Autenticação de robôs com credenciais de cliente

Configure a autenticação de robô usando credenciais de cliente do OAuth 2.0 para conectar robôs Unattended ao Orchestrator

Credenciais de cliente é um mecanismo de autenticação que usa a estrutura do OAuth 2.0 como base para o seu protocolo de autenticação, o que permite que robôs não assistidos se conectem ao Orchestrator com um par ID do cliente/segredo do cliente gerado através de objetos de modelo de máquina. O par ID do cliente/segredo do cliente gera um token que autoriza a conexão entre o robô e o Orchestrator, e fornece ao robô acesso a recursos do Orchestrator.

As credenciais do cliente permitem que o UiPath® Robot acesse recursos do Orchestrator usando suas próprias credenciais, em vez de representar um usuário. Quando o robô solicita recursos do Orchestrator, ele impõe a necessidade de o próprio robô ter autorização para executar uma ação, pois não há nenhum usuário envolvido na autenticação.

Importante:

Credenciais de cliente funcionam com o UiPath Robot 2022.2 ou superior.

Como funciona

Figura 1. Diagrama de autenticação de robô com credenciais do cliente

1. O usuário insere o ID do cliente e Segredo do cliente conforme gerado por um objeto de máquina no Orchestrator.
2. O robô solicita a configuração de autenticação do Orchestrator.
3. O Orchestrator confirma que Credenciais de cliente é o mecanismo usado para a autenticação de robôs.
4. O robô solicita um token de acesso do Identity Server apresentando o ID do cliente e o segredo do cliente como autenticação da sua própria identidade.
5. Se a identidade do robô for validada, o Identity Server emite um token de acesso para o UiPath Robot. A autorização é concluída.
6. O robô solicita o recurso do Orchestrator e apresenta o token de acesso para a autenticação.
7. Se o token de acesso for válido, o Orchestrator serve o recurso ao robô.

Geração de credenciais de autorização

As etapas a seguir explicam como gerar credenciais para autenticar seus robôs.

1. Navegue até Tenant > Máquinas.
2. Crie um modelo de máquina como você faria normalmente.
3. Depois de terminar de configurar seus campos, Selecione Provisionamento. O objeto da máquina é criado e uma janela de confirmação é exibida com detalhes sobre a máquina, incluindo o ID do cliente e Segredo do cliente.
   Importante:

   Você precisará do ID do cliente e segredo do cliente para conectar o robô ao Orchestrator. O segredo do cliente só pode ser visto uma vez logo após a sua criação, portanto, se quiser usar o mesmo segredo várias vezes, certifique-se de copiá-lo e armazená-lo em um local seguro de armazenamento. Considere usar criptografia ou hash para proteger seu armazenamento.

Geração de novos segredos do cliente

Você pode gerar novos segredos do cliente para o mesmo ID do cliente editando o objeto de máquina. As etapas a seguir explicam como gerar novos segredos.

1. Navegue até Tenant > Máquinas.
2. Para a máquina para a qual deseja gerar novos segredos, selecione Mais ações > Editar máquina
3. Na seção Segredos do cliente , selecione Adicionar novo para adicionar um novo segredo. Um novo segredo será gerado e estará visível para você copiá-lo.
   Importante:

   O segredo do cliente só pode ser visto uma vez logo após a sua criação, portanto, se quiser usar o mesmo segredo várias vezes, certifique-se de copiá-lo e armazená-lo em um local seguro de armazenamento. Certifique-se também de armazenar o ID do segredo, pois essa é a única maneira de identificar o segredo caso queira excluí-lo mais tarde, por exemplo.

Como excluir segredos existentes do cliente

Você pode excluir qualquer segredo para revogar o acesso de máquinas que estejam empregando esses segredos para se conectarem ao Orchestrator. As etapas a seguir explicam como excluir segredos existentes.

1. Navegue até Tenant > Máquinas.
2. Para a máquina para a qual deseja excluir segredos, selecione Mais ações > Editar máquina
3. Na seção Segredos do cliente , selecione Excluir segredo do cliente para o segredo que você deseja excluir. Uma janela de confirmação será exibida.
4. Selecione Excluir na janela de confirmação para confirmar a operação de exclusão. O segredo será excluído com sucesso e todas as máquinas host empregando-o para se conectar ao Orchestrator serão desconectadas.
   Importante:

   A exclusão de um segredo é permanente e faz com que o robô se desconecte, revogando assim o acesso de máquinas de host que usam esse segredo para se conectar ao Orchestrator. Isso interrompe qualquer execução que esteja ocorrendo nessas máquinas de host e impede que qualquer execução posterior aconteça.