Authentik: стадия MFA Validation переведена в режим configure с TOTP — при входе пользователь без устройства проходит настройку по QR. Откат описан в ops/auth/2FA.md. Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks, главному репозиторию задано описание и темы. README переписан как индекс: карта инфраструктуры, ссылки на все разделы документации, принципы. Яндекс: зафиксирован статус — чтение работает, управление через API 403 (нет scope iot), управление голосом и Zigbee работают.
116 lines
9.7 KiB
Markdown
116 lines
9.7 KiB
Markdown
# Двойной вход: разбор и исправление (вечер 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`
|
||
дал круг; откатил.
|