2.8 KiB
2.8 KiB
ADR-007. Вход в Gitea через Authentik
Дата: 21.10.2026 · Статус: в работе (S-02)
Что уже есть
Gitea настроена на доверие обратному прокси:
[security]
ENABLE_REVERSE_PROXY_AUTHENTICATION = true
REVERSE_PROXY_AUTHENTICATION_USER = X-Forwarded-User
REVERSE_PROXY_AUTHENTICATION_EMAIL = X-Forwarded-Email
REVERSE_PROXY_TRUSTED_PROXIES = *
Но nginx для git.buryans.ru не передаёт X-Forwarded-User — поэтому
единый вход фактически не работает, остаётся обычная форма.
План (3 шага, каждый обратим)
Шаг 1. oauth2-proxy для Gitea
Добавить контейнер oauth2-proxy-git (CT140, рядом с Gitea):
--provider=oidc
--oidc-issuer=https://auth.buryans.ru/application/o/gitea/
--client-id=... --client-secret=...
--email-domain=*
--upstream=static://200
--skip-provider-button
--set-xauthrequest
Порт 9111 (свободен).
Шаг 2. Приложение в Authentik
- Provider: OAuth2/OIDC, redirect
https://git.buryans.ru/oauth2/callback. - Application: slug
gitea, доступ — группаgitea-users. - Политика доступа: та же, что у остальных сервисов (2FA обязателен).
Шаг 3. nginx
location = /oauth2/auth { internal; proxy_pass http://192.168.1.140:9111/oauth2/auth; }
location / {
auth_request /oauth2/auth;
error_page 401 = /oauth2/sign_in;
auth_request_set $auth_user $upstream_http_x_auth_request_user;
proxy_set_header X-Forwarded-User $auth_user;
proxy_pass http://192.168.1.140:3000;
}
Риски и защита
| Риск | Мера |
|---|---|
| Отрезать вход в Gitea | конфиг в /mnt/backups/configs (ct/gitea-conf.tgz) |
| Сломать git push/pull | auth_request только для /, git-операции по HTTP Basic остаются |
| Потерять локального админа | пользователь agent-qwen с токеном не зависит от SSO |
Откат
- Убрать
auth_requestиз nginx,nginx -t && systemctl reload nginx. - Остановить
oauth2-proxy-git. - Gitea продолжит работать с обычной формой входа.
Почему не сделано сразу
Правка требует создания провайдера в Authentik и нового контейнера. Ошибка в шаге 3 блокирует доступ к центральной истине проекта — поэтому изменения применяются отдельным шагом с проверкой после каждого.