View a markdown version of this page

Einrichtung der Amazon SNS-Integration mit Firebase Cloud Messaging-Authentifizierung - Amazon Simple Notification Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einrichtung der Amazon SNS-Integration mit Firebase Cloud Messaging-Authentifizierung

In diesem Thema wird beschrieben, wie Sie die erforderlichen FCM-API-Anmeldeinformationen (HTTP v1) von Google zur Verwendung mit der AWS API abrufen, AWS CLI und die. AWS-Managementkonsole

Wichtig

26. März 2024 — Amazon SNS unterstützt die FCM-HTTP-v1-API für Apple-Geräte und Webpush-Ziele. Wir empfehlen, dass Sie Ihre vorhandenen mobilen Push-Anwendungen am oder vor dem 1. Juni 2024 auf die neueste FCM-HTTP-v1-API migrieren, um Anwendungsunterbrechungen zu vermeiden.

18. Januar 2024 — Amazon SNS hat die Unterstützung für die FCM-HTTP-v1-API für die Übermittlung mobiler Push-Benachrichtigungen an Android-Geräte eingeführt.

20. Juni 2023 — Google hat seine alte HTTP-API für Firebase Cloud Messaging (FCM) als veraltet eingestuft. Amazon SNS unterstützt jetzt die Bereitstellung an alle Gerätetypen mithilfe der FCM-HTTP-v1-API. Wir empfehlen, dass Sie Ihre vorhandenen mobilen Push-Anwendungen am oder vor dem 1. Juni 2024 auf die neueste FCM-HTTP-v1-API migrieren, um Unterbrechungen zu vermeiden.

Sie können Amazon SNS ermächtigen, Push-Benachrichtigungen an Ihre Anwendungen zu senden, indem Sie Informationen bereitstellen, die Sie als Entwickler der App identifizieren. Geben Sie zur Authentifizierung entweder einen API-Schlüssel oder ein Token an, wenn Sie eine Plattformanwendung erstellen. Sie können die folgenden Informationen von Ihrer Firebase-Anwendungskonsole abrufen:

API-Schlüssel

Der API-Schlüssel ist eine Anmeldeinformation, die beim Aufrufen der Legacy-API von Firebase verwendet wird. Die FCM-Legacy-APIs werden am 20. Juni 2024 von Google entfernt. Wenn Sie derzeit einen API-Schlüssel als Plattformanmeldeinformation verwenden, können Sie die Plattformanmeldeinformation aktualisieren, indem Sie Token als Option auswählen und die zugehörige JSON-Datei für Ihre Firebase-Anwendung hochladen.

Token

Beim Aufrufen der HTTP v1-API wird ein kurzlebiges Zugriffstoken verwendet. Dies ist die von Firebase vorgeschlagene API zum Senden von Push-Benachrichtigungen. Um Zugriffstoken zu generieren, stellt Firebase Entwicklern eine Reihe von Anmeldeinformationen in Form einer privaten Schlüsseldatei (auch als service.json-Datei bezeichnet) zur Verfügung.

Voraussetzung

Sie benötigen Ihre FCM-service.json-Anmeldeinformationen, bevor Sie mit der Verwaltung von FCM-Einstellungen in Amazon SNS beginnen können. Informationen zum Abrufen Ihrer service.json-Anmeldeinformationen finden Sie unter Migrieren Sie von älteren FCM-APIs auf HTTP v1 in der Google-Firebase-Dokumentation.

Verwaltung der FCM-Einstellungen mit der CLI

Sie können FCM-Push-Benachrichtigungen mithilfe der AWS API erstellen. Die Anzahl und Größe der Amazon SNS-Ressourcen in einem AWS Konto sind begrenzt. Weitere Informationen finden Sie im Handbuch unter Endpunkte und Kontingente für Amazon Simple Notification Service. Allgemeine AWS-Referenz

Um eine FCM-Push-Benachrichtigung zusammen mit einem Amazon SNS-Thema zu erstellen (AWS API)

Bei Verwendung von Schlüssel-Anmeldeinformationen lautet PlatformCredential API key. Bei Verwendung von Token-Anmeldeinformationen ist PlatformCredential eine private Schlüsseldatei im JSON-Format:

