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

В AxelNAC существуют два метода интеграции с SMS-шлюзами: email2sms и API. Данные методы обеспечивают доставку SMS-сообщений, необходимых для аутентификации пользователей, однако отличаются способом передачи данных.

Тип интеграции email2sms
В данном варианте взаимодействие с SMS-провайдером осуществляется через электронную почту. AxelNAC отправляет письмо на адрес электронной почты, указанный провайдером. В теле письма передаются основные параметры, необходимые для отправки SMS: данные для аутентификации (например, логин и пароль или токен доступа), номер телефона получателя и текст сообщения. Провайдер получает это письмо, обрабатывает его и доставляет SMS-сообщение пользователю-гостю. 

Тип интеграции API
Интеграция по API представляет собой прямое взаимодействие с SMS-шлюзом через программный интерфейс. AxelNAC обращается к API провайдера, передавая необходимые параметры запроса: аутентификационные данные, номер получателя и текст SMS. Данный метод является более предпочтительным, так как он позволяет контролировать статус выполняемой операции.

Независимо от выбранного типа интеграции, для корректной работы механизма передачи SMS необходим минимальный набор параметров: данные для аутентификации, адрес назначения (номер телефона) и содержимое сообщения. Эти параметры формируются AxelNAC и передаются в SMS-шлюз выбранным транспортом — через email2sms или через API.

Интеграция с SMS-шлюзом

Для работы источника SMS необходимо настроить интеграцию с SMS-шлюзом. Вы можете использовать физический — в нашем примере это Yeastar TG100 и облачный шлюз — мы используем шлюз с типом SMSC. В случае, если вы используете иной шлюз, выберите для него тип Пользовательский. Рассмотрим подробнее интеграцию с каждым из них.

Физический шлюз Yeastar TG

Для того чтобы выполнить интеграцию AxelNAC с физическим SMS-шлюзом, выполните следующие действия:

Шаг 1. Перейдите в раздел Конфигурация → Интеграция → SMS-шлюзы и нажмите Новый SMS-шлюз.

Шаг 2. В открывшемся окне заполните поля следующим образом:

• Имя: YeastarTG_gateway;
• Тип: Yeastar TG;
• Имя пользователя: User;
• Пароль: password;
• Отправка учетных данных: Включено.

Шаг 3. Нажмите Создать, чтобы сохранить новую интеграцию.

Шаг 4. После этого настройте параметры электронной почты SMTP и SMTP-сервера вашего физического шлюза.

Облачный шлюз SMSC

Для того чтобы выполнить интеграцию AxelNAC с облачным SMS-шлюзом, выполните следующие действия:

Шаг 1. Перейдите в раздел Конфигурация → Интеграция → SMS-шлюзы и нажмите Новый SMS-шлюз.

Шаг 2. В открывшемся окне заполните поля следующим образом:

• Имя: SMSC_gateway;
• Тип: SMSC;
• Имя пользователя: User;
• Пароль: password;
• Отправка учетных данных: Включено.

Шаг 3. Нажмите Создать, чтобы сохранить новую интеграцию.

Шаг 4. После этого настройте параметры электронной почты SMTP и SMTP-сервера вашего облачного шлюза.

Пользовательский тип шлюза

Для того чтобы выполнить интеграцию AxelNAC с вашим SMS-шлюзом, выполните следующие действия:

Шаг 1. Перейдите в раздел Конфигурация → Интеграция → SMS-шлюзы и нажмите Новый SMS-шлюз.

Шаг 2. В открывшемся окне заполните поля следующим образом:

• Имя: Custom_gateway;
• Тип: Пользовательское;
• Тип API: выберите подходящий вам тип;
• Имя пользователя: User;
• Пароль: password;
• Шаблон Email-адреса API: введите собственное значение;
• Шаблон темы письма: введите собственное значение;
• Шаблон содержимого письма: введите собственное значение;
• Отправка учетных данных: Включено.

Шаг 3. Нажмите Создать, чтобы сохранить новую интеграцию.

Шаг 4. После этого настройте параметры электронной почты SMTP и SMTP-сервера вашего шлюза.

Интеграция с SMTP

Чтобы интегрироваться с SMTP, выполните следующие действия:

Шаг 1. Перейдите в раздел Конфигурация → Настройки системы → Уведомления.

Шаг 2. В открывшемся окне конфигурации заполните следующие поля:

• Отправитель — адрес электронной почты, с которого отправляются уведомления. Если значение не указано, используется root@<имя домена сервера>;
• SMTP-сервер — адрес сервера исходящей почты, через который отправляются уведомления. По умолчанию используется localhost. При использовании значения по умолчанию SMTP-сервер должен быть доступен локально;
• SMTP-шифрование — тип шифрования, применяемый при подключении к SMTP-серверу;
• SMTP-порт — порт SMTP-сервера. Если указано значение 0, порт выбирается автоматически в зависимости от типа шифрования: none — 25, ssl — 465, starttls — 587;
• Имя пользователя SMTP — имя пользователя, применяемое для аутентификации при подключении к SMTP-серверу;
• Пароль SMTP — пароль для подключения к SMTP-серверу в связке с указанным именем пользователя.

Шаг 3. Нажмите Сохранить для того, чтобы сохранить выбранные настройки.

Ознакомьтесь с полным описанием интерфейса вкладки Уведомления.

Добавление источника SMS-аутентификации

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

Шаг 1. В разделе Конфигурация → Политики и контроль доступа → Источники аутентификации нажмите Новый внешний источник и выберите SMS из выпадающего списка.

Шаг 2. На открывшейся странице заполните поля следующим образом:

• Имя: SMS_example;
• Описание: SMS-based registration;
• SMS-шлюз: выберите настроенный ранее шлюз;
• Ме тод хэширования паролей базы данных: Bcrypt;
• Пра вила аутентификации — нажмите Добавить правило и заполните поля следующим образом:
  • Имя: catchall;
  • Описание: Выдача роли guest и доступа на 1 день всем устройствам или пользователям;
  • Действия — нажмите Добавить действие и заполните поля:
    • Тип: Роль;
    • Значение: guest.

Нажмите на , чтобы добавить еще одно действие и заполните поля:

•  Тип: Период доступа без реавторизации;
•  Значение: 1 день.

Шаг 3. Нажмите Сохранить, чтобы сохранить настроенную конфигурацию.

При выборе данного источника как источника аутентификации на Captive-портале всем устройствам, которые пытаются зарегистрироваться через данный источник аутентификации, будет добавлена роль guest и они могут пользоваться сетью без повторной регистрации в течение 1 дня. Данная конфигурация является примером наиболее часто используемого метода настройки данного источника аутентификации.

Полезные ссылки 

• Полное описание интерфейса источника аутентификации SMS;
• Полное описание интерфейса страницы SMS-шлюзы;
• Полное описание интерфейса вкладки Уве домления;
• Использование нескольких SMS-шлюзов в одном профиле подключения.