Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Microsoft. Identity.Web är en uppsättning NuGet-paket som förenklar tillägg av autentisering och auktorisering i program som integreras med Microsofts identitetsplattform. Varje paket är inriktat på ett specifikt scenario, så du installerar bara det programmet behöver. Den här artikeln beskriver de tillgängliga paketen och hjälper dig att välja rätt paket.
Kärnpaket
De här paketen tillhandahåller grundläggande funktioner för autentisering och tokenhantering.
| Package | Beskrivning |
|---|---|
| Microsoft. Identity.Web | Huvudpaketet för ASP.NET Core webbappar och webb-API:er. Aktiverar inloggning, tokenverifiering och anropande underordnade API:er. |
| Microsoft. Identity.Web.UI | Tillhandahåller gränssnittskomponenter för ASP.NET Core webbappar, inklusive inloggnings- och utloggningskontrollanter och vyer. |
| Microsoft. Identity.Web.TokenAcquisition | API på högre nivå för tokenförvärv i konfidentiella klientprogram (ASP.NET Core och .NET SDK). Hanterar tokenhantering automatiskt. |
| Microsoft. Identity.Web.TokenCache | Tokencacheserialiserare för MSAL.NET konfidentiella klientapplikationer. Stöder minnesintern, distribuerad och sessionsbaserad cachelagring. |
Hanteringspaket för autentiseringsuppgifter
Dessa paket hanterar olika typer av autentiseringsuppgifter.
| Package | Beskrivning |
|---|---|
| Microsoft. Identity.Web.Certificate | Certifikathanteringsfunktioner för MSAL.NET, inklusive inläsning av certifikat från Azure Key Vault och lokala arkiv. |
| Microsoft. Identity.Web.Certificateless | Scenarier med certifikatfri autentisering, till exempel hanterade identiteter och arbetsbelastningsidentitetsfederation. |
Underordnade API- och integreringspaket
De här paketen hjälper dig att anropa skyddade API:er och integrera med Azure tjänster.
| Package | Beskrivning |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Gränssnitt på högre nivå för att anropa underordnade skyddade API:er från konfidentiella klientprogram med automatisk tokenhantering. |
| Microsoft. Identity.Web. Azure | Genom att erbjuda TokenCredential implementeringar möjliggörs det för ASP.NET Core webbappar och webb-API:er att använda Azure SDK:er med Microsofts identitetsplattform. |
| Microsoft. Identity.Web.OWIN | Gör att ASP.NET webbappar (OWIN/Katana) och webb-API:er på .NET Framework kan använda Microsofts identitetsplattform. |
Microsoft Graph paket
Dessa paket tillhandahåller integrering med Microsoft Graph för att anropa Microsoft 365 tjänster.
| Package | Beskrivning |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Microsoft Graph integrering med Graph SDK v5 och senare. Rekommenderas för nya projekt. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Microsoft Graph Beta-integrering med Graph SDK v5 och senare. Använd det här paketet för att få åtkomst till förhandsgranskningsfunktioner. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph integrering med Graph SDK v4. Använd GraphServiceClient paket för nya projekt. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Microsoft Graph Beta-integrering med Graph SDK v4. |
Avancerade scenariopaket
Dessa paket stöder specialiserade autentiseringsscenarier.
| Package | Beskrivning |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Stöd för diagnostik och loggning för felsökning av autentiseringsproblem. |
| Microsoft. Identity.Web.OidcFIC | Implementering av FIC-provider (Cloud Federation Identity Credential). Aktiverar scenarier för molnbaserad autentisering. |
| Microsoft.Identity.Web.AgentIdentities | Hjälpmetoder för agentidentitetsscenarier, inklusive att skapa autonoma agenter och copilot-integreringar. |
Välj rätt paket
Använd följande exempel för att installera de paket som matchar ditt programscenario.
Webbprogram som loggar in användare
Installera kärnpaketet och användargränssnittspaketet för ASP.NET Core webbappar som loggar in användare med Microsoft Entra ID:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
Skyddade webb-API:er
Installera kärnpaketet för ASP.NET Core webb-API:er som validerar token från autentiserade anropare:
dotnet add package Microsoft.Identity.Web
Daemonprogram och bakgrundstjänster
För daemonappar eller bakgrundstjänster som hämtar token utan användarinteraktion installerar du paketet för tokenförvärv:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Anropa Microsoft Graph
För nya projekt använder du Graph SDK v5-paketet:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Om ditt projekt använder Graph SDK v4 installerar du det tidigare integrationspaketet i stället:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Använda Azure-SDK:er
Om du vill autentisera Azure SDKs klienter med Microsofts identitetsplattform installerar du integreringspaketet för Azure:
dotnet add package Microsoft.Identity.Web.Azure
Anropa anpassade nedströms-API:er
Om du vill anropa dina egna skyddade API:er med automatisk tokenhantering installerar du det underordnade API-paketet:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Scenarier med agent och andrepilot
Installera agentidentitetspaketet för att skapa autonoma agenter eller copilot-integreringar:
dotnet add package Microsoft.Identity.Web.AgentIdentities
OWIN-applikationer (.NET Framework)
Installera OWIN-paketet för ASP.NET webbappar och webb-API:er på .NET Framework (OWIN/Katana):
dotnet add package Microsoft.Identity.Web.OWIN