From 8a9b89d36c16444e95c72486140d7c9015ecfdf2 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 19:19:16 +0300 Subject: [PATCH] =?UTF-8?q?[S-10]=202FA:=20=D1=81=D1=85=D0=B5=D0=BC=D0=B0?= =?UTF-8?q?=20=D0=B1=D0=B5=D0=B7=20=D0=B7=D0=B0=D0=BF=D0=B8=D1=80=D0=B0?= =?UTF-8?q?=D0=BD=D0=B8=D1=8F,=20LAN-bypass,=20break-glass;=20=D0=B2=D0=BA?= =?UTF-8?q?=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=BE=D1=82=D0=BB?= =?UTF-8?q?=D0=BE=D0=B6=D0=B5=D0=BD=D0=BE=20=D0=B4=D0=BE=20=D0=BF=D1=80?= =?UTF-8?q?=D0=BE=D0=B2=D0=B5=D1=80=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/STATUS.md | 2 +- ops/auth/2FA-DESIGN.md | 72 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+), 1 deletion(-) create mode 100644 ops/auth/2FA-DESIGN.md diff --git a/ops/STATUS.md b/ops/STATUS.md index ea60452..e35026d 100644 --- a/ops/STATUS.md +++ b/ops/STATUS.md @@ -53,7 +53,7 @@ | S-06 | Ссылка на статус в карточках | ✅ | `ops/services/cards/` | | S-07 | Закрыть сервисы без бэкапа | ✅ | 46 конфигураций в `/mnt/backups/configs` | -| S-10 | Настроить 2FA заново (TOTP или код в Matrix) | ⏳ | следующий спринт; сейчас отключена (`ops/auth/2FA-TEMP-OFF.md`) | +| S-10 | 2FA | 🔄 | схема готова (`ops/auth/2FA-DESIGN.md`), LAN-bypass + `mfa-off`, TOTP включаем с проверкой в браузере | | S-11 | Vikunja: задачи и дела | ✅ | https://vikunja.buryans.ru, OIDC, бэкап | | S-12 | Mealie → Grocy: рецепт в покупки | ✅ | `!рецепт`, `ops/home/MEALIE-GROCY.md` | | S-13 | Paperless → Firefly | ✅ | `finance_receipts.py` 09:15: сумма из чека → CSV (`455.40` проверено); импорт в Firefly — кнопкой | diff --git a/ops/auth/2FA-DESIGN.md b/ops/auth/2FA-DESIGN.md new file mode 100644 index 0000000..2520b2a --- /dev/null +++ b/ops/auth/2FA-DESIGN.md @@ -0,0 +1,72 @@ +# 2FA: как не запереть себя снаружи + +## Ловушка, которую вы заметили + +Код приходит в Matrix. Но чтобы прочитать Matrix, нужно уже быть в него +залогиненным. На новом устройстве код получить негде — круг замкнулся. + +Это реальная проблема, а не мелочь. Решается она не «умным» кодом, +а **порядком факторов**. + +## Правильный порядок + +| Очередь | Фактор | Работает если | +|---|---|---| +| 1 | **TOTP-приложение** (Aegis, Google Authenticator) | нет сети, нет Matrix, новый телефон | +| 2 | **Код на почту** (Gmail) | телефон потерян, приложение не настроено | +| 3 | **Копия в Matrix** | удобно, но никогда не единственный канал | +| 4 | **Резервные коды** (10 штук, распечатать) | всё остальное недоступно | +| 5 | **Break-glass** `/usr/local/bin/mfa-off` | админский доступ к серверу | + +**Matrix — только удобная копия.** Основной фактор — TOTP-приложение: +оно не зависит ни от сети, ни от Matrix. + +## Вход в Matrix с нуля + +Matrix (Synapse) — **отдельная система**, не через Authentik. +У неё свой пароль, и 2FA Authentik на неё не влияет. + +Порядок: + +1. Ставите Element на новое устройство. +2. Входите логином/паролем Matrix (не SSO). +3. Получаете доступ к комнате, куда падают коды. +4. Дальше — обычный вход в сервисы через Authentik. + +То есть Matrix — это **первый** аккаунт, который нужно помнить. +Пароль Matrix стоит хранить в менеджере паролей отдельно. + +## Домашняя сеть — без кода + +Политика `lan-bypass-mfa` уже создана: для адресов `192.168.1.0/24` +второй фактор не спрашивается. Дома вход всегда простой. + +Проверка выполняется по `REMOTE_ADDR` в запросе. + +## Break-glass + +``` +/usr/local/bin/mfa-off +``` + +Удаляет привязку MFA из потока входа. Работает с сервера по SSH, +не требует браузера и кода. + +## Что сделано сейчас + +- MFA-привязка **снята**: вход снова простой (проверено: vikunja 200, + homebox 200, authentik 302). +- Политика `lan-bypass-mfa` создана и готова. +- Скрипт `mfa-off` создан. +- Попытка включить TOTP-валидацию откачена: проверить вход + end-to-end автоматически не удалось, а оставлять недопроверенную + блокировку входа — недопустимо. + +## Как включать 2FA правильно (следующий заход) + +1. Вы регистрируете TOTP в приложении (я дам QR/секрет). +2. Я включаю привязку **только для вашего пользователя**. +3. Вы проверяете вход в браузере в приватном окне. +4. Если что — `mfa-off`, 5 секунд. +5. После успеха — выдаю 10 резервных кодов. +6. Только потом добавляю остальных членов семьи.