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ô - não selecionado

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

Tipo	Implicações
Assistido	Você pode usar login 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.
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 ambas as opções de autenticação na página Configurações > guia Segurança. É necessário o logon do usuário para fazer solicitações HTTP do Orchestrator, executar robôs assistidos ou ver 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

Tipo	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".

Importante:

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 Assistant será preenchido com os processos nas pastas às quais seu usuário 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.

   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:

  • A pessoa que trata da 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.Objetos da máquina não precisam ser atribuídos às pastas do Orchestrator, apenas usuários.
  • Se houver vários usuários trabalhando na mesma máquina, será necessário criar um robô no Orchestrator para cada um deles.

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.

   Aprenda sobre as várias entidades da máquina no Orchestrator e quando usar cada uma delas.

6. Clique em Conectar.O robô agora está conectado ao Orchestrator.
   
   

   

   
   

   Observação: a funcionalidade de robôs de alta densidade serve apenas se o mesmo nome e chave da máquina forem usados ao registrar cada robô por usuário.

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. Vá ao diretório no qual seu UiPath Robot 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 UiPath Robot agora está conectado ao Orchestrator.Em um ambiente de alta densidade, o robô correspondente a cada usuário é conectado ao Orchestrator.

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.Aprenda sobre as várias entidades da máquina no Orchestrator e quando usar cada uma delas.
6. Clique em Conectar.O UiPath Robot agora está conectado ao Orchestrator.
   
   

   

   
   

   Observação:

   • Os objetos da máquina precisam ser atribuídos a pastas no Orchestrator.
   • A funcionalidade de robôs de alta densidade serve apenas se o mesmo nome e chave da máquina forem usados ao registrar cada robô por usuário.

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. Vá ao diretório no qual seu UiPath Robot 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 UiPath Robot agora está conectado ao Orchestrator.Em um ambiente de alta densidade, o robô correspondente a cada usuário será conectado ao Orchestrator.

Inscrição automática

Use uma string de conexão para registrar automaticamente robôs de serviço no Orchestrator.

A string de conexão é uma URL que contém as seguintes informações:

• a URL do Orchestrator - identifica a instância do Orchestrator à qual o UiPath Robot se conecta;
• ID do tenant - identifica o tenant ao qual o UiPath Robot se conecta;
• nome de domínio - identifica o domínio da máquina; isso é necessário apenas se a máquina estiver em um domínio diferente daquele especificado para o parâmetro WindowsAuth.Domain (isso também é válido para máquinas de subdomínio). O domínio precisa estar em um relacionamento de confiança bidirecional com aquele definido para o parâmetro WindowsAuth.Domain.

  Clique aqui para obter detalhes sobre os parâmetros de autorização no UiPath.Orchestrator.dll.config.

Veja abaixo dois exemplos de strings de conexão de acordo com o domínio da máquina:

• O mesmo domínio especificado em UiPath.Orchestrator.dll.config - https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1
• Domínio diferente daquele especificado em UiPath.Orchestrator.dll.config - https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1&domainName=domain_name
  Observação:

  Para implantar robôs no Orchestrator usando a string de conexão, é necessário o seguinte:

  • o parâmetro WindowsAuth.Enabled deve ser definido como true
  • o parâmetro WindowsAuth.Domain deve ser configurado para um domínio válido
  • o robô de modo de serviço deve ser instalado.

1. No Orchestrator, navegue até Configurações, guia Geral. (Tenant > Configurações > Geral). Procure o campo String de conexão na seção Configurações do aplicativo e clique em Copiar. A string de conexão é copiada para a área de transferência.
   
   

   

   
   
2. Envie a string de conexão para o máquina do robô que você deseja conectar ao Orchestrator (por e-mail, pendrive etc.)
3. Use uma ferramenta de implantação automática para instalar os robôs e forneça a string de conexão copiada acima no parâmetro StringDeConexão usado com o instalador do UiPathStudio.msi.O UiPath Robot é conectado ao Orchestrator e é exibido como Disponível na página Robôs.
   Observação: a conexão de robôs ao Orchestrator usando o parâmetro --connectionstring só é possível quando são usadas máquinas padrão. Ambientes com modelos de máquinas não são compatíveis com isso.