Citrix Endpoint Management™

Firebase Cloud Messaging

Hinweis:

Firebase Cloud Messaging (FCM) war früher als Google Cloud Messaging (GCM) bekannt. Einige Bezeichnungen und Meldungen in der Citrix Endpoint Management-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 Citrix Endpoint Management herstellen. Citrix Endpoint Management sendet, wenn für FCM konfiguriert, 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 Citrix Endpoint Management-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 in Citrix Endpoint Management. Diese Verbindung ermöglicht eine nahezu Echtzeit-Kommunikation von Ihrem Citrix Endpoint Management-Dienst zu Ihrem Gerät über FCM. Die FCM-Registrierung funktioniert für neue Geräteregistrierungen und bereits registrierte Geräte.

  • Wenn Citrix Endpoint Management eine Verbindung zum Gerät herstellen muss, verbindet es sich mit dem FCM-Dienst. Anschließend benachrichtigt der FCM-Dienst das Gerät, sich zu verbinden. Diese Art der Verbindung ähnelt der, die Apple für seinen Push Notification Service verwendet.

  • Voraussetzungen

  • Neuester Citrix 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 Citrix Endpoint Management 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 zu einer Positivliste hinzuzufügen. Wenn Sie jedoch IP-Einschränkungen benötigen, empfiehlt FCM, alle IP-Adressen in den IPv4- und IPv6-Blöcken zu einer Positivliste hinzuzufügen. Diese Blöcke sind im Google ASN 15169 aufgeführt. Aktualisieren Sie diese Liste monatlich.

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 den Anmeldeinformationen Ihres Google-Entwicklerkontos bei 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 Migrieren von älteren FCM-APIs zu HTTP v1.

  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 Migrieren von älteren FCM-APIs zu HTTP v1.

      FCM 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 auf Android finden Sie in diesem Google Developers Cloud Messaging-Artikel: https://firebase.google.com/docs/cloud-messaging/android/client.

So konfigurieren Sie Citrix Endpoint Management für FCM

Navigieren Sie in der Citrix Endpoint Management-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 Citrix Endpoint Management Version 24.6.0 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 bestehende 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 Zeit lang im Leerlauf, damit es die Verbindung zu Citrix Endpoint Management trennt.

  3. Klicken Sie in der Citrix Endpoint Management-Konsole 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