XenMobile® Server

Firebase Cloud Messaging

Hinweis:

Firebase Cloud Messaging (FCM) war früher als Google Cloud Messaging (GCM) bekannt. Einige Bezeichnungen und Meldungen der XenMobile®-Konsole verwenden die GCM-Terminologie.

Citrix® empfiehlt die Verwendung von Firebase Cloud Messaging (FCM), um zu steuern, wie und wann Android-Geräte eine Verbindung zu XenMobile herstellen. Wenn XenMobile für FCM konfiguriert ist, sendet es Verbindungsbenachrichtigungen an Android-Geräte, die für FCM aktiviert sind. Jede Sicherheitsaktion oder jeder Bereitstellungsbefehl löst eine Push-Benachrichtigung aus, die den Benutzer auffordert, die Verbindung zum XenMobile Server wiederherzustellen.

Nachdem Sie die Konfigurationsschritte in diesem Artikel abgeschlossen haben und sich ein Gerät anmeldet, registriert sich das Gerät beim FCM-Dienst im XenMobile Server. Diese Verbindung ermöglicht eine nahezu Echtzeit-Kommunikation von Ihrem XenMobile-Dienst zu Ihrem Gerät über FCM. Die FCM-Registrierung funktioniert für neue Geräteregistrierungen und bereits registrierte Geräte.

Wenn XenMobile eine Verbindung zum Gerät herstellen muss, verbindet es sich mit dem FCM-Dienst. Der FCM-Dienst benachrichtigt dann das Gerät, sich zu verbinden. Diese Art der Verbindung ähnelt der, die Apple für seinen Push Notification Service verwendet.

Voraussetzungen

  • Neuester Secure Hub-Client
  • Anmeldeinformationen für das Google-Entwicklerkonto
  • Google Play-Dienste auf FCM-fähigen Android-Geräten installiert

Firewall-Ports

  • Öffnen Sie Port 443 auf XenMobile für fcm.googleapis.com und Google.com.
  • Öffnen Sie die ausgehende Internetkommunikation für Geräte-WLAN auf den Ports 5228, 5229 und 5230.
  • Um ausgehende Verbindungen zuzulassen, empfiehlt FCM, die Ports 5228 bis 5230 ohne IP-Einschränkungen zuzulassen. Wenn Sie jedoch IP-Einschränkungen benötigen, empfiehlt FCM, alle IP-Adressen in den IPv4- und IPv6-Blöcken zuzulassen. Diese Blöcke sind im Google ASN 15169 aufgeführt. Aktualisieren Sie diese Liste monatlich. Weitere Informationen zu FCM-Ports finden Sie in der Google-Dokumentation zu FCM-Ports.

Weitere Informationen finden Sie unter Portanforderungen.

Architektur

Dieses Diagramm zeigt den Kommunikationsfluss für FCM im externen und internen Netzwerk.

Die FCM-Architektur

