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

Adicionar autenticação ao seu copiloto permite que os usuários entrem, dando ao seu copiloto 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ários 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

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

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

Criar um registro de aplicativo

1. Entre no portal do Azure usando uma conta de administrador no mesmo locatário utilizado no seu copiloto.

2. Acesse Registros de aplicativos.

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

   Pode ser útil posteriormente usar o nome do seu copiloto. Por exemplo, se o seu copiloto se chamar "Ajuda de vendas da Contoso", você pode nomear o registro do aplicativo "ContosoSalesReg".

4. Em Tipos de conta suportados, Select Contas em qualquer locatário organizacional (Qualquer Microsoft Entra diretório de ID - Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).

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ê precisará delas mais tarde.

Adicionar a URL de redirecionamento

1. Em Gerenciar, Select Autenticação.

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

3. Em Redirecionar URIs, insira https://token.botframework.com/.auth/web/redirect e Select Configurar.

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

4. Em Redirecionar URIs para a plataforma Web , Select Adicionar URI.

5. Digite https://europe.token.botframework.com/.auth/web/redirect e Select Salvar.

   Observação

   O painel de configuração de autenticação no Copilot Studio mostrar a seguinte URL de redirecionamento: https://unitedstates.token.botframework.com/.auth/web/redirect. O uso dessa URL faz com que a autenticação falhe; em vez disso, use o URI.

6. Na seção Concessão implícita e fluxos híbridos , Select tanto Tokens de acesso (usados para fluxos implícitos) quanto Tokens de ID (usados para fluxos implícitos e híbridos).

7. Selecione Salvar.

Gerar um segredo do cliente

1. Em Gerenciar, Select Certificados e segredos.

2. Na seção Segredos do cliente, selecione Novo segredo do cliente.

3. (Opcional) Insira uma descrição. Uma delas é fornecida se deixada em branco.

4. Selecione o período de validade. Selecione o período mais curto relevante para a vida do seu copiloto.

5. Selecione Adicionar para criar o segredo.

6. Armazene o Valor do segredo em um arquivo temporário seguro. Você precisará dele ao configurar a autenticação do seu copiloto posteriormente.

Configurar a autenticação manual

1. Em Copilot Studio, vá para Configurações para seu copiloto e Select Segurança.

2. Selecione Autenticação.

3. Selecione Autenticar manualmente.

4. Deixe Exigir que os usuários efetuem login ativado.

5. Insira os seguintes valores para as propriedades:

   • Provedor de serviços: Select Azure Active Directory v2.

   • ID do cliente: insira a ID do aplicativo (cliente) que você copiou anteriormente do portal do Azure.

   • Segredo do cliente: insira o segredo do cliente que você gerou anteriormente no portal do Azure.

   • Escopos: Digite profile openid.

6. Selecione Salvar para concluir a configuração.

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 para um administrador de locatários inseri-lo para você.

   

   Observação

   Para que não seja necessário solicitar o consentimento dos usuários em cada aplicativo, um Administrador global, um Administrador de aplicativos ou um Administrador de aplicativos de nuvem deve dar o consentimento para o locatário acessar os 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.

Defina um escopo personalizado para seu copiloto

Os escopos permitem que você determine funções de usuário e administrador e 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.
   State	Selecione Habilitado

3. Selecione Adicionar escopo.

Configurar a autenticação no Microsoft Copilot Studio

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

2. Selecione Autenticar manualmente.

3. Deixe Exigir que os usuários efetuem login ativado.

4. Select um provedor de serviços e forneça os valores necessários. Consulte Configurar autenticação manual em Copilot Studio.

5. Selecione Salvar.

Testar seu copiloto

1. Publicar seu copiloto.

2. No painel Testar copiloto, envie uma mensagem ao seu copiloto.

3. Quando o copiloto responder, selecione Logon.

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

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

5. Cole o código no chat do copiloto para concluir o processo de entrada.