Быстрый старт
С помощью быстрого старта вы создадите секрет, а затем получите его содержимое через API-запрос.
Перед началом работы
Зарегистрируйтесь в личном кабинете Cloud.ru.
Если вы уже зарегистрированы, войдите под своей учетной записью.
Подключите Secret Manager. Для этого в меню
личного кабинета выберите Управление → Secret Manager и нажмите Подключить.
Создайте секрет
В личном кабинете на странице Secret Manager нажмите Добавить секрет.
Введите название ключа — cloudru-example-secret.
Введите описание — Сообщение Бобу от Алисы.
В поле Значение секрета выберите JSON-редактор и скопируйте в следующее сообщение:
{"to" : "Боб" ,"from" : "Алиса" ,"massage" : "Секретное сообщение"}Нажмите Добавить.
Получите секрет
Пройдите аутентификацию в API.
Создайте персональный ключ доступа:
В личном кабинете перейдите в раздел Управление профилем и нажмите Ключи доступа.
Нажмите Создать ключ и введите краткое описание — Ключ для Secret Manager.
Выберите время жизни ключа — 7 дней и нажмите Создать.
Будут сгенерированы Key ID (логин) и Key Secret (пароль).
Сохраните Key Secret (пароль).
После того как вы закроете окно, посмотреть его будет нельзя.
Получите токен с помощью curl-запроса:
curl -- location -- request POST 'https://iam.api.cloud.ru/api/v1/auth/token?key_id=$KEY_ID&secret=$SECRET'Где:
$KEY_ID — Key ID (логин);
$SECRET — Key Secret (пароль).
Используйте токен при каждом API-запросе к сервису:
Authorization: Bearer $TOKEN
Выполните HTTP-запрос:
GET https : // secretmanager . api . cloud . ru / v1 / secrets /< идентификатор_секрета >/ versions / latest / payloadЗамените значение <идентификатор_секрета> на идентификатор созданного секрета. Чтобы получить идентификатор, в личном кабинете в списке секретов нажмите на название нужного и скопируйте значение поля UUID Секрета.
Значение параметра data в ответе — ваши данные в формате Base64.
Что дальше
Вы можете продолжить работу с секретом, например:
- Перед началом работы
- Создайте секрет
- Получите секрет
- Что дальше