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