База знаний FAM/MFA+ : Настройка отправки SMS через SMS Центр

Общие сведения

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

  1. В разделе «Настройки» → «Имена для SMS» зарегистрировать имя отправителя:
  2. В разделе «Настройки» установить корректный логин и пароль:

    Логин и пароль потребуются на следующем шаге при настройке на стороне административной консоли Avanpost FAM.

Настройка на стороне административной консоли Avanpost FAM

Настройка параметров выполняется в соответствии с документацией сервиса на HTTP-интерфейс отправки сообщений, поэтому в случае изменения параметров на стороне сервиса может потребоваться корректировка указанной ниже инструкции. Подробное описание параметров описано в общей инструкции по настройке интеграции с SMS-шлюзами .

  1. В разделе «Настройки методов аутентификации» создать новый метод с типом SMS:
  2. Указать параметры метода аутентификации:
    • Ключ-тэг – любое значение латиницей; данный идентификатор может быть использован для диагностики интеграции в отладочном журнале системы 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).
  3. Сохранить изменения.

Настройка выполнена.

Приложение А. Пример настроенной интеграции на стороне Avanpost FAM

Пример выполненной настройки на стороне административной консоли Avanpost FAM: