API-токены
Обзор
В этом разделе можно создавать API-токены и управлять ими.
API-токены используются для аутентификации в API Zabbix.
Каждый API-токен назначается одному пользователю и наследует разрешения этого пользователя.
Запросы, аутентифицированные с помощью API-токена, авторизуются в соответствии с ролью и разрешениями связанного пользователя.
Вы можете фильтровать API-токены по имени, пользователям, которым назначены токены, сроку действия, пользователям, создавшим токены, или статусу (включен/отключен). Нажмите на статус токена в списке, чтобы быстро включить или отключить токен. Также можно массово включить или отключить токены, выбрав их в списке и нажав кнопки Включить/Отключить под списком.
Чтобы создать новый токен, нажмите кнопку Создать API-токен в правом верхнем углу, затем заполните обязательные поля на экране настройки токена:
| Параметр | Описание |
|---|---|
| Имя | Отображаемое имя токена. |
| Пользователь | Пользователь, которому должен быть назначен токен. Чтобы быстро выбрать пользователя, начните вводить имя пользователя, имя или фамилию, затем выберите нужного пользователя из списка автодополнения. Также можно нажать кнопку Выбрать и выбрать пользователя из полного списка пользователей. Токен можно назначить только одному пользователю. |
| Описание | Необязательное описание токена. |
| Установить дату и время окончания действия | Снимите этот флажок, если у токена не должно быть срока действия. |
| Дата окончания действия | Нажмите значок календаря, чтобы выбрать дату окончания действия токена, или введите дату вручную в формате YYYY-MM-DD hh:mm:ss |
| Включен | Снимите этот флажок, если необходимо создать токен в отключенном состоянии. |
Нажмите Добавить, чтобы создать токен.
Скопируйте значение Токена аутентификации и сохраните его в безопасном месте до закрытия страницы, затем нажмите Закрыть. Токен появится в списке.
Значение Токена аутентификации нельзя просмотреть повторно. Оно доступно только сразу после создания токена. Если вы потеряете сохраненный токен, его придется сгенерировать заново, при этом будет создана новая строка авторизации.
Нажмите имя токена, чтобы изменить имя, описание, настройки срока действия или статус токена. Обратите внимание, что изменить пользователя, которому назначен токен, невозможно. Нажмите кнопку Обновить, чтобы сохранить изменения. Если токен был утерян или раскрыт, можно нажать кнопку Перегенерировать, чтобы создать новое значение токена. Появится диалоговое окно подтверждения с предложением подтвердить операцию, поскольку после ее выполнения ранее сгенерированный токен станет недействительным.
Пользователи без доступа к разделу меню Администрирование могут просматривать и изменять сведения о назначенных им токенах только в разделе Профиль пользователя > API-токены раздел, если в разрешениях их роли пользователя разрешено Управление API-токенами.