Microsoft Entra SDK für AgentID: Übersicht

Das Microsoft Entra SDK für AgentID ist ein containerisierter Webdienst, der Tokenakquisition, Validierung und sichere nachgeschaltete API-Aufrufe verarbeitet. Sie wird zusammen mit Ihrer Anwendung als Begleitcontainer ausgeführt, sodass Sie identitätslogik in einen dedizierten Dienst entladen können. Durch die Zentralisierung von Identitätsoperationen im Microsoft Entra SDK für AgentID entfällt die Notwendigkeit, komplexe Tokenverwaltungslogik in jeden Dienst einzubetten, wodurch die Codeduplizierung und potenzielle Sicherheitsrisiken reduziert werden.

Wenn Sie mit Kubernetes, containerisierten Diensten mit Docker oder modernen Microservices in Azure erstellen, bietet das Microsoft Entra SDK für AgentID eine standardisierte Möglichkeit zum Verarbeiten der Authentifizierung und Autorisierung in cloudeigenen Anwendungen.

Was ist das Microsoft Entra SDK für AgentID?

Das Microsoft Entra SDK für AgentID kommuniziert mit Ihrer Anwendung über eine HTTP-API für Authentifizierung und Autorisierung und stellt unabhängig vom Technologiestapel konsistente Integrationsmuster bereit. Anstatt Identitätslogik direkt in Ihren Anwendungscode einzubetten, verarbeitet das Microsoft Entra SDK für AgentID Tokenverwaltung, Validierung und API-Aufrufe über standardmäßige HTTP-Anforderungen.

Dieser Ansatz ermöglicht polyglot microservices-Architekturen, bei denen verschiedene Dienste in Python, Node.js, Go, Java und anderen geschrieben werden können, während konsistente Authentifizierungsmuster beibehalten werden.

Die typische Architektur lautet wie folgt:

Clientanwendung → Ihre Web-API → Microsoft Entra SDK für AgentID → Microsoft Entra ID

Die neuesten Container-Images und Versions-Tags finden Sie im Container-Image, um zu starten.

Sicherheit

Stellen Sie sicher, dass Ihr Microsoft Entra SDK für die AgentID-Bereitstellung bewährte Methoden für den sicheren Betrieb befolgt. Das SDK muss in einer containerisierten Umgebung mit eingeschränktem Netzwerkzugriff ausgeführt werden, um nicht autorisierten Zugriff zu verhindern. Das öffentliche Verfügbarmachen der SDK-API kann zu Sicherheitsrisiken führen, z. B. zum Erwerb nicht autorisierter Token.

Lesen Sie Security Best Practices, um sich über empfohlene bewährte Methoden zur Netzwerksicherheit, Laufzeitsicherheit und für Anmeldeinformationen zu informieren.

Quick Start

Um mit dem Microsoft Entra SDK für AgentID zu beginnen, werden die folgenden Schritte empfohlen:

1. Wählen Sie Ihre Bereitstellung aus – Wählen Sie Kubernetes, Docker oder AKS aus.
2. Konfigurieren von Einstellungen – Einrichten von Umgebungsvariablen
3. Wählen Sie ein Szenario – Folgen Sie einem geführten Beispiel
4. Bereitstellung in der Produktion – Bewährte Sicherheitspraktiken überprüfen

Hauptvorteile

Die Architektur trennt Identitätsbedenken von geschäftslogik und bietet die folgenden Vorteile:

Wann das Microsoft Entra SDK für AgentID oder Microsoft.Identity.Web verwendet wird

Detaillierte Anleitungen zur Auswahl zwischen den beiden Ansätzen finden Sie unter "Vergleich mit Microsoft.Identity.Web ".

Tokenüberprüfung

