{{indexmenu_n>10}}
====== Управление разделом HotSpot ======
Wi-Fi HotSpot — это система, предоставляющая публичный доступ в интернет после прохождения пользователем авторизации и идентификации через номер телефона или по SMS.

Процесс авторизации пользователей:
  - Пользователь (еще не абонент) подключается к публичной Wi-Fi точке.
  - DHCP-сервер назначает ему внутренний IP-адрес, и в системе срабатывает триггер на блокировку интернета через услугу "Белый список" — она ограничивает доступ ко всему интернету, кроме страницы авторизации. Также устанавливаются ограничения на скорость соединения.
  - Устройство клиента автоматически перенаправляет на страницу авторизации, где нужно ввести номер телефона и выбрать способ подтверждения — получение кода либо по SMS, либо по звонку на указанный номер.
  - После авторизации, в зависимости от условий соглашения, система снимает ограничивающий полисинг и услугу "Белый список".

Если используется DPI, создается профиль абонента с логином (номер телефона) и назначенным IP. Профиль становится активным, абонент получает доступ к интернету с необходимыми политиками и услугами. После истечения параметра "Время жизни сессии" происходит деавторизация. DPI снимает все услуги и полисинг, удаляет связку "логин-IP" и снова активирует услугу "Белый список" с ограничением доступа, чтобы абоненту требовалась повторная авторизация.\\
В случае работы через биллинг-систему, она получает запрос с IP и номером телефона, после чего применяет настройки в соответствии с установленными в биллинге параметрами и тайм-аутами.

Конфигурация WiFi HotSpot осуществляется в разделе GUI Управление DPI → ХотСпот. 

<note>Данный раздел появился в GUI v2.6.6.
Описание модуля, с которым взаимодействует раздел, доступно по [[dpi:dpi_components:module_wi-fi_hotspot|ссылке]].</note>

Раздел содержит вкладки:
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#общие_настройки|Общие настройки]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_внешнего_вида|Настройки внешнего вида]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_локализации|Настройки локализации]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_авторизации_и_клик-оферты|Настройки авторизации и клик-оферты]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_услуг|Настройки услуг]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_тарифов|Настройки тарифов]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_dhcp|Настройки DHCP]]
  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#логи|Логи]]

{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:hotspot.png?nolink&1200 |}}

=====Общие настройки=====
  - В параметре "Web сервер" выбрать ХОТСПОТ сервер, привязанный к DPI.\\ Если соответствующего оборудования нет — добавить его по кнопке "Добавить новое устройство". Появится форма создания нового оборудования, в нем создать оборудование с типом "ХОТСПОТ сервер".\\ :!: [[dpi:dpi_components:dpiui:user_guide:admin_section:equipment_management:list|Подробнее о создании оборудования]].\\ {{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:common_settings.png?nolink&700|}}
  - В параметре "Captive portal URL"  указать URL, на который будет перенаправляться абонент для авторизации в сети. Создает/изменяет профиль услуги Белый список с введенным URL. Имя профиля — ''hotspot_white_list_profile''.
  - В параметре "URL для редиректа" указать URL, на который будет перенаправляться абонент после успешной авторизации на HotSpot портале. Если поле пустое — абонент перенаправляется на https://google.com.

=====Настройки внешнего вида=====
В данном разделе возможно изменить иконку (favicon) и логотип, отображаемые на странице портала.

{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:view_settings.png?nolink&700|}}

=====Настройки локализации=====
  - Добавить язык для настройки локализации по нажатию на **+**. Список доступных языков:\\ {{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:localizations_settings_1.png?nolink&300|}}
  - Выбрать добавленный язык для настройки значений параметров. Изменить значение можно нажав на него.\\ {{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:localizations_settings_2.png?nolink&700|}}
  - Любой язык можно установить языком по умолчанию, нажав на кнопку “Установить по умолчанию”. Автоматически языком по умолчанию установлен первый добавленный.\\ {{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:localizations_settings_3.png?nolink&300|}}

Если настроено 2 и больше языков, на странице авторизации будет кнопка для выбора языка.

=====Настройки авторизации и клик-оферты=====
====Настройка WiFi авторизации====
Wi-Fi авторизация — процесс подключения к сети с идентификацией пользователя через номер телефона или SMS.\\
Для настройки данного типа авторизации в параметре “Включение Wi-Fi авторизации” выбрать значение “Да”. После этого появятся все настройки WiFi авторизации:
  - “Включить управление сессиями”.\\ Если выбрано значение “Да” — создание и управление абонентами (авторизация и деавторизация) происходит через DPI и есть возможность настроить “Время жизни сессии” (По истечению времени жизни сессии ХотСпот выполнит скрипт для удаления абонента с DPI и применит тариф авторизации и услугу “Белый список” для его IP-адреса).\\ Если выбрано значение “Нет” — управление абонентами происходит через биллинг или другой сторонний сервис. Здесь нужно настроить HTTP-запрос, который будет отправляться на API биллинга, все соответствующие политики биллинг сам применит к абоненту и снимет с него.
  - “Тип авторизации”. Доступно два варианта: 
    - “По коду” — для этого варианта нужно настроить HTTP-запросы на сервис, через который будет осуществляться отправка SMS и звонков.\\ Также есть возможность настроить параметр “Последовательная авторизация” — данный режим позволяет выбрать первоначальный способ авторизации, и “Режим отладки” — это позволит отправить код авторизации на email, указанный в поле телефонного номера и протестировать сценарии после авторизации абонента.
    - “По исходящему звонку” — для этого варианта нужно настроить два параметра:
      - “Номера телефонов для исходящего звонка” — ввести номера телефонов через запятую, ХотСпот выберет случайный номер телефона для авторизации абонента по исходящему вызову.
      - “Секретный ключ для генерации хэша” — настроить сервис звонков для отправки HTTP-запроса о получении исходящего звонка от абонента на ХотСпот. По нажатию на иконку вопроса справа от параметра доступна подсказка по настройке API метода ХотСпота для получения сигнала и по созданию хэша.

