Citrix Endpoint Management™

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 Citrix Endpoint Management utilizan 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 Citrix Endpoint Management. Citrix Endpoint Management, 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 pedir al usuario que se vuelva a conectar al servidor de Citrix Endpoint Management.

  • Después de completar los pasos de configuración de este artículo y de que un dispositivo se registre, el dispositivo se registra con el servicio FCM en Citrix Endpoint Management. Esa conexión permite la comunicación casi en tiempo real desde tu servicio de Citrix Endpoint Management a tu dispositivo mediante FCM. El registro de FCM funciona para nuevas inscripciones de dispositivos y para dispositivos inscritos anteriormente.

  • Cuando Citrix Endpoint Management 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 Apple usa para su servicio de notificaciones push.

  • Requisitos previos

  • Cliente de Citrix 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 de firewall

  • Abre el puerto 443 en Citrix Endpoint Management para 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 agregar los puertos 5228 a 5230 a una lista de permitidos, sin restricciones de IP. Sin embargo, si necesitas restricciones de IP, FCM recomienda agregar todas las direcciones IP de los bloques IPv4 e IPv6 a una lista de permitidos. Esos bloques se enumeran en el ASN 15169 de Google. Actualiza esa lista mensualmente.

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

Arquitectura

Este diagrama muestra el flujo de comunicación para 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 con 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 usan actualmente en nuestra implementación de FCM. La fecha límite para la migración es el 21 de junio de 2024. Necesitamos migrar FCM de la API heredada de FCM a la API HTTP v1. Para obtener más información, consulta Migrar de las API heredadas de FCM 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, Google deja de usar la API heredada. Tienes que habilitar la API de Firebase Cloud Messaging (V1). Para obtener más información, consulta Migrar de las API heredadas de FCM a HTTP v1.

      Habilitar FCI

      Descarga el archivo JSON de la cuenta de servicio de 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 Citrix Endpoint Management para FCM

En la consola de Citrix Endpoint Management, 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 Citrix Endpoint Management versión 24.6.0 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 usas FCM, verás que el ID de remitente se rellena automáticamente con tu proyecto de FCM actual y 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 Citrix Endpoint Management.

  3. En la consola de Citrix Endpoint Management, haz clic en Administrar, selecciona el dispositivo Android y, a continuación, 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

    Si la configuración es correcta, se produce un borrado selectivo en el dispositivo.

Firebase Cloud Messaging