[S-02] ADR-007: план SSO для Gitea (oauth2-proxy + Authentik + nginx), откат описан
This commit is contained in:
1 parent
a02ddbc83c
commit
5d68dfcffb
1 file changed
+75
@@ -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 блокирует доступ к центральной истине проекта —
|
||||
поэтому изменения применяются отдельным шагом с проверкой после каждого.
|
||||
Reference in new issue
Block a user