Как работает 2FA-сервис
Как работает 2FA-сервис в OTP-кодах — режим Под ключ, где платформа сама генерирует, отправляет и проверяет коды верификации по 9 каналам
Коротко: 2FA-сервис автоматизирует отправку и проверку кодов верификации. Платформа сама генерирует код, отправляет его и проверяет ответ пользователя.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок / Опытный
Что это
2FA-сервис — режим «Под ключ». Платформа берёт на себя всю работу с кодом:
- Генерирует код.
- Отправляет код через нужный канал.
- Принимает код от пользователя.
- Проверяет код.
- Возвращает результат: верно или неверно.
Вам не нужно писать логику генерации и проверки кодов.
Это один из двух режимов работы OTP-сервиса. Второй режим — Умный шлюз — когда клиент сам генерирует код, а платформа только доставляет его.
Тестовое подключение бесплатно — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
Перед началом
- Вы зарегистрированы в OTP-кодах.
- Вы зарегистрировали имя отправителя.
- Вы готовы настроить 2FA-интеграцию.
Чем отличается от «Умный шлюз»
| Критерий | Под ключ (2FA) | Умный шлюз |
|---|---|---|
| Кто генерирует код | Платформа | Вы |
| Кто проверяет код | Платформа | Вы |
| Что вы получаете | «Код верный / неверный» | Статус доставки сообщения |
| Сложность интеграции | 2 запроса | 1 запрос + своя логика |
| Кому подходит | Без своего OTP-модуля | Со своим генератором кодов |
Доступные каналы
Доступные каналы. В 2FA-сервисе доступно 9 каналов OTP. Номера для поля channel и особенности каждого — в таблице Какие каналы использовать для OTP.
Как это работает
Отправляете номер телефона получателя на URL интеграции.
Платформа сама создаёт код — вы не пишете логику генерации.
Код уходит получателю через выбранный канал.
Пользователь вводит полученный код на вашем сайте.
Отправляете requestId и code на проверку.
«Код верный» или «Код неверный».
Что вы получаете
- В ответе на первый запрос — requestId. По нему можно проверить статус.
- В ответе на проверку — результат: код верный или неверный.
Преимущества
Как подключить
Создайте аккаунт и получите доступ в личный кабинет.
Имя отправителя нужно для отправки кодов по любому каналу.
В разделе 2FA Service → 2FA SMS создайте интеграцию. Она выдаст ключ интеграции и URL интеграции.
Отправьте тестовый код и проверьте его через API.
Результат
Вы понимаете, как работает режим «Под ключ», и готовы настроить 2FA-интеграцию.
Частые проблемы
Причина: канал недоступен или номер получателя неактивен.
Решение: проверьте статус в EDR. Если не помогает — обратитесь в поддержку.
Причина: неверный ключ или неверная схема аутентификации.
Решение: проверьте, что используете Basic Auth с ключом интеграции из раздела Данные для интеграции. Не используйте заголовок X-API-Key — он не подходит для 2FA-эндпоинтов.
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru