Files
buryan-infra/ops/adr/ADR-010-passwordless-2fa.md
T

1.8 KiB
Raw Blame History

ADR-010. Вход по 2FA без пароля

Дата: 21.10.2026 · Статус: принято

Задача

Владелец ожидал, что двухфакторный код будет основным входом, а не вторым шагом после пароля.

Решение

Порядок шагов в default-authentication-flow:

Порядок Stage Условие
10 Identification всегда
20 MFA validation (TOTP) если у пользователя есть TOTP
30 Password пропускается, если TOTP есть
100 User login всегда

Политика has-totp-device (expression, negate=true) висит на шаге пароля: есть TOTP → пароль не спрашиваем; нет TOTP → спрашиваем как раньше.

not_configured_action=skip у MFA-стадии: у кого TOTP нет — сразу к паролю.

Что получилось

  • С TOTP: только код (без пароля).
  • Без TOTP: пароль, как раньше (никого не заблокировали).

Риск и откат

  • Потеря TOTP-устройства = потеря входа. Резерв: recovery-коды Authentik и доступ к админке по API-токену.
  • Откат: удалить policy binding на шаге пароля, вернуть порядок identification → password → mfa → login.

Проверка

Структура потока проверена через API (/flows/executor/ отдаёт ak-stage-identification, порядок bindings подтверждён). Реальный вход нужно проверить в браузере — пароль владельца мне неизвестен.