Das Microsoft Entra SDK für AgentID überprüft sowohl Zugriffstoken als auch ID-Token, die von Microsoft Entra ID ausgestellt wurden, und überprüft ihre Signaturen anhand der öffentlichen Schlüssel der Microsoft Entra-ID, überprüft Ablaufzeiten und stellt sicher, dass die Token für Ihre Anwendung vorgesehen sind. Nach der Überprüfung können Sie Benutzeransprüche, Rollen und Bereiche extrahieren, um fundierte Autorisierungsentscheidungen innerhalb Ihrer Anwendungslogik zu treffen.

Tokenerwerb / Autorisierungsheadererstellung

• On-Behalf-Of OAuth 2.0-Ablauf – Übertragung des Benutzerkontextes an nachgeschaltete APIs
• Clientanmeldeinformationen – Anwendungs-zu-Anwendung-Authentifizierung
• Verwaltete Identität – native Azure-Dienstauthentifizierung
• Agent-Identität – Autonome oder delegierte Agentmuster

Nachgeschaltete API-Aufrufe

• Automatisches Erfassen und Anhängen von Tokens
• Optionale Anforderungsmodifikationen (Berechtigungsumfänge, Methode, Kopfzeilen)
• Signierte HTTP-Anforderungen (PoP/SHR)-Unterstützung

Szenarien und Lernprogramme

Die folgenden Anleitungen sind umfassende schrittweise Lernprogramme mit praktischen Codebeispielen, die zeigen, wie Sie das Microsoft Entra SDK für AgentID in Ihre Anwendungen integrieren. Jedes Szenario bietet vollständige Anforderungs-/Antwortbeispiele, Codeausschnitte und Implementierungsmuster, die auf unterschiedliche Programmiersprachen und Frameworks zugeschnitten sind.

Architekturmuster

Ein typischer Fluss, in dem Ihr Client eine Web-API aufruft, delegiert die API Identitätsvorgänge an das Microsoft Entra SDK für AgentID über HTTP-Endpunkte. Das SDK überprüft eingehende Token mithilfe des /Validate Endpunkts, erwirbt Token mithilfe /AuthorizationHeader und /AuthorizationHeaderUnauthenticatedkann direkt nachgeschaltete APIs mithilfe /DownstreamApi und /DownstreamApiUnauthenticatedaufrufen.

Es interagiert mit Microsoft Entra ID für die Tokenausstellung und das Abrufen von Open ID Connect-Metadaten, wobei die Architektur im folgenden Codeausschnitt veranschaulicht wird:

%%{init: {
  "theme": "base",
  "themeVariables": {
    "background": "#121212",
    "primaryColor": "#1E1E1E",
    "primaryBorderColor": "#FFFFFF",
    "primaryTextColor": "#FFFFFF",
    "textColor": "#FFFFFF",
    "lineColor": "#FFFFFF",
    "labelBackground": "#000000"
  }
}}%%
flowchart LR
    classDef dnode fill:#1E1E1E,stroke:#FFFFFF,stroke-width:2px,color:#FFFFFF
    linkStyle default stroke:#FFFFFF,stroke-width:2px,color:#FFFFFF

    client[Client Application]:::dnode -->| Bearer over HTTP | webapi[Web API]:::dnode
    subgraph Pod / Host
        webapi -->|"/Validate<br/>/AuthorizationHeader/{name}<br/>/DownstreamApi/{name}"| sidecar[Microsoft Entra SDK for AgentID]:::dnode
    end
    sidecar -->|Token validation & acquisition| entra[Microsoft Entra ID]:::dnode

Unterstützung und Ressourcen

Die folgenden Ressourcen bieten umfassende Anleitungen und Hilfe bei der Problembehandlung und Antworten auf häufig gestellte Fragen.

Weitere Hilfe:

• Melden von Problemen im Microsoft-Identity-Web-Repository
• Microsoft Entra ID -Anleitungen zur Problembehandlung überprüfen

Weitere Ressourcen

• Dokumentation zu Microsoft Entra ID
• Microsoft Identity Platform-Dokumentation
• Microsoft Identity Web Repository
• Kubernetes-Dokumentation
• Docker-Dokumentation