From 5d68dfcffbadd7adff7768a02fa765e7bbaaedf2 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 14:39:32 +0300 Subject: [PATCH] =?UTF-8?q?[S-02]=20ADR-007:=20=D0=BF=D0=BB=D0=B0=D0=BD=20?= =?UTF-8?q?SSO=20=D0=B4=D0=BB=D1=8F=20Gitea=20(oauth2-proxy=20+=20Authenti?= =?UTF-8?q?k=20+=20nginx),=20=D0=BE=D1=82=D0=BA=D0=B0=D1=82=20=D0=BE=D0=BF?= =?UTF-8?q?=D0=B8=D1=81=D0=B0=D0=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/adr/ADR-007-gitea-sso.md | 75 ++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 ops/adr/ADR-007-gitea-sso.md 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 блокирует доступ к центральной истине проекта — +поэтому изменения применяются отдельным шагом с проверкой после каждого.