19 ноября 2026 г.
Автор
Рецензент
Расширение Twilio Verify за пределами каналов операторов связи
Большинство команд приходят к Verify ради одного канала — как правило, одноразовых паролей по SMS (OTP), — а затем добавляют голос, WhatsApp или email простой сменой параметров. Twilio предоставляет полезную инфраструктуру для реализации каналов проверки OTP, таких как интеграция с операторами связи, простая регистрация и удобный опыт для разработчиков. Но как насчет программных каналов с открытым исходным кодом, таких как Passkeys, одноразовые пароли на основе времени (TOTP) и Push-уведомления?
Вы можете разработать все три. TOTP — это опубликованный стандарт RFC, WebAuthn — стандартный API браузера, а push работает на базе устоявшейся инфраструктуры APNs и FCM. Но как и со многими вещами в разработке программного обеспечения, особенно сейчас, создание прототипа и его запуск в продакшн — это две разные задачи.
Зачем использовать Twilio Verify для каналов проверки Passkeys, TOTP и Push
Использование Twilio Verify создает надежное решение, которое переживет прототип благодаря следующим возможностям:
Криптографическое хранение серверов и учетных данных. Verify позаботится о том, чтобы ваше приложение соответствовало меняющимся спецификациям, обеспечивая наличие соответствующей требованиям стороны полагающейся стороны (FIDO2 relying party), правильно зашифрованного хранилища сидов и мобильного менеджера учетных данных, обновленного под каждый релиз ОС.
Издержки на управление идентификацией. Verify упрощает управление программными факторами, обеспечивая единообразное состояние пользователя, объединенные журналы аудита и бесшовную сверку идентификационных данных при аутентификации.
Verify предоставляет единую объектную модель для каждого программного канала
Verify унифицирует факторы аутентификации по всем каналам с помощью четырех основных ресурсов:
- Service (граница конфигурации)
- Entity (идентификатор личности пользователя)
- Factor (зарегистрированный аутентификатор)
- Challenge (попытка аутентификации и жизненный цикл).
Verify также предоставляет границу абстракции идентификации, используя идентификатор Entity вместо PII (персональных данных). Программные факторы сопоставляются напрямую с этим идентификатором, сохраняя профили пользователей изолированными в вашей основной базе данных.
Verify Passkeys: вам не нужно запускать сервер FIDO2
Эксплуатация полагающейся стороны (relying party) WebAuthn требует генерации PublicKeyCredentialCreationOptions, синтаксического анализа бинарных полезных нагрузок CBOR (это как JSON, но менее читаемый), проверки подписей по authenticatorData и clientDataJSON (еще больше криптографии!) и управления хранением открытых ключей (ЕЩЕ БОЛЬШЕ криптографии!).
Кроссплатформенная валидация источников (origin) добавляет сложности: веб-приложения отправляют источники HTTPS, в то время как приложения для Android передают хэш-подписи (например, android:apk-key-hash:<base64>). Verify абстрагирует валидацию источников для различных вариантов сборки через конфигурацию Service:
Скопировать код
Регистрация Passkey в Twilio Verify требует всего двух шагов API:
- Создание фактора passkey путем вызова подресурса Factors /Passkeys/Factors
- Проверка фактора passkey путем вызова подресурса VerifyFactor /Passkeys/VerifyFactor:
Скопировать код
Аутентификация следует тому же шаблону с использованием /Passkeys/Challenges и /Passkeys/ApproveChallenge. Это исключает самостоятельное обслуживание полагающейся стороны, синтаксический анализ утверждений и кастомное ветвление источников. Настройки аутентификатора, такие как DiscoverableCredentials, управляются напрямую через API, так что ваш агент кодирования может легко вносить изменения за вас.
Три вещи остаются на вашей стороне.
Клиентские реализации. Веб-приложения используют стандартные вызовы API navigator.credentials напрямую к конечным точкам Verify. Мобильные приложения используют SDK Twilio для обертывания API менеджера учетных данных платформ.
Требования к привязке домена. Приложения должны обслуживать файлы .well-known/assetlinks.json и apple-app-site-association, соответствующие сертификатам подписи приложения, во избежание сбоев регистрации.
Синхронизация учетных данных и резервный вариант. Синхронизация ключей доступа управляется провайдерами клиентской экосистемы (например, iCloud Keychain, Менеджер паролей Google). Для новых или несинхронизированных устройств Verify позволяет бесшовно переключаться на каналы операторов связи в рамках того же сервиса (Service).
TOTP: алгоритм прост, проблема в сиде
Сиды TOTP требуют безопасного хранения ключей, эквивалентного хэшам паролей. Как и в случае с Passkeys, хотя стандарт прост в управлении, именно краевые случаи станут источником вашего разочарования и инцидентов. Хотя генерация одноразового кода тривиальна, хранение секретного сида — нет. Сид TOTP представляет собой долгоживущий общий секрет из того же класса риска, что и хэш пароля, но с меньшим опытом индустрии по его обработке. Verify упрощает эту задачу, генерируя сид, сохраняя его и безопасно обрабатывая вещи, которые легко испортить, такие как отклонение синхронизации часов (clock drift skew).
Чтобы создать новый фактор TOTP с помощью Verify:
Скопировать код
Затем ваше приложение отображает factor.binding.uri в виде QR-кода, который конечный пользователь может отсканировать с помощью своего приложения, совместимого с RFC 6238, такого как Authy или Google Authenticator. Когда вам нужно выдать запрос на проверку, один вызов API позволит проверить введенный пользователем токен из его приложения:
Скопировать код
Если у вас уже есть другое решение TOTP, существующие секреты можно импортировать через Binding.Secret для бесшовной миграции в Verify.
Push-уведомления и тихое подтверждение на устройстве: жизненный цикл — это и есть работа
Push-факторы сохраняют асимметричный открытый ключ в Verify, защищая закрытый ключ на устройстве с помощью Android Keystore или iOS Keychain.
В дополнение к правильному управлению хранением ключей, преимущества использования Push в Verify включают:
- Устойчивую доставку. Автоматизированное управление жизненным циклом ключей, ротацию токенов, таймауты запросов и подписанные вебхуки (webhook notifications).
- Бесшовную кастомизацию. Пользовательские полезные нагрузки могут включать детали, видимые пользователю, и защищенные hidden_details.
- Надежность уведомлений. Поскольку доставка APNs и FCM может задерживаться из-за режимов энергосбережения или ограничений сети, SDK Verify поддерживают активный опрос (polling) ожидающих запросов для обеспечения их завершения.
- Тихое подтверждение на устройстве. Тихая аутентификация проверяет сеансы внутри приложения в фоновом режиме. Всегда сверяйте SID запросов или токены транзакций в hidden_details перед подтверждением, чтобы предотвратить несанкционированные проверки.
Почему Passkeys, TOTP или Push от Verify заслуживают места в вашем текущем стеке
Если вы уже используете Verify, добавление программного канала не является новой интеграцией. Это вызов Factor для сущности Entity, которая у вас уже есть, в сервисе Service, который вы уже настроили, с теми же аутентификацией провайдера, соглашениями об ошибках и консолью.
Использование Verify за пределами каналов OTP предоставляет:
- Гибкость многофакторной аутентификации. Поддержка различных предпочтений пользователей (TOTP, push, SMS) через единый интерфейс API и объектную модель.
- Централизованный инвентарь факторов. Запрос GET /Entities/{identity}/Factors предоставляет единый источник достоверной информации о возможностях аутентификации пользователя.
- Бесшовное восстановление аккаунта. Если пользователь теряет доступ к одному каналу, ваше приложение может вернуться к настроенным каналам оператора связи в рамках того же Service, сохраняя лимиты запросов и защиту от мошенничества.
Две границы, которые стоит знать перед началом проектирования
Verify предоставляет примитивы факторов, состояние жизненного цикла и конечные точки верификации, но не обеспечивает соблюдение кросс-канальной политики. Решение о том, когда запрашивать ключ доступа (passkey), а когда переключаться на push-уведомления или SMS, остается за логикой вашего приложения или инструментами CIAM, которые вызывают те же API Verify в фоновом режиме. Единственный встроенный механизм резервного копирования — это channel=auto, при котором Silent Network Auth может переключиться на SMS, при этом программные каналы не затрагиваются.
Аудит логирования имеет ту же структуру. События Verify и API попыток верификации охватывают SMS, WhatsApp, RCS и голосовые вызовы. Для push-уведомлений предусмотрены вебхуки, однако TOTP и ключи доступа не поддерживают ни события, ни попытки, поэтому сохраняйте ответы API на уровне вашей интеграции, если вам необходим контрольный журнал.
Дальнейшие шаги
Изучите нашу документацию и руководства, чтобы начать внедрение передовых каналов верификации в ваше приложение.
- Обзор Verify Passkeys и технический обзор. Passkeys находится в стадии закрытого бета-тестирования, запросите доступ на странице обзора.
- Краткое руководство по Verify TOTP
- Технический обзор и лучшие практики Verify Push, включая бесшумное подтверждение устройства, ротацию токенов и обнаружение удаления приложения
- Справочник API Factor и Challenge
Нам не терпится увидеть, что вы создадите.











