Когда пользователь говорит «код пришёл через пять минут», не увеличивайте таймер вслепую. Найдите provider message ID и постройте линию времени. Если запрос две минуты лежал в вашей очереди — виноват не оператор. Если провайдер быстро поставил статус `sent`, но `delivered` появился позже, задержка уже после передачи сообщения дальше.
Статус `sent` не означает, что телефон показал SMS: у провайдера он обычно фиксирует передачу вышестоящему оператору. Для точного вывода нужны delivery receipts, а их доступность и смысл зависят от канала и страны.
Пять временных меток вместо одного таймера
| Метка | Кто ставит | Что показывает |
|---|---|---|
| challenge_created_at | ваше приложение | с какого момента код действителен |
| provider_requested_at | ваш sender | когда запрос ушёл наружу |
| queued_at | провайдер | принят в очередь |
| sent_at | провайдер | передан следующему участнику |
| delivered_at | delivery receipt | подтверждена доставка, если поддерживается |
Все метки храните в UTC, а в интерфейсе переводите для человека. Рядом нужны challenge id, provider message id, channel и обезличенный destination hash. Сам код и полный телефон в диагностический лог не записывают.
Срок жизни относится к challenge, а не к SMS
Одноразовый код — это серверный challenge. Его срок действия начинается по вашему правилу, обычно при создании или выдаче, и проверяется на сервере. Начинать TTL с неизвестного момента доставки нельзя: callback может опоздать, не прийти или быть недоступен. Увеличение TTL повышает окно для перебора и не устраняет очередь.
challenge: id, user_key, code_hash, created_at, expires_at, attempts, state
message: provider_id, challenge_id, queued_at, sent_at, delivered_at, status
verify only when:
challenge.state = 'active'
now < expires_at
attempts < policy_limitПовторная отправка не должна оживлять старый код
Выберите понятную модель. Самая простая: новый запрос закрывает прежний challenge, а принимается только последний код. Если бизнес требует один и тот же код в нескольких сообщениях, сохраняйте один challenge и не продлевайте `expires_at` каждым нажатием. Иначе злоумышленник сможет удерживать код активным повторными отправками.
- Показать cooldown до новой отправки и не запускать параллельные сообщения.
- После resend сообщить, что прежний код больше не действует, если это ваша модель.
- Ограничить запросы по аккаунту, сессии и доверенному сетевому сигналу.
- Ограничить число попыток проверки отдельно от числа отправок.
- Не раскрывать, существует ли аккаунт, разными ответами endpoint.
Статусы превращаются в разные действия поддержки
| Наблюдение | Вероятный участок | Действие |
|---|---|---|
| created → requested долго | внутренняя очередь | проверить worker и retry |
| queued долго | очередь провайдера | метрики маршрута/лимита |
| sent без delivered | оператор/устройство | другой канал по политике |
| undelivered/failed | ошибка адреса или маршрута | показать безопасный вариант |
| delivered быстро, увидел поздно | устройство/UX | не обещать точное SMS-время |
Outbound status callbacks обрабатывайте идемпотентно и проверяйте подлинность запроса способом, который документирует ваш провайдер. Callback может прийти повторно или позже, чем пользователь уже завершил вход; он обновляет телеметрию, но не должен снова активировать закрытый challenge.
Интерфейс не обещает невозможного
После нажатия пишите «запрос принят», а не «код доставлен». Покажите маскированный адрес, оставшееся время challenge и понятный момент доступности resend. После устойчивой ошибки предложите резервный подтверждённый канал — например, authenticator или recovery flow — вместо бесконечной серии SMS.
Контрольный тест искусственно задерживает каждый участок
- Создать challenge и задержать внутренний sender на минуту.
- Убедиться, что метрика показывает задержку до provider request.
- Отправить два запроса и проверить политику старого кода.
- Подать повторный и переставленный callback одного message id.
- Проверить отказ после expires_at и лимита попыток.
- Смоделировать failed/undelivered и переход к резервному каналу.
Проблема решена, когда для каждого медленного сообщения виден участок задержки, старый OTP не принимается вопреки политике, а повторные callbacks не меняют результат входа. Для анализа нужны challenge id, message id, статусы и метки времени — коды, tokens и полный номер телефона не нужны.