Для кастомизации WEB-портала в SoftWLC включен Конструктор Порталов, с помощью которого пользователи могут настраивать сценарии работы и внешний вид порталов, используемых при Hotspot-авторизации. Пользователи Конструктора могут создавать и удалять порталы, выбирать их фон и содержание (текст, изображения), устанавливать различные режимы и сценарии авторизации для каждого из порталов. Сам по себе Конструктор не выполняет никаких действий в цепочке предоставления услуги абонентом. Это инструмент, служащий исключительно для настройки.

В Конструкторе порталов существует возможность настройки работы Портала, как с точками доступа Элтекс, так и c BRAS (ESR-1000), который используется для подключения к платформе точек доступа сторонних производителей. В случае работы с BRAS в Конструкторе порталов дополнительно необходима настройка в разделах "Взаимодействие с BRAS" и "Доступ к PCRF".Установка производится с помощью пакета

Управление сервисом

...

Установка

Блок кода

language	bash
theme	RDark

apt-get install eltex-portal-

...

cnstructor

Способы запуска/остановки

Интерфейс работает под tomcat (версии 6 и выше), поэтому отдельных команд для запуска/остановки не предусмотрено.

Действие

Команда

Ответ

Проверка состояния

service eltex-portal-cnstructor status

Сервис запущен

Подсказка
Active: active (running)

Cервис не запущен

Предупреждение
Active: failed

Запуск сервиса

service eltex-portal-cnstructor start

Сервис успешно запущен

Подсказка
Active: active (running)

Остановка сервиса

service eltex-portal-cnstructor stop

Сервис успешно остановлен

Подсказка
Active: failed

Перезапуск сервиса

service eltex-portal-cnstructor restart

Сервис успешно перезапущен

Подсказка
Active: active (running)

Конфигурация

...

/etc/eltex-portal-constructor/application.conf

основной Основной конфигурационный файл. Пример дефолтной конфигурации:

Раскрыть

Блок кода

language

py

js
title	/etc/eltex-portal-constructor
collapse	true

auth-service {
    host = localhost
    port = 21812
    timeout = 10s
    retries = 3
    secret = eltex
    # pap, chap, mschapv2
    protocol = pap
}

login {
    # Количество попыток входа в панель администратора до наступления блокировки
    maxAttemptsLogin = 3
    maxAttemptsIP = 5
    # Количество минут блокировки после достижения максимального числа попыток входа в панель администратора
    blockTime = 5m
}

database {
    host = localhost
    port = 3306
    name = ELTEX_PORTAL
    user = javauser
    password = javapassword

    pool {
        # Time to wait for a connection
        connectionTimeout = 10s
        # Time to wait for connection validation
        validationTimeout = 3s

        min = 1
        max = 10
    }

    cache {
        # Limit of cached simple entries count (for each query type)
        maxEntries = 1000
        # Limit of total cached portal resources size
        maxResourceBytes = 32m
        # Maximum time to retain items in the cache
        expireTime = 30s
    }
}

sso {
    enabled = false
    # Must be in double quotes
    version = "1.0"

    rest {
        scheme = http
        host = localhost
        port = 80
        sso_api_path = /apiman-gateway/b2b_test
    }
    auth {
        scheme = http
        host = localhost
        port = 80
        authentication_path = /auth/realms/b2b/protocol/openid-connect/auth
        logout_path = /auth/realms/b2b/protocol/openid-connect/logout
    }


    params {
        client_id = id
        # URL of epadmin, URL must be in double quotes (!!!)
        redirect_uri = "http://localhost:8080/epadmin/sso"
        client_secret = secret
    }
}

jetty {
    https {
        port = 9444
        keystorePass = 12345
        keystoreFile = /etc/eltex-portal-constructor/localhost.pfx
        keystoreType = PKCS12
        keyAlias = 1
        ciphers = [
            TLS_RSA_WITH_AES_128_CBC_SHA256
            TLS_RSA_WITH_AES_128_CBC_SHA
            TLS_RSA_WITH_AES_256_CBC_SHA256
            TLS_RSA_WITH_AES_256_CBC_SHA
        ]
    }
}

validation {
    public_key = /etc/eltex-doors/keys/public.pem
}

Параметры	Описание
auth-service - подключение к серверу авторизации пользователей
host	адрес Aдрес сервиса авторизации.
port	портПорт, на который будут отправляться запросы.
timeout	время Время ожидания ответа от сервера.
retries	количество Количество попыток.
secret	ключевое Ключевое слово для шифрования сообщений.
protocol	протокол Протокол авторизации, поддерживаемый сервером.
login - настройки защиты от подбора паролей
maxAttemptsLogin	количество Количество попыток авторизации под одним и тем же логином, после которого будет включена капча.
maxAttemptsIP	количество Количество попыток авторизации с одного IP-адреса, при превышении попытки авторизации с этого адреса будут блокироваться.
blockTime	время Время блокировки IP-адреса.
database - настройки работы с БД
host	Адрес сервера БД.
port	Порт, на который сервер БД принимает входящее подключение.
name	Название БД.
user	Имя пользователя БД.
password	Пароль пользователя БД.
pool	Управление соединениями к БД. connectionTimeout - Время время жизни коннекта при бездействии. validationTimeout - интервал проверки бездействующих коннектов. min - минимальное количество коннектов. max - максимальное количество коннектов.
cache	Настройки кэширования. maxEntries - максимальное количество элементов в кэше. maxResourceBytes - размер кэша. expireTime - время хранения данных в кэше.
sso	Блок настроек взаимодействия с SSO. enable - влюкчение/выключение взаимодействия. rest - блок настроек хоста и путей методов rest-сервера. auth - блок настроек хоста и путей методов auth-сервера. params - блок настроек идентификационной информации для SSO.
jetty	Блок настроек взаимодействия с jetty.
validation	Блок настроек валидации токенов для взаимодействия с другими сервисами SWLC. public_key - путь до публичного ключа.

/etc/eltex-portal-constructor/log4j2.xml

Файл настроек логирования.

Блок кода

language	js
title	/etc/eltex-portal-constructor/log4j2.xml
collapse	true

<?xml version="1.0" encoding="UTF-8"?>

<Configuration monitorInterval="10">

    <Properties>
        <Property name="rootLevel">${env:LOG_LEVEL:-ERROR}</Property>

        <Property name="baseDir">/var/log/eltex-portal-constructor</Property>
        <Property name="maxFileSize">20 MB</Property>
        <Property name="accumulatedFileSize">10 GB</Property>
        <Property name="lastModified">4d</Property>
        <Property name="maxCount">20</Property>
        <Property name="logPattern">%d{ISO8601} [%t] %-5p %logger{12} %C{1}.%M(line:%L). %m%n</Property>

        <Property name="consoleLevel">${env:CONSOLE_LEVEL:-OFF}</Property>

        <Property name="gelfLevel">${env:GELF_LEVEL:-OFF}</Property>
        <Property name="gelfHost">${env:GELF_HOST:-udp:lab3-test.eltex.loc}</Property>
        <Property name="gelfPort">${env:GELF_PORT:-12201}</Property>
    </Properties>

    <Appenders>

        <Console name="STDERR" target="System.err">
            <PatternLayout pattern="${logPattern}"/>
        </Console>

        <RollingFile name="RollingFile"
                     fileName="${baseDir}/portal-constructor.log"
                     filePattern="${baseDir}/log/portal-constructor-%i.log.gz">
            <PatternLayout pattern="${logPattern}"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="${maxFileSize}"/>
                <OnStartupTriggeringPolicy />
            </Policies>
            <DefaultRolloverStrategy max="${maxCount}">
                <Delete basePath="${baseDir}" maxDepth="3">
                    <IfFileName glob="*/portal-constructor-*.log.gz">
                        <IfAny>
                            <IfAccumulatedFileSize exceeds="${accumulatedFileSize}"/>
                            <IfLastModified age="${lastModified}"/>
                        </IfAny>
                    </IfFileName>
                </Delete>
            </DefaultRolloverStrategy>
        </RollingFile>

        <RollingFile name="UserActionsRollingFile"
                     fileName="${baseDir}/user-actions.log"
                     filePattern="${baseDir}/log/user-actions-%i.log.gz">
            <PatternLayout pattern="${logPattern}"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="${maxFileSize}"/>
                <OnStartupTriggeringPolicy />
            </Policies>
            <DefaultRolloverStrategy max="${maxCount}">
                <Delete basePath="${baseDir}" maxDepth="3">
                    <IfFileName glob="*/user-actions-*.log.gz">
                        <IfAny>
                            <IfAccumulatedFileSize exceeds="${accumulatedFileSize}"/>
                            <IfLastModified age="${lastModified}"/>
                        </IfAny>
                    </IfFileName>
                </Delete>
            </DefaultRolloverStrategy>
        </RollingFile>

        <Gelf name="Gelf" host="${gelfHost}" port="${gelfPort}" version="1.1" facility="eltex-portal-constructor"
              extractStackTrace="true" originHost="%host{fqdn}" maximumMessageSize="8192" >
            <Field name="thread" pattern="%t"/>
            <Field name="level" pattern="%level"/>
            <Field name="severity" pattern="%-5level"/>
            <Field name="logger" pattern="%logger{12}"/>
            <Field name="location" pattern="%C{1}.%M(line:%L)"/>
        </Gelf>

    </Appenders>


    <Loggers>
        <Root level="${rootLevel}">
            <AppenderRef ref="RollingFile"/>
            <AppenderRef ref="STDERR" level="${consoleLevel}"/>
            <AppenderRef ref="Gelf" level="${gelfLevel}"/>
        </Root>

        <Logger name="UserActionsLogger" additivity="false" level="INFO">
            <AppenderRef ref="UserActionsRollingFile"/>
            <AppenderRef ref="Gelf" level="${gelfLevel}"/>
        </Logger>

        <Logger name="io.grpc.netty"               level="ERROR"/>
        <Logger name="net.jradius"                 level="ERROR"/>
        <Logger name="org.jooq"                    level="ERROR"/>
        <Logger name="com.zaxxer"                  level="ERROR"/>
        <Logger name="org.eclipse.jetty"           level="ERROR"/>
        <Logger name="org.springframework"         level="ERROR"/>
        <Logger name="org.eltex.portal.objectpool" level="ERROR"/>
        <Logger name="org.apache"                  level="ERROR"/>
        <Logger name="jndi"                        level="ERROR"/>

        <Logger name="org.jooq.impl.DefaultConnectionProvider" level="OFF"/>

    </Loggers>

