Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Microsoft. Identity.Web is een set NuGet-pakketten die het toevoegen van verificatie en autorisatie vereenvoudigen aan toepassingen die zijn geïntegreerd met de Microsoft identity platform. Elk pakket is gericht op een specifiek scenario, zodat u alleen installeert wat uw toepassing nodig heeft. In dit artikel worden de beschikbare pakketten beschreven en kunt u de juiste pakketten kiezen.
Kernpakketten
Deze pakketten bieden de fundamentele functionaliteit voor verificatie en tokenbeheer.
| Package | Beschrijving |
|---|---|
| Microsoft. Identity.Web | Het hoofdpakket voor ASP.NET Core web-apps en web-API's. Hiermee schakelt u aanmelding, tokenvalidatie en het aanroepen van downstream-API's in. |
| Microsoft. Identity.Web.UI | Biedt UI-onderdelen voor ASP.NET Core web-apps, waaronder aan- en afmeldingscontrollers en weergaven. |
| Microsoft. Identity.Web.TokenAcquisition | API op een hoger niveau voor het verkrijgen van tokens in vertrouwelijke clienttoepassingen (ASP.NET Core en .NET SDK). Verwerkt tokenbeheer automatisch. |
| Microsoft. Identity.Web.TokenCache | Serializers voor tokencache voor MSAL.NET vertrouwelijke clienttoepassingen. Ondersteunt in-memory, gedistribueerde en sessiegebaseerde caching. |
Referentiebeheerpakketten
Deze pakketten verwerken verschillende verificatiereferentietypen.
| Package | Beschrijving |
|---|---|
| Microsoft. Identity.Web.Certificate | Mogelijkheden voor certificaatbeheer voor MSAL.NET, waaronder het laden van certificaten uit Azure Key Vault en lokale winkels. |
| Microsoft. Identity.Web.Certificateless | Scenario's voor certificaatloze verificatie, zoals beheerde identiteiten en federatie van workloadidentiteiten. |
Downstream-API en integratiepakketten
Met deze pakketten kunt u beveiligde API's aanroepen en integreren met Azure-services.
| Package | Beschrijving |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Interface op een hoger niveau voor het aanroepen van met downstream beveiligde API's vanuit vertrouwelijke clienttoepassingen met automatisch tokenbeheer. |
| Microsoft. Identity.Web. Azure | Hiermee kunnen ASP.NET Core web-apps en web-API's Azure-SDK's gebruiken met de Microsoft identity platform door TokenCredential-implementaties te bieden. |
| Microsoft. Identity.Web.OWIN | Hiermee kunnen ASP.NET web-apps (OWIN/Katana) en web-API's in .NET Framework de Microsoft identity platform gebruiken. |
Microsoft Graph pakketten
Deze pakketten bieden integratie met Microsoft Graph voor het aanroepen van Microsoft 365 services.
| Package | Beschrijving |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Microsoft Graph integratie met de Graph SDK v5 en hoger. Aanbevolen voor nieuwe projecten. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Microsoft Graph Bèta-integratie met de Graph SDK v5 en hoger. Gebruik dit pakket voor toegang tot preview-functies. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph integratie met de Graph SDK v4. Gebruik GraphServiceClient pakketten voor nieuwe projecten. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Microsoft Graph Bèta-integratie met de Graph SDK v4. |
Geavanceerde scenariopakketten
Deze pakketten ondersteunen gespecialiseerde verificatiescenario's.
| Package | Beschrijving |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Ondersteuning voor diagnostiek en logregistratie voor het oplossen van verificatieproblemen. |
| Microsoft. Identity.Web.OidcFIC | Implementatie van FIC-provider (Cloud Federation Identity Credential). Maakt cross-cloud scenario's voor verificatie mogelijk. |
| Microsoft. Identity.Web.AgentIdentities | Helpermethoden voor agentidentiteitsscenario's, waaronder het bouwen van autonome agents en copilot-integraties. |
Kies het juiste pakket
Gebruik de volgende voorbeelden om de pakketten te installeren die overeenkomen met uw toepassingsscenario.
Webtoepassingen die gebruikers aanmelden
Voor ASP.NET Core web-apps die gebruikers aanmelden met Microsoft Entra ID, installeert u het kernpakket en het UI-pakket:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
Beveiligde web-API's
Installeer het kernpakket voor ASP.NET Core web-API's waarmee tokens van geverifieerde aanroepers worden gevalideerd:
dotnet add package Microsoft.Identity.Web
Daemon-toepassingen en achtergrondservices
Installeer het tokenverwervingspakket voor daemon-apps of achtergrondservices die tokens verkrijgen zonder tussenkomst van de gebruiker:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Aanroepen van Microsoft Graph
Gebruik voor nieuwe projecten het Graph SDK v5-pakket:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Als uw project Gebruikmaakt van Graph SDK v4, installeert u in plaats daarvan het eerdere integratiepakket:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Azure-SDK's gebruiken
Als u Azure SDK clients wilt verifiëren met de Microsoft identity platform, installeert u het Azure-integratiepakket:
dotnet add package Microsoft.Identity.Web.Azure
Aangepaste downstream-API's aanroepen
Als u uw eigen beveiligde API's wilt aanroepen met automatisch tokenbeheer, installeert u het downstream-API-pakket:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Agent- en copilot-scenario's
Installeer het pakket agentidentiteiten voor het bouwen van autonome agents of copilot-integraties:
dotnet add package Microsoft.Identity.Web.AgentIdentities
OWIN-toepassingen (.NET Framework)
Installeer het OWIN-pakket voor ASP.NET web-apps en web-API's in .NET Framework (OWIN/Katana):
dotnet add package Microsoft.Identity.Web.OWIN