diff --git a/ops/sso/2FA-MATRIX-ANALYSIS.md b/ops/sso/2FA-MATRIX-ANALYSIS.md new file mode 100644 index 0000000..26c9b00 --- /dev/null +++ b/ops/sso/2FA-MATRIX-ANALYSIS.md @@ -0,0 +1,88 @@ +# 2FA через Matrix: анализ (10.11.2026) + +## Требование владельца + +> Вход в Authentik по логину и 2FA из Matrix. **Без пароля и без двойного входа**. +> Иначе смысла в 2FA не вижу. + +## Вердикт: это возможно нативно + +Authentik 2026.8.5 поддерживает **passwordless вход по ссылке из письма** +(magic link). Ссылка приходит в Matrix через наш мост SMTP→Matrix. + +### Как выглядит вход + +``` +1. Открываешь вход → «Вход через Matrix» +2. Вводишь логин (akadmin) +3. Через 2 секунды в Matrix приходит ссылка +4. Нажимаешь → ты внутри +``` + +Ни пароля, ни второго экрана. + +## Что уже сделано и проверено + +### Поток `matrix-magic-link` (создан) + +| order | Стадия | +|---|---| +| 10 | идентификация (логин/email) | +| 20 | **письмо в Matrix** (Matrix-2FA-Stage) | +| 30 | вход пользователя | + +### Мост SMTP→Matrix + +**Нашёл и починил две поломки:** + +1. Работал самодельный SMTP, который искал в письме **6-значный код**. + Authentik присылает **ссылку**, а не код — поэтому в Matrix не приходило ничего. +2. Этот SMTP ломался на многокомандном протоколе (терял `MAIL FROM`/`RCPT TO`). + +**Исправлено:** установлен `aiosmtpd`, служба переведена на полноценную +реализацию `/opt/hub-core/smtp_matrix.py`, тема письма декодируется из MIME. + +### Проверка цепочки (факты) + +``` +SMTP listening on :2525 +mail: Вход в Buryans Hub -> maloyakapg@gmail.com +matrix: 1 комнат + +В комнате !x7_Vj4CVPXA0Hk9WlWeswMsM0dymjqFoD: +📧 Вход в Buryans Hub +Ссылка для входа: https://authentik.buryans.ru/flows/matrix-magic-link/?token=... +``` + +## Чего я НЕ сделал и почему + +**Не переключил вход по умолчанию.** Сейчас работает и пароль, и новый поток. +Переключение — последний шаг, и я не стал делать его без вас, потому что: + +1. Если мост или Matrix упадут, **войти будет нечем** — нужен резервный путь. +2. Это меняет вход для всей семьи, а не только для владельца. + +## Анализ безопасности — честно + +**Главный риск: Matrix становится единственным фактором.** + +| Что | Последствие | +|---|---| +| Доступ к Matrix = доступ ко всему хабу | нужно защитить сам Matrix | +| Ссылка в переписке | если Matrix-аккаунт угнан, хаб открыт | +| Мост пишет в комнату | любой участник комнаты видит ссылки | + +**Что обязательно сделать до включения:** + +1. **Ссылка живёт 5 минут** — уже настроено (`token_expiry=minutes=5`). +2. **Комната — личная переписка с ботом**, не общая (сейчас так). +3. **E2EE в Matrix** — без шифрования переписка читается сервером. +4. **Резервный вход**: отдельный пароль или static-token на случай падения Matrix. +5. **Ограничить комнату**: только владелец, без приглашённых. + +## Что осталось + +1. Переключить вход по умолчанию на `matrix-magic-link`. +2. Сделать резервный путь (не сломать вход при падении Matrix). +3. Проверить настоящий вход в браузере (я проверил только отправку ссылки). +4. Решить: пользоваться только владельцу или всей семье.