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 есть гости — стоит убрать эту сеть и оставить только туннель.