Начиная с версии 1.3.983 WNAM поддерживает функцию идентификации гостей, зарегистрированных в автоматизированной системе управления гостиницами "Эдельвейс" (далее - АСУ "Эдельвейс") производства компании Эделинк. Доступ предоставляется без СМС-сообщения и звонков на основе информации о госте, имеющейся в базе данных (далее - БД) гостиничной системы. Взаимодействие между установленной у заказчика-владельца сети Wi-Fi АСУ "Эдельвейс" и WNAM на сервере (того же заказчика, или провайдера авторизации) осуществляется по протоколу HTTP при помощи специального агента на сервере АСУ "Эдельвейс". WNAM поддерживает одновременную работу с несколькими АСУ "Эдельвейс" на разных площадках оказания услуги Wi-Fi.
Для настройки интеграции WNAM с АСУ "Эдельвейс" необходимо:
1. Установить и настроить АСУ "Эдельвейс".
Инструкция по установке и настройки АСУ "Эдельвейс" предоставляется при приобретении системы.
2. Установить и настроить адаптер взаимодействия АСУ "Эдельвейс" с внешними системами.
Адаптер поставляется компанией-производителем, Эделинк. Адаптер, с одной стороны, взаимодействует с БД АСУ "Эдельвейс" на сервере в гостинице, а с другой стороны предоставляет HTTP API интерфейс для проверки наличия регистрации гостя в системе и параметров его проживания. После установки адаптера (может носить имя EdelHotWiFiAdapter или EdelHotWiFiAgent), необходимо выполнить следующие действия:
2.1. В конфигурационном файле C:\EDEL\SERVICES\EdelHotWiFiAgent\EdelHotWiFiAdapter.exe.config необходимо указать IP-адрес и TCP-порт, по которому адаптер будет доступен извне серверу WNAM. Для этого необходимо отредактировать в конфигурационном файле параметр UriHotezaHost так, чтобы он содержал имя/адрес локального сервера и порт например:
<appSettings>
...<add key="UriHotezaHost" value="http://127.0.0.1:4214/" /></appSettings>
Рекомендуется оставить адрес сервера локальным (localhost) и порт подключения 4214. Также необходимо уточнить адрес сервера АСУ "Эдельвейс", по которому он будет доступен для WNAM. Таким адресом является либо адрес в частной сети, например 192.168.9.11 (если WNAM установлен в той же сети), либо публичный адрес, предоставляемый путем трансляции (проброса порта) на пограничном маршрутизаторе Интернет, если WNAM подключается к АСУ "Эдельвейс" из сети Интернет. Адрес сервера АСУ "Эдельвейс" понадобятся в дальнейшем.
2.2. Разрешить доступ извне к серверу, где установлена АСУ "Эдельвейс". Для этого в настройках межсетевого экрана ОС Windows этого сервера разрешить обращения на порт (в примере - 4214):
На той же вкладке в свойствах АСУ "Эдельвейс" в разделе "Scope" в поле "Remote IP Address - These IP addresses" рекомендуется указать IP-адрес сервера WNAM, который будет обращаться к серверу АСУ "Эдельвейс". Это нужно для того, чтобы не произошло случайного подключения к АСУ "Эдельвейс" (агент при этом работает "на чтение" и является безопасным).
2.3. Перезапустить службу EdelHotWiFiAgent.
2.4. Необходимо проверить доступность сервиса простым запросом без параметров (в ответ сервер должен вернуть ошибку типа 404, что в данном случае является корректной работой). Проверку следует выполнить сначала с самого сервера АСУ "Эдельвейс", а затем с сервера WNAM.
root@debian:~# curl http://77.123.231.56:4214
{"statusCode":404,"message":"The resource you have requested cannot be found.","details":""}root@debian64:~#
3. Настроить WNAM на способ идентификации через АСУ "Эдельвейс".
3.1. В разделе "Конфигурация! → "Гостевая авторизация" → "Конструктор страниц" необходимо загрузить шаблонную страницу идентификации edelweiss.html (её можно получить по ссылке: http://www.netams.com/files/wnam/portalpages/) и отредактировать при необходимости, например, изменив логотип/иконку. Редактирование страницы доступно в "Конструкторе страниц" при нажатии на кнопку с изображением карандаша на шаблоне страницы. Страница содержит два обязательных поля - номер комнаты гостя и фамилию гостя, которые используются для его идентификации.
3.2. Указать метод авторизации "Гостиничная система" в разделе "Авторизация" в окне настройки метода авторизации (в общих настройках, или настройках конкретной площадки):
В параметре "URL системы" необходимо указать адрес агента, установленного на сервере АСУ "Эдельвейс", в нашем примере это http://77.123.231.56:4214/. В качестве имени страницы следует выбрать страницу, загруженную на предыдущем шаге (edelweiss.html).
3.3. Сохранить изменения. На этом настройка завершена.
4. Провести тестирование функции идентификации через АСУ "Эдельвейс"
Для этого необходимо выполнить подключение к Wi-Fi на площадке, на которой произведена настройка авторизации через АСУ "Эдельвейс". При подключении гостя ему будет предложена возможность идентификации:
При авторизации гостю необходимо указать свой номер комнаты и фамилию. В случае отрицательной авторизации пользователю будет об этом сообщено ("Гость не найден"). При получении положительного ответа ("Гость найден, в настоящий момент его проживание разрешено") система WNAM создаст запись о госте в своей БД, а гостю будет предложено перейти в Интернет в соответствии с настройками "Перенаправления". При этом в лог-файле wnam.log появятся записи:
19:19:02.789 DEBUG [c.n.w.web.cp.CaptivePortalController:1537] - captive portal redirected to EDELWEISS page, username=00:01:02:03:04:05, cust=new, form='edelweiss.html'
19:19:22.428 DEBUG [c.n.w.web.cp.CaptivePortalController:1141] - postEdelweiss room=204, birthdate=11.05.1986, MAC=00:01:02:03:04:05, EDEL_URL='http://77.123.231.56:4214/'
19:19:22.637 DEBUG [c.n.w.web.cp.CaptivePortalController:1181] - postEdelweiss identified: 'МОРОЗОВА МАРИЯ ПАВЛОВНА' until 07.01.2017 23:59:59
19:19:22.637 DEBUG [c.n.w.web.cp.CaptivePortalController:1596] - processRedirectRequestCi mac=00:01:02:03:04:05, method=ADV, formName=, redirectUrl=bash.im, key=40cac5c4-2551-4446-9aa9-251fe3a77a27
Доступ в Интернет гостю будет разрешен до конца дня оформленного проживания. При последующих подключениях гостя до завершения проживания авторизация запрашиваться не будет (необходима первичная идентификация). Если гость продлил проживание или приехал в следующий раз, идентификация будет запрошена повторно и доступ будет разрешен в случае, если в БД АСУ "Эдельвейс" сохранились записи о госте. Административный интерфейс содержит запись о госте, созданную в соответствии с полученными из системы данными:
При нажатии на кнопку справа от слов "Код СМС авторизации" ранее сохраненная для гостя авторизация будет сброшена, и при следующем его подключении к сети Интернет запрос ввода номера комнаты и фамилии произойдет повторно.