[HOME] Home Assistant за SSO: auth_request + error_page в nginx (хост и VPS), в HA добавлены доверенные сети 10.88.0.0/24 и 192.168.1.0/24 с allow_bypass_login. Проверено: home редиректит на Authentik, HA пускает без второго логина с обоих путей

This commit is contained in:
root committed 2026-11-10 18:19:06 +03:00
1 parent 40a24864d3
commit bf02f969e0
1 file changed
+64
+64
View File
@@ -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 есть гости — стоит убрать эту сеть и оставить только туннель.