Autenticação do Microsoft Teams

Este documento descreve como autenticar o Microsoft Teams com o UiPath Integration Service usando o OAuth 2.0. O conector do Microsoft Teams é compatível com a autenticação OAuth baseada em usuário, com suporte opcional para aplicativos personalizados OAuth e cenários habilitados para bots.

Visão geral

A tabela a seguir resume as opções de autenticação compatíveis e seus pré-requisitos.

Cenário de autenticação	Description	Pré-requisitos
OAuth gerenciado pela UiPath (Código de autorização)	Usa um aplicativo gerenciado pela UiPath	Conta do Microsoft Teams, capacidade de conceder consentimento
Traga seu próprio aplicativo OAuth (BYOA)	Usa um aplicativo do Azure AD gerenciado pelo cliente	Aplicativo do Azure AD, ID do cliente, Segredo do cliente, ID do tenant, consentimento do administrador

Autenticação OAuth 2.0

Incluir robô

A opção Incluir bot determina se a conexão inclui o acesso baseado em bot do Microsoft Teams, além de permissões de OAuth delegadas pelo usuário. Selecionar esta opção habilita o envio de mensagens como Uipath notification com sua conexão.

Configuração	Comportamento
Não (Padrão)	Apenas OAuth delegado por usuário
Sim	Habilita a funcionalidade do robô Microsoft Teams

Observação:

• A autenticação de robô requer um robô de Microsoft Teams registrado no Azure.
• O suporte a bots não é necessário para a maioria das atividades do Microsoft Teams.
• Use esta opção apenas se sua automação exigir explicitamente recursos de bots.

Traga sua própria configuração do aplicativo OAuth (BYOA)

Se você selecionar Traga seu próprio aplicativo OAuth, configure seu aplicativo Azure AD da seguinte forma.

Configurações de aplicativos do Azure

Configuração	Valor
Fluxo do OAuth	Authorization Code
Redirecionamento/URL de retorno de chamada	https://{baseURL}/provisioning_/callback(por exemplo,https://cloud.uipath.com/provisioning_/callback para Automation Cloud).
Tipos de conta compatíveis	Tenant único ou vários tenants
API	Microsoft Graph

ID do Tenant

Tipo de app	ID do Tenant
Multi-tenant	common
Tenant único	ID de tenant do Azure

Observação:

A UiPath é compatível com aplicativos de tenant único e de vários tenants.

Escopos e permissões

Os escopos controlam quais ações a UiPath pode executar no Microsoft Teams. Os escopos são configuráveis durante a criação da conexão.

Escopos obrigatórios

Os escopos a seguir são obrigatórios e não devem ser removidos. Eles são necessários para uma conexão bem-sucedida.

Escopo	Finalidade
openid	Autenticação do usuário e geração de token de ID
offline_access	Habilita a emissão de token de atualização
User.Read	Lê o perfil do usuário conectado

Observação:

A remoção de qualquer escopo obrigatório resultará em falhas de conexão ou autenticação do runtime.

Todos os escopos

Os escopos a seguir habilitam cenários comuns de automação do Microsoft Teams.

Escopo	Use case	Atividade ou evento
openid	Ao usar essa permissão, um aplicativo pode receber um identificador exclusivo para o usuário na forma da subdeclaração. A permissão também dá ao aplicativo acesso ao endpoint UserInfo . O escopo openid pode ser usado no endpoint do token da plataforma de identidade da Microsoft para adquirir tokens de ID. O aplicativo pode usar esses tokens para autenticação	N/A
offline_access	Obrigatório para receber o token de atualização no ponto de extremidade de solicitação de autenticação. Quando você simula um código de autorização no fluxo de código de autorização do OAuth 2.0 sem o escopo offline\_access, você não recebe um token de atualização do ponto de extremidade /token.	N/A
profile	Recuperar o perfil do usuário atual, como nome, nome de usuário, e-mail etc., para que possa ser usado como usuário padrão/autenticado na criação da conexão e em determinadas atividades	N/A
email	Permite que o aplicativo leia todos os endereços de e-mail primários de seus usuários, para enviar mensagens ou convidá-los para um canal	Enviar mensagem de chat individual, Convidar membro para o canal, Convidar usuário para a equipe
User.Read	Permite que os usuários façam login no aplicativo, e permite que o aplicativo leia o perfil de usuários conectados. Isso também permite que o aplicativo leia informações básicas da empresa dos usuários conectados	Obter Registro → Eu
Team.Create	Criar uma equipe para convidar e envolver os usuários respectivos	Inserir registro → Teams
Team.ReadBasic.All	Recupere a lista de equipes a serem selecionadas nas atividades, como enviar uma mensagem de canal etc.	Criar canal, Listar todos os canais, Enviar mensagem de chat, Enviar mensagem de chat individual, Convidar membro para um canal, Responder a uma mensagem de canal, Enviar mensagem de canal, Obter equipe por nome
TeamMember.ReadWrite.All	Adicionar membro a uma equipe em nome do usuário conectado Recuperar a lista de membros de uma equipe	Listar todos os membros da equipe, Convidar usuário para a equipe, Obter equipe pelo nome, Inserir registro → Membros das equipes, Listar todos os registros → Membros das equipes
Channel.Create	Crie um canal (padrão/privado) para convidar e envolver os respectivos usuários da equipe	Criar canal
Channel.ReadBasic.All	Recuperar a lista de canais de uma equipe a serem selecionados nas atividades, como envio de mensagem de canal etc.	Obter canal por nome, Convidar membro para um canal, Listar todos os canais, Listar canal por nome, Responder à mensagem do canal, Enviar mensagem do canal
ChannelMember.ReadWrite.All	Adicionar membro a um canal em nome do usuário conectado Recuperar a lista de membros envolvidos em um canal	Convidar membro para um canal, Listar todos os registros → Membros dos canais de equipes
ChannelMessage.Send	Envie uma mensagem em um canal. Além disso, responda a uma mensagem em um thread, se necessário.	Responder à mensagem do canal, Enviar mensagem do canal
ChannelMessage.Read.All	Permite que o aplicativo leia todas as mensagens do canal no Microsoft Teams, sem um usuário conectado Também é usado para disparar eventos sempre que uma mensagem é publicada no canal ou sempre que uma palavra-chave é mencionada no canal	Responder à mensagem do canal, Listar todas as mensagens do canal, Listar todos os registros → Mensagens dos canais do Teams, Quando uma mensagem foi publicada no canal (Futchi), Quando uma palavra-chave ou nome de usuário é mencionado no canal (Future)
Chat.ReadWrite	Permite que o aplicativo leia e envie suas mensagens 1:1 Permite que o aplicativo leia e envie mensagens de chat em grupo Também usado para disparar eventos sempre que uma mensagem de chat for publicada	Enviar mensagem de chat em grupo, Enviar mensagem de chat individual, Listar todas as mensagens de chat, Listar todos os registros → Chats, Quando uma mensagem de chat for publicada ( Futura )
ChatMember.ReadWrite	Adicionar membro a um chat em nome do usuário conectado Recuperar a lista de membros envolvidos em um chat	Inserir registro → Membros dos chats, Listar todos os registros → Membros dos chats
Calendars.ReadWrite	Crie uma entrada de calendário do Outlook da reunião online do Teams.	Create Online Teams Meeting
OnlineMeetings.ReadWrite	Crie uma reunião online no Microsoft Teams e recupere ID da reunião, senha e URL em nome do usuário atual.	Create Online Teams Meeting
Files.Read.All	Recuperar as informações do arquivo que foram carregadas no SharePoint para compartilhá-las em um canal ou chat do Teams	Enviar mensagem do canal Enviar mensagem de chat em grupo, Enviar mensagem de chat individual, Responder a mensagem do canal

Os escopos podem ser adicionados ou removidos para seguir os princípios de privilégio mínimo .

Tokens de atualização para aplicativos OAuth

Os tokens de atualização para aplicativos OAuth podem ser invalidados ou revogados a qualquer momento pela Microsoft. Isso pode acontecer por diferentes motivos, como tempos limite e revogação. Para obter detalhes, consulte a documentação oficial da Microsoft.

Observação:

A invalidação de tokens resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.

Esse problema afeta todos os conectores baseados no Microsoft Graph.

Certifique-se de seguir as práticas recomendadas da Microsoft ao criar seus aplicativos OAuth. Para obter detalhes completos sobre como criar um aplicativo Microsoft OAuth, consulte a documentação da Microsoft.

Adicionar a conexão do Microsoft Teams

Para criar uma conexão com sua instância do Microsoft Teams, você precisa realizar as seguintes etapas:

1. Selecione Orchestrator no inicializador do produto.

2. Selecione uma pasta e navegue até a aba Conexões .

3. Selecione Adicionar conexão.

4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.

5. É possível escolher entre dois tipos de autenticação: Código de autorização do OAuth 2.0 ou Traga seu próprio aplicativo do OAuth 2.0.

6. Insira as credenciais necessárias.

   Para qualquer campo do tipo secreto, você pode selecionar o menu ao lado do campo e escolher Usar ativo de credencial para fazer referência a um ativo de credencial do Orchestrator vinculado a um cofre externo em vez de inserir o valor diretamente. Para obter mais informações, consulte Usar ativos de credenciais para conexões.

7. Select Connect.

Para obter mais informações sobre a autenticação no Microsoft Teams, consulte a página Autenticação e autorização da Microsoft.