Authentik: стадия MFA Validation переведена в режим configure с TOTP — при входе пользователь без устройства проходит настройку по QR. Откат описан в ops/auth/2FA.md. Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks, главному репозиторию задано описание и темы. README переписан как индекс: карта инфраструктуры, ссылки на все разделы документации, принципы. Яндекс: зафиксирован статус — чтение работает, управление через API 403 (нет scope iot), управление голосом и Zigbee работают.
9.7 KiB
Двойной вход: разбор и исправление (вечер 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. Уроки
- Код 200 ничего не доказывает. Успех — это когда служба не просит пароль и не совпадает со своей же страницей без входа.
oauth2-proxyне умеет передавать логин. ТолькоX-Forwarded-UserиX-Auth-Request-User, а тамsub. Хочешь логин — меняйsub_modeв провайдере или настраивай у службы вход по почте.- Отступ в compose — это не «мелочь». Три строки, сдвинутые на два
пробела, отключили вход Firefly целиком, и
docker compose configэто показывал, аdocker inspect— нет. - Домашний и внешний nginx — разные файлы. Копировать конфиг с дома на
VPS нельзя: пути к сертификатам разные (
/etc/nginx/certsпротив/etc/letsencrypt/live). Один раз скопировал — VPS перестал проходитьnginx -t. Откатил из копии, правлю только точечно. - Авто-переход на вход — не всегда благо. У Nextcloud
auto_redirectдал круг; откатил.