Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Microsoft. Identity.Web è un set di pacchetti NuGet che semplificano l'aggiunta di autenticazione e autorizzazione alle applicazioni che si integrano con il Microsoft Identity Platform. Ogni pacchetto è destinato a uno scenario specifico, in modo da installare solo le esigenze dell'applicazione. Questo articolo descrive i pacchetti disponibili e consente di scegliere quello giusto.
Pacchetti di base
Questi pacchetti forniscono le funzionalità fondamentali per l'autenticazione e la gestione dei token.
| Package | Descrizione |
|---|---|
| Microsoft. Identity.Web | Pacchetto principale per ASP.NET Core app Web e API Web. Abilita l'accesso, la convalida dei token e la chiamata alle API downstream. |
| Microsoft. Identity.Web.UI | Fornisce componenti dell'interfaccia utente per applicazioni web ASP.NET Core, inclusi controller e visualizzazioni di accesso e disconnessione. |
| Microsoft. Identity.Web.TokenAcquisition | API di livello superiore per l'acquisizione di token nelle applicazioni client riservate (ASP.NET Core e .NET SDK). Gestisce automaticamente la gestione dei token. |
| Microsoft. Identity.Web.TokenCache | Serializzatori della cache dei token per applicazioni client riservate MSAL.NET. Supporta la memorizzazione nella cache in memoria, distribuita e basata su sessione. |
Pacchetti di gestione delle credenziali
Questi pacchetti gestiscono tipi di credenziali di autenticazione diversi.
| Package | Descrizione |
|---|---|
| Microsoft. Identity.Web.Certificate | Funzionalità di gestione dei certificati per MSAL.NET, incluso il caricamento di certificati da Azure Key Vault e archivi locali. |
| Microsoft. Identity.Web.Certificateless | Scenari di autenticazione senza l'uso di certificati, ad esempio identità gestite e federazione dell'identità di lavoro. |
Pacchetti di integrazione e API downstream
Questi pacchetti consentono di chiamare le API protette e di integrarsi con i servizi di Azure.
| Package | Descrizione |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Interfaccia di livello superiore per la chiamata di API protette downstream da applicazioni client riservate con gestione automatica dei token. |
| Microsoft. Identity.Web. Azure | Consente alle app Web e alle API Web di ASP.NET Core di usare gli SDK di Azure con la piattaforma di identità Microsoft fornendo delle implementazioni TokenCredential. |
| Microsoft. Identity.Web.OWIN | Consente alle applicazioni web ASP.NET (OWIN/Katana) e alle API web su .NET Framework di utilizzare la piattaforma di identità Microsoft. |
pacchetti Microsoft Graph
Questi pacchetti forniscono l'integrazione con Microsoft Graph per chiamare i servizi di Microsoft 365.
| Package | Descrizione |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Integrazione di Microsoft Graph usando Graph SDK v5 e versioni successive. Consigliato per i nuovi progetti. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Integrazione Beta di Microsoft Graph utilizzando Graph SDK v5 e versioni successive. Usare questo pacchetto per accedere alle funzionalità di anteprima. |
| Microsoft. Identity.Web.MicrosoftGraph | Integrazione di Microsoft Graph usando Graph SDK v4. Usare pacchetti GraphServiceClient per nuovi progetti. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | L'integrazione beta di Microsoft Graph utilizzando Graph SDK v4. |
Pacchetti di scenari avanzati
Questi pacchetti supportano scenari di autenticazione specializzati.
| Package | Descrizione |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Supporto di diagnostica e registrazione per la risoluzione dei problemi di autenticazione. |
| Microsoft. Identity.Web.OidcFIC | Implementazione del provider FIC (Cloud Federation Identity Credential). Abilita scenari di autenticazione tra cloud. |
| Microsoft. Identity.Web.AgentIdentities | Metodi helper per scenari di identità agente, tra cui la creazione di agenti autonomi e integrazioni con copilot. |
Scegli il pacchetto giusto
Usare gli esempi seguenti per installare i pacchetti che corrispondono allo scenario dell'applicazione.
Applicazioni Web che consentono l'accesso degli utenti
Per ASP.NET Core app Web che consentono agli utenti di accedere con Microsoft Entra ID, installare il pacchetto principale e il pacchetto dell'interfaccia utente:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
API Web protette
Per ASP.NET Core API Web che convalidano i token dai chiamanti autenticati, installare il pacchetto principale:
dotnet add package Microsoft.Identity.Web
Applicazioni daemon e servizi in background
Per le app daemon o i servizi in background che acquisiscono token senza interazione dell'utente, installare il pacchetto di acquisizione di token:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Chiamata di Microsoft Graph
Per i nuovi progetti, usare il pacchetto Graph SDK v5:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Se il progetto usa Graph SDK v4, installare invece il pacchetto di integrazione precedente:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Uso di Azure SDK
Per autenticare i client Azure SDK con il Microsoft Identity Platform, installare il pacchetto di integrazione Azure:
dotnet add package Microsoft.Identity.Web.Azure
Chiamata di API downstream personalizzate
Per chiamare le PROPRIE API protette con la gestione automatica dei token, installare il pacchetto dell'API downstream:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Scenari di agente e copilota
Per la creazione di agenti autonomi o integrazioni con copilot, installare il pacchetto di identità dell'agente:
dotnet add package Microsoft.Identity.Web.AgentIdentities
Applicazioni OWIN (.NET Framework)
Per ASP.NET app Web e API Web in .NET Framework (OWIN/Katana), installare il pacchetto OWIN:
dotnet add package Microsoft.Identity.Web.OWIN