13.5. Администрирование и обслуживание

⁠13.5. Администрирование и обслуживание

⁠13.5.1. Интеграция Forgejo с AD

Forgejo поддерживает аутентификацию пользователей через LDAP-совместимые каталоги, включая Active Directory (AD). Интеграция с AD позволяет использовать существующие учетные записи пользователей для доступа к Forgejo без создания отдельных учетных записей.

Интеграция с AD позволяет:

использовать корпоративные учётные данные AD для входа в Forgejo;
автоматически создавать учётные записи Forgejoпри первом успешном входе пользователя;
централизованно управлять учетными записями пользователей (например, блокировать доступ путем отключения учетной записи в AD);
использовать атрибуты LDAP (имя, фамилия, адрес электронной почты) из каталога AD.

Примечание

Для подключения Forgejo к AD рекомендуется создать отдельную сервисную учётную запись, которая будет использоваться для поиска объектов каталога. Сервисная учётная запись должна иметь права на чтение объектов пользователей и групп в AD.

Для добавление источника аутентификации необходимо:

Перейти в раздел Панель управления → Идентификация и доступ → Аутентификация и нажать кнопку Добавить новый источник:
В открывшемся окне выбрать тип источника LDAP (через BindDN).
Заполнить параметры подключения (см. Параметры LDAP-аутентификации ).
Нажать кнопку Создать организацию:

⁠

Таблица 13.3. Параметры LDAP-аутентификации

Параметр	Значение	Описание
Название аутентификации	AD	Отображаемое имя источника аутентификации в интерфейсе Forgejo
Сервер	dc1.test.alt	Имя или IP-адрес контроллера домена
Порт	389 (или 636 для LDAPS)	Порт LDAP/LDAPS-сервера
Bind DN	CN=forgejo,CN=Users,DC=test,DC=alt	DN сервисной учётной записи для поиска объектов каталога
Пароль Bind	StrongP@ssword	Пароль сервисной учётной записи
База поиска пользователей	cn=Users,dc=test,dc=alt	Корневой DN для поиска учётных записей пользователей
Фильтр пользователей	(&(objectClass=user)(sAMAccountName=%s))	Фильтр поиска пользователей по логину
Атрибут username	sAMAccountName	Атрибут AD, используемый как имя пользователя в Forgejo
Атрибут first name	givenName	Атрибут с именем пользователя
Атрибут surname	sn	Атрибут с фамилией пользователя
Атрибут эл. почты	mail	Атрибут с адресом электронной почты

После добавления источника LDAP рекомендуется проверить параметры поиска пользователя.

Для проверки аутентификации необходимо:

Открыть страницу входа Forgejo: http://forgejo.test.alt:3000/user/login
В поле Имя или адрес эл. почты указать имя доменного пользователя.
В поле Пароль указать пароль доменного пользователя.
Нажать кнопку Вход:

При успешной аутентификации Forgejo выполнит поиск пользователя в каталоге AD и создаст локальную учетную запись. После этого пользователь будет перенаправлен в интерфейс Forgejo.