tocdepth: 2

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

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

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

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

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

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

В личном кабинете на странице Secret Manager нажмите Добавить секрет.
Введите название ключа — cloudru-example-secret.
Введите описание — Сообщение Бобу от Алисы.
В поле Значение секрета выберите JSON-редактор и скопируйте в следующее сообщение:
```
{
  "to":"Боб",
  "from":"Алиса",
  "massage": "Секретное сообщение"
}
```
Нажмите Добавить.

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

Пройдите аутентификацию в 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
```
Выполните HTTP-запрос:
```
GET https://secretmanager.api.cloud.ru/v1/secrets/<идентификатор_секрета>/versions/latest/payload
```
Замените значение <идентификатор_секрета> на идентификатор созданного секрета. Чтобы получить идентификатор, в личном кабинете в списке секретов нажмите на название нужного и скопируйте значение поля UUID Секрета.

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

Что дальше

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

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