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 пускает существующие учётки.
109 lines
6.8 KiB
Markdown
109 lines
6.8 KiB
Markdown
# Единый вход: третий заход — родной 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` включить вход нельзя.
|