Requisitos de TI y Operación

Sensores

Para que los sensores se comuniquen con QUMEA-Cloud, el firewall del cliente debe configurarse de tal manera que:

  • se permitan conexiones salientes a *.qumea.cloud [1] en los puertos 443 (TCP), 51820 (UDP), 51821 (UDP),

  • se proporcione un NTP a través de DHCP o se permita el acceso a time1.google.com, time2.google.com y time3.google.com.

  • no haya geobloqueo para rangos de IP en conexiones salientes, [2]

  • no haya inspección SSL en la conexión a *.qumea.cloud, [3]

  • Nuestra recomendación: Coloque los sensores Qumea en su propia red, ya sea físicamente separada o en una VLAN separada. Los sensores no necesitan acceso a la red interna del cliente, solo deben comunicarse con nuestra nube.

  • El sensor está destinado a ser utilizado en un entorno de red habilitado para DHCP.

  • Los sensores Qumea no son un dispositivo médico.

Verifique que las siguientes opciones estén activadas en su enrutador:

Opciones del enrutador
Figure 1. Opciones del enrutador que deben estar activadas. Dependiendo del modelo del enrutador, las opciones pueden variar.

Dispositivos móviles

Apple

Los dispositivos móviles deben poder:

  • conectarse a *.qumea.cloud en el puerto 443.

Para la recepción exitosa de notificaciones push, los siguientes rangos de IP y puertos deben estar accesibles [4]:

  • Puerto(s): 5223 (TCP)

  • Rango de IP: 17.0.0.0/8 (todo el rango pertenece a Apple)

Si los iPhones son proporcionados por QUMEA, las siguientes conexiones deben estar permitidas para la gestión de dispositivos (JAMF):

  • *jamfnow.com, *jamfcloud.com

Android

Rangos de IP y puertos

Los dispositivos móviles deben poder:

  • conectarse a *.qumea.cloud en el puerto 443.

Para la recepción exitosa de notificaciones push, los siguientes rangos de IP y puertos deben estar accesibles [5]:

  • Puerto(s): 443, 5228-5230 (TCP)

  • Nombres de host: mtalk.google.com mtalk4.google.com mtalk-staging.google.com mtalk-dev.google.com alt1-mtalk.google.com alt2-mtalk.google.com alt3-mtalk.google.com alt4-mtalk.google.com alt5-mtalk.google.com alt6-mtalk.google.com alt7-mtalk.google.com alt8-mtalk.google.com android.clients.google.com device-provisioning.googleapis.com

Configuraciones recomendadas del sistema Android

Las siguientes configuraciones del sistema deben estar correctamente configuradas en Android para que la aplicación QUMEA funcione de manera óptima:

  • Desactivar la optimización de batería para la aplicación QUMEA

  • Si el dispositivo móvil solo está conectado a través de la red móvil, habilitar el uso de datos en segundo plano para la aplicación QUMEA

Distribución de la aplicación

Para distribuir la aplicación QUMEA en tu organización, debes proporcionar a QUMEA tu ID de Organización de Google (ID comienza con C0 o LC0).

Actualizaciones de software

Las actualizaciones de software pueden ser lanzadas por QUMEA para corregir errores o mejorar funciones después de que el producto haya sido lanzado. Las versiones de software actualizadas no afectarán el cumplimiento continuo de todas las reglas aplicables. Los parámetros de frecuencia de radio no son accesibles para el usuario y no pueden ser cambiados por el usuario.

Puntos finales de API pública para monitoreo de salud del sistema

La API pública de salud proporciona acceso a varios estados de salud de los sensores, funcionalidades en ejecución y servicios en la nube dentro de nuestra plataforma. Este capítulo describe los puntos finales disponibles, sus propósitos y cómo usarlos de manera efectiva para monitorear la salud del sistema. Antes de comenzar, asegúrate de que tu entorno esté configurado según las instrucciones en el capítulo de instalación. La API pública de salud es accesible una vez que el sistema está en funcionamiento y puede ser consultada aproximadamente una vez por minuto.

Para usar los puntos finales de la API pública, se necesita la URL de la interfaz web. Agrega las rutas proporcionadas a continuación al final de la interfaz web. Por ejemplo, ver Estructura de respuesta.

Estado general de salud

Ruta: api/public/v1/health

Método: GET

Resumen: Devuelve el estado de salud combinado de los sensores, funcionalidades y servicios en la nube de Qumea. Si todos los componentes están saludables, se devuelve un estado de OK; de lo contrario, DOWN.

Estado de salud de los sensores

Ruta: api/public/v1/health/sensors

Método: GET

Resumen: Proporciona el estado de salud de los sensores del sistema. Devuelve OK si todos los sensores funcionan correctamente o DOWN si algún sensor no funciona como se espera.

Estado de salud de la aplicación

Ruta: api/public/v1/health/application

Método: GET

Resumen: Recupera el estado de salud de todas las funcionalidades en ejecución. Un estado OK indica que todas las funcionalidades en ejecución están saludables, mientras que DOWN significa que al menos una funcionalidad está experimentando problemas.

Estado de salud del sistema

Ruta: api/public/v1/health/system

Método: GET

Resumen: Verifica el estado de salud general de los servicios en la nube de Qumea. Al igual que otros puntos finales, devuelve OK si todos los servicios en la nube son accesibles y DOWN si un servicio no es accesible.

Estructura de respuesta

Cada punto final devuelve una respuesta JSON con la marca de tiempo actual y el estado de salud. El estado de salud puede ser OK o DOWN, dependiendo de la salud del sistema en el momento de la solicitud.

Ejemplo de respuesta JSON para un sistema saludable. Ejemplo de llamada URL: https://test.qumea.cloud/api/public/v1/health
{
  "timestamp": "2023-01-01T12:00:00Z",
  "status": "OK"
}
Ejemplo de respuesta JSON para un sistema no saludable (acompañado de un código de estado 503). Ejemplo de llamada URL: https://test.qumea.cloud/api/public/v1/health/system
{
  "timestamp": "2023-01-01T12:00:00Z",
  "status": "DOWN"
}

1. Si la configuración con el operador comodín no es posible, los siguientes enlaces deben estar abiertos: mqtt.qumea.cloud devices.qumea.cloud packages.qumea.cloud packages-repo.qumea.cloud radiqvpn.qumea.cloud prim.radiqvpn.qumea.cloud sec.radiqvpn.qumea.cloud update.qumea.cloud sensormgmt.qumea.cloud loki.qumea.cloud
2. Por diseño, los servicios en la nube no están vinculados a una ubicación específica y pueden cambiar su ubicación geográfica sin previo aviso
3. Algunos dispositivos QUMEA utilizan mTLS, por lo tanto, con la inspección SSL activa, la nube rechaza las solicitudes de conexión de los sensores
5. Ver también: Puertos FCM y tu firewall