Conectar Robôs ao Orchestrator

Este artigo descreve como escolher o método de conexão do robô ao Orchestrator, dependendo do mecanismo de autenticação de robôs definido no Orchestrator. A UiPath fornece vários métodos de autenticação de robôs, que variam desde a expiração da autenticação com tokens até a autenticação com tokens que nunca expiram.

Os três mecanismos de autenticação disponíveis são o estado resultante de duas configurações de tenant do Orchestrator localizado na página Configurações > guia Segurança.

Quais são os tipos de autenticação dos robôs?

Standard Authentication

Permita apenas conexões com tokens de autenticação que nunca expiram desmarcando ambas as opções de autenticação na página Configurações > guia Segurança.

• Permitir tanto a autenticação do usuário quanto a autenticação da chave do robô - não selecionado

• Impor a autenticação do usuário, desabilitar a autenticação da chave do robô - não selecionado

Tipo	Implicações
Assistido	Restrinja a autenticação de robôs assistidos no Assistant à chave da máquina.Não há nenhuma opção Logon exibida no Assistant e, portanto, os usuários não podem conectar o Studio e o Assistant ao Orchestrator usando suas credenciais.
Não Assistido	Os robôs não assistidos necessitam de conexões da chave da máquina todo o tempo.

Autenticação híbrida

Permite tanto conexões padrão com tokens que não expiram quanto conexões com tokens que expiram ao habilitar Permitir tanto a autenticação do usuário quanto a autenticação da chave do robô e desmarcar Impor a autenticação do usuário, desabilitar a autenticação da chave do robô.

Permitir tanto a autenticação do usuário quanto a autenticação da chave do robô - selecionado

Impor a autenticação do usuário, desabilitar a autenticação da chave do robô - não selecionado

Implicações
Assistido	Você pode usar login interativo para autenticar robôs assistidos. A opção Entrar é exibida no Assistant, permitindo que os usuários conectem o Studio e o Assistant ao Orchestrator usando suas credenciais, mas isso não é necessário.
Não Assistido	Os robôs não assistidos necessitam de conexões da chave da máquina todo o tempo.

Autenticação segura

Permita apenas conexões com tokens que expiram habilitando as opções de autenticação na página de Configurações > aba de Segurança. O login do usuário é necessário para fazer solicitações HTTP do Orchestrator, executar robôs assistidos ou visualizar processos no Assistant.

Permitir tanto a autenticação do usuário quanto a autenticação da chave do robô - selecionado

Impor a autenticação do usuário, desabilitar a autenticação da chave do robô - selecionado

Implicações
Assistido	Restrinja a autenticação de robôs assistidos no Assistant ao logon de usuários interativos. A autenticação de robôs assistidos requer logon, caso contrário o usuário não verá seus processos associados no Assistant e o robô aparecerá como "Conectado, não licenciado".
Não Assistido	Os robôs não assistidos necessitam de conexões da chave da máquina todo o tempo.
Não assistidos no modo assistido	Para os não assistidos, a máquina de host é conectada e licenciado no modo não assistido, de forma que a maneira designada para executar processos é o Orchestrator. Se quiser usar a máquina no modo assistido (abrindo o Assistant) quando a autenticação do usuário for imposta, você precisará fazer logon; caso contrário, você não poderá ver os processos no Assistant, e o robô aparecerá como "Conectado, não licenciado".

AVISO:

Esse método de autenticação requer a recompilação dos fluxos de trabalho que usam atividades do Orchestrator ou fazem chamadas HTTP diretas para a API do Orchestrator utilizando pacotes de atividades v2020.10 ou superiores.

Há uma chance de que a execução de trabalhos falhe se for usada pelo menos uma das dependências abaixo em um projeto de automação:

• UiPath.System.Activities < 20.10.0
• UiPath.Persistence.Activities < 1.1.7
• UiPath.DataService.Activities < 20.10.0
• UiPath.Testing.Activities < 1.2.0

Use a Ferramenta de atualização em massa das dependências do projeto no Studio para atualizar dependências de processos para versões maiores ou iguais às fornecidas acima. Teste antes de implantar em produção.

Conectar robôs assistidos ao Orchestrator

Logon interativo

Use o logon interativo para autenticar robôs assistidos.A opção Logon é exibida no Assistant, permitindo que os usuários conectem o Studio e o Assistant ao Orchestrator usando suas credenciais.Compatível com:

• Autenticação híbrida
• Autenticação segura

1. Abra o Assistant.
2. No menu Preferências, selecione Logon. Você será direcionado à página Logon da sua instância do Orchestrator.
3. Faça logon da forma habitual.
4. Após sua identidade ser confirmada, o UiPath Assistant será preenchido com os processos nas pastas às quais sua conta tem acesso. Saiba mais sobre a autenticação interativa.
   Observação:

   • Ao usar o login interativo, não é necessário criar

     objetos de máquina no Orchestrator.

   • Você precisa da permissão Visualizar em Pacotes no nível do tenant para baixar pacotes e bibliotecas.

   Importante: o login interativo não tem suporte em um contexto de pasta clássico.

Usando a chave da máquina no assistente

Use a chave da máquina gerada no Orchestrator para autenticar robôs assistidos.Compatível com:

• Standard Authentication

• Autenticação híbrida

  Observação:

  • O responsável pela configuração do Orchestrator na empresa deve fornecer aos usuários e desenvolvedores assistidos a URL do Orchestrator e a chave da máquina corretas. Os objetos da máquina não precisam ser atribuídos às pastas do Orchestrator, apenas as contas.
  • Se houver várias contas trabalhando na mesma máquina, será necessário criar um robô no Orchestrator para cada uma delas.

1. Abra o Assistant.
2. No menu Preferências, selecione Preferências. A janela Preferências é exibida.
   
   

   

   
   
3. Navegue até Configurações do Orchestrator.
4. No campo URL do Orchestrator, insira o endereço da web do Orchestrator, como https://myOrchestrator.uipath.com/..
5. No campo Chave da máquina, insira a chave gerada pela entidade da máquina no Orchestrator.
6. Clique em Conectar.O robô agora está conectado ao Orchestrator.
   
   

   

   
   

Usando a chave da máquina na linha de comando

1. Salve a chave de máquina gerada no Orchestrator na área de transferência ou em um arquivo.
2. Abra o prompt de comando.
3. Acesse o diretório em que seu robô está instalado (por padrão C:\Program Files\UiPath\Studio). Por exemplo: cd C:\Program Files\UiPath\Studio.
4. Use os argumentos de linha de comando --connect, -url e -key em conjunto com a URL do Orchestrator e a chave da máquina. Por exemplo: UiRobot.exe --connect -url https://demo.uipath.com/ -key ba1e4809-2f64-4965-bae2-efda62d20164. O robô agora está conectado ao Orchestrator.
   Nota: Substitua "https://demo.uipath.com/" com o URL real do orquestrador.

Conectar robôs não assistidos ao Orchestrator

Usando a chave da máquina no assistente

Use a chave da máquina gerada no Orchestrator para autenticar robôs não assistidos.As conexões da chave da máquina são necessárias todo o tempo para a execução não assistida.Compatível com:

• Standard Authentication
• Autenticação híbrida

• Autenticação segura

Observação: os privilégios do administrador são necessários para executar esse procedimento para os robôs de modo de serviço.

Importante:

A máquina do host é conectada e licenciada no modo não assistido, para que você possa executar processos não assistidos usando o Orchestrator.

Se quiser usar a máquina no modo assistido (abrindo o Assistant) quando a autenticação do usuário for imposta, você precisará fazer logon; caso contrário, você não poderá ver os processos no Assistant, e o robô aparecerá como "Conectado, não licenciado".

1. Abra o Assistant.
2. No menu Preferências, selecione Preferências. A janela Preferências é exibida.
   
   

   

   
   
3. Navegue até Configurações do Orchestrator.
4. No campo URL do Orchestrator, insira o endereço da web do Orchestrator, como https://myOrchestrator.domain.local/..
5. No campo Chave da máquina, insira a chave gerada pela entidade da máquina no Orchestrator.
6. Clique em Conectar.O robô agora está conectado ao Orchestrator.
   
   

   

   
   

   Observação:

   • Os objetos da máquina precisam ser atribuídos a pastas no Orchestrator.

Usando a chave da máquina na linha de comando

1. Salve a chave de máquina gerada no Orchestrator na área de transferência ou em um arquivo.
2. Abra o prompt de comando.
3. Acesse o diretório em que seu robô está instalado (por padrão C:\Program Files\UiPath\Studio). Por exemplo: cd C:\Program Files\UiPath\Studio.
4. Use os argumentos de linha de comando --connect, -url e -key em conjunto com a URL do Orchestrator e a chave da máquina. Por exemplo: UiRobot.exe --connect -url https://demo.uipath.com/ -key ba1e4809-2f64-4965-bae2-efda62d20164. O robô agora está conectado ao Orchestrator.
   Nota: Substitua "https://demo.uipath.com/" com o URL real do orquestrador.