Führen Sie das Auth SDK-Sidecar für die lokale Entwicklung aus

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 AgentIdentity für eine benannte API ohne AuthorizationHeaderUnauthenticated-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.