4 API-Tokens
Übersicht
In diesem Abschnitt können API-Tokens erstellt und verwaltet werden.
API-Tokens werden für die Authentifizierung in der Zabbix API verwendet.
Sie können API-Tokens nach Name, den Benutzern, denen die Tokens zugewiesen sind, Ablaufdatum, den Benutzern, die Tokens erstellt haben, oder nach 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 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 dann die erforderlichen Felder im Konfigurationsbildschirm für Tokens aus:
| Parameter | Beschreibung |
|---|---|
| Name | Anzeigename des Tokens. |
| User | 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 dann 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 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 Add, 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 Close. 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; dabei wird eine neue Autorisierungszeichenfolge erstellt.
Klicken Sie auf den Token-Namen, 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, zu ändern, welchem Benutzer der Token zugewiesen ist. Klicken Sie auf die Schaltfläche Update, um die Änderungen zu speichern. Wenn ein Token verloren gegangen oder offengelegt wurde, können Sie auf die Schaltfläche Regenerate klicken, um einen neuen Token-Wert zu erzeugen. Es wird ein Bestätigungsdialog angezeigt, in dem Sie diese Aktion bestätigen müssen, da der zuvor erzeugte Token nach dem Fortfahren ungültig wird.
Benutzer ohne Zugriff auf den Menüabschnitt Administration können Details von Tokens, die ihnen zugewiesen sind, nur im Abschnitt User profile > API tokens sehen und ändern, wenn Manage API tokens in den Berechtigungen ihrer Benutzerrolle erlaubt ist.