En este artículo describimos los recursos web, restricciones, destinos y demás características que son necesarias para que la aplicación de señalización digital funcione correctamente. Estas indicaciones aplican para cualquiera de las plataformas en las que Arkbox ha sido desarrolladas (Android, Windows, iOS, WebOS, Tizen, Universal web app, Java).

Generalidades

La red en la que se habilita un player con Arkbox puede contar con ciertas restricciones, como Firewalls, Proxys, y otros componentes que restringen la navegación hacia internet, por lo que a continuación te vamos a contar cuáles son los requisitos mínimos necesarios para nuestras aplicaciones.

Los requerimientos se presentan indicando los dos extremos involucrados dentro de un proceso de comunicación. Se entenderán como extremos: Servidor Arkbox, Servidor Cliente, Player Arkbox, Computador con cliente de datos instalado, Navegador web.

Se describen los extremos como una URL, Un puerto, y el protocolo asociado.

La dirección se representará con los símbolos < (menor que) y > (mayor que).
A continuación te mostramos un ejemplo:

Ejemplo

Descripción

Recurso1 > Recurso2

La comunicación es establecida por el Recurso1 y va hacia el Recurso2. Esto se interpretará como un requerimiento de salida.

Recurso1 < Recurso2

La comunicación es establecida por el Recurso2 y va hacia el Recurso1. Esto se interpretará como un requerimiento de entrada

Los destinos pueden ser representados por un destino FQDN, una IP o un rango de IP’s. En caso de que presente el recurso como un destion FQDN podrá aparecer el carácter * (asterisco) que funciona como un comodín.

