Aufrufen einer benutzerdefinierten API als Agent mit dem Auth SDK-Sidecar

Verwenden Sie app-only-Zugriff, wenn ein Cloud-Agent geplante, ereignisgesteuerte oder andere autonome Arbeit ohne einen angemeldeten Benutzer ausführt. In diesem Artikel wird eine benutzerdefinierte API aufgerufen, aber derselbe Sidecar-Fluss gilt für Azure Dienste und Microsoft Graph.

In diesem Artikel konfigurieren Sie Anwendungsberechtigungen und verwenden das Sidecar, um einen Nur-App-Autorisierungsheader zu erwerben oder die API aufzurufen.

Voraussetzungen

  • Abschluss des Konfigurierens des Auth SDK-Sidecars, einschließlich der Registrierung des Agents, der Client-ID und der Anmeldeinformationen.
  • Eine Anwendungsberechtigung, die von der benutzerdefinierten API verfügbar gemacht wird.

Zugriff konfigurieren

  1. Machen Sie eine Anwendungsberechtigung in der benutzerdefinierten API verfügbar.
  2. Erteilen Sie der Agent-ID diese Berechtigung, und überprüfen Sie die Administratorzustimmung. Verwenden Sie die freigegebene Client-ID für die Zustimmung und die Objekt-ID der Agentidentität, wenn Sie die App-Rollenzuweisung überprüfen.
  3. Konfigurieren Sie die API im Sidecar mit der Basis-URL und dem api://<api-client-id>/.default Bereich.
  4. Konfigurieren Sie die API, um das Agent-ID-Token und die erforderliche App-Rolle zu überprüfen.

Sidecar konfigurieren

Der Agent ruft den Sidecar über Loopback in ihrem gemeinsamen genutzten Netzwerknamespace auf. Das Sidecar verwendet die konfigurierte Client-ID und Anmeldeinformationen, um einen Autorisierungsheader für die API abzurufen.

Fügen Sie ein Nur-App-Profil für die benutzerdefinierte API hinzu. Lassen Sie Identitätsüberschreibungen wie im Sidecar-Setup beschrieben deaktiviert:

{
  "DownstreamApis": {
    "custom-api": {
      "BaseUrl": "https://api.contoso.com/",
      "Scopes": [
        "api://<custom-api-client-id>/.default"
      ],
      "RequestAppToken": true
    }
  }
}

Informationen zur Blaupausenidentität, Anmeldeinformationen und Containerkonfiguration finden Sie unter Konfigurieren des Auth SDK-Sidecars.

Abrufen eines Tokens und Aufrufen der API

GET /AuthorizationHeaderUnauthenticated/custom-api

Senden Sie die zurückgegebene authorizationHeader an die benutzerdefinierte API. Übergeben Sie keine AgentIdentity Override und senden Sie die Blueprint-Anmeldeinformationen nicht an die API.

Die API muss die Signatur, den Aussteller, die Zielgruppe, die Ablaufzeit, die Agent-ID-Ansprüche und den erforderlichen roles-Wert des Tokens überprüfen.

Alternativ können Sie POST /DownstreamApiUnauthenticated/custom-api verwenden, damit der Sidecar die konfigurierte API aufruft. Es ist keine Identitätsüberschreibung erforderlich.

Vergewissern Sie sich, dass der API-Vorgang mit der erforderlichen Rolle erfolgreich ist und eine Anforderung ohne diese Rolle ablehnt. Eine erfolgreiche Tokenantwort allein stellt keine API-Autorisierung her. Protokollieren Sie den Autorisierungsheader nicht.

Nächster Schritt

Authentifizieren von Benutzern beim Agenten