Files
buryan-infra/ops/home/HA-SSO.md
T

65 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 есть гости — стоит убрать эту сеть и оставить только туннель.