Microsoft Office 365 Scope

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

Description

Usa a plataforma de identidade da Microsoft para estabelecer uma conexão autenticada entre o UiPath e seu aplicativo Microsoft 365. Essa conexão autenticada permite que um Robot chame a API do Microsoft Graph para ler e escrever recursos em seu nome.

Importante: a partir da versão 2.5.5, você pode usar as atividades mais recentes do Microsoft 365 dentro da atividade Scope. Para saber como usar as atividades do Integration Service com a Microsoft 365 Scope , consulte Como usar atividades do Microsoft 365 sem conexões do Integration Service.

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Dica: esta página explica os parâmetros de autenticação disponíveis na atividade Microsoft 365 Scope. Para obter mais detalhes sobre cada opção de autenticação, consulte o guia Como se conectar às atividades do Microsoft 365.

Para começar a configurar essa atividade, você deve primeiro selecionar um método de conexão. Dependendo do método selecionado, diferentes campos são exibidos no painel Propriedades.

• Método de conexão — selecione o método de conexão que você deseja usar. As opções disponíveis no menu suspenso são:
  • Painel de propriedades - Configure os detalhes da conexão no painel de propriedades.
  • Ativo - Use ativos de credenciais do Orchestrator. Recomendamos que você use esta opção.

Método de conexão do ativo

Observação: quando você seleciona essa opção, a maioria dos campos de autenticação geralmente exibidos no painel Propriedades é escondida, porque as informações de autenticação são armazenadas dentro do ativo.

• Ativos de conexão - Navegue pelas pastas do Orchestrator para selecionar um ativo. Este campo aceita variáveis IResource . Selecione o botão Gerenciar ativos para abrir o Orchestrator. A lista de ativos disponíveis depende do Orchestrator ao qual seu Studio e o Robô estão conectados.
  • Use o menu do botão Mais para selecionar Recarregar ativos se você tiver atualizado seus ativos no Orchestrator. Observe que se você adicionar um novo ativo no Orchestrator enquanto estiver usando o Studio Desktop, ele não ficará disponível imediatamente na atividade Scope.

• Consulte o formato do ativo em Como usar atividades Microsoft 365 sem conexões do Integration Service.

Dependendo do tipo de autenticação configurado no ativo, você também deve configurar os seguintes campos disponíveis no painel Propriedades:

Autenticação

• Endereço de email do usuário representado - O endereço de email do usuário representado. Usado para métodos de autenticação do ID do aplicativo e segredo e ID do aplicativo e certificado.

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

• Nome de usuário - O nome de usuário da sua conta do Microsoft 365. Usado para o método de autenticação de nome de usuário e senha.
• Senha - A senha de sua conta do Microsoft 365.

Comum

• TempoLimiteEmMs - Especifica o tempo que se deve aguardar (em milissegundos) para que a autenticação interativa (caixa de diálogo de consentimento) seja concluída antes de gerar um erro. Esse campo é compatível apenas com números inteiros e variáveis Int32 . O valor padrão é 30000ms (30 segundos).

Runtime

• Ativos de conexão do runtime — Navegue para selecionar um ativo. Esse campo permite que você selecione um ativo diferente para o tempo de execução. Use o menu do botão Mais para selecionar Caminho relativo e insira o caminho completo do ativo do Orchestrator contendo detalhes da conexão.

Método de conexão do Painel de propriedades

Observação: quando você seleciona essa opção, você deve configurar os campos de autenticação disponíveis no painel Propriedades.

Primeiro, configure os seguintes campos:

• Conexões - Selecione uma conta da lista. Você pode adicionar, excluir e escolher quais conexões usar.
• Escopos de autenticação - Consulte a seção do assistente Usando os escopos de autenticação abaixo.

Usando o assistente de Escopos de autenticação

Observação: esse assistente substitui o parâmetro Serviços disponível em versões anteriores desse pacote. O assistente Escopos de Autenticação está disponível quando você usa autenticação de Token interativo.

A atividade Scope incorpora um seletor de permissões universais, oferecendo uma imagem clara de todos os escopos de autenticação usados, dos quais as atividades precisam para funcionar corretamente.

Todas as atividades filhos incluídas na atividade Microsoft 365 Scope são detectadas automaticamente como escopos necessários.

Se nenhum escopo for selecionado manualmente no assistente de Escopos, a função Detecção automática é aplicada por padrão no runtime, e a necessidade de configurar o assistente é eliminada. Todos os escopos mínimos exigidos são selecionados no runtime.

Você também pode adicionar um escopo manualmente após adicionar uma atividade filho à Microsoft 365 Scope.

Em seguida, você deve selecionar o Tipo de autenticação no painel Propriedades e configurar os campos necessários para o seu método de autenticação preferido. As seções abaixo listam os campos disponíveis em cada menu.

Autenticação

• Tipo de autenticação - O tipo de autenticação necessária para seu aplicativo registrado. Selecione uma das cinco opções: Token interativo, Autenticação integrada do Windows (IWA), Nome de usuário e senha, ID e segredo do aplicativo ou ID e certificado do aplicativo. O valor padrão é Token interativo.
• Ambiente - O ambiente. Nuvens Azure Global ou nacionais que são ambientes exclusivos e separados do Azure Global. Selecione uma das cinco opções: Padrão, Global, China, Alemanha ou Governo dos EUA. O valor padrão é Global.
• ID do aplicativo - O ID exclusivo do aplicativo (cliente) atribuído pelo Azure Active Directory quando você registrou seu aplicativo durante a configuração. O ID do aplicativo (cliente) representa uma instância de um aplicativo Microsoft 365.
• Tenant - O ID exclusivo do diretório (tenant) atribuído pelo Azure Active Directory quando você registrou seu aplicativo durante a configuração. Necessário para aplicativos com vários tenants e Autenticação integrada do Windows.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)).
• Endereço de email do usuário representado - O endereço de email do usuário representado. Usado em cenários Unattended (para métodos de autenticação de ID do aplicativo e segredo e ID do aplicativo e certificado).

Token Interativo

Observação: esse é o mesmo método de autenticação suportado no Integration Service, seja por meio do aplicativo UiPath público ou de um aplicativo personalizado privado (método Traga seu próprio aplicativo).

Para obter detalhes, consulte Token interativo.

• Aplicativo OAuth - Indica o aplicativo (cliente) a ser usado. Este campo é compatível apenas com variáveis OAuthApplication. Selecione uma das duas opções:
  • UiPath - Padrão. Quando você deseja usar o aplicativo criado pela UiPath (registro de aplicativo público da UiPath). Se selecionado, os campos IDDoAplicativo e Tenant fornecidos na seção Autenticação serão ignorados.
  • Personalizado - Quando você deseja criar seu próprio aplicativo com permissões específicas. Nesse caso, você deve definir um valor para o campo ID do aplicativo. Consulte Como criar um aplicativo para conexões do Microsoft 365 Scope.

Application ID e Certificate (Unattended)

Para obter detalhes, consulte ID e certificado do aplicativo.

• Certificado como Base64 - A representação Base64 do certificado.

• Senha do certificado - Uma senha opcional que pode ser necessária para usar o certificado, como uma Secure String.

Application ID and Secret (Unattended)

Para obter detalhes, consulte ID e segredo do aplicativo.

• Segredo do Aplicativo - A string secreta que o aplicativo usa para fornecer sua identidade.
• Segredo seguro do aplicativo - O segredo do aplicativo (cliente), como um SecureString.

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

Para obter detalhes, consulte Nome de usuário e senha.

Importante: a Microsoft desativou a autenticação básica para o Exchange online. Isso afeta algumas de nossas atividades, como o escopo do Microsoft Office365. Recomendamos usar o protocolo OAuth nas atividades que o suportam.

• Senha - A senha de sua conta do Microsoft 365.
• Senha segura - A senha de sua conta do Microsoft 365, como um SecureString.
• Nome de usuário - O nome de usuário de sua conta do Microsoft 365.

Comum

• TempoLimiteEmMs - Especifica a quantidade de tempo para aguardar (em milissegundos) para que a autenticação interativa (caixa de diálogo de consentimento) seja concluída antes que um erro seja gerado. Esse campo é compatível apenas com inteiros e variáveis Int32. O valor padrão é 3000 ms (30 segundos) (não exibido).
• ContinuarComErro — se definido, continua a execução das atividades restantes mesmo se a atividade atual falhar.

Solução de problemas

Se você tiver algum problema com a autenticação, consulte Solução de problemas - Autenticação.