Configuration reference
All keys live under the SuperAdmin section of appsettings.json. You can also set them in code:
builder.Services.AddSuperAdmin(config, db => ..., o => o.RoutePrefix = "backoffice");
General and branding
| Key | Default | Description |
|---|---|---|
RoutePrefix | admin | URL prefix of the panel |
Title, Logo, LogoMini, LoginBackgroundImage | Branding. Logo values are HTML from config |
Protection
| Key | Default | Description |
|---|---|---|
Protection:Scope | Prefix | Prefix protects Protection:Paths (default: the prefix). All protects the whole app |
Protection:Paths | [] → /admin | Path prefixes to protect when Scope = Prefix |
Protection:AnonymousPaths | [] | Extra public patterns. Login, denied and /_content/* are always public |
Protection:ApiPaths | [] → /admin/api/* | Patterns that get 401/403 instead of redirects |
Protection:SkipUrlRulesForAssets | true | MapStaticAssets() files and Blazor framework requests (/_framework/*, /_blazor) need login but no URL rule |
Authentication
| Key | Default | Description |
|---|---|---|
Auth:CookieName | .SuperAdmin.Auth | |
Auth:CookieSecurePolicy | SameAsRequest | Set Always in production |
Auth:ExpireMinutes / SlidingExpiration | 60 / true | Session lifetime |
Auth:AllowRememberMe / RememberMeDays | true / 14 | |
Auth:MaxFailedAttempts / LockoutMinutes | 5 / 15 | Per-user lockout |
Auth:LoginPermitLimit / LoginWindowSeconds | 10 / 60 | Per-IP login rate limit (0 disables) |
Auth:PasswordMinLength / PasswordMaxLength | 8 / 128 | |
Auth:SetDefaultScheme | false | Make the SuperAdmin cookie the default authentication scheme (Blazor, [Authorize], HttpContext.User) |
Auth:RevalidationMinutes | 1 | Blazor Server: how often open circuits re-check the user |
Database
| Key | Default | Description |
|---|---|---|
Database:TablePrefix | sa_ | |
Database:Schema | null | For example admin on SQL Server or PostgreSQL. On Oracle and MySQL the schema is the user or database |
Database:Mode | Auto | Auto, Create, Migrate or None. See Modes |
Database:AutoMigrate | true | Obsolete. false is the same as Mode = None |
Cache
| Key | Default | Description |
|---|---|---|
Cache:VersionCheckSeconds | 5 | Web farm only: how often other instances notice changes. 0 = single instance |
Cache:UserSnapshotMinutes | 10 | Sliding cache lifetime per user |
Operation log
| Key | Default | Description |
|---|---|---|
OperationLog:Enabled | true | |
OperationLog:Methods | [] → POST, PUT, PATCH, DELETE | |
OperationLog:Except | [] | Patterns never logged (the log page itself is always excluded) |
OperationLog:RedactKeys | [] | Extra keys to mask. password, secret, token, apikey and authorization are always masked |
OperationLog:MaxBodyBytes / RetentionDays | 65536 / 90 | |
OperationLog:WriteToDatabase | true | false when only your IOperationLogSink should receive entries |
Seed
| Key | Default | Description |
|---|---|---|
Seed:Enabled | true | Seeds only what is missing (idempotent) |
Seed:AdminUserName / AdminPassword | admin / null | Null: random password on the console in Development, no admin user elsewhere. Never logged |
Seed:ForcePasswordChange | true |
UI
| Key | Default | Description |
|---|---|---|
UI:Enabled | true | false removes every built-in page. Guard, cookie and services keep working |
UI:Pages | All | Account (login, logout, denied, profile, password), Management (dashboard, users, roles, ...) or All |
UI:Stylesheets | [] | Extra CSS files loaded after the package CSS on every panel page (built-in pages, sign-in page, <SuperAdminHead />). ~/, / or absolute URLs. Local entries are public, so the sign-in page can load them under Scope = All. See Theme and colours |
UI:ColorMode | Light | Light, Dark or Auto (follows the browser) |