- tocdepth
2
Создать сервисный аккаунт
Вы можете создать сервисный аккаунт в личном кабинете или по API с помощью curl-запроса.
Перейдите в раздел Пользователи, на вкладку Сервисные аккаунты.
В правом верхнем углу нажмите Создать.
Задайте для сервисного аккаунта название и краткое описание.
Назначьте роль. Она будет определять права доступа сервисного аккаунта (см. Роли). Для того, чтобы аккаунт мог совершать какие-либо действия с ресурсами, рекомендуем выбирать роль «Администратор» в проекте. Для просмотра данных подойдет роль «Пользователь».
Нажмите Создать.
Создайте персональный ключ доступа.
Получите аутентификационный токен.
Создайте сервисный аккаунт с помощью curl-запроса:
curl --location 'https://iam.api.cloud.ru/api/v1/service-accounts' \ --header 'accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <аутентификационный токен>' \ --data '{ "name": "SA2_test_public_api", "description": "тестовый сервисный аккаунт для публичного API", "projectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx" }'
Где:
name— Название сервисного аккаунта. Можно использовать латинские буквы, цифры, дефисы, двоеточия и подчеркивания.description— Описание сервисного аккаунта.projectID— Идентификатор проекта, в котором вы хотите создать сервисный аккаунт.
Пример ответа
{ "service_account": { "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "namespace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "name": "SA2_test_public_api", "email": "SA2_test_public_api@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx.iam.cloud.ru", "description": "тестовый сервисный аккаунт для публичного API", "use_refresh_tokens": false, "enabled": true, "created_at": "2024-08-28T10:26:08.224379Z", "updated_at": "2024-08-28T10:26:08.224379Z" } }
С помощью запроса назначьте роль, используя
idсервисного аккаунта из предыдущего шага.Подсказка
Если сервисному аккаунту не добавлена роль, то он не будет авторизован на выполнение вызовов API.
curl --location 'https://iam.api.cloud.ru/api/v1/service-accounts' \ --header 'accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <аутентификационный токен>' \ --data '{ "role": "platform.project.admin", "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "objectType": "resource", "subjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "subjectType": "service_account", "expiresAt": "2024-10-28T07:19:34.563Z" }'
Где:
role— роль, выдаваемая сервисному аккаунту;objectId— идентификатор ресурса, на уровень которого выдается роль;objectType:customer— роль выдается на организацию;resource— роль на любой ресурс.
subjectId— идентификатор сервисного аккаунта;subjectType— тип субъекта, которому выдается роль:service_account— роль для сервисного аккаунта.
expiresAt - 2025-05-28— дата, после которой роль будет удалена.
Сервисный аккаунт появится в списке в статусе «Активен». Теперь для него можно сгенерировать ключ доступа или создать API-ключ.
для Dev & Test