Migração de chaves de API para Tokens de acesso pessoal (PATs)

Tanto as chaves de API quanto os Tokens de acesso pessoal (PATs) são usados para autenticação e autorização. Este é seu guia sobre como migrar de chaves de API para PATs.

Compreensão das chaves de API e PATs

As chaves de API são usadas principalmente para autenticar solicitações para a API do UiPath Orchestrator. Elas são geradas no nível do tenant e oferecem acesso a recursos específicos do Orchestrator.

Por outro lado, os PATs são personalizados para autenticar usuários e aplicativos que acessam serviços da UiPath, como recursos do Orchestrator, Studio, Document Understanding e Platform. Cada PAT é associado a uma única conta de usuário, e os níveis de acesso podem ser ajustados com base nas necessidades do usuário.

Considerações de migração: para migrar de Chaves de API para PATs, os PATs devem ser definidos usando escopos de aplicativos que abranjam todos os escopos do Orchestrator (OR.*).

Escopo e segurança

As chaves de API permitem o acesso a recursos dentro de um tenant específico do Orchestrator e podem ser restritas por meio de permissões associadas à chave de API. OS PATs, por outro lado, concedem aos usuários acesso aos recursos dentro de sua organização da UiPath e podem receber escopos de acesso específicos dentro dos produtos da UiPath.

Em termos de segurança, os PATs são mais seguros porque eles têm links para usuários individuais e podem ser revogados ou substituídos a qualquer momento.

Considerações de migração: lembre-se que, ao contrário das chaves de API, os PATs têm datas de expiração. Portanto, esses tokens devem ser regenerados antes da expiração para garantir o acesso ininterrupto aos serviços da UiPath.

Mecanismo de trabalho

As chaves de API são utilizadas principalmente para acesso programático aos pontos de extremidade de API do Orchestrator.

OS PATs têm aplicativos mais variados, incluindo acesso programático a vários serviços, mas também orientam interações do usuário com o sistema.

Considerações de migração: embora as chaves de API exijam a obtenção de um conjunto de tokens de um ponto de extremidade de autenticação, os valores PAT devem ser usados diretamente nas chamadas de API como valores de token do portador no cabeçalho de autorização (Authorization: Bearer <PAT value>)