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.
Ein upstream-Client meldet den Benutzer an und sendet ein Zugriffstoken an den Agent. Der Agent übergibt dieses Token zur Überprüfung an das Sidecar, bevor er die Ansprüche des Benutzers verwendet oder einen On-Behalf-Of (OBO)-Austausch durchführt.
Das Sidecar stellt die Benutzeroberfläche für die Anmeldung nicht bereit. Verwenden Sie MSAL im Upstream-Web-, Desktop- oder mobilen Client.
Voraussetzungen
- Abschluss von Konfigurieren von Auth SDK Sidecar, einschließlich der Registrierung des Agents und der Anmeldeinformation.
- Ein Upstreamclient, der einen Benutzer anmeldet und ein Token für den verfügbar gemachten Bereich des Agents anfordert.
- Abschluss von Konfigurieren der delegierten Berechtigung und Gewähren des Zugriffs für den vorgelagerten Client. Diese Registrierungs- und Microsoft Graph Zustimmungsschritte gelten auch für das Sidecar; verwenden Sie nicht den ASP.NET Core Code aus diesem Artikel.
Konfigurieren Sie die Zielgruppe
Registrieren Sie einen Bereich, der von der API des Agents verfügbar gemacht wird. Der Upstream-Client fordert diesen Scope an, sodass das resultierende Zugriffstoken für den Agent vorgesehen ist.
Senden Sie kein für Microsoft Graph oder eine andere Ressource ausgestelltes Token an die Agent-API.
Konfigurieren Sie das Sidecar, um die Audience und den delegierten Gültigkeitsbereich der Agent-API zu überprüfen:
Legen Sie AzureAd:ClientId auf die während des Setups erfasste Client-ID fest, nicht auf eine Verzeichnisobjekt-ID. Setze AzureAd:Scopes auf access_agent. Der Upstream-Client fordert api://<agent-client-id>/access_agent an.
{
"AzureAd": {
"Instance": "https://login.microsoftonline.com/",
"TenantId": "<tenant-id>",
"ClientId": "<agent-client-id>",
"Scopes": "access_agent"
}
}
Verwenden Sie denselben AzureAd-Abschnitt, um die Blueprint-Anmeldeinformation zu konfigurieren. Die vollständige Einrichtung von Container- und Anmeldeinformationen finden Sie unter Konfigurieren des Auth SDK-Sidecars.
Überprüfen des Tokens
Leiten Sie den vollständigen eingehenden Autorisierungsheader an das Sidecar weiter:
GET /Validate
Authorization: ******
Die Antwort enthält das überprüfte Protokoll, Token und Claims. Verwenden Sie die Claims, um den Benutzer zu identifizieren und die Autorisierungsrichtlinie des Agents zu erzwingen.
Vertrauen Sie vor der Überprüfung keinen Ansprüchen, die vom Client oder Agenten decodiert werden.
Sidecar aufrufen
Überprüfen Sie den eingehenden Autorisierungsheader mit dem Sidecar, bevor Sie seine zurückgegebenen Claims verwenden. Setzen Sie voraus, dass protocoltid ist, die oid- und access_agent-Ansprüche nicht leer sind und scp im durch Leerzeichen getrennten Bearer-Anspruch enthalten ist. Identifizieren Sie den Anrufer anhand der Kombination von tid und oid. Lehnen Sie die Anforderung ab, wenn eine Überprüfung fehlschlägt, und wenden Sie die Autorisierungsrichtlinie des Agents vor der Verarbeitung an.
import requests
SIDECAR_URL = "http://localhost:5000"
def validate_caller(inbound_auth_header: str) -> dict:
"""Validate an inbound access token with the sidecar and return the token claims."""
response = requests.get(
f"{SIDECAR_URL}/Validate",
headers={"Authorization": inbound_auth_header},
timeout=5,
)
if response.status_code in (401, 403):
raise PermissionError("The sidecar rejected the caller's access token.")
response.raise_for_status()
result = response.json()
if result.get("protocol", "").lower() != "bearer":
raise PermissionError("The validated token used an unexpected protocol.")
claims = result.get("claims", {})
object_id = claims.get("oid")
tenant_id = claims.get("tid")
if not object_id or not tenant_id:
raise PermissionError("The validated token doesn't identify a user and tenant.")
if "access_agent" not in claims.get("scp", "").split():
raise PermissionError("The caller doesn't have the required delegated scope.")
return claims
# Call before processing each request:
claims = validate_caller(request.headers.get("Authorization"))
# Use claims["oid"] and claims["tid"] as the stable caller identity.
# Apply the agent's authorization policy before processing the request.
Behalten Sie SIDECAR_URL im Loopback im freigegebenen Netzwerk-Namespace bei. Ersetzen Sie den Platzhalter für den Autorisierungsheader durch den vollständigen Authorization Header, der vom Agent empfangen wird. Wenn Sie einen anderen Bereich verwenden als access_agent, aktualisieren Sie sowohl die Sidecar-Konfiguration als auch die Bereichsprüfung des Hilfsdiensts.
Die Antwort enthält auch das überprüfte Token, aber im Beispiel wird es nicht deserialisiert. Geben Sie das Token nicht zurück oder protokollieren Sie es. Wenn das Sidecar das Token ablehnt, lehnen Sie die Agent-Anforderung ab, anstatt das Token lokal zu decodieren oder ohne einen authentifizierten Benutzer fortzusetzen.
Geben Sie 401 Unauthorized für ein fehlendes oder ungültiges Token und 403 Forbidden zurück, wenn einem authentifizierten Aufrufer der erforderliche Bereich oder Zugriff fehlt. Fahren Sie nach einer der beiden Ablehnungen nicht mit der downstream-API fort.
Im Beispiel werden auch Anmeldeinformationen abgelehnt, die das Sidecar mit einem anderen Protokoll überprüft hat, z. B. ein app-only-Proof-of-Possession-Token. Verwenden Sie die überprüfte Mandanten-ID und Objekt-ID als stabilen Benutzerschlüssel. Wenden Sie die Autorisierungsrichtlinie des Agents vor der Verarbeitung der Anforderung an.
Nächste Schritte
- Steuern, welche Benutzer auf den Agenten zugreifen können.
- Anfordern der Zustimmung für delegierte Berechtigungen.
- Rufen Sie eine benutzerdefinierte API als Benutzer auf.