Documentos de metadados de ID do cliente em Microsoft Entra ID (versão prévia)

Os Documentos de Metadados de Identificador de Cliente (CIMD) permitem que um cliente OAuth se identifique usando uma URL HTTPS em vez de um identificador de cliente pré-atribuído. O documento nessa URL contém os metadados OAuth do cliente. Microsoft Entra ID obtém e valida o documento, representa o cliente como uma identidade de agente no tenant e emite tokens de acordo com as políticas existentes de consentimento e segurança do tenant.

Importante

O suporte a documentos de metadados de ID do cliente no Microsoft Entra ID está em visualização pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou ter recursos restritos. Para obter mais informações, consulte Os Termos de Licença Universal para Serviços Online.

O CIMD é útil quando um cliente deve se conectar a muitos servidores de autorização com os quais ele não tem nenhuma relação anterior. Por exemplo, um cliente MCP pode descobrir servidores remotos do Model Context Protocol (MCP) em tempo de execução, e cada servidor pode usar um servidor de autorização diferente. Exigir que cada cliente seja registrado em cada servidor de autorização não é escalável.

O CIMD é definido pela especificação do Documento de Metadados da ID do Cliente OAuth. A especificação de autorização do MCP recomenda CIMD para clientes que não têm outro mecanismo de registro com suporte.

Como o CIMD funciona com Microsoft Entra ID

Um fluxo de autorização cimd típico tem as seguintes etapas:

Diagrama de raias mostrando um usuário conectando um cliente MCP a um servidor MCP. O cliente descobre o Microsoft Entra ID, envia uma solicitação de autorização com uma URL de CIMD como ID de cliente, e o Microsoft Entra ID recupera e valida o documento de metadados. O Microsoft Entra ID obtém o consentimento do usuário, se necessário, cria uma identidade de agente, se necessário, e emite um token de acesso que o cliente usa para chamar o servidor MCP.

  1. Um cliente MCP descobre que um servidor MCP usa Microsoft Entra ID como servidor de autorização.
  2. O cliente lê os metadados do servidor de autorização e determina que o CIMD tem suporte.
  3. O cliente envia uma solicitação de autorização. Seu client_id é a URL HTTPS do seu documento de metadados.
  4. Microsoft Entra ID recupera o documento e valida seu conteúdo, incluindo uma correspondência exata entre a URL solicitada client_id e a URL do documento client_id.
  5. Microsoft Entra ID gera uma ID estável do aplicativo a partir da URL canônica do documento e procura uma identidade de agente correspondente no tenant.
  6. Se a identidade não existir, a política do locatário determinará se ela pode ser criada por meio do consentimento. Em vez disso, um administrador pode adicionar o cliente CIMD com antecedência.
  7. Microsoft Entra ID valida o URI de redirecionamento solicitado e as permissões, obtém qualquer consentimento necessário e emite um token de acesso restrito ao público-alvo.
  8. O cliente apresenta o token para o servidor MCP.

A URL CIMD é a identidade durável do cliente. Mover o documento para outra URL cria uma identidade diferente e não preserva as permissões concedidas à identidade antiga.

Como Microsoft Entra representa um cliente CIMD

Microsoft Entra ID representa um cliente CIMD como uma identidade de agente em cada locatário em que o cliente é aprovado.

Uma identidade de agente apoiada pelo CIMD:

  • Tem uma ID de aplicativo derivada da URL de CIMD canônica.
  • Armazena a URL do CIMD como um identificador imutável.
  • Tem um blueprint de identidade de agente somente leitura em cada locatário e nenhuma entidade de serviço de blueprint.
  • Usa o documento de metadados externos como a fonte da verdade para sua configuração do OAuth.
  • Aparece no inventário de identidade do agente, nos logs de auditoria e nos logs de entrada.

Como os metadados permanecem no documento externo, os recursos que inspecionam a configuração OAuth armazenada em um objeto de aplicativo Entra podem não avaliar um cliente CIMD. Analise as considerações de governança antes de adotar o CIMD.

Quando usar CIMD

Os implementadores sempre devem preferir o pré-registro de um cliente com o Entra quando possível. Para integrações estratégicas ou de alto volume, uma ID de cliente registrada convencional fornece a identidade mais estável e as funcionalidades mais amplas do Entra. O CIMD só deve ser usado quando todas as seguintes condições se aplicarem:

  • O cliente deve se conectar a muitos servidores de autorização operados independentemente.
  • Os servidores de autorização não conseguem pré-registrar o cliente de forma razoável.
  • O cliente usa um fluxo OAuth delegado e presente do usuário.
  • O cliente pode publicar metadados estáveis em uma URL HTTPS pública.
  • O cliente aceita as limitações descritas neste artigo.

Um cliente MCP que descobre muitos servidores remotos em runtime é o cenário principal.

Capacidades e limitações suportadas

A tabela a seguir resume as capacidades e as limitações das identidades de agente com suporte do CIMD.

Capability Suporte ao CIMD
Fluxo de código de autorização do OAuth com um usuário autenticado Supported
Tokens de atualização Supported
Chave de verificação para Exchange de código (PKCE) Supported
Fluxo de credenciais do cliente Sem suporte
Fluxo de código do dispositivo Supported
Agindo como um recurso OAuth ou destinatário de token Sem suporte
Tokens de ID ou tokens SAML para login do usuário Sem suporte
Segredos do cliente compartilhados Sem suporte
Verificação Publisher ou certificação do Microsoft 365 Sem suporte
Várias identidades de agente que compartilham um modelo Sem suporte
Contas de usuário do agente Sem suporte
Windows Gerenciador de Contas Web (WAM) Sem suporte
Conversão local para ou de uma ID de cliente convencional Sem suporte

Modelo de segurança

O CIMD prova que um cliente controla uma URL. Ele não prova que o cliente é confiável ou deve receber acesso aos dados organizacionais.

Microsoft Entra ID aplica as seguintes proteções:

  • Identificadores somente via HTTPS: Uma ID de cliente CIMD deve ser uma URL HTTPS com um caminho. Informações do usuário e fragmentos não são permitidos na URL.
  • Correspondência exata de identidade: O client_id no documento deve corresponder exatamente à URL usada como a ID do cliente.
  • Correspondência exata de redirecionamento: O URI de redirecionamento em uma solicitação de autorização deve corresponder exatamente a um URI no documento.
  • Imposição da política de consentimento: A política de consentimento do locatário existente determina se os usuários podem adicionar o cliente e quais permissões delegadas podem ser concedidas.
  • Sem tokens somente de aplicativo: Os clientes CIMD não podem usar a concessão de credenciais do cliente.
  • Restrição de audiência: Microsoft Entra ID não emite tokens cujo público-alvo é o cliente CIMD.

Na política de consentimento recomendada padrão, os usuários só podem consentir com permissões OAuth de baixo risco para clientes CIMD. Permissões sensíveis exigem consentimento de administrador. Para obter diretrizes de administrador, consulte Gerenciar clientes CIMD no Microsoft Entra ID.

Considerações de governança

Antes de usar o CIMD, considere as seguintes considerações:

  • O proprietário do cliente controla o documento de metadados e pode alterar seu conteúdo.
  • A URL do documento é imutável no Microsoft Entra ID. Uma alteração de URL requer uma nova identidade e novas concessões de consentimento.
  • A política de gerenciamento de aplicativos e outros controles que inspecionam a configuração armazenada em um objeto de aplicativo não abrangem metadados que permanecem apenas no documento CIMD.
  • Os clientes CIMD não dão suporte à verificação do Publisher nem à certificação do Microsoft 365.
  • O Entra não fornece uma lista de permissões ou de bloqueio de domínio gerenciada pelo locatário para URLs CIMD.
  • Perder o controle da URL do documento ou de seu domínio pode afetar todos os locatários que confiam nessa identidade do cliente.

Use permissões delegadas de privilégio mínimo, pré-aprove clientes que precisam de acesso confidencial, monitore suas entradas e remova identidades que não são mais necessárias.