Интеграция MikroTik hotspot

{toc}

h2. Описание схемы
Официальная документация по [mikrotik hotspot|https://wiki.mikrotik.com/wiki/Manual:IP/Hotspot].
Схема сети:

!HotSpot01.png!

Софт хотспот на mikrotik запускается на отдельном интерфейсе. Весь трафик пришедший на интерфейс будет пропущен, только после авторизации.
Радио сеть не зависит от хотспот, следовательно, хотспот можно запустить на центральном контроллере и подключить к нему несколько точек доступа.

h2. Важные замечания пред началом интеграции
{warning}Протокол управления должен быть *SSH*, по telnet страница авторизации не загрузится{warning}
{note}* В справочниках должны быть заполнены пулы billing_ip cabinet_ip dns1 dns2
* Создание НАСа возможно из веб-интерфейса. Последние шаги выполняются только из командной строки (далее по тексту статьи)
* Должна быть выбрана схема с [веб-авторизацией на оборудовании|CarbonBilling:Софт HotSpot с веб-авторизацией на оборудовании]{note}

h2. Часть первая. Создание НАСа в веб-интерфейсе
# Создайте NAS с типом *Mikrotik-hotspot-simple* \\ \\
!0.png|border=1,width=450! \\ \\
# Заполните настройки подключения к НАСу \\ \\
!1.png|border=1,width=450! \\ \\
Обязательные поля:
* IP адрес радиус сервера(обычно адрес биллинга)
* Telnet_ip - ip адрес для отправки команд

!2.png|border=1,width=450!
!2.1.png|border=1,width=450! \\ \\
Обязательные поля:
* IP адрес кабинета (адрес для перенаправления)
# При необходимости настройте pppoe-интерфейс. Это +не критично+ для интеграции hotspot \\ \\
!3.png|border=1,width=450! \\ \\

h3. Исправление ini файла hotspot
Для формирования корректного конфигурационного файла hotspot и странички веб-авторизации, требуется вручную исправить файл hotspot.ini. Для этого выполните следующие шаги:
# Перейдите на закладку *"Настройка"* вкладки *"Управление"*
# При отсутствии списка файлов, нажмите *"Обновить список"*
# Выберите файл *hotspot.ini*
# Приведите файл к такому виду как на картинке (так же приложен листинг), указав требуемые IP и наименование интерфейса Микротика, с которого планируется принимать подключения абонентов Hotspot
# Отмотайте страничку в самый низ до кнопки *"Сохранить"* (верхняя кнопка отвечает за сохранение настроек в биллинге, а не ini файла)
# Нажмите кнопку *Сохранить* \\ \\
!hotspot6-7.png|border=1,width=450!


Листинг:
{code}tmplt=tmplt/hotspot
enabled="1"
hotspot="int=ether2 ip=10.88.0.1"

{code}
{note}Убедитесь что после строки *hotspot* есть перенос на следующую строку или пустая строка{note}

Дальнейшая интеграция происходит в терминале.

h2. Часть вторая. Генерация конфигурационных файлов и загрузка на оборудование.
# Подключитесь к серверу по ssh и перейдите в каталог управления оборудованием.
Узнать нужный каталог Вы можете на вкладке *"Управление"* в области *"Каталог управления этим экземпляром оборудования"*
В данном примере, каталог оборудования */var/oss/core/mikrotik_hotspot*
{code}chroot /app/asr_billing
cd /var/oss/core/mikrotik_hotspot{code}
# Сгенерируйте конфигурационные файлы для загрузки на оборудование
{code}rtsh cfg make{code}
В выводе команды должны быть hotspot.cfg и hotspot_login.html и не должно быть ошибок. Пример корректного вывода:
{code}making firewall.ini hotspot.ini netflow.ini
/usr/local/bin/oss/cfg_render firewall.ini tmplt/firewall_address_list.cfg.tmplt >firewall_address_list.cfg
/usr/local/bin/oss/cfg_render firewall.ini tmplt/firewall_filter.cfg.tmplt >firewall_filter.cfg
/usr/local/bin/oss/cfg_render firewall.ini tmplt/firewall_nat.cfg.tmplt >firewall_nat.cfg
/usr/local/bin/oss/cfg_render hotspot.ini tmplt/hotspot.cfg.tmplt >hotspot.cfg
/usr/local/bin/oss/cfg_render hotspot.ini tmplt/hotspot_login.html.tmplt >hotspot_login.html
/usr/local/bin/oss/cfg_render netflow.ini tmplt/netflow.cfg.tmplt >netflow.cfg{code}
# Загрузите конфигурационные файлы на оборудование
{code}rtsh cfg upload{code}
Далее последует очень длинный вывод команды. При нормальном коннекте между биллингом и Микротиком загрузка может занимать до 2 минут.

h2. Часть третья. Создание шаблона учетной записи
В биллинге требуется настроить шаблон абонента и учетной записи. Подробнее описано в разделе "[CarbonBilling:Софт HotSpot с веб-авторизацией на оборудовании]".
h2. Проверка работы
Абонент, физический подключенный к сети и получивший IP-адрес из подсети интерфейса hotspot, но не авторизованный в биллинге и на оборудовании, при попытке зайти на веб-страницу должен быть переброшен на страницу авторизации. Страница выглядит следующим образом:

!hotspot8-page.png|border=1!

В данном примере абонент пытался получить доступ к сайту vk.com, что видно из адресной строки браузера.
При наличии логина/пароля, абонент должен авторизоваться введя логин и пароль.
При отсутствии или утере таких данных, абоненту следует пройти [процедуру регистрации|CarbonBilling:Софт HotSpot]