{toc}
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! \\ \\
# Выбираем пулы из справочников \\ \\
!2.png|border=1,width=450!
!2.1.png|border=1,width=450! \\ \\
# При необходимости настройте pppoe-интерфейс. Это +не критично+ для интеграции hotspot \\ \\
!3.png|border=1,width=450! \\ \\
# Перейдите на вкладку *Описание* и заполните поля hotspot внзу страницы \\ \\
!hotspot4-5.png|border=1! \\ \\
# Вернитесь на вкладку *Управление* и выполните поэтапно все пункты *"Шаг 1 Инициализация"* и *"Шаг 2 Сохранение текущего конфига"* \\ \\
!4.png|border=1,width=800!
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 с веб-авторизацией на оборудовании]" или в разделе "[CarbonBilling:Софт HotSpot с веб-авторизацией в личном кабинете]"
h2. Проверка работы
Абонент, физический подключенный к сети и получивший IP-адрес из подсети интерфейса hotspot, но не авторизованный в биллинге и на оборудовании, при попытке зайти на веб-страницу должен быть переброшен на страницу авторизации. Страница выглядит следующим образом:
!hotspot8-page.png|border=1!
В данном примере абонент пытался получить доступ к сайту vk.com, что видно из адресной строки браузера.
При наличии логина/пароля, абонент должен авторизоваться введя логин и пароль.
При отсутствии или утере таких данных, абоненту следует пройти [процедуру регистрации|CarbonBilling:Софт HotSpot]
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! \\ \\
# Выбираем пулы из справочников \\ \\
!2.png|border=1,width=450!
!2.1.png|border=1,width=450! \\ \\
# При необходимости настройте pppoe-интерфейс. Это +не критично+ для интеграции hotspot \\ \\
!3.png|border=1,width=450! \\ \\
# Перейдите на вкладку *Описание* и заполните поля hotspot внзу страницы \\ \\
!hotspot4-5.png|border=1! \\ \\
# Вернитесь на вкладку *Управление* и выполните поэтапно все пункты *"Шаг 1 Инициализация"* и *"Шаг 2 Сохранение текущего конфига"* \\ \\
!4.png|border=1,width=800!
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 с веб-авторизацией на оборудовании]" или в разделе "[CarbonBilling:Софт HotSpot с веб-авторизацией в личном кабинете]"
h2. Проверка работы
Абонент, физический подключенный к сети и получивший IP-адрес из подсети интерфейса hotspot, но не авторизованный в биллинге и на оборудовании, при попытке зайти на веб-страницу должен быть переброшен на страницу авторизации. Страница выглядит следующим образом:
!hotspot8-page.png|border=1!
В данном примере абонент пытался получить доступ к сайту vk.com, что видно из адресной строки браузера.
При наличии логина/пароля, абонент должен авторизоваться введя логин и пароль.
При отсутствии или утере таких данных, абоненту следует пройти [процедуру регистрации|CarbonBilling:Софт HotSpot]