API-Schlüssel verwalten

IMPORTANT
Workfront empfiehlt die Verwendung des /login-Endpunkts oder der API-Schlüssel nicht mehr. Verwenden Sie stattdessen eine der folgenden Authentifizierungsmethoden:
  • Server-Authentifizierung mit JWT
  • Benutzerauthentifizierung mit OAuth2
Anweisungen zum Einrichten dieser Authentifizierungsmethoden finden Sie unter Erstellen von OAuth2-Anwendungen für Workfront-Integrationen
Anweisungen zur Verwendung der Server-Authentifizierung in Workfront finden Sie unter Konfigurieren und Verwenden der benutzerdefinierten OAuth 2-Anwendungen Ihres Unternehmens mithilfe des JWT-Flusses
Anweisungen zur Verwendung der Benutzerauthentifizierung in Workfront finden Sie unter Konfigurieren und Verwenden der benutzerdefinierten OAuth 2-Anwendungen Ihrer Organisation mithilfe des Autorisierungs-Code-Flusses

Um Sicherheitslücken in der API zu minimieren, können Adobe Workfront-Admins die API-Schlüssel verwalten, mit denen Anwendungen für einen Benutzerzugriff auf Workfront ermöglicht werden.

Sie können Ihren aktuellen Administrator-API-Schlüssel zurücksetzen oder entfernen, API-Schlüssel für den Ablauf konfigurieren und die API-Schlüssel für alle Benutzer entfernen.

Beispiele für Programme, die die Workfront-API nutzen:

  • Dokumentenintegrationen wie Dropbox, Google Drive und Workfront DAM
  • Workfront Mobile Apps
IMPORTANT
Beim Zurücksetzen oder Entfernen eines API-Schlüssels muss jede Anwendung, die die Workfront-API nutzt und sich über diesen API-Schlüssel bei Workfront authentifiziert, neu konfiguriert werden, um den Zugriff auf Workfront wiederzuerlangen.

Zugriffsanforderungen

Erweitern, um die Zugriffsanforderungen für die in diesem Artikel beschriebene Funktionalität anzuzeigen.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket Beliebig
Adobe Workfront-Lizenz

Standard

Abo

Konfigurationen der Zugriffsebene Sie müssen ein Workfront-Administrator sein.

Weitere Informationen finden Sie unter Zugriffsanforderungen in der Dokumentation zu Workfront.

Workfront-API-Schlüssel

Jeder Benutzer in Workfront verfügt über einen eindeutigen API-Schlüssel. Dieser Schlüssel wird pro Benutzer generiert, wenn der Benutzer auf eine Integration zugreift, die die Workfront-API nutzt (z. B. die Workfront Mobile App oder eine Dokumentenintegration).

NOTE
API-Schlüssel, die Sie in der Produktionsumgebung generieren, werden während der wöchentlichen Aktualisierung in Ihre Vorschau-Umgebung kopiert. Alle API-Schlüssel, die Sie in der Vorschau-Umgebung generieren, werden während der wöchentlichen Aktualisierung mit Ihren Produktions-API-Schlüsseln überschrieben.

Workfront-Administratoren verfügen außerdem über einen eindeutigen API-Schlüssel. Wenn eine Anwendung einen Administrator-API-Schlüssel für den Zugriff auf Workfront verwendet, hat die Anwendung Administratorzugriff auf Workfront.

Administrator-API-Schlüssel verwalten

Sie können den API-Schlüssel für Ihr Administrator-Benutzerkonto generieren, zurücksetzen oder entfernen.

  1. Klicken Sie auf Hauptmenü-Symbol Hauptmenü in der linken oberen Ecke von Adobe Workfront und klicken Sie dann auf Setup Setup-Symbol .

  2. Klicken Sie auf System > Kundeninformationen.

  3. (Bedingt) Führen Sie eine der folgenden Aktionen aus:

    So generieren Sie einen API-Schlüssel: Klicken Sie Abschnitt API-Schlüsseleinstellungen auf API-Schlüssel generieren.

    ODER
    Zurücksetzen eines API-Schlüssels: Klicken Sie im Abschnitt API Schlüsseleinstellungen“ auf Zurücksetzen und dann auf Zurücksetzen.

    ODER

    So entfernen Sie den API-Schlüssel: Klicken Sie im Abschnitt API Schlüsseleinstellungen auf „Entfernen und dann auf Entfernen.

Konfigurieren, wann API-Schlüssel ablaufen

Sie können API-Schlüssel so konfigurieren, dass sie für alle Benutzer in Ihrem System ablaufen. Wenn der API-Schlüssel einer Benutzerin oder eines Benutzers abläuft, muss sich die Benutzerin bzw. der Benutzer erneut bei allen Anwendungen authentifizieren, die die Workfront-API für den Zugriff auf Workfront verwenden. Sie können die Häufigkeit ändern, mit der die API-Schlüssel ablaufen. Sie können auch konfigurieren, ob API-Schlüssel ablaufen, wenn das Kennwort eines Benutzers abläuft.

  1. Klicken Sie auf Hauptmenü-Symbol Hauptmenü in der linken oberen Ecke von Adobe Workfront und klicken Sie dann auf Setup Setup-Symbol .

  2. Klicken Sie System > Kundeninformationen.

  3. Wählen Sie im Bereich API Schlüsseleinstellungen in der Dropdown-Liste Nach Erstellung API-Schlüssel laufen ab in den Zeitrahmen aus, in dem die API-Schlüssel ablaufen sollen.

    Wenn Sie diese Option ändern, beginnt der neue Zeitrahmen ab dem Zeitpunkt, an dem Sie die Änderung vorgenommen haben. Wenn Sie diese Option beispielsweise von 1 Monat auf 6 Monate ändern, laufen die API-Schlüssel 6 Monate nach der Änderung ab.

    Standardmäßig laufen API-Schlüssel jeden Monat ab.

  4. Um API-Schlüssel so zu konfigurieren, dass sie zum Zeitpunkt des Ablaufs der Benutzerkennwörter ablaufen, aktivieren Sie API-Schlüssel entfernen, wenn das Kennwort eines Benutzers abläuft.

    Standardmäßig ist diese Option nicht aktiviert.

    Informationen zum Konfigurieren von Benutzerkennwörtern für den Ablauf finden Sie unter Konfigurieren von Systemsicherheitseinstellungen.

  5. Klicken Sie auf Speichern.

API-Schlüssel für alle Benutzer entfernen

Wenn Sie wegen einer bestimmten Sicherheitsverletzung in Bezug auf Ihr Workfront-System besorgt sind, können Sie API-Schlüssel gleichzeitig für alle Benutzer entfernen.

IMPORTANT
Das Entfernen von API-Schlüsseln für alle Benutzer macht ALLE API-Schlüssel für alle Benutzer im System ungültig. Diese Aktion führt dazu, dass alle Ihre Integrationen in Workfront fehlschlagen, bis Sie einen neuen API-Schlüssel in Workfront generieren und alle Ihre Integrationen aktualisieren.
  1. Klicken Sie auf Hauptmenü-Symbol Hauptmenü in der linken oberen Ecke von Adobe Workfront und klicken Sie dann auf Setup Setup-Symbol .

  2. Erweitern Sie System und klicken Sie dann auf Kundeninformationen.

  3. Klicken Sie im Bereich API Schlüsseleinstellungen auf Alle API-Schlüssel entfernen und klicken Sie dann auf Entfernen Alle.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43