diff --git a/docs/HOME-ASSISTANT-SSO-DONE.md b/docs/HOME-ASSISTANT-SSO-DONE.md new file mode 100644 index 0000000..3facdba --- /dev/null +++ b/docs/HOME-ASSISTANT-SSO-DONE.md @@ -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/` | diff --git a/ops/sso/2026-10-19-ha-sso/00-diagnose-code.sh b/ops/sso/2026-10-19-ha-sso/00-diagnose-code.sh new file mode 100644 index 0000000..aca4d25 --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/00-diagnose-code.sh @@ -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/^/ /' diff --git a/ops/sso/2026-10-19-ha-sso/01-ha-auth-providers.sh b/ops/sso/2026-10-19-ha-sso/01-ha-auth-providers.sh new file mode 100644 index 0000000..03efbc6 --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/01-ha-auth-providers.sh @@ -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 - <&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 diff --git a/ops/sso/2026-10-19-ha-sso/02-domain-via-proxy.sh b/ops/sso/2026-10-19-ha-sso/02-domain-via-proxy.sh new file mode 100644 index 0000000..27f255b --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/02-domain-via-proxy.sh @@ -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 - <&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/^/ /' diff --git a/ops/sso/2026-10-19-ha-sso/03-check-proxy-forwarded-options.sh b/ops/sso/2026-10-19-ha-sso/03-check-proxy-forwarded-options.sh new file mode 100644 index 0000000..0cd69cf --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/03-check-proxy-forwarded-options.sh @@ -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/^/ /' diff --git a/ops/sso/2026-10-19-ha-sso/04-header-strip-layer.sh b/ops/sso/2026-10-19-ha-sso/04-header-strip-layer.sh new file mode 100644 index 0000000..1f33e0f --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/04-header-strip-layer.sh @@ -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 " (пусто — хорошо)" diff --git a/ops/sso/2026-10-19-ha-sso/05-verify.sh b/ops/sso/2026-10-19-ha-sso/05-verify.sh new file mode 100644 index 0000000..a04d6d0 --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/05-verify.sh @@ -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' diff --git a/ops/sso/2026-10-19-ha-sso/README.md b/ops/sso/2026-10-19-ha-sso/README.md new file mode 100644 index 0000000..daa21c8 --- /dev/null +++ b/ops/sso/2026-10-19-ha-sso/README.md @@ -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-*`.