Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Microsoft. Identity.Web est un ensemble de packages NuGet qui simplifient l’ajout d’authentification et d’autorisation aux applications qui s’intègrent au Plateforme d'identités Microsoft. Chaque package cible un scénario spécifique. Vous installez donc uniquement ce dont votre application a besoin. Cet article décrit les packages disponibles et vous aide à choisir celui qui convient.
Packages principaux
Ces packages fournissent les fonctionnalités fondamentales pour l’authentification et la gestion des jetons.
| Package | Description |
|---|---|
| Microsoft. Identity.Web | Package principal pour ASP.NET Core applications web et API web. Active la connexion, la validation des jetons et l’appel d’API en aval. |
| Microsoft. Identity.Web.UI | Fournit des composants d'interface utilisateur pour les applications web ASP.NET Core, notamment les contrôleurs et les vues de connexion et de déconnexion. |
| Microsoft. Identity.Web.TokenAcquisition | API de niveau supérieur pour l’acquisition de jetons dans les applications clientes confidentielles (ASP.NET Core et .NET SDK). Gère automatiquement la gestion des jetons. |
| Microsoft. Identity.Web.TokenCache | Sérialiseurs de cache de jetons pour les applications clientes confidentielles de MSAL.NET. Prend en charge la mise en cache en mémoire, distribuée et basée sur la session. |
Packages de gestion des informations d’identification
Ces packages gèrent différents types d’informations d’identification d’authentification.
| Package | Description |
|---|---|
| Microsoft. Identity.Web.Certificate | Fonctionnalités de gestion des certificats pour MSAL.NET, notamment le chargement de certificats à partir de Azure Key Vault et de magasins locaux. |
| Microsoft. Identity.Web.Certificateless | Scénarios d’authentification sans certificat, tels que les identités managées et la fédération des identités de charge de travail. |
Packages d’intégration et d’API en aval
Ces packages vous aident à appeler des API protégées et à s’intégrer aux services Azure.
| Package | Description |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Interface de niveau supérieur pour appeler des API protégées en aval à partir d’applications clientes confidentielles avec gestion automatique des jetons. |
| Microsoft. Identity.Web. Azure | Permet aux applications web ASP.NET Core et aux API web d’utiliser les SDK Azure avec la plate-forme Microsoft Identity en fournissant des implémentations TokenCredential. |
| Microsoft. Identity.Web.OWIN | Permet aux applications web ASP.NET (OWIN/Katana) et aux API web sur .NET Framework d’utiliser le Plateforme d'identités Microsoft. |
paquets Microsoft Graph
Ces packages fournissent une intégration avec Microsoft Graph pour appeler des services de Microsoft 365.
| Package | Description |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Intégration de Microsoft Graph à l’aide du Kit de développement logiciel (SDK) Graph v5 et versions ultérieures. Recommandé pour les nouveaux projets. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Intégration bêta Microsoft Graph utilisant le Kit de développement logiciel (SDK) Graph v5 et versions ultérieures. Utilisez ce package pour accéder aux fonctionnalités en préversion. |
| Microsoft. Identity.Web.MicrosoftGraph | Intégration de Microsoft Graph à l'aide du kit de développement logiciel (SDK) Graph v4. Utilisez les paquets GraphServiceClient pour de nouveaux projets. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Intégration bêta de Microsoft Graph à l'aide du SDK Graph v4. |
Packages de scénarios avancés
Ces packages prennent en charge des scénarios d’authentification spécialisés.
| Package | Description |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Prise en charge des diagnostics et de la journalisation pour résoudre les problèmes d’authentification. |
| Microsoft. Identity.Web.OidcFIC | Implémentation du fournisseur FIC (Cloud Federation Identity Credential). Active les scénarios d’authentification multicloud. |
| Microsoft. Identity.Web.AgentIdentities | Méthodes d’assistance pour les scénarios d’identité des agents, y compris la création d’agents autonomes et les intégrations Copilot. |
Choisissez le bon forfait
Utilisez les exemples suivants pour installer les packages qui correspondent à votre scénario d’application.
Applications web qui autorisent la connexion des utilisateurs
Pour ASP.NET Core applications web qui connectent des utilisateurs avec Microsoft Entra ID, installez le package principal et le package d’interface utilisateur :
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
API web protégées
Pour ASP.NET Core API web qui valident les jetons des appelants authentifiés, installez le package principal :
dotnet add package Microsoft.Identity.Web
Applications démon et services en arrière-plan
Pour les applications démon ou les services en arrière-plan qui acquièrent des jetons sans interaction utilisateur, installez le package d’acquisition de jetons :
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Appel de Microsoft Graph
Pour les nouveaux projets, utilisez le package Graph SDK v5 :
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Si votre projet utilise le Kit de développement logiciel (SDK) Graph v4, installez plutôt le package d’intégration précédent :
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Utilisation de SDK Azure
Pour authentifier Kit de développement logiciel (SDK) Azure clients avec le Plateforme d'identités Microsoft, installez le package d’intégration Azure :
dotnet add package Microsoft.Identity.Web.Azure
Appel d'APIs personnalisées en aval
Pour appeler vos propres API protégées avec la gestion automatique des jetons, installez le package d’API en aval :
dotnet add package Microsoft.Identity.Web.DownstreamApi
Scénarios d’agent et de copilote
Pour créer des agents autonomes ou des intégrations copilotes, installez le package d’identités d’agent :
dotnet add package Microsoft.Identity.Web.AgentIdentities
Applications .NET Framework OWIN
Pour ASP.NET applications web et les API web sur .NET Framework (OWIN/Katana), installez le package OWIN :
dotnet add package Microsoft.Identity.Web.OWIN