Konfigurieren von FCM für Android

Über Firebase Cloud Messaging (FCM) wird die Kommunikation zwischen dem Smart-Device-Server von Avalanche und Ihren Android-Geräten hergestellt. Um die FCM-Unterstützung auf dem Smart-Device-Server zu aktivieren, müssen Sie von Google Anmeldeinformationen anfordern, um Ihren Server zu authentifizieren. Der Prozess besteht aus folgenden Schritten: Erstellen eines Firebase-Projekts, Hinzufügen einer Avalanche-App zu Ihrem Projekt, Anfordern von FCM-Anmeldeinformationen und Eingabe der FCM-Anmeldeinformationen in Avalanche. Um diesen Vorgang durchzuführen, benötigen Sie ein Google-Konto.

Avalanche verfügt momentan über zwei Apps, die über FCM kommunizieren können: den standardmäßigen Avalanche Enabler und den Android Enterprise Enabler. Beide Apps können in einem Firebase-Projekt unterstützt werden.

Falls Sie früher GCM zusammen mit Avalanche verwendet haben und jetzt zu FCM migrieren möchten, lesen Sie die Google Migrationsanleitung.

FCM funktioniert mit Enablern ab Version 6.3.

FCM-Ports

Für FCM müssen die folgenden Netzwerkports geöffnet sein: 5228, 5229 und 5230. Wir empfehlen, diese Ports ohne IP-Einschränkungen auf eine Positivliste zu setzen. Falls Ihr Unternehmen bestimmte Verbindungen einschränken muss, lesen Sie den Firebase-Artikel FCM-Ports und Firewall.

Einrichten von FCM

So erstellen Sie ein Firebase-Projekt für Avalanche:

1.Wechseln Sie in einem Webbrowser zu https://console.firebase.google.com.

2.Klicken Sie auf Projekt hinzufügen.

3.Geben Sie als Projektname AvalancheFCM ein.

4.(Optional) Richten Sie Google Analytics für Ihr Projekt ein.

5.Klicken Sie auf Projekt erstellen.

So fügen Sie Ihrem Firebase-Projekt eine Avalanche-App hinzu:

1.Wechseln Sie in Ihrem Firebase-Projekt "AvalancheFCM" zu Projekteinstellungen.

2.Wählen Sie auf der Registerkarte "Allgemein" die Option zum Hinzufügen einer Android-App zu Ihre Apps aus.

3.Falls Sie den standardmäßigen Avalanche Enabler verwenden, geben Sie als Paketname com.wavelink.android ein.
-ODER-
Falls Sie den Android Enterprise Enabler verwenden, geben Sie als Paketname com.ivanti.enterprise ein.

4.Klicken Sie auf App registrieren.

5.Laden Sie die Datei "google-services.json" herunter und klicken Sie auf Weiter.

6.Klicken Sie auf Zur Konsole wechseln.

So fordern Sie FCM-Anmeldeinformationen an:

1.Wechseln Sie in Ihrem Firebase-Projekt "AvalancheFCM" zu Projekteinstellungen.

2.Klicken Sie auf der Registerkarte"Dienstkonten" auf Neuen privaten Schlüssel generieren.

3.Klicken Sie auf Schlüssel generieren.
Der private Schlüssel des Dienstkontos wird heruntergeladen.

So stellen Sie FCM-Anmeldeinformationen Avalanche zur Verfügung:

1.Navigieren Sie in der Avalanche-Konsole zur Registerkarte "Profile".

2.Klicken Sie auf den Namen des Smart-Device-Server-Profils, das Sie bearbeiten möchten.

3.Klicken Sie auf Bearbeiten.

4.Klicken Sie im Bereich "Google Firebase Cloud Messaging" neben der Google-Services-Datei auf Hinzufügen.

5.Öffnen Sie die Datei google-services.json, die Sie beim Hinzufügen der Avalanche-App zu Ihrem Firebase-Projekt heruntergeladen haben.

6.Klicken Sie neben "Dienstkontodatei" auf Hinzufügen.

7.Öffnen Sie die JSON-Datei mit dem privaten Schlüssel für Ihre Dienstkonten.

8.Klicken Sie oben im Profil auf Speichern.

9.Führen Sie eine Bereitstellung aus.

Ihre Android-Geräte können jetzt über die Google Cloud-Dienste mit Avalanche kommunizieren. Damit Smart-Geräte verbunden werden können, benötigen Sie außerdem ein SSL-Zertifikat für den Smart-Device-Server. Weitere Informationen zu Zertifikaten finden Sie unter Erhalten von SSL-Zertifikaten.

Falls das Smart-Device-Server-Protokoll Fehler vom Typ 403 ausgibt, müssen Sie möglicherweise die Firebase Cloud Messaging-API unter https://console.developers.google.com/apis/library/fcm.googleapis.com aktivieren.