Тема
Сервисные аккаунты
Сервисный аккаунт - субъект для CI, скриптов и интеграций. Он получает доступ так же, как человек, но войти в интерфейс не может и к API обращается с токенами. Лицензия сервисным аккаунтам не нужна.
Раздел «Люди» → «Сервисные аккаунты» виден тем, у кого есть право service_account.manage.
Создание
- Нажмите «Создать аккаунт».
- Введите название: короткое, уникальное, легко узнаваемое в логах, например
ci-androidилиbi-export. - Добавьте описание: для чего аккаунт и кто им пользуется.
- Выберите ответственного. Если оставить пустым, ответственным станете вы.
- Сохраните, затем выдайте аккаунту роль и выпустите токен.
Без роли аккаунт ничего не может, даже с токеном.
Вкладки
| Вкладка | Что в ней |
|---|---|
| Доступ | Роли аккаунта и где они выданы. Выдать, сменить, отозвать роль |
| Токены | Токены аккаунта |
| Аудит | События по аккаунту (нужно право audit.view) |
Доступ
Рекомендуется роль «Агент CI» (отправка результатов и чтение плана прогона) или «Читатель API» (просмотр без выгрузок). Можно использовать и свои роли. Отозвав роль, вы отнимаете права и у токенов аккаунта: токен не может быть шире аккаунта.
Токены
Нажмите «Выпустить токен».
| Параметр | Описание |
|---|---|
| Название | Для чего токен, например bi-export |
| Срок действия | 30 дней, 90 дней, 1 год или бессрочный. Бессрочный работает, пока его не отзовут, поэтому лучше выбирать ограниченный срок |
| Где действует | Вся организация либо проекты и пространства. Токен на проекте действует и в его пространствах |
| Права | Весь набор аккаунта либо выбранные права. Нельзя выбрать то, чего нет у аккаунта; опасные права помечены |
После создания скопируйте токен: он показывается один раз. Отозвать токен можно в списке; всё, что его использует, сразу перестанет работать.
Ответственный
Ответственный отвечает за аккаунт: токены и доступ пересматриваются вместе с ним. Если ответственный заблокирован, токены аккаунта продолжают работать, но аккаунт помечается «Ответственный заблокирован. Назначьте другого».
Управляемые аккаунты
Некоторые аккаунты создаёт и обновляет подключение CI или система: они помечены «управляется подключением» или «управляется системой». Изменить или удалить их здесь нельзя, но доступом и токенами управлять можно. Аккаунты, созданные из токенов проектов при обновлении, помечены «перенесён из токена проекта» и не имеют собственного ограничения: они могут всё, что может аккаунт.
Удаление
Удаление записывается в журнал аудита. Роли аккаунта снимаются, токены отзываются, скрипты с ними перестают работать. Чтобы остановить аккаунт ненадолго, отзовите его токены: аккаунт и доступ сохранятся.