[S-02] ADR-007: план SSO для Gitea (oauth2-proxy + Authentik + nginx), откат описан

This commit is contained in:
buryan-agent committed 2026-10-21 14:39:32 +03:00
1 parent a02ddbc83c
commit 5d68dfcffb
1 file changed
+75
+75
View File
@@ -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 блокирует доступ к центральной истине проекта —
поэтому изменения применяются отдельным шагом с проверкой после каждого.