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.
Anfragen, die mit einem API-Token authentifiziert wurden, 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 bzw. zu deaktivieren. Sie können Token auch gesammelt aktivieren bzw. 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 anschließend die erforderlichen Felder im Konfigurationsbildschirm des Tokens aus:
| Parameter | Beschreibung |
|---|---|
| Name | Der sichtbare Name des Tokens. |
| Benutzer | Der Benutzer, dem der Token zugewiesen werden soll. Um schnell einen Benutzer auszuwählen, beginnen Sie mit der Eingabe des Benutzernamens, 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 Auswählen klicken und einen Benutzer aus der vollständigen Benutzerliste auswählen. Ein Token kann nur einem Benutzer zugewiesen werden. |
| Beschreibung | Optionale Beschreibung des Tokens. |
| Ablaufdatum und -zeit festlegen | Deaktivieren Sie dieses Kontrollkästchen, wenn der Token kein Ablaufdatum haben soll. |
| Ablaufdatum | 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. |
| Aktiviert | Deaktivieren Sie dieses Kontrollkästchen, wenn Sie den Token in einem 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 anschließend 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 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 Aktualisieren, um die Änderungen zu speichern. Wenn ein Token verloren gegangen ist oder offengelegt wurde, können Sie auf die Schaltfläche Neu generieren klicken, um einen neuen Token-Wert zu erzeugen. Ein Bestätigungsdialog wird angezeigt, in dem Sie aufgefordert werden, diesen Vorgang zu bestätigen, 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 im Abschnitt Benutzerprofil > API-Token Abschnitt nur anzeigen und ändern, wenn in den Berechtigungen ihrer Benutzerrolle die Option API-Token verwalten erlaubt ist.