Escopo do Microsoft Teams

As atividades Microsoft Teams usam a plataforma de identidade Microsoft para estabelecer uma conexão autenticada entre o UiPath e seu aplicativo Microsoft Teams por meio da atividade Microsoft Scope . Essa conexão permite que um Robô chame a API do Microsoft Graph para ler e escrever recursos em seu nome.

Para estabelecer sua conexão autenticada, primeiro registre seu aplicativo Microsoft Teams no seu Azure Active Directory (usando sua conta pessoal, de trabalho e/ou escola do Microsoft Office 365). Ao registrar seu aplicativo, você atribui as permissões da API do Microsoft Graph, que especificam os recursos que um Robô pode acessar em seu nome.

Após registrar seu aplicativo Microsoft Teams, o Azure Active Directory atribui um ID de aplicativo exclusivo (cliente) que você insere na atividade Microsoft Teams Scope . O IdDoAplicativo é usado para coletar a informação necessária sobre o seu aplicativo registrado para iniciar a autenticação.

Observação: para saber mais sobre como registrar seu aplicativo e atribuir permissões, consulte o Guia de configuração . Este guia fornece instruções passo a passo para configurar seu aplicativo Microsoft Teams para a automação.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione a atividade Microsoft Teams Scope ao seu projeto.

3. Insira valores para as propriedades Autenticação, Entrada e Não assistido (se aplicável).

   
   

   

   
   

Automação Attended vs. Unattended

A atividade Microsoft Teams Scope tem três fluxos de autenticação diferentes (TiposDeAutenticação) que você pode escolher ao adicionar a atividade ao seu projeto. A seleção depende do tipo de modo de automação que você planeja executar (não assistido ou assistido) e dos requisitos de autenticação do aplicativo (consulte o administrador se não tiver certeza de quais requisitos de autenticação se aplicam ao seu aplicativo).

TipoDeAutenticação	Assistido	Não Assistido
Token Interativo	X
IntegratedWindowsAuthentication	X	X
UsernameAndPassword	X	X

Importante: a automação não assistida não é compatível com a autenticação multifator. Se o aplicativo exigir uma autenticação multifator, você só poderá executar a automação assistida usando o tipo de autenticação InteractiveToken .

Token Interativo

O tipo de autenticação InteractiveToken pode ser usado para automação assistida e quando a autenticação multifator (MFA) é necessária. Essa é a opção padrão e o que usamos em nossos exemplos. Se você estiver interessado em "brincar" com o pacote de atividades, essa opção é fácil de configurar e funciona bem para contas pessoais (usando o URI de redirecionamento padrão anotado na etapa 7 da seção Registre seu aplicativo do Guia de configuração).

Quando a atividade Microsoft Teams Scope for executada pela primeira vez usando esse tipo de autenticação, você será solicitado a autorizar o acesso aos recursos (você concedeu permissões ao registrar seu aplicativo) por meio de uma caixa de diálogo consentimento .

Se você selecionar essa opção, as propriedades Username,Password e Tenant devem ser deixadas vazias.

Esse tipo de autenticação segue o fluxo do código de autorização do OAuth 2.0.

Autenticação do Windows Integrada

O tipo de autenticação IntegrationWindowsAuthentication pode ser usado para automação assistida e não assistida. Essa opção pode ser aplicada a aplicativos hospedados do Windows que sejam executados em computadores associados a um domínio do Windows ou ao Azure Active Directory.

Selecione essa opção apenas se o aplicativo registrado estiver configurado para oferecer suporte à Autenticação Integrada do Windows (informações adicionais podem ser encontradas no GitHub ).

Se você selecionar essa opção, as propriedades Username,Password e Tenant devem ser deixadas vazias.

UsernameAndPassword

O tipo de autenticação NomeDeUsuárioESenha pode ser usado para automação assistida (quando a autenticação de vários fatores não é necessária) e automação não assistida.

