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 das offizielle Sidecar-Beispiel, um die Agent-ID-Authentifizierung zu testen, ohne Microsoft Entra Anmeldeinformationen im Agentprozess zu platzieren. Das Beispiel enthält einen Agent, das Auth SDK-Sidecar und eine geschützte Wetter-API.
Voraussetzungen
- Docker Desktop oder eine andere Docker Compose-Umgebung.
- Ein Microsoft Entra-Mandant.
- Abschluss der Erstellung einer Identität für Ihren Agent, einschließlich Mandantenaktivierung, Administratorgenehmigungen und der aufgezeichneten Client- und Objekt-IDs.
- Eine Entwicklungsanmeldeinformation im Blueprint.
Verwenden Sie einen geheimen Clientschlüssel nur für lokale Tests. Verwenden Sie verwalteten Identitätsverbund für gehostete Bereitstellungen.
Beispiel abrufen
Klonen Sie das Repository der Microsoft Entra-Agent-ID-Beispiele, und öffnen Sie das sidecar/dev Verzeichnis.
Verwenden Sie das Containerlayout des Beispiels mit der Cloud-Agent-Sidecar-Konfiguration. Legen Sie die während des Setups aufgezeichnete Client-ID und die Blueprint-Anmeldeinformationen fest, und lassen Sie Identitätsüberschreibungen deaktiviert. Verwenden Sie keine Beispielflüsse mit AgentIdentity- oder AgentUserId-Overrides. Committen Sie die Umgebungsdatei oder das Clientgeheimnis nicht.
Beispiel starten
Starten Sie die Container, indem Sie den sidecar/dev Anweisungen des Beispiels folgen.
Der Agent muss das Sidecar über localhost in einem freigegebenen Netzwerknamespace aufrufen. Verwenden Sie die Docker Compose-Konfiguration, nicht separate Container, die über einen sidecar DNS-Namen kommunizieren. Machen Sie den Sidecarport nicht öffentlich verfügbar.
Überprüfen Sie vor dem Testen das Sidecar mit der Integritätsprüfung. Es bestätigt, dass das Sidecar Anfragen akzeptiert, nicht, dass Anmeldeinformationen, Zustimmung oder API-Zugriff ordnungsgemäß konfiguriert sind.
Verständnis des Tokenflusses
Bei Nur-App-Aufrufen verwendet das Sidecar die konfigurierte Agent-ID und das API-Profil, um ein Token für die downstream-Ressource abzurufen. Bei delegierten Aufrufen sendet der Agent das Zugriffstoken des angemeldeten Benutzers an das Sidecar, das es unter Verwendung des OAuth-On-Behalf-Of-Flusses gegen ein nachgeschaltetes Token austauscht. Der Agent kann einen Autorisierungsheader anfordern oder den Sidecar den nachgelagerten API-Aufruf weiterleiten lassen.
API-Zugriff testen
Testen Sie diese Vorgänge separat:
-
Nur App: Der Agent ruft
AgentIdentityfür eine benannte API ohneAuthorizationHeaderUnauthenticated-Abfrageparameter auf. - Benutzerdelegiert: Der Beispielclient meldet einen Benutzer an und übergibt das Zugriffstoken an den Agent. Der Agent leitet ihn an den authentifizierten Sidecar-Endpunkt für OBO weiter.
- Tokenüberprüfung: Die geschützte API überprüft die Signatur, den Aussteller, die Zielgruppe, das Ablaufen und die Agent-ID-Ansprüche des Zugriffstokens.
Stellen Sie sicher, dass App-only-Token über Anwendungsberechtigungen verfügen und delegierte Token die erwarteten Benutzer- und Bereichsansprüche enthalten.
Wechseln zu einer gehosteten Umgebung
Vor der Bereitstellung:
- Ersetzen Sie das Entwicklungsgeheimnis durch eine verwaltete Verbundanmeldeinformation für verwaltete Identitäten.
- Leiten Sie den Sidecar-Datenverkehr im freigegebenen Netzwerknamespace auf die Loopback-Schnittstelle.
- Konfigurieren Sie Produktionsumleitungs-URIs und API-Zielgruppen.
- Entfernen Sie nur für die Entwicklung verwendete Ports und Beispielanmeldeinformationen.
Nächster Schritt
Rufen Sie eine benutzerdefinierte API als Agent auf.