From bf02f969e099d2d2679dc447ec4a2e89d59ab087 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 10 Nov 2026 18:19:06 +0300 Subject: [PATCH] =?UTF-8?q?[HOME]=20Home=20Assistant=20=D0=B7=D0=B0=20SSO:?= =?UTF-8?q?=20auth=5Frequest=20+=20error=5Fpage=20=D0=B2=20nginx=20(=D1=85?= =?UTF-8?q?=D0=BE=D1=81=D1=82=20=D0=B8=20VPS),=20=D0=B2=20HA=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=B4=D0=BE?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=D0=B5=D0=BD=D0=BD=D1=8B=D0=B5=20=D1=81=D0=B5?= =?UTF-8?q?=D1=82=D0=B8=2010.88.0.0/24=20=D0=B8=20192.168.1.0/24=20=D1=81?= =?UTF-8?q?=20allow=5Fbypass=5Flogin.=20=D0=9F=D1=80=D0=BE=D0=B2=D0=B5?= =?UTF-8?q?=D1=80=D0=B5=D0=BD=D0=BE:=20home=20=D1=80=D0=B5=D0=B4=D0=B8?= =?UTF-8?q?=D1=80=D0=B5=D0=BA=D1=82=D0=B8=D1=82=20=D0=BD=D0=B0=20Authentik?= =?UTF-8?q?,=20HA=20=D0=BF=D1=83=D1=81=D0=BA=D0=B0=D0=B5=D1=82=20=D0=B1?= =?UTF-8?q?=D0=B5=D0=B7=20=D0=B2=D1=82=D0=BE=D1=80=D0=BE=D0=B3=D0=BE=20?= =?UTF-8?q?=D0=BB=D0=BE=D0=B3=D0=B8=D0=BD=D0=B0=20=D1=81=20=D0=BE=D0=B1?= =?UTF-8?q?=D0=BE=D0=B8=D1=85=20=D0=BF=D1=83=D1=82=D0=B5=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/home/HA-SSO.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 ops/home/HA-SSO.md diff --git a/ops/home/HA-SSO.md b/ops/home/HA-SSO.md new file mode 100644 index 0000000..4748d83 --- /dev/null +++ b/ops/home/HA-SSO.md @@ -0,0 +1,64 @@ +# Home Assistant: SSO включён (10.11.2026) + +## Задача + +`https://home.buryans.ru` работал без SSO: доступ был, но вход — только +собственный у HA. + +## Что уже было готово + +* `oauth2-proxy-home` на CT106:9130, режим `static://202` (только авторизация), + `SET_XAUTHREQUEST=true`, redirect `https://home.buryans.ru/oauth2/callback`; +* в HA уже был `auth_providers: trusted_networks` с `allow_bypass_login: true` + и одной сетью `172.19.0.0/16` (docker). + +## Что добавлено + +### HA: доверенные сети + +```yaml +auth_providers: + - type: trusted_networks + trusted_networks: + - 172.19.0.0/16 + - 10.88.0.0/24 # VPS через туннель + - 192.168.1.0/24 # хост-nginx + trusted_users: + 172.19.0.0/16: 217134ec… + 10.88.0.0/24: 217134ec… + 192.168.1.0/24: 217134ec… + allow_bypass_login: true +``` + +### nginx (хост и VPS) + +В `location /` блока `home.buryans.ru`: + +```nginx +auth_request /oauth2/auth; +error_page 401 = /oauth2/sign_in; +``` + +## Проверка + +``` +redirect на Authentik: client_id=home-assistant-proxy, + redirect_uri=https://home.buryans.ru/oauth2/callback, scope=openid email profile +/oauth2/sign_in → 302 +HA с хоста (192.168.1.0/24) → 200 без логина HA +HA с VPS (10.88.0.0/24) → 200 без логина HA +https://home.buryans.ru/ → 302 на Authentik +``` + +Итог: один вход — Authentik. HA не спрашивает пароль второй раз. + +## Ловушка + +`auth_request` возвращает 401, и без `error_page 401 = /oauth2/sign_in;` +пользователь получает пустую 401-страницу вместо входа. Оба директивы нужны вместе. + +## Внимание (безопасность) + +`trusted_networks` с `192.168.1.0/24` означает: **любое устройство в локальной +сети** входит в HA без пароля. Это стандартная схема для HA за прокси, но +если в LAN есть гости — стоит убрать эту сеть и оставить только туннель.