Table of Contents

dotnet new Templates

AsiBackbone.Templates removes blank-page adoption friction by generating a runnable ASP.NET Core host with AsiBackbone governance wiring already in place.

Important

The generated project is a local scaffold. It is not a production persistence design, production signing provider, compliance guarantee, or replacement for host-owned authentication, authorization, security review, deployment, monitoring, or execution controls.

Install

dotnet new install AsiBackbone.Templates

For local repository validation, install the generated .nupkg from the package artifact directory instead:

dotnet new install ./artifacts/packages/AsiBackbone.Templates.2.0.0.nupkg

Create a governed Web API

dotnet new asibackbone-webapi -n MyGovernedApi --hostStyle plain

Then run the generated app:

cd MyGovernedApi
dotnet restore
dotnet run

Host-style selection

The template supports a --hostStyle choice parameter.

Host style Use when Notes
plain You want the smallest standard ASP.NET Core Web API scaffold. Uses direct package registration and ordinary ASP.NET Core project structure.
netcoretemplate You want a generated host that can be adapted toward the NetCoreApplicationTemplate style. Does not make NetCoreApplicationTemplate a dependency of AsiBackbone or the generated app.

Both host styles currently generate the same runnable core project shape, with the selected style captured in appsettings.json and the generated README. The netcoretemplate style is intentionally a compatibility bridge and documentation cue rather than a hard dependency on the external template repository.

Generated project contents

The generated project includes:

  • AddAsiBackboneAspNetCore() registration;
  • UseAsiBackboneEndpointGovernance() middleware;
  • a sample governance constraint and decision policy;
  • a Minimal API endpoint using fluent endpoint-governance metadata;
  • a controller action using [RequireGovernancePolicy], [RequireCapabilityGrant], and [EmitGovernanceAudit];
  • non-durable InMemoryAuditLedger storage for local inspection;
  • AsiBackbone.Analyzers as a development-time analyzer reference;
  • a generated README with next steps and production-boundary notes.

Useful generated endpoints

GET /
GET /sample/decision
GET /sample/audit/{correlationId}
POST /sample/minimal/execute
POST /sample/controller/execute

The /sample/decision endpoint returns the decision outcome, reason codes, correlation ID, policy metadata, and audit event ID. Use the correlation ID with /sample/audit/{correlationId} to inspect the local in-memory audit residue.

Local defaults and production boundaries

The template intentionally favors safe local defaults:

Concern Template default Production expectation
Audit storage Non-durable in-memory audit ledger Host-owned durable audit/outbox persistence when records must survive restart.
Capability validation Sample scope check for sample.execute Host-owned scope, expiry, replay, actor binding, and downstream authorization checks.
Signing Not configured by default Add a production signing/key-management provider only when the host has a concrete trust model.
Authentication and authorization Not configured by default Add normal ASP.NET Core auth and policy enforcement for protected hosts.
Execution Sample response only Host application owns real business execution and refusal behavior.

CI validation

The repository validates the template package by packing local packages, installing the generated AsiBackbone.Templates package, generating both supported host styles, restoring against the local package output plus NuGet, and building each generated project.

This proves the template can be installed and used from a clean directory without making Core depend on template infrastructure or NetCoreApplicationTemplate.

Edit this page