Генератор TOTP

Алгоритм простыми словами

TOTP - это HOTP (одноразовый пароль на основе HMAC, RFC 4226), в котором счётчик заменён текущим временем Unix, делённым на шаг времени (обычно 30 секунд):

counter = floor(unix_time / 30)
hash = HMAC-SHA1(secret, counter_as_8_byte_big_endian)
offset = last byte of hash AND 0x0F
truncated = 4 bytes from offset, with the top bit zeroed
code = truncated mod 10^digits

Ваше устройство и сервер выполняют одни и те же вычисления над одним и тем же секретом и одними и теми же часами, поэтому получают одинаковый код, который при этом никуда не передаётся. Шестизначный код - это просто усечённый HMAC по модулю 10^6. Никакой магии, только хеширование.

Типичные параметры

Если сервис отклоняет ваши коды, сначала проверьте количество цифр и период, затем алгоритм. Учтите также, что некоторые приложения-аутентификаторы молча игнорируют нестандартные параметры (Google Authenticator исторически обрабатывал всё как SHA-1, 6 цифр, 30 секунд), поэтому всегда тестируйте именно с тем приложением, которым будут пользоваться ваши пользователи.

Как безопасно хранить секреты

• Никогда не отправляйте секрет 2FA по почте или в мессенджере. Попав в чей-то ящик, он навсегда остаётся в журналах и резервных копиях провайдера.
• Подключайте 2FA сканированием QR-кода. QR-код содержит URI otpauth://totp/..., объединяющий секрет, алгоритм, количество цифр и период в один однозначный пакет.
• Делайте резервную копию при подключении. Храните коды восстановления, или сам секрет, в менеджере паролей: потеря телефона без них означает потерю доступа.
• Один секрет на сервис. Каждый сервис выдаёт собственный секрет при настройке; если какой-то из них утёк, подключите 2FA заново, чтобы старый перестал действовать.

Расхождение времени

TOTP работает только пока обе стороны согласны во времени. Эта страница вычисляет коды по часам сервера, поэтому если код здесь отличается от кода в вашем приложении-аутентификаторе, первый подозреваемый - часы устройства. Большинство проверяющих систем допускают расхождение в одно окно в каждую сторону (30-60 секунд); если разница больше, синхронизируйте часы устройства по NTP, прежде чем винить секрет.

Используйте здесь тестовые секреты

Этот инструмент вычисляет код на нашем сервере: введённый секрет передаётся по HTTPS при каждом обновлении, а при переходе между шагами инструмента появляется и в URL страницы. Для разработки, демонстраций и отладки с одноразовыми секретами это нормально. Но это не место для настоящего секрета, защищающего вашу почту или банковский счёт: ему место в отдельном приложении-аутентификаторе на телефоне. Если вы уже вставили настоящий секрет куда-то вне своего аутентификатора, подключите 2FA на том сервисе заново, чтобы секрет сменился.