Embora não seja recomendado pela Microsoft, você pode usar esse tipo de autenticação em aplicativos clientes públicos. Usar esse tipo de autenticação impõe restrições ao aplicativo. Por exemplo, os aplicativos que usam esse fluxo não poderão fazer login um usuário que precise executar a autenticação de vários fatores (acesso condicional). Isso também não permitirá que seu aplicativo se beneficie do logon único. A autenticação com nome de usuário/senha vai contra os princípios da autenticação moderna e só é fornecida por motivos de legado (informações adicionais podem ser encontradas no GitHub ).

Se você selecionar essa opção, as propriedades Nome de usuário e Senha serão obrigatórias e a propriedade Locatário será opcional para aplicativos de locatário único (necessário para aplicativos de vários locatários).

Observação: a propriedade IDdoAplicativo é necessária ao selecionar o TipoDeAutenticaçãoNomeDeUsuárioESenha. Você pode registrar seu aplicativo do Microsoft Office 365 usando sua conta pessoal, de trabalho e/ou escola.

Propriedades

Os valores para as seguintes propriedades são especificados ao adicionar esta atividade ao seu projeto no UiPath Studio.

Comum

NomeDeExibição

O nome de exibição da atividade.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Escopo do Microsoft Teams
Valores permitidos	Insira uma variável String ou String .
Observações	N/A

Autenticação

IdDoAplicativo

O ID exclusivo do aplicativo (cliente) atribuído pelo Azure Active Directory quando você registrou seu aplicativo durante a Configuração.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	O ID do aplicativo (cliente) representa uma instância de um aplicativo Microsoft Teams. Uma única organização pode ter vários IDs de aplicativo (cliente) para sua conta do Microsoft Office 365. ID de cada aplicativo (cliente) contém seus próprios requisitos de permissões e autenticação. Por exemplo, você e seu colega podem registrar um aplicativo do Microsoft Teams no Azure Active Directory da sua empresa e gerar o ID de seu próprio aplicativo (cliente).

TipoDeAutenticação

O tipo de autenticação necessário para seu aplicativo registrado.

Atributos	Detalhes
Tipo	Seleção suspensa
Required	Sim
Valor padrão	Token Interativo
Valores permitidos	Selecione uma das três opções: Nome de Usuário e Senha da Autenticação Integrada do Windows do Token Interativo
Observações	Para obter mais informações sobre essas opções e qual selecionar, consulte a seção Automação não assistida e assistida acima.

Tenant

O ID do diretório exclusivo (tenant) atribuído pelo Azure Active Directory quando você registrou seu aplicativo durante o .

Atributos	Detalhes
Tipo	String
Required	Não (necessário para aplicativos de vários tenants)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	O ID do diretório (tenant) pode ser encontrado na página de visão geral do seu aplicativo registrado (sob o ID do aplicativo (cliente)).

Token Interativo

AplicativoOAuth

Indica o aplicativo (cliente) a ser usado.

Atributos	Detalhes
Tipo	enum
Required	Não
Valor padrão	Personalizado
Valores permitidos	Personalizado, UiPath
Observações	Se a opção "UiPath" for selecionada, IdDoAplicativo e Tenant serão ignorados.

Nome de usuário e Senha (Não Assistido)

Essas propriedades aplicam-se apenas quando você executa automação não assistida. Ao especificar valores para essas propriedades, certifique-se de que a propriedade TipoDeAutenticação esteja definida como NomeDeUsuárioESenha. Para obter mais informações, consulte a seção Nome de usuário e senha acima.

Senha

A senha da sua conta do Microsoft Office 365.

Atributos	Detalhes
Tipo	String
Required	Não (obrigatório se TipoDeAutenticação for NomeDeUsuárioESenha)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	N/A

SenhaSegura

A senha da sua conta do Microsoft Office 365.

Atributos	Detalhes
Tipo	SecureString
Required	Não (obrigatório se TipoDeAutenticação for NomeDeUsuárioESenha) e Senha for nula.
Valor padrão	Vazio
Valores permitidos	Insira uma variável SecureString ou SecureString .
Observações	N/A

Username

O nome de usuário da sua conta do Microsoft Office 365.

Atributos	Detalhes
Tipo	String
Required	Não (obrigatório se TipoDeAutenticação for NomeDeUsuárioESenha)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	N/A