Citrix Endpoint Management™

Messagerie Cloud Firebase

Remarque :

Firebase Cloud Messaging (FCM) était auparavant connu sous le nom de Google Cloud Messaging (GCM). Certains libellés et messages de la console Citrix Endpoint Management utilisent la terminologie GCM.

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

  • Après avoir 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 Citrix Endpoint Management. Cette connexion permet une communication quasi en temps réel de votre service Citrix Endpoint Management vers votre appareil en utilisant FCM. L’enregistrement FCM fonctionne pour les nouvelles inscriptions d’appareils et les appareils précédemment inscrits.

  • Lorsque Citrix Endpoint Management 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 à ce qu’Apple utilise pour son service de notification push.

  • Conditions préalables

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

Ports de pare-feu

  • Ouvrez le port 443 sur Citrix Endpoint Management 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’ajouter les ports 5228 à 5230 à une liste d’autorisation, sans restrictions IP. Cependant, si vous avez besoin de restrictions IP, FCM recommande d’ajouter toutes les adresses IP des blocs IPv4 et IPv6 à une liste d’autorisation. Ces blocs sont répertoriés dans l’ ASN 15169 de Google. Mettez à jour cette liste mensuellement.

Pour plus d’informations, consultez Exigences de port.

Architecture

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

Architecture FCM

Pour configurer votre compte Google pour FCM

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

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

  2. Cliquez sur Ajouter un projet.

    Option Créer un projet

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

    Option Paramètres du projet

    Remarque :

    Google va déprécier les API FCM héritées 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 Migrer des API FCM héritées vers HTTP v1.

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

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

      Activer l'API Messagerie Cloud

      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 Migrer des API FCM héritées vers HTTP v1.

      Activer FCM

      Téléchargez le fichier JSON du compte de service depuis Comptes de service sous Paramètres du projet. Consultez la section Fournir des informations d’identification manuellement pour générer un fichier de clé privée pour votre compte de service. Cliquez sur Générer une nouvelle clé privée pour télécharger le fichier JSON de la clé de compte de service.

      Paramètres du projet

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

Pour configurer Citrix Endpoint Management pour FCM

Dans la console Citrix Endpoint Management, accédez à Paramètres > Messagerie Cloud Firebase.

Pour l’API Messagerie Cloud (héritée)

  1. Saisissez la clé de Messagerie Cloud Firebase de la dernière étape de la configuration de Messagerie Cloud Firebase dans le champ Clé API.

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

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 Citrix Endpoint Management version 24.6.0 et ultérieure, consultez l’article du Centre de connaissances 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 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 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 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 Citrix Endpoint Management.

  3. Depuis la console Citrix Endpoint Management, cliquez sur Gérer, sélectionnez l’appareil Android, puis cliquez sur Sécuriser.

    Option Sécuriser l'appareil Android

  4. Sous Actions de l’appareil, cliquez sur Effacement sélectif.

    Option Effacement sélectif

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

Messagerie Cloud Firebase