TOTP-код не нужно переводить из часового пояса пользователя в часовой пояс сервера. По RFC 6238 временной счётчик строится из Unix time, начальной эпохи и длины шага. Если после перелёта код перестал приниматься, сначала сравните фактическое время телефона и сервера, а затем параметры генератора. Настройка вида `Europe/Moscow` или `Asia/Tbilisi` в профиле на вычисление TOTP влиять не должна.
Для одной отказавшей попытки запишите время приёма в UTC, отклонение часов сервера от источника синхронизации, выбранный step, алгоритм и допустимое окно. Сам код и секрет в журнал не попадают. Результат должен ответить на простой вопрос: сервер проверял тот же временной интервал, который использовал authenticator, или причина находится в другом enrollment.
Вычисление опирается на номер шага, а не на локальные часы
В стандартной схеме `T = floor((Current Unix time - T0) / X)`. Значение `X` по умолчанию равно 30 секундам, однако клиент и сервер обязаны использовать одинаковый параметр. Часовой пояс участвует только в отображении даты человеку; Unix timestamp одной и той же секунды одинаков в любой стране.
server_unix=1791397205
T0=0
step=30
server_counter=floor((1791397205-0)/30)=59713240
client_unix=1791397141
client_counter=59713238
delta_steps=-2 # часы клиента отстают примерно на 64 секунды| Наблюдение | Вероятная причина | Следующая проверка |
|---|---|---|
| ошибка появилась после ручной смены даты | автоматическое время выключено | сравнить UTC телефона с надёжным источником |
| не работает у всех | время сервера или параметры verifier | NTP, step, digits, algorithm, T0 |
| не работает только один token | старый или другой secret | перепривязка устройства после подтверждения личности |
| принимается соседний код | небольшой clock skew | измерить delta и проверить синхронизацию |
| часовой пояс меняет результат в коде | ошибочная конвертация local datetime | использовать Unix time напрямую |
Проверка начинается с двух часов и одной попытки
- Зафиксировать серверное время UTC и состояние службы синхронизации в момент отказа.
- На телефоне включить автоматические дату, время и часовой пояс, затем сравнить секунды.
- Сгенерировать один новый код после начала следующего временного шага.
- В диагностическом режиме вычислить номера шагов клиента и сервера без вывода secret.
- Если шаг совпал, перейти к digits, hash algorithm и записи enrollment, не расширяя окно вслепую.
Скриншот настенных часов не подходит: нужна точность до секунд и UTC. На сервере проверяют не только вывод команды времени, но и состояние синхронизации. В контейнере обычно используется время хоста, поэтому расхождение ищут на узле, а не пытаются установить отдельную timezone внутри каждого контейнера.
Параметры enrollment должны переживать перенос между сервисами
QR-код связывает authenticator с секретом и параметрами. После миграции 2FA легко оставить в базе секрет, но изменить число цифр, алгоритм или step. Сравните сохранённые значения с теми, которые использовал прежний verifier. Если продукт поддерживает несколько политик, храните версию enrollment рядом с записью устройства, а не определяйте её по дате регистрации.
- Не печатать otpauth URI, QR-код и secret в application log.
- Не переносить secret через клиент после завершения enrollment.
- Не менять параметры для существующих устройств без явной миграции.
- После перепривязки отозвать старую запись и выдать новые recovery codes.
Окно допуска компенсирует сеть, но не лечит часы
RFC допускает ограниченное окно вокруг текущего шага и описывает повторную синхронизацию, однако большое окно увеличивает число кодов, которые сервер примет одновременно. Выберите минимальный диапазон, подтверждённый измерением, и ограничьте число попыток. Если отклонение постоянно растёт, исправляют системные часы; если оно стабильно велико только на одном устройстве, пользователю возвращают понятную инструкцию по автоматической синхронизации.
Успешный код нельзя принимать повторно в том же контексте только потому, что он всё ещё попадает в окно. Для чувствительной операции сервер фиксирует использованный временной шаг или применяет другой механизм защиты от повторной отправки. Rate limit и блокировка перебора работают независимо от допуска по времени.
Исправление проверяется переходом через границу шага
Контрольный тест проводят до и после смены 30-секундного интервала, на телефоне с автоматическим временем и на намеренно смещённом тестовом устройстве. Корректная система принимает код в заявленном окне, отклоняет повтор и не меняет результат после выбора другой зоны отображения. Отдельно проверяют восстановление через recovery code, чтобы ремонт TOTP не заблокировал владельца аккаунта.
Для разбора достаточно версии authenticator, обезличенного device record, параметров TOTP, времени UTC и величины clock skew. Секрет, QR и действующий код не передаются. Такой набор позволяет отличить рассинхрон часов от неверной миграции enrollment без ослабления всей двухфакторной защиты.