Files
buryan-infra/ops/adr/ADR-009-home-assistant-auth.md
T

1.8 KiB
Raw Blame History

ADR-009. Home Assistant: собственный вход, без SSO

Дата: 21.10.2026 · Статус: принято

Контекст

Home Assistant — единственный сервис, куда нет единого входа. Варианты: компонент auth_oidc (сторонний, ставится в custom_components) или oauth2-proxy перед home.buryans.ru.

Решение

Оставляем собственный вход Home Assistant и включаем встроенный TOTP. SSO через Authentik не внедряем.

Почему

  1. Мобильное приложение HA ходит в API напрямую по токенам — прокси перед сервисом ломает авторизацию и push-уведомления.
  2. auth_oidc — сторонний компонент, обновляется отдельно от HA; при мажорном обновлении HA есть риск потерять вход в дом.
  3. У HA есть встроенный TOTP — второй фактор закрывается штатно.
  4. HA не публикуется в интернет: доступ через VPN/LAN.

Компенсирующие меры

  • TOTP не включаем: владелец решил, что не нужен (21.10).
  • trusted_networks ограничены локальной сетью.
  • Конфиг HA в ежедневном бэкапе (ct/homeassistant-config.tgz).
  • Доступ снаружи — только через VPN.

Последствия

Home Assistant остаётся в списке «без SSO» осознанно. В отчёте о дырах помечается как исключение, а не задача.