Files
buryan-infra/ops/adr/ADR-007-gitea-sso.md
T

2.8 KiB
Raw Blame History

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

Откат

  1. Убрать auth_request из nginx, nginx -t && systemctl reload nginx.
  2. Остановить oauth2-proxy-git.
  3. Gitea продолжит работать с обычной формой входа.

Почему не сделано сразу

Правка требует создания провайдера в Authentik и нового контейнера. Ошибка в шаге 3 блокирует доступ к центральной истине проекта — поэтому изменения применяются отдельным шагом с проверкой после каждого.