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

С помощью быстрого старта вы создадите секрет, а затем получите его содержимое через API-запрос.

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

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

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

  2. Подключите Secret Manager. Для этого в меню Кнопка с изображением девяти точек личного кабинета выберите Управление → Secret Manager и нажмите Подключить.

Создайте секрет

  1. В личном кабинете на странице Secret Manager нажмите Добавить секрет.

  2. Введите название ключа — cloudru-example-secret.

  3. Введите описание — Сообщение Бобу от Алисы.

  4. В поле Значение секрета выберите JSON-редактор и скопируйте в следующее сообщение:

    {
    "to" : "Боб" ,
    "from" : "Алиса" ,
    "massage" : "Секретное сообщение"
    }
  5. Нажмите Добавить.

Получите секрет

  1. Пройдите аутентификацию в API.

    1. Создайте персональный ключ доступа:

      1. В личном кабинете перейдите в раздел Управление профилем и нажмите Ключи доступа.

      2. Нажмите Создать ключ и введите краткое описание — Ключ для Secret Manager.

      3. Выберите время жизни ключа — 7 дней и нажмите Создать.

        Будут сгенерированы Key ID (логин) и Key Secret (пароль).

        Сохраните Key Secret (пароль).

        После того как вы закроете окно, посмотреть его будет нельзя.

    2. Получите токен с помощью 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 (пароль).

    3. Используйте токен при каждом API-запросе к сервису:

      Authorization: Bearer $TOKEN
  2. Выполните HTTP-запрос:

    GET https : // secretmanager . api . cloud . ru / v1 / secrets /< идентификатор_секрета >/ versions / latest / payload

    Замените значение <идентификатор_секрета> на идентификатор созданного секрета. Чтобы получить идентификатор, в личном кабинете в списке секретов нажмите на название нужного и скопируйте значение поля UUID Секрета.

Значение параметра data в ответе — ваши данные в формате Base64.

Что дальше

Вы можете продолжить работу с секретом, например:

Evolution