superset token#

Управление токенами доступа к REST API модуля аналитики

Зачем нужна#

Команда выпускает, показывает и отзывает токены для машинного доступа к REST API модуля аналитики: внешняя система передаёт токен в заголовке Authorization: Bearer [TOKEN] и работает с API без входа через веб-интерфейс. Типичный сценарий — передача внешних справочников в модуль аналитики

Токены привязываются к учётной записи модуля аналитики и наследуют её роль. Пользователь должен уже существовать в модуле: учётные записи создаются автоматически при первом входе через SSO или вручную (см. ниже) — если пользователя нет, команда откажет. Роль берётся как у пользователя: суперпользователь RuDesktop имеет Admin, обычные пользователи — Public (токен такого пользователя не сможет загружать файлы; команда предупредит об этом)

Для технической учётной записи, которая нужна только под токен, пользователя можно создать прямо в модуле аналитики — без учётной записи на сервере RuDesktop и без входа по SSO. В интерфейсе: откройте https://[SERVER_ADDR]/analytics/users/add и создайте пользователя с ролью Admin

Или через CLI:

rude superset fab create-user --role Admin --username analytics_uploader \
    --firstname analytics_uploader --lastname "" \
    --email analytics_uploader@local --password [произвольный_пароль]

Пароль нужен только при создании: вход в веб-интерфейс модуля всегда идёт через SSO, пароль нигде не используется

Предупреждение

Под технической учётной записью не выполняйте вход по SSO: при входе роль пересинхронизируется с сервера RuDesktop, и если эта учётная запись там не суперпользователь — роль Admin сменится на Public

Важно

Значение токена выводится один раз при создании — посмотреть его повторно нельзя. При утере отзовите токен и выпустите новый

Типичные случаи применения:

  • выпуск токена для внешней системы, загружающей справочники через REST API

  • отзыв скомпрометированного или более не нужного токена

  • проверка, какими токенами и когда пользовались (list показывает uuid и статус)

Синтаксис#

rude superset token create [имя_пользователя] [--days N] [--name ИМЯ]
rude superset token list [<имя_пользователя|id>]
rude superset token revoke [токен | uuid] [--purge]
rude superset token prune

Подкоманды#

create [имя_пользователя] [--days N] [--name ИМЯ]

Выпустить токен для существующего пользователя модуля аналитики (по имени или идентификатору). Без --days токен бессрочный — действует до отзыва; --days N ограничивает срок действия N днями с момента выпуска. --name задаёт отображаемое имя ключа — удобно при нескольких ключах, чтобы в list было видно, какой ключ какой интеграции принадлежит; без --name ключ создаётся без имени (в списке отображается прочерк). Печатает значение токена один раз

list [<имя_пользователя|id>]

Показать токены всех пользователей или только указанного: дату создания, пользователя, имя ключа, uuid, статус (активен / отозван/истёк) и срок действия, если задан. Значение токена не показывается — оно хранится только в виде хэша

revoke [токен | uuid] [--purge]

Отозвать токен по его значению либо по uuid из list. Отзыв применяется сразу. Без --purge отозванный токен остаётся в списке со статусом отозван/истёк (история); --purge дополнительно удаляет запись о нём из списка

prune

Удалить из списка разом все отозванные и истёкшие токены; активные не затрагиваются

Пример#

Выпуск токена для служебной учётной записи:

rude superset token create analytics_uploader

После выполнения команды в выводе отобразится следующее:

sst_1YdKk2mS9QpZ8xN3vL5rA7wTbGhJ4cE6fU2iO0dPqR

Токен на ограниченный срок (30 дней):

rude superset token create analytics_uploader --days 30

После выполнения команды в выводе отобразится следующее:

sst_1YdKk2mS9QpZ8xN3vL5rA7wTbGhJ4cE6fU2iO0dPqR
Действует до: 05.12.2026 14:10

Список токенов и отзыв:

rude superset token list
rude superset token revoke sst_1YdKk2mS9QpZ8xN3vL5rA7wTbGhJ4cE6fU2iO0dPqR