Перейти к основному содержимому

Аутентификация запросов

В зависимости от продукта или его ресурса для работы с API продуктов Servercore и аутентификации запросов вместо логина и пароля используются:

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

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

IAM-токен для аккаунта (X-Auth-Token)⁠

к сведению

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

Токен передается в заголовке X-Auth-Token.

IAM-токен для аккаунта (iam_token_account_scoped) дает доступ к управлению большинством продуктов Servercore и объектами OpenStack API наравне с логином и паролем в панели управления my.servercore.com. Позволяет управлять ресурсами аккаунта.

Время жизни токена — 24 часа.

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

Получить IAM-токен для аккаунта⁠

Выписывать IAM-токен для аккаунта можно сервисным пользователям с ролями:

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

Если вы используете 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.servercore.ru/identity/v3/auth/tokens'

Укажите:

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

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

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

IAM-токен для проекта (X-Auth-Token)⁠

к сведению

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

Токен передается в заголовке X-Auth-Token.

IAM-токен для проекта (iam_token_project_scoped) дает доступ к управлению большинством продуктов Servercore и объектами OpenStack API наравне с логином и паролем в панели управления my.servercore.com. Позволяет управлять ресурсами проекта.

Время жизни токена — 24 часа.

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

Получить IAM-токен для проекта⁠

Выписывать IAM-токен для проекта можно сервисным пользователям с ролями:

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

Если вы используете 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.servercore.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.

Статический токен (static_token) дает полный доступ к управлению всеми продуктами Servercore, кроме объектов OpenStack API, наравне с логином и паролем в панели управления my.servercore.com.

Время жизни токена не ограничено.`

Для API, которые не поддерживают IAM-токен для аккаунта и IAM-токен для проекта, X-Token является единственным:

Получить статический токен⁠

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

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

APIIAM-токен для аккаунтаIAM-токен для проектаСтатический токен
IAM✓✗✗
Федерации✓✗✗
Выделенные серверы✓✓✗
Проекты и ресурсы облачной платформы✓✓✗
Ресурсы облачной платформы в проекте✗✓✗
Квоты и лимиты проекта✓✓✗
Облачные базы данных✗✓✗
Managed Kubernetes✗✓✗
Секреты✗✓✗
Сертификаты✗✓✗
Swift✗✓✗
DNS-хостинг✗✓✗
Сервис учета IP-адресов✗✗✓
Тикеты✗✗✓
Вложения✗✗✓