Migrer des clés API vers les jetons d’accès personnels (PAT)

Les clés API ainsi que les jetons d’accès personnels (PAT) peuvent être utilisés dans le cadre du processus d’authentification et d’autorisation. La présente section vous explique comment migrer des clés API vers les PAT.

Comprendre les clés API et les PAT

Les clés API sont essentiellement utilisées afin d’authentifier les requêtes adressées à l’API UiPath Orchestrator. Elles sont générées au niveau du locataire et permettent d’accéder à des ressources Orchestrator spécifiques.

En revanche, les PAT sont mieux adaptés à l’authentification des utilisateurs et des applications pour accéder aux services UiPath tels qu’Orchestrator, Studio, Document Understanding ou d’autres ressources de la plate-forme. Chaque PAT est associé à un seul compte utilisateur, et les niveaux d’accès peuvent être ajustés en fonction des besoins des utilisateurs.

Considérations relatives à la migration : pour migrer des clés API vers des PAT, ces derniers doivent être configurés en spécifiant des étendues d’application englobant toutes les étendues d’Orchestrator (OR.*).

Étendues et sécurité

Les clés API permettent d’accéder aux ressources d’un locataire Orchestrator spécifique et peuvent être restreintes via des autorisations associées à la clé API concernée. Les PAT, en revanche, permettent aux utilisateurs d’accéder aux ressources de leur organisation UiPath et peuvent attribuer des étendues d’accès spécifiques aux produits UiPath.

Sur le plan de la sécurité, les PAT sont plus sécurisés, dans la mesure où ils sont associés à des utilisateurs spécifiques et peuvent être révoqués ou remplacés à tout moment.

Considérations de migration : n’oubliez pas que, contrairement aux clés API, les PAT disposent de dates d’expiration. Par conséquent, il convient de procéder à une nouvelle génération de ces jetons avant leur expiration, afin de garantir un accès continu aux services UiPath.

Fonctionnement

Les clés API sont essentiellement utilisées dans le cadre d’un accès par programme aux points de terminaison de l’API Orchestrator.

Les champs d’application des PAT sont plus variés : cela peut concerner un accès par programme à différents services, mais également les interactions directes des utilisateurs avec le système.

Considérations relatives à la migration : bien que les clés API nécessitent d’obtenir un ensemble de jetons à partir d’un point de terminaison de l’authentification, les valeurs PAT doivent être utilisées directement dans les appels API en tant que valeurs de jeton du porteur dans l’en-tête d’autorisation (Authorization: Bearer <PAT value>)