Skip to main content

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​

KeyDefaultDescription
RoutePrefixadminURL prefix of the panel
Title, Logo, LogoMini, LoginBackgroundImageBranding. Logo values are HTML from config

Protection​

KeyDefaultDescription
Protection:ScopePrefixPrefix protects Protection:Paths (default: the prefix). All protects the whole app
Protection:Paths[] → /adminPath 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:SkipUrlRulesForAssetstrueMapStaticAssets() files and Blazor framework requests (/_framework/*, /_blazor) need login but no URL rule

Authentication​

KeyDefaultDescription
Auth:CookieName.SuperAdmin.Auth
Auth:CookieSecurePolicySameAsRequestSet Always in production
Auth:ExpireMinutes / SlidingExpiration60 / trueSession lifetime
Auth:AllowRememberMe / RememberMeDaystrue / 14
Auth:MaxFailedAttempts / LockoutMinutes5 / 15Per-user lockout
Auth:LoginPermitLimit / LoginWindowSeconds10 / 60Per-IP login rate limit (0 disables)
Auth:PasswordMinLength / PasswordMaxLength8 / 128
Auth:SetDefaultSchemefalseMake the SuperAdmin cookie the default authentication scheme (Blazor, [Authorize], HttpContext.User)
Auth:RevalidationMinutes1Blazor Server: how often open circuits re-check the user

Database​

KeyDefaultDescription
Database:TablePrefixsa_
Database:SchemanullFor example admin on SQL Server or PostgreSQL. On Oracle and MySQL the schema is the user or database
Database:ModeAutoAuto, Create, Migrate or None. See Modes
Database:AutoMigratetrueObsolete. false is the same as Mode = None

Cache​

KeyDefaultDescription
Cache:VersionCheckSeconds5Web farm only: how often other instances notice changes. 0 = single instance
Cache:UserSnapshotMinutes10Sliding cache lifetime per user

Operation log​

KeyDefaultDescription
OperationLog:Enabledtrue
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 / RetentionDays65536 / 90
OperationLog:WriteToDatabasetruefalse when only your IOperationLogSink should receive entries

Seed​

KeyDefaultDescription
Seed:EnabledtrueSeeds only what is missing (idempotent)
Seed:AdminUserName / AdminPasswordadmin / nullNull: random password on the console in Development, no admin user elsewhere. Never logged
Seed:ForcePasswordChangetrue

UI​

KeyDefaultDescription
UI:Enabledtruefalse removes every built-in page. Guard, cookie and services keep working
UI:PagesAllAccount (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:ColorModeLightLight, Dark or Auto (follows the browser)