# 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, не требует браузера и кода. ## Аппаратный ключ (YubiKey / FIDO2) — лучший вариант Ключ снимает проблему целиком: он **физический**, код никуда не приходит, работает без сети и без Matrix. | Свойство | TOTP-приложение | YubiKey | |---|---|---| | Нужен телефон | да | нет | | Работает без сети | да | да | | Не фишируется | нет | **да** (проверяет домен) | | Вход «касанием» | нет | **да** | | Цена | 0 | ~5–6 тыс. ₽ | | Потеря | восстановить по секрету | нужен второй ключ или коды | ### Схема с ключом 1. **Основной ключ** — вход касанием. 2. **Запасной ключ** — лежит дома (обязательно, если ключ один — потеря = проблема). 3. **Резервные коды** — 10 штук на бумаге. 4. TOTP/Matrix — не нужны, но остаются как резерв для семьи. ### Что нужно от вас Купить один или два ключа (любой FIDO2: YubiKey 5, Token2, SoloKeys). Двух достаточно на всю семью, если хранить запасной в сейфе. ### Что уже готово - MFA-стадия принимает `totp` **и** `webauthn`, `not_configured_action=skip` — значит включение никого не запрёт. - Стадия настройки ключа: `default-authenticator-webauthn-setup`. - `mfa-off` и LAN-bypass на месте. ## Что сделано сейчас - 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. Только потом добавляю остальных членов семьи. ## Решение владельца (21.10.2026) 2FA отложена. Вход остаётся по паролю, MFA-привязок в потоке **0**. Важно, что выяснилось при попытке включить: - у пользователя `roman` **нет TOTP-устройства** — включение MFA мгновенно заперло бы вход; - резервные коды через API не создаются (эндпоинт отвечает пусто); - проверка входа автоматически не удалась — только браузером. Поэтому порядок при возврате к теме строго такой: 1. сгенерировать секрет и **зарегистрировать TOTP в приложении** (браузер); 2. выдать 10 резервных кодов; 3. только после этого включать привязку MFA; 4. проверить вход в приватном окне; 5. держать `mfa-off` под рукой.