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

6.8 KiB
Raw Permalink Blame History

Единый вход: третий заход — родной 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 включить вход нельзя.