Compartilhar via

Configurar o logon único com o Microsoft Entra ID para agentes no Microsoft Teams

O Copilot Studio dá suporte ao logon único (SSO) para agentes publicados nos chats 1:1 do Microsoft Teams. Com esse suporte, os agentes podem entrar automaticamente usando as credenciais do Microsoft Teams. O SSO só tem suporte quando se usa o Microsoft Entra ID. Outros provedores de serviços, como Azure AD v1, não oferecem suporte a SSO no Microsoft Teams.

Importante

Você pode usar SSO em chats do Microsoft Teams sem precisar da autenticação manual. Para usar esse método para um agente publicado anteriormente, reconfigure o agente para usar Autenticar com Microsoft e o republique no Microsoft Teams. Pode levar algumas horas até que essa alteração entre em vigor. Se estiver no meio de uma conversa e a alteração ainda não tiver sido feita, um usuário poderá digitar "recomeçar" no chat para forçar a reinicialização da conversa com a versão mais recente do agente. Essas alterações agora estão disponíveis para bate-papos do Teams 1:1 entre o usuário e o agente. Eles ainda não estão disponíveis para bate-papos em grupo ou mensagens de canal.

Não há suporte ao SSO para agentes integrados ao Dynamics 365 Customer Service.

Não prossiga com o seguinte documento, a menos que isso seja necessário. Se você quiser usar a autenticação manual para seu agente, consulte Configurar autenticação de usuário com o Microsoft Entra ID.

Observação

Se estiver usando a autenticação SSO do Teams com a opção de autenticação manual e também usando o agente em sites personalizados ao mesmo tempo, você deverá implantar o aplicativo Teams usando o manifesto do aplicativo.

Para obter mais informações, consulte Baixar o manifesto do aplicativo Teams para um agente.

Outras configurações, como as opções de autenticação ao lado do Manual ou por meio da implantação do Teams usando o Copilot Studio com um clique, não funcionarão.

Pré-requisitos

Configurar um registro de aplicativo

Antes de configurar o SSO para o Teams, configure a autenticação do usuário com o Microsoft Entra ID. Esse processo cria um registro do aplicativo que você precisa configurar o SSO.

  1. Criar um registro de aplicativo. Consulte as instruções em Configurar autenticação do usuário com o Microsoft Entra ID.

  2. Adicionar a URL de redirecionamento.

  3. Gere um segredo do cliente.

  4. Configure a autenticação manual.

Localizar a ID do aplicativo de canal do Teams

  1. No Copilot Studio, abra o agente para o qual você deseja configurar o SSO.

  2. Vá até a página Canais do agente e selecione o bloco Teams e Microsoft 365 Copilot.

  3. No painel de configuração Teams e Microsoft 365 Copilot, selecione Editar detalhes, expanda Mais e selecione Copiar próximo do campo ID do Aplicativo.

Adicionar a ID do aplicativo do canal do Teams ao registro do aplicativo

  1. Acesse o Portal do Azure. Abra a instância de registro do aplicativo criado por você quando configurou a autenticação do usuário para o agente.

  2. Selecione Expor uma API no painel lateral. Para URI da ID do Aplicativo, selecione Definir.

    Captura de tela do local do botão Definir para o URI da ID do aplicativo.

  3. Digite api://botid-{teamsbotid} e substitua {teamsbotid} pela ID do aplicativo do canal do Teams encontrado anteriormente.

    Captura de tela de um URI formatado corretamente inserido na caixa URI de ID do aplicativo.

  4. Selecione Salvar.

Os aplicativos são autorizados a chamar APIs quando usuários ou administradores concedem permissões durante o processo de consentimento. Para saber mais sobre consentimento, consulte Permissões e consentimento na plataforma de identidade da Microsoft.

Se a opção de consentimento do administrador estiver disponível, conceda o consentimento:

  1. No portal do Azure no registro do aplicativo, vá até Permissões de API.

  2. Selecione Conceder consentimento de administrador para <nome de seu tenant> e, em seguida, selecione Sim.

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.

Adicionar permissões de API

  1. No portal do Azure no registro do aplicativo, vá até Permissões de API.

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

  3. Selecione Permissões delegadas. Uma lista de permissões é exibida.

  4. Expanda Permissões do OpenId.

  5. Selecione openid e perfil.

  6. Selecione Adicionar permissões.

    Captura de tela das permissões de openid e perfil ativadas.

