Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Microsoft. Identity.Web ist eine Reihe von NuGet-Paketen, die das Hinzufügen von Authentifizierung und Autorisierung zu Anwendungen vereinfachen, die in die Microsoft Identity Platform integriert werden. Jedes Paket zielt auf ein bestimmtes Szenario ab, sodass Sie nur das installieren, was Ihre Anwendung benötigt. Dieser Artikel beschreibt die verfügbaren Pakete und hilft Ihnen bei der Auswahl des richtigen Pakets.
Erforderliche Pakete
Diese Pakete bieten die grundlegenden Funktionen für die Authentifizierung und Die Tokenverwaltung.
| Paket | Beschreibung |
|---|---|
| Microsoft. Identity.Web | Das Hauptpaket für ASP.NET Core Web-Apps und Web-APIs. Ermöglicht die Anmelde-, Tokenüberprüfung und das Aufrufen von downstream-APIs. |
| Microsoft. Identity.Web.UI | Stellt UI-Komponenten für ASP.NET Core Web-Apps bereit, einschließlich Anmelde- und Abmeldecontrollern und Ansichten. |
| Microsoft. Identity.Web.TokenAcquisition | API auf höherer Ebene für den Tokenerwerb in vertraulichen Clientanwendungen (ASP.NET Core und .NET SDK). Verarbeitet die Tokenverwaltung automatisch. |
| Microsoft. Identity.Web.TokenCache | Tokencache-Serialisierer für MSAL.NET vertrauliche Clientanwendungen. Unterstützt speicherinternes, verteiltes und sitzungsbasiertes Caching. |
Lösungen zur Zugangsdatenverwaltung
Diese Pakete verarbeiten verschiedene Typen von Authentifizierungsdaten.
| Paket | Beschreibung |
|---|---|
| Microsoft. Identity.Web.Certificate | Zertifikatverwaltungsfunktionen für MSAL.NET, einschließlich des Ladens von Zertifikaten aus Azure Key Vault und lokalen Speicher. |
| Microsoft. Identity.Web.Certificateless | Szenarien mit zertifikatloser Authentifizierung, wie etwa verwaltete Identitäten und Workload Identity Federation. |
Nachgeschaltete API- und Integrationspakete
Diese Pakete helfen Ihnen, geschützte APIs aufzurufen und in Azure Dienste zu integrieren.
| Paket | Beschreibung |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Schnittstelle höherer Ebene zum Aufrufen nachgeschalteter geschützter APIs von vertraulichen Clientanwendungen mit automatischer Tokenverwaltung. |
| Microsoft. Identity.Web. Azure | Ermöglicht ASP.NET Core Web-Apps und Web-APIs, Azure SDKs mit der Microsoft-Identitätsplattform zu verwenden, indem TokenCredential-Implementierungen bereitgestellt werden. |
| Microsoft. Identity.Web.OWIN | Ermöglicht ASP.NET Web-Apps (OWIN/Katana) und Web-APIs in dem .NET Framework die Verwendung der Microsoft Identity Plattform. |
Microsoft Graph-Pakete
Diese Pakete bieten eine Integration mit Microsoft Graph für die Nutzung von Microsoft 365-Diensten.
| Paket | Beschreibung |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Microsoft Graph Integration mithilfe des Graph SDK v5 und höher. Empfohlen für neue Projekte. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Microsoft Graph Beta-Integration mit dem Graph SDK v5 und höher. Verwenden Sie dieses Paket, um auf Vorschaufeatures zuzugreifen. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph Integration mit dem Graph SDK v4. Verwenden Sie GraphServiceClient Pakete für neue Projekte. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Microsoft Graph Beta-Integration mit dem Graph SDK v4. |
Erweiterte Szenariopakete
Diese Pakete unterstützen spezielle Authentifizierungsszenarien.
| Paket | Beschreibung |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Diagnose- und Protokollierungsunterstützung für die Behandlung von Authentifizierungsproblemen. |
| Microsoft. Identity.Web.OidcFIC | Implementierung des Cloud Federation Identity Credential (FIC)-Anbieters. Ermöglicht Szenarien für die cloudübergreifende Authentifizierung. |
| Microsoft. Identity.Web.AgentIdentities | Hilfsmethoden für Agentidentitätsszenarien, einschließlich der Erstellung autonomer Agents und Copilot-Integrationen. |
Wählen Sie das richtige Paket
Verwenden Sie die folgenden Beispiele, um die Pakete zu installieren, die Ihrem Anwendungsszenario entsprechen.
Webanwendungen, die Benutzer anmelden
Installieren Sie für ASP.NET Core Web-Apps, die Benutzer mit Microsoft Entra ID anmelden, das Kernpaket und das Benutzeroberflächenpaket:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
Geschützte Web-APIs
Installieren Sie für ASP.NET Core Web-APIs, die Token von authentifizierten Anrufern überprüfen, das Kernpaket:
dotnet add package Microsoft.Identity.Web
Daemon-Anwendungen und Hintergrunddienste
Installieren Sie für Daemon-Apps oder Hintergrunddienste, die Token ohne Benutzerinteraktion abrufen, das Tokenakquisitionspaket:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Aufrufen von Microsoft Graph
Verwenden Sie für neue Projekte das Graph SDK v5-Paket:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Wenn Ihr Projekt graph SDK v4 verwendet, installieren Sie stattdessen das frühere Integrationspaket:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Verwenden von Azure SDKs
Um Azure SDK Clients mit dem Microsoft Identity Platform zu authentifizieren, installieren Sie das Azure Integrationspaket:
dotnet add package Microsoft.Identity.Web.Azure
Aufrufen benutzerdefinierter Downstream-APIs
Um Ihre eigenen geschützten APIs mit automatischer Tokenverwaltung aufzurufen, installieren Sie das nachgeschaltete API-Paket:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Agent- und Copilot-Szenarien
Installieren Sie zum Erstellen autonomer Agents oder Copilot-Integrationen das Agentidentitätspaket:
dotnet add package Microsoft.Identity.Web.AgentIdentities
OWIN-Anwendungen (.NET Framework)
Installieren Sie für ASP.NET Web-Apps und Web-APIs unter .NET Framework (OWIN/Katana) das OWIN-Paket:
dotnet add package Microsoft.Identity.Web.OWIN