Skip to content

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

Токены -- это учетные данные аутентификации, которые CLI-клиенты используют для подключения к серверу. Каждый токен привязан к пользователю и, опционально, к устройству.

Команды CLI

bash
# Сгенерировать токен для пользователя с ID 1
unns token gen 1

# Сгенерировать с именем устройства
unns token gen 1 macbook-pro

# Показать все токены
unns token list

# Показать токены конкретного пользователя
unns token list 1

# Отозвать токен
unns token revoke 3

Свойства токена

ПолеОписание
hashSHA-256 хеш (хранится, никогда в открытом виде)
user_idПользователь-владелец
device_nameНеобязательный идентификатор устройства
enabledАктивен или отозван
created_atВременная метка создания
last_usedПоследняя успешная аутентификация

Как работают токены

  1. Администратор генерирует токен -> необработанный токен показывается один раз
  2. Токен передается пользователю
  3. Пользователь запускает unne setup и вводит токен
  4. CLI отправляет токен во время рукопожатия
  5. Сервер хеширует его и ищет хеш в базе данных
  6. Токен наследует все лимиты от родительского пользователя

Токен = Устройство

Когда для пользователя установлен max_devices, каждый токен считается одним устройством. Если у пользователя max_devices=2, он может иметь не более 2 активных токенов, подключенных одновременно.

Безопасность

  • Токены хранятся только в виде SHA-256 хешей
  • Необработанный токен отображается один раз при генерации и никогда не сохраняется
  • Отзыв токена немедленно отключает клиента
  • Токенами можно управлять через CLI или Панель администратора

Released under the MIT License.