Configurar autenticação do usuário com o Microsoft Entra ID

Adicionar autenticação ao seu agente permite que os usuários entrem, dando ao seu agente acesso a um recurso ou informação restrita.

Este artigo aborda como configurar o Microsoft Entra ID como seu provedor de serviços. Para saber mais sobre outros provedores de serviços e autenticação de usuário em geral, consulte Configurar autenticação de usuário no Copilot Studio.

Se você tiver direitos de administração de locatários, poderá configurar permissões de API. Caso contrário, você precisa pedir a um administrador do locatário para fazer isso para você.

Pré-requisitos

Saiba como adicionar a autenticação de usuário a um tópico

Você conclui as duas primeiras etapas no portal do Azure e conclui as duas etapas finais no Copilot Studio.

Criar um registro de aplicativo do

1. Entre no portal do Azure, usando uma conta de administrador no mesmo tenant que seu agente.

2. Vá para Registros de aplicativo.

3. Selecione Novo registro e insira um nome para o registro. Não altere registros de aplicativos existentes.

   Recomenda-se usar posteriormente o nome de seu agente. Por exemplo, se o seu agente se chamar "Ajuda de vendas da Contoso", você pode nomear o registro do aplicativo "ContosoSalesReg".

4. Em Tipos de conta com suporte, selecione Contas somente neste diretório organizacional (somente Contoso – único locatário).

5. Deixe a seção URI de redirecionamento em branco por enquanto. Insira essas informações nas próximas etapas.

6. Selecione Registrar.

7. Após concluir o registro, acesse Visão geral.

8. Copie o ID do aplicativo (cliente) e cole em um local temporário. Você precisa dele em etapas posteriores.

Adicionar a URL de redirecionamento

1. Em Gerenciar, selecione Autenticação.

2. Em Configurações da plataforma, selecione Adicionar uma plataforma e Web.

3. Em URIs de Redirecionamento, digite https://token.botframework.com/.auth/web/redirect ou https://europe.token.botframework.com/.auth/web/redirect para Europa. Você também pode copiar a URI da caixa de texto da URL de Redirecionamento na página de configuração de Segurança do Copilot Studio em Autenticar manualmente.

   Essa ação direciona você de volta à página Configurações da plataforma.

   Para obter uma lista de serviços obrigatórios que o Copilot Studio conecta, incluindo token.botframework.com, consulte Serviços obrigatórios.

4. Selecione Tokens de acesso (usados para fluxos implícitos) e Tokens de ID (usados para fluxos implícitos e híbridos).

5. Selecione Configurar.

Configurar a autenticação manual

Em seguida, configure a autenticação manual. Você pode escolher entre várias opções para o seu provedor. No entanto, recomendamos que você use o Microsoft Entra ID V2 com credenciais federadas. Você também pode usar os segredos do cliente se não conseguir usar credenciais federadas.

Configurar permissões de API

1. Acesse Permissões da API.

2. Selecione Conceder consentimento do administrador para <nome do seu locatário>, depois selecione Sim. Se o botão não estiver disponível, talvez seja necessário pedir a um administrador de locatários para inseri-lo para você.

   

   Importante

   Para evitar que os usuários precisem consentir com cada aplicativo, alguém atribuído pelo menos ao cargo de Administrador de Aplicativos ou Administrador de Aplicativos de Nuvem pode conceder consentimento para todo o locatário aos registros do seu aplicativo.

3. Selecione Adicionar uma permissão e escolha Microsoft Graph.

   

4. Selecione Permissões delegadas.

   

5. Expanda Permissões de OpenId e ative o código aberto e o perfil.

   

6. Selecione Adicionar permissões.

Definir um escopo personalizado para seu agente

Escopos permitem determinar funções de usuário e administrador, além de direitos de acesso. Você cria um escopo personalizado para o registro do aplicativo de tela que você cria em uma etapa posterior.

1. Acesse Expor uma API e selecione Adicionar um escopo.

   

2. Defina as seguintes propriedades. Você pode deixar as outras propriedades em branco.

   Propriedade	Valor
   Nome do escopo	Insira um nome que faça sentido no seu ambiente, como Test.Read
   Quem pode consentir?	Selecione Administradores e usuários
   Nome de exibição do consentimento do administrador	Insira um nome que faça sentido no seu ambiente, como Test.Read
   Descrição do consentimento do administrador	Inserir Allows the app to sign the user in.
   Estado	Selecione Habilitado

3. Selecione Adicionar escopo.

Configurar autenticação no Copilot Studio

1. No Copilot Studio, em Configurações, selecione Segurança>Autenticação.

2. Selecione Autenticar manualmente.

3. Deixe ativada a opção Exigir que os usuários entrem.

4. Selecione um Provedor de serviços e forneça os valores necessários. Consulte Configurar autenticação manual no Copilot Studio.

5. Selecione Salvar.

Testar o seu agente

1. Publique seu agente.

2. No painel Testar seu agente, envie uma mensagem para seu agente.

3. Quando o agente responder, selecione Entrar.

   Uma nova guia do navegador será aberta solicitando que você entre.

4. Entre e copie o código de validação exibido.

5. Para concluir o processo de entrada, cole o código no chat do agente.