On this page

4 API-Tokens

Übersicht

In diesem Abschnitt können API-Tokens erstellt und verwaltet werden.

Sie können API-Tokens nach Name, Benutzern, denen die Tokens zugewiesen sind, Ablaufdatum, Benutzern, die Tokens erstellt haben, oder Status (aktiviert/deaktiviert) filtern. Klicken Sie in der Liste auf den Token-Status, um einen Token schnell zu aktivieren/deaktivieren. Sie können Tokens auch gesammelt aktivieren/deaktivieren, indem Sie sie in der Liste auswählen und anschließend auf die Schaltflächen Aktivieren/Deaktivieren unterhalb der Liste klicken.

Um einen neuen Token zu erstellen, klicken Sie oben rechts auf die Schaltfläche API-Token erstellen und füllen Sie dann die erforderlichen Felder im Konfigurationsbildschirm für Tokens aus:

Parameter Beschreibung
Name Angezeigter Name des Tokens.
User Benutzer, dem der Token zugewiesen werden soll. Um schnell einen Benutzer auszuwählen, beginnen Sie mit der Eingabe des Benutzernamens, Vor- oder Nachnamens und wählen Sie dann den gewünschten Benutzer aus der Autovervollständigungsliste aus. Alternativ können Sie auf die Schaltfläche Auswählen klicken und einen Benutzer aus der vollständigen Benutzerliste auswählen. Ein Token kann nur einem Benutzer zugewiesen werden.
Description Optionale Token-Beschreibung.
Set expiration date and time Deaktivieren Sie dieses Kontrollkästchen, wenn ein Token kein Ablaufdatum haben soll.
Expiry date Klicken Sie auf das Kalendersymbol, um das Ablaufdatum des Tokens auszuwählen, oder geben Sie das Datum manuell im Format YYYY-MM-DD hh:mm:ss ein
Enabled Deaktivieren Sie dieses Kontrollkästchen, wenn Sie einen Token im deaktivierten Zustand erstellen möchten.

Klicken Sie auf Hinzufügen, um einen Token zu erstellen.

Kopieren Sie den Wert Auth token und speichern Sie ihn an einem sicheren Ort bevor Sie die Seite schließen, und klicken Sie dann auf Schließen. Der Token wird in der Liste angezeigt.

Der Wert Auth token kann später nicht erneut angezeigt werden. Er ist nur unmittelbar nach dem Erstellen eines Tokens verfügbar. Wenn Sie einen gespeicherten Token verlieren, müssen Sie ihn neu generieren; dadurch wird eine neue Autorisierungszeichenfolge erstellt.

Klicken Sie auf den Tokennamen, um den Namen, die Beschreibung, die Einstellungen für das Ablaufdatum oder den Token-Status zu bearbeiten. Beachten Sie, dass es nicht möglich ist, den Benutzer zu ändern, dem der Token zugewiesen ist. Klicken Sie auf die Schaltfläche Aktualisieren, um die Änderungen zu speichern. Wenn ein Token verloren gegangen oder offengelegt wurde, können Sie auf die Schaltfläche Neu generieren klicken, um einen neuen Token-Wert zu erzeugen. Es wird ein Bestätigungsdialog angezeigt, in dem Sie aufgefordert werden, diesen Vorgang zu bestätigen, da der zuvor generierte Token nach dem Fortfahren ungültig wird.

Benutzer ohne Zugriff auf den Menüabschnitt Administration können Details zu den ihnen zugewiesenen Tokens nur im Abschnitt Benutzerprofil → API-Tokens section anzeigen und ändern, wenn in ihren Benutzerrollen die Berechtigung API-Tokens verwalten erlaubt ist.