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 новых
ошибок нет, прямой заход из локальной сети по-прежнему требует пароль.
This commit is contained in:
buryan-agent committed 2026-10-19 14:05:51 +03:00
1 parent d8066f73de
commit 92b1d4a58f
8 files changed
+418

No files matched your search

+79
View File
@@ -0,0 +1,79 @@
# 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/` |
@@ -0,0 +1,15 @@
#!/bin/bash
# Как HA 2026.2.3 собирает провайдеров авторизации
set -uo pipefail
CT=106
echo "=== 1. ГДЕ В КОДЕ ЧИТАЕТСЯ auth_providers ==="
pct exec $CT -- bash -c "docker exec homeassistant grep -rn 'auth_providers' /usr/src/homeassistant/homeassistant/ --include='*.py' | head -12" 2>&1 | sed 's/^/ /'
echo
echo "=== 2. AUTHMANAGER: создание провайдеров ==="
pct exec $CT -- bash -c "docker exec homeassistant grep -n -A22 'def _config_providers' /usr/src/homeassistant/homeassistant/auth/__init__.py" 2>&1 | sed 's/^/ /'
echo
echo "=== 3. ЧТО ДЕЛАЕТСЯ ПРИ async_setup ==="
pct exec $CT -- bash -c "docker exec homeassistant grep -n -A18 'async def async_setup' /usr/src/homeassistant/homeassistant/auth/__init__.py" 2>&1 | sed 's/^/ /'
@@ -0,0 +1,74 @@
#!/bin/bash
# ============================================================
# HA: вход через Authentik без своей формы
# ============================================================
# HA отказывал («not_allowed»), потому что адрес прокси входил в
# http.trusted_proxies, а HA не пускает по доверенной сети С ПРОКСИ-АДРЕСА:
# if any(ip_addr in trusted_proxy for trusted_proxy in self.trusted_proxies):
# raise InvalidAuthError("Can't allow access from a proxy server")
#
# Решение: убрать сеть Docker из http.trusted_proxies. Тогда HA не доверяет
# X-Forwarded-For от прокси и берёт адрес прокси как адрес клиента (172.17.0.2),
# а он уже входит в trusted_networks.
# ============================================================
set -uo pipefail
CT=106
CFG=/opt/smart-lxc/homeassistant/config/configuration.yaml
ROMAN=217134ecbef24dfb82574b398287491c
STAMP=$(date +%Y%m%d_%H%M%S)
echo "=== 0. КОПИЯ КАТАЛОГА КОНФИГА ==="
pct exec $CT -- cp -a /opt/smart-lxc/homeassistant/config /opt/smart-lxc/homeassistant/config.bak-sso-$STAMP
pct exec $CT -- bash -c "ls -d /opt/smart-lxc/homeassistant/config.bak-sso-* | tail -1" | sed 's/^/ копия: /'
echo
echo "=== 1. ПРАВЛЮ КОНФИГ ==="
pct exec $CT -- docker exec -i homeassistant python - <<PY
import yaml
p = "/config/configuration.yaml"
d = yaml.safe_load(open(p, encoding="utf-8"))
d.setdefault("homeassistant", {})["auth_providers"] = [
{
"type": "trusted_networks",
"trusted_networks": ["172.16.0.0/12", "192.168.1.0/24"],
"trusted_users": {
"172.16.0.0/12": "$ROMAN",
"192.168.1.0/24": "$ROMAN",
},
"allow_bypass_login": True,
},
{"type": "homeassistant"},
]
http = d.setdefault("http", {})
http["use_x_forwarded_for"] = True
http["trusted_proxies"] = ["127.0.0.1"]
yaml.safe_dump(d, open(p, "w", encoding="utf-8"), sort_keys=False, allow_unicode=True)
print(open(p, encoding="utf-8").read())
PY
echo
echo "=== 2. ПРОВЕРКА КОНФИГА ==="
pct exec $CT -- docker exec homeassistant python -m homeassistant --script check_config -c /config 2>&1 | tail -3 | sed 's/^/ /'
echo
echo "=== 3. ПЕРЕЗАПУСК ==="
pct exec $CT -- docker restart homeassistant >/dev/null 2>&1
for i in $(seq 1 10); do
sleep 9
c=$(curl -s -o /dev/null -w '%{http_code}' --max-time 6 http://192.168.1.106:8123/ 2>/dev/null)
if [ "$c" = "200" ]; then echo " HA поднялась ($i)"; break; fi
done
echo
echo "=== 4. ТЕСТ ВХОДА ПО ДОВЕРЕННОЙ СЕТИ (из сети прокси) ==="
pct exec $CT -- docker start oauth2-proxy-home >/dev/null 2>&1
sleep 6
pct exec $CT -- docker run --rm --net container:oauth2-proxy-home curlimages/curl:latest \
-s -X POST --max-time 15 -H 'Content-Type: application/json' \
-d '{"client_id":"http://192.168.1.106:8123/","handler":["trusted_networks",null],"redirect_uri":"http://192.168.1.106:8123/?auth_callback=1"}' \
http://192.168.1.106:8123/auth/login_flow 2>&1 | head -c 400
echo
echo
echo "=== 5. СПОСОБЫ ВХОДА ОТТУДА ЖЕ ==="
pct exec $CT -- docker run --rm --net container:oauth2-proxy-home curlimages/curl:latest \
-s --max-time 15 http://192.168.1.106:8123/auth/providers 2>&1 | head -c 300
@@ -0,0 +1,89 @@
#!/bin/bash
# ============================================================
# HA: домен снова через прокси единого входа
# ============================================================
# Доверяем только сети Docker (прокси). Локальную сеть 192.168.1.0/24
# из доверенных убираю: иначе любой в доме входил бы в HA без пароля,
# обращаясь напрямую на 192.168.1.106:8123.
# ============================================================
set -uo pipefail
CT=106
ROMAN=217134ecbef24dfb82574b398287491c
echo "=== 1. ДОВЕРЯЕМ ТОЛЬКО ПРОКСИ ==="
pct exec $CT -- docker exec -i homeassistant python - <<PY
import yaml
p = "/config/configuration.yaml"
d = yaml.safe_load(open(p, encoding="utf-8"))
d["homeassistant"]["auth_providers"] = [
{
"type": "trusted_networks",
"trusted_networks": ["172.16.0.0/12"],
"trusted_users": {"172.16.0.0/12": "$ROMAN"},
"allow_bypass_login": True,
},
{"type": "homeassistant"},
]
yaml.safe_dump(d, open(p, "w", encoding="utf-8"), sort_keys=False, allow_unicode=True)
print(" доверенные сети: 172.16.0.0/12")
PY
pct exec $CT -- docker exec homeassistant python -m homeassistant --script check_config -c /config 2>&1 | tail -2 | sed 's/^/ /'
pct exec $CT -- docker restart homeassistant >/dev/null 2>&1
for i in $(seq 1 10); do
sleep 9
c=$(curl -s -o /dev/null -w '%{http_code}' --max-time 6 http://192.168.1.106:8123/ 2>/dev/null)
if [ "$c" = "200" ]; then echo " HA поднялась ($i)"; break; fi
done
echo
echo "=== 2. ДОМЕН → ПРОКСИ (дома и на VPS) ==="
python3 - <<'PY'
import re, datetime
p = "/etc/nginx/conf.d/buryans-all.conf"
t = open(p, encoding="utf-8").read()
m = re.search(r"server_name\s+home\.buryans\.ru\s*;", t)
end = t.find("\n}", m.end())
block = t[m.end():end]
new = re.sub(r"proxy_pass\s+http://[^;]+;", "proxy_pass http://192.168.1.106:9130;", block)
if new == block:
print(" дом: уже через прокси")
else:
open(f"{p}.before-home-sso2-{datetime.datetime.now():%Y%m%d_%H%M%S}", "w", encoding="utf-8").write(t)
open(p, "w", encoding="utf-8").write(t[:m.end()] + new + t[end:])
print(" дом: home → 192.168.1.106:9130")
PY
nginx -t 2>&1 | tail -1 | sed 's/^/ /'
systemctl reload nginx && echo " домашний nginx перезагружен"
python3 - > /tmp/vps-home2.py <<'PY'
print(r'''
import re, datetime
p = "/etc/nginx/conf.d/buryans-all.conf"
t = open(p, encoding="utf-8").read()
m = re.search(r"server_name\s+home\.buryans\.ru\s*;", t)
if m:
end = t.find("\n}", m.end())
block = t[m.end():end]
new = re.sub(r"proxy_pass\s+http://[^;]+;", "proxy_pass http://192.168.1.106:9130;", block)
open(f"{p}.before-home-sso2-{datetime.datetime.now():%Y%m%d_%H%M%S}", "w", encoding="utf-8").write(t)
open(p, "w", encoding="utf-8").write(t[:m.end()] + new + t[end:])
print(" VPS: home -> 9130")
else:
print(" VPS: блок не найден")
''')
PY
scp -q /tmp/vps-home2.py root@193.233.210.184:/tmp/vps-home2.py
ssh -o BatchMode=yes root@193.233.210.184 'python3 /tmp/vps-home2.py && nginx -t 2>&1 | tail -1 && systemctl reload nginx && echo " VPS перезагружен"' 2>&1 | sed 's/^/ /'
echo
echo "=== 3. ПРОКСИ В АВТОЗАПУСК ==="
pct exec $CT -- docker update --restart=unless-stopped oauth2-proxy-home >/dev/null 2>&1
pct exec $CT -- docker start oauth2-proxy-home >/dev/null 2>&1
sleep 5
echo " состояние: $(pct exec $CT -- docker inspect oauth2-proxy-home --format '{{.State.Status}} / {{.HostConfig.RestartPolicy.Name}}' 2>/dev/null)"
echo
echo "=== 4. ПРОВЕРКА ДОМЕНА ==="
sleep 3
echo " home.buryans.ru → $(curl -s -o /dev/null -w '%{http_code}' --max-time 15 -k https://home.buryans.ru/ | cut -c1-80)"
curl -s -o /dev/null -D - --max-time 15 -k https://home.buryans.ru/ 2>/dev/null | grep -i '^location:' | tr -d '\r' | cut -c1-80 | sed 's/^/ /'
@@ -0,0 +1,6 @@
#!/bin/bash
# Умеет ли oauth2-proxy НЕ передавать X-Forwarded-For
set -uo pipefail
CT=106
pct exec $CT -- docker run --rm quay.io/oauth2-proxy/oauth2-proxy:latest --help 2>&1 \
| grep -i -e forwarded -e 'strip-headers' | head -20 | sed 's/^/ /'
@@ -0,0 +1,93 @@
#!/bin/bash
# ============================================================
# HA + Authentik: прослойка, снимающая X-Forwarded-For
# ============================================================
# HA в двух случаях против:
# 1) если прокси в http.trusted_proxies — «нельзя входить с прокси-адреса»;
# 2) если прокси НЕ в trusted_proxies, но шлёт X-Forwarded-For — 400.
# oauth2-proxy не умеет не слать этот заголовок. Поэтому между ним и HA
# ставим nginx-прослойку, которая его вычищает. Тогда HA видит адрес
# прослойки (сеть Docker) — а эта сеть и есть доверенная.
# ============================================================
set -uo pipefail
CT=106
echo "=== 1. КОНФИГ ПРОСЛОЙКИ ==="
pct exec $CT -- mkdir -p /opt/ha-strip
pct exec $CT -- tee /opt/ha-strip/nginx.conf >/dev/null <<'EOF'
worker_processes 1;
events { worker_connections 512; }
http {
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 80;
location / {
proxy_pass http://192.168.1.106:8123;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
# главное: HA не должен видеть, что запрос шёл через прокси
proxy_set_header X-Forwarded-For "";
proxy_set_header X-Real-IP "";
proxy_set_header X-Forwarded-Proto https;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}
}
}
EOF
pct exec $CT -- bash -c "head -5 /opt/ha-strip/nginx.conf" | sed 's/^/ /'
echo
echo "=== 2. СЕТЬ И ПРОСЛОЙКА ==="
pct exec $CT -- docker network create ha-sso >/dev/null 2>&1 && echo " сеть ha-sso создана"
pct exec $CT -- docker rm -f ha-strip >/dev/null 2>&1
pct exec $CT -- docker run -d --name ha-strip --restart unless-stopped \
--network ha-sso \
-v /opt/ha-strip/nginx.conf:/etc/nginx/nginx.conf:ro \
nginx:alpine >/dev/null 2>&1
sleep 5
echo " прослойка: $(pct exec $CT -- docker inspect ha-strip --format '{{.State.Status}}' 2>/dev/null)"
echo " проверка прослойки (должна отдать страницу HA):"
pct exec $CT -- docker run --rm --network ha-sso curlimages/curl:latest \
-s -o /dev/null -w ' код: %{http_code}\n' --max-time 10 http://ha-strip/ 2>&1 | tail -1
echo
echo "=== 3. ПРОКСИ — ЧЕРЕЗ ПРОСЛОЙКУ ==="
SEC=$(pct exec $CT -- docker inspect oauth2-proxy-home --format '{{range .Config.Env}}{{println .}}{{end}}' 2>/dev/null | grep '^OAUTH2_PROXY_CLIENT_SECRET=' | cut -d= -f2- | tr -d '\r')
[ -z "$SEC" ] && { echo " ❌ нет секрета клиента"; exit 1; }
COOK=$(openssl rand -hex 16)
pct exec $CT -- docker rm -f oauth2-proxy-home >/dev/null 2>&1
pct exec $CT -- docker run -d --name oauth2-proxy-home --restart unless-stopped \
--security-opt apparmor=unconfined --dns 192.168.1.107 --dns 192.168.1.1 \
--network ha-sso -p 9130:9130 \
-e OAUTH2_PROXY_PROVIDER=oidc \
-e OAUTH2_PROXY_OIDC_ISSUER_URL="https://authentik.buryans.ru/application/o/home-assistant/" \
-e OAUTH2_PROXY_CLIENT_ID=home-assistant-proxy \
-e OAUTH2_PROXY_CLIENT_SECRET="$SEC" \
-e OAUTH2_PROXY_REDIRECT_URL="https://home.buryans.ru/oauth2/callback" \
-e OAUTH2_PROXY_UPSTREAMS="http://ha-strip:80" \
-e OAUTH2_PROXY_HTTP_ADDRESS="0.0.0.0:9130" \
-e OAUTH2_PROXY_COOKIE_NAME=_oauth2_proxy_home \
-e OAUTH2_PROXY_COOKIE_SECRET="$COOK" \
-e OAUTH2_PROXY_COOKIE_SECURE=true \
-e OAUTH2_PROXY_REVERSE_PROXY=true \
-e OAUTH2_PROXY_EMAIL_DOMAINS='*' \
-e OAUTH2_PROXY_SKIP_PROVIDER_BUTTON=true \
-e OAUTH2_PROXY_PASS_USER_HEADERS=true \
-e OAUTH2_PROXY_SET_XAUTHREQUEST=true \
-e OAUTH2_PROXY_APPROVAL_PROMPT=auto \
quay.io/oauth2-proxy/oauth2-proxy:latest >/dev/null 2>&1
sleep 8
echo " прокси: $(pct exec $CT -- docker inspect oauth2-proxy-home --format '{{.State.Status}}' 2>/dev/null)"
pct exec $CT -- docker logs --tail 3 oauth2-proxy-home 2>&1 | tail -3 | sed 's/^/ /'
echo
echo "=== 4. ПРОВЕРКА СО СТОРОНЫ HA ==="
echo " журнал (не должно быть 400 и «untrusted proxy»):"
pct exec $CT -- docker logs --tail 20 homeassistant 2>&1 | grep -iE 'untrusted|forwarded' | tail -3 | sed 's/^/ /'
echo " (пусто — хорошо)"
+31
View File
@@ -0,0 +1,31 @@
#!/bin/bash
# Итоговая проверка HA после настройки
set -uo pipefail
CT=106
echo "=== 1. ЖУРНАЛ HA: нет ли 400 и «untrusted proxy» ==="
pct exec $CT -- docker logs --tail 40 homeassistant 2>&1 | grep -iE 'untrusted|forwarded|400 Bad' | tail -5 | sed 's/^/ /'
echo " (пусто = хорошо)"
echo
echo "=== 2. СПОСОБЫ ВХОДА ОТ ПРОКСИ ==="
pct exec $CT -- docker run --rm --network ha-sso curlimages/curl:latest \
-s --max-time 10 http://ha-strip/auth/providers 2>&1 | head -c 250
echo
echo
echo "=== 3. АВТО-ВХОД (без формы) ==="
pct exec $CT -- docker run --rm --network ha-sso curlimages/curl:latest \
-s -X POST --max-time 10 -H 'Content-Type: application/json' \
-d '{"client_id":"https://home.buryans.ru/","handler":["trusted_networks",null],"redirect_uri":"https://home.buryans.ru/?auth_callback=1"}' \
http://ha-strip/auth/login_flow 2>&1 | head -c 200
echo
echo
echo "=== 4. ДОМЕН ==="
echo " home.buryans.ru → $(curl -s -o /dev/null -w '%{http_code}' --max-time 15 -k https://home.buryans.ru/)"
echo " напрямую (без прокси) → $(curl -s -o /dev/null -w '%{http_code}' --max-time 10 http://192.168.1.106:8123/)"
echo
echo "=== 5. ЧТО ЗАПУЩЕНО ==="
pct exec $CT -- docker ps --format ' {{.Names}} | {{.Status}}' 2>/dev/null | grep -E 'homeassistant|ha-strip|oauth2-proxy-home'
+31
View File
@@ -0,0 +1,31 @@
# Home Assistant за единым входом (работает)
Схема: домен → `oauth2-proxy-home` (9130) → `ha-strip` → HA `:8123`.
## Почему понадобилась прослойка
В HA два запрета, и мы попадали то в один, то в другой:
1. если адрес прокси входит в `http.trusted_proxies`, HA отказывает во входе
по доверенной сети с этого адреса («Can't allow access from a proxy server»);
2. если прокси НЕ в `trusted_proxies`, но присылает `X-Forwarded-For`, HA
отвечает 400 («Received X-Forwarded-For header from an untrusted proxy»).
`oauth2-proxy` не умеет не передавать этот заголовок, поэтому между ним и HA
стоит nginx-прослойка, которая его вычищает.
## Порядок
1. `01-ha-auth-providers.sh` — `trusted_networks` (сеть Docker) → пользователь,
`allow_bypass_login`, и `trusted_proxies` только `127.0.0.1`.
2. `04-header-strip-layer.sh` — сеть `ha-sso`, прослойка `ha-strip`, пересоздание
прокси с upstream `http://ha-strip:80`.
3. `02-domain-via-proxy.sh` — домен → 9130 на двух nginx.
4. `05-verify.sh` — проверка: способы входа, авто-вход (`create_entry`), журнал.
## Важно при пересоздании прокси
Upstream должен быть `http://ha-strip:80`, а не `192.168.1.106:8123`, иначе
вернётся 400. Прокси и прослойка живут в сети `ha-sso`.
Копия конфига HA до правок: `/opt/smart-lxc/homeassistant/config.bak-sso-*`.