Перейти к основному содержимому
API docs by Redocly

Авторизация

Для работы с API продуктов Selectel используются:

  • IAM-токены:

  • статические токены:

    • X-Token — для управления ресурсами, привязанными к аккаунту.

Используемый токен зависит от продукта.

Адрес (URL) для обращения в запросах можно посмотреть в списке URL.

Вы можете ограничить доступ к API по адресам, которые включают в себя https://api.selectel.ru.

X-Auth-Token (scope: account)

X-Auth-Token (scope: account) можно выписать только сервисному пользователю.

X-Auth-Token (scope: account) — IAM-токен, который дает доступ к управлению большинством продуктов Selectel и объектами OpenStack API наравне с логином и паролем в панели управления my.selectel.ru. Позволяет управлять ресурсами аккаунта.

Токен передается в заголовке X-Auth-Token в каждом запросе. Время жизни токена — 24 часа.

Токен позволяет управлять:

Получить X-Auth-Token (scope: account)

Выписывать X-Auth-Token (scope: account) можно сервисным пользователям с ролями:

  • Администратор аккаунта;
  • Администратор биллинга;
  • Администратор пользователей;
  • Наблюдатель аккаунта.

Если вы используете Windows, в запросах замените одинарные кавычки ('') на двойные (""). Мы также рекомендуем использовать для запросов PowerShell и не использовать CMD.

  1. Выполните запрос:

    curl -i -XPOST \
-H 'Content-Type: application/json' \
-d '{"auth":{"identity":{"methods":["password"],"password":{"user":{"name":"<username>","domain":{"name":"<account_id>"},"password":"<password>"}}},"scope":{"domain":{"name":"<account_id>"}}}}' \
'https://cloud.api.selcloud.ru/identity/v3/auth/tokens'

    Укажите:

    • <username> — имя сервисного пользователя. Посмотреть имя можно в панели управления: в верхнем меню нажмите Аккаунт и перейдите в раздел Пользователи → вкладка Сервисные пользователи (раздел доступен только Владельцу аккаунта и Администратору пользователей);
    • <account_id> — номер аккаунта панели управления. Можно посмотреть в панели управления в правом верхнем углу;
    • <password> — пароль сервисного пользователя, можно посмотреть при создании пользователя или изменить на новый.

При успешной авторизации вернется ответ с кодом 201 Created в формате:

HTTP/2 201
X-Subject-Token: token
  1. В заголовке X-Subject-Token посмотрите токен.

X-Auth-Token (scope: project)

X-Auth-Token (scope: project) можно выписать только сервисному пользователю.

X-Auth-Token (scope: project) — IAM-токен, который дает доступ к управлению большинством продуктов Selectel и объектами OpenStack API наравне с логином и паролем в панели управления my.selectel.ru. Позволяет управлять ресурсами проекта.

Токен передается в заголовке X-Auth-Token в каждом запросе. Время жизни токена — 24 часа.

Токен позволяет управлять:

Получить X-Auth-Token (scope: project)

Выписывать X-Auth-Token (scope: project) можно сервисным пользователям с ролями:

  • Администратор аккаунта;
  • Администратор биллинга;
  • Администратор пользователей;
  • Наблюдатель аккаунта;
  • Администратор проекта;
  • Администратор объектного хранилища;
  • Наблюдатель проекта.

Если вы используете Windows, в запросах замените одинарные кавычки ('') на двойные (""). Мы также рекомендуем использовать для запросов PowerShell и не использовать CMD.

  1. Выполните запрос:

    curl -i -XPOST \
-H 'Content-Type: application/json' \
-d '{"auth":{"identity":{"methods":["password"],"password":{"user":{"name":"<username>","domain":{"name":"<account_id>"},"password":"<password>"}}},"scope":{"project":{"name":"<project_name>","domain":{"name":"<account_id>"}}}}}' \
'https://cloud.api.selcloud.ru/identity/v3/auth/tokens'

    Укажите:

    • <username> — имя сервисного пользователя. Посмотреть имя можно в панели управления: в верхнем меню нажмите Аккаунт и перейдите в раздел Пользователи → вкладка Сервисные пользователи (раздел доступен только Владельцу аккаунта и Администратору пользователей);
    • <account_id> — номер аккаунта панели управления. Можно посмотреть в панели управления в правом верхнем углу;
    • <password> — пароль сервисного пользователя, можно посмотреть при создании пользователя или изменить на новый;
    • <project_name> — имя проекта.

При успешной авторизации вернется ответ с кодом 201 Created в формате:

HTTP/2 201
X-Subject-Token: token
  1. В заголовке X-Subject-Token посмотрите токен.

X-Token

X-Token можно выписать только пользователю панели управления.

X-Token — статический токен, который дает полный доступ к управлению всеми продуктами Selectel, кроме объектов OpenStack API, наравне с логином и паролем в панели управления my.selectel.ru.

Токен передается в запросе в заголовке X-Token. Время жизни токена не ограничено.

Для API, которые не поддерживают X-Auth-Token (scope: account) и X-Auth-Token (scope: project), X-Token является единственным:

Получить X-Token

  1. В панели управления в верхнем меню нажмите Аккаунт.
  2. Перейдите в раздел Ключи API.
  3. Нажмите Добавить ключ.
  4. Введите название ключа.
  5. Нажмите Добавить.

Поддержка токенов в API

API X-Auth-Token (scope: account) X-Auth-Token (scope: project) X-Token
IAM ✓ ✗ ✗
Федерации ✓ ✗ ✗
Баланс ✓ ✗ ✓
Статистика ✓ ✗ ✓
Выделенные серверы ✓ ✓ ✗
Проекты и ресурсы облачной платформы ✓ ✓ ✗
Ресурсы облачной платформы в проекте ✗ ✓ ✗
Квоты и лимиты проекта ✓ ✓ ✗
Облачные базы данных ✗ ✓ ✗
Managed Kubernetes ✗ ✓ ✗
Container Registry ✗ ✓ ✗
Секреты ✗ ✓ ✗
Сертификаты ✗ ✓ ✗
Сертификаты Let’s Encrypt® ✗ ✓ ✗
Swift ✗ ✓ ✗
Selectel Storage ✗ ✓ ✗
CDN ✓ ✗ ✓
DNS-хостинг (actual) ✗ ✓ ✗
DNS-хостинг (legacy) ✓ ✗ ✓
Почтовый сервис Selectel ✗ ✓ ✗
Сервис учета IP-адресов ✗ ✗ ✓
Тикеты ✗ ✗ ✓
Вложения ✗ ✗ ✓