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