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.
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
- Machen Sie eine Anwendungsberechtigung in der benutzerdefinierten API verfügbar.
- 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.
- Konfigurieren Sie die API im Sidecar mit der Basis-URL und dem
api://<api-client-id>/.defaultBereich. - 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