AuthenticationInstaller — Web
Key: Authentication
Default Enabled: ✅
Package: SaveApis.Framework.Web
Purpose
Registers the ASP.NET Core Authentication services and adds the UseAuthentication() middleware to the pipeline. This installer is the foundation for all authentication schemes — including Zitadel token introspection.
What It Does
Builder phase:
- Calls
builder.Services.AddAuthentication()— registers the authentication service and the authentication middleware
Application phase:
- Calls
app.UseAuthentication()— adds the authentication middleware to the HTTP pipeline, which populatesHttpContext.Useron every request
Dependencies
| Dependency | Direction | Requirement | Description |
|---|---|---|---|
AuthorizationInstaller |
Before | Required | Authorization must run after Authentication |
ZitadelInstaller |
Before | Required | Zitadel scheme is added on top of Authentication |
ControllerInstaller |
Before | Optional | Controllers require auth middleware to be present |
OpenApiInstaller |
Before | Optional | OpenAPI endpoint should have auth available |
ScalarInstaller |
Before | Optional | Scalar UI should have auth available |
Configuration
This installer has no configuration options. It registers the base authentication infrastructure only — authentication schemes (e.g. Zitadel) are added by other installers.
InstallerContext Extension
installer.WithAuthentication(bool enabled = true);
Warning: Disabling
AuthenticationInstallerwill also breakAuthorizationInstallerandZitadelInstallersince they depend on it. Disable all three together if you want to run without auth.
Related
- Web Framework Overview
- AuthorizationInstaller — must run after this installer
- ZitadelInstaller — adds the Zitadel introspection scheme