Если вы хотите включить двухфакторную аутентификацию во многих сервисах, вам предложат установить Google Authenticator, Microsoft Authenticator или похожее приложение. Оно показывает шестизначный код, который обновляется каждые 30 секунд и правильно работает, даже если телефон не подключён к интернету. Многим это кажется магией: как сайт и телефон знают один и тот же код, если они не общаются друг с другом? Ответ кроется в открытом стандарте TOTP, и понимание его принципа помогает правильно пользоваться приложением.
Общий секрет и время: две опоры TOTP
TOTP (Time-based One-Time Password) описан в стандарте RFC 6238 и основан на более раннем алгоритме HOTP (RFC 4226). Когда вы включаете двухфакторную аутентификацию, сайт создаёт случайный секретный ключ и показывает его в виде QR-кода. Приложение сканирует код и сохраняет секрет на телефоне, а сайт хранит свою копию на сервере. После этого стороны больше никогда не обращаются друг к другу: каждая делит текущее время на 30-секундные отрезки, пропускает номер отрезка вместе с секретом через функцию HMAC и извлекает из результата шестизначное число. Секрет и время одинаковые, поэтому и код получается одинаковым.
Внутри QR-кода на самом деле записана обычная текстовая ссылка. Она содержит имя аккаунта, название сервиса, секретный ключ и параметры алгоритма:
otpauth://totp/Misol:ali@misol.uz?secret=JBSWY3DPEHPK3PXP&issuer=Misol&algorithm=SHA1&digits=6&period=30
Значение secret здесь — это сам секрет в формате Base32. Поэтому никому не показывайте QR-код и не храните его скриншот в облачной галерее: тот, у кого есть эта строка, сможет генерировать ваши коды.
Алгоритм в нескольких строках кода
Чтобы увидеть, как TOTP работает изнутри, его можно написать на Python без библиотек. Функция ниже вычисляет код для текущего времени, и при правильном времени на обоих устройствах он совпадёт с кодом в приложении-аутентификаторе:
import base64, hashlib, hmac, struct, time
def totp(secret_b32, step=30, digits=6):
key = base64.b32decode(secret_b32.upper() + '=' * (-len(secret_b32) % 8))
counter = int(time.time()) // step
h = hmac.new(key, struct.pack('>Q', counter), hashlib.sha1).digest()
offset = h[-1] & 0x0F
code = (struct.unpack('>I', h[offset:offset + 4])[0] & 0x7FFFFFFF) % 10 ** digits
return str(code).zfill(digits)
print(totp('JBSWY3DPEHPK3PXP'))
Как видно, в алгоритме нет сетевых запросов или секретного сервера, только секрет, часы и криптографический хеш. На Linux-сервере тот же код можно получить готовой командой, это удобно для проверки своих скриптов:
# Linux: получить текущий код в терминале (пакет oathtool)
oathtool --totp -b JBSWY3DPEHPK3PXP
# Проверить синхронизацию времени на сервере
timedatectl status
Почему так важна точность времени
Поскольку TOTP полностью опирается на часы, если время на телефоне или сервере сбилось на минуту-другую, коды перестают совпадать, и пользователь видит «неверный код». Поэтому серверы обычно принимают и код на шаг раньше и на шаг позже, то есть допускают расхождение примерно в 30 секунд. На телефоне должна быть включена автоматическая настройка времени, а на сервере должна работать синхронизация NTP. Если коды постоянно отклоняются, первым делом проверьте время и часовой пояс на устройстве.
От чего TOTP защищает, а от чего нет
Главное преимущество TOTP перед SMS в том, что код создаётся внутри телефона и не передаётся через мобильную сеть. Поэтому подмена SIM-карты или перехват SMS на TOTP не влияют. Код работает и без интернета, что удобно за границей или в местах с плохой связью. Но от фишинга TOTP не защищает: если вы введёте пароль и текущий код на поддельном сайте, злоумышленник сразу использует их на настоящем, ведь код действует 30 секунд. Полную защиту от этого даёт только passkey, привязанный к домену.
Правильное подключение и резервные коды
При включении двухфакторной аутентификации многие пропускают важный шаг — сохранение резервных кодов. Обычно сайт вместе с QR-кодом выдаёт список одноразовых резервных кодов. Распечатайте их и храните в надёжном месте или запишите в менеджер паролей. Если телефон потеряется, сломается или приложение удалится, именно эти коды могут оказаться единственным способом вернуть доступ.
- Выбор приложения. Google Authenticator теперь умеет синхронизировать коды через аккаунт Google, у Microsoft Authenticator есть своя функция резервного копирования, а открытое приложение Aegis для Android поддерживает зашифрованный экспорт.
- Смена телефона. Перед очисткой старого телефона перенесите аккаунты на новое устройство и проверьте, что можете войти в каждый сервис с нового телефона.
- Второе устройство. Для важных аккаунтов QR-код при подключении можно отсканировать сразу на двух устройствах, например на рабочем телефоне и планшете.
Пример: веб-студия в Ташкенте
Небольшая веб-студия в Яккасарае поддерживает WordPress-сайты более чем десяти клиентов. У каждого сайта есть админ-панель, управление доменом и хостингом, почта и репозиторий кода, и для всего этого отдельные аккаунты. Однажды выяснилось, что пароль от рабочей почты одного из разработчиков попал в утёкшую базу. После этого студия сделала TOTP обязательным во всех аккаунтах, установила на WordPress-сайты плагин двухфакторной аутентификации и стала хранить резервные коды в отдельном разделе командного менеджера паролей с ограниченным доступом. Когда сотрудник уходит, записи TOTP на его устройствах больше ничего не значат, потому что студия переподключает двухфакторную аутентификацию в каждом аккаунте и создаёт новый секрет.
В критически важных для бизнеса аккаунтах, таких как домен и хостинг, тоже включайте самую сильную доступную защиту. Например, какие способы подтверждения есть в кабинете sayt.uz, можно уточнить в настройках профиля или через техническую поддержку.
Добавляем TOTP на свой сайт
Если вы сами разрабатываете личный кабинет для клиентов, добавить TOTP несложно. Для каждого пользователя создаётся случайный секрет, из ссылки otpauth строится QR-код, и пользователь подтверждает подключение вводом первого кода. Храните секрет в базе в зашифрованном виде, не принимайте повторно уже использованный код в течение тех же 30 секунд и ограничивайте число попыток. Для Python с библиотекой pyotp основная часть занимает несколько строк:
import pyotp
secret = pyotp.random_base32() # создаётся один раз для пользователя
totp = pyotp.TOTP(secret)
uri = totp.provisioning_uri(name='ali@misol.uz', issuer_name='Misol')
# из uri строится QR-код для пользователя
totp.verify(kiritilgan_kod, valid_window=1) # допуск +-30 секунд
При подключении выдайте пользователю резервные коды и храните их в базе хешированными, как пароли. Для действий вроде отключения двухфакторной аутентификации или подключения нового устройства снова запрашивайте текущий код TOTP или пароль, иначе злоумышленник, однажды попавший в аккаунт, может тихо отключить защиту.