Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um agente local é executado em um dispositivo de endpoint e não pode armazenar com segurança um segredo do cliente nem um certificado. Configure-o como um cliente público OAuth e use o fluxo de código de autorização com a Chave de Prova para Exchange de Código (PKCE).
O usuário entra por meio de um navegador. O agente recebe um código de autorização no URI de redirecionamento registrado e troca o código sem credencial de cliente.
Importante
A autenticação do agente local está em versão prévia. 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.
Prerequisites
Você precisa de um tenant do Microsoft Entra no qual possa registrar uma ID de agente ou de um tenant com suporte a Documentos de Metadados de ID do Cliente (CIMD).
Escolha uma ID do cliente
| Option | ID do cliente | Usar quando |
|---|---|---|
| Registrar uma ID do agente no Microsoft Entra | ID do cliente atribuída por Microsoft Entra | Recomendado quando você sabe que o agente se conecta ao Microsoft Entra. |
| Usar um CIMD | URL HTTPS pública do documento de metadados do cliente | Use quando o mesmo cliente distribuído se conecta a servidores de autorização operados independentemente e o pré-registro não é prático. |
Prefira uma ID do Agente registrada quando possível. Para obter mais informações sobre CIMD, consulte documentos de metadados de Client ID no Microsoft Entra ID.
Registrar o ID do agente
- Crie um blueprint de instância única e provisione sua ID do Agente. Escolha o modo de instância ao criar o blueprint; você não pode alterá-lo depois.
- Adicione o URI de redirecionamento recomendado pela biblioteca de autenticação na plataforma do
publicClientblueprint. - Registre a ID do cliente e a ID do locatário da ID do Agente.
Cada instalação usa a mesma ID do cliente. Não crie uma ID de Agente separada para cada dispositivo e não adicione um segredo do cliente, um certificado ou uma credencial de identidade federada para esse fluxo.
Para obter opções de URI de redirecionamento, consulte o aplicativo desktop que chama APIs Web: configuração de código.
Entre com MSAL.NET
Instalar MSAL.NET:
dotnet add package Microsoft.Identity.Client
Criar um aplicativo cliente público:
using Microsoft.Identity.Client;
var app = PublicClientApplicationBuilder
.Create("<agent-client-id>")
.WithAuthority("https://login.microsoftonline.com/<tenant-id>")
.WithDefaultRedirectUri()
.Build();
Conecte o usuário sem solicitar permissões delegadas para uma API:
var result = await app
.AcquireTokenInteractive(Array.Empty<string>())
.ExecuteAsync();
Console.WriteLine($"Signed in as {result.Account.Username}");
AcquireTokenInteractive não tem uma sobrecarga sem parâmetros. Passe uma coleção de escopo vazia quando o agente só precisar entrar no usuário. A MSAL adiciona os escopos reservados do OpenID Connect necessários para entrar, mas não solicita um escopo delegado para uma API.
A MSAL abre o navegador do sistema, usa PKCE, valida a resposta e armazena em cache a conta. Use uma autoridade específica do locatário para uma ID de agente registrada. Não use o nome da conta ou o token de ID para autorizar o acesso a uma API. Solicite os escopos delegados da API na próxima etapa.
Usar um cliente CIMD para acesso delegado à API (versão prévia)
Use a URL do CIMD como a ID do cliente em uma biblioteca OAuth que dá suporte a IDs de cliente com valor de URL. A biblioteca deve usar o fluxo de código de autorização com PKCE e não deve enviar uma credencial de cliente ao resgatar o código.
O CIMD não dá suporte a tokens de ID para entrada do usuário. Esse branch usa a autenticação do navegador para obter acesso delegado à API, não o resultado do MSAL.NET somente para login mostrado anteriormente. Solicite os escopos delegados do recurso seguindo o procedimento de configuração do CIMD.
Para obter metadados e requisitos de URI de redirecionamento, consulte Configurar um cliente com um documento de metadados de ID do cliente.
Próxima etapa
Chame APIs como o usuário conectado.