Files
buryan-infra/docs/HOME-ASSISTANT-SSO-STATUS.md
T
buryan-agent d8066f73de Home Assistant: попытка SSO отменена, служба возвращена в рабочее состояние
Провайдер trusted_networks в HA 2026.2.3 конфиг принимает (схема проходит),
но вход с адреса прокси отклоняет — даже при 0.0.0.0/0. Значит HA не
применяет auth_providers из configuration.yaml.

Откат: домен напрямую на 192.168.1.106:8123, прокси остановлен, конфиг
чистый, check_config проходит. У HA остаётся один вход — свой.
2026-10-19 13:56:16 +03:00

69 lines
4.6 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.
# Home Assistant: почему вход через Authentik не заработал и что сделано
Короткая запись к `SPRINT-2026-10-19-SSO-3.md`. Владелец прислал снимок
экрана: HA показывал «Не удалось получить данные о поставщиках аутентификации».
---
## 1. Что было на экране
Адрес в браузере: `home.buryans.ru/auth/authorize?...&redirect_uri=…%2F?auth_callback%3D1`.
То есть **сам Home Assistant** начал свою процедуру входа: он не увидел
готовую сессию и запустил свой OAuth-круг. А затем не смог получить список
способов входа (`/auth/providers`) — потому что этот запрос уходил через прокси
единого входа и возвращал перенаправление вместо JSON.
## 2. Что выяснилось проверкой
| Проверка | Результат |
|---|---|
| Конфиг HA принимает `auth_providers`? | да, `check_config` без ошибок |
| Схема HA принимает наш блок? | да: сети, пользователь, `allow_bypass_login` — всё разбирается |
| HA видит запрос от прокси? | да, в журнале: `from 172.17.0.2` |
| Вход по доверенной сети разрешён? | **нет**: `abort / not_allowed` |
| А если разрешить вообще всё (`0.0.0.0/0`)? | **всё равно `not_allowed`** |
Последний пункт — решающий: при сети `0.0.0.0/0` отказать не может никакой
адрес. Значит HA **не применяет** `auth_providers` из `configuration.yaml`:
провайдер `trusted_networks` у него зарегистрирован (иначе не было бы шага
входа), но со **пустым** списком сетей — отсюда «not_allowed».
Причина, по которой это происходит в HA 2026.2.3, требует отдельного разбора:
провайдеры авторизации хранятся не только в конфиге, но и в
`/config/.storage/auth`, и, судя по поведению, HA берёт их оттуда, а не из
правленого файла (в файле `.storage/auth` при этом ключа `providers` нет —
то есть поведение неочевидное).
## 3. Что сделано
**Откат в рабочее состояние**, чтобы не оставлять службу полусломанной:
* `home.buryans.ru` снова ведёт напрямую на HA (`192.168.1.106:8123`);
* `auth_providers` из конфига убран, `use_x_forwarded_for: true` возвращён;
* прокси `oauth2-proxy-home` остановлен и снят с автозапуска;
* HA перезапущена, `check_config` чистый, домен отвечает 200.
**Итог:** у Home Assistant остаётся **один** вход — его собственный. Двойного
входа нет. Вход через Authentik для HA пока не сделан.
## 4. Что нужно для следующего шага
Разобраться, откуда HA 2026.2.3 берёт список провайдеров авторизации:
1. посмотреть поведение при **пустом** `.storage/auth` (переименовать файл,
дать HA создать заново, проверить, появятся ли сети из конфига);
2. если провайдеры берутся из хранилища — записать провайдера
`trusted_networks` прямо в `.storage/auth` (с id, сетями и пользователем);
3. альтернатива без доверенной сети: оставить HA за прокси и включить
в HA «доверять заголовку» нельзя — такого механизма в HA нет.
## 5. Что из этого захода в силе
Не зависит от HA и работает:
* **Music (Navidrome)** — вход по заголовку от прокси, проверено по API (200/401);
* **Mealie** — родной OIDC, прокси убран;
* **Immich** — OAuth включён (`features.oauth = true`);
* **Element** — Synapse предлагает `m.login.sso` (`allow_existing_users: true`).