Visão geral do SDK do Microsoft Entra para Identidade do Agente

O Microsoft Entra SDK para Agent ID é um serviço web containerizado que gere a aquisição de tokens, validação e chamadas seguras de API downstream. Ele é executado como um contêiner complementar junto com seu aplicativo, permitindo que você descarregue a lógica de identidade para um serviço dedicado. Ao centralizar as operações de identidade no Microsoft Entra SDK para o ID do Agente, elimina a necessidade de incorporar lógica complexa de gestão de tokens em cada serviço, reduzindo a duplicação de código e potenciais vulnerabilidades de segurança.

Se estiver a construir com Kubernetes, serviços containerizados com Docker ou microserviços modernos no Azure, o SDK Microsoft Entra para Agent ID oferece uma forma padronizada de gerir autenticação e autorização em aplicações cloud-native.

O que é o Microsoft Entra SDK para ID de Agente?

O Microsoft Entra SDK para ID de Agente comunica com a sua aplicação através de uma API HTTP para autenticação e autorização, proporcionando padrões de integração consistentes independentemente da sua pilha tecnológica. Em vez de incorporar a lógica de identidade diretamente no código da sua aplicação, o Microsoft Entra SDK para Agent ID gere tokens, validação e chamadas API através de pedidos HTTP padrão.

Esta abordagem permite arquiteturas de microserviços poliglotas onde diferentes serviços podem ser escritos em Python, Node.js, Go, Java e outros, mantendo padrões de autenticação consistentes.

A arquitetura típica é a seguinte:

Para obter a imagem de contêiner e as tags de versão mais recentes, consulte a Imagem de contêiner para começar.

Segurança

Garanta que o seu SDK Microsoft Entra para implementação do Agent ID segue as melhores práticas para uma operação segura. O SDK deve ser executado em um ambiente conteinerizado com acesso restrito à rede, para impedir o acesso não autorizado. Expor a API do SDK publicamente pode levar a vulnerabilidades de segurança, como aquisição não autorizada de tokens.

Consulte as práticas recomendadas de segurança para garantir as práticas recomendadas para recomendações de segurança de rede, credenciais e tempo de execução.

Início rápido

Para começar com o Microsoft Entra SDK para Agent ID, recomendam-se os seguintes passos:

1. Escolha sua implantação - Selecione Kubernetes, Docker ou AKS
2. Definir configurações - Configurar variáveis de ambiente
3. Escolha um cenário - Siga um exemplo guiado
4. Implantar na produção - Revise as práticas recomendadas de segurança

Principais benefícios

A arquitetura separa as preocupações de identidade da lógica de negócios, fornecendo os seguintes benefícios:

Quando usar o Microsoft Entra SDK para ID de Agente ou Microsoft. Identity.Web

Veja Comparação com Microsoft. Identity.Web para orientações detalhadas sobre a escolha entre as duas abordagens.

Validação de token

O Microsoft Entra SDK for Agent ID valida tanto os tokens de acesso como os tokens de ID emitidos pela Microsoft Entra ID, verificando as suas assinaturas contra as chaves públicas do Microsoft Entra ID, verificando os tempos de validade e garantindo que os tokens são destinados à sua aplicação. Depois de validado, você pode extrair declarações, funções e escopos do usuário para tomar decisões de autorização informadas dentro da lógica do aplicativo.

Aquisição de tokens / criação de cabeçalho de autorização

• Fluxo OAuth 2.0 On-Behalf-Of - Delegar contexto do utilizador a APIs a jusante
• Credenciais do cliente - Autenticação de aplicativo para aplicativo
• Managed Identity - Autenticação nativa de serviços Azure
• Identidade do agente - Padrões de agente autônomos ou delegados

Chamadas de API downstream

• Obtenha e anexe tokens automaticamente
• Substituições de solicitação opcionais (escopos, método, cabeçalhos)
• Suporte a solicitações HTTP assinadas (PoP/SHR)

Cenários e tutoriais

Os guias seguintes são tutoriais completos, passo a passo, com exemplos práticos de código que demonstram como integrar o Microsoft Entra SDK for Agent ID nas suas aplicações. Cada cenário fornece exemplos completos de solicitação/resposta, trechos de código e padrões de implementação adaptados para diferentes linguagens de programação e estruturas.

Padrões de arquitetura

Um fluxo típico em que o seu cliente chama uma Web API, a API delega as operações de identidade ao Microsoft Entra SDK para o Agent ID através de endpoints HTTP. O SDK valida tokens de entrada usando o /Validate ponto de extremidade, adquire tokens usando /AuthorizationHeader e /AuthorizationHeaderUnauthenticatede pode invocar diretamente APIs downstream usando /DownstreamApi e /DownstreamApiUnauthenticated.

Interage com o Microsoft Entra ID para emissão de tokens e recuperação de metadados Open ID Connect, com a arquitetura demonstrada no seguinte excerto:

%%{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

Apoio e recursos

Os recursos a seguir fornecem orientação abrangente e ajuda com a solução de problemas e respostas a perguntas comuns.

Para obter ajuda adicional:

• Reporte problemas no repositório web Microsoft-identity
• Consulta Microsoft Entra ID guias de resolução de problemas

Conteúdo relacionado

• Guia de Instalação
• Referência de configuração
• Comparação com Microsoft. Identidade.Web
• Práticas recomendadas de segurança