Definir um escopo personalizado para seu agente

  1. No portal do Azure na instância de registro do aplicativo, vá até Expor uma API.

  2. Selecione Adicionar um escopo.

    Captura de tela do botão Adicionar um escopo realçado.

  3. Defina as seguintes propriedades:

    Propriedade Valor
    Nome do escopo Inserir Test.Read
    Quem pode consentir? Selecione Administradores e usuários
    Nome de exibição do consentimento do administrador Inserir Test.Read
    Descrição do consentimento do administrador Inserir Allows the app to sign the user in.
    Estado Selecione Habilitado

    Observação

    O nome do escopo Test.Read é um valor de espaço reservado. Substitua-o por um nome que faça sentido no seu ambiente.

  4. Selecione Adicionar escopo.

Adicionar IDs de clientes do Microsoft Teams

Importante

Nas etapas a seguir, os valores fornecidos para IDs de cliente do Microsoft Teams devem ser usados literalmente porque são iguais em todos os locatários.

  1. No portal do Azure na instância de registro do aplicativo, vá até Expor uma API e selecione Adicionar um aplicativo cliente.

    Captura de tela do botão Adicionar um aplicativo cliente realçado.

  2. No campo ID do cliente, insira a ID do cliente do Microsoft Teams para desktop/dispositivo móvel, que é 1fec8e78-bce4-4aaf-ab1b-5451cc387264. Marque a caixa de seleção para o escopo que você criou anteriormente.

    Captura de tela do ID do cliente inserido no painel Adicionar um aplicativo cliente.

  3. Selecione Adicionar aplicativo.

  4. Repita as etapas anteriores, mas, para ID do Cliente, insira a ID do cliente para Microsoft Teams na Web, que é 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

  5. Confirme se a página Expor uma API lista as IDs do aplicativo cliente do Microsoft Teams.

Para resumir, as duas IDs de cliente do Microsoft Teams adicionadas à página Expor uma API são:

  • 1fec8e78-bce4-4aaf-ab1b-5451cc387264
  • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

Adicionar URL de troca de tokens às configurações de autenticação do agente

Para atualizar as configurações de autenticação do Microsoft Entra ID no Copilot Studio, você deve adicionar a URL da troca de token para que o Microsoft Teams e o Copilot Studio possam compartilhar as informações.

  1. No portal do Azure na instância de registro do aplicativo, vá até Expor uma API.

  2. Em Escopos, selecione o ícone Copiar para a área de transferência.

  3. No Copilot Studio, nas configurações do agente, selecione Segurança e o bloco Autenticação.

  4. Para URL de troca de token (necessário para SSO), cole o escopo copiado anteriormente.

  5. Selecione Salvar.

    Captura de tela mostrando onde colar a URL de troca de token no Copilot Studio.

Adicionar SSO ao canal do Teams do agente

  1. No Copilot Studio, nas configurações do agente, selecione Canais.

  2. Selecione o bloco do Teams e do Microsoft 365 Copilot.

  3. Selecione Editar detalhes e expanda Mais.

  4. Na ID do cliente do aplicativo AAD, insira a ID do aplicativo (cliente) do registro do aplicativo.

    Para obter esse valor, abra o portal do Azure. Em seguida, no registro do aplicativo, vá até Visão geral. Copie o valor na caixa ID do aplicativo (cliente).

  5. No URI do recurso, insira o URI da ID do aplicativo do registro do aplicativo.

    Para obter esse valor, abra o portal do Azure. Em seguida, no registro do aplicativo, vá até Expor uma API. Copie o valor na caixa URI da ID do aplicativo.

    Captura de tela mostrando onde colar o URI da ID do aplicativo no canal do Teams do Copilot Studio.

  6. Selecione Salvar, em seguida, Fechar.

  7. Publique novamente o agente, a fim de disponibilizar as alterações mais recente para os clientes.

  8. Selecione Ver agente no Teams para iniciar uma nova conversa com seu agente no Teams e verificar se ele entra automaticamente.

Problemas conhecidos

Se você tiver publicado o agente usando autenticação manual sem SSO do Teams, o agente no Teams solicitará continuamente que os usuários entrem no sistema.

  • Last updated on