Configurar o logon único com 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. Usando esse suporte, os agentes podem conectar automaticamente os usuários com suas credenciais de Microsoft Teams. O SSO só tem suporte quando se usa o Microsoft Entra ID.

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 Authenticate com Microsoft e publique-o novamente para 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.

Note

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.

Não funcionam outras configurações, como opções de autenticação além das manuais ou por meio da implantação do Teams usando o Copilot Studio com um clique.

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 de aplicativo necessário para configurar o SSO.

  1. Crie 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.

Localize o 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.

Adicione a ID do aplicativo de canal do Teams ao registro do aplicativo.

  1. Vá para o portal do Azure. Abra a instância de registro do aplicativo para o registro do aplicativo que você criou ao configurar a autenticação de usuário para o seu agente.

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

    Captura de tela da localização do botão de configuração para o URI de identificação do aplicativo.

  3. Digite api://botid-{teamsbotid} e substitua {teamsbotid} por 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. Clique em 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 Azure, no registro do aplicativo, acesse API Permissions.

  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 Azure, no registro do aplicativo, acesse API Permissions.

  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 Azure, na instância de registro do aplicativo, acesse Expose 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 Insira Test.Read
    Quem pode consentir? Selecione Administradores e usuários
    Nome de exibição do consentimento do administrador Insira Test.Read
    Descrição do consentimento do administrador Insira Allows the app to sign the user in.
    Estado Selecione Habilitado

    Note

    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

Use os valores fornecidos para IDs de cliente do Microsoft Teams literalmente nas etapas a seguir, pois essas IDs de cliente são as mesmas em todos os inquilinos.

  1. No portal do Azure, na instância de registro do aplicativo, acesse Expose uma API e selecione Add 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 Microsoft Teams que você adiciona à página Expose 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 Microsoft Entra ID no Copilot Studio, adicione a URL de troca de tokens para que Microsoft Teams e Copilot Studio possam compartilhar informações.

  1. No portal Azure, na instância de registro do aplicativo, acesse Expose 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, em seguida, selecione o bloco Autenticação.

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

  5. Clique em Salvar.

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

Adicionar SSO ao canal do Teams do seu agente

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

  2. Selecione o painel o Teams e o 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 recentes 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