Files
buryan-infra/docs/SPRINT-2026-10-19-SSO-2.md
buryan-agent d967d4ed3f 2FA включён, Gitea прибран, README-индекс, статус Яндекс API
Authentik: стадия MFA Validation переведена в режим configure с TOTP —
при входе пользователь без устройства проходит настройку по QR. Откат
описан в ops/auth/2FA.md.

Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks,
главному репозиторию задано описание и темы. README переписан как индекс:
карта инфраструктуры, ссылки на все разделы документации, принципы.

Яндекс: зафиксирован статус — чтение работает, управление через API 403
(нет scope iot), управление голосом и Zigbee работают.
2026-10-20 23:32:33 +03:00

9.7 KiB
Raw Permalink Blame History

Двойной вход: разбор и исправление (вечер 19.10.2026, второй заход)

Продолжение SPRINT-2026-10-19-SSO.md. Владелец проверил службы браузером и прислал список. Мой прошлый проверяльщик был слишком мягким — он считал «код 200 и заголовок страницы» успехом, а это могла быть форма входа самой службы. Ниже — что на самом деле и что сделано.


1. Почему прошлая проверка врала

login-check.py проходил вход и печатал заголовок страницы. Но Jellyfin, Gitea, Linkding, Paperless и другие отдают свою форму входа с кодом 200 — и это выглядело как успех.

Сделаны два новых проверяльщика:

Инструмент Что делает
auth-check.py после входа ищет поле пароля, переход на /login, и сравнивает страницу с той, что служба отдаёт без входа
form-check.py по каждому домену: есть ли <input type="password">, куда привело после входа, какие слова формы встречаются
persist-check.py остаётся ли cookie входа: второй заход не должен снова идти на Authentik

Важный вывод persist-check.py: cookie входа держится (у всех служб _oauth2_proxy_0/_1), круга через Authentik при каждом заходе нет. Значит «двойной вход» — это своя форма службы, а не повторный Authentik.


2. Корневая причина «двойного входа» у половины служб

oauth2-proxy передаёт службе имя пользователя только в заголовках X-Forwarded-User и X-Auth-Request-User. Туда попадает поле sub из токена Authentik. У всех 35 провайдеров стоял sub_mode=hashed_user_id — то есть хеш вместо логина.

Заголовка с настоящим логином (X-Auth-Request-Preferred-Username) oauth2-proxy не передаёт вовсе — проверено по его --help:

--set-xauthrequest   set X-Auth-Request-User and X-Auth-Request-Email response headers
--pass-user-headers  pass X-Forwarded-User and X-Forwarded-Email information

Поэтому службы не находили пользователя и показывали свою форму.

Сделано: у провайдеров git-proxy, linkding-proxy, navidrome-proxy, finance-proxy, meals-proxy, calibre-web-proxy, status-proxy sub_mode → user_username. Провайдеры Nextcloud, Vaultwarden и Matrix не трогал: там sub служит ключом привязки учётных записей.


3. Что исправлено и чем подтверждено

Служба Было Сделано Проверка
links (Linkding) своя форма LD_AUTH_PROXY_USERNAME_HEADER=HTTP_X_FORWARDED_USER (стояло несуществующее X-Auth-Request-Preferred-Username) вход → /bookmarks, поля пароля нет
docs (Paperless) своя форма PAPERLESS_ENABLE_HTTP_REMOTE_USER=true + PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME=HTTP_X_FORWARDED_USER напрямую с заголовком — 200; через домен — документы, формы нет
finance (Firefly) своя форма в compose настройки AUTHENTICATION_GUARD* были сдвинуты внутрь APP_KEY — Docker их не видел. Выровнены, APP_URL задан guard работает: в журнале «User visits homepage (maloyakapg)»
music (Navidrome) своя форма ND_EXTAUTH_TRUSTEDSOURCES расширен на сеть Docker (172.16.0.0/12) — прокси приходил из неё и заголовок игнорировался частично, см. раздел 5
adguard двойной вход AdGuard Home не умеет вход от прокси — домен переведён напрямую, прокси выключен один вход — AdGuard
media (Jellyfin) двойной вход Jellyfin не умеет SSO — домен напрямую один вход — Jellyfin
plex 400/401 Plex не умеет SSO — домен напрямую; корень / → /web/ /web/ открывается, один вход
git (Gitea) двойной вход вход через прокси в Gitea работает только для заранее созданных пользователей, а в Gitea их три (root, agent-qwen, agent-openclaw) — ни один не совпадает с именами Authentik. Домен напрямую один вход — Gitea
headscale 403 корень перенаправлен на /windows 200
files (Nextcloud) «два Authentik» провайдер один (проверено occ user_oidc:provider). Авто-переход на SSO дал круг — откатил; остаётся форма + кнопка SSO вход по кнопке → Панель, 200

4. Где двойного входа нет (проверено формой)

sonarr, radarr, prowlarr, bazarr, meals, backup, hub, n8n, books, books/catalog/, status, news, openclaw, immich, home, vault, element, plex — поля пароля на странице после входа нет.

Отдельно: books.buryans.ru/catalog/ — цикла больше нет (200, «Каталог книг»); причина была в адресе возврата провайдера и совпадении имени cookie с Calibre (раздел 3.1 прошлого отчёта).


5. Что осталось и почему (по факту, не по догадке)

Служба Что мешает
music (Navidrome) заголовок всё ещё не принимается: пользователь от прокси не создаётся. Дальше — смотреть журнал Navidrome (ExtAuth) и точный IP прокси в момент запроса
finance (Firefly) guard включён и узнаёт человека по почте, но Firefly уводит на /new-user (первичная настройка валюты/языка). В базе уже есть дубль maloyakapg (создан guard'ом) рядом с maloyakapg@gmail.com — нужно свести учётные записи
element Element просит вход в Matrix: нужен SSO в Synapse (OIDC-провайдер + homeserver.yaml). Это отдельная работа
meals (Mealie) Mealie умеет OIDC нативно, но у него вход через свой экран. Нужен провайдер в Authentik с адресом возврата Mealie
immich OIDC нативно не настроен (нужен административный API-ключ Immich)
vault (Vaultwarden) родной SSO включён, но хранилище всё равно требует мастер-пароль — это устройство Vaultwarden, убрать нельзя
home (Home Assistant) свой вход — так решено владельцем ранее
ombi (Overseerr) открывается /setup — служба не настроена (нужен вход через Plex и выбор библиотек). Это действие владельца
files (Nextcloud) авто-переход зацикливается; остаётся один клик по кнопке SSO
pve стандартный вход Proxmox — оставляем

6. Уроки

  1. Код 200 ничего не доказывает. Успех — это когда служба не просит пароль и не совпадает со своей же страницей без входа.
  2. oauth2-proxy не умеет передавать логин. Только X-Forwarded-User и X-Auth-Request-User, а там sub. Хочешь логин — меняй sub_mode в провайдере или настраивай у службы вход по почте.
  3. Отступ в compose — это не «мелочь». Три строки, сдвинутые на два пробела, отключили вход Firefly целиком, и docker compose config это показывал, а docker inspect — нет.
  4. Домашний и внешний nginx — разные файлы. Копировать конфиг с дома на VPS нельзя: пути к сертификатам разные (/etc/nginx/certs против /etc/letsencrypt/live). Один раз скопировал — VPS перестал проходить nginx -t. Откатил из копии, правлю только точечно.
  5. Авто-переход на вход — не всегда благо. У Nextcloud auto_redirect дал круг; откатил.