Um einen FCM-Anmeldeinformationstyp für ein vorhandenes Amazon SNS-Thema abzurufen (AWS API)

Ruft den Anmeldeinformationstyp "AuthenticationMethod": "Token" oder "AuthenticationMethod": "Key" ab:

Um ein FCM-Attribut für ein vorhandenes Amazon SNS-Thema festzulegen (AWS API)

Legt das FCM-Attribut fest:

Verwaltung der FCM-Einstellungen mithilfe der Konsole

Sie können FCM-Push-Benachrichtigungen mit der AWS Command Line Interface (CLI) erstellen. Die Anzahl und Größe der Amazon SNS-Ressourcen in einem AWS Konto sind begrenzt. Weitere Informationen finden Sie unter Amazon Simple Notification Service-Endpunkte und -Kontingente.

Um eine FCM-Push-Benachrichtigung zusammen mit einem Amazon SNS-Thema zu erstellen (AWS CLI)

Bei Verwendung von Schlüssel-Anmeldeinformationen lautet PlatformCredential API key. Bei Verwendung von Token-Anmeldeinformationen ist PlatformCredential eine private Schlüsseldatei im JSON-Format. Wenn Sie die AWS CLI verwenden, muss die Datei im Zeichenkettenformat vorliegen und Sonderzeichen müssen ignoriert werden. Um die Datei korrekt zu formatieren, empfiehlt Amazon SNS die Verwendung des folgenden Befehls: SERVICE_JSON=`jq @json <<< cat service.json`

Um einen FCM-Anmeldeinformationstyp für ein vorhandenes Amazon SNS-Thema abzurufen (AWS CLI)

Ruft den Anmeldeinformationstyp "AuthenticationMethod": "Token" oder "AuthenticationMethod": "Key" ab:

Um ein FCM-Attribut für ein vorhandenes Amazon SNS-Thema festzulegen (AWS CLI)

Legt das FCM-Attribut fest:

Verwalten von FCM-Einstellungen (Konsole)

Gehen Sie wie folgt vor, um Ihre Firebase Cloud Messaging (FCM) -Anmeldeinformationen in Amazon SNS einzugeben und zu verwalten.

  1. Melden Sie sich bei der Amazon-SNS-Konsole an.

  2. Wählen Sie im Navigationsbereich Push-Benachrichtigungen aus.

  3. Wählen Sie im Abschnitt Plattformanwendungen die FCM-Plattformanwendung aus, deren Anmeldeinformationen Sie bearbeiten möchten, und klicken Sie dann auf Bearbeiten.

  4. Wählen Sie im Abschnitt Firebase Cloud Messaging-Anmeldeinformationen eine der folgenden Optionen aus:

    • Token-based Authentifizierung (empfohlene Methode) — Laden Sie die private Schlüsseldatei (JSON) hoch, die Sie von der Firebase-Konsole heruntergeladen haben. Diese Datei enthält die Anmeldeinformationen, die zum Generieren kurzlebiger Zugriffstoken für FCM-Benachrichtigungen erforderlich sind. Um diese Datei zu erhalten:

      1. Gehen Sie zu Ihrer Firebase-Anwendungskonsole.

      2. Wählen Sie in den Projekteinstellungen Cloud Messaging aus.

      3. Laden Sie die JSON-Datei mit dem privaten Schlüssel herunter (zur Verwendung in der tokenbasierten Authentifizierungsmethode).

    • API-Schlüsselauthentifizierung — Wenn Sie die ältere API-Schlüssel-Authentifizierungsmethode bevorzugen, geben Sie den Google-API-Schlüssel in das dafür vorgesehene Feld ein. Um diese Datei zu erhalten:

      1. Gehen Sie zu Ihrer Firebase-Anwendungskonsole.

      2. Wählen Sie in den Projekteinstellungen Cloud Messaging aus.

      3. Kopieren Sie den Serverschlüssel (API-Schlüssel), um ihn zum Senden von Benachrichtigungen zu verwenden.

  5. Wenn Sie die gewünschten Änderungen vorgenommen haben, wählen Sie Save changes (Änderungen speichern) aus.

Verwandte Themen