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. Только потом добавляю остальных членов семьи.