tocdepth: 2

Перевыпустить API-ключ

В целях безопасности рекомендуется регулярно перевыпускать API-ключи. Если API-ключ был раскрыт, его также необходимо перевыпустить. Вы можете перевыпустить API-ключ в личном кабинете или по API с помощью curl-запроса.

При перевыпуске изменяются только два параметра API-ключа: Key Secret (secret) и дата истечения срока действия (expiresAt). Если в запросе не указана новая дата окончания срока действия API-ключа, будет выставлена дата по умолчанию — один год с текущей даты. Идентификатор ключа остается неизменным.

Перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
Откройте существующий сервисный аккаунт.
Перейдите на вкладку API-ключи.
Найдите нужный ключ и в строке с ним нажмите .
Нажмите Выпустить.
Сохраните Key Secret.

После закрытия окна получить его будет нельзя. Из соображений безопасности рекомендуется хранить пароль в менеджере паролей.

Пример запроса:

curl --location --request POST 'https://iam.api.cloud.ru/api/v1/service-accounts/credentials/api-keys/{id}/reissue?expiresAt=2024-05-23T09%3A32%3A02.984Z' \
--header 'accept: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--header 'Cookie: SERVERID=s1'

Где:

id — идентификатор API-ключа. Передается при создании API-ключа.
expiresAt — дата истечения срока действия API-ключа. Дату истечения можно узнать с помощью запроса на получение данных API-ключа.
$TOKEN — авторизационный токен.

Пример ответа:

{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "api-key-test",
    "description": "тестовый api-key",
    "service_account_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "products": [
        "monaas"
    ],
    "secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "restrictions": {
        "ip_addresses": {
            "ip_addresses": [
                "xxx.xxx.x.x"
            ]
        },
        "time_range": {
            "time_slots": [
                {
                    "start": 18,
                    "end": 19
                }
            ],
            "timezone": 3
        }
    },
    "enabled": true,
    "created_at": "2024-03-25T06:13:26.114149Z",
    "updated_at": "2024-03-25T09:56:36.699551067Z",
    "expires_at": "2024-05-23T09:32:02.984Z"
}

Перевыпустить API-ключ

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