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

2.2 KiB
Raw Blame History

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: доверенные сети

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:

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