Подключение внешнего портала

Внешний OTT/IPTV портал

Внешний Портал является Web-приложением, которое загружается в STB для
доступа к услугам, предоставляемым определенной платформой OTT/IPTV.

Будучи клиент-серверной компьютерной программой, Внешний Портал охватывает две стороны: клиентская часть Внешнего Портала загружается в STB, серверная - функционирует на стороне сервера MiddleWare (MW), который выполняет функции связующего звена между STB и различными медиа-сервисами, такими как доступ к аудио-видео контенту, записям, другим приложениям и т.д.

Взаимодействие STB с сервером MW осуществляется по протоколу HTTP. Адрес внешнего портала, представляющий собой HTTP-URL, предварительно прописывается в STB - на этапе создания образа ПО или вручную, через настройки STB. Соединение STB с порталом выполняется на этапе загрузки STB в одном из режимов: автоматически или вручную, путем выбора необходимого портала из списка.

Соединение с внешним порталом может предусматривать процедуру идентификации пользователя: для доступа к порталу пользователь должен ввести в предлагаемой форме Authentication данные своей учетной записи, полученные от оператора (провайдера услуг).

После соединения STB с внешним порталом пользователь получает доступ к услугам платформы OTT/IPTV (доступ к аудио-видео-контенту, услуги по записи/воспроизведению, доступ к играм и другим приложениям и др.).

Портал каждой OTT/IPTV платформы использует оригинальный пользовательский интерфейс (User Interface - UI). UI портала разрабатывается на основе принципа Среды рабочего стола, который содержит элементы управления услугами и настройками портала - окна, пиктограммы, папки, меню и т.д.

Для взаимодействия определенной модели STB и MW предварительно проводятся работы по взаимному интегрированию. Приставки семейства MAG, по умолчанию, интегрированы с ТВ-платформой Ministra.

Настройка параметров внешнего портала

В моделях STB с открытой платформой доступ к внешнему порталу может настраиваться следующими способами:

1. Адрес внешнего портала указывается оператором при сборке образа ПО - только для ПО STB, которое создает оператор (операторские и кастомные образы ПО). Данный портал будет автоматически загружаться в STB. Кроме этого, оператор может отключить возможность перехода во Встроенный портал - см. Инструкции.
2. Адрес внешнего портала настраивается пользователем вручную в разделе системных настроек Порталы. В публичном и заводском образах ПО, предоставляемых производителем STB, доступ к окну Порталы открыт по-умолчанию.

Настройка доступа к порталам во Встроенном портале

Раздел Порталы (обычный режим настройки)

Во встроенном портале настройка доступа к внешним порталам проводится в следующем разделе: Системные настройки ⇒ Серверы ⇒ Порталы.
В разделе Порталы, по-умолчанию, предоставляется возможность указывать данные (имя, URL) максимум двух внешних порталов. Однако, при необходимости, в STB может храниться информация о большем количестве (до 8-ми) внешних порталов - Дополнительные настройки порталов.

Дополнительные настройки порталов (Режим мультипортальности)

В окне Порталы / Дополнительно  устанавливаются дополнительные правила загрузки порталов: определяется портал, загружаемый по умолчанию, определяется тип загрузки - автоматический или ручной выбор портала и другое. Кроме того, также могут быть добавлены дополнительные внешние порталы (максимум восемь).

1. Вызвать окно: Системные настройки ⇒ Серверы ⇒ Порталы ⇒ Дополнительно (F1 на ПДУ)
2. Установить в поле Режим мультипортальности значение ON.

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

Как подключить внешний портал

Пример настройки соединения с одним внешним порталом (приведен вариант ввода информации с помощью экранной клавиатуры).

Основная настройка Внешнего портала:

