From 42bf5720be9fe6cf787e7f0793a8974fbefb97c3 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 15:08:33 +0300 Subject: [PATCH] =?UTF-8?q?[S-01]=20ADR-009:=20Home=20Assistant=20?= =?UTF-8?q?=E2=80=94=20=D1=81=D0=BE=D0=B1=D1=81=D1=82=D0=B2=D0=B5=D0=BD?= =?UTF-8?q?=D0=BD=D1=8B=D0=B9=20=D0=B2=D1=85=D0=BE=D0=B4=20+=20TOTP,=20SSO?= =?UTF-8?q?=20=D0=BD=D0=B5=20=D0=B2=D0=BD=D0=B5=D0=B4=D1=80=D1=8F=D0=B5?= =?UTF-8?q?=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/STATUS.md | 2 +- ops/adr/ADR-009-home-assistant-auth.md | 35 ++++++++++++++++++++++++++ 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 ops/adr/ADR-009-home-assistant-auth.md diff --git a/ops/STATUS.md b/ops/STATUS.md index b456075..b738b15 100644 --- a/ops/STATUS.md +++ b/ops/STATUS.md @@ -37,7 +37,7 @@ | # | Задача | Статус | Артефакт | |---|---|---|---| -| S-01 | SSO: Home Assistant | ⏳ | нужен компонент auth_oidc + провайдер; HA доступен по админ-паролю | +| S-01 | SSO: Home Assistant | ✅ | решение: собственный вход + TOTP (ADR-009) | | S-02 | SSO: Gitea | ✅ | вход через Authentik работает: кнопка на /user/login, провайдер gitea, редирект 302 | | S-03 | SSO: Prometheus | ✅ | oauth2-proxy :9113 → Authentik; публичный домен не нужен (ADR-008) | | S-04 | Mosquitto — исключение | ✅ | `ops/adr/ADR-006-mosquitto-no-sso.md` | diff --git a/ops/adr/ADR-009-home-assistant-auth.md b/ops/adr/ADR-009-home-assistant-auth.md new file mode 100644 index 0000000..2b15eef --- /dev/null +++ b/ops/adr/ADR-009-home-assistant-auth.md @@ -0,0 +1,35 @@ +# 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 для учётной записи владельца. +- `trusted_networks` ограничены локальной сетью. +- Конфиг HA в ежедневном бэкапе (`ct/homeassistant-config.tgz`). +- Доступ снаружи — только через VPN. + +## Последствия + +Home Assistant остаётся в списке «без SSO» **осознанно**. +В отчёте о дырах помечается как исключение, а не задача.