</Configuration>

Автоматическое перечитывание конфигурации логгера:

Без форматирования
<Configuration monitorInterval="10">

Уровень логирования:

Без форматирования
<Property name="rootLevel">${env:LOG_LEVEL:-ERROR}</Property>

Базовая директория хранения логов:

Без форматирования
<Property name="baseDir">/var/log/eltex-portal-constructor</Property>

Максимально допустимый размер файла (при его превышении создается новый файл. а старый архивируется):

Без форматирования
<Property name="maxFileSize">20 MB</Property>

Суммарный размер логов (текущий файл + архивные). При его превышении наиболее старые файлы будут удаляться:

Без форматирования
<Property name="accumulatedFileSize">10 GB</Property

Срок хранения логов, файлы модифицированные раннее этого срока будут удаляться:

Без форматирования
<Property name="lastModified">4d</Property>

Максимальное количество архивных файлов, при его превышении наиболее старые файлы будут перезаписываться:

Без форматирования
<Property name="maxCount">20</Property>

Блок настройки перенаправления логов в Graylog (уровень логирования, адрес, порт):

Без форматирования
<Property name="gelfLevel">${env:GELF_LEVEL:-OFF}</Property> <Property name="gelfHost">${env:GELF_HOST:-udp:lab3-test.eltex.loc}</Property> <Property name="gelfPort">${env:GELF_PORT:-12201}</Property>

Системные настройки в GUI

...

Section

Column

width	40%

Image Modified

Column

В данном разделе содержаться содержатся системные настройки Конструктора Порталов, а так же настройки для интеграции Eltex Portal и Конструктора Порталов с сервисами и платформами (авторизация через ЕСИА, АТС Смольного, рекламная платформа Волга).

Конструктор порталов

...

Section

Column

width	40%

Image Modified

Column

Настройки страницы Конструктора порталов.

Параметры:

Заголовок страницы – название страницы, отображаемое в заголовке страницы.
Значок (favicon) – значок, отображаемый в заголовке.
Время сессии (мин) – время бездействия пользователя, после которого http-сессия будет разорвана и потребуется повторная авторизация.
Хост портала - адрес сервиса Eltex Portal, нужен для отправки команды на перечитывание данных (применения изменений на виртуальных порталах без перезапуска tomcat). Данная Данная настройка необходима, если Конструктор и Портал установлены на разных серверах.
Порт портала - порт, который прослушивает сервис Eltex Portal. Если Конструктор и Портал установлены на разных серверах, то между ними должны проходить пакеты в порту 8080 в случае наличия firewall.
Настройки контента - установка ограничений на размер, разрешение и продолжительность загружаемых медиафайлов.

Уведомления

...

Section

Column

width	40%

Image Modified

Column

Уведомления администраторов системы об ошибках в работе портала. Уведомления отправляются по почте и SMS.

При добавлении нового получателя нужно выбрать способ отправки. Уведомление может быть отправлено по:

SNMP
Email
SMS

Типы уведомлений

Section

Column

width	40%

SNMP

Image Modified

Электронная почта

Image Modified

SMS

Image Modified

Column

Система оповещения предназначена для оповещения пользователей SoftWLC о проблемах на WEB-портале. Для добавления нового хоста (тип SNMP) следует указать следующие данные:

Хост – адрес сервера -получателя трапов;
Порт – номер порта, прослушиваемого получателем, как правило, используется номер 162;
Community – строка символов, в которой содержится пароль в открытом виде.
Тип PDU – TRAP или INFORM;
Время ожидания ответа (сек) – время, в течение которого ожидается ответ от получателя, действителен только для INFORM;
Количество попыток – количество попыток отправки сообщений типа INFORM с интервалом, равным таймауту;.

Доступ к NBI

...

Section

Column

width	40%

Image Modified

Column

Интерфейс для взаимодействия между компонентами SoftWLC.

Для корректного функционирования портала необходимо настроить его связь с EMS сервером через Northbound Interface. Это позволяет Конструктору Порталов получать из EMS все необходимые сведения, например список тарифных планов и их параметры.

Параметры:

Протокол – протокол передачи данных к NBI (HTTP или HTTPS) Зависит . Зависит от настроек NBI на сервере NBI.
Хост – адрес сервера NBI.
Порт – порт, прослушиваемый сервером NBI.
Путь к WSDL – адрес расположения WSDL-файла на сервере. Как правило, это всегда "/axis2/services/RadiusNbiService?wsdl".
Имя пользователя – логин пользователя.
Пароль – пароль пользователя

При переходе на версию 1

.

8 для доступа в NBI нужно использовать служебную запись softwlc_service/service. Если в 1.7 использовалась стандартная запись admin/password, то при переходе на 1.8 она автоматически заменится на служебную. Если использовалась другая пара логин/пароль, то при переходе на 1.8 нужно обновить данные вручную.

Доступ к NGW

...

Section

Column

width	40%

Image Modified

Column

интерфейс Интерфейс для работы с SMS-шлюзами.

Здесь настраиваются параметры связи Конструктора Порталов с Notification Gateway. Эта связка необходима Конструктору для считывания с NGW информации о поддержке различных типов авторизаций. В результате, если NGW, например, не настроен на авторизацию по входящему звонку, то Конструктор не будет предлагать пользователю этот элемент настройки.

Параметры:

Хост – адрес сервера NGW. Если Если Конструктор и NGW установлены на одном сервере, то значение должно быть "localhost".
Порт – порт, прослушиваемый сервером NGW.

Взаимодействие с BRAS

...

Section

Column

width	40%

Image Modified

Column

Настройка доступа к BRAS.

Когда установлен флаг "Взаимодействие с BRAS", включается поддержка BRAS на стороне портала. После активации в настройках портала станут доступны тарифные планы PCRF.

Подробнее о настройке BRAS здесь: BRAS. Руководство по настройке.

Доступ к PCRF

...

Section

Column

width	40%

Image Modified

Column

Настройка взаимодействия с PCRF. Обеспечивает доступ к управлению и системе тарификации сессий абонентов, подключенных через BRAS.

Параметры:

Хост – адрес сервера PCRF;.
Порт – порт, прослушиваемый сервером PCRF;.
Таймаут чтения – время (сек), которое ждёт портал, пока не получит ответ от PCRF;.
Таймаут записи – время (сек) на отправку сообщения от портала к PCRF.

Доступ к Mercury

...

Section

Column

width	40%

Image Modified

Column

доступ Настройка доступа к сервису управления портальными учетными записями eltex-mercury.

Параметры:

Хост – адрес сервера Mercury.
Порт – порт, прослушиваемый сервисом Mercury.

Личный кабинет

...

Section

Column

width	40%

Image Modified

Column

Ссылка для перехода в Личный кабинет пользователя. Отображается на панели управления Конструктором.

Параметры:

Протокол - протокол, по которому происходит взаимодействие с ЛК (HTTP/HTTPS).
Хост – адрес сервера ЛК, по которому пользователи могут подключиться из внешней сети.
Порт – порт, прослушиваемый сервером ЛК.

Вход через ЕСИА

...

Section

Column

width	40%

Image Modified

Column

Настройка интеграции с ЕСИА (авторизация через госуслуги).

