4 Tokeny API
Przegląd
Ta sekcja umożliwia tworzenie tokenów API i zarządzanie nimi.
Tokeny API służą do uwierzytelniania w API Zabbix.
Każdy token API jest przypisany do jednego użytkownika i dziedziczy uprawnienia tego użytkownika.
Żądania uwierzytelnione za pomocą tokenu API są autoryzowane zgodnie z rolą i uprawnieniami powiązanego użytkownika.
Tokeny API można filtrować według nazwy, użytkowników, do których są przypisane, daty wygaśnięcia, użytkowników, którzy utworzyli tokeny, lub statusu (włączony/wyłączony). Kliknij status tokenu na liście, aby szybko go włączyć/wyłączyć. Można również zbiorczo włączyć/wyłączyć tokeny, zaznaczając je na liście, a następnie klikając przyciski Enable/Disable poniżej listy.
Aby utworzyć nowy token, kliknij przycisk Create API token w prawym górnym rogu, a następnie wypełnij wymagane pola na ekranie konfiguracji tokenu:
| Parameter | Description |
|---|---|
| Name | Widoczna nazwa tokenu. |
| User | Użytkownik, do którego token powinien zostać przypisany. Aby szybko wybrać użytkownika, zacznij wpisywać jego nazwę użytkownika, imię lub nazwisko, a następnie wybierz wymaganego użytkownika z listy autouzupełniania. Możesz również kliknąć przycisk Select i wybrać użytkownika z pełnej listy użytkowników. Token można przypisać tylko do jednego użytkownika. |
| Description | Opcjonalny opis tokenu. |
| Set expiration date and time | Usuń zaznaczenie tego pola wyboru, jeśli token nie powinien mieć daty wygaśnięcia. |
| Expiry date | Kliknij ikonę kalendarza, aby wybrać datę wygaśnięcia tokenu, lub wprowadź datę ręcznie w formacie YYYY-MM-DD hh:mm:ss |
| Enabled | Usuń zaznaczenie tego pola wyboru, jeśli token ma zostać utworzony w stanie wyłączonym. |
Kliknij Add, aby utworzyć token.
Skopiuj wartość Auth token i zapisz ją w bezpiecznym miejscu przed zamknięciem strony, a następnie kliknij Close. Token pojawi się na liście.
Wartości Auth token nie można wyświetlić ponownie. Jest dostępna tylko bezpośrednio po utworzeniu tokenu. Jeśli utracisz zapisany token, musisz go wygenerować ponownie, co spowoduje utworzenie nowego ciągu autoryzacyjnego.
Kliknij nazwę tokenu, aby edytować jego nazwę, opis, ustawienia daty wygaśnięcia lub status tokenu. Pamiętaj, że nie można zmienić użytkownika, do którego token jest przypisany. Kliknij przycisk Update, aby zapisać zmiany. Jeśli token został utracony lub ujawniony, możesz kliknąć przycisk Regenerate, aby wygenerować nową wartość tokenu. Zostanie wyświetlone okno dialogowe z potwierdzeniem, w którym należy potwierdzić tę operację, ponieważ po jej wykonaniu wcześniej wygenerowany token stanie się nieważny.
Użytkownicy bez dostępu do sekcji menu Administration mogą wyświetlać i modyfikować szczegóły tokenów przypisanych do nich w sekcji User profile → API tokens section tylko wtedy, gdy w ich uprawnieniach roli użytkownika zezwolono na Manage API tokens.