Начиная с версии 1.4.1462 система WNAM поддерживает новый инструмент - нотификации (уведомления). Он Данный инструмент позволяет сообщить внешней системе о наступлении некоторого события, которое произошло в беспроводной сети и связано с системой авторизации WNAM. Таким событием может быть редирект устройства абонента на портал авторизации, прохождение авторизации, запуск и останов сессии доступа в сеть Интернет и т.п. В качестве внешней системы может выступать ваше любое используемое программное обеспечение, которое должно выполнять какие-то требуемые вам действия при наступлении событий в сети Wi-Fi. Это может быть система взаимодействия с пользователями (например, учет их в какой-то базе данных), система отправки пользователям СМС-сообщений рекламного характера, маркетинговая система, система отслеживания числа посетителей беспроводной сети в заданной локации и т.п.. Таким образом, система WNAM позволяет бизнесу монетизировать беспроводную сеть, применяя дополнительные средства взаимодействия с пользователями на своё усмотрение.
Вы можете Для решения вашей конкретной задачи можно обратиться в ООО "Нетамс" за помощью в решении вашей конкретной задачи.настройке натификации.
Нотификации настраиваются из меню "Конфигурация - " → "Нотификации":.
В этом разделе присутствует список объектов, каждый из которых представляет из себя задачу (условие), в которой настраивается условие, в каких случая случаях и что исполняется. Объектов типа "Нотификация" может быть много. Если параметры нескольких объектов пересекаются, например у вас , есть два объекта, которые срабатывают на событие "редирект пользователя на портал", то они будут обработаны оба.
Из данного окна можно просмотреть список имеющихся нотификаций, создать новый объект или отредактировать имеющийся. Для этого создания нотификации служит кнопка "Создать нотификацию", либо можно нажать в строку таблицы с уже имеющимися нотификациями. В обоих случаях откроется редактор с тремя вкладками, позволяющий выполнить все настройки.
В первой вкладке По кнопке "Создать нотификацию" настраивается название объекта, указывается время создания, время последнего срабатывания и их число, а также задаются типы событий (условия), при которых происходит срабатывание.
Можно также включить (активировать) и выключить (деактивировать) работу нотификации, либо удалить её.
В качестве возможных условий срабатывания (типах типы событий) допустимы:
- ("Ассоциация с беспроводной сетью");
- REDIRECT ("Редирект на портал");
- AUTH_REQ ("Запрос авторизации");
- AUTH_CONFIRM ("Подтверждение авторизации");
- SESSION_START ("Запуск сессии");
- SESSION_STOP ("Останов сессии");
- ("Событие аудита");
- ("Событие эндпоинта");
- ("Событие TACACS+");
- ("Событие коннектора с AD").
Код системы WNAM содержит соответствующий соответствующие обработчики, которые при наступлений событий заданного типа вызывают исполнение соответствующих нотификаций, подпадающих под настроенный в них тип (с учетом фильтров по включенности, площадкам, повторам - см. ниже).
Вторая вкладка ("Площадки") позволяет выбрать уведомления, уведомления с какой площадки будут обработаны. Можно указать конкретную площадку , или "все":
Также можно настроить фильтр по частоте срабатывания. Например, для одного МАС-адреса события типа "перенаправление Перенаправление на портал" могут срабатывать много раз подряд с одними и теми же параметрами. Чтобы избежать ситуации, когда внешняя система получает уведомление по аждому каждому событию, можно выбрать режим "подавлять Подавлять повторные события", указать число секунд (интервал подавления) и тип совпадения, использующийся при проверке повторности (либо МАС-адрес, либо комбинация МАС-адреса и идентификатор площадки).
В третьей вкладке ("Обработчик") задается обработчик, который будет использован для уведомления внешней системы, и набор параметров, которые будут переданы этому обработчику:.
Допустимы четыре типа следующие типы обработчиков:
- Вызов локального скрипта (по отношению к серверу системы WNAM) скрипта;
- Запрос внешнего ресурса по HTTP GET;
- Запрос внешнего ресурса по HTTP POST;
- Уведомление внешней аналитической системы MLARadar;
- Отправка события в SYSLOG;
- Отправка Trap по SNMT:
- Email.
При вызове локального скрипта параметры передаются в виде аргументов командной строки.
При вызове ресурса по GET - в виде набора пар "ключ=значение", разделенных символом &, прямо в URL запроса.
При вызове ресурса по POST - в виде стандартного запроса с параметрами, упакованными в формат json.
При использовании обработчика "УведомлятьRadar" необходимо Вы должны задать путь до скрипта, URL для запроса , или IP-адрес и пароль MLAWNAM Radar.
При использовании обработчика "Отправлять событие в SYSLOG" необходимо указать хост, на которой будут отправлены события.
При использовании обработчика "Отправлять Trap по SNMT" необходимо указать Trap сервера и "Комьюнити (v2c).
Также необходимо Вы должны указать один или несколько отправляемых параметров, значения которых передаются внешней системе, согласно таблице:. Список параметров представлен в таблице.
| Тип объекта | Ключ в параметрах | Передаваемое значение |
|---|---|---|
| MAC | mac | МАС-адрес устройства пользователя в формате ХХ:ХХ:ХХ:ХХ:ХХ:ХХ |
| AP MAC | apmac | МАС-адрес точки доступа Wi-Fi, через которую подключен пользователь, в формате ХХ:ХХ:ХХ:ХХ:ХХ:ХХ |
| ID площадки | siteId | Идентификатор площадки, например "1" |
| ID сессии | sessId | Идентификатор сессии, например "80400105-7b8fb8" |
| IP адрес | ip | IP-адрес устройства абонента, например 192.168.1.203 |
| Объект "пользователь" | cust | Объект типа Customer в формате JSON, соответствующий объекту из коллекции базы данных (db.customers базы данных) |
| Объект "площадка" | site | Объект типа Site в формате JSON, соответствующий объекту из коллекции базы данных(db.areas базы данных) |
| Объект "сессия" | sess | Объект типа Session в формате JSON, соответствующий объекту из коллекции базы данных (db.sessions базы данных) |
Если в момент создания события значение параметра не известно (например, вы указали указан параметр "Объект "сессия"" на событие "Перенаправление", когда сессии ещё нет), этот параметр не передается. Необходимо иметь в виду, что события выстраиваются в асинхронную очередь и могут обрабатываться с небольшой задержкой, которая зависит от производительности и загрузки вашего используемого сервера. В случае срабатывания нотификации в лог-файле вы заметите запись, аналогуичную этойбудет отображена запись типа:
15:39:41.157 DEBUG [c.n.w.services.NotificationService:145] - Execute notification 'ОбработчикНовойСессии' handler POST, event type REDIRECT, object: {E4:02:9B:7B:8F:B8}