---
title: Как настроить 2FA-интеграцию
description: Настройка 2FA-интеграции — сторона генерации, канал, параметры кода
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

# Как настроить 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 | Неверный ключ | Сверьте ключ |

## См. также

- [Как работает 2FA-сервис](/02-otp/01-turnkey/otp-101-how-2fa-works)
- [Как редактировать 2FA-интеграцию](/02-otp/01-turnkey/otp-103-edit-2fa)
- [Принцип работы 2FA: на стороне платформы](/02-otp/01-turnkey/otp-106-platform-side)
- [Как создать API-ключ](/02-otp/03-for-developers/otp-302-api-key)

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

- OTP-коды: support@otpcod.ru