Параметры:

Тип среды ЕСИА - Промышленная или тестовая.
Мнемоника системы - Идентификатор системы в ЕСИА.
Области доступа (scope) - действия, которые может выполнять система (в данном случае Eltex Portal) от имени пользователя.
Сертификат и ключ (контейнер PKC#12) - сертификат системы, зарегистрированный в ЕСИА при подаче заявки.
Пароль от контейнера PKC#12 - приватный ключ от контейнера с сертификатом.

Интеграция с АТС Смольного

...

Section

Column

width	40%

Image RemovedImage Added

Column

Настройка интеграции с АТС Смольного для проведения MAC-авторизации совместно с общей базой данных других провайдеров.

Параметры:

Включить интеграцию - глобальное включение возможности интеграции для портала. Для каждого виртуального портала необходимо установить дополнительный флаг активации этой функции.
URL - адрес для интеграции.
Идентификатор NAS - индивидуальный идентификатор, используемый в запросах на сервис авторизации.
Секретное слово для NAS - последовательность, используемая для отправки запросов на сервис авторизации.
Максимальное количество соединений - количество одновременно работающих коннектов, которое может поднять сервис eltex-portal для взаимодействия с системой авторизации АТС Смольного.
Таймаут соединения в милисекундах - время ожидания ответа от сервиса авторизации.

Идентификатор NAS - индивидуальный идентификатор, используемый в запросах на сервис авторизацию

Секретное слово для NAS - последовательность, используемая для отправки запросов на сервис авторизации.

Доступ к платформе Волга

...

Section

Column

width	40%

Image Modified

Column
Настройка доступа к платформе Волга. v1.18_Настройка интеграции с рекламной площадкой Волга (essen-retail)

...

Section

Column

width	40%

Image Modified

Column
Настройка доступа к серверу опросов : v1.18_Polly

...

Section

Column

width	40%

Image Modified

Column

Настройка сервиса оплаты:

Максимальное количество соединений - максимальное количество одновременный подключений в сторону сервиса оплаты.
Таймаут соединения - время, через которое произойдёт разрыв подключения к сервису оплаты.

...

Галерея

...

Section

Column

width	40%

Image Modified

Column

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

Поиск выполняется сразу по полям таблицы: Название, Домен, Описание.

Добавление/изменение изображений/видео

...

Section

Column

width	40%

Image RemovedImage Added

Column

Добавить изображение или видео в галерею можно при настройке виртуальных порталов (при выборе картинок) и непосредственно в Галерее. Процесс добавления медиафайла в Галерее:

Нажать кнопку "Загрузить"
В открывшемся окне выбрать нужное изображение/видео на ПК
Указать Домен домен ресурса и добавить описание. Домен ресурса – домен видимости изображения для пользователя Конструктора Портала. Пользователи Конструктора портала могут видеть те изображения, домен которых совпадает с доменом роли учетной записи пользователя или является его поддоменом. Дефолтные изображения в Конструкторе порталов, которые присутствуют в нем с момента инсталляции и не имеют доменов, видны всем пользователям Конструктора Порталов.

После этого новое изображение/видео добавится в галерею.

Уже загруженное изображение/видео можно изменить. Для этого нужно выделить один из элементов галереи и нажать кнопку "Изменить". Если выбрать несколько элементов, то кнопка "Изменить" будет неактивна.

При изменении имени, домена, изображения или описания, привязка данного элемента к порталам сохраняется. Таки Таким образом, можно установить один и тот же элемент на несколько различных порталов, а потом изменить изображение/видео сразу на всех элементах.

Удаление изображений/видео

...

Section

Column

width	40%

Image Modified

Column

Чтобы удалить файл из галереи, нужно выбрать удаляемый файл и нажать кнопку "Удалить".

В процессе удаления произойдет проверка на то, используется ли использование где-нибудь это этого изображение/видео. Если изображение/видео нигде не используется, то появится сообщение об успешном удалении.

Если некоторые из удаляемых изображений уже где-либо задействованы, то отобразится ошибка, в которой будет указан список виртуальных порталов, на которых они используются.

...

Стартовая страница

...

Section

Column

width	40%

Image Modified

Column

Приветственная страница конструктора порталов. В Dashboard'е отображаются данные:

Имя, фамилия, логин пользователя.
Роль пользователя (не отображается для пользователя 'admin').
время Время последней авторизации пользователя.
количество Количество доступных (находящихся в домене пользователя) порталов.
Количество порталов без тарифных планов (авторизация пользователей на этих порталах невозможна).

Личный Кабинет

...

Кнопка "Личный Кабинет" в боковой панели Конструктора Порталов предназначена для быстрого и удобного для пользователя перемещения между Конструктором Порталов и Личным Кабинетом. Т.к. авторизация в Конструкторе и ЛК производится через одну систему: Auth Service, то по нажатию на данную кнопку в новой вкладке браузера у пользователя открывается ЛК, при чем авторизация в ЛК уже не требуется, она автоматически производится.

Порталы

...

Создание нового портала

Section

Column

width	40%

Image Removed

Image Modified

Column

Создать новый портал можно, нажав кнопку "Создать новый портал" в боковой панели Конструктора. При создании нового портала необходимо указать его Имя и Домен. Имя портала потребуется при конфигурирование параметра Virtual Portal Name SSID точки доступа, чтобы привязать этот SSID к созданному кастомизированному под клиента порталу. Домен портала будет определять пользователей Конструктора, которые смогут его видеть (домен портала должен совпадать с доменом учетной записи пользователя Конструктора или быть его поддоменом). WEB-портал может содержать неограниченное количество страниц (порталов), обладающих уникальной кастомизацией для соответствующего клиента.

По умолчанию после инсталляции в Конструкторе присутствует портал "Default". Этот Для редактирования этот портал доступен только для Админитратора Конструктора Порталов. Когда в Конструкторе создается новый портал, по умолчанию он содержит в себе все настройки идентичные порталу "Default". Поэтому Администратор может настроить портал "Default" таким образом, чтобы другие порталы при создании уже были преднастроены и требовали минимальных действий при кастомизации.

Копирование портала

...

Section

Column

width	40%

Image Modified

Column

Копирование портала осуществляется с помощью нажатия на пиктограмму
Копирование включает в себя :

Настройки портала.
Внешний вид портала.
Домен портала.

Общие настройки

...

Вкладка "Общие"

Основные

Section

Column

width	40%40

Image Modified

Подразделение "Общие настройки" включает несколько групп настроек:

Общие:

Основные:

Column

Рабочее расписание - расписание, по которому выбранный портал активирует свою работу.

Основной язык – язык, который по умолчанию используется при открытии портала на клиентском устройстве, если язык, используемый на устройстве, не поддерживается порталом. Определение языка выполняется по заголовкам, передаваемым пользовательским устройством (поле Accept-Language). Многие устройства передают несколько языков в этом поле, в случае если один из передаваемых языков поддерживается порталом, будет отображаться язык из этого списка вместо основного.

Длина генерируемого пароля – количество символов в пароле, генерируемом порталом автоматически при регистрации пользователя.

Время свободного повторного входа – задает время, в течение которого, пользователь не будет возвращаться на портал (страница "Добро пожаловать"), при повторном подключение . (актуально для схемы включения через BRAS) .

Время хранения MAC-адреса пользователя – задает период хранения MAC-адреса пользователя. При повторном подключении, система автоматически распознает пользователя, без повторной регистрации на портале.

Добавлять идентификатор сессии в URL перенаправления – включает уникальный идентификатор сессии пользователя при выполнении финального редиректа с портала на внешний сайт. Выполняется подстановка идентификатора сессии в URL в следующих местах: при переходе с финальной страницы и при клике по баннеру на странице "поздравления"

Разрешить смену тарифа - включает страницу смены тарифа после прохождения клиентом его портальных сценариев.

Включить интеграцию с АТС Смольного - включает проверку наличия MAC-адреса пользователя в базе данных АТС Смольного. Флаг становится доступным только при глобальном включении интеграции с АТС Смольного.

Отображать пользовательское соглашение - выбор места.

Рекламная рассылка

...

Section

Column
width 40
Image Added

Column
Спрашивать согласие пользователей на рассылку - функция позволяет настроить предоставление услуги, по выбору пользователя или только с подтверждением согласия пользователя на рекламную рассылку.
Обязательное поле - функция позволяет не предоставлять услугу при отказе пользователя. Поле появляется при активации параметра "Спрашивать согласие на рассылку".

Дополнительные параметры при регистрации

...

Section

Column
width 40
Image Added

Column
Запрашивать дополнительные параметры при регистрации – функция позволяет собрать дополнительные данные о пользователях: имя, фамилию, адрес электронной почты. Если установлен флаг “Обязательное поле”, то пользователю придется заполнять эти поля в обязательном порядке. (Не поддерживается одновременно с активированным сервисом оплаты).
После активации параметра, станет доступна возможность выбора запрашиваемых полей.

Подтверждение возраста

...

Section

Column
width 40
Image Added

Column
Запрашивать дополнительные параметры при регистрации - функция позволяет настроить предоставление услуги пользователям, подтвердившим на портале достижения определенного возраста.Режим работы -
После активации параметра, становятся доступны дополнительные поля:
Обязательное поле - подтверждение возраста становится обязательным, в случае отказа, услуга не будет предоставляться.
Возраст - ограничение возраста.

Вкладка "Режим работы"

...

Вкладка отвечает за выбор порядка прохождения авторизации пользователя на портале.

...

Основные

...

Section

Column
width 40
Image Added

Column
Вход через ЕСИА (Госуслуги) - включает на портале форму авторизации пользователя через Единую Систему Идентификации и Аутентификации. Опция активна только в случае, если проведена интеграция Notification GW с ЕСИА.
Авторизация - пользователь Wi-Fi сможет авторизоваться на портале только если он будет иметь заранее выданные логин и пароль, которые он введет в форму на портале. Будет отсутствовать возможность пройти авторизацию путем подтверждения своего номера телефона по звонку или SMS. Генерирует и выдает логины и пароли пользователям обычно Администратор организации.
Регистрация - пользователь Wi-Fi на странице портала будет иметь возможность авторизации в системе, только подтвердив свой номер телефона (например, указав его в на портале и получив SMS с паролем). У пользователя не будет возможности вести ввести на портале сразу полученный заранее логин и пароль. Режим характерен для классических Hotspot с авторизацией по звонку или SMS.
Подтверждение личности (выбор
Авторизация - пользователь Wi-Fi сможет авторизоваться на портале, только если он будет иметь заранее выданные логин и пароль, которые он введет в форму на портале. Будет отсутствовать возможность пройти авторизацию путем подтверждения своего номера телефона по звонку или SMS. Генерирует и выдает логины и пароли пользователям обычно Администратор организации.

Подтверждение личности

Выбор вариантов подтверждения пользователем своего номера телефона. Одновременно можно активировать на портале несколько вариантов

...

, тогда пользователь сможет выбрать для себя наиболее оптимальный способ

...

.

Section

Column

width	40

Image Added

Column

Режим демонстрации - демо-режим, который не требует требует интеграции Notification GW с какими-либо системами и работает "из коробки". С помощью этого режима можно посмотреть работу портала на начальном этапе инсталляции всей системы. При выборе этого режима пользователь должен ввести на портале свой номер телефона, после чего откроется страница портала, в которой поле "Логин" уже будет заполнено его номером телефона, а поле "Пароль" также будет заполнено автоматически сгенерированным паролем. Для авторизации пользователю будет достаточно нажать кнопку "Подключиться", при этом никаких SMS высылать\получать не нужно. Однако, данный

Предупреждение

Данный режим не гарантирует идентификацию абонента, т.к. он может ввести номер НЕ своего телефона, тем самым обеспечив свою анонимность. Данный режим рекомендуется использовать только для демонстрации, а не в реальной эксплуатации, т.к. это может противоречить законодательству страны, где предоставляется услуга, например Постановление Правительства Российской Федерации от 31.07.2014 № 758

SMS пользователю - подтверждение номера телефона путем получения пользователем SMS с паролем. Пользователь на портале должен ввести свой номер телефона, после чего система генерирует для него пароль и высылает пользователю по SMS. Пользователь на странице портала вводит этот пароль (поле "Логин" уже предзаполнено его номером телефона) и тем самым авторизовывается, подтверждая, что этот номер действительно принадлежит ему. Режим требует интеграции Notification GW с SMS-шлюзом оператора, через который будут отправляться SMS.

SMS от пользователя - Подтверждение подтверждение номера телефона путем отправки пользователем SMS с паролем на настроенный номер.

Звонок от пользователяпользователю- Подтверждение подтверждение (регистрация) учетной записи пользователя при помощи обратного звонка на номер пользователя.

Звонок пользователюот пользователя - Подтверждение подтверждение (регистрация) учетной записи пользователя при помощи обратного совершаемого им звонка на номер пользователя.

Отправка SMS - раздел для настройки параметров отправки SMS при авторизации на портале:

Основные:

Код страны по умолчанию - выбор кода страны по умолчанию для заполнения номера телефона на портале.

Урезать SSID в SMS - активация обрезает текст SMS для гарантированной отправки текста в 1 SMS

Количество секунд между попытками получения SMS - число секунд между попытками отправки SMS пользователю.

Выбор кода страны:

Разрешить выбор кода страны - активирует возможность выбора кода страны пользователем, с выбором стран в начале списка.

Безопасность - раздел для настройки параметров безопасности портальной авторизации.

Списки доступа:

Список доступа по MAC - выбор списка доступа по MAC, составленного в ЛК.

Список доступа по телефонному номеру - выбор списка доступа по номеру телефона, составленного в ЛК.

Captha:

Использовать captcha - активирует функционал captcha на портале и его настройку.

SMS-антиспам:

Включить SMS-антиспам - активирует функционал SMS-антиспам на портале и его настройку.

Страницы – дополнительные страницы виртуального портала, используются для организации перехода между сложными сценариями и оповещения пользователей.

Инструкция – активация инструкции на страницах портала;

Поздравление – активация страницы поздравления об успешном подключение к сети Интернет.(Страница "Поздравление" открывает настройку дополнительных финальных баннеров)

Добро пожаловать - активация подтверждения номера/логина пользователем на портале при mac-авторизации.

Cookie отключены - активация предупреждающей страницы о том, что на клиентском устройстве отключены cookie.

Страница 1-5 – активация дополнительных страниц виртуального портала.

Настройки отправки SMS

Вход через Fan ID - подтверждение (регистрация) учетной записи пользователя при помощи "паспорта болельщика".

Вкладка "Отправка SMS"

...

Раздел для настройки параметров отправки SMS при авторизации на портале.

Основные

Section

Column

width	40%

Image Modified

Image Removed

Column

Код страны по умолчанию – номера телефонов пользователей-иностранцев имеют префикс, отличный от "+7". На портале пользователь имеет возможность выбора префикса своей страны. В данной настройке выбирается префикс, который пользователь будет видеть по умолчанию после открытия портала.

Урезать SSID в SMS – опция, уменьшающая длину отправляемого пользователю SMS за счет уменьшения длины названия SSID (если его имя слишком длинное), чтобы уместить все в одно сообщение. Это приводит к экономии на отправке SMS.

Количество секунд между попытками получения SMS - число секунд между попытками отправки SMS пользователю.

Выбор кода страны

Section

Column

width	40

Image Added

Column

Разрешить выбор кода страны - включает\выключает на портале возможность выбора кода страны. Если опция выключена, то пользователь сможет указать свой номер телефона только с префиксом, установленным по умолчанию. Обычно опцию включают, если ожидается, что на портале будут авторизовываться проходить авторизацию иностранцы.

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

Урезать SSID в SMS – опция, уменьшающая длину отправляемого пользователю SMS за счет уменьшения длины названия SSID (если его имя слишком длинное), чтобы уместить все в одно сообщение. Это приводит к экономии на отправке SMS.

Настройки безопасности

Вкладка "Безопасность"

...

Раздел для настройки параметров безопасности портальной авторизации.

Списки доступа

Section

Column

width	40%

Image Modified

Image Removed

Image Added

Image Removed

Column

Список доступа по MAC - выбор списка доступа по MAC, составленного в ЛК.

Список доступа по телефонному номеру - выбор списка доступа по номеру телефона, составленного в ЛК.

Списки доступа позволяют ограничить доступ к порталу по MAC-адресу клиента или телефонному номеру. Существует два вида списков:

Белые - все адреса/номера из списка имеют доступ к порталу, остальные нет. Если МАС-адрес/телефонный номер клиента отсутствует в белом списке, при редиректе на портал, он получит страницу портала, с пояснением что его он не находится в белом списке;
Черные - все адреса/номера имеют доступ к порталу, адреса из списка нет. Если МАС-адрес/телефонный номер клиента находится в черном списке, при редиректе на портал, он получит страницу портала, с пояснением что он находится в черном списке.

Captcha

Section

Column

width	40

Image Added

Column

Использовать captcha – активировать capcha на портале для защиты от ботов.

Количество символов в captcha - число символов, формируемых в изображении captcha. Чем больше символов, тем выше защита от ботов, но тем более сложной становится процедура заполнения captсha пользователем. Опция появляется в настройках только после активации опции "Использовать captcha".

SMS-антиспам

Section

Column

width	40

Image Added

Column

Включить смс-антиспам – функция, ограничивающая частоту отправки SMS пользователю. В случае превышения количества запрошенных SMS пользователь отправляется в блокировку (по MAC-адресу) и не сможет зарегистрироваться. При успешной авторизации пользователя, счетчик сбрасывается. При активации опции становится доступна настройка количества попыток получения СМС перед наступлением блокировки, становятся доступны дополнительные настройки.

Количество попыток с устройства по получению SMS с кодом до наступления бана - количество попыток получения SMS перед наступлением блокировки.

Количество секунд бана после превышения числа попыток - количество секунд между попытками получения СМС получения SMS и времен блокировки.

Выбранный список доступа – список МАС адресов, позволяет ограничить доступ к порталу по MAC адресу клиента. Существует два вида списков:

Белые - все адреса из списка имеют доступ к порталу, остальные нет. Если МАС адрес клиента отсутствует в белом списке, при редиректе на портал, он получит страницу портала, с пояснением что его MAC адрес не находится в белом списке;
Черные - все адреса имеют доступ к порталу, адреса из списка нет. Если МАС адрес клиента находится в черном списке, при редиректе на портал, он получит страницу портала, с пояснением что его MAC адрес находится в черном списке.

Список доступа по телефонному номеру - список телефонных номеров, позволяет ограничить доступ к порталу по номеру клиента.

Языковые настройки

...

width	40%

Image Removed

...

Вкладка "Страницы"

...

Дополнительные страницы виртуального портала, используются для организации перехода между сложными сценариями и оповещения пользователей.

Section

Column

width	40

Image Added

Column

Инструкция – активация инструкции на страницах портала.

Поздравление – активация страницы поздравления об успешном подключение к сети Интернет. (Страница "Поздравление" открывает настройку дополнительных финальных баннеров).

Добро пожаловать - активация подтверждения номера/логина пользователем на портале при mac-авторизации.

Cookie отключены - активация предупреждающей страницы о том, что на клиентском устройстве отключены cookie.

Страница 1-5 – активация дополнительных страниц виртуального портала.

Языковые настройки

...

Портал поддерживает одновременно несколько языков: русский, английский, казахский, китайский, французкий немецкий, испанский, итальянский, фарси, японский, монгольский, бурятский и узбекский.
Пользователь может переключать языки, по своему усмотрению, в левой части вкладки, путем установки флага напротив нужных. По умолчанию доступны 2 языка: английский и русский. Остальные языки не активны. Если было обновление с более ранних версий SoftWLS, то уже ранее созданные порталы сохраняют языковые настройки.

Section

Column

width	40%

Image Added

Column

Для каждого языка доступны следующие настройки:

URL для перенаправления – URL-страницы, на которую пользователь будет перенаправлен после портальной авторизации (т. Т.е., например, после того, как он ввел свой номер телефона, получил СМС SMS и ввел пароль в портале, его принудительно перенаправит на указанный в параметре URL. Обычно это сайт клиента, рекламная страница или сайт оператора). Поддерживаются доменные имена на латинице и кириллические доменные именакириллице.

URL перехода по баннеру на финальной странице - URL-страницы, на которую пользователь будет перенаправлен при нажатии на финальный баннер (находящийся вниху внизу страницы портала) на странице "Поздравление" (последней страницы портала, которая включается в общих настройках используемого портала).

URL перехода по промо баннеру на финальной странице - URL-страницы, на которую пользователь будет перенаправлен при нажатии на финальный промо баннер (всплывающий баннер) на странице "Поздравление" (последней страницы портала, которая включается в общих настройках используемого портала).

Заголовок страницы – формируется администратором портала под каждого клиента индивидуально (необязательный параметр).
Подпись снизу – формируется администратором портала под каждого клиента индивидуально (необязательный параметр).
Шаблон SMS сообщения – шаблон сообщения, в котором пользователю будет отправлен пароль

URL перенаправления перед предоставлением услуги - URL-страницы, на которую пользователь будет перенаправлен после подверждения номера с передачей этого номера телефона на данный сайт.

Примечание

"URL перенаправления перед предоставлением услуги" настраивается для перенаправления пользователя, с передачей его номера, на сторонний сайт. Для дальнейшего прохождения авторизации на портале, после необходимых Вам действий на стороннем сайте, требует редирект назад на портал. Так же требует настройки белого списка хостов APB. Перед настройкой данного функционала ознакомьтесь с данной документацией <ссылка на инструкцию>.

Добавление "URL для перенаправления" по расписанию

Section

Column

width	40%

Column

Чтобы открыть окно настройки "URL для перенаправления" для разных расписаний нужно нажать на пиктограмму Image Removed Image Added в поле настройки URL.

В данном окне отображаются уже существующие URL для разных расписаний. При необходимости их можно удалить с помощью кнопки Image Removed Image Added.

Для каждого расписания может быть добавлен только один URL.

Для добавления новой привязки URL+расписание, нужно выбрать одно из доступных расписаний, указать URL и нажать кнопку "Добавить". После этого оно появится в списке. Далее нужно сохранить изменения в окне настроек расписаний, и после этого сохранить изменения на странице языковые настройки.

Примечание
Привязки URL и расписаний создаются отдельно для каждого языка. , используемого на портале.

Рекламные площадки

...

Раздел содержит настройки активации/деактивации интеграции с рекламными площадками.

Section

Column

width	40

Image Added

Column

Включить интеграцию с платформой Волга - активация/деактивация интеграции с платформой Волга. При включенном параметре, становится видимой дополнительная настройка.

Location - расположение площадки.

Включить интеграцию с рекламными площадками - активация/деактивация интеграции с рекламными площадками. При включенном параметре, становится видимой дополнительная настройка.

Рекламная площадка - выбор рекламной площадки. В выпадающем меню доступно две площадки: WiFix и Hot WiFi.

После нажатия кнопки "Сохранить" настройки применятся.

Работа по расписанию

Основное расписание

...

Section

Column

width	40%

Image RemovedImage Added

Image Modified

Column

По умолчанию планировщик отключен и активируется установкой соответствующей галочки в разделе Работа по расписанию настроек виртуального портала. Поставленная галочка означает работу портала согласно расписанию в этот день, снятая галочка - портал в этот день не работает. Для работы портала в течении всего дня необходимо установить ползунок на значение 00:00 - 24:00в системе не заданы настройки расписания. В случае добавления расписания работы портала, он будет работать только в указанное время, если пользователь зайдет на портал в нерабочее время, то увидит вместо формы регистрации/авторизации на портале страницу-заглушку.

Отсчет времени ведется в часовом поясе, в котором находится точка доступа, к которой подключается пользователь. Часовой пояс точки доступа задается в настройках домена, в котором она находится. Настройка часового пояса описана на страницах v1.18_Администрирование EMS в разделе "Часовой пояс" и v1.18_Администрирование Личного кабинета в разделе "Дерево доменов".

Изменения времени работы вступают в силу после нажатия "Сохранить" в планировщике.

Не рабочее время портала по расписанию не означает что уже авторизованный пользователь не сможет продолжать получать услугу Wi-Fi. Авторизованные пользователи будут продолжать работать до истечения времени заложенного в тарифе. Но новые пользователи, а также те пользователи, у которых истек тариф не смогут получить или продлить услугу в нерабочее время.

Подсказка
В не рабочее время вместо формы регистрации/авторизации на портале выдается страница-заглушка.

Портал получает значение таймзоны через NBI и кэширует его на 5 минут. В связи с этим, изменение часового пояса домена может вступить в силу на портале в течение 5 минут.

...

Работа с планировщиком

Section

Column

width	40%

Image RemovedImage Added

Column

Раздел позволяет создавать расписания, используемые в дальнейшем для настройки отображения баннеров, а также ссылок для редиректа пользователей после авторизации на портале.

Примечание
Для создания и редактирования расписаний пользователь КП должен обладать привилегией на редактирование системных настроек. Пользоваться уже готовыми расписаниями могут любые пользователи.

Для просмотра и редактирования добавления расписания нужно нажать на пиктограмму Image Removed справа от названия расписаниянеобходимо нажать кнопку "Добавить". Откроется окно создания расписания идентичное окну редактирования. После этого в таблице можно будет выбрать рабочие часы для этого расписания. Темно-серые блоки совпадают с рабочим временем, настроенным в основном расписании, светлые блоки соответствуют нерабочему времени.Для сохранения изменений нужно нажать пиктограмму Image Removed. Для отмены Image Removed. Лиловые блоки отображают рабочее время, серые - нерабочее.

Для просмотра и редактирования расписания нужно нажать на пиктограмму Image Added справа от названия расписания. После этого в таблице можно будет снова выбрать рабочие часы для этого расписания.

Для удаления расписаний используется кнопка Image Removed Image Added. При удалении расписания, происходит так же удаление привязок ресурсов (баннеров и ссылок для редиректа) к этому расписанию, на всех порталах, где это расписание используется.

Для добавления нового расписания нужно нажать на ссылку "здесь".

Примечание
Пользователям, не имеющим права на редактирование расписаний не будут отображаться кнопки для сохранения изменений и удаления расписаний.

Тарифы

...

В разделе выбираются тарифные планы, содержащие различные ограничения для доступа, которые будут предложены пользователю при подключении к SSID в режиме Hotspot, которому сопоставлен данный WEB-портал.

Предупреждение
К порталу обязательно должен быть привязан хотя бы один Тарифный План, иначе портал не будет функционировать, и у пользователей будет отображаться ошибка.

На одном портале можно активировать несколько тарифных планов.

Тарифы

Section

Column

width	40%

Image Added

Column

На вкладке отображаются тарифы для работы с ТД, которые добавлены для данного портала. По умолчанию, к порталу привязан дефолтный тариф "Hotspot Default", его можно удалить, нажав на соответствующую кнопку.

Тарифные планы для "Точек доступа" настраиваются в личном кабинете и через систему Eltex.EMS.

Для добавления нового тарифного плана нужно нажать кнопку "Добавить". В диалоговом окне в чекбоксах выбрать тарифные планы, подтвердить выбор нажатием кнопки "Добавить" в диалоговом окне.

В поле «Название тарифа на портале» можно задать название тарифного плана, которое будет отображаться пользователю при регистрации на портале.

Специальные тарифы BRAS

Section

Column

width	40

Image Added

Column

Тарифные планы PCRF, настраиваются только в личном кабинете.

Для каждого параметра, в выпадающем меню можно выбрать необходимый тариф.

Тариф для опросов - сценарий, который будет применен к сессии пользователя для опроса.

Рекламный тариф BRAS - сценарий, который будет применен к сессии пользователя для отображения рекламы.

Рабочий тариф BRAS - сценарий, который будет применен к сессии пользователя в обычном режиме.

Для активации рекламного тарифа, необходимо сначала подключить интеграцию с рекламной площадкой.

Опросы

...

Section

Column

width	40

Image Added

Column
Настройка сервиса опросов находится в инструкции сервиса Polly.

Сервис оплаты

...

Section

Column

width	40%

Image Modified

Column

Портал поддерживает возможность авторизации пользователя на портале только после прохождения процедуры оплаты доступа с помощью сервиса Сбербанка.

Чтобы активировать работу сервисов оплаты, необходимо установить флаг “Включить “Включить интеграцию со Сбербанком”Сбербанком”.

Тип среды - выбор среды работы функционала оплаты. Для тестирования данного функционала выбирается среда "Тестовая", для обращения к тестовому API Сбербанка. Для использования в эксплуатации используется среда "Промышленная" для реальной оплаты услуг клиентами.
Имя пользователя - логин пользователя платформы Сбербанка с суффиксом -api.
Пароль - пароль пользователя платформы Сбербанка

Тарифные планы

Section

Column

width	40%

Image Removed

Column

На данной вкладке выбираются тарифные планы, содержащие различные ограничения для доступа, которые будут предложены пользователю при подключении к SSID в режиме Hotspot, которому сопоставлен данный WEB-портал.

В поле «Название тарифа на портале» можно задать название тарифного плана, которое будет отображаться пользователю при регистрации на портале. Тарифные планы для "Точек доступа" настраиваются в личном кабинете и через систему Eltex.EMS. Тарифные планы PCRF, настраиваются только в личном кабинете. На одном портале можно активировать несколько тарифных планов.

Предупреждение
К порталу обязательно должен быть привязан хотя бы один Тарифный План, иначе портал не будет функционировать, и у пользователей будет отображаться ошибка.

Для добавления нового тарифного плана нужно нажать кнопку "Добавить". В диалоговом окне в чекбоксах выбрать тарифные планы, подтвердить выбор нажатием кнопки "Добавить" в диалоговом окне.

Внешний вид

...

Image Removed

...

Внешний вид

...

Раздел содержит набор инструментов, позволяющий изменять внешний вид и содержание страниц порталов.

Image Added

Примечание
Финальный баннер и финальный промо баннер доступны для настройки при активации в общих настройках страницы "Поздравление"

...

Инструменты для

...

настройки

...

Настройка цвета

Section

Column

width	40%

Image RemovedImage Added

Column

Виртуальный портал имеет мультиязычный интерфейс, Wi-Fi пользователь может самостоятельно выбрать отображаемый язык. Для того чтобы проводить настройку страниц портала отдельно на каждом языке, на всех страницах портала есть меню выбора языка . При использовании режима «Все языки», изменения на странице будут применены ко всем языкам. Этот режим удобен для настройки внешнего вида портала (страница Регистрация). При выборе конкретного языка изменения будут вносится только этого языка. При изменении содержимого текстовых полей изменения всегда будут сохраняться только в один из выбранных языков, если выбран режим "Все языки", то изменения будут сохраняться только в русский язык.

Для изменения цвета элементов следует использовать пиктограмму в виде закрашенного квадрата (отображает текущий выбранный цвет): Image Added. При нажатии на пиктограмму откроется окно выбора цвета. Элементы окна:

Палитра - наглядно показывает выбираемый цвет, цвет может быть выбрано простым кликом.
Кодовое значение в стандарте RGB/HSB - цвет может быть указан в цифровом виде.
Индекс - представление цвета в виде индекса. Индекс цвета может быть введено вручную.
Настройка насыщенности - слева направо цвет изменяется от 0% (прозрачный) до 100% (непрозрачный).

Выбор изображения/видео

Для выбора нового изображения/видео, или изменения уже используемого используется пиктограмма Image Added. При ее нажатии откроется окно для выбора изображения из галереи и его обрезки. Выберите нужное изображение/видео и установите его, нажав кнопку Image Added.

Image Added

Обрезка изображения

Section

Column

width	40%

Image Added

Column

Для обрезки нового изображения, или изменения обрезки уже используемого, откройте окно для выбора изображения из галереи и нажмите кнопку Image Added.

В окне обрезки изображения установите необходимые границы обрезки, используя выделение границ курсором или переместив область выделения и растянув её границы.

Превью

...

Section

Column

width	40%

Column

Используется для настройки портала, а также оценки отображения виртуального портала на устройствах пользователей.

В правой части настройки страницы портала расположено изображение внешнего вида портала таким, каким оно будет отображаться на устройстве клиента. Над изображением внешнего вида портала имеются пиктограммы , с помощью которых можно переключать тип клиентского устройства и видеть, как будет отображаться портал на экране смартфона, планшета или монитора лаптопа, Для того чтобы увидеть, как на мобильных устройствах будет отображаться портал в горизонтальном положении экрана, нужно нажать на пиктограмму дважды: .

Под пиктограммами располагается меню выбора страницы портала . При портальной авторизации у абонента друг за другом отображаются различные страницы портала, отвечающие за определенный этап авторизации (Страница входа, страница ввода кода SMS, финальная страница, страница "Добро пожаловать", Выбор способа оплаты, страница окончания сессии, пользовательское соглашение):

Настройка элементов

Section

Column

width	40%

Пример редактирования сообщения на странице "Добро пожаловать":

Image Modified

В результате откроется окно для редактирования текста, в котором мы можем исправить приветствие:

Image Modified

В результате будет получено:

Image Modified

Column

При наведении указателя мыши на элементы портала в превью можно заметить отображение специальной пиктограммы . Этот символ означает, что данный элемент может быть изменен пользователем. Таким способом могут быть изменены изображения, используемые для баннеров, а также многие текстовые поля на портале. Следует обратить внимание, что некоторые текстовые поля являются стандартными для всех порталов, например, пояснительные тексты при регистрации/авторизации - эти тексты редактировать нельзя. Кроме этого, текст "Пользовательского соглашения" должен изменяться централизованно для всей системы, поэтому он может быть изменен только суперпользователем системы и только в портале 'default', откуда он будет получен всеми остальными порталами.

...

Выбор языка для

...

редактирования

Настройка цвета

...

Section

Column

width	40%

Image RemovedImage Added

Column

Виртуальный портал имеет мультиязычный интерфейс, Wi-Fi пользователь может самостоятельно выбрать отображаемый язык. Для изменения цвета элементов следует использовать пиктограмму в виде закрашенного квадрата (отображает текущий выбранный цвет): Image Removed. При нажатии на пиктограмму откроется окно выбора цвета. Элементы окна:

Палитра - наглядно показывает выбираемый цвет, цвет может быть выбрано простым кликом.
Кодовое значение в стандарте RGB/HSB - цвет может быть указан в цифровом виде.
Индекс - представление цвета в виде индекса. Индекс цвета может быть введено вручную.
Настройка насыщенности - слева направо цвет изменяется от 0% (прозрачный) до 100% (непрозрачный).

Выбор изображения/видео

того чтобы проводить настройку страниц портала отдельно на каждом языке, на всех страницах портала есть меню выбора языка . При использовании режима «Все языки», изменения на странице будут применены ко всем языкам. Этот режим удобен для настройки внешнего вида портала (страница Регистрация). При выборе конкретного языка изменения будут вносится только этого языка. При изменении содержимого текстовых полей изменения всегда будут сохраняться только в один из выбранных языков, если выбран режим "Все языки", то изменения будут сохраняться только в русский язык.

Тема

...

Section

Column

width	40%40

Image RemovedImage Added

Section

Column
Для обрезки нового изображения, или изменения обрезки уже используемого, откройте окно для выбора изображения из галереи и нажмите кнопку Image Removed.

Для выбора нового изображения/видео, или изменения уже используемого используется пиктограмма Image Removed. При ее нажатии откроется окно для выбора изображения из галереи и его обрезки. Выберите нужное изображение/видео и установите его, нажав кнопку Image Removed.

Column

Обрезка изображения

Функция выбора отображения портала из готовых тем. Предпросмотрт сразу доступен на панеле "Превью" справа.

Дополнительные CSS

...

Section

Column

width	40%

Image Added

Column

Функция загрузки в виртуальный портал css файлов, переопределяющих настройки отображения элементов виртуального портала. Это позволяет настраивать элементы портала, для которых не реализовано графической настройки.

Чтобы отменить изменения, сделанные загрузкой css файла, необходимо загрузить пустой файл.

Дополнительный JavaScript

...

Section

Column

width	40%

Image RemovedImage Added

Column

В окне обрезки изображения установите необходимые границы обрезки, используя выделение границ курсором или переместив область выделения и растянув её границы.

Функция загрузки в виртуальный портал JavaScript файла, переопределяющих настройки отображения элементов виртуального портала. Это позволяет изменить сценарий отображения элементов портала, для которых не реализовано настройки.

Чтобы отменить изменения, сделанные загрузкой JavaScript файла, необходимо загрузить пустой файл.

Разделы

Общие

...

Section

Column

width	40%

Image Modified

Column

В данном разделе настраивается:

Favicon - значок. отображаемый в заголовке страницы в браузере пользователя. Также этот значок будет использоваться при отображении портала в Конструкторе. Для того чтобы сменить значок, достаточно кликнуть на его превью, после этого будет открыта галерея для выбора другого изображения
Фон страницы - фоновое изображение/видео страницы портала.
Шапка Фон шапки - Настройка настройка полосы с выбором языка и логотипом.
Верхний баннер - располагается над меню пользователя (2).
Левый баннер - располагается слева от меню пользователя (1). Не отображается в мобильной версии. В версии для планшетов отображается только если выключен правый баннер.
Правый баннер - располагается справа от меню пользователя (3). Не отображается в мобильной версии. В версии для планшетов отображается только если выключен правый левый баннер.
Нижний баннер - располагается под меню пользователя (4).

Подсказка
Если в качестве изображений использовать картинки с прозрачным фоном, то они органично впишутся в дизайн портала.

Подсказка

В качестве изображения баннера или фона можно вставить картинку в формате GIF, которая будет динамично меняться на странице пользователя, например:.

Image Removed

Настройка баннеров

Section

Column

width	40%

Image Modified

Column

Для добавления еще отсутствующего на портале баннера или для редактирования одного из уже добавленных нужно нажать на пиктограмму Image Removed Image Added рядом названием баннера (верхний, левый, правый, нижний, финальный*). Уже добавленные баннеры отображаются на превью, для их редактирования можно навести указатель мыши на баннер и нажать на пиктограмму Image Removed Image Added.

При добавлении нового баннера откроется окно редактирования, для того что бы добавить изображение используется кнопка Image Removed Image Added, по нажатию которой откроется галерея для выбора изображений. Баннер может содержать несколько изображений, при такой конфигурации они будут сменять друг друга. На портале смена изображений на всех баннерах будет происходить синхронно. Изображения, используемые в одном баннере должны иметь одинаковый размер по ширине и высоте (в пикселях).

Для изменения уже добавленного изображения/видео нужно использовать кнопку Image Removed Image Added, а для удаления Image Removed Image Added.

По умолчанию, в окне редактирования предлагается настраивать баннеры для режима "Без расписания". При настройке баннера можно выбрать другое расписание, заранее преднастроенное в разделе расписаний портала. При выборе дополнительного расписания оно будет привязано к порталу, а в рабочее время этого расписания будут отображаться только те баннеры, которые настроены для работы в нем.

Примечание
Таким образом, если Если для одного из баннеров было добавлено использование расписания, а для других нет, в рабочее время этого расписания эти такие баннеры отображаться не будут.

После выбора нужных изображений/видео, следует нажать на кнопку "Сохранить".

Подсказка

Следует помнить, что изображения должны быть одного размера. К примеру, если первое изображение в "настройке баннера" имеет размер 400px * 200px, то второе и последующие должны иметь точно такие же размеры ( 400px * 200px).
Для этого при обрезке изображений баннера есть кнопка Image Removed Image Added. Нажав её можно выбрать изображение/видео, с которого будут скопированы параметры области выделения для обрезки изображения.

Текст

...

Section

Column

width	40%

Image Modified

Column

Содержимое - текст, отображаемый на странице регистрации пользователя. Настраивается через стандартную форму набора текста.
Заголовок формы регистрации - текст, отображаемый на странице регистрации пользователя по номеру телефона. Настраивается через стандартную форму набора текста.
Заголовок формы авторизации - текст, отображаемый на странице авторизации пользователя по учетной записи. Настраивается через стандартную форму набора текста.
Фон - цвет фоновой подложки для области с текстом и элементами управления.
Обычный - цвет и шрифт, используемые для отображения основного текста на портале.
Заголовки - цвет и шрифт, используемые для отображения заголовков страниц.
Ссылки - цвет ссылок на странице (используется шрифт основного текста).
Заголовок формы авторизации - заголовок страницы регистрации, который будет отображаться в браузере.

...

Поля ввода

...

Section

Column

width	40%

Image Modified

Column

Текст - цвет и шрифт текста в полях ввода.
Фон - цвет фона полей ввода.
Рамка - цвет и ширина рамки полей ввода.
Закругление - радиус закругления углов в полях ввода.
Надпись у поля "Имя пользователя" - надпись, отображаемая рядом с полем, в котором указывается логин пользователя. Параметр может быть изменен только если выбран определенный язык для редактирования.
Надпись у поля "Пароль" - надпись, отображаемая рядом с полем, в котором указывается пароль пользователя. Параметр может быть изменен только если выбран определенный язык для редактирования.

...

Кнопки

...

Section

Column

width	40%

Image Modified

Column

Рамка - цвет и ширина рамки кнопок.
Закругление - радиус закругления углов кнопок.
Текст кнопки "По учетной записи" -текст, отображаемый на кнопке, включающий режим авторизации по уже существующей учетной записи.
Текст кнопки "По номеру телефона" - текст. отображаемый на кнопке для регистрации на портале новой учетной записи.
Текст - цвет текста на кнопках
Фон - основной цвет кнопки
Градиент - (если включен) создает градиентный переход на кнопке
Выбрать заготовку - выбрать заранее заготовленные шаблоны цветового оформления кнопок

...

Докеризация сервиса

...

column

Sectionwarning

title

width	40%

Image Removed

Column
Функция выбора отображения портала из готовых тем.

Дополнительные CSS

...

Column

width	40%

Image Removed

Column

Функция загрузки в виртуальный портал css файлов, переопределяющих настройки отображения элементов виртуального портала. Это позволяет настраивать элементы портала, для которых не реализовано графической настройки.

Чтобы отменить изменения, сделанные загрузкой css файла, необходимо загрузить пустой файл.

Дополнительный JavaScript

...

Column

width	40%

Image Removed

Column

Функция загрузки в виртуальный портал JavaScript файла, переопределяющих настройки отображения элементов виртуального портала. Это позволяет изменить сценарий отображения элементов портала, для которых не реализовано настройки.

Чтобы отменить изменения, сделанные загрузкой JavaScript файла, необходимо загрузить пустой файл.

Докеризация сервиса

Внимание!

При работе сервиса в докере все адреса сторонних сервисов (как в файлах, так и в настройках GUI конструктора порталов) должны быть указаны как внешние адреса, даже если они работают на одном хосте! Использовать адрес localhost или 127.0.0.1 недопустимо, т.к. это приведет к обращению к этому адресу внутри контейнера!

Сервис может быть запущен в docker-контейнере. Для этого необходимо подготовить файл с переменными окружения .env и docker-compose.yml

Блок кода

language	yml
title	docker-compose.yml

version: "3"
services:
  eltex-portal-constructor:
    container_name: eltex-portal-constructor
    image: lab3-testhub.eltex-co.loc:9443ru/softwlc/eltex-portal-constructor:1.18
    ports:
      - 9001:${PORTAL_CONSTRUCTOR_PORT}
      - 9444:${PORTAL_CONSTRUCTOR_HTTPS_PORT}
    environment:
      - PORT=${PORTAL_CONSTRUCTOR_PORT}
      - database.host=${PORTAL_CONSTRUCTOR_DATABASE_HOST}
      - database.port=${PORTAL_CONSTRUCTOR_DATABASE_PORT}
      - database.name=${PORTAL_CONSTRUCTOR_DATABASE_NAME}
      - database.user=${PORTAL_CONSTRUCTOR_DATABASE_USER}
      - database.password=${PORTAL_CONSTRUCTOR_DATABASE_PASSWORD}
      - jetty.https.port=${PORTAL_CONSTRUCTOR_HTTPS_PORT}
      - jetty.https.keystorePass=${PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_PASS}
      - jetty.https.keystoreFile=${PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_FILE}
      - validation.public_key=${PORTAL_CONSTRUCTOR_PUBLIC_KEY}
      - auth-service.host=${PORTAL_CONSTRUCTOR_AUTH_SERVICE_HOST}
      - auth-service.port=${PORTAL_CONSTRUCTOR_AUTH_SERVICE_PORT}
      - auth-service.secret=${PORTAL_CONSTRUCTOR_AUTH_SERVICE_SECRET}
    volumes:
      - /etc/eltex-doors/keys/public.pem:${PORTAL_CONSTRUCTOR_PUBLIC_KEY}:ro

...

Блок кода

language	java
title	.env

PORTAL_CONSTRUCTOR_PORT=9001

PORTAL_CONSTRUCTOR_HTTPS_PORT=9444
PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_PASS=12345
PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_FILE=/etc/eltex-portal-constructor/localhost.pfx

PORTAL_CONSTRUCTOR_PUBLIC_KEY=/etc/eltex-doors/keys/public.pem

PORTAL_CONSTRUCTOR_DATABASE_HOST=<ip-addr>
PORTAL_CONSTRUCTOR_DATABASE_PORT=3306
PORTAL_CONSTRUCTOR_DATABASE_NAME=ELTEX_PORTAL
PORTAL_CONSTRUCTOR_DATABASE_USER=javauser
PORTAL_CONSTRUCTOR_DATABASE_PASSWORD=javapassword

PORTAL_CONSTRUCTOR_AUTH_SERVICE_HOST=<ip-addr>
PORTAL_CONSTRUCTOR_AUTH_SERVICE_PORT=21812
PORTAL_CONSTRUCTOR_AUTH_SERVICE_SECRET=eltex

Возможные переменные окружения

...

Запуск сервиса

PORTAL_CONSTRUCTOR_PORT - порт, на котором будет стартовать сервис внутри контейнера,
JAVA_INIT_HEAP - аргумент запуска JVM -Xms.
JAVA_MAX_HEAP - аргумент запуска JVM -Xmx.
JAVA_OPTS – другие аргументы запуска JVM (может перезаписать любые другие аргументы).

Логирование

LOG_LEVEL - уровень Root логера.
GELF_HOST - хост подключения к Gelf.
GELF_PORT - порт подключения к Gelf.
GELF_LEVEL - уровень Gelf логера.

Подключение к БД

PORTAL_CONSTRUCTOR_DATABASE_HOST - хост подключения к БД.
PORTAL_CONSTRUCTOR_DATABASE_PORT - порт подключения к БД.
PORTAL_CONSTRUCTOR_DATABASE_NAME - название БД.
PORTAL_CONSTRUCTOR_DATABASE_USER - пользователь БД.
PORTAL_CONSTRUCTOR_DATABASE_PASSWORD - пароль БД.
database.pool.connectionTimeout - таймаут подключения к БД.
database.pool.validationTimeout - таймаут валидации соединения с БД.
database.pool.min - минимальное число idle соединений с БД в пуле.
database.pool.max - максимальное число соединений с БД в пуле.
database.cache.maxEntries - максимальное число простых кэшированных записей (для каждого типа запроса).
database.cache.maxResourceBytes - максимальный размер кэшированных ресурсов.
database.cache.expireTime - максимальное время хранения записей в кеше.

Конфигурация взаимодействия с eltex-auth-service

auth-service.host - хост auth-service.
auth-service.port - порт auth-service.
auth-service.secret - секрет auth-service.
auth-service.timeout - таймаут подключения к auth-service.
auth-service.retries - количество попыток подключения к auth-service.
auth-service.protocol - протокол взаимодействия с auth-service (pap/chap/mschapv2).

Конфигурация настроек входа в eltex-portal-constructor

login.maxAttemptsLogin - кол-во попыток входа в панель администратора до наступления блокировки.
login.maxAttemptsIP - кол-во попыток входа с одного IP адреса до наступления блокировки.
login.blockTime - продолжительность блокировки после достижения максимального числа попыток входа.

Настройки SSO

sso.enabled - вкл/выкл вход по SSO.
sso.version - версия SSO.
sso.rest.scheme - HTTP/HTTPS схема взаимодействия с API SSO.
sso.rest.host - хост API SSO.
sso.rest.port - порт API SSO.
sso.rest.sso_api_path - path API SSO.
sso.auth.scheme - схема URL аутентификации через SSO.
sso.auth.host - хост URL аутентификации через SSO.
sso.auth.port - port URL аутентификации через SSO.
sso.auth.authentication_path - path URL аутентификации через SSO.
sso.auth.logout_path - path URL деаутентификации (logout) через SSO.
sso.params.client_id - ID клиентского приложения (КП) в системе SSO.
sso.params.client_secret - секрет клиентского приложения (КП) в системе SSO.
sso.params.redirect_uri - URL обратного перенаправления на КП после успешной аутентификации в системе SSO.

Доступ через HTTPS

PORTAL_CONSTRUCTOR_HTTPS_PORT - HTTPS порт сервиса внутри контейнера.
PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_PASS - пароль к KeyStore.
PORTAL_CONSTRUCTOR_HTTPS_KEYSTORE_FILE - путь до KeyStore.
jetty.https.keystoreType - тип KeyStore.
jetty.https.keyAlias - алиас SSL сертификата.
jetty.https.ciphers - список названий шифров.

Валидация JWT

PORTAL_CONSTRUCTOR_PUBLIC_KEY - путь до public.pem ключа для валидации JWT

...

Блок кода

language	bash

docker-compose up

Авторизация на Конструкторе Порталов

...

Перед тем, как авторизоваться на Конструкторе порталов, который запущен в контейнере, необходимо добавить серверный адрес для eltex_auth_service в MySQL:

insert into eltex_auth_service.nas (nasname, shortname, secret) values('<IP-address>','docker', 'eltex');

для многохостовой установки (eltex_auth_service и eltex-portal-constructor находятся на разных хостах):

Вместо <IP-address> нужно вписать ip-адрес сервера, котором запущен контейнер с Конструктором Порталов.

для однохостовой установки (eltex_auth_service и eltex-portal-constructor находятся на одном хосте):

Вместо <IP-address> нужно вписать ip-адрес контейнера, внутри которого запущен Конструктором Порталов.

При этом следует учитывать, что при перезапуске контейнера, у него может смениться адрес, в таком, случае придется снова добавлять запись, но с другим ip-адресом.

Дерево страниц

История страницы

Сравнение версий

Старая версия 1

Новая версия Текущий

Ключ

Управление сервисом

Установка

Способы запуска/остановки

Конфигурация

/etc/eltex-portal-constructor/application.conf

/etc/eltex-portal-constructor/log4j2.xml

Системные настройки в GUI

Конструктор порталов

Уведомления

Типы уведомлений

Image Modified

Доступ к NBI

Доступ к NGW

Взаимодействие с BRAS

Доступ к PCRF

Доступ к Mercury

Личный кабинет

Вход через ЕСИА

Интеграция с АТС Смольного

Доступ к платформе Волга

Доступ к сервису опросов

Настройки сервиса оплаты

Галерея

Добавление/изменение изображений/видео

Удаление изображений/видео

Стартовая страница

Личный Кабинет

Порталы

Создание нового портала

Копирование портала

Общие настройки

Вкладка "Общие"

Основные

Рекламная рассылка

Дополнительные параметры при регистрации

Подтверждение возраста

Вкладка "Режим работы"

Основные

Подтверждение личности

Настройки отправки SMS

Вкладка "Отправка SMS"

Основные

Выбор кода страны

Настройки безопасности

Вкладка "Безопасность"

Списки доступа

Captcha

SMS-антиспам

Языковые настройки

Вкладка "Страницы"

Языковые настройки

Добавление "URL для перенаправления" по расписанию

Рекламные площадки

Работа по расписанию

Основное расписание

Работа с планировщиком

Тарифы

Тарифы

Специальные тарифы BRAS

Опросы

Сервис оплаты

Тарифные планы

Внешний вид

Внешний вид

Инструменты для

настройки

Настройка цвета

Выбор изображения/видео

Обрезка изображения

Превью

Настройка элементов

Выбор языка для

редактирования

Настройка цвета