Skip to main content
Skip table of contents

Puertos y recursos web

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 Tekus DS ha sido desarrolladas (Android, Windows, iOS, WebOS, Tizen, Universal web app, Java).

Generalidades

La red en la que se habilita un player con Tekus DS 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 Tekus Suite, Servidor Cliente, Player Tekus DS, 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:

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 Tekus Suite en las siguientes secciones.

Entre player Tekus DS y servidor Tekus Suite

Entre player Tekus DS y servidor Tekus Suite

  • Player: Dispositivo que ejecuta el aplicativo Player Tekus DS 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.tekus.co/*

api.arkbox.co/*

apiscreens.tekus.co/*

HTTPS

443 (TCP)

Sincronización de contenidos medias

Player > Servidor

arkbox.s3.amazonaws.com/*

s3.amazonaws.com/arkbox/*

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

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

cdn.tekus.co/*

cn.tekus.co/*

files.tekus.co/*

cdn.arkbox.co/*

HTTPS

443 (TCP)

Revisión estado de conexión (WebOS < V2.0.0)

Player > Servidor

cdn.arkbox.co/*

cdn.tekus.co/*

cn.tekus.co/*

HTTP

80 (TCP)

Comunicación, mensajes y colas de mensajería

Player > Servidor

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

HTTPS

443 (TCP)

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 Tekus Suite

Entre cliente web y servidor Tekus Suite

  • 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.tekus.co/*

mydomain.app.tekus.co

HTTPS

443 (TCP)

Carga de contenidos y visualización de contenidos

Cliente web > Servidor

mydomain.tekus.co/*

arkbox.s3.amazonaws.com/*

s3.amazonaws.com/arkbox/*

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

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

cn.tekus.co/*

cdn.tekus.co/*

files.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)

Comunicación, notificaciones push

Cliente web > Servidor

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 Tekus Suite

Entre equipo con cliente de datos y servidor Tekus Suite

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 Tekus Suite 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.tekus.co/*

api.arkbox.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.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 Tekus DS con cliente de datos

Entre player Tekus DS 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.tekus.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 Tekus DS 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.tekus.co para dispositivos anteriores a las versiones V4 de android y V2 de Windows y https://apisreens.tekus.co para dispositivos superiores a versión android V4 y versión V2 de Windows.

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

https://api.tekus.co

image-20240412-210801.png

https://apiscreens.tekus.co

  • 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 (https://www.google.com) pero no en la de Tekus Suite.

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

Pantalla registrada, pero no descarga contenido

Pantalla registrada, pero no descarga contenido

Al abrir la aplicación Tekus DS en el player se muestra código alfanumérico en pantalla, pero luego de realizar le registro, el player no descarga el contenido de la lista de reproducción.

  • Causa 1: El dispositivo no tiene asociada una lista de reproducción

  • Resolución 1: Dirígite a tu cuenta y vincula una lista de reproducción desde la sección ‘Contenido’ en la edición del Player.

  • Causa 2: Aunque el dispositivo logró conectarse y registrarse es posible que los recursos de red para la descarga de contenidos no estén habilitados. Para comprobar esto navega la siguiente URL: https://arkbox.s3.amazonaws.com/test y https://cn.tekus.co/test. Deberías ver un contenido como el siguiente:

Si no ves este contenido es posible que haya una restricción hacia el destino/FQDN utilizado para la descarga de contenidos

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


¿Te gustaría probar nuestras soluciones?

¡Qué esperas para solicitar tu demo! Haz clic aquí. 🤩


Aviso Legal

Copyright © Tekus S.A.S 2024. 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.

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.