Översikt över Microsoft Entra SDK för agent-ID

Microsoft Entra SDK för agent-ID är en containerbaserad webbtjänst som hanterar tokenförvärv, validering och säkra underordnade API-anrop. Den körs som en tillhörande container tillsammans med ditt program, så att du kan avlasta identitetslogik till en dedikerad tjänst. Genom att centralisera identitetsåtgärder i Microsoft Entra SDK för agent-ID eliminerar du behovet av att bädda in komplex tokenhanteringslogik i varje tjänst, vilket minskar kodduplicering och potentiella säkerhetsrisker.

Om du skapar med Kubernetes, containerbaserade tjänster med Docker eller moderna mikrotjänster på Azure ger Microsoft Entra SDK för agent-ID ett standardiserat sätt att hantera autentisering och auktorisering i molnbaserade program.

Vad är Microsoft Entra SDK för agent-ID?

Microsoft Entra SDK för agent-ID kommunicerar med ditt program via ett HTTP-API för autentisering och auktorisering, vilket ger konsekventa integrationsmönster oavsett din teknikstack. I stället för att bädda in identitetslogik direkt i programkoden hanterar Microsoft Entra SDK för agent-ID tokenhantering, validering och API-anrop via standard-HTTP-begäranden.

Den här metoden möjliggör arkitekturer för flerspråkiga mikrotjänster där olika tjänster kan skrivas i Python, Node.js, Go, Java och andra samtidigt som konsekventa autentiseringsmönster upprätthålls.

Den typiska arkitekturen är följande:

Client Application → Ditt webb-API → Microsoft Entra SDK för agent-ID → Microsoft Entra ID

De senaste containeravbildnings- och versionstaggar finns i ContainerAvbildning för att komma igång.

Security

Se till att din Microsoft Entra SDK för agent-ID-distribution följer metodtipsen för säker drift. SDK:n måste köras i en containerbaserad miljö med begränsad nätverksåtkomst för att förhindra obehörig åtkomst. Att exponera SDK-API:et offentligt kan leda till säkerhetsproblem, till exempel obehörigt tokenförvärv.

Se Metodtips för säkerhet för att säkerställa bästa praxis för säkerhetsrekommendationer för nätverk, autentiseringsuppgifter och körning.

Snabbstart

För att komma igång med Microsoft Entra SDK för agent-ID rekommenderar vi följande steg:

1. Välj din distribution – Välj Kubernetes, Docker eller AKS
2. Konfigurera inställningar – Konfigurera miljövariabler
3. Välj ett scenario – Följ ett guidat exempel
4. Distribuera till produktion – Granska metodtips för säkerhet

Viktiga fördelar

Arkitekturen skiljer identitetsproblem från affärslogik, vilket ger följande fördelar:

När du ska använda Microsoft Entra SDK för agent-ID eller Microsoft. Identity.Web

Se Comparison med Microsoft. Identity.Web för detaljerad vägledning om hur du väljer mellan de två metoderna.

Tokenverifiering

Microsoft Entra SDK för agent-ID verifierar både åtkomsttoken och ID-token som utfärdats av Microsoft Entra ID, verifierar deras signaturer mot Microsoft Entra ID offentliga nycklar, kontrollerar förfallotiderna och ser till att token är avsedda för ditt program. När du har verifierat det kan du extrahera användaranspråk, roller och omfång för att fatta välgrundade auktoriseringsbeslut i din programlogik.

Tokenhantering/skapande av auktoriseringshuvud

• På Behalf-Of OAuth 2.0-flöde – Delegera användarkontext till vidarebefordrade API:er
• Klientautentiseringsuppgifter – Program-till-program-autentisering
• Hanterad identitet – Intern Azure tjänstautentisering
• Agentidentitet – Autonoma eller delegerade agentmönster

Underordnade API-anrop

• Hämta och bifoga token automatiskt
• Valfria åsidosättningar av begäran (omfång, metod, rubriker)
• Stöd för signerade HTTP-begäranden (PoP/SHR)

Scenarier och självstudier

Följande guider är omfattande stegvisa självstudier med praktiska kodexempel som visar hur du integrerar Microsoft Entra SDK för agent-ID i dina program. Varje scenario innehåller fullständiga exempel på begäran/svar, kodfragment och implementeringsmönster som är skräddarsydda för olika programmeringsspråk och ramverk.

Arkitekturmönster

Ett typiskt flöde där klienten anropar ett webb-API, och API:et delegerar identitetsåtgärder till Microsoft Entra SDK för agent-ID via HTTP-slutpunkter. SDK:et validerar inkommande token med hjälp av /Validate slutpunkten, hämtar token med hjälp av /AuthorizationHeader och /AuthorizationHeaderUnauthenticated, och kan direkt anropa underordnade API:er med hjälp av /DownstreamApi och /DownstreamApiUnauthenticated.

Den interagerar med Microsoft Entra ID för tokenutfärding och hämtning av Open ID Connect-metadata, med arkitektur som visas i följande kodfragment:

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

Support och resurser

Följande resurser ger omfattande vägledning och hjälp med felsökningsproblem och svar på vanliga frågor.

För ytterligare hjälp:

• Rapportera problem på lagringsplatsen Microsoft-identity-web
• Kontrollera felsökningsguiderna Microsoft Entra ID

Relaterat innehåll

• Installationsguide
• Konfigurationsreferens
• Comparison med Microsoft.Identity.Web
• Metodtips för säkerhet