Apple wird das HTTP/1-basierte Binärprotokoll auf dem Apple Push Notification-Dienst nach dem 31. März 2021 nicht mehr unterstützen. Wir empfehlen Ihnen, Ihren XSP|ADP so zu konfigurieren, dass er die HTTP/2-based Schnittstelle für APNs. Dieses Update erfordert, dass auf Ihrem XSP|ADP, auf dem der NPS gehostet wird, R22 oder höher ausgeführt wird.

Dieser Abschnitt enthält optionale Verfahren, die Sie in der Google FCM-Konsole verwenden können, wenn Sie über eine bestehende NPS-Bereitstellung verfügen, die Sie zu FCMv1 migrieren müssen. Es gibt drei Verfahren:

• UC-One-Clients zu FCMv1 migrieren– Wenn Sie vorhandene UCaaS-Clients haben und diese zur Verwendung von FCMv1 migrieren müssen.

• SaaS-Clients zu FCMv1 migrieren– Wenn Sie vorhandene SaaS-Clients haben und diese zur Verwendung von FCMv1 migrieren müssen.

• ADP-Server aktualisieren– Wenn Sie den NPS auf einen ADP-Server migrieren.

Migrieren Sie UC-One-Clients zu FCMv1

Verwenden Sie die folgenden Schritte in der Google FCM-Konsole, um UC-One-Clients zu Google FCM HTTPv1 zu migrieren.

1. Melden Sie sich beim FCM Admin SDK unter http://console.firebase.google.coman.

2. Wählen Sie die entsprechende Android-Anwendung aus.

3. Zeichnen Sie auf der Registerkarte Allgemein die Projekt-ID auf.

4. Navigieren Sie zur Registerkarte Dienstkonten, um ein Dienstkonto zu konfigurieren. Sie können ein neues Dienstkonto erstellen oder ein vorhandenes konfigurieren.

   So erstellen Sie einen neuen Service-Account:

   1. Klicken Sie zum Erstellen eines neuen Dienstkontos auf die blaue Schaltfläche

   2. Klicken Sie auf die blaue Schaltfläche, um einen neuen privaten Schlüssel zu generieren

   3. Schlüssel an einen sicheren Speicherort herunterladen

   So verwenden Sie ein vorhandenes Service-Konto erneut:

   1. Klicken Sie auf den blauen Text, um vorhandene Dienstkonten anzeigen zu können.

   2. Geben Sie das zu verwendende Dienstkonto an. Dienstkonto benötigt Berechtigung firebaseadmin-sdk.

   3. Klicken Sie ganz rechts auf das Hamburgermenü, und erstellen Sie einen neuen privaten Schlüssel.

   4. Laden Sie die json-Datei herunter, die den Schlüssel enthält, und speichern Sie sie an einem sicheren Speicherort.

5. Kopieren Sie die JSON-Datei auf den XSP|ADP.

6. Konfigurieren Sie die Projekt-ID und :

   XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  

7. Konfigurieren Sie die Anwendung:

   XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
   ...Done
   
   XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
     Application ID    Project ID
   ==============================
             my_app    my_project

8. FCMv1 aktivieren:

   XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
   ...Done

9. Führen Sie den Befehl bwrestart aus, um den XSP|ADP neu zu starten.

SaaS-Clients zu FCMv1 migrieren

Verwenden Sie die folgenden Schritte auf der Google FCM-Konsole, wenn Sie SaaS-Clients zu FCMv1 migrieren möchten.

1. FCM deaktivieren:

   XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
   ...Done

2. Führen Sie den Befehl bwrestart aus, um den XSP|ADP neu zu starten.

3. FCM aktivieren:

   XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
   ...Done

4. Führen Sie den Befehl bwrestart aus, um den XSP|ADP neu zu starten.

ADP-Server aktualisieren

Verwenden Sie die folgenden Schritte in der Google FCM-Konsole, wenn Sie den NPS zur Verwendung eines ADP-Servers migrieren.

1. Holen Sie sich die JSON-Datei von der Google Cloud-Konsole:

   1. Gehen Sie in der Google Cloud-Konsole zur Seite Dienstkonten.

   2. Klicken Sie auf Projekt auswählen , wählen Sie Ihr Projekt aus und klicken Sie auf Öffnen .

   3. Suchen Sie die Zeile des Dienstkontos, für das Sie einen Schlüssel erstellen möchten, klicken Sie auf die vertikale Schaltfläche Mehr und dann auf Schlüssel erstellen.

   4. Wählen Sie einen Schlüssel Typ und klicken Sie auf Erstellen

      Die Datei wird heruntergeladen.

2. FCM zum ADP-Server hinzufügen:

   1. Importieren Sie die JSON-Datei mit dem Befehl /bw/install auf den ADP-Server.

   2. Melden Sie sich bei der ADP-CLI an und fügen Sie die Projekt- und API-Schlüssel hinzu:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

   3. Fügen Sie als Nächstes die Anwendung und den Schlüssel hinzu:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

   4. Überprüfen Sie die Konfiguration:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
      Project ID Accountkey
      ========================
      connect-ucaas ********
      
      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
      Application ID Project ID
      ===================================
      com.broadsoft.ucaas.connect connect-ucaas