tocdepth

2

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

С помощью быстрого старта вы создадите секрет, а затем получите его содержимое через 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 free tier
для Dev & Test
Получить