Files
buryan-infra/docs/HOME-ASSISTANT-SSO-DONE.md
T
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

80 lines
4.3 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 — сделано
Замена прошлой записи `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/` |