# IAM API Selectel

> Управляйте пользователями панели и сервисными пользователями Selectel, группами, ролями и S3 ключами.

- HTML: https://poapi.ru/selectel/iam
- Компания: Selectel
- Страница компании: https://poapi.ru/company/selectel
- Категории: Администрирование
- Сайт API: https://docs.selectel.ru/api/users-and-roles/
- Документация: https://docs.selectel.ru/api/users-and-roles/

## Подключение и ограничения
- Авторизация: iam_token_account_scoped; передавайте IAM-токен аккаунта в X-Auth-Token. Такую схему задаёт OpenAPI для GET /iam/v1/me.
- Ограничения: Нужны Bash, curl, jq, account-scoped IAM-токен, ожидаемый keystone_id, имя роли и scope. Для scope=project задайте PROJECT_ID. URL метода — https://api.selectel.ru/iam/v1/me; базовый URL уже включает /iam/v1. Тайм-ауты 5/30 секунд. Скрипт выключает xtrace и не передаёт токен в аргументах процесса curl и не печатает его.

```bash
#!/usr/bin/env bash
set -euo pipefail
set +x
: "${IAM_TOKEN:?Укажите account-scoped IAM-токен}"
: "${EXPECTED_KEYSTONE_ID:?Укажите ожидаемый keystone_id}"
: "${EXPECTED_ROLE_NAME:?Укажите точное имя роли}"
: "${EXPECTED_ROLE_SCOPE:?Укажите account или project}"
if [[ $EXPECTED_ROLE_SCOPE == project ]]; then : "${PROJECT_ID:?Укажите ID проекта}"; elif [[ $EXPECTED_ROLE_SCOPE != account ]]; then echo "EXPECTED_ROLE_SCOPE должен быть account или project" >&2; exit 2; fi
command -v curl >/dev/null && command -v jq >/dev/null || { echo "Нужны Bash, curl и jq" >&2; exit 2; }
base=${IAM_API:-https://api.selectel.ru/iam/v1}
body=$(printf 'header = "X-Auth-Token: %s"\n' "$IAM_TOKEN" | curl --config - --silent --show-error --fail-with-body --connect-timeout 5 --max-time 30 -H "Accept: application/json" "${base%/}/me")
printf '%s\n' "$body" | jq -e --arg id "$EXPECTED_KEYSTONE_ID" --arg role "$EXPECTED_ROLE_NAME" --arg scope "$EXPECTED_ROLE_SCOPE" --arg project "${PROJECT_ID:-}" '(.keystone_id == $id) and ((.roles | type) == "array") and ([.roles[] | select(.role_name == $role and .scope == $scope and ($scope != "project" or .project_id == $project))] | length >= 1)' >/dev/null || { echo "Текущий пользователь или роль не совпали с ожидаемыми" >&2; exit 1; }
echo "IAM-пользователь и роль совпали; токен не выводился"
```
- Результат: GET /iam/v1/me возвращает UserProfileResponse с keystone_id и roles. Элемент roles содержит role_name, scope (account или project) и project_id. Скрипт требует ожидаемый keystone_id и роль с точным scope.
- Ошибки: OpenAPI для GET /iam/v1/me перечисляет 401 и 404 помимо 200. curl останавливается при HTTP-ошибке или тайм-ауте. Несовпадение keystone_id или отсутствие точной роли также прекращает сценарий.
- Проверено по документации: 2026-11-15
- [IAM API Selectel](https://docs.selectel.ru/api/users-and-roles/)
- [URL IAM API](https://docs.selectel.ru/api/urls/)
- [Тарифы Selectel](https://selectel.ru/prices/)

## Описание
IAM API управляет пользователями панели, сервисными пользователями, группами и назначением ролей; отдельные методы создают, читают и удаляют S3 ключи. Роли назначаются на уровне аккаунта или проекта. Создание S3 ключа возвращает secret key только в ответе создания, поэтому сохраните его в защищённом хранилище сразу.

## Пользователи, группы и роли

IAM API работает с пользователями панели, сервисными пользователями и группами. У роли есть role_name, scope и project_id. Группы подходят для повторяемого набора прав; отдельно проверяйте, относится роль к аккаунту или проекту.

Удаление сервисного пользователя удаляет его пары ключей. Перед удалением перенесите интеграции и проверьте зависимости.

## Ключи сервисного пользователя

API даёт методы для списка, создания и удаления S3-credentials. При создании ответ содержит access_key и secret_key; спецификация указывает, что секрет возвращается только один раз. Сохраните его в менеджере секретов до закрытия ответа.

Для ротации создайте новую пару, переведите приложение и затем удалите старый access_key. Не печатайте полный JSON credentials и не записывайте токен в shell trace.

## Проверка токена и назначений

GET /iam/v1/me возвращает профиль с keystone_id и массивом roles. Пример сверяет ожидаемый идентификатор и пару role_name/scope; это подтверждает данные IAM, но не доступность соседнего API.

Методы текущей спецификации используют account-scoped IAM-токен в X-Auth-Token. Токен действует 24 часа. Скрипт отключает xtrace и выводит только результат проверки.

## Расходы продуктов

IAM управляет правами, но не создаёт облачные ресурсы. Назначение роли может разрешить автоматизации использовать платный продукт; проверяйте стоимость и потребление этого продукта, пула и конфигурации. Пример выполняет только чтение профиля.

## Когда использовать
- Перед запуском автоматизации проверить, что IAM-токен принадлежит ожидаемому пользователю и у него есть роль на целевой проект.
- Объединять пользователей и сервисных пользователей в группы, назначать роли для аккаунта или проекта и отзывать доступ при смене обязанностей.
- Управлять S3-ключами пользователей и сервисных пользователей, не выводя секреты в журнал.

## Порядок интеграции
1. Выберите пользователя автоматизации и область полномочий: аккаунт или проект. Текущая спецификация IAM API требует account-scoped токен; IAM-токен действует 24 часа.
2. Перед изменением доступа выполните GET /iam/v1/me и сравните keystone_id и роль. Пример ниже не выводит токен и останавливается при несовпадении пользователя или scope.
3. Меняйте только необходимые назначения через API групп и ролей. После изменения проверьте целевой API отдельно. При создании S3-ключа сохраните secret_key из ответа создания; позже его перечитать нельзя.

## Что проверить перед запуском
- scope=account и scope=project дают разные назначения. Сверьте project_id и role_name, иначе пользователь получит слишком широкий либо недостаточный доступ.
- Токен действует 24 часа. Для долгой автоматизации предусмотрите безопасное обновление; не печатайте X-Auth-Token в stdout, CI-журнал или shell trace.
- secret_key возвращается только при создании. Если он потерян, выпустите новую пару, безопасно сохраните её и удалите прежнюю по access_key. Удаление сервисного пользователя также удаляет его ключи.

## Связанные API
- [Cloud Platform Projects and Resources API Selectel](https://poapi.ru/selectel/selectel-cloud-management-api): Управляйте проектами облачной платформы, пользователями, публичными IP, подсетями, SSH ключами и лицензиями; виртуальные ресурсы создаются через OpenStack API.
- [Object Storage API Selectel](https://poapi.ru/selectel/selectel-storage-api): Управляйте квотой Object Storage, параметрами контейнеров и доменами, задачами экспорта логов и SSL сертификатами.
