Files
buryan-infra/docs/HOME-ASSISTANT-SSO-DONE.md
buryan-agent 92b1d4a58f Home Assistant: вход через Authentik заработал (прослойка снимает X-Forwarded-For)
Причина отказа найдена в коде HA: он запрещает вход по доверенной сети
с адреса, внесённого в http.trusted_proxies, а если адрес не внесён и
приходит X-Forwarded-For — отвечает 400.

Решение: trusted_networks для сети Docker с trusted_users (пользователь Roman),
trusted_proxies без сети прокси, и nginx-прослойка ha-strip между прокси и HA,
которая вычищает X-Forwarded-For и X-Real-IP.

Проверено: способы входа содержат Trusted Networks, авто-вход отдаёт
create_entry, круг через домен — 200 Home Assistant, в журнале HA новых
ошибок нет, прямой заход из локальной сети по-прежнему требует пароль.
2026-10-19 14:05:51 +03:00

4.3 KiB
Raw Permalink Blame History

Home Assistant: вход через Authentik — сделано

Замена прошлой записи HOME-ASSISTANT-SSO-STATUS.md (там был откат). Причина отказа найдена в коде HA, обход — рабочий.


1. Почему не работало

В Home Assistant два разных запрета, и мы попадали то в один, то в другой:

# homeassistant/auth/providers/trusted_networks.py
if any(ip_addr in trusted_proxy for trusted_proxy in self.trusted_proxies):
    raise InvalidAuthError("Can't allow access from a proxy server")
  1. Если адрес прокси внесён в http.trusted_proxies — HA запрещает вход по доверенной сети с этого адреса. Это и давало not_allowed при любых сетях, вплоть до 0.0.0.0/0.
  2. Если адрес прокси не внесён в trusted_proxies, но прокси присылает X-Forwarded-For — HA отвечает 400 и пишет в журнал: Received X-Forwarded-For header from an untrusted proxy 172.17.0.2.

А oauth2-proxy не умеет не передавать X-Forwarded-For (в --help такого ключа нет).

2. Решение

Шаг Что сделано
1 homeassistant.auth_providers: trusted_networks c сетью Docker 172.16.0.0/12, trusted_users → пользователь Roman, allow_bypass_login: true
2 http.trusted_proxies: оставлен только 127.0.0.1 — прокси там быть не должно
3 Между oauth2-proxy и HA поставлена прослойка ha-strip (nginx в сети ha-sso), которая вычищает X-Forwarded-For и X-Real-IP
4 Домен home.buryans.ru → oauth2-proxy-home (9130) → ha-strip → HA :8123

Схема:

браузер → nginx (VPS и дом) → oauth2-proxy-home :9130
        → ha-strip (снимает X-Forwarded-For)
        → Home Assistant :8123

HA видит адрес ha-strip (сеть Docker) — он в доверенной сети, а признаков прокси в запросе нет. Поэтому вход выполняется автоматически пользователем Roman, без формы.

3. Что проверено

Проверка Результат
check_config HA чистый
Способы входа от прокси trusted_networks + homeassistant
Начало входа от прокси create_entry — HA сразу выдаёт вход, формы нет
Весь круг через домен Authentik → HA, `итог 200
Журнал HA новых untrusted proxy и 400 нет
Прямой заход на 192.168.1.106:8123 из локальной сети 200, своя форма — то есть доступ из дома без пароля не открылся

4. Что важно помнить

  • Доверенная сеть — это сеть Docker. Любой контейнер в CT 106, попавший в 172.16.0.0/12, войдёт в HA как Roman. Сеть маленькая и локальная, но это осознанный компромисс, а не недосмотр.
  • Прослойка обязательна. Если её убрать, вернётся 400 от HA. Скрипт пересоздания прокси должен указывать upstream http://ha-strip:80, а не 192.168.1.106:8123.
  • trusted_proxies не должен содержать сеть прокси — иначе HA снова откажет по своей защите от входа «с прокси-адреса».
  • Копия конфига HA до правок: /opt/smart-lxc/homeassistant/config.bak-sso-20261019_140039.

5. Файлы

Что Где
Конфиг прослойки /opt/ha-strip/nginx.conf (CT 106)
Сеть Docker ha-sso
Контейнеры ha-strip, oauth2-proxy-home (оба restart unless-stopped)
Скрипты настройки ops/sso/2026-10-19-ha-sso/