Escopo do Microsoft Teams

As atividades Microsoft Teams usam a plataforma de identidade da 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 Robot 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, profissional e/ou escolar 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.

Depois de registrar seu aplicativo Microsoft Teams, o Azure Active Directory atribui um ID exclusivo de aplicativo (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 o registro de seu aplicativo e atribuir permissão, consulte o guia de Configuração . Este guia fornece instruções passo a passo para configurar seu aplicativo Microsoft Teams para 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. Sua seleção depende do tipo de modo de automação que você planeja executar (não assistido ou assistido) e dos seus requisitos de autenticação de aplicativo (consulte seu 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 Unattended não é compatível com a autenticação de vários fatores. Se o seu aplicativo exigir autenticação de vários fatores, você só poderá executar automação Attended usando o tipo de autenticação InteractiveToken .

Token Interativo

O tipo de autenticação InteractiveToken pode ser usado para automação Attended e quando a autenticação multifator (MFA) é necessária. Essa é a opção padrão e a que usamos em nossos exemplos. Se você estiver interessado em "brincar com você" 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 observado na etapa 7 da seção Registrar 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 (para os quais você concedeu permissões ao registrar seu aplicativo) por meio de uma caixa de diálogo de consentimento .

Se você selecionar essa opção, as propriedades Nome de usuário,Senha e Tenant devem ficar vazias.

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

Autenticação do Windows Integrada

The IntegratedWindowsAuthentication authentication type can be used for both attended and unattended automation. This option can apply to Windows hosted applications running on computers joined to a Windows domain or Azure Active Directory.

Você só deve selecionar essa opção se seu aplicativo registrado for 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 Nome de usuário,Senha e Tenant devem ficar vazias.

UsernameAndPassword

The UsernameAndPassword authentication type can be used for both attended (when mutli-factor authentication is not required) and unattended automation.

Embora não seja recomendado pela Microsoft, você pode usar esse tipo de autenticação em aplicativos de clientes públicos. O uso desse tipo de autenticação impõe restrições a seu aplicativo. Por exemplo, os aplicativos que usam esse fluxo não poderão fazer login em um usuário que precisa realizar a autenticação de vários fatores (acesso condicional). Também não habilitará seu aplicativo para se beneficiar 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 legados (informações adicionais podem ser encontradas no GitHub).

If you select this option, the Username and Password properties are required and the Tenant property is optional for single-tenant applications (required for multi-tenant applications).

Observação:

The ApplicationID property is required when selecting the UsernameAndPassword AuthenticationType. You can register your Microsoft Office 365 Application using your personal, work, and/or school account.

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 seu próprio ID do 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: InteractiveToken integradoWindowsAutenticação NomeDeUsuárioESenha
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 exclusivo do diretório (tenant) atribuído pelo Azure Active Directory quando você registrou seu aplicativo durante.

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 se aplicam 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	No (required if AuthenticationType is UsernameAndPassword)
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	No (required if AuthenticationType is UsernameAndPassword)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	N/A