- Erste Schritte
- Authentication
- Scopes und Berechtigungen
- Plattformverwaltungs-APIs
Private Test Cloud API-Anleitung
Wir unterstützen die Authentifizierung durch ROPC (Resource Owner Password Credentials) für die Abwärtskompatibilität für Orchestrator-Instanzen, die von eigenständigen zu Automation Suite-Bereitstellungen migriert wurden.
Nur Hostadministratoren sollten sich mit dem /api/account/authenticate/ -Endpunkt authentifizieren.
Geschäftsanwender sollten sich mithilfe externer Anwendungen authentifizieren.
Um das Zugriffstoken abzurufen, stellen Sie eine POST-Anforderung an den /api/account/authenticate -Endpunkt mit der folgenden Nutzlast:
{
"TenancyName": "{account_tenant_name}",
"UsernameOrEmailAddress": "{account_username}",
"Password": "{account_password}"
}
{
"TenancyName": "{account_tenant_name}",
"UsernameOrEmailAddress": "{account_username}",
"Password": "{account_password}"
}
Wo:
{account_tenant_name}– ist der Name des Mandanten in Ihrem Automation Suite-Konto{account_username}– ist der Benutzername Ihres Automation Suite-Kontos{account_password}– ist das Kennwort, mit dem Sie sich bei Ihrem Automation Suite-Konto anmelden
Um den Wert TenancyName Ihrer Orchestrator-Instanz zu finden, stellen Sie eine GET-Anforderung an /odata/Users/UiPath.Server.Configuration.OData.GetCurrentUser.
Der Antworttext gibt das Bearer-Token zurück, das von Ihrer Anwendung verwendet wird, um weitere API-Aufrufe zu autorisieren. Fügen Sie daher im Autorisierungsheader eines API-Aufrufs Bearer xxxx an und ersetzen Sie xxxx durch den Wert {access_token} (z. B. Authorization: Bearer eyJhbG ... LnVxjA).
{
"result": "{access_token}",
"targetUrl": null,
"success": true,
"error": null,
"unAuthorizedRequest": false,
"__abp": true
}
{
"result": "{access_token}",
"targetUrl": null,
"success": true,
"error": null,
"unAuthorizedRequest": false,
"__abp": true
}
- Standardmäßig ist das Zugriffstoken 30 Minuten lang gültig. Um einen neuen zu generieren, rufen Sie den
api/account/authenticate-Endpunkt erneut auf. - Wenn Ihre Automation Suite-Organisation das Azure Active Directory-Modell verwendet, müssen Sie externe Anwendungen in der Automation Suite registrieren und externe Apps verwenden.