Начиная с версии 1.3.983 WNAM поддерживает функцию идентификации гостей, зарегистрированных в автоматизированной системе управления гостиницами "Эдельвейс" (далее - АСУ "Эдельвейс") производства компании Эделинк. Доступ предоставляется без СМС-сообщения и звонков на основе информации о госте, имеющейся в базе данных (далее - БД) гостиничной системы. Взаимодействие между установленной у заказчика-владельца сети Wi-Fi АСУ "Эдельвейс" и WNAM на сервере (того же заказчика, или провайдера авторизации) осуществляется по протоколу HTTP при помощи специального агента на сервере АСУ "Эдельвейс". WNAM поддерживает одновременную работу с несколькими АСУ "Эдельвейс" на разных площадках оказания услуги Wi-Fi.
Для настройки интеграции WNAM с АСУ "Эдельвейс" необходимо:
Инструкция по установке и настройки АСУ "Эдельвейс" предоставляется при приобретении системы.
Адаптер поставляется компанией-производителем, Эделинк. Адаптер, с одной стороны, взаимодействует с БД АСУ "Эдельвейс" на сервере в гостинице, а с другой стороны предоставляет 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.1. В разделе "Конфигурация! → "Гостевая авторизация" → "Конструктор страниц" необходимо загрузить шаблонную страницу идентификации edelweiss.html (её можно получить по ссылке: http://www.netams.com/files/wnam/portalpages/) и отредактировать при необходимости, например, изменив логотип/иконку. Редактирование страницы доступно в "Конструкторе страниц" при нажатии на кнопку с изображением карандаша на шаблоне страницы. Страница содержит два обязательных поля - номер комнаты гостя и фамилию гостя, которые используются для его идентификации.
3.2. Указать метод авторизации "Гостиничная система" в разделе "Авторизация" в окне настройки метода авторизации (в общих настройках, или настройках конкретной площадки):
В параметре "URL системы" необходимо указать адрес агента, установленного на сервере АСУ "Эдельвейс", в нашем примере это http://77.123.231.56:4214/. В качестве имени страницы следует выбрать страницу, загруженную на предыдущем шаге (edelweiss.html).
3.3. Сохранить изменения. На этом настройка завершена.
Для этого необходимо выполнить подключение к 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
Доступ в Интернет гостю будет разрешен до конца дня оформленного проживания. При последующих подключениях гостя до завершения проживания авторизация запрашиваться не будет (необходима первичная идентификация). Если гость продлил проживание или приехал в следующий раз, идентификация будет запрошена повторно и доступ будет разрешен в случае, если в БД АСУ "Эдельвейс" сохранились записи о госте. Административный интерфейс содержит запись о госте, созданную в соответствии с полученными из системы данными:
При нажатии на кнопку справа от слов "Код СМС авторизации" ранее сохраненная для гостя авторизация будет сброшена, и при следующем его подключении к сети Интернет запрос ввода номера комнаты и фамилии произойдет повторно.