Puertos y recursos web
Tabla de contenidos
Guía para garantizar el correcto funcionamiento de Tekus DS
En este artículo te explicamos los recursos web, restricciones, destinos y demás características necesarias para que la aplicación de señalización digital funcione de manera óptima. Estas indicaciones aplican para todas las plataformas en las que Tekus DS está disponible: Android, Windows, iOS, WebOS, Tizen, Universal Web App y Java.
Generalidades
La red donde se habilita un player con Tekus DS puede tener restricciones como Firewalls, Proxys u otros componentes que limitan la navegación hacia internet. Por eso, aquí te detallamos los requisitos mínimos que deben cumplirse para garantizar el funcionamiento adecuado de nuestras aplicaciones.
¿Cómo interpretamos los requisitos?
Los requerimientos están organizados considerando los dos extremos involucrados en cada proceso de comunicación. Estos extremos incluyen:
Servidor Tekus Suite
Player Tekus DS
Navegador web
Servidor Cliente
Computador con cliente de datos instalado
Cada extremo se describe mediante:
Una URL (dirección web) ó un FQDN (Nombre de dominio completo ↗️)
Un puerto (para comunicación).
El protocolo asociado.
Además, para representar las direcciones usamos los símbolos < (menor que) y > (mayor que).
A continuación, te mostramos un ejemplo práctico para ayudarte a comprender mejor estos requisitos:
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 representarse mediante un FQDN, una dirección IP o un rango de direcciones IP. Si el recurso se presenta como un FQDN, es posible que incluya el carácter * (asterisco), que actúa 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
Restricciones de acceso por IP en redes específicas
En algunas configuraciones de red, el acceso a los recursos se restringe según la IP del destino y no por el FQDN (nombre de dominio completo). Como nuestra solución está alojada en un entorno de cloud computing con balanceo de carga y escalabilidad automática, es importante que tengas en cuenta que no utilizamos una única IP en nuestros servidores, sino un rango de direcciones IP asociadas a los recursos implementados.
Nuestra infraestructura está respaldada por Amazon Web Services (AWS). Por esta razón, te recomendamos establecer las restricciones según los rangos de IP definidos en el siguiente enlace:
👉 Rangos de IP de AWS.
Dado que estos rangos son amplios, AWS proporciona herramientas que permiten filtrar las IPs según regiones y servicios. A continuación, detallamos las regiones y servicios utilizados por nuestra solución y que tienen recursos expuestos a internet:
Regiones:
US East (N. Virginia). Esta región se identifica como us-east-1.Servicios:
EC2, S3, SQS, Cloud Front, SNS, SES, ELB, WAF, Route 53, Lambda,
Si las restricciones se pueden establecer por URL, puedes encontrar los destinos usados por los componentes de Tekus Suite en las siguientes secciones.
Conexión entre Player Tekus DS y el Servidor Tekus Suite
Player: Dispositivo que ejecuta la aplicación Player Tekus DS o Lighthouse. Algunos ejemplos de players incluyen Android TV Box, pantallas de señalización digital con WebOS, o PC con Windows.
Servidor: Recurso en la nube que se encarga de recibir todas las solicitudes de clientes, como usuarios y players, para gestionar y administrar los contenidos de manera eficiente.
Funcionalidad | Dirección | Destino ó FQDN | Protocolo | Puertos |
Sincronización de datos, contenidos, comandos de administración. REST/API | Player > Servidor | HTTPS | 443 (TCP) | |
Sincronización de contenidos medias | Player > Servidor | arkbox.s3-us-west-1.amazonaws.com/* | HTTPS | 443 (TCP) |
Revisión estado de conexión (WebOS < V2.0.0) | Player > Servidor | HTTP | 80 (TCP) | |
Comunicación, mensajes y colas de mensajería | Player > Servidor | HTTPS | 443 (TCP) | |
n0mtleabw0.execute-api.us-east-1.amazonaws.com/prod | 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) |
Conexión entre el Cliente Web y el Servidor Tekus Suite
Cliente Web: Es el navegador que utiliza el usuario para acceder a la administración de su cuenta. Ten en cuenta que cada cuenta tiene asignado un subdominio único. En los ejemplos de la tabla siguiente, se utilizará mydomain como el dominio representativo para la cuenta.
Servidor: Recurso alojado en la nube encargado de recibir todas las solicitudes de los clientes para gestionar y administrar contenidos de forma eficiente.
Funcionalidad | Dirección | Destino ó FQDN | Protocolo | Puertos |
Navegación y administración de contenidos y players | Cliente web > Servidor | HTTPS | 443 (TCP) | |
Carga de contenidos y visualización de contenidos | Cliente web > Servidor | arkbox.s3-us-west-1.amazonaws.com/* | HTTPS | 443 (TCP) |
Comunicación, mensajes y colas de mensajería | Cliente web > Servidor | HTTPS | 443 (TCP) | |
Comunicación, notificaciones push | Cliente web > Servidor | WWS (Web Socket Secure) | 443 (TCP) |
Entre equipo con cliente de datos y servidor Tekus Suite
Esta sección aplica únicamente para implementaciones que necesitan mostrar datos en las pantallas provenientes de algún recurso informático dentro de la red. Si este caso no aplica a tu implementación, puedes omitir estas recomendaciones.
Cliente de datos: Es un componente de software proporcionado por Tekus Suite que permite interpretar diferentes orígenes de datos, como XLS, XLSX, texto plano o bases de datos, y convertirlos en una fuente Web XML. Este componente debe instalarse en un equipo con Windows
Funcionalidad | Dirección | Destino ó FQDN | Protocolo | Puertos |
Sincronización de datos, comandos de administración. REST/API | Cliente de datos > Servidor | HTTPS | 443 (TCP) | |
Comunicación, mensajes y colas de mensajería | Cliente de datos > Servidor | HTTPS | 443 (TCP) | |
WWS (Web Socket Secure) | 443 (TCP) |
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 dependerá de la IP o del nombre del recurso visible en la red donde se instale el cliente de datos. Es fundamental configurar el firewall en el equipo para garantizar que el tráfico entrante por el puerto correspondiente se permita correctamente.
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)
Si al ingresar a la página de tu cuenta en https://mydomain.tekus.co desde un equipo o un player aparecen errores relacionados con el certificado de seguridad, es posible que la causa esté relacionada con la configuración de la hora en el dispositivo.
Causa
Es probable que la hora del equipo no esté configurada correctamente.
En el caso de players sin batería para almacenar esta información, el problema podría estar asociado a la configuración de la red, ya que algunos routers no ajustan la hora automáticamente.
Solución
Verifica y corrige la fecha y hora en el dispositivo que está intentando acceder a la plataforma.
Código de registro no mostrado en pantalla principal
Si al abrir la aplicación Tekus DS el player no muestra un código alfanumérico en la pantalla, no podrás registrar el dispositivo.
Causa 1
El dispositivo no tiene acceso a internet.
Solución 1
Verifica la conexión a internet del player:
Abre un navegador en el dispositivo e ingresa la siguiente URL según la versión del sistema operativo:
Para dispositivos con versiones anteriores a Android V4 y Windows V2, utiliza:
https://api.tekus.coPara dispositivos con versiones posteriores a Android V4 y Windows V2, utiliza:
https://apiscreens.tekus.co
La página debería cargarse correctamente como se muestra en la imagen a continuación.
Causa 2
El dispositivo tiene acceso a internet, pero existen restricciones en la red que impiden la navegación hacia ciertos destinos. Por ejemplo, puedes acceder a https://www.google.com , pero no a los recursos de Tekus Suite.
Resolución 2
Contacta a tu administrador de red y proporciónale la lista de puertos y destinos especificados en este documento para que los habilite correctamente.
Pantalla registrada, pero no descarga contenido
Si al abrir la aplicación Tekus DS en el player aparece un código alfanumérico en pantalla, pero después de registrar el dispositivo no se descarga el contenido de la lista de reproducción, podrían estar ocurriendo los siguientes problemas:
Causa 1
El dispositivo no tiene asociada una lista de reproducción.
Solución 1
Accede a tu cuenta y vincula una lista de reproducción desde la sección ‘Contenido’, en la edición del player correspondiente.
Causa 2
Aunque el dispositivo logró conectarse y registrarse, es posible que los recursos de red necesarios para la descarga de contenidos no estén habilitados.
Para comprobarlo, ingresa desde un navegador a las siguientes URLs:
Deberías visualizar un contenido similar al que se muestra a continuación.
Solución 2
Contacta a tu administrador de red y proporciónale la lista de puertos y destinos especificados en este documento para habilitar el acceso necesario.
Si no puedes ver este contenido, es probable que haya restricciones hacia el destino o el FQDN utilizado para la descarga de contenidos.
Si tienes algún requerimiento de soporte comunícate con nosotros a través de www.tekus.co/soporte.
Aviso Legal
Copyright © Tekus S.A.S 2025. 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.