Overzicht van de Microsoft Entra ID Auth SDK (sidecar)

De Microsoft Entra ID Auth SDK (sidecar) is een in containers geplaatste webservice die tokenaanroepen, validatie en beveiligde downstream-API-aanroepen verwerkt. Het wordt uitgevoerd als een aanvullende container naast uw toepassing, zodat u identiteitslogica kunt offloaden naar een toegewezen service. Door identiteitsbewerkingen in de Microsoft Entra ID Auth SDK (sidecar) te centraliseren, hoeft u geen complexe logica voor tokenbeheer in te sluiten in elke service, waardoor codeduplicatie en potentiële beveiligingsproblemen worden verminderd.

Als u bouwt met Kubernetes, in containers geplaatste services met Docker of moderne microservices op Azure, biedt de Microsoft Entra ID Auth SDK (sidecar) een gestandaardiseerde manier om verificatie en autorisatie in cloudeigen toepassingen te verwerken.

Wat is de Microsoft Entra ID Auth SDK (sidecar)?

De Microsoft Entra ID Auth SDK (sidecar) communiceert met uw toepassing via een HTTP-API voor verificatie en autorisatie, waardoor consistente integratiepatronen worden geboden, ongeacht uw technologiestack. In plaats van identiteitslogica rechtstreeks in uw toepassingscode in te sluiten, verwerkt de Microsoft Entra ID Auth SDK (sidecar) tokenbeheer, validatie en API-aanroepen via standaard HTTP-aanvragen.

Met deze benadering kunnen polyglot microservicesarchitecturen ontstaan waarbij verschillende services kunnen worden ontwikkeld in Python, Node.js, Go, Java en andere talen, terwijl consistente verificatiepatronen worden behouden.

De typische architectuur is als volgt:

Client-applicatie → Uw Web-API → Microsoft Entra ID Auth SDK (sidecar) → Microsoft Entra ID

Zie de Container Image voor de meest recente containerimages en versietags.

Security

Zorg ervoor dat uw Microsoft Entra ID Auth SDK-implementatie (sidecar) de aanbevolen procedures voor veilige bewerking volgt. De SDK moet worden uitgevoerd in een containeromgeving met beperkte netwerktoegang om onbevoegde toegang te voorkomen. Het openbaar beschikbaar maken van de SDK-API kan leiden tot beveiligingsproblemen, zoals het verkrijgen van onbevoegde tokens.

Raadpleeg Security Best Practices om best practices voor netwerk-, aanmeldgegevens- en runtimebeveiliging aan te bevelen.

Snel starten

Om aan de slag te gaan met de Microsoft Entra ID Auth SDK (sidecar), worden de volgende stappen aanbevolen:

1. Uw implementatie kiezen - Kubernetes, Docker of AKS selecteren
2. Instellingen configureren - Omgevingsvariabelen instellen
3. Een scenario kiezen - Volg een begeleid voorbeeld
4. Uitrollen naar productie - Beveiligingsrichtlijnen nalopen

Belangrijkste voordelen

De architectuur scheidt identiteitsproblemen van bedrijfslogica en biedt de volgende voordelen:

Wanneer gebruikt u de Microsoft Entra ID Auth SDK (sidecar) of Microsoft.Identity.Web

Zie Comparison met Microsoft. Identity.Web voor gedetailleerde richtlijnen voor het kiezen tussen de twee benaderingen.

Tokenvalidatie

De Microsoft Entra ID Auth SDK (sidecar) valideert zowel toegangstokens als id-tokens die zijn uitgegeven door Microsoft Entra ID, waarbij de handtekeningen worden geverifieerd op basis van de openbare sleutels van Microsoft Entra ID, de verlooptijden worden gecontroleerd en ervoor wordt gezorgd dat de tokens zijn bedoeld voor uw toepassing. Zodra het is gevalideerd, kunt u gebruikersclaims, rollen en bereiken extraheren om weloverwogen autorisatiebeslissingen te nemen binnen uw toepassingslogica.

Token ophalen/autorisatieheader maken

• On-Behalf-Of OAuth 2.0-stroom - De gebruikerscontext delegeren naar downstream-API's
• Clientreferificaties - Authenticatie tussen toepassingen
• Managed Identity - Inheemse Azure-serviceauthenticatie
• Agentidentiteit - Autonome of gedelegeerde agentpatronen

Downstream-API-aanroepen

• Tokens automatisch verkrijgen en koppelen
• Optionele aanvraagoverschrijvingen (bereiken, methode, headers)
• Ondersteuning voor ondertekende HTTP-aanvragen (PoP/SHR)

Scenarios en handleidingen

De volgende handleidingen zijn uitgebreide stapsgewijze zelfstudies met praktische codevoorbeelden die laten zien hoe u de Microsoft Entra ID Auth SDK (sidecar) integreert in uw toepassingen. Elk scenario biedt volledige voorbeelden van aanvragen/antwoorden, codefragmenten en implementatiepatronen die zijn afgestemd op verschillende programmeertalen en frameworks.

Architectuurpatronen

Een typische stroom waarbij uw client een web-API aanroept, de API identiteitsbewerkingen delegeert naar de Microsoft Entra ID Auth SDK (sidecar) via HTTP-eindpunten. De SDK valideert binnenkomende tokens met behulp van het /Validate eindpunt, verkrijgt tokens met behulp /AuthorizationHeader van en /AuthorizationHeaderUnauthenticateden kan rechtstreeks downstream-API's aanroepen met behulp van /DownstreamApi en /DownstreamApiUnauthenticated.

Het communiceert met Microsoft Entra ID voor tokenuitgifte en Open ID Connect-metagegevens ophalen, met architectuur die wordt gedemonstreerd in het volgende codefragment:

%%{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 ID Auth SDK (sidecar)]:::dnode
    end
    sidecar -->|Token validation & acquisition| entra[Microsoft Entra ID]:::dnode

Ondersteuning en middelen

De volgende bronnen bieden uitgebreide richtlijnen en hulp bij het oplossen van problemen en antwoorden op veelgestelde vragen.

Voor aanvullende hulp:

• Problemen melden over Microsoft-identity-webopslagplaats
• Raadpleeg Microsoft Entra ID handleidingen voor probleemoplossing

Verwante inhoud

• Installatiehandleiding
• Configuratiereferentie
• Comparison met Microsoft. Identity.Web
• Aanbevolen beveiligingsprocedures