Персональные токены доступа (PAT)

Персональные токены доступа (PAT) — это долгоживущие токены, которые используются для аутентификации в CLI и API системы 5А. PAT работают наравне с JWT-токенами: если запрос приходит с Bearer-токеном, начинающимся с префикса pat_, система определяет владельца токена и применяет его права доступа.

ℹ️

PAT имеют те же права доступа, что и пользователь-владелец. Ограничений по scope или ролям для токенов не предусмотрено.

Управление токенами

Управление персональными токенами выполняется в разделе Глобальные настройки → Токены доступа.

Общий вид раздела "Токены доступа"

В таблице отображаются все токены, созданные текущим пользователем:

Имя — название токена, заданное при создании.
Создан — дата и время создания токена.
Истекает — дата истечения срока действия токена. Для бессрочных токенов отображается «Бессрочно».
Последнее использование — дата и время последнего успешного использования токена. Если токен ещё не использовался, отображается «Никогда».

ℹ️

Секретное значение токена (строка, начинающаяся с pat_) не хранится в системе и не отображается в таблице. Оно показывается только один раз при создании.

Пользователю доступны следующие действия:

Создать токен — создание нового персонального токена.
Отозвать токен — отзыв выбранного токена (доступен в строке таблицы).

Создание токена

Для создания нового персонального токена выполните следующие шаги:

Откройте раздел Глобальные настройки → Персональные токены доступа.
Нажмите Создать токен.
Заполните форму создания токена.
- Имя — название токена (например, cli-workstation). Используется для идентификации токена в списке.
- Срок действия — выберите один из вариантов:
  - 30 дней
  - 90 дней
  - 1 год
  - Бессрочно — токен не имеет ограничения по времени действия.
Нажмите Создать.

После успешного создания система отображает секретное значение токена в специальном поле. Токен имеет формат pat_....

⚠️

Важно: секретное значение токена показывается только один раз при создании. Скопируйте и сохраните его в надёжном месте. Восстановить утерянный токен невозможно — потребуется создать новый.

Для копирования токена нажмите кнопку Скопировать. После закрытия окна секретное значение будет недоступно.

Отзыв токена

Отозванный токен немедленно перестаёт работать. Все последующие запросы с этим токеном будут отклонены системой.

Для отзыва токена выполните следующие шаги:

Откройте раздел Глобальные настройки → Персональные токены доступа.
Найдите в таблице токен, который требуется отозвать, и нажмите Отозвать в строке с ним.
Подтвердите отзыв в модальном окне.

После успешного отзыва токен исчезает из таблицы.

ℹ️

Отозвать можно только собственные токены. Администратор не может отозвать токен другого пользователя через интерфейс.

Связанные разделы:

Интерфейс командной строки (CLI) — описание использования PAT в CLI.
API системы — описание использования PAT в API-запросах.
Создание пользователя — информация о создании учётных записей.

Настройка входа через LDAP Обзор сценариев по настройке ролевых моделей