microsrv:~$
RUEN
Консоль

Токены доступа (PAT)

Создание и управление персональными токенами доступа (PAT) для работы с OpenTofu, Terraform, REST API и CI/CD.

Что такое токены доступа (PAT)

Персональные токены доступа (Personal Access Tokens, PAT) — это секретные ключи аутентификации, предназначенные для программного взаимодействия с платформой microsrv.

Токены используются для:

  • Автоматизации инфраструктуры через OpenTofu и Terraform (официальный провайдер microsrv-cloud/microsrv).
  • Интеграции в пайплайны непрерывного развёртывания (CI/CD: GitHub Actions, GitLab CI, Woodpecker CI).
  • Вызова методов REST API и работы через консольную утилиту microsrvctl.

Все токены начинаются с префикса sel_ и действуют от имени вашей учётной записи с правами доступа к текущим и создаваемым проектам.

Пошаговое получение токена в консоли

Шаг 1. Переход в раздел токенов

  1. Войдите в Консоль управления microsrv.
  2. В боковом меню в блоке Доступ выберите пункт Токены доступа (или перейдите по прямому адресу /access-tokens).

Шаг 2. Создание нового токена

  1. На странице списка токенов нажмите кнопку Создать токен (вверху справа или по ссылке /access-tokens/create).
  2. Заполните параметры токена:
    • Название токена: укажите понятное назначение (например, opentofu-production, github-actions-deploy или laptop-dev). Название видно в списке токенов и помогает отслеживать, где используется ключ.
    • Срок действия (дней): укажите количество дней до автоматического отзыва:
      • 0 — бессрочный токен (без ограничения срока действия).
      • От 1 до 3650 дней — токен с автоматическим истечением срока. Для автоматизированных CI/CD контуров рекомендуется задавать регулярную ротацию (например, 90 или 180 дней).
  3. Нажмите кнопку Создать токен.

Шаг 3. Сохранение значения токена

После создания откроется окно с сгенерированным секретным значением:

[!WARNING] Значение токена показывается только один раз в момент создания! После закрытия страницы просмотреть его повторно невозможно.

  1. Нажмите кнопку Копировать токен.
  2. Сохраните токен в надёжном менеджере паролей, переменных окружения CI/CD или защищённом хранилище секретов.
  3. Нажмите Готово для возврата к общему списку токенов.

Использование токена

В переменных окружения для OpenTofu / Terraform

Для работы с провайдером OpenTofu задайте переменную окружения MICROSRV_TOKEN в терминале или в секретах вашей CI-системы:

export MICROSRV_TOKEN="sel_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Провайдер microsrv автоматически прочитает эту переменную при вызове команд tofu plan и tofu apply.

В конфигурационном файле провайдера

Токен также можно передать явно через аргумент блока provider "microsrv":

provider "microsrv" {
  endpoint = "https://api.microsrv.ru"
  token    = var.microsrv_token
}

[!IMPORTANT] Никогда не коммитьте открытые токены в систему контроля версий Git. Используйте переменные окружения (MICROSRV_TOKEN) или зашифрованные файлы секретов terraform.tfvars.

В HTTP-запросах к REST API

Для прямых вызовов REST API передавайте токен в заголовке Authorization:

curl -H "Authorization: Bearer sel_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     https://api.microsrv.ru/api/v1/projects

Отзыв и ротация токенов

Если токен был скомпрометирован или более не используется:

  1. Откройте страницу Токены доступа.
  2. Найдите нужный токен по его названию, дате создания или префиксу.
  3. Нажмите кнопку Отозвать и подтвердите действие.
  4. Доступ по отозванному токену блокируется немедленно.

Следующие шаги

← НазадСетевые интерфейсы и IP-адресаДалее →Управление виртуальной машиной и графики ресурсов