Sintia.AuthServer
1.3.1
dotnet add package Sintia.AuthServer --version 1.3.1
NuGet\Install-Package Sintia.AuthServer -Version 1.3.1
<PackageReference Include="Sintia.AuthServer" Version="1.3.1" />
<PackageVersion Include="Sintia.AuthServer" Version="1.3.1" />
<PackageReference Include="Sintia.AuthServer" />
paket add Sintia.AuthServer --version 1.3.1
#r "nuget: Sintia.AuthServer, 1.3.1"
#:package Sintia.AuthServer@1.3.1
#addin nuget:?package=Sintia.AuthServer&version=1.3.1
#tool nuget:?package=Sintia.AuthServer&version=1.3.1
Sintia.AuthServer
Modulo ABP riusabile dell'Identity Provider SINTIA (OpenIddict + SPID/CIE/SAML).
Da referenziare in un host ASP.NET Core (ABP [DependsOn]) che fornisce configurazione
(appsettings), certificati (signing/encryption OpenIddict) e connection string al database.
Flussi Auth supportati
- OpenIddict: Authorization Code, Hybrid, Implicit, Client Credentials, Password, Refresh Token
- Provider esterni: Microsoft/Entra ID, Windows Authentication (Negotiate), SPID, CIE, SAML2
- Emergency Access (token + IP allowlist)
Installazione
Feed interno SINTIA LAB (Azure Artifacts) — vedi nuget.config del progetto host:
dotnet add package Sintia.AuthServer --version <versione>
Uso minimo
[DependsOn(typeof(SintiaAuthServerModule))]
public class YourHostModule : AbpModule
{
public override void ConfigureServices(ServiceConfigurationContext context)
{
// opzionale: provider aggiuntivi, installabili SOLO da qui (vedi sotto)
context.Services.AddSintiaWindows();
}
}
I provider (Windows/SPID/CIE/SAML/Google/Microsoft) sono opzionali: installabili SOLO da
codice via AddSintiaX(...) — appsettings.json non può più accenderne uno da solo (vedi
"Configurazione provider" sotto). Le credenziali/valori operativi, una volta installato un
provider, si configurano invece da appsettings o da UI (/SettingManagement), a scelta.
Se usi
Program.csinvece di un modulo host (es. minimal hosting senza[DependsOn]dedicato): ogniAddSintiaX(...)va chiamato subuilder.ServicesPRIMA diawait builder.AddApplicationAsync<SintiaAuthServerModule>(), mai dopo. Il merge tra appsettings eAddSintiaX(ExecutePreConfiguredActions) gira dentroConfigureServicesdel modulo, eseguito durante quell'await— una chiamata registrata dopo non viene mai applicata: il provider risulta silenziosamente "non installato" (nessun errore, nessun bottone in login), unico segnale è il warning a log. Esempio:builder.Services.AddSintiaMicrosoft(); // PRIMA builder.Services.AddSintiaGoogle(); // PRIMA await builder.AddApplicationAsync<SintiaAuthServerModule>(); // POI
Configurazione minima obbligatoria
Senza queste chiavi l'host non si avvia (database non raggiungibile o schema incompleto bloccano l'avvio; valori OpenIddict/OAuth errati falliscono al primo utilizzo). Nessuna ha un default utilizzabile in produzione.
| Chiave | Perché serve |
|---|---|
ConnectionStrings:Default |
Connection string del database (schema Identity/OpenIddict/PermissionManagement/SettingManagement/AuditLogging/BackgroundJobs/FeatureManagement) |
SigningCertificate:Filename + SigningCertificate:Password |
Certificato di firma/cifratura OpenIddict (.pfx) — il file fisico deve stare nella content root dell'host (src/Sintia.AuthServer.Host/ in questo repo), copiato in output dal csproj |
StringEncryption:DefaultPassPhrase |
Cifra i ClientSecret OAuth (Google/Microsoft) salvati a DB da /SettingManagement — cambiarla dopo il primo salvataggio rende quei valori indecifrabili |
AuthServer:Authority / App:SelfUrl |
URL pubblico usato per costruire gli endpoint OpenIddict e i redirect |
| Migration del database | Prima del primo avvio eseguire un DbMigrator (console) che referenzia il pacchetto Sintia.AuthServer.Migration (vedi il suo README). L'Host non applica migration e non si avvia se il database non è raggiungibile o lo schema è incompleto |
DatabaseProvider (opzionale) |
SqlServer (default) oppure PostgreSql |
Per i tre valori sensibili (SigningCertificate:Password, StringEncryption:DefaultPassPhrase,
ClientSecret dei provider OAuth), non committare mai il valore reale in un file tracciato:
usare appsettings.secrets.json (gitignored) o variabili d'ambiente. <set-by-secret> nei
file di esempio di questo repo è solo un placeholder leggibile — non un valore che la libreria
risolve da sola: senza un override reale l'app si avvia comunque, ma OAuth/OpenIddict falliscono
al primo utilizzo con quel valore letterale.
Configurazione provider
Enabled ("il provider è installato", richiede restart) è SOLO CODICE, per tutti e 7
i provider: appsettings.json NON può più installarne uno da solo. Un
AddSintiaX(...) chiamato in ConfigureServices del modulo host è già l'opt-in — imposta
Enabled = true prima di applicare l'eventuale lambda, anche senza passare argomenti. Chi
non chiama il metodo resta SEMPRE spento, anche con Enabled: true scritto in appsettings
(loggato come warning a startup, non ignorato in silenzio). Gli ALTRI campi (nella lambda o
già in appsettings) restano invece letti normalmente da entrambe le fonti — la lambda ha
precedenza, un campo non toccato resta quello di appsettings; solo Enabled è cambiato.
Eccezione: AddSintiaLocal (login locale). Parte Enabled=true di default, SENZA
bisogno di chiamarlo — altrimenti un host che dimentica ogni AddSintiaX resterebbe senza
NESSUN modo di accedere. Per spegnerlo: AddSintiaLocal(disabled: true), mai più
Account:EnableLocalLogin da appsettings.
Un secondo interruttore, indipendente da Enabled, decide se un provider installato è
acceso ora: il toggle "Attivo" in /SettingManagement → Provider di login (Setting
RuntimeEnabled, no restart, sempre sovrascrivibile da appsettings/Setting — non cambiato).
| Provider | Metodo | Sezione appsettings (solo campi non-Enabled) | Note |
|---|---|---|---|
| CIE | AddSintiaCie(CieEnvironment environment, Action<CieAuthOptions>? configure = null) |
Auth:Cie |
environment obbligatorio (Staging/Production) sia da codice sia da appsettings — con provider installato e Environment non impostato l'host non si avvia (nessun default silenzioso per un provider di identità governativo) |
| SPID | AddSintiaSpid(Action<SpidAuthOptions>? configure = null) |
Auth:Spid |
|
| SAML 2.0 | AddSintiaSaml(string spEntityId, string idpMetadataUrl, Action<SamlAuthOptions>? configure = null) |
Auth:Saml |
IdP generico (es. Entra via SAML). spEntityId/idpMetadataUrl obbligatori a compile-time — a differenza di CIE/SPID/Microsoft/Google, questi due campi NON hanno un equivalente Setting in /SettingManagement: se mancano il provider è rotto, nessun percorso "configuralo dopo da UI" |
| Windows (Negotiate) | AddSintiaWindows(Action<WindowsAuthOptions>? configure = null) |
Auth:Windows |
|
| Google OAuth | AddSintiaGoogle(Action<GoogleAuthOptions>? configure = null) |
Google |
ClientId/ClientSecret restano comunque sovrascrivibili senza restart da /SettingManagement |
| Microsoft/Entra ID | AddSintiaMicrosoft(Action<MicrosoftAuthOptions>? configure = null) |
EntraId |
ClientId/ClientSecret/TenantId sovrascrivibili da /SettingManagement; CallbackPath (default /signin-oidc, redirect URI da registrare su Entra) da appsettings o dalla lambda, richiede restart; EntraId:Authority resta configurabile solo da appsettings. ForceAsDefaultProvider+AutoRedirectToProvider (entrambi true) reindirizzano automaticamente la pagina di login a Entra dopo un breve delay, annullabile dall'utente |
| Login locale | AddSintiaLocal(bool disabled = false, Action<LocalAuthOptions>? configure = null) |
Account:EnableRegistration/EnableForgotPassword/IsTwoFactorAuthenticationEnabled |
Unico provider Enabled=true di default (vedi sopra). Registrazione/Password dimenticata/2FA restano governati da appsettings o dalla lambda, non toccati da disabled |
| Lingue extra | AddSintiaLanguage(string cultureName, string uiCultureName, string displayName) |
— (nessun equivalente appsettings) | Italiano è sempre disponibile e sempre il default; chiamabile più volte |
Esempio con configurazione esplicita:
public override void ConfigureServices(ServiceConfigurationContext context)
{
context.Services.AddSintiaMicrosoft(ms =>
{
ms.ClientId = "...";
ms.ClientSecret = "...";
ms.TenantId = "...";
});
context.Services.AddSintiaCie(CieEnvironment.Production);
context.Services.AddSintiaSaml(
spEntityId: "https://auth.miodominio.it",
idpMetadataUrl: "https://login.microsoftonline.com/{tenantId}/federationmetadata/2007-06/federationmetadata.xml?appid={appId}");
context.Services.AddSintiaLanguage("en", "en", "English");
}
Passaggi per abilitare e configurare un provider
Due fasi distinte, non intercambiabili:
1. Installazione (codice, richiede restart). Chiama AddSintiaX(...) come sopra — SOLO
questo accende Enabled. Senza questa chiamata il provider non esiste per l'host, qualunque
cosa dica appsettings.
2. Accensione + configurazione (a runtime, scelta libera tra due fonti):
- Da appsettings.json/secrets — imposta i campi della sezione (colonna "Sezione
appsettings" nella tabella sopra:
Auth:Cie,Auth:Spid,Auth:Saml,Auth:Windows,Google,EntraId). Letti come valore di partenza al boot. - Da UI,
/SettingManagement→ tab "Provider di login" — la sezione del provider compare SOLO se è già installato (Enabled=true, punto 1). Da lì un admin può sovrascrivere ClientId/ClientSecret/TenantId/EntityId/DefaultUserRole/ecc. senza restart — vince sempre sul valore di appsettings se valorizzato, altrimenti appsettings resta il fallback.
Il toggle "Attivo" (Setting RuntimeEnabled) è l'ECCEZIONE: esiste SOLO da UI, nessun
equivalente in appsettings. Un provider installato (Enabled=true) ma con RuntimeEnabled
a false resta invisibile in login finché un admin non lo accende da /SettingManagement —
non basta editare appsettings. Default diversi per provider, non uniformi:
| Provider | RuntimeEnabled default |
|---|---|
| Login locale, Microsoft/Entra ID | true — visibile appena installato |
| Google, Windows, SPID, CIE, SAML | false — va acceso esplicitamente da /SettingManagement anche dopo AddSintiaX(...) |
Emergency Access
Per abilitare l'accesso di emergenza, aggiungere in appsettings.json (o
appsettings.secrets.json per AccessToken, mai committato in chiaro):
{
"Authentication": {
"EmergencyAccess": {
"Enabled": true,
"AccessToken": "<set-by-secret>",
"AllowedIpAddresses": "",
"LogToSecurity": true
}
}
}
Poi navigare a /Account/Emergency/{AccessToken}. Dettagli completi (sicurezza, IP
allowlist, troubleshooting) in docs/EMERGENCY_ACCESS.md.
Deleghe utente (opt-in)
Un utente (delegato, A) accede ai client OIDC per conto di un altro (delegante, B) in base a
una delega con validità da/a creata da un amministratore. I token hanno sub = B e i claim
impersonator_userid/impersonator_username = A. Spenta di default: senza la chiamata sotto
nessuna pagina, endpoint o claim aggiuntivo.
context.Services.AddSintiaDelegation(); // PRIMA di AddApplicationAsync, come gli altri AddSintiaX
context.Services.AddSintiaDelegation(o =>
{
o.AccessTokenLifetime = TimeSpan.FromMinutes(30); // default 1 ora, > 0 obbligatorio
o.AllowRememberOwnProfile = false; // nasconde "Ricordami" (default true)
});
Per usarla serve anche:
- Permission (ruolo o utente, seed nel DbMigrator del consumer):
Sintia.AuthServer.Delegations.Manage(gestione, pagina/Delegationse voce di menu),.Delegator(può essere rappresentato),.Delegate(può accedere per conto di altri). - Client abilitati: permission OpenIddict
ext:delegationsull'applicazione. I client senza restano identici a prima e non ricevono mai token delegati. - Client che rispettano il contratto (
docs/DELEGATION.md, "Contratto per i client"): leggereimpersonator_*, mostrare chi agisce, tracciarlo nell'audit, limitare la durata della sessione locale delegata.
Nessuna migration: lo store è la tabella ABP AbpUserDelegations, già nello schema di
Sintia.AuthServer.Migration. Le date delle deleghe seguono il clock ABP: su un host che lavora
in UTC impostare AbpClockOptions.Kind = DateTimeKind.Utc. Dettagli, limiti noti e
troubleshooting in docs/DELEGATION.md.
Documentazione aggiuntiva
Documenti tecnici dettagliati per provider/feature, letti dal repository sorgente (non inclusi nel pacchetto NuGet — se si consuma solo il pacchetto, recuperarli dal repository Git):
docs/SPID_INTEGRATION.mddocs/CIE_INTEGRATION.mddocs/SAML_INTEGRATION.mddocs/WINDOWS_INTEGRATION.mddocs/EMERGENCY_ACCESS.md— configurazione, abilitazione dall'esterno, sicurezza, troubleshootingdocs/DELEGATION.md— deleghe utente (accesso per conto di, opt-in viaAddSintiaDelegation())docs/LOCALIZATION.md
Novità
1.3
- Deleghe utente opt-in (
AddSintiaDelegation): accesso per conto di un altro utente con validità da/a, pagina di scelta del profilo dopo il login ("Ricordami" per il proprio profilo, "Cambia profilo" conprompt=select_account), gestione admin/Delegationscon voce di menu, opt-in per client (ext:delegation), token delegati di durata breve e mai oltre la fine della delega, sessione delegata limitata alle pagine necessarie. Vedi "Deleghe utente" sopra. - Nessun cambio di schema:
Sintia.AuthServer.Migration1.3 (stessa versione) non aggiunge migration. - Senza
AddSintiaDelegationil comportamento è invariato.
1.2.2
- Fix
wwwroot/libsallineato ad ABP 10.7:jquery-migratemancante faceva fallire il bundle del layout LeptonXLite (Could not find file '/libs/jquery-migrate/jquery-migrate.js'), pagina di errore inclusa. Aggiornato@abp/aspnetcore.mvc.ui.theme.leptonxlitea ~5.7.0; rimossitoastrejquery-form, non più dipendenze del tema. EntraId:CallbackPathconfigurabile (default/signin-oidc), anche conAddSintiaMicrosoft(o => o.CallbackPath = "..."). Chi aveva registrato/signin-microsoftsu Entra deve impostarlo esplicitamente.- Sicurezza: dipendenze .NET aggiornate a 10.0.13 per le advisory del 2026-10-13
(
Microsoft.AspNetCore.Authentication.NegotiateGHSA-vrrp-6v32-2p8g;System.Security.Cryptography.Xml/PkcsDoS). Pin esplicito diSystem.Security.Cryptography.Pkcs10.0.13 (prima arrivava 9.0.11 viaMicrosoft.Data.SqlClient). - Prima versione pubblicata su nuget.org insieme a
Sintia.AuthServer.Migration1.2.2 (stessa versione per i due pacchetti).
1.1.1 — introduce CallbackPath, ma il pacchetto non include il fix wwwroot/libs: usare 1.2.2.
Uso e supporto
Pacchetto interno SINTIA LAB — uso riservato ai soggetti autorizzati (vedi LICENSE). Repository: https://dev.azure.com/sintialab/_git/SINT_AuthServer Contattare SINTIA LAB S.r.l. per informazioni su licenza e supporto.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Azure.Identity (>= 1.21.0)
- CIE.AspNetCore.Authentication (>= 2.1.0)
- DistributedLock.Redis (>= 1.1.1)
- ElmahCore (>= 2.1.2)
- ITfoxtec.Identity.Saml2.MvcCore (>= 4.18.2)
- Microsoft.AspNetCore.Authentication.Google (>= 10.0.13)
- Microsoft.AspNetCore.Authentication.MicrosoftAccount (>= 10.0.13)
- Microsoft.AspNetCore.Authentication.Negotiate (>= 10.0.13)
- Microsoft.AspNetCore.Authentication.OpenIdConnect (>= 10.0.13)
- Microsoft.AspNetCore.DataProtection.StackExchangeRedis (>= 10.0.13)
- Microsoft.EntityFrameworkCore.Relational (>= 10.0.13)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.13)
- Microsoft.IdentityModel.Abstractions (>= 8.19.2)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.19.2)
- Microsoft.IdentityModel.Logging (>= 8.19.2)
- Microsoft.IdentityModel.Protocols (>= 8.19.2)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.19.2)
- Microsoft.IdentityModel.Tokens (>= 8.19.2)
- Microsoft.IdentityModel.Tokens.Saml (>= 8.19.2)
- Microsoft.IdentityModel.Validators (>= 8.19.2)
- QRCoder (>= 1.8.0)
- Scriban (>= 7.5.0)
- Serilog.AspNetCore (>= 10.0.0)
- Serilog.Sinks.Async (>= 1.5.0)
- SPID.AspNetCore.Authentication (>= 3.4.0)
- System.Data.SqlClient (>= 4.9.1)
- System.DirectoryServices.AccountManagement (>= 10.0.13)
- System.IdentityModel.Tokens.Jwt (>= 8.19.2)
- System.Linq.Dynamic.Core (>= 1.7.4)
- System.Security.Cryptography.Pkcs (>= 10.0.13)
- System.ServiceModel.Primitives (>= 10.0.652802)
- Volo.Abp.Account.Application (>= 10.7.0)
- Volo.Abp.Account.HttpApi (>= 10.7.0)
- Volo.Abp.Account.Web.OpenIddict (>= 10.7.0)
- Volo.Abp.AspNetCore.Mvc.UI.Theme.LeptonXLite (>= 5.7.0)
- Volo.Abp.AspNetCore.Serilog (>= 10.7.0)
- Volo.Abp.AuditLogging.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.Autofac (>= 10.7.0)
- Volo.Abp.BackgroundJobs.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.EntityFrameworkCore.PostgreSql (>= 10.7.0)
- Volo.Abp.EntityFrameworkCore.SqlServer (>= 10.7.0)
- Volo.Abp.FeatureManagement.Application (>= 10.7.0)
- Volo.Abp.FeatureManagement.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.FeatureManagement.Web (>= 10.7.0)
- Volo.Abp.Identity.Application (>= 10.7.0)
- Volo.Abp.Identity.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.Localization (>= 10.7.0)
- Volo.Abp.Localization.Abstractions (>= 10.7.0)
- Volo.Abp.OpenIddict.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.PermissionManagement.Domain.Identity (>= 10.7.0)
- Volo.Abp.PermissionManagement.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.SettingManagement.Application (>= 10.7.0)
- Volo.Abp.SettingManagement.EntityFrameworkCore (>= 10.7.0)
- Volo.Abp.SettingManagement.Web (>= 10.7.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Sintia.AuthServer:
| Package | Downloads |
|---|---|
|
Sintia.AuthServer.Migration
Migration EF Core (SQL Server e PostgreSql) e servizio di migrazione di Sintia.AuthServer. Da referenziare solo dal DbMigrator (console) del repo cliente, mai dall'Host web. |
GitHub repositories
This package is not used by any popular GitHub repositories.