Рассмотрим для примера: Портал 1 (Имя: сталкер, URL: http://10.1.3.1/stalker_portal/c)

1. Во Встроенном портале войти в Системные настройки ⇒ Серверы ⇒ Порталы
2. Вызвать виртуальную клавиатуру (кнопкой KB на ПДУ).
3. Заполнить значение Портал 1 имя (не нажимать Enter). Например: сталкер.
4. Убрать виртуальную клавиатуру (кнопкой KB на ПДУ).
5. Перейти в поле Портал 1 URL (кнопкой Вниз на ПДУ).
6. Вызвать виртуальную клавиатуру (кнопкой KB на ПДУ).

7. Заполнить значение Портал 1 URL. В примере используется адрес: http://10.1.3.1/stalker_portal/c/
   Примечание. Если в поле Портал 1 URL ввести некорректное значение, при попытке сохранения будет выдано соответствующее предупреждение.

8. В конце редактирования нажать кнопку Enter на виртуальной клавиатуре для сохранения введенных данных.

9. Чтобы соединиться с Порталом 1, необходимо выйти из окна Порталы (Выход на ПДУ) и Перегрузить портал. Заданный портал (Портал 1) должен загрузиться автоматически.

Дополнительная настройка порталов (Режим мультипортальности):

Рассмотрим для примера: Портал 2 (URL: http://192.168.1.1)

1. Во Встроенном портале войти в Системные настройки ⇒ Серверы ⇒ Порталы.
2. Нажать Дополнительно (F1) и в открывшемся окне установить в поле Режим мультипортальности значение ON. При этом открываются дополнительные поля редактирования порталов:
   1. В поле Портал выбрать портал, настройки которого необходимо редактировать (в примере: Портал 2).
   2. В поле Использовать портал 2 установить значение ON. При этом появляются поля Имя 2 и URL 2.
      
   3. В полях Имя 2 и URL2 ввести необходимые значения (в примере: URL 2: http://192.168.1.1).
   4. При необходимости, аналогично описанному в п.п. a-с, произвести настройку других порталов (в примере: Портал 2).
   5. Из всех порталов выбрать один, который будет загружаться автоматически, - указать этот портал в поле Портал по умолчанию.
   6. Выбрать задержку автоматической загрузки портала - установить значение поля Задержка загрузки портала (например: 3 сек.).
   7. Сохранить изменения с помощью команды Сохранить (ОК на ПДУ).
3. Чтобы соединиться с Порталом, перегрузить Встроенный портал: Системные настройки ⇒ Перезапуск портала. Заданный портал (Портал 2) должен загрузиться автоматически.

Когда стартует загрузка портала

Загрузка портала в STB происходит в следующих случаях:

• при включении приставки или после перезагрузки (в том числе после обновления ПО);
• при выходе из Встроенного портала (то есть при выходе из Главного меню - используйте кнопку Выход на ПДУ);
• после перезапуска Встроенного портала;
• при выходе из определенного внешнего портала (если такая возможность предусмотрена оператором).

Типы загрузки портала: автозапуск и ручной запуск

Возможные варианты загрузки портала:

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

Обычный режим настроек

В обычном режиме настройки порталов:

• если внешние порталы не прописаны, применяется автозапуск Встроенного портала;
• если в настройках указан единственный внешний портал, применяется автозапуск указанного внешнего портала;
• если в настройках прописаны оба внешних портала, применяется ручной запуск.

Режим мультипортальности

В режиме мультипортальности один из порталов (Встроенный или внешний) назначается порталом по-умолчанию. При этом тип загрузки зависит от значения поля "Задержка загрузки портала":

• если установить определенное время задержки (3 с....2 мин.), то портал по-умолчанию будет автоматически загружаться в STB, после установленной задержки.
• если установить значение Без автозагрузки, то применяется ручной запуск.

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

• в поле Портал по умолчанию выбрать значение Портал 2.
• в поле Задержка загрузки портала установить необходимое значение задержки (любое кроме "Без автозапуска").

Автозагрузка портала

Ка настроить автозагрузку описано выше. Процесс автозагрузки портала следующий:

• В начале загрузки портала на экран выводится окно Загрузка портала....
  Примечание. Длительность отображения окна Загрузка портала... (задержка загрузки портала) - по-умолчанию 3 секунды. В режиме мультипортальности эта задержка может изменяться с помощью поля Задержка загрузки портала.

• Если во время отображения сообщения Загрузка портала... нажать Menu на ПДУ, загрузка прекратится и откроется Окно выбора портала для загрузки, в котором может проводиться ручной запуск портала и(или) изменение необходимых системных настроек.
• По истечении установленного времени задержки (если загрузка не была прервана) автоматически стартует загрузка портала. В результате успешной загрузки на экране появляется окно Портала (стартовая страница). Если загрузка завершилась неудачно, на экран выводится окно Ошибка загрузки страницы.

Окно выбора портала для загрузки (Ручная загрузка портала)

Окно Выберите портал для загрузки выводится на экран на этапе загрузки портала в STB в тех случаях, когда не используется автозагрузка:

• В обычном режиме настройки порталов: если в настройках прописаны оба внешних портала, применяется ручной запуск.
• В режиме мультипортальности: если в поле Задержка загрузки портала установлено значение Без автозагрузки.

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

• Если во время отображения сообщения Загрузка портала... нажать Menu на ПДУ, загрузка прервется и откроется окно Выбора портала для загрузки.
  Примечание. Длительность отображения окна Загрузка портала..., по-умолчанию, 3 с. В режиме мультипортальности это значение может изменяться с помощью поля Задержка загрузки портала.

Окно позволяет произвести ручной выбор загружаемого в STB портала (Встроенного или внешнего). Кроме этого, пользователь может войти в Системные настройки и произвести изменения в настройках порталов (Системные настройки ⇒ Серверы ⇒ Порталы) и других параметров, до запуска загрузки портала.

Ошибка загрузки портала

Если загрузка внешнего портала STB закончилась ошибкой, выдается окно Ошибка загрузки страницы (page 404). Данное окно, по аналогии с окном Выберите портал для загрузки, содержит список порталов STB и ярлык перехода в Системные настройки. Кроме этого, окно содержит команду Попробовать снова (повторное соединение с порталом) и, в правой стороне окна, текущие параметры STB, которые могут быть полезны для анализа причины ошибки загрузки портала. В частности, могут отображаться: состояние подключения к Интернету, состояние LAN (Ethernet) подключения, IP-адрес, MAC-адрес, модель STB, версия ПО и т. д.

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

1. Устранить причину ошибки загрузки портала (например, восстановить работоспособность сетевого соединения) и попытаться повторно соединиться с порталом.
2. Зайти в Системные настройки и произвести необходимые изменения (например, настройки порталов) и вернуться опять в окно Выберите портал для загрузки (находясь в окне Системные настройки используйте кнопку Назад на ПДУ), чтобы снова выбрать портал для загрузки.
3. Выбрать для загрузки другой портал (внешний или встроенный) из списка.

Вероятные причины ошибки загрузки портала

• Если начальная загрузка проходит (на экране виден логотип и сообщения Starting…), но внешний портал не загружается (открывается окно Ошибка загрузки страницы), причины могут быть следующие:
  • не верный адрес (URL) портала;
  • отсутствует сетевое соединение;
  • не доступен портал IPTV-провайдера;
  • блокирован доступ к сервису со стороны IPTV-провайдера.
• Если доступность сети проверена, но портал не загружается – перезагрузите STB.
• Если соединение с сетью исправно, но сетевые сервисы не доступны, обратитесь к IPTV- оператору.
• Блокирование доступа к услугам со стороны IPTV-оператора (сообщения типа «Приставка отключена» и др.) – внимательно прочтите информационное сообщение на экране TV, обратитесь к оператору или устраните причину проблемы самостоятельно, перезагрузите STB.

DHCP-портал

В STB предусмотрена возможность назначать внешний портал с DHCP-сервера. Данная функция называется DHCP-портал. Настройка DHCP-портала проводится в окне: Системные настройки ⇒ Серверы ⇒ Дополнительно. 
Чтобы активировать функцию DHCP-портал, установите значение ON в поле Использовать DHCP портал.

Если используется DHCP-портал, то на этапе загрузки STB будет проведен запрос и получение от DHCP-сервера  адреса внешнего портала. Для этой цели DHCP-сервер должен быть сконфигурирован надлежащим образом.

Значение полученного таким образом портала будет записано в переменную окружения portal_dhcp. Соответственно, данное значение будет отображаться в окне Дополнительно в поле DHCP портал .

DHCP-портал имеет приоритет выше, чем значения порталов, назначенные в разделе Порталы. То есть если после перезапуска приставки было получено определенное значение DHCP-портала, то приставка будет пытаться автоматически соединиться с этим порталом, не смотря на значения других порталов (Портал 1, Портал 2, ...).

Инструкции по настройке порталов при сборке образа ПО

Инструкции для операторов по конфигурированию доступа к внешнему порталу на этапе сборки образа:

• Адрес портала указывается в переменных окружения (файл env.txt) - см. раздел Подготовка образа ПО. Общие полoжения:

  • Например, чтобы Порталу 1 установить адрес "http://example.com" - в файле env.txt должна быть строка: portal1=http://example.com/ - данный портал будет автоматически загружаться в STB.

• Чтобы скрыть (не отображать во встроенном портале) раздел Порталы - в файле env.txt должна быть строка: custom_url_hider=true

• Рекомендуется производить проверку переменных при загрузке ПО для контроля несанкционированного изменения переменных - Проверка переменных при старте STB
• Как обслуживать различные страницы, связанные с загрузкой портала (см. раздел Отключение пунктов меню Настроек, перехода во Встроенный портал и др., содержание файла - /home/web/system/pages/loader/rules.js):
  • Разрешить/запретить вызов окна Выбора портала для загрузки во время отображения сообщения "Загрузка портала..." по нажатию Menu на ПДУ.
  • Разрешить/запретить доступ к разделу Системные настройки из окон Выбора портала для загрузки и Ошибка загрузки страницы (page 404).
  • Скрыть/открыть список сконфигурированных порталов (URL, имя) в окнах Выбора портала для загрузки и Ошибка загрузки страницы (page 404).
  • Разрешить/запретить доступ к Встроенному порталу в окнах Выбора портала для загрузки и Ошибка загрузки страницы (page 404).
• Как отключить доступ к файловой системе STB (по протоколу SSH) - описано в разделе SSH - Изменение пароля, порта, отключение/включение