Serveur XenMobile®

Firebase Cloud Messaging

Remarque :

Firebase Cloud Messaging (FCM) était auparavant connu sous le nom de Google Cloud Messaging (GCM). Certaines étiquettes et messages de la console XenMobile® utilisent la terminologie GCM.

Citrix® vous recommande d’utiliser Firebase Cloud Messaging (FCM) pour contrôler comment et quand les appareils Android se connectent à XenMobile. XenMobile, lorsqu’il est configuré pour FCM, envoie des notifications de connexion aux appareils Android compatibles avec FCM. Toute action de sécurité ou commande de déploiement déclenche une notification push pour inviter l’utilisateur à se reconnecter au serveur XenMobile.

Une fois que vous avez terminé les étapes de configuration de cet article et qu’un appareil s’est enregistré, l’appareil s’enregistre auprès du service FCM dans le serveur XenMobile. Cette connexion permet une communication quasi en temps réel entre votre service XenMobile et votre appareil à l’aide de FCM. L’enregistrement FCM fonctionne pour les nouvelles inscriptions d’appareils et les appareils précédemment inscrits.

Lorsque XenMobile doit établir une connexion avec l’appareil, il se connecte au service FCM. Ensuite, le service FCM notifie l’appareil de se connecter. Ce type de connexion est similaire à celui qu’Apple utilise pour son service de notification push.

Conditions préalables

  • Client Secure Hub le plus récent
  • Informations d’identification du compte développeur Google
  • Services Google Play installés sur les appareils Android compatibles avec FCM

Ports de pare-feu

  • Ouvrez le port 443 sur XenMobile vers fcm.googleapis.com et Google.com.
  • Ouvrez la communication Internet sortante pour le Wi-Fi de l’appareil sur les ports 5228, 5229 et 5230.
  • Pour autoriser les connexions sortantes, FCM recommande d’autoriser les ports 5228 à 5230 sans restrictions IP. Toutefois, si vous avez besoin de restrictions IP, FCM recommande d’autoriser toutes les adresses IP des blocs IPv4 et IPv6. Ces blocs sont répertoriés dans l’ASN 15169 de Google. Mettez à jour cette liste tous les mois. Pour plus d’informations sur les ports FCM, consultez la documentation Google sur les ports FCM.

Pour plus d’informations, consultez la section Exigences en matière de ports.

Architecture

Ce diagramme montre le flux de communication pour FCM dans le réseau externe et interne.

L’architecture FCM

Pour configurer votre compte Google pour FCM

  1. Connectez-vous à l’URL suivante à l’aide des informations d’identification de votre compte développeur Google :

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

  2. Cliquez sur Add project (Ajouter un projet).

    L’option Créer un projet

  3. Après avoir créé le projet, cliquez sur Project settings (Paramètres du projet).

    L’option Paramètres du projet

    Remarque :

    Google va déprécier les API héritées de FCM pour HTTP, qui sont actuellement utilisées dans notre implémentation FCM. La date limite de migration est le 21 juin 2024. Nous devons migrer FCM de l’API FCM héritée vers l’API HTTP v1. Pour plus d’informations, consultez la section Migrate from legacy FCM APIs to HTTP v1.

  4. Cliquez sur l’onglet Cloud Messaging. Vérifiez que l’API Firebase Cloud Messaging est activée et cliquez sur Manage Service Accounts (Gérer les comptes de service).

    1. Avant la migration, vous pouviez utiliser l’API héritée. Assurez-vous que l’API Cloud Messaging (Legacy) est activée. Copiez les valeurs des champs Key (Clé) et Sender ID (ID d’expéditeur).

      Activer l’API Cloud Messaging

      Si aucune clé n’est répertoriée, cliquez sur les points de suspension sous Actions pour ajouter une clé.

      Actions

    2. Après la migration, l’API héritée est dépréciée par Google. Vous devez activer l’API Firebase Cloud Messaging (V1). Pour plus d’informations, consultez la section Migrate from legacy FCM APIs to HTTP v1.

      Activer FCI

      Téléchargez le fichier JSON du compte de service à partir de Service accounts (Comptes de service) sous Project settings (Paramètres du projet). Consultez la section Provide credentials manually pour générer un fichier de clé privée pour votre compte de service. Cliquez sur Generate new private key (Générer une nouvelle clé privée) pour télécharger le fichier JSON de la clé du compte de service.

      Paramètres du projet

Pour les étapes de configuration d’une application client FCM sur Android, consultez cet article de Google Developers Cloud Messaging : https://firebase.google.com/docs/cloud-messaging/android/client.

Pour configurer XenMobile pour FCM

Dans la console XenMobile, accédez à Settings > Firebase Cloud Messaging (Paramètres > Firebase Cloud Messaging).

Pour l’API Cloud Messaging (Legacy)

  1. Saisissez la Key (Clé) Firebase Cloud Messaging de la dernière étape de la configuration Firebase Cloud Messaging dans le champ API key (Clé API).

  2. Saisissez la valeur Sender ID (ID d’expéditeur) de la procédure précédente.

La saisie de la valeur de l’ID d’expéditeur

Pour l’API Firebase Cloud Messaging (V1)

Remarques :

  • Pour activer l’API FCM V1 pour XenMobile Server version 10.15 Rolling Patch 7 et versions ultérieures, consultez l’article du Knowledge Center CTX677031.
  • Si vous êtes un nouvel utilisateur FCM, ignorez l’étape 1 et passez à l’étape 2.
  1. Si vous utilisez déjà FCM, vous remarquerez que l’ID d’expéditeur est automatiquement renseigné avec votre projet FCM actuel et qu’une nouvelle option permet de télécharger le Service Account Key File (Fichier de clé de compte de service).

    FCM pour les utilisateurs actuels

  2. Si vous êtes un nouvel utilisateur FCM, saisissez l’ID d’expéditeur et téléchargez le Service Account Key File (Fichier de clé de compte de service) de la procédure précédente.

    Nouvel utilisateur FCM

  3. Le fichier téléchargé sera analysé et les champs correspondants seront générés automatiquement.

    Compte de service analysé

  4. Vérifiez les informations et cliquez sur Save (Enregistrer).

Pour tester votre configuration

  1. Inscrivez un appareil Android.

  2. Laissez l’appareil inactif pendant un certain temps, afin qu’il se déconnecte de XenMobile.

  3. Connectez-vous à la console XenMobile, cliquez sur Manage (Gérer), sélectionnez l’appareil Android, puis cliquez sur Secure (Sécuriser).

    L’option Sécuriser l’appareil Android

  4. Sous Device Actions (Actions de l’appareil), cliquez sur Selective Wipe (Effacement sélectif).

    L’option Effacement sélectif

    En cas de configuration réussie, l’effacement sélectif se produit sur l’appareil.

Firebase Cloud Messaging