So konfigurieren Sie Ihr Google-Konto für FCM

  1. Melden Sie sich mit Ihren Google-Entwicklerkonto-Anmeldeinformationen unter der folgenden URL an:

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

  2. Klicken Sie auf Projekt hinzufügen.

    Die Option "Projekt erstellen"

  3. Nachdem Sie das Projekt erstellt haben, klicken Sie auf Projekteinstellungen.

    Die Option "Projekteinstellungen"

    Hinweis:

    Google wird die älteren FCM-APIs für HTTP, die derzeit in unserer FCM-Implementierung verwendet werden, einstellen. Die Migrationsfrist ist der 21. Juni 2024. Wir müssen FCM von der älteren FCM-API zur HTTP v1 API migrieren. Weitere Informationen finden Sie unter Von älteren FCM-APIs zu HTTP v1 migrieren.

  4. Klicken Sie auf die Registerkarte Cloud Messaging. Vergewissern Sie sich, dass die Firebase Cloud Messaging API aktiviert ist, und klicken Sie auf Dienstkonten verwalten.

    1. Vor der Migration konnten Sie die Legacy-API verwenden. Stellen Sie sicher, dass die Cloud Messaging API (Legacy) aktiviert ist. Kopieren Sie die Werte aus den Feldern Schlüssel und Absender-ID.

      Cloud Messaging API aktivieren

      Wenn kein Schlüssel aufgeführt ist, klicken Sie auf die Auslassungspunkte unter Aktionen, um einen Schlüssel hinzuzufügen.

      Aktionen

    2. Nach der Migration wird die Legacy-API von Google eingestellt. Sie müssen die Firebase Cloud Messaging API (V1) aktivieren. Weitere Informationen finden Sie unter Von älteren FCM-APIs zu HTTP v1 migrieren.

      FCI aktivieren

      Laden Sie die JSON-Datei des Dienstkontos unter Dienstkonten in den Projekteinstellungen herunter. Im Abschnitt Anmeldeinformationen manuell bereitstellen erfahren Sie, wie Sie eine private Schlüsseldatei für Ihr Dienstkonto generieren. Klicken Sie auf Neuen privaten Schlüssel generieren, um die JSON-Datei des Dienstkontoschlüssels herunterzuladen.

      Projekteinstellungen

Schritte zum Einrichten einer FCM-Client-App unter Android finden Sie in diesem Google Developers Cloud Messaging-Artikel: https://firebase.google.com/docs/cloud-messaging/android/client.

So konfigurieren Sie XenMobile für FCM

Gehen Sie in der XenMobile-Konsole zu Einstellungen > Firebase Cloud Messaging.

Für Cloud Messaging API (Legacy)

  1. Geben Sie den Firebase Cloud Messaging Schlüssel aus dem letzten Schritt der Firebase Cloud Messaging-Konfiguration in das Feld API-Schlüssel ein.

  2. Geben Sie den Wert der Absender-ID aus dem vorherigen Verfahren ein.

Die Eingabe des Absender-ID-Werts

Für Firebase Cloud Messaging API (V1)

Hinweise:

  • Um die FCM API V1 für XenMobile Server Version 10.15 Rolling Patch 7 und höher zu aktivieren, lesen Sie den Knowledge Center-Artikel CTX677031.
  • Wenn Sie ein neuer FCM-Benutzer sind, überspringen Sie Schritt 1 und fahren Sie mit Schritt 2 fort.
  1. Wenn Sie bereits FCM verwenden, werden Sie feststellen, dass die Absender-ID automatisch mit Ihrem aktuellen FCM-Projekt ausgefüllt wird und eine neue Option zum Hochladen der Dienstkontoschlüsseldatei verfügbar ist.

    FCM für aktuelle Benutzer

  2. Wenn Sie ein neuer FCM-Benutzer sind, geben Sie die Absender-ID ein und laden Sie die Dienstkontoschlüsseldatei aus dem vorherigen Verfahren hoch.

    Neuer FCM-Benutzer

  3. Die hochgeladene Datei wird analysiert und die entsprechenden Felder werden automatisch generiert.

    Analysiertes Dienstkonto

  4. Überprüfen Sie die Informationen und klicken Sie auf Speichern.

So testen Sie Ihre Konfiguration

  1. Registrieren Sie ein Android-Gerät.

  2. Lassen Sie das Gerät eine Weile im Leerlauf, damit es die Verbindung zu XenMobile trennt.

  3. Melden Sie sich bei der XenMobile-Konsole an, klicken Sie auf Verwalten, wählen Sie das Android-Gerät aus und klicken Sie dann auf Sichern.

    Die Option "Android-Gerät sichern"

  4. Klicken Sie unter Geräteaktionen auf Selektives Löschen.

    Die Option "Selektives Löschen"

    Bei einer erfolgreichen Konfiguration erfolgt ein selektives Löschen auf dem Gerät.

Firebase Cloud Messaging