Как настроить 2FA-интеграцию

Настройка 2FA-интеграции — сторона генерации, канал, параметры кода

Как настроить 2FA-интеграцию

Коротко: 2FA-интеграция настраивается в разделе «2FA Service». Вы выбираете, где генерируется код, канал отправки и параметры.

Кому подходит

  • Роль: Клиент, Администратор
  • Уровень: Опытный

Что вы получите

Настроенную 2FA-интеграцию, готовую к отправке кодов.

Перед началом

  • Вы в личном кабинете OTP-сервиса.
  • У вас есть имя отправителя со статусом Активно.
  • У вас есть API-ключ.

Шаги

Шаг 1. Откройте раздел «2FA Service»

В левом меню: 2FA Service → 2FA SMS.

Шаг 2. Нажмите «Добавить интеграцию»

Кнопка в правом верхнем углу.

Шаг 3. Выберите сторону генерации и проверки

ЗначениеЧто означает
На стороне клиентаВы генерируете код и проверяете его на своей стороне
На стороне платформыПлатформа генерирует и проверяет код

Шаг 4. Укажите название

Понятное имя записи. Например, «2FA для сайта».

Шаг 5. Выберите SMS-отправителя

Имя отправителя, от которого будут отправляться коды.

Шаг 6. Настройте параметры кода

Доступно при генерации на стороне платформы:

ПолеЧто указать
Количество цифр в коде4, 5, 6 или больше
Период валидности кодаВ секундах, максимум 600
URL для результата верификацииКуда отправлять результат (необязательно)

Шаг 7. Настройте текст сообщения

Введите текст с плейсхолдером {{code}}. Например: «Ваш код: {{code}}».

Шаг 8. Сгенерируйте API-ключ для интеграции

В разделе Данные для интеграции нажмите кнопку генерации. Ключ появится в поле API key.

Скопируйте:

  • API key.
  • URL для интеграции.

Шаг 9. Сохраните

КнопкаЧто делает
Сохранить как черновикСохраняет со статусом Черновик
Сохранить и запустить сервисАктивирует интеграцию

Результат

2FA-интеграция настроена. Статус — Активный.

Тестирование

Возможность тестирования становится доступна после создания интеграции:

  1. Откройте карточку интеграции.
  2. Введите номер телефона для теста.
  3. Нажмите Отправить тестовый код.
  4. Проверьте, что код пришёл.

Статусы интеграции

СтатусЧто означает
АктивныйРаботает
ЧерновикНе активирована
ЗаблокированныйОтключена

Частые проблемы

СимптомПричинаРешение
Кнопка «Сохранить и запустить» неактивнаНе заполнено обязательное полеПроверьте форму
Тестовый код не приходитНеверный номерПроверьте номер
Ошибка APIНеверный ключСверьте ключ

См. также

Нужна помощь?