Внешний вид портала HotSpot при включенной Wi-Fi авторизации (по входящему звонку и Режиму отладки): 

{{:dpi:dpi_components:dpiui:скат_dpiui2_hotspot_режим_отладки.png?600|}} 

====Настройка клик-оферты====
Клик-оферта — показывает абонентам текст публичной оферты, с которой они должны согласиться, для того чтобы пользоваться услугами.

Для настройки данного типа авторизации в параметре “Включение Клик-оферты” выбрать значение “Да”. После этого появятся настройки Клик-оферты:
  - “Включить управление сессиями”.\\ Если выбрано значение “Да” — создание и управление абонентами (авторизация и деавторизация) происходит через DPI и есть возможность настроить “Время жизни сессии” (По истечению времени жизни сессии ХотСпот выполнит скрипт для удаления абонента с DPI и применит тариф авторизации и услугу Captive Portal для его IP-адреса).\\ Если выбрано значение “Нет” — управление абонентами происходит через биллинг или другой сторонний сервис. Здесь нужно создать HTTP-запрос, который будет отправляться на API биллинга, все соответствующие политики биллинг сам применит к абоненту и снимет с него.

<note>Данный сценарий возможен только в случае, если клик-оферта работает в связке с [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройка_wifi_авторизации|WiFi авторизацией]]. 
В случае, если работает __только__ клик-оферта — при подтверждении с абонента снимается ограничение (услуга "Белый список").</note>

Текст клик-оферты настраивается в разделе “[[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройки_локализации|Настройки локализации]]” в параметрах с префиксом “click_wrap”:\\
{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:localizations_settings_4.png?nolink&700|}}

Внешний вид портала HotSpot при включенной клик-оферте: 

{{:dpi:dpi_components:dpiui:скат_dpiui2_hotspot_click_wrap.png?600|}}

=====Настройки услуг=====
<note important>Настройки услуг доступны только при параметре “Включить управление сессиями” = “Да” в разделе “Настройки авторизации и клик-оферты”.</note> 

В данной форме доступна настройка подключаемых абоненту услуг после того, как он пройдет авторизацию на портале.

{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:services_settings.png?nolink&800|}}

Для подключения доступны следующие услуги:
  * 2. Реклама — без профиля
  * 3. Блокировка рекламы — без профиля
  * 4. Черный список — как без профиля, так и с возможностью выбора профиля
  * 11. CGNAT — только с выбором профиля
  * 50. Нотификация — без профиля

=====Настройки тарифов=====
<note important>Настройки тарифов доступны только при параметре “Включить управление сессиями” = “Да” в разделе “Настройки авторизации и клик-оферты”.</note>

В данной форме доступна настройка параметров тарифных планов, применимых к абонентам при Wi-Fi авторизации.
Тарифы в форме соответствуют следующим именам на DPI:
  * Тариф для авторизации — применяется в момент авторизации в сети. Соответствует именованному профилю ''wifi_hotspot_auth_policing'' на DPI.
  * Тариф бесплатного Wi-Fi — применяется после успешной авторизации. Соответствует именованному профилю ''wifi_hotspot_policing'' на DPI. Устанавливается абоненту после прохождения авторизации на портале.

{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:tariffs_settings.png?nolink&800|}}

=====Настройки DHCP=====
Вспомогательная информация о подключении DHCP сервера:
  - [[dpi:dpi_components:platform:subscriber_management:subsman_remote|Настройка удаленного запуска ssh команд]]
  - Установить на триггер на выдачу нового IP:
Для Wi-Fi авторизации используйте этот триггер:
<code>ssh dpi_user@dpi_host "/var/dpiui2/add_captive_portal_auth.sh <IP>"</code>

Если Вам нужна только функция Клик-оферты, используйте этот триггер:
<code>ssh dpi_user@dpi_host "/var/dpiui2/add_captive_portal_click_wrap.sh <IP>"</code>


=====Логи=====
В данном подразделе содержатся лог файлы интерфейса и Клик-оферты.\\
Для обновления списка нажмите на кнопку "Обновить".

=====Управление конфигурацией=====
{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:conf_mng.png?nolink&700|}}

  - Сохранить конфигурацию
  - Обновить конфигурацию
  - Перейти на страницу документации раздела ХотСпот
  - Удалить конфигурацию