Files
buryan-infra/docs/SSO-STATE-2026-10-19.md
T
buryan-agent fc70ea2d0d Порядок: HA стабильно (малая cookie), дом и VPS выровнены, лишнее убрано
HA: cookie сессии уменьшена с ~4 КБ (две части) до 565 байт (одна),
новое имя _oauth2_proxy_ha, SameSite=lax. Проверено: повторный заход
отдаёт /auth/providers 200, журнал чист.

Дом и VPS расходились в hub (заглушка nginx), links (мимо единого входа)
и turn — выровнены, теперь 41 домен совпадает.

Overseerr переведён напрямую (свой вход через Plex), прокси снят.
Удалены провайдеры без приложений: n8n-oidc, vaultwarden-proxy (35/36).
Firefly: убраны дубли от проверок, остался владелец.

domains.yaml приведён к факту: 19 адресов, добавлено предупреждение
о ручной настройке единого входа.
2026-10-19 14:22:43 +03:00

117 lines
7.3 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`, `-SSO-2.md`, `-SSO-3.md`,
`HOME-ASSISTANT-SSO-DONE.md`.
---
## 1. Вход через Authentik (один вход, дальше сразу служба)
Проверено сквозным входом — 18 служб:
| Домен | Что открывается |
|---|---|
| `home` | Home Assistant (после прослойки, см. ниже) |
| `music` | Navidrome |
| `docs` | Paperless |
| `links` | Linkding |
| `hub` | Dashy |
| `meals` | Mealie (родной OIDC) |
| `n8n` | n8n |
| `flow` | Node-RED |
| `backup` | Duplicati |
| `status` | Uptime Kuma |
| `books`, `books/catalog/` | Calibre, каталог книг |
| `sonarr`, `radarr`, `prowlarr`, `bazarr` | arr-службы |
| `openclaw` | OpenClaw |
| `news` | FreshRSS (мастер первой настройки) |
| `files` | Nextcloud (кнопка SSO; форма остаётся) |
| `element` | Element (сервер предлагает `m.login.sso`) |
| `immich` | Immich (OAuth включён) |
| `vault` | Vaultwarden (родной SSO + мастер-пароль) |
## 2. Свой вход (прокси единого входа снят намеренно)
Эти службы не умеют принимать вход от прокси — двойного входа нет, вход один,
их собственный:
| Домен | Служба | Почему |
|---|---|---|
| `adguard` | AdGuard Home | нет механизма доверия прокси |
| `media` | Jellyfin | нет SSO (нужен сторонний плагин) |
| `plex` | Plex | не принимает заголовки прокси |
| `git` | Gitea | вход через прокси только для заранее созданных учёток |
| `ombi`, `requests` | Overseerr | свой вход через Plex |
| `pve` | Proxmox | свой вход, так и решено |
## 3. Home Assistant: почему понадобилась прослойка
В HA два запрета, и мы попадали то в один, то в другой:
1. если адрес прокси входит в `http.trusted_proxies` — HA отказывает во входе
по доверенной сети с этого адреса («Can't allow access from a proxy server»);
2. если прокси НЕ в `trusted_proxies`, но присылает `X-Forwarded-For` — HA
отвечает **400** («Received X-Forwarded-For header from an untrusted proxy»).
`oauth2-proxy` не умеет не передавать этот заголовок, поэтому между ним и HA
стоит nginx-прослойка `ha-strip` (сеть `ha-sso`), которая его вычищает.
Схема: `домен → oauth2-proxy-home:9130 → ha-strip → HA:8123`.
Плюс cookie сессии HA-прокси уменьшена: было ~4 КБ в двух частях, стало 565 байт
одной (`--session-cookie-minimal`, имя `_oauth2_proxy_ha`).
## 4. Наведён порядок
| Что | Было | Стало |
|---|---|---|
| Домашний и внешний nginx | расходились в 3 доменах | совпадают полностью (41 домен) |
| `hub` дома | вёл на заглушку nginx (`192.168.1.10`) | на прокси Dashy |
| `links` дома | шёл **мимо** единого входа напрямую | через прокси |
| `turn` дома | проксировал на coturn | перенаправление на `call`, как на VPS |
| Провайдеры Authentik | 37, два без приложений | 35, у всех есть приложение |
| Лишние прокси (adguard, plex, jellyfin, git, meals, vaultwarden, overseerr) | работали | остановлены, автозапуск снят |
| Карта доменов `ops/network/domains.yaml` | расходилась с nginx (19 адресов) | приведена к факту + предупреждение |
| Firefly | в базе дубли от проверок | остался только владелец |
## 5. Что осталось (и почему это не про вход)
| Домен | Состояние |
|---|---|
| `ombi` (Overseerr) | открывается `/setup` — служба **не настроена**. Нужен вход через Plex и выбор библиотек: это может сделать только владелец |
| `news` (FreshRSS) | мастер первой настройки: база пустая, ленты завести заново |
| `finance` (Firefly) | вход через Authentik работает; на `/new-user` ведёт потому, что **в базе 0 счетов** — Firefly просит создать первый счёт |
| `vault` (Vaultwarden) | родной SSO есть, но хранилище требует мастер-пароль — так устроен Vaultwarden |
| `files` (Nextcloud) | форма + кнопка SSO: авто-переход давал круг, оставлен один клик |
| `music` | вход работает; при новом пользователе Navidrome создаёт учётку и её нужно наделить библиотекой (сейчас выдано всем) |
| `libre` | — |
## 6. Важные тонкости (чтобы не сломать)
1. **Прокси HA должен смотреть на `http://ha-strip:80`**, не на `192.168.1.106:8123`.
Иначе вернётся 400.
2. **`http.trusted_proxies` в HA не должен содержать сеть прокси** — иначе HA
откажет по своей защите.
3. **Доверенная сеть HA — это сеть Docker.** Любой контейнер в CT 106 войдёт
туда как Roman.
4. **Не запускать `apply-all-domains.sh` без сверки**: единый вход настроен
вручную (адреса прокси, имена cookie, прослойка). В `domains.yaml` стоит
предупреждение.
5. **Домашний и внешний nginx — разные файлы** (разные пути сертификатов).
Копировать один на другой нельзя.
## 7. Где что лежит
| Что | Где |
|---|---|
| Проверка входа | `/root/login-check.py`, `/root/form-check.py` |
| Пароль проверочной учётки | `/root/.buryan-sso-check-password` |
| Ключ к секретам | `AGE-КЛЮЧ-все-секреты.txt` (в рабочей папке) |
| Токен API Authentik | `/root/.authentik-api-token` |
| Буферы заголовков nginx | `/etc/nginx/conf.d/00-proxy-buffers.conf` (дом и VPS) |
| Прослойка HA | `/opt/ha-strip/nginx.conf` (CT 106) |
| Конфиг HA | `/opt/smart-lxc/homeassistant/config/configuration.yaml` |
| Копии конфигов | `*.bak-*` рядом с файлами, `config.bak-sso-*` у HA |
| Скрипты сессии | `ops/sso/2026-10-19*/` |