Firebase Cloud Messaging
Nota:
Firebase Cloud Messaging (FCM) se conocía anteriormente como Google Cloud Messaging (GCM). Algunas etiquetas y mensajes de la consola de XenMobile® utilizan la terminología de GCM.
Citrix® recomienda utilizar Firebase Cloud Messaging (FCM) para controlar cómo y cuándo se conectan los dispositivos Android a XenMobile. Cuando XenMobile 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 solicitar al usuario que se vuelva a conectar al servidor de XenMobile.
Una vez que complete los pasos de configuración de este artículo y un dispositivo se registre, el dispositivo se registrará con el servicio FCM en el servidor de XenMobile. Esa conexión permite la comunicación casi en tiempo real desde su servicio XenMobile a su dispositivo mediante FCM. El registro de FCM funciona para nuevas inscripciones de dispositivos y para dispositivos inscritos anteriormente.
Cuando XenMobile necesita iniciar una conexión con el dispositivo, se conecta al servicio FCM. Luego, el servicio FCM notifica al dispositivo que se conecte. Este tipo de conexión es similar a la que utiliza 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
-
Abra el puerto 443 en XenMobile a
fcm.googleapis.comyGoogle.com. -
Abra 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 necesita restricciones de IP, FCM recomienda permitir todas las direcciones IP en los bloques IPv4 e IPv6. Esos bloques se enumeran en el ASN de 15169 de Google. Actualice esa lista mensualmente. Para obtener más información sobre los puertos de FCM, consulte la documentación de Google sobre puertos de FCM.
Para obtener más información, consulte Requisitos de puertos.
Arquitectura
Este diagrama muestra el flujo de comunicación para FCM en la red externa e interna.
Para configurar su cuenta de Google para FCM
-
Inicie sesión en la siguiente URL utilizando las credenciales de su cuenta de desarrollador de Google:
<https://console.firebase.google.com/> -
Haga clic en Añadir proyecto.

-
Después de crear el proyecto, haga clic en Configuración del proyecto.
Nota:Google va a dejar de usar las API heredadas de FCM para HTTP, que se utilizan actualmente en nuestra implementación de FCM. La fecha límite de migración es June 21, 2024. Necesitamos migrar FCM de la API heredada de FCM a la API HTTP v1. Para obtener más información, consulte Migrar de las API heredadas de FCM a HTTP v1. -
Haga clic en la pestaña Cloud Messaging. verificar que la API de Firebase Cloud Messaging esté habilitada y haga clic en Administrar cuentas de servicio.
-
Antes de la migración, podía usar la API heredada; asegúrese de que la API de Cloud Messaging (heredada) esté habilitada. Copie los valores de los campos Clave e ID de remitente.
Si no tiene una clave en la lista, haga clic en los puntos suspensivos en Acciones para añadir una clave.
-
Después de la migración, la API heredada queda en desuso por parte de Google. Debe habilitar la API de Firebase Cloud Messaging (V1). Para obtener más información, consulte Migrar de las API de FCM heredadas a HTTP v1.
Descargue el archivo JSON de la cuenta de servicio desde Cuentas de servicio en Configuración del proyecto. Consulte la sección Proporcionar credenciales manualmente para generar un archivo de clave privada para su cuenta de servicio. Haga clic en Generar nueva clave privada para descargar el archivo JSON de la clave de la cuenta de servicio.
-
Para conocer los pasos para configurar una aplicación cliente de FCM en Android, consulte 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, vaya a Parámetros > Firebase Cloud Messaging.
Para la API de Cloud Messaging (heredada)
-
Introduzca la clave de Firebase Cloud Messaging del último paso de la configuración de Firebase Cloud Messaging en el campo Clave de API.
-
Introduzca el valor de ID de remitente del procedimiento anterior.
Para la API de Firebase Cloud Messaging (V1)
Notas:
-
Para habilitar la API V1 de FCM para XenMobile Server versión 10.15 Rolling Patch 7 y posteriores, consulte el artículo del Centro de conocimientos CTX677031.
-
Si es un nuevo usuario de FCM, omita el paso 1 y continúe a partir del paso 2.
-
Si ya utiliza FCM, observará que el ID de remitente se rellena automáticamente con su proyecto de FCM actual y que aparece una nueva opción para cargar el archivo de clave de cuenta de servicio (Service Account Key File).

-
Si es un nuevo usuario de FCM, introduzca el ID de remitente y cargue el archivo de clave de cuenta de servicio del procedimiento anterior.

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

-
verificar la información y haga clic en Guardar.
Para probar la configuración
-
Inscriba un dispositivo Android.
-
Deje el dispositivo inactivo durante un tiempo para que se desconecte de XenMobile.
-
Inicie sesión en la consola de XenMobile, haga clic en Administrar, seleccione el dispositivo Android y, a continuación, haga clic en Proteger.

-
En Acciones del dispositivo, haga clic en Borrado selectivo.
En una configuración correcta, el borrado selectivo se produce en el dispositivo.