Сервисный аккаунт — это учётная запись, предназначенная для использования в автоматизированных скриптах. Такие аккаунты применяются в CI/CD-пайплайнах и интеграциях. Сервисный аккаунт нельзя использовать для аутентификации в веб-интерфейсе, а также для выполнения действий от его имени через имперсонацию.

Создание сервисного аккаунта

Сервисный аккаунт инстанса создаёт администратор в веб-интерфейсе, через REST API или в Rails-консоли. Сервисные аккаунты группы и проекта создают владелец группы и Maintainer проекта в настройках группы или проекта.

В веб-интерфейсе

  1. Выберите «Admin» → «Настройки» → «Сервисные аккаунты».
  2. Нажмите «Добавить сервисный аккаунт».
  3. Заполните поле «Имя». Поля «Имя пользователя» и «Электронная почта» необязательные.
  4. Нажмите «Создать».

Через REST API

Отправьте запрос POST /api/v4/service_accounts с токеном администратора. Необязательные параметры name, username и email задают имя, имя пользователя и адрес электронной почты аккаунта.

В Rails-консоли

Откройте Rails-консоль для используемого типа установки:

Создание аккаунта

  1. Используя Rails-консоль, подготовьте параметры с описанием создаваемого аккаунта. Заполните поля name, username, email и admin и задайте остальные параметры на основе следующего примера:

    user_args = {
    name: 'kaiten_sa',
    username: 'kaiten_sa',
    email: 'kaiten_sa@flant.com',
    admin: false,
    user_type: :service_account,
    organization_id: Organizations::Organization.default_organization.id,
    password_automatically_set: true,
    force_random_password: true,
    skip_confirmation: true
    }
  2. Выберите пользователя, от имени которого будет создан сервисный аккаунт, после чего выполните создание пользователя:

    user = User.find_by_username('root')
    Users::CreateService.new(user, user_args).execute

Генерация токена доступа

Чтобы создать токен доступа в веб-интерфейсе:

  1. Выберите «Admin» → «Настройки» → «Сервисные аккаунты».
  2. Откройте меню ⋮ в строке аккаунта и выберите «Управление токенами доступа».
  3. Нажмите «Добавить новый токен».
  4. Заполните поля «Имя токена» и «Срок действия» и выберите области действия токена.
  5. Нажмите «Создать токен».

Чтобы создать токен через REST API, используйте Personal access tokens API от GitLab.