XenMobile® Server

Firebase Cloud Messaging

Nota:

Firebase Cloud Messaging (FCM) era anteriormente conocido como Google Cloud Messaging (GCM). Algunas etiquetas y mensajes de la consola de XenMobile® usan la terminología de GCM.

Citrix® te recomienda usar Firebase Cloud Messaging (FCM) para controlar cómo y cuándo los dispositivos Android se conectan a XenMobile. XenMobile, cuando está configurado para FCM, envía notificaciones de conexión a los dispositivos Android que tienen FCM habilitado. Cualquier acción de seguridad o comando de implementación activa una notificación push para pedirle al usuario que se vuelva a conectar a XenMobile Server.

Después de completar los pasos de configuración en este artículo y un dispositivo se registra, el dispositivo se registra con el servicio FCM en XenMobile Server. Esa conexión permite una comunicación casi en tiempo real desde tu servicio XenMobile a tu dispositivo usando FCM. El registro de FCM funciona para nuevas inscripciones de dispositivos y para dispositivos inscritos previamente.

Cuando XenMobile necesita iniciar una conexión con el dispositivo, se conecta al servicio FCM. Luego, el servicio FCM notifica al dispositivo para que se conecte. Este tipo de conexión es similar a la que usa Apple para su servicio de notificaciones push.

Requisitos previos

  • Cliente Secure Hub más reciente
  • Credenciales de la cuenta de desarrollador de Google
  • Servicios de Google Play instalados en dispositivos Android con FCM habilitado

Puertos del firewall

  • Abre el puerto 443 en XenMobile a fcm.googleapis.com y Google.com.
  • Abre la comunicación saliente de Internet para el Wi-Fi del dispositivo en los puertos 5228, 5229 y 5230.
  • Para permitir conexiones salientes, FCM recomienda permitir los puertos 5228 a 5230 sin restricciones de IP. Sin embargo, si necesitas restricciones de IP, FCM recomienda permitir todas las direcciones IP en los bloques IPv4 e IPv6. Esos bloques se enumeran en el ASN 15169 de Google. Actualiza esa lista mensualmente. Para obtener más información sobre los puertos de FCM, consulta la documentación de Google sobre puertos de FCM.

Para obtener más información, consulta Requisitos de puertos.

Arquitectura

Este diagrama muestra el flujo de comunicación de FCM en la red externa e interna.

La arquitectura de FCM

Para configurar tu cuenta de Google para FCM

  1. Inicia sesión en la siguiente URL usando las credenciales de tu cuenta de desarrollador de Google:

    https://console.firebase.google.com/

  2. Haz clic en Agregar proyecto.

    La opción Crear un proyecto

  3. Después de crear el proyecto, haz clic en Configuración del proyecto.

    La opción Configuración del proyecto

    Nota:

    Google va a dejar de usar las API heredadas de FCM para HTTP, que se usa actualmente en nuestra implementación de FCM. La fecha límite de migración es el 21 de junio de 2024. Necesitamos migrar FCM de la API de FCM heredada a la API HTTP v1. Para obtener más información, consulta Migrar de las API de FCM heredadas a HTTP v1.

  4. Haz clic en la ficha Cloud Messaging. Verifica que la API de Firebase Cloud Messaging esté habilitada y haz clic en Administrar cuentas de servicio.

    1. Antes de la migración, podías usar la API heredada, asegúrate de que la API de Cloud Messaging (heredada) esté habilitada. Copia los valores de los campos Clave e ID de remitente.

      Habilitar la API de Cloud Messaging

      Si no tienes una clave en la lista, haz clic en los puntos suspensivos en Acciones para agregar una clave.

      Acciones

    2. Después de la migración, la API heredada está en desuso por parte de Google. Debes habilitar la API de Firebase Cloud Messaging (V1). Para obtener más información, consulta Migrar de las API de FCM heredadas a HTTP v1.

      Habilitar FCI

      Descarga el archivo JSON de la cuenta de servicio desde Cuentas de servicio en Configuración del proyecto. Consulta la sección Proporcionar credenciales manualmente para generar un archivo de clave privada para tu cuenta de servicio. Haz clic en Generar nueva clave privada para descargar el archivo JSON de la clave de la cuenta de servicio.

      Configuración del proyecto

Para conocer los pasos para configurar una aplicación cliente de FCM en Android, consulta este artículo de Google Developers Cloud Messaging: https://firebase.google.com/docs/cloud-messaging/android/client.

Para configurar XenMobile para FCM

En la consola de XenMobile, ve a Configuración > Firebase Cloud Messaging.

Para la API de Cloud Messaging (heredada)

  1. Introduce la Clave de Firebase Cloud Messaging del último paso de la configuración de Firebase Cloud Messaging en el campo Clave de API.

  2. Introduce el valor de ID de remitente del procedimiento anterior.

La entrada del valor de ID de remitente

Para la API de Firebase Cloud Messaging (V1)

Notas:

  • Para habilitar la API de FCM V1 para XenMobile Server versión 10.15 Rolling Patch 7 y posteriores, consulta el artículo del Centro de conocimientos CTX677031.
  • Si eres un nuevo usuario de FCM, omite el paso 1 y continúa desde el paso 2.
  1. Si ya estás usando FCM, notarás que el ID de remitente se rellena automáticamente con tu proyecto de FCM actual y aparece una nueva opción para cargar el Archivo de clave de cuenta de servicio.

    FCM para usuarios actuales

  2. Si eres un nuevo usuario de FCM, introduce el ID de remitente y carga el Archivo de clave de cuenta de servicio del procedimiento anterior.

    Nuevo usuario de FCM

  3. El archivo cargado se analizará y los campos correspondientes se generarán automáticamente.

    Cuenta de servicio analizada

  4. Verifica la información y haz clic en Guardar.

Para probar tu configuración

  1. Inscribe un dispositivo Android.

  2. Deja el dispositivo inactivo durante un tiempo para que se desconecte de XenMobile.

  3. Inicia sesión en la consola de XenMobile, haz clic en Administrar, selecciona el dispositivo Android y luego haz clic en Proteger.

    La opción Proteger dispositivo Android

  4. En Acciones del dispositivo, haz clic en Borrado selectivo.

    La opción Borrado selectivo

En una configuración correcta, el borrado selectivo se produce en el dispositivo.

Firebase Cloud Messaging