Auf dieser Seite

API-Tokens

Übersicht

In diesem Abschnitt können Sie API-Token erstellen und verwalten.
API-Token werden zur Authentifizierung in der Zabbix-API verwendet.
Jeder API-Token ist einem einzelnen Benutzer zugewiesen und übernimmt die Berechtigungen dieses Benutzers. Mit einem API-Token authentifizierte Anfragen werden entsprechend der Rolle und den Berechtigungen des zugehörigen Benutzers autorisiert.

Sie können API-Token nach Name, Benutzern, denen die Token zugewiesen sind, Ablaufdatum, Benutzern, die Token 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 Token auch gesammelt aktivieren/deaktivieren, indem Sie sie in der Liste auswählen und anschließend auf die Schaltflächen Enable/Disable unterhalb der Liste klicken.

Um einen neuen Token zu erstellen, klicken Sie oben rechts auf die Schaltfläche Create API token und füllen Sie anschließend die erforderlichen Felder im Konfigurationsbildschirm des Tokens aus:

Parameter Beschreibung
Name Sichtbarer Name des Tokens.
User Benutzer, dem der Token zugewiesen werden soll. Um schnell einen Benutzer auszuwählen, beginnen Sie mit der Eingabe des Benutzernamens sowie des Vor- oder Nachnamens und wählen Sie anschließend den gewünschten Benutzer aus der Autovervollständigungsliste aus. Alternativ können Sie auf die Schaltfläche Select klicken und einen Benutzer aus der vollständigen Benutzerliste auswählen. Ein Token kann nur einem Benutzer zugewiesen werden.
Description Optionale Beschreibung des Tokens.
Set expiration date and time Deaktivieren Sie dieses Kontrollkästchen, wenn der 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 den Token im deaktivierten Zustand erstellen möchten.

Klicken Sie auf Add, um einen Token zu erstellen.

Kopieren Sie den Wert Auth token und speichern Sie ihn vor dem Schließen der Seite an einem sicheren Ort. Klicken Sie anschließend auf Close. Der Token wird in der Liste angezeigt.

Der Wert Auth token kann später nicht erneut angezeigt werden. Er ist nur unmittelbar nach der Erstellung 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 Namen des Tokens, um den Namen, die Beschreibung, die Einstellungen für das Ablaufdatum oder den Token-Status zu bearbeiten. Beachten Sie, dass nicht geändert werden kann, welchem Benutzer der Token zugewiesen ist. Klicken Sie auf die Schaltfläche Update, um die Änderungen zu speichern. Wenn ein Token verloren gegangen ist oder offengelegt wurde, können Sie auf die Schaltfläche Regenerate klicken, um einen neuen Token-Wert zu generieren. Ein Bestätigungsdialog wird angezeigt, in dem Sie diesen Vorgang bestätigen müssen, da der zuvor generierte Token nach der Fortsetzung ungültig wird.

Benutzer ohne Zugriff auf den Menüabschnitt Administration können Details der ihnen zugewiesenen Token nur unter User profile > API tokens Abschnitt anzeigen und ändern, wenn Manage API tokens in den Berechtigungen ihrer Benutzerrolle erlaubt ist.