Benutzer über einen lokalen Agenten anmelden (Vorschau)

Ein lokaler Agent läuft auf einem Endgerät und kann weder ein Clientgeheimnis noch ein Zertifikat sicher speichern. Konfigurieren Sie die Anwendung als öffentlichen OAuth-Client und verwenden Sie den Autorisierungscodefluss mit Proof Key für Code Exchange (PKCE).

Der Benutzer meldet sich über einen Browser an. Der Agent empfängt einen Autorisierungscode bei seinem registrierten Umleitungs-URI und löst den Code ohne Clientanmeldeinformationen ein.

Wichtig

Die Authentifizierung des lokalen Agents befindet sich in der Vorschau. Diese Vorschau wird ohne Vereinbarung auf Serviceebene bereitgestellt und wird für Produktionsworkloads nicht empfohlen. Einige Features werden möglicherweise nicht unterstützt oder verfügen über eingeschränkte Funktionen. Weitere Informationen finden Sie unter "Universelle Lizenzbedingungen für Onlinedienste".

Voraussetzungen

Sie benötigen einen Microsoft Entra Mandanten, in dem Sie eine Agent-ID registrieren können, oder einen Mandanten, der Metadatendokumente für Client-IDs (CIMD) unterstützt.

Auswählen einer Client-ID

Auswahl Client-ID Verwenden Sie, wenn
Registrieren Sie eine Agent-ID in Microsoft Entra Von Microsoft Entra zugewiesene Client-ID Empfohlen, wenn Sie wissen, dass der Agent eine Verbindung mit Microsoft Entra herstellt.
Ein CIMD verwenden Öffentliche HTTPS-URL des Metadatendokuments des Clients Wird verwendet, wenn derselbe verteilte Client eine Verbindung mit unabhängig betriebenen Autorisierungsservern herstellt und die Vorregistrierung nicht praktikabel ist.

Bevorzugen Sie nach Möglichkeit eine registrierte Agent-ID. Weitere Informationen zu CIMD finden Sie unter Client-ID-Metadatendokumente in Microsoft Entra ID.

Registrieren Sie die Agent-ID

  1. Erstellen Sie einen Einzelinstanzen-Blueprint, und stellen Sie dessen Agent-ID bereit. Wählen Sie den Instanzmodus aus, wenn Sie den Blueprint erstellen. Sie können ihn danach nicht mehr ändern.
  2. Fügen Sie den umleitungs-URI hinzu, der von Ihrer Authentifizierungsbibliothek unter der Plattform des Blueprints publicClient empfohlen wird.
  3. Notieren Sie sich die Client-ID und die Mandanten-ID der Agenten-ID.

Jede Installation verwendet dieselbe Client-ID. Erstellen Sie keine separate Agent-ID für jedes Gerät, und fügen Sie für diesen Fluss keine geheimen Clientschlüssel, Zertifikate oder Verbundidentitätsanmeldeinformationen hinzu.

Informationen zu Umleitungs-URI-Optionen finden Sie in der Desktop-App, die Web-APIs aufruft: Codekonfiguration.

Anmelden mit MSAL.NET

Installieren Sie MSAL.NET:

dotnet add package Microsoft.Identity.Client

Erstellen sie eine öffentliche Clientanwendung:

using Microsoft.Identity.Client;

var app = PublicClientApplicationBuilder
    .Create("<agent-client-id>")
    .WithAuthority("https://login.microsoftonline.com/<tenant-id>")
    .WithDefaultRedirectUri()
    .Build();

Melden Sie den Benutzer an, ohne delegierte Berechtigungen für eine API anzufordern:

var result = await app
    .AcquireTokenInteractive(Array.Empty<string>())
    .ExecuteAsync();

Console.WriteLine($"Signed in as {result.Account.Username}");

AcquireTokenInteractive verfügt nicht über eine parameterlose Überladung. Übergeben Sie eine leere Bereichssammlung, wenn der Agent den Benutzer nur anmelden muss. MSAL fügt die reservierten OpenID Connect-Bereiche hinzu, die für die Anmeldung erforderlich sind, fordert jedoch keinen delegierten Bereich für eine API an.

MSAL öffnet den Systembrowser, verwendet PKCE, überprüft die Antwort und speichert das Konto im Cache. Verwenden Sie eine mandantenspezifische Autorität für eine registrierte Agent-ID. Verwenden Sie nicht den Kontonamen oder das ID-Token, um den Zugriff auf eine API zu autorisieren. Fordern Sie im nächsten Schritt die delegierten Berechtigungen der API an.

Verwenden Sie einen CIMD-Client für delegierten API-Zugriff (Vorschau)

Verwenden Sie die CIMD-URL als Client-ID in einer OAuth-Bibliothek, die URL-wertige Client-IDs unterstützt. Die Bibliothek muss den Autorisierungscodefluss mit PKCE verwenden und darf keine Clientanmeldeinformationen senden, wenn sie den Code einlöst.

CIMD unterstützt keine ID-Token für die Benutzeranmeldung. Diese Verzweigung verwendet die Browserauthentifizierung, um delegierten API-Zugriff zu erhalten, nicht das zuvor gezeigte, nur für die Anmeldung bestimmte MSAL.NET-Ergebnis. Fordern Sie die delegierten Berechtigungsbereiche der Ressource an, indem Sie das CIMD-Konfigurationsverfahren befolgen.

Informationen zu Metadaten- und Anforderungen für Umleitungs-URIs finden Sie unter Konfigurieren eines Clients mit einem Client-ID-Metadatendokument.

Nächster Schritt

Aufrufen von APIs als angemeldeter Benutzer.