APIs als Benutzer über einen lokalen Agenten aufrufen (Vorschau)

Nachdem der lokale Agent einen Benutzer anmeldet, fordern Sie die delegierten Berechtigungsbereiche an, die für die geschützte API erforderlich sind. MSAL ruft ein Zugriffstoken für den angemeldeten Nutzer ab und zwischenspeichert es für spätere Aufrufe. Die API autorisiert die Anforderung basierend auf dem Benutzer, der Client-Agent-ID und den Bereichen im Token.

Voraussetzungen

Important

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".

  • Schließen Sie das Anmelden von Benutzern über einen lokalen Agenten ab. Die MSAL.NET-Codeausschnitte hier werden in derselben Anwendung weitergeführt und verwenden deren Variable für die öffentliche Clientanwendung, app, wieder.
  • Rufen Sie den delegierten Bereich und den Endpunkt der Ziel-API beim Eigentümer ab. Ersetzen Sie <resource-client-id>, <delegated-scope> und <resource-url> durch die Werte für diese API.
  • Stimmen Sie die Einwilligung mit einem Mandantenadministrator ab, wenn die angeforderte Berechtigung oder die Mandantenrichtlinie dies erfordert.

Anfordern des API-Berechtigungsbereichs

Fordern Sie nur die delegierten Berechtigungsbereiche an, die für den Vorgang erforderlich sind:

var scopes = new[] { "api://<resource-client-id>/<delegated-scope>" };

Verwenden Sie für Microsoft Graph Microsoft Graph Scopes wie User.Read oder Files.Read.

Der Ressourcenbesitzer steuert, welche delegierten Berechtigungen verfügbar sind. Ein Benutzer oder Administrator muss zustimmen, bevor der Agent sie verwenden kann.

Ein Token abrufen

Prüfen Sie zunächst den MSAL-Cache, bevor Sie den Benutzer erneut auffordern:

AuthenticationResult result;
var account = (await app.GetAccountsAsync()).FirstOrDefault();

try
{
    result = await app.AcquireTokenSilent(scopes, account).ExecuteAsync();
}
catch (MsalUiRequiredException)
{
    result = await app.AcquireTokenInteractive(scopes).ExecuteAsync();
}

Überprüfen oder ändern Sie das Zugriffstoken nicht im Agent. Behandeln Sie es als opakes Zugangsmerkmal für die Ziel-API.

Aufrufen der API

Senden Sie das Token im HTTP-AuthorizationHeader:

Der Codeausschnitt geht davon aus, dass Ihre Anwendung einen HttpClient mit dem Namen httpClient bereitstellt. Behalten Sie den Tokenerwerb und den API-Aufruf im selben Vorgang bei, sodass der Aufruf den resultierenden result.AccessToken verwendet.

using System.Net.Http.Headers;

using var request = new HttpRequestMessage(HttpMethod.Get, "<resource-url>");
request.Headers.Authorization =
    new AuthenticationHeaderValue("Bearer", result.AccessToken);

using var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();

Fordern Sie ein Token für jede Ressource an. Ein für eine API ausgestelltes Token, z. B. Microsoft Graph, kann nicht mit einer anderen API verwendet werden.

Lokale öffentliche Clients unterstützen nur delegierten Zugriff. Sie können keine Client Credentials verwenden, um app-only-Token abzurufen.

Überprüfen Sie, ob die API die erwartete Antwort für den angemeldeten Benutzer zurückgibt. Die erfolgreiche Anmeldung allein belegt keinen API-Zugriff. Überprüfen Sie bei 401 Unauthorized, ob das Token für diese API angefordert wurde und dass die Überprüfungseinstellungen der API ihrer Registrierung entsprechen. Überprüfen Sie 403 Forbidden die delegierte Zustimmung und den Zugriff des Benutzers auf die angeforderte Ressource. Wenn die Zustimmung eine Administratorgenehmigung erfordert, übergeben Sie die Client-ID, die Zielressource und die angeforderten Bereiche, anstatt den Benutzer wiederholt aufzufordern.

Nächste Schritte