Общие сведения
Avanpost FAM позволяет осуществлять для отправки SMS-сообщений любой SMS-шлюз, поддерживающий HTTP-интерфейс для отправки сообщений. В качестве SMS-шлюза может быть использован шлюз от компании ООО «СМС-Центр» (smsc.ru).
Интеграция с SMS-шлюзом необходима для использования фактора SMS OTP (отправка одноразового кода посредством SMS-сообщения).
Данная инструкция описывает процесс настройки интеграции Avanpost FAM с SMS-шлюзом smsc.ru.
Системные требования для интеграции Avanpost FAM c smsc.ru:
- Установленный и настроенный в сети компонент Avanpost FAM Server;
- Наличие сетевого доступа с сервера, на котором размещён Avanpost FAM Server, до URL
https://smsc.ru/sys/send.php.
Настройка
Настройка на стороне личного кабинета smsc.ru
- В разделе «Настройки» → «Имена для SMS» зарегистрировать имя отправителя:
- В разделе «Настройки» установить корректный логин и пароль:
Логин и пароль потребуются на следующем шаге при настройке на стороне административной консоли Avanpost FAM.
Настройка на стороне административной консоли Avanpost FAM
Настройка параметров выполняется в соответствии с документацией сервиса на HTTP-интерфейс отправки сообщений, поэтому в случае изменения параметров на стороне сервиса может потребоваться корректировка указанной ниже инструкции. Подробное описание параметров описано в общей инструкции по настройке интеграции с SMS-шлюзами.
- В разделе «Настройки методов аутентификации» создать новый метод с типом SMS:
- Указать параметры метода аутентификации:
- Ключ-тэг – любое значение латиницей; данный идентификатор может быть использован для диагностики интеграции в отладочном журнале системы Avanpost FAM;
- Метод активен – включить, если предполагается использование этого метода после выполнения настройки;
- Включить DEBUG-режим (одноразовый пароль выводится в лог, без отправки SMS) – флаг снят;
- URL-адрес SMS-шлюза – указать значение в соответствии с документацией сервиса; на момент разработки инструкции адрес -
https://smsc.ru/sys/send.php; - HTTP-метод запроса – выбрать
POST; - Заголовок Content-Type –
application/x-www-form-urlencoded; - Фактор доступен только для пользователей с подтвержденным номером телефона – на усмотрение администратора;
- Атрибуты строки запроса (HTTP Query String) –Тело запроса содержит массив объектов JSON добавить две записи:
- Ключ – login; значение – значение логина, указанное в разделе «Настройки» в личном кабинете smsc.ru;
- Ключ – psw; значение – значение пароля, заданное в разделе «Настройки» в личном кабинете smsc.ru;
- Атрибуты тела запроса – оставить пустым;
- Тело запроса содержит массив объектов JSON – флаг снят;
- Атрибуты заголовка запроса (HTTP Header).
- Сохранить изменения.
Настройка выполнена.
Приложение А. Пример настроенной интеграции на стороне Avanpost FAM
Пример выполненной настройки на стороне административной консоли Avanpost FAM:
