Глава 4. Источник SMS
С помощью источника аутентификации 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. В случае, если вы используете иной шлюз, выберите для него тип Пользовательский. Рассмотрим подробнее интеграцию с каждым из них.
Для создания интеграции с SMS-шлюзами пользователь должен иметь роль Администратор или обладать правами SMS_GATEWAY_CREATE, SMS_GATEWAY_READ, SMS_GATEWAY_UPDATE, SMS_GATEWAY_DELETE, SMS_SEND_METHOD_AVAILABLE, DEFAULT_SEND_METHOD_SMS и System - Create.
Физический шлюз Yeastar TG
Для того чтобы выполнить интеграцию AxelNAC с физическим SMS-шлюзом, выполните следующие действия:
Шаг 1. Перейдите в раздел Конфигурация → Интеграция → SMS-шлюзы и нажмите Новый SMS-шлюз.
Шаг 2. В открывшемся окне заполните поля следующим образом:
- Имя: YeastarTG_gateway;
- Тип: Yeastar TG;
- Имя пользователя: User;
- Пароль: password;
- Отправка учетных данных: Включено.
Шаг 3. Нажмите Создать, чтобы сохранить новую интеграцию.
Шаг 4. После этого настройте параметры электронной почты SMTP и SMTP-сервера вашего физического шлюза.
Облачный шлюз SMSC
Для настройки интеграции с SMS-шлюзами с типом SMSC понадобится активный аккаунт в системе SMSC.ru.
Для того чтобы выполнить интеграцию 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
Для корректной работы email2sms необходимо выполнить интеграцию с 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 дня. Данная конфигурация является примером наиболее часто используемого метода настройки данного источника аутентификации.