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 texto ou de credenciais do Orchestrator, ou ambos. Recomendamos que você use essa 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 é oculta, 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 é compatível com IResource variáveis. Selecione o botão Gerenciar ativos para abrir o Orchestrator. A lista de ativos disponíveis depende do Orchestrator ao qual seu Studio e seu Robot estão conectados. Você pode usar o ativo no momento do design. Além disso, o ativo pode ser apenas do tipo texto.

  • 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 diretamente na atividade Scope.

• Verifique o formato do ativo em Como usar atividades do 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 de 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 a quantidade de tempo para aguardar (em milissegundos) para que a autenticação interativa (caixa de diálogo Consentimento) seja concluída antes que um erro seja gerado. Esse campo é compatível apenas com números inteiros e variáveis Int32 . O valor padrão é 3000 ms (30 segundos).

Runtime

• Ativos de conexão de runtime — Navegue para selecionar um ativo. Este campo permite que você selecione um ativo diferente para runtime. Use o menu do botão Mais para selecionar Caminho relativo e insira o caminho completo do ativo do Orchestrator que contém os detalhes da conexão. Recomendamos que você use um ativo de credencial neste campo, mas você também pode usar um ativo de texto. O valor JSON deve ser definido no campo de senha para ativos de credenciais. Este valor é opcional e, se deixado em branco, os valores de tempo de design serão usados em runtime.

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.
• EscoposDeAutenticação
  • Verifique a seção do assistente Usando 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. A 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)).

• Local do armazenamento de dados de conexão — uma lista suspensa que especifica onde a resposta do token é armazenada. Os valores de propriedades disponíveis são Disco local, Orchestrator ou Nunca armazenar.

  • Disco local - Os tokens de conexão são armazenados em uma pasta local na máquina. A mesma conexão pode ser usada em vários processos na mesma máquina.
  • Orchestrator - Os tokens de conexão são armazenados no Orchestrator como ativos em uma pasta especificada. A mesma conexão pode ser usada em vários processos em várias máquinas, desde que tenha acesso à pasta do Orchestrator especificada.
  • Nunca armazenar - Os tokens de conexão nunca são armazenados.
  Observação:

  A solução de armazenamento do O365 é diferente da do GSuite devido a limitações técnicas. O O365 armazena todas as contas em um único arquivo no Orchestrator, enquanto que o GSuite armazena um arquivo por conta.

• Caminho da pasta de conexão do Orchestrator — a pasta do Orchestrator em que as operações ocorrem. Deixe vazia se pastas Modernas não estiver habilitado. Para obter mais detalhes, consulte Sobre pastas no guia do Orchestrator.

• 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 do ID do aplicativo e segredo e ID do aplicativo e certificado .

Token Interativo

Observação:

Esse é o mesmo método de autenticação que o Integration Service suporta por meio do Aplicativo público da UiPath ou do 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ê quiser 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 . Verifique o Registro de aplicativo OAuth personalizado - Traga seu próprio aplicativo (BYOA).
• Usar agente – Defina essa opção como Verdadeiro para usar o agente do Gerenciador de Autenticação do Windows (WAM) para autenticação interativa. Essa opção fornece uma experiência de autenticação mais integrada no Windows.
• UsuárioDoOAuth2 - O email do usuário que fará login por meio do token interativo.

Application ID e Certificate (Unattended)

Para obter detalhes, consulte ID do aplicativo e certificado.

• Certificado como Base64 - A representação Base64 do certificado.
• Senha do certificado - Uma senha opcional que pode ser solicitada para usar o certificado, como um Secure String.

Application ID and Secret (Unattended)

Para obter detalhes, consulte ID do aplicativo e Segredo.

• Application Secret - The secret string that the application uses to provide its identity.
• Secure Application Secret - The Application (client) secret, as a SecureString.

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

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

Importante:

A Microsoft está substituindo a autenticação básica pelo 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 Consentimento) seja concluída antes que um erro seja gerado. Esse campo é compatível apenas com números inteiros e variáveis Int32 . O valor padrão é 30000 ms (30 segundos) (não mostrado).
• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.

Solução de problemas

Se você encontrar qualquer problema com a autenticação, verifique Solução de problemas — Autenticação.