- 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:
для Dev & Test