Sie können anstelle der sitzungsbasierten Authentifizierung mithilfe von Token auf die Orchestrator-APIs zugreifen. Als Enterprise-Superuser können Sie die API-Token verwalten. Sie können mehrere API-Token für einen Benutzer erstellen.

Hinweis:
  • Für Enterprise Read Only- und MSP Business Specialist-Benutzer ist die tokenbasierte Authentifizierung nicht aktiviert.
  • Der Enterprise-Superuser sollte inaktive IdP-Benutzer (Identity Provider, Identitätsanbieter) manuell aus dem Orchestrator löschen, um nicht autorisierten Zugriff über API-Token zu verhindern.

Die Benutzer können die Token basierend auf ihren Rollen erstellen, widerrufen und herunterladen.

So verwalten Sie die API-Token:
  1. Erweitern Sie im Unternehmensportal in der Leiste „Globale Navigation (Global Navigation)“ das Dropdown-Menü Enterprise-Anwendungen (Enterprise Applications).
  2. Wählen Sie den Dienst Globale Einstellungen (Global Settings) aus.
  3. Navigieren Sie zu Benutzerverwaltung (User Management) > Benutzer (User).
  4. Wählen Sie einen Benutzer aus und klicken Sie auf Ändern (Modify) oder klicken Sie auf den Link zum Benutzernamen. Navigieren Sie zum Abschnitt API-Token (API Tokens).
  5. Klicken Sie auf Neues API-Token (New API Token).
  6. Geben Sie im Fenster Neues Token (New Token) in den Feldern Name und Beschreibung (Description) Werte für das Token ein und wählen Sie dann im Dropdown-Menü die Lebensdauer (Lifetime) aus.
  7. Klicken Sie auf Speichern (Save). Das neue Token wird in der Tabelle API-Token (API Tokens) angezeigt. Anfänglich wird der Status des Tokens als Ausstehend (Pending) angezeigt. Nach dem Herunterladen ändert sich der Status in Aktiviert (Enabled).
  8. Zum Herunterladen des Tokens wählen Sie es aus und klicken dann auf API-Token herunterladen (Download API Token).
  9. Zum Deaktivieren eines Tokens wählen Sie es aus und klicken auf API-Token widerrufen (Revoke API Token). Der Status des Token wird als Widerrufen (Revoked) angezeigt.
  10. Klicken Sie auf CSV, um die vollständige Liste der API-Token im CSV-Dateiformat herunterzuladen.
  11. Nach Ablauf der Lebensdauer des Tokens ändert sich der Status in Abgelaufen (Expired).
Hinweis: Nur der mit dem Token verknüpfte Benutzer kann das Token herunterladen. Nach dem Herunterladen wird nur die ID des Tokens angezeigt. Sie können ein Token nur einmal herunterladen. Nach dem Herunterladen kann der Benutzer das Token als Teil des Autorisierungs-Headers der Anforderung senden, um auf die Orchestrator-API zuzugreifen.
Das folgende Beispiel zeigt einen Beispielausschnitt des Codes für den Zugriff auf eine API. 
curl -k -H "Authorization: Token <Token>"
  -X POST https://vco/portal/
  -d '{ "id": 1, "jsonrpc": "2.0", "method": "enterprise/getEnterpriseUsers", "params": { "enterpriseId": 1 }}'
Im Folgenden finden Sie weitere Optionen im Abschnitt API-Token (API Tokens):
Option Beschreibung
Suchen (Search) Geben Sie einen Suchbegriff ein, um in der Tabelle nach dem übereinstimmenden Text zu suchen. Verwenden Sie die Option für die erweiterte Suche, um die Suchergebnisse einzugrenzen.
Spalten (Columns) Wählen Sie mit einem Klick die Spalten aus, die auf der Seite angezeigt oder ausgeblendet werden sollen.
Aktualisieren (Refresh) Klicken Sie auf diese Option, um die Seite zu aktualisieren, damit die aktuellsten Daten angezeigt werden.