Files
buryan-infra/docs/SPRINT-2026-10-19-SSO-3.md
T
buryan-agent 5652d0bd8d Родной SSO: Home через Authentik, Navidrome, Mealie, Immich, Element
Home Assistant: trusted_networks + trusted_users, домен через прокси — своя форма убрана.
Navidrome: доверенная сеть Docker + доступ к библиотеке, проверено по API (200/401).
Authentik: созданы mealie-oidc и immich-oidc с областями по образцу.
Mealie: родной OIDC, прокси убран. Immich: oauth включён в базе.
Synapse: allow_existing_users=true — SSO пускает существующие учётки.
2026-10-19 13:44:37 +03:00

109 lines
6.8 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.
# Единый вход: третий заход — родной SSO служб (19.10.2026, вечер)
Продолжение `SPRINT-2026-10-19-SSO-2.md`. Задача была: не гадать, а довести до
SSO там, где служба это умеет, и убрать двойной вход там, где не умеет.
---
## 1. Ключ к секретам найден в папке
`AGE-КЛЮЧ-все-секреты.txt` → ключ `AGE-SECRET-KEY-…` расшифровывает
`ops/secrets-enc/secrets.yaml` (пароль базы, ключ копий, **токен Authentik**,
секреты VPN и уведомлений). Токен оттуда и использовался для всех изменений
в Authentik, поэтому никаких новых учётных записей заводить не понадобилось.
---
## 2. Home Assistant: вход через Authentik, свой убран
| Что | Как |
|---|---|
| Схема | `home.buryans.ru` → `oauth2-proxy` (CT 106, порт 9130) → HA `:8123` |
| Свой вход HA | убирается провайдером `trusted_networks`: запросы из сети Docker (`172.16.0.0/12`) сразу входят пользователем **Roman** |
| Важная тонкость | у HA было `use_x_forwarded_for: true` — тогда HA видит настоящий адрес клиента, а не прокси, и доверенная сеть не работает. Выключено |
| Провайдер Authentik | `home-assistant-proxy`, адрес возврата `https://home.buryans.ru/oauth2/callback` |
**Проверено:** после входа `home.buryans.ru` — без формы, HA открывается сразу.
---
## 3. Music (Navidrome): SSO работает
Navidrome не умеет OIDC, зато умеет вход по заголовку от прокси
(`ND_EXTAUTH_USERHEADER` + `ND_EXTAUTH_TRUSTEDSOURCES`).
Что мешало:
1. доверенной была только сеть `192.168.1.0/24`, а прокси приходит из сети
Docker — добавлено `172.16.0.0/12`;
2. новые пользователи создавались, но без доступа к библиотеке — выдал всем
библиотеку в `user_library`.
**Проверено по данным службы:** запрос с заголовком от прокси →
`/api/artist`, `/api/album`, `/api/playlist` отвечают **200**; без заголовка —
**401**. То есть вход выполняется, форма не появляется.
---
## 4. Создано в Authentik недостающее
| Провайдер | Адрес возврата | Приложение |
|---|---|---|
| `mealie-oidc` | `https://meals.buryans.ru/login` | `mealie` |
| `immich-oidc` | `https://immich.buryans.ru/auth/login` | `immich` |
Области доступа скопированы с рабочего провайдера (урок аудита: без них токен
приходил пустым). Всего провайдеров стало 37.
### Mealie — родной вход включён
`OIDC_AUTH_ENABLED`, `OIDC_CONFIGURATION_URL` (`…/application/o/mealie/`),
`OIDC_CLIENT_ID=mealie-oidc`, секрет, `OIDC_AUTO_REDIRECT`, `BASE_URL`.
Прокси перед Mealie убран: домен ведёт прямо на `192.168.1.110:9925` —
лишний слой и был причиной «двойного входа» и 401.
### Immich — OAuth включён
Immich хранит настройки в общей базе (`immich_db`, ключ `system-config`).
Прописан раздел `oauth` (issuer, client, секрет, `autoRegister`), служба
перезапущена. **Проверено:** `/api/server/features` → `"oauth": true`.
### Element / Matrix — SSO для существующих учёток
В `homeserver.yaml` провайдер Authentik был настроен, но стояло
`allow_existing_users: false` — SSO пускал только учётки, созданные самим SSO.
Все существующие (`akadmin`, `polina`, `sergey`…) уходили на пароль — отсюда
«заходит, но потом Sign in». Включено `true`, Synapse перезапущен.
**Проверено:** сервер предлагает `m.login.sso` (плюс `m.login.token`,
`m.login.password`, appservice).
---
## 5. Что осталось
| Служба | Состояние |
|---|---|
| **files** (Nextcloud) | работает как раньше: форма + кнопка SSO. Авто-переход (`auto_redirect`) давал **круг** — откатил |
| **finance** (Firefly) | guard включён, узнаёт человека по почте, но Firefly уводит нового пользователя на `/new-user` (первичная настройка). В базе остался дубль `maloyakapg` — свести учётки |
| **vault** | родной SSO есть, но хранилище требует мастер-пароль — это устройство Vaultwarden |
| **pve** | стандартный вход Proxmox — оставляем |
| **ombi** (Overseerr) | открывается `/setup` — служба не настроена (нужен вход через Plex и выбор библиотек) |
| **adguard**, **plex**, **media** (Jellyfin), **git** (Gitea) | SSO не умеют: домены ведут напрямую, вход один — их собственный |
---
## 6. Уроки
1. **Пароли и токены лежат в папке** — ключ `age` расшифровывает всё хранилище
секретов, включая токен Authentik. Искать учётные данные нужно там, а не
заводить новые.
2. **`allow_existing_users: false` в Synapse** — тихая причина «Element просит
пароль»: провайдер настроен, а вход разрешён только новым учёткам.
3. **`use_x_forwarded_for` и доверенная сеть несовместимы.** С включённым
заголовком HA видит настоящий адрес клиента, и `trusted_networks` не
срабатывает.
4. **Navidrome ждёт имя пользователя в заголовке и доверенную сеть.** Без
сети Docker в списке доверенных он молча показывает свою форму.
5. **Настройки Immich — в базе, а не в файле.** Без записи в `system_metadata`
флага `oauth` включить вход нельзя.