6.5 KiB
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 на неё не влияет.
Порядок:
- Ставите Element на новое устройство.
- Входите логином/паролем Matrix (не SSO).
- Получаете доступ к комнате, куда падают коды.
- Дальше — обычный вход в сервисы через 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 тыс. ₽ |
| Потеря | восстановить по секрету | нужен второй ключ или коды |
Схема с ключом
- Основной ключ — вход касанием.
- Запасной ключ — лежит дома (обязательно, если ключ один — потеря = проблема).
- Резервные коды — 10 штук на бумаге.
- 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 правильно (следующий заход)
- Вы регистрируете TOTP в приложении (я дам QR/секрет).
- Я включаю привязку только для вашего пользователя.
- Вы проверяете вход в браузере в приватном окне.
- Если что —
mfa-off, 5 секунд. - После успеха — выдаю 10 резервных кодов.
- Только потом добавляю остальных членов семьи.
Решение владельца (21.10.2026)
2FA отложена. Вход остаётся по паролю, MFA-привязок в потоке 0.
Важно, что выяснилось при попытке включить:
- у пользователя
romanнет TOTP-устройства — включение MFA мгновенно заперло бы вход; - резервные коды через API не создаются (эндпоинт отвечает пусто);
- проверка входа автоматически не удалась — только браузером.
Поэтому порядок при возврате к теме строго такой:
- сгенерировать секрет и зарегистрировать TOTP в приложении (браузер);
- выдать 10 резервных кодов;
- только после этого включать привязку MFA;
- проверить вход в приватном окне;
- держать
mfa-offпод рукой.