Files
buryan-infra/docs/SPRINT-2026-10-19-SSO-2.md
T
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

116 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Двойной вход: разбор и исправление (вечер 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`
дал круг; откатил.