Sintia.AuthServer 1.3.1

dotnet add package Sintia.AuthServer --version 1.3.1
                    
NuGet\Install-Package Sintia.AuthServer -Version 1.3.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sintia.AuthServer" Version="1.3.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sintia.AuthServer" Version="1.3.1" />
                    
Directory.Packages.props
<PackageReference Include="Sintia.AuthServer" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Sintia.AuthServer --version 1.3.1
                    
#r "nuget: Sintia.AuthServer, 1.3.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Sintia.AuthServer@1.3.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Sintia.AuthServer&version=1.3.1
                    
Install as a Cake Addin
#tool nuget:?package=Sintia.AuthServer&version=1.3.1
                    
Install as a Cake Tool

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.cs invece di un modulo host (es. minimal hosting senza [DependsOn] dedicato): ogni AddSintiaX(...) va chiamato su builder.Services PRIMA di await builder.AddApplicationAsync<SintiaAuthServerModule>(), mai dopo. Il merge tra appsettings e AddSintiaX (ExecutePreConfiguredActions) gira dentro ConfigureServices del 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:

  1. Permission (ruolo o utente, seed nel DbMigrator del consumer): Sintia.AuthServer.Delegations.Manage (gestione, pagina /Delegations e voce di menu), .Delegator (può essere rappresentato), .Delegate (può accedere per conto di altri).
  2. Client abilitati: permission OpenIddict ext:delegation sull'applicazione. I client senza restano identici a prima e non ricevono mai token delegati.
  3. Client che rispettano il contratto (docs/DELEGATION.md, "Contratto per i client"): leggere impersonator_*, 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.md
  • docs/CIE_INTEGRATION.md
  • docs/SAML_INTEGRATION.md
  • docs/WINDOWS_INTEGRATION.md
  • docs/EMERGENCY_ACCESS.md — configurazione, abilitazione dall'esterno, sicurezza, troubleshooting
  • docs/DELEGATION.md — deleghe utente (accesso per conto di, opt-in via AddSintiaDelegation())
  • 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" con prompt=select_account), gestione admin /Delegations con 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.Migration 1.3 (stessa versione) non aggiunge migration.
  • Senza AddSintiaDelegation il comportamento è invariato.

1.2.2

  • Fix wwwroot/libs allineato ad ABP 10.7: jquery-migrate mancante 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.leptonxlite a ~5.7.0; rimossi toastr e jquery-form, non più dipendenze del tema.
  • EntraId:CallbackPath configurabile (default /signin-oidc), anche con AddSintiaMicrosoft(o => o.CallbackPath = "..."). Chi aveva registrato /signin-microsoft su Entra deve impostarlo esplicitamente.
  • Sicurezza: dipendenze .NET aggiornate a 10.0.13 per le advisory del 2026-10-13 (Microsoft.AspNetCore.Authentication.Negotiate GHSA-vrrp-6v32-2p8g; System.Security.Cryptography.Xml/Pkcs DoS). Pin esplicito di System.Security.Cryptography.Pkcs 10.0.13 (prima arrivava 9.0.11 via Microsoft.Data.SqlClient).
  • Prima versione pubblicata su nuget.org insieme a Sintia.AuthServer.Migration 1.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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.

Version Downloads Last Updated
1.3.1 0 11/16/2026
1.2.5 140 10/26/2026
1.2.3 147 10/16/2026
1.2.2 154 10/15/2026