Configurar a autenticação do utilizador com Microsoft Entra ID

Adicionar autenticação ao seu agente permite que os utilizadores iniciem sessão, dando ao seu agente acesso a um recurso ou a informações restritas.

Este artigo explica como configurar o Microsoft Entra ID como o seu fornecedor de serviços. Para saber mais sobre outros fornecedores de serviços e autenticação de utilizadores em geral, consulte Configurar autenticação de utilizadores no Copilot Studio.

Se tiveres direitos de administração de inquilinos, pode configurar permissões da API. Caso contrário, precisa de pedir a um administrador de inquilinos para o fazer por si.

Pré-requisitos

Saiba como adicionar a autenticação do utilizador a um tópico

Conclua os primeiros vários passos no portal do Azure e conclua os dois passos finais no Copilot Studio.

Criar um registo de aplicações

1. Inicie sessão no portal do Azure usando uma conta de administrador no mesmo inquilino que o seu agente.

2. Aceda a Registos de aplicações.

3. Selecione Novo registo e introduza um nome para o registo. Não altere os registos de aplicações existentes.

   Pode ser útil mais tarde usar o nome do seu agente. Por exemplo, se o seu agente se chamar "Ajuda de vendas Contoso", poderá nomear o registo da aplicação como "ContosoRegVendas".

4. Em Tipos de conta suportados, selecione Contas só neste diretório organizacional (Só Contoso - Inquilino único).

5. Deixe a secção do URI de Redirecionamento em branco por agora. Introduza essa informação nos próximos passos.

6. Selecione Registar.

7. Após a conclusão do registro, vá para Descrição geral.

8. Copie o ID da Aplicação (cliente) cole-o num ficheiro temporário. Precisa disso nos passos seguintes.

Adicionar o URL de redirecionamento

1. Em Gerir, selecione Autenticação.

2. Em Configurações de Plataforma, selecione Adicionar uma plataforma e, em seguida, selecione Web.

3. Em URIs de Redirecionamento, introduza https://token.botframework.com/.auth/web/redirect ou https://europe.token.botframework.com/.auth/web/redirect para a Europa. Também pode copiar o URI da caixa de texto do URL de Redirecionamento na página de definições de Segurança do Copilot Studio em Autenticar manualmente.

   Esta ação leva-o de volta à página de Configurações da plataforma.

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

4. Selecione tanto os Tokens de acesso (utilizados para fluxos implícitos) como os ID tokens (utilizados para fluxos implícitos e híbridos).

5. Selecione Configurar.

Configurar autenticação manual

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

Configurar permissões API

1. Aceda a Permissões da API.

2. Selecione Conceder consentimento do administrador para <o nome do seu inquilino> e, em seguida, selecione Sim. Se o botão não estiver disponível, pode ser necessário pedir a um administrador de inquilinos para o introduzir por si.

   

   Importante

   Para evitar que os utilizadores tenham de dar o seu consentimento a cada aplicação, alguém a quem tenha sido atribuída, pelo menos, a função de Administrador de aplicações ou de Administrador de aplicações na cloud pode conceder o consentimento a nível do inquilino aos seus registos de aplicações.

3. Selecione Adicionar uma permissão e depois selecione Microsoft Graph.

   

4. Selecione Permissões delegadas.

   

5. Expanda as permissões OpenId e ative openid e perfil.

   

6. Selecione Adicionar permissões.

Definir um âmbito personalizado para o seu agente

Os Âmbitos permitem determinar funções de utilizador e de administrador e direitos de acesso. Cria um âmbito personalizado para o registo da aplicação de tela que cria num passo posterior.

1. Vá a Expor uma API e selecione Adicionar um âmbito.

   

2. Defina as seguintes propriedades. Pode deixar as outras propriedades em branco.

   Propriedade	valor
   Nome do âmbito	Introduza um nome que faça sentido no seu ambiente, como Test.Read
   Quem pode consentir?	Selecionar Admins e utilizadores
   Nome a apresentar de consentimento do administrador	Introduza um nome que faça sentido no seu ambiente, como Test.Read
   Descrição do consentimento do administrador	Introduzir Allows the app to sign the user in.
   Estado	Selecione Ativado

3. Selecione Adicionar âmbito.

Configurar a autenticação no Copilot Studio

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

2. Selecione Autenticar manualmente.

3. Deixe ativado Exigir que os utilizadores iniciem sessão.

4. Selecione um Fornecedor de serviços e forneça os valores obrigatórios. Consulte Configurar autenticação manual no Copilot Studio.

5. Selecione Guardar.

Teste o seu agente

1. Publique o seu agente.

2. No painel Testar o seu agente, envie uma mensagem ao seu agente.

3. Quando o agente responder, selecione Iniciar sessão.

   Abre-se um novo separador do browser, pedindo-lhe para iniciar sessão.

4. Inicie sessão e depois copie o código de validação apresentado.

5. Para concluir o processo de início de sessão, cole o código no chat do agente.