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 Microsoft Entra ID Auth SDK-Sidecar, wenn Ihr Cloud-Agent nicht mit ASP.NET Core und Microsoft.Identity.Web erstellt wird. Das Sidecar wird neben dem Agent ausgeführt, enthält die Blueprint-Anmeldeinformationen, ruft Token ab und speichert Token und gibt Autorisierungsheader oder Aufrufe nachgeschalteter APIs zurück.
Der Agent kommuniziert mit dem Sidecar über localhost in einem freigegebenen Netzwerk-Namespace. Machen Sie den Sidecar-Endpunkt nicht öffentlich verfügbar.
Wählen Sie diese Integration aus
Verwenden Sie das Sidecar, wenn der Agent Folgendes tun muss:
- Rufen Sie eine API mit seiner Agent-ID auf.
- Aufrufen einer API als angemeldeter Benutzer über On-Behalf-Of (OBO).
- Überprüfen Sie ein eingehendes Benutzertoken, und lesen Sie dessen Claims.
- Ändern Sie Anmeldeinformationsquellen, ohne den Agentcode zu ändern.
Verwenden Sie für ASP.NET Core Agents stattdessen die integrierte Microsoft.Identity.Web Anleitung in dieser Dokumentation.
Funktionsweise des Sidecars
| Component | Verantwortung |
|---|---|
| Upstream-Client | Meldet einen Benutzer an und sendet ein Zugriffstoken an den Agent, wenn der Benutzerkontext erforderlich ist. |
| Agent | Wendet Geschäftslogik an und fordert einen Autorisierungs-Header oder einen nachgelagerten Aufruf an. |
| Beiwagen | Überprüft eingehende Token, authentifiziert sich mit der konfigurierten freigegebenen Client-ID und den Blueprint-Anmeldeinformationen und zwischenspeichert Token. |
| Geschützte API | Überprüft das resultierende Zugriffstoken und autorisiert die Anforderung. |
Für einen Cloud-Agenten unterstützt das Sidecar zwei Tokenakquisitionsmuster:
- Nur-App-Agent-ID: Der Agent fordert ein Token ohne eingehendes Benutzertoken an.
- Agent, der für einen angemeldeten Benutzer fungiert: Der Agent leitet das eingehende Benutzertoken weiter, und das Sidecar führt OBO aus.
Wenn Sie eine Plattform erstellen, die separate Agents für Teams oder Kunden hosten oder Ihr Szenario ein dediziertes Benutzerkonto eines Agents benötigt, befolgen Sie das Lernprogramm für die Agent-Flotte.
Das folgende Diagramm zeigt einen Agenten und einen Sidecar, die in derselben privaten Umgebung ausgeführt werden. Der Agent fordert einen Autorisierungsheader vom Sidecar an, der ein Zugriffstoken von Microsoft Entra abruft.
Sicherheitsgrenze
Führen Sie das Sidecar im selben Netzwerknamespace wie der Agent aus, z. B. in demselben Pod oder derselben Container-App. Produktionsbuilds beschränken Aufrufer auf Loopback; Separate Container auf einer privaten Brücke reichen nicht aus. Befolgen Sie für Docker Compose die Shared-Network-Konfiguration. Nur vertrauenswürdiger Agent-Code sollte ihn aufrufen können. Verwenden Sie eine verwaltete Identität und Verbundidentitätsanmeldeinformation für gehostete Bereitstellungen. Verwenden Sie Clientgeheimnisse nur für die lokale Entwicklung.
Nächste Schritte
- Konfigurieren Sie das Auth SDK-Sidecar.
- Führen Sie das Sidecar lokal aus.
- Rufen Sie eine benutzerdefinierte API als Agent auf.