Различия

Показаны различия между двумя версиями страницы.

--- dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot [2024/09/26 15:29] – создано - внешнее изменение 127.0.0.1
+++ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot [2024/11/20 08:41] (текущий) – [Общие настройки] elena.krasnobryzh
@@ Строка 1: / Строка 1: @@
-====== Управление разделом HotSpot ======
 {{indexmenu_n>10}}
-  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#Конфигурация Web сервера|Конфигурация Web сервера]]
+====== Управление разделом HotSpot ======
-  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#Конфигурация Wi-Fi авторизации|Конфигурация Wi-Fi авторизации]]
+Wi-Fi HotSpot — это система, предоставляющая публичный доступ в интернет после прохождения пользователем авторизации и идентификации через номер телефона или по SMS.
-  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#Click wrap конфигурация|Click wrap конфигурация]]
-  * [[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:management_hotspot#Управление услугами|Управление услугами]]
-  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#Настройки внешнего вида портала|Настройки внешнего вида портала]]
-  * [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#Настройки языка|Настройки языка]]
-Данный раздел появился в версии 2.6.6.
+Процесс авторизации пользователей:
+  - Пользователь (еще не абонент) подключается к публичной Wi-Fi точке.
+  - DHCP-сервер назначает ему внутренний IP-адрес, и в системе срабатывает триггер на блокировку интернета через услугу "Белый список" — она ограничивает доступ ко всему интернету, кроме страницы авторизации. Также устанавливаются ограничения на скорость соединения.
+  - Устройство клиента автоматически перенаправляет на страницу авторизации, где нужно ввести номер телефона и выбрать способ подтверждения — получение кода либо по SMS, либо по звонку на указанный номер.
+  - После авторизации, в зависимости от условий соглашения, система снимает ограничивающий полисинг и услугу "Белый список".
-Описание модуля, с которым взаимодействует данный раздел, доступно по [[dpi:dpi_components:module_wi-fi_hotspot|ссылке]].
+Если используется DPI, создается профиль абонента с логином (номер телефона) и назначенным IP. Профиль становится активным, абонент получает доступ к интернету с необходимыми политиками и услугами. После истечения параметра "Время жизни сессии" происходит деавторизация. DPI снимает все услуги и полисинг, удаляет связку "логин-IP" и снова активирует услугу "Белый список" с ограничением доступа, чтобы абоненту требовалась повторная авторизация.\\
+В случае работы через биллинг-систему, она получает запрос с IP и номером телефона, после чего применяет настройки в соответствии с установленными в биллинге параметрами и тайм-аутами.
-Для перехода в раздел Конфигурация откройте меню Управление DPI и нажмите на ХотСпот.
+Конфигурация WiFi HotSpot осуществляется в разделе GUI Управление DPI → ХотСпот.
-{{ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot:pth_1.png? 900 }}
+<note>Данный раздел появился в GUI v2.6.6.
+Описание модуля, с которым взаимодействует раздел, доступно по [[dpi:dpi_components:module_wi-fi_hotspot|ссылке]].</note>
-===== ХотСпот =====
+Раздел содержит вкладки:
-==== Конфигурация Web сервера ====
+  * [[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:management_hotspot#управление_оборудованием|Управление оборудованием]]), в котором необходимо будет создать оборудование с типом "Dpi WiFi Web". После создания выберите данное оборудование из выпадающего списка.
+{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:hotspot.png?nolink&1200 |}}
-Форма для создания нового оборудования представлена ниже.
-{{ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot:save_2.png? 400 }}
-  * Captive portal URL - Будет создан/изменен профиль услуги Белый список с введенным URL. Имя профиля - hotspot_white_list_profile
-  * Время жизни сессии - Используется в случае включенной Wi-Fi авторизации. Время указывается в секундах (по-молчанию - 3600 сек (1 час))
-  * URL для редиректа - после авторизации на Hotspot портале абонент будет перенаправлен на данную страницу (перенаправляется на https://google.com , если поле пустое)
-==== Конфигурация Wi-Fi авторизации ====
+=====Общие настройки=====
+  - В параметре "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.
-В данной части возможно включение/отключение функции Wi-Fi авторизации.
+=====Настройки внешнего вида=====
-В данный момент возможны следующие варианты авторизации:
+В данном разделе возможно изменить иконку (favicon) и логотип, отображаемые на странице портала.
-  * Путем получения кода авторизации по SMS (Форма для настройки будет представленна дальше).
-  * Путем получения кода авторизации по входящему звонку (Форма для настройки будет представленна дальше).
-  * Режим отладки. Детали доступны по кнопке "?" справа от "выключателя" режима  отладки.
-Форма настройки авторизации по SMS и входящему звонку представлена ниже.
+{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:view_settings.png?nolink&700|}}
-{{ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot:wi_fi_3.png? 400 }}
+=====Настройки локализации=====
+  - Добавить язык для настройки локализации по нажатию на **+**. Список доступных языков:\\ {{: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|}}
-В данной форме необходимо указать данные по запросам, которые инициируют отправку SMS/звонка.
+Если настроено 2 и больше языков, на странице авторизации будет кнопка для выбора языка.
-Внешний вид портала Hotspot при включенной Wi-Fi авторизации (по входящему звонку и Режиму отладки) представлен ниже.
+=====Настройки авторизации и клик-оферты=====
+====Настройка WiFi авторизации====
+Wi-Fi авторизация — процесс подключения к сети с идентификацией пользователя через номер телефона или SMS.\\
+Для настройки данного типа авторизации в параметре “Включение Wi-Fi авторизации” выбрать значение “Да”. После этого появятся все настройки WiFi авторизации:
+  - “Включить управление сессиями”.\\ Если выбрано значение “Да” — создание и управление абонентами (авторизация и деавторизация) происходит через DPI и есть возможность настроить “Время жизни сессии” (По истечению времени жизни сессии ХотСпот выполнит скрипт для удаления абонента с DPI и применит тариф авторизации и услугу “Белый список” для его IP-адреса).\\ Если выбрано значение “Нет” — управление абонентами происходит через биллинг или другой сторонний сервис. Здесь нужно настроить HTTP-запрос, который будет отправляться на API биллинга, все соответствующие политики биллинг сам применит к абоненту и снимет с него.
+  - “Тип авторизации”. Доступно два варианта:
+    - “По коду” — для этого варианта нужно настроить HTTP-запросы на сервис, через который будет осуществляться отправка SMS и звонков.\\ Также есть возможность настроить параметр “Последовательная авторизация” — данный режим позволяет выбрать первоначальный способ авторизации, и “Режим отладки” — это позволит отправить код авторизации на email, указанный в поле телефонного номера и протестировать сценарии после авторизации абонента.
+    - “По исходящему звонку” — для этого варианта нужно настроить два параметра:
+      - “Номера телефонов для исходящего звонка” — ввести номера телефонов через запятую, ХотСпот выберет случайный номер телефона для авторизации абонента по исходящему вызову.
+      - “Секретный ключ для генерации хэша” — настроить сервис звонков для отправки HTTP-запроса о получении исходящего звонка от абонента на ХотСпот. По нажатию на иконку вопроса справа от параметра доступна подсказка по настройке API метода ХотСпота для получения сигнала и по созданию хэша.
-{{ :dpi:dpi_components:dpiui:скат_dpiui2_hotspot_режим_отладки.png?400 |}}
+Внешний вид портала HotSpot при включенной Wi-Fi авторизации (по входящему звонку и Режиму отладки):
-==== Click wrap конфигурация ====
+{{:dpi:dpi_components:dpiui:скат_dpiui2_hotspot_режим_отладки.png?600|}}
-Включение данной функции позволяет показывать абонентам текст публичной оферты, с которой они должны согласиться, для того чтобы пользоваться Вашими услугами.
+====Настройка клик-оферты====
+Клик-оферта — показывает абонентам текст публичной оферты, с которой они должны согласиться, для того чтобы пользоваться услугами.
-Внешний вид портала при включенном Click wrap представлен ниже.
+Для настройки данного типа авторизации в параметре “Включение Клик-оферты” выбрать значение “Да”. После этого появятся настройки Клик-оферты:
+  - “Включить управление сессиями”.\\ Если выбрано значение “Да” — создание и управление абонентами (авторизация и деавторизация) происходит через DPI и есть возможность настроить “Время жизни сессии” (По истечению времени жизни сессии ХотСпот выполнит скрипт для удаления абонента с DPI и применит тариф авторизации и услугу Captive Portal для его IP-адреса).\\ Если выбрано значение “Нет” — управление абонентами происходит через биллинг или другой сторонний сервис. Здесь нужно создать HTTP-запрос, который будет отправляться на API биллинга, все соответствующие политики биллинг сам применит к абоненту и снимет с него.
-{{ :dpi:dpi_components:dpiui:скат_dpiui2_hotspot_click_wrap.png?400 |}}
+<note>Данный сценарий возможен только в случае, если клик-оферта работает в связке с [[dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot#настройка_wifi_авторизации|WiFi авторизацией]].
+В случае, если работает __только__ клик-оферта — при подтверждении с абонента снимается ограничение (услуга "Белый список").</note>
-==== DHCP конфигурация ====
+Текст клик-оферты настраивается в разделе “[[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|}}
-. Настроить [[dpi:dpi_components:platform:subscriber_management:subsman_remote#удаленный_запуск_команд_через_ssh|удаленный запуск команд через SSH]]
+Внешний вид портала HotSpot при включенной клик-оферте:
-. Установить на триггер на выдачу нового IP:
+{{:dpi:dpi_components:dpiui:скат_dpiui2_hotspot_click_wrap.png?600|}}
-	* В случае использования HotSpot как портала для Wi-Fi авторизации : <code>ssh dpi_user@dpi_host "/var/dpiui2/add_captive_portal_auth.sh <IP>"</code>
-	* В случае использования HotSpot **ТОЛЬКО** как портала для Клик-оферты: <code>ssh dpi_user@dpi_host "/var/dpiui2/add_captive_portal_click_wrap.sh <IP>"</code>
-==== Конфигурация тарифов ====
+=====Настройки услуг=====
+<note important>Настройки услуг доступны только при параметре “Включить управление сессиями” = “Да” в разделе “Настройки авторизации и клик-оферты”.</note>
-В данной форме доступна настройка параметров тарифных планов, применимых к абонентам при Wi-Fi авторизации.
+В данной форме доступна настройка подключаемых абоненту услуг после того, как он пройдет авторизацию на портале.
-{{ :dpi:dpi_components:dpiui:скат_dpiui2_hotspot_тарифы.png?400 |}}
+{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:services_settings.png?nolink&800|}}
-Тарифы в форме соответствуют следующим именам на DPI:
+Для подключения доступны следующие услуги:
-  * Тариф для авторизации - wifi_hotspot_auth_policing;
+  * 2. Реклама — без профиля
-  * Тариф бесплатного Wi-Fi - wifi_hotspot_policing. Устанавливается абоненту после прохождения авторизации на портале;
+  * 3. Блокировка рекламы — без профиля
-  * Тариф для платного Wi-Fi - wifi_hotspot_payed_policing. Взаимодействие с этим тарифным планом в разработке.
+  * 4. Черный список — как без профиля, так и с возможностью выбора профиля
+  * 11. CGNAT — только с выбором профиля
-==== Управление услугами ====
+  * 50. Нотификация — без профиля
-В данной форме доступна настройка подключемых абоненту услуг после того, как он пройдет авторизацию на портале.
-{{ :dpi:dpi_components:dpiui:скат_dpiui2_hotspot_услуги.png?400 |}}
-В данный момент доступны следующие услуги:
-  * 2. Реклама - без профиля
-  * 3. Блокировка рекламы - без профиля
-  * 4. Черный список - с возможностью выбора профиля
-  * 11. CGNAT - с возможностью выбора профиля
-  * 50. Нотификация - без профиля
-=== Настройки внешнего вида портала ===
-В данном разделе возможно изменить иконку(favicon) и логотип, отображаемые на странице портала.
-{{ :dpi:dpi_components:dpiui:скат_dpiui2_hotspot_настройки_вида.png?400 |}}
+=====Настройки тарифов=====
+<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|}}
-Чтобы сохранить конфигурацию, нажмите на кнопку **"Сохранить"**.
-{{ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot:save_4.png? 500 }}
+=====Настройки 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:management_hotspot:updt_5.png? 500 }}
-=== Удалить конфигурацию ===
+=====Логи=====
-Чтобы удалить конфигурацию, нажмите на кнопку **"Удалить"**.
+В данном подразделе содержатся лог файлы интерфейса и Клик-оферты.\\
+Для обновления списка нажмите на кнопку "Обновить".
-{{ dpi:dpi_components:dpiui:user_guide:ssg_control_section:management_hotspot:dlt_6.png? 500 }}
+=====Управление конфигурацией=====
+{{:dpi:dpi_components:dpiui:user_guide:ssg_control_section:conf_mng.png?nolink&700|}}
-===== Логи =====
+  - Сохранить конфигурацию
+  - Обновить конфигурацию
+  - Перейти на страницу документации раздела ХотСпот
+  - Удалить конфигурацию
-В данном подразделе содержатся лог файлы интерфеса и Клик-оферты.
-Для обновления списка нажмите на кнопку **"Обновить"**.
-===== Wiki ====
-Для получения информации о полном списке параметров ознакомьтесь с содержимым прикрепленной страницы.