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

36 lines
1.8 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.
# 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» **осознанно**.
В отчёте о дырах помечается как исключение, а не задача.