tocdepth: 2

Быстрый старт

С помощью быстрого старта вы создадите сервисный аккаунт, получите ключи доступа и токен для аутентификации в API Cloud.ru.

Перед началом работы

Зарегистрируйтесь в личном кабинете Cloud.ru.

Если вы уже зарегистрированы, войдите под своей учетной записью.

Создайте сервисный аккаунт

Сервисный аккаунт — это специальная техническая учетная запись, не предполагающая персональной авторизации. Аккаунт аутентифицируется в облаке с помощью сгенерированных ключей доступа, а не логина и пароля, как обычный пользователь.

Чтобы создать сервисный аккаунт:

Перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
В правом верхнем углу нажмите Создать.
Задайте для сервисного аккаунта любое название.
Назначьте роль — «Администратор проекта», чтобы у аккаунта был доступ на все действия внутри проекта.
Нажмите Создать.

Сервисный аккаунт появится в списке в статусе «Активен».

Получите ключ доступа

Перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
Нажмите на созданный ранее сервисный аккаунт.
В правом верхнем углу вкладки Ключи доступа нажмите Создать.
Введите краткое описание ключа.
Задайте время жизни ключа — 30 дней. После этого срока ключ перестанет быть активным.
Нажмите Создать.

После этого будут сгенерированы Key ID (логин) и Key Secret (пароль). Сохраните Key Secret.

Получите токен для аутентификации

Получите токен с помощью curl-запроса:

curl -i --data-urlencode "grant_type=access_key" --data-urlencode "client_id=$KEY_ID" --data-urlencode "client_secret=$SECRET" "https://auth.iam.sbercloud.ru/auth/system/openid/token"

curl -i --data-urlencode 'grant_type=access_key' --data-urlencode "client_id=$KEY_ID" --data-urlencode "client_secret=$SECRET" "https://auth.iam.sbercloud.ru/auth/system/openid/token"

Где:

KEY_ID — Key ID (логин).
SECRET — Key Secret (пароль).

Что дальше

Полученный токен используйте при каждом запросе к сервису, передавая его в заголовке Authorization в следующем формате:

Authorization: Bearer $TOKEN

Точные эндпоинты и параметры запроса будут указаны в инструкции к каждому сервису. Примеры доступных API:

Была ли статья полезной?