Причина отказа найдена в коде 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 новых ошибок нет, прямой заход из локальной сети по-прежнему требует пароль.
80 lines
4.3 KiB
Markdown
80 lines
4.3 KiB
Markdown
# Home Assistant: вход через Authentik — сделано
|
||
|
||
Замена прошлой записи `HOME-ASSISTANT-SSO-STATUS.md` (там был откат).
|
||
Причина отказа найдена в коде HA, обход — рабочий.
|
||
|
||
---
|
||
|
||
## 1. Почему не работало
|
||
|
||
В Home Assistant два разных запрета, и мы попадали то в один, то в другой:
|
||
|
||
```python
|
||
# 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 | Home Assistant` |
|
||
| Журнал 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/` |
|