Por ejemplo, el destino FQND api.tekus.co/*  puede referirse a los distintas URL que tienen como base api.tekus.co, es decir que las siguientes URL’s estarán contenidas dentro de este destino:

  • api.tekus.co/Status

  • api.tekus.co/example1

  • api.tekus.co/example2/subUrl

Puertos, destinos y protocolos usados

Direcciones IP usadas por infraestructura AWS

Direcciones IP usadas por infraestructura AWS

En algunas tipologías de red se realiza la restricción del acceso a los recursos por la IP del destino y no por el recurso asociado (FQDN). Dado que nuestra solución está alojada en un ambiente de cloud computing con características de balanceo de carga y escalabilidad automática, es necesario que tengas presente que no es una IP la utilizada por nuestros servidores sino un rango de IP’s asociadas a los recursos informáticos implementados.

Nuestra infraestructura está alojada en la nube de Amazon, por tal motivo te sugerimos establecer las restricciones acorde a los rangos definidos en https://docs.aws.amazon.com/es_es/general/latest/gr/aws-ip-ranges.html

Este es un amplio rango de IP’s, AWS expone algunas herramientas para poder filtrar los rangos de IP por regiones y por servicios. A continuación se especifican las regiones y servicios usados por nuestra solución:

 

  • Regiones:
    US East (N. Virginia). Esta región se identifica como us-east-1.

  • Servicios:
    EC2, S3, SQS, Cloud Front, SNS, SES, ELB, RDS, DynamoDb, WAF, Route 53

 

Si las restricciones se pueden establecer por URL, puedes encontrar los destinos usados por los componentes de Arkbox en las siguientes secciones.

Entre player Arkbox y servidor Arkbox

Entre player Arkbox y servidor Arkbox

  • Player: Dispositivo que ejecuta el aplicativo Arkbox Player o Lighthouse. Ej: Android Tv Box, TV Digital Signage WebOs, PC Windows.

  • Servidor: Recurso alojado en la nube que recibe todas las peticiones de clientes como usuarios y players para la administración de contenidos.

Funcionalidad

Dirección

Destino ó FQDN

Protocolo

Puertos

Sincronización de datos, contenidos, comandos de administración. REST/API

Player > Servidor

api.arkbox.co/*

api.tekus.co/*

HTTPS

443 (TCP)

Sincronización de contenidos medials

Player > Servidor

arkbox.s3.amazonaws.com/*

s3.amazonaws.com/arkbox/*

arkbox.s3-us-west-1.amazonaws.com/*

cdn.arkbox.co/*

cdn.tekus.co/*

cn.tekus.co/*

HTTPS

443 (TCP)

Comunicación, mensajes y colas de mensajería

Player > Servidor

sqs.us-east-1.amazonaws.com/*

HTTPS

443 (TCP)

pns.arkbox.co/*

pns.tekus.co/*

n0mtleabw0.execute-api.us-east-1.amazonaws.com/prod

d-k5jiassydk.execute-api.us-east-1.amazonaws.com

d-9scb3v039k.execute-api.us-east-1.amazonaws.com

WSS (Web Sockets Secure)

443 (TCP)

Actualización Hora automática por Red (OPCIONAL si la red tiene NTP local)

(Windows)

*.pool.ntp.org (Android)

time.windows.com (Windows)

NTP

123 (UDP)

Entre cliente web y servidor Arkbox

Entre cliente web y servidor Arkbox

  • Cliente web: Navegador utilizado por el usuario para acceder a la administración de tu cuenta. Debes tener presente que cada cuenta tiene asignado un subdominio. En la tabla siguiente se indicará mydomain como el dominio establecido para la cuenta.

  • Servidor: Recurso alojado en la nube que recibe todas las peticiones de clientes para la administración de contenidos

Funcionalidad

Dirección

Destino ó FQDN

Protocolo

Puertos

Navegación y administración de contenidos y players

Cliente web > Servidor

mydomain.arkbox.co/*

mydomain.tekus.co/*

HTTPS

443 (TCP)

Carga de contenidos y visualización de contenidos

Cliente web > Servidor

mydomain.arkbox.co/*

mydomain.tekus.co/*

arkbox.s3.amazonaws.com/*

s3.amazonaws.com/arkbox/*

arkbox.s3-us-west-1.amazonaws.com/*

cdn.arkbox.co/*

cn.tekus.co/*

HTTPS

443 (TCP)

Comunicación, mensajes y colas de mensajería

Cliente web > Servidor

sqs.us-east-1.amazonaws.com/

sqs.us-east-1.amazonaws.com/*

HTTPS

443 (TCP)

Cliente web > Servidor

pns.arkbox.co/*

pns.tekus.co/*

n0mtleabw0.execute-api.us-east-1.amazonaws.com/prod

d-k5jiassydk.execute-api.us-east-1.amazonaws.com

WWS (Web Socket Secure)

443 (TCP)

Entre equipo con cliente de datos y servidor Arkbox

Entre equipo con cliente de datos y servidor Arkbox

Esta sección sólo aplica para las implementaciones que requieren mostrar datos en las pantallas que proceden de algún recurso informático dentro de la red. En caso de no aplicar NO es necesario que atiendas estas recomendaciones.

  • Cliente de datos: Componente de software provisto por la solución Arkbox que permite interpretar un origen de datos (Xls, Xlsx, Texto plano, o base de datos) como una fuente Web XML. Este componente se instala en un equipo Windows.

Funcionalidad

Dirección

Destino ó FQDN

Protocolo

Puertos

Sincronización de datos, comandos de administración. REST/API

Cliente de datos > Servidor

api.arkbox.co/*

api.tekus.co/*

HTTPS

443 (TCP)

Comunicación, mensajes y colas de mensajería

Cliente de datos > Servidor

sqs.us-east-1.amazonaws.com/

sqs.us-east-1.amazonaws.com/*

HTTPS

443 (TCP)

pns.arkbox.co/*

pns.tekus.co/*

n0mtleabw0.execute-api.us-east-1.amazonaws.com/prod

d-k5jiassydk.execute-api.us-east-1.amazonaws.com

WWS (Web Socket Secure)

443 (TCP)

Entre player Arkbox con cliente de datos

Entre player Arkbox con cliente de datos

Funcionalidad

Dirección

Destino ó FQDN

Protocolo

Puertos

Consulta de XML de una fuente de datos

Player > Cliente de datos

{IP_EQUIPO_CLIENTE_DATOS}:{PUERTO}

HTTP

8181*

El destino depende de la IP (o nombre del recurso visible en red) en dónde se instale el cliente de datos. Es importante que configures el firewall en el equipo con el fin de garantizar el tráfico entrante por este puerto.

El puerto 8181 es un puerto sugerido. Si el cliente desea cambiar este puerto lo puede hacer en las configuraciones del cliente de datos.

 

Resolución de problemas

A continuación te presentamos algunas posibles situaciones en las que no se logra una conexión correcta entre los componentes de la plataforma. Así también te explicamos las posibles causas y posibles soluciones.

 

Error de certificado de seguridad (HTTPS):

Error de certificado de seguridad (HTTPS)

Al navegar en la página de la cuenta del cliente “https://mydomain.arkbox.co ” desde un equipo o desde un player encuentras errores relacionados con el certificado de seguridad de la página.

  • Causa: Es posible que la hora del equipo no esté configurada correctamente. En el caso de players que no tengan una batería que almacena esta información, es posible que sea un problema relacionado con la configuración de la red dado que algunos routers no configuran la hora de manera automática.

  • Solución: Debes validar la fecha y hora del dispositivo que está intentando acceder a plataforma.

Código de registro no mostrado en pantalla principal

Código de registro no mostrado en pantalla principal

Al abrir la aplicación Arkbox o Lighthouse en el player no se te muestra un código alfanumérico en pantalla, por lo que no puedes realizar el registro del dispositivo.

  • Causa 1: El dispositivo no cuenta con acceso a internet

  • Resolución 1: Debes validar la conexión del player a internet. Para ello debes abrir un navegador en el dispositivo e ingresar el siguiente enlace: https://api.arkbox.co/Status

Debería cargarte la página como se muestra a continuación.

  • Causa 2: El dispositivo cuenta con acceso a internet, pero existen restricciones en la red que no permiten navegación. Por ejemplo, puedes navegar en la página de google (www.google.com ) pero no en la de Arkbox.

  • Resolución 2: Debes contactar a tu administrador de red e indicarle los puertos y destinos relacionados en este documento.


Aviso Legal

 Copyright © Tekus S.A.S 2022. Todos los derechos reservados.

El presente documento no podrá ser reproducido ni transmitido de ninguna forma ni por ningún medio sin el consentimiento previo otorgado por escrito de Tekus S.A.S y sus filiales.

El producto que se describe en este manual puede contener software cuyos derechos de autor pertenecen a Tekus S.A.S y a sus posibles licenciantes. Los clientes no podrán reproducir, distribuir, modificar, descompilar, desarmar, decodificar, extraer, ceder ni arrendar dicho software de ningún modo, como tampoco practicar ingeniería inversa, ni otorgar una sublicencia de este, salvo en aquellos casos en que la ley aplicable prohíba dichas restricciones o que dichas acciones hayan sido aprobadas por los titulares de los derechos de autor respectivos.