From bb5a7e0520840aedd51dfa0a4fcde5f7a61862de Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 10 Nov 2026 15:24:34 +0300 Subject: [PATCH] =?UTF-8?q?[SSO]=202FA=20=D1=87=D0=B5=D1=80=D0=B5=D0=B7=20?= =?UTF-8?q?Matrix:=20=D0=B0=D0=BD=D0=B0=D0=BB=D0=B8=D0=B7=20=D0=B8=20?= =?UTF-8?q?=D1=80=D0=B0=D0=B1=D0=BE=D1=87=D0=B8=D0=B9=20=D0=BF=D1=80=D0=BE?= =?UTF-8?q?=D1=82=D0=BE=D1=82=D0=B8=D0=BF.=20=D0=9F=D0=BE=D1=82=D0=BE?= =?UTF-8?q?=D0=BA=20matrix-magic-link=20(=D0=BB=D0=BE=D0=B3=D0=B8=D0=BD=20?= =?UTF-8?q?=E2=86=92=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B0=20=D0=B2=20Mat?= =?UTF-8?q?rix=20=E2=86=92=20=D0=B2=D1=85=D0=BE=D0=B4,=20=D0=B1=D0=B5?= =?UTF-8?q?=D0=B7=20=D0=BF=D0=B0=D1=80=D0=BE=D0=BB=D1=8F)=20=D1=81=D0=BE?= =?UTF-8?q?=D0=B7=D0=B4=D0=B0=D0=BD=20=D0=B2=20Authentik,=20=D0=BC=D0=BE?= =?UTF-8?q?=D1=81=D1=82=20SMTP=E2=86=92Matrix=20=D0=B8=D1=81=D0=BF=D1=80?= =?UTF-8?q?=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD:=20=D0=B8=D1=81=D0=BA=D0=B0?= =?UTF-8?q?=D0=BB=206-=D0=B7=D0=BD=D0=B0=D1=87=D0=BD=D1=8B=D0=B9=20=D0=BA?= =?UTF-8?q?=D0=BE=D0=B4=20=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20=D1=81?= =?UTF-8?q?=D1=81=D1=8B=D0=BB=D0=BA=D0=B8,=20=D0=BB=D0=BE=D0=BC=D0=B0?= =?UTF-8?q?=D0=BB=D1=81=D1=8F=20=D0=BD=D0=B0=20=D0=BF=D1=80=D0=BE=D1=82?= =?UTF-8?q?=D0=BE=D0=BA=D0=BE=D0=BB=D0=B5.=20=D0=A6=D0=B5=D0=BF=D0=BE?= =?UTF-8?q?=D1=87=D0=BA=D0=B0=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=B5?= =?UTF-8?q?=D0=BD=D0=B0:=20=D0=BF=D0=B8=D1=81=D1=8C=D0=BC=D0=BE=20=D0=B4?= =?UTF-8?q?=D0=BE=D1=85=D0=BE=D0=B4=D0=B8=D1=82=20=D0=B2=20=D0=BB=D0=B8?= =?UTF-8?q?=D1=87=D0=BD=D1=83=D1=8E=20=D0=BA=D0=BE=D0=BC=D0=BD=D0=B0=D1=82?= =?UTF-8?q?=D1=83=20=D1=81=D0=BE=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=BE?= =?UTF-8?q?=D0=B9.=20=D0=9F=D0=B5=D1=80=D0=B5=D0=BA=D0=BB=D1=8E=D1=87?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=BF=D0=BE=20=D1=83=D0=BC=D0=BE?= =?UTF-8?q?=D0=BB=D1=87=D0=B0=D0=BD=D0=B8=D1=8E=20=D0=9D=D0=95=20=D1=81?= =?UTF-8?q?=D0=B4=D0=B5=D0=BB=D0=B0=D0=BD=D0=BE=20=E2=80=94=20=D0=BD=D1=83?= =?UTF-8?q?=D0=B6=D0=B5=D0=BD=20=D1=80=D0=B5=D0=B7=D0=B5=D1=80=D0=B2=D0=BD?= =?UTF-8?q?=D1=8B=D0=B9=20=D0=B2=D1=85=D0=BE=D0=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/sso/2FA-MATRIX-ANALYSIS.md | 88 ++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 ops/sso/2FA-MATRIX-ANALYSIS.md 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. Решить: пользоваться только владельцу или всей семье.