Migrieren von API-Schlüsseln zu persönlichen Zugriffstoken (PATs)

API-Schlüssel sowie persönliche Zugriffstoken (PATs) werden für die Authentifizierung und Autorisierung verwendet. Das ist Ihr Handbuch für die Migration von API-Schlüsseln zu PATs.

Grundlegendes zu API-Schlüsseln und PATs

API-Schlüssel werden hauptsächlich zur Authentifizierung von Anforderungen an die UiPath Orchestrator-API verwendet. Sie werden auf Mandantenebene generiert und bieten Zugriff auf bestimmte Orchestrator-Ressourcen.

Andererseits sind PATs auf die Authentifizierung von Benutzern und Anwendungen zugeschnitten, die auf UiPath-Dienste wie Orchestrator, Studio, Document Understanding und Platform-Ressourcen zugreifen. Jedes PAT ist mit einem einzelnen Benutzerkonto verknüpft, und Zugriffsebenen können je nach den Anforderungen des Benutzers angepasst werden.

Migrationshinweise: Für die Migration von API-Schlüsseln zu PATs müssen die PATs mit Anwendungs-Scopes definiert werden, die alle Orchestrator-Scopes umfassen (OR.*).

Scope und Sicherheit

API-Schlüssel ermöglichen den Zugriff auf Ressourcen innerhalb eines bestimmten Orchestrator-Mandanten und können über Berechtigungen eingeschränkt werden, die mit dem API-Schlüssel verknüpft sind. PATs hingegen gewähren Benutzern Zugriff auf die Ressourcen innerhalb ihrer UiPath-Organisation und können bestimmten Zugriffs-Scopes innerhalb von UiPath-Produkten zugewiesen werden.

In Bezug auf die Sicherheit sind PATs sicherer, da sie mit einzelnen Benutzern verknüpft sind und jederzeit widerrufen oder ersetzt werden können.

Migrationshinweise: Denken Sie daran, dass PATs im Gegensatz zu API-Schlüsseln ein Ablaufdatum haben. Daher müssen diese Token vor ihrem Ablauf neu generiert werden, um einen ununterbrochenen Zugriff auf die UiPath-Dienste sicherzustellen.

Funktionsweise

API-Schlüssel werden hauptsächlich für den programmatischen Zugriff auf Orchestrator API-Endpunkte verwendet.

PATs haben vielfältigere Anwendungen, einschließlich programmatischen Zugriff auf mehrere Dienste, aber auch direkte Benutzerinteraktionen mit dem System.

Migrationshinweise: Während API-Schlüssel eine Reihe von Token von einem Authentifizierungsendpunkt erhalten müssen, sollten PAT-Werte direkt in den API-Aufrufen als Bearer-Token-Werte im Autorisierungsheader verwendet werden (Authorization: Bearer <PAT value>)