Conectar Robôs ao Orchestrator

É possível conectar seus robôs ao Orchestrator de diferentes maneiras, com base nas configurações de autenticação de robôs definidas no Orchestrator, geralmente por um administrador. Se você não souber quais são as configurações de autenticação dos Robôs, peça a seu administrador do Orchestrator para fornecer detalhes para que você possa usar o método correto para conectar seu Robô.

Quais são minhas configurações de autenticação

The robot authentication settings can be seen and configured on Tenant > Settings, on the Robot security tab, usually by an administrator. Your Orchestrator administrator should provide you with details so as to be able to use the right method to connect your robot.

Mais em autenticação de robôs.

Instruções sobre como alterar as configurações de autenticação de robôs.

Conectar robôs assistidos ao Orchestrator

Usando o URL de serviço (Login Interativo)

Faça logon com suas credenciais para conectar seu robô ao Orchestrator. Isso dá ao robô acesso aos recursos do Orchestrator e fornece ao usuário direitos de operação para produtos, como o Studio ou UiPath Assistant.

1. Abra o Assistant.
2. No menu Preferências, selecione Configurações do Orchestrator. A janela Configuração do Orchestrator será exibida.
3. Para o campo Tipo de conexão, selecione URL de serviço. O conteúdo da janela é ajustado de acordo com a seleção.
4. Para o campo URL de serviço, insira o URL da instância do Orchestrator à qual você deseja se conectar.
5. Selecione Entrar. Você será direcionado à página Logon da sua instância do Orchestrator.
6. Faça logon da forma habitual.

Depois que sua identidade é confirmada, o Assistant é preenchido com as automações nas pastas do Orchestrator que você pode acessar.

Figura 1. Conexão usando o URL do serviço

Observação:

• Ao usar o login interativo, não há necessidade de 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.

Usando as credenciais do cliente no assistente

Use credenciais do cliente para conectar UiPath Robots Attended ao Orchestrator. ID do cliente — o par de segredo do cliente é gerado por meio de objetos de modelo de máquina no Orchestrator.

Existem duas maneiras de conectar seu robô com as credenciais de cliente: usando o UiPath Assistant ou a linha de comando.

1. Abra o Assistant.
2. No menu Preferências, selecione Configurações do Orchestrator. A janela Configuração do Orchestrator será exibida.
3. Para o campo Tipo de conexão, selecione ID do Cliente. O conteúdo da janela é ajustado de acordo com a seleção.
4. Para o campo URL do Orchestrator, insira o URL da instância do Orchestrator à qual você deseja se conectar.

Certifique-se de adicionar o URL do Orchestrator e AccountLogicalName e ServiceName, como https://cloud.uipath.com/uipathtokyo/uipathkyoto/.

5. Para o campo ID do cliente, insira o ID do Cliente gerado pelo objeto de máquina no Orchestrator.
6. Para o campo Segredo do cliente, insira o segredo do Cliente gerado pelo objeto de máquina no Orchestrator.
7. Selecione Conectar. O robô agora está conectado ao Orchestrator.

Figura 2. Conexão usando o ID do Cliente

Usando as credenciais do cliente na linha de comando

1. Abra o prompt de comando.
2. Acesse o diretório em que seu robô está instalado. Por exemplo:

   cd C:\Program Files\UiPath\Studio
   

3. Use os argumentos de linha de comando --connect, --url, --clientID e --clientSecret para conectar seu robô e passar o URL do Orchestrator, ID do cliente e segredo do cliente. Por exemplo:

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   Observação:

   Ao usar o PowerShell, é necessário usar o escape para o caractere $ no segredo do cliente com "". Por exemplo, você deve passar um segredo do cliente como o Bepx8O3XqSHrt$ZU como "Bepx8O3XqSHrt""$""ZU".

Conectar robôs não assistidos ao Orchestrator

Em automações não assistidas, a máquina do host é conectada e licenciada no modo não assistido para que a maneira designada de executar processos seja o Orchestrator. Se quiser usar a máquina no modo assistido (abrindo o UiPath Assistant) quando o logon interativo é exigido, você precisa fazer logon. Caso contrário, não será possível ver os processos no UiPath Assistant e o robô aparece como “Conectado, Não licenciado”.

Usando as credenciais do cliente no assistente

Use as credenciais de cliente para conectar robôs não assistidos ao Orchestrator. ID do cliente — o par de segredo do cliente é gerado por meio de objetos de modelo de máquina no Orchestrator.

Existem duas maneiras de conectar seu robô com as credenciais de cliente: usando o UiPath Assistant ou a linha de comando.

1. Abra o Assistant.
2. No menu Preferências, selecione Configurações do Orchestrator. A janela Configuração do Orchestrator será exibida.
3. Para o campo Tipo de conexão, selecione ID do Cliente. O conteúdo da janela é ajustado de acordo com a seleção.
4. Para o campo URL do Orchestrator, insira o URL da instância do Orchestrator à qual você deseja se conectar.

Certifique-se de adicionar o URL do Orchestrator e AccountLogicalName e ServiceName, como https://cloud.uipath.com/uipathtokyo/uipathkyoto/.

5. Para o campo ID do cliente, insira o ID do Cliente gerado pelo objeto de máquina no Orchestrator.
6. Para o campo Segredo do cliente, insira o segredo do Cliente gerado pelo objeto de máquina no Orchestrator.
7. Selecione Conectar. O robô agora está conectado ao Orchestrator.

Figura 3. Conexão usando o ID do Cliente

Em uma conexão bem-sucedida, o Assistant exibirá um ponto de aviso, seguido pela mensagem Connected as Unattended .

O aviso é exibido quando conectado a uma sessão ativa do Windows e você não tem recursos Attended. Para habilitar o modo Attended , faça login com sua conta de Desenvolvedor de RPA.

Observação:

Quando você estiver conectado como Unattended, o seguinte erro será registrado no Visualizador de Eventos do Windows > Eventos do aplicativo:

UiPath.Service.Host 25.10.7.0

[Status HTTP 401][Código de erro do Orchestrator

InvalidLoginMethod]UiPath.Robot.Core.Orchestrator.OrchestratorHttpException

Não foi possível conseguir o token do usuário. Sua conexão é Unattended. Faça logon ou habilite a sessão de solução de problemas do Orchestrator.

Usando as credenciais do cliente na linha de comando

1. Abra o prompt de comando.
2. Acesse o diretório em que seu robô está instalado. Por exemplo:

   cd C:\Program Files\UiPath\Studio
   

3. Use os argumentos de linha de comando --connect, --url, --clientID e --clientSecret para conectar seu robô e passar o URL do Orchestrator, ID do cliente e segredo do cliente. Por exemplo:

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   Observação:

   Ao usar o PowerShell, é necessário usar o escape para o caractere $ no segredo do cliente com "". Por exemplo, você deve passar um segredo do cliente como o Bepx8O3XqSHrt$ZU como "Bepx8O3XqSHrt""$""ZU".

Atualize o URL padrão do orquestrador para Mac

Para atualizar o serviço de URL do Orchestrator padrão ao usar o Assistant em um Mac, altere-o no store.json (/Applications/UiPath Assistant.app/Contents/Robot/uipath.config~/Library/ApplicationSupport/UiPath/store.json):

"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }