diff --git a/ops/adr/ADR-007-gitea-sso.md b/ops/adr/ADR-007-gitea-sso.md new file mode 100644 index 0000000..b9af42d --- /dev/null +++ b/ops/adr/ADR-007-gitea-sso.md @@ -0,0 +1,75 @@ +# ADR-007. Вход в Gitea через Authentik + +**Дата:** 21.10.2026 · **Статус:** в работе (S-02) + +## Что уже есть + +Gitea настроена на доверие обратному прокси: + +```ini +[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 + +```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 | + +## Откат + +1. Убрать `auth_request` из nginx, `nginx -t && systemctl reload nginx`. +2. Остановить `oauth2-proxy-git`. +3. Gitea продолжит работать с обычной формой входа. + +## Почему не сделано сразу + +Правка требует создания провайдера в Authentik и нового контейнера. +Ошибка в шаге 3 блокирует доступ к центральной истине проекта — +поэтому изменения применяются отдельным шагом с проверкой после каждого.