Was ist Event Notifications?

Event Notifications ist ein Dienst zur Weiterleitung von Ereignisbenachrichtigungen, der Sie über kritische Ereignisse in Ihrem IBM Cloud-Konto informiert oder mithilfe von Webhooks automatisierte Aktionen auslöst. Sie können Ereignisbenachrichtigungen von IBM Cloud-Diensten wie Availability Monitoring filtern und an E-Mail, SMS, Push-Benachrichtigungen und Webhooks weiterleiten.

Wie verwenden Kunden Firefox-Web-Push-Benachrichtigungen?

Das folgende Diagramm zeigt, wie Kunden Firefox-Web-Push-Benachrichtigungen verwenden.

Ziele

Dieses Lernprogramm zeigt im Folgenden, wie Sie Push-Benachrichtigungen senden:

• Website mit Event Notifications erstellen.
• Firefox-Webberechtigungsnachweise abrufen.
• SDK herunterladen und die Benachrichtigungskonfiguration abschließen.
• Firefox-Web-Push-Benachrichtigungen konfigurieren und an einen Browser senden.

Erstellen Sie eine Event Notifications-Serviceinstanz.

• Melden Sie sich bei Ihrem IBM Cloud-Konto an.
• Suchen Sie im IBM Cloud-Katalog unter Event Notifications > Event Notifications.
• Wählen Sie eine Region aus der Liste der unterstützten Regionen aus und wählen Sie einen Preisplan aus.
• Geben Sie einen Servicenamen an.
• Wählen Sie eine Ressourcengruppe aus.
• Akzeptieren Sie die Lizenzvereinbarungen und Bedingungen, indem Sie auf das Kontrollkästchen klicken.
• Klicken Sie auf Erstellen.

Generische API-Quelle hinzufügen

So erstellen Sie eine generische API-Quelle:

• Klicken Sie in der Event Notifications-Instanz auf Quellen.
• Klicken Sie auf Erstellen und wählen Sie im Dialogfeld Quelle erstellen eine API-Quelle aus.
• Geben Sie einen Namen und optional eine Beschreibung ein und klicken Sie auf Quelle erstellen.

Ein neues Event Notifications-Ziel erstellen

Klicken Sie in der Event Notifications-Instanz auf Destinations und dann auf Create.

Geben Sie im Dialogfeld Ziel erstellen die folgenden Zielangaben ein.

• Name: Geben Sie einen Namen für das Ziel ein.
• Beschreibung: Fügen Sie eine optionale Beschreibung für das Ziel hinzu.
• Typ: Wählen Sie in der Dropdown-Liste den Typ Firefox-Push-Benachrichtigungen aus.
• Wählen Sie einen Zielplan aus: Vorproduktionsziel oder Produktionsziel.
  • Ziel für die Vorproduktionsphase – Wählen Sie dieses Ziel als kostengünstiges Push-Ziel für Ihre Entwicklungs- und Testumgebungen aus.
  • Produktionsziel – nutzen Sie den vollen Funktionsumfang dieses Ziels. Unbegrenzte Anzahl an Geräten und ausgehenden Nachrichten zulässig.
• Geben Sie die URL Ihrer Website an.
• Klicken Sie auf Ziel erstellen.
• Nachdem das Ziel Firefox erstellt wurde, bearbeiten Sie das Ziel, um den für das Web-SDK erforderlichen öffentlichen vapID-Schlüssel abzurufen.

![Ziel](images/en-push-firefox-destination-edit.png "" caption-side="bottom"}"){: caption="

Event Notifications-Thema erstellen

Klicken Sie in der Event Notifications-Instanz auf Themen und anschließend auf Erstellen. Geben Sie in den Schritten Themendetails und Ereignisfilter die folgenden Themen- und Filterdetails ein:

• Name: Geben Sie einen Namen für das Thema ein.
• Beschreibung: Fügen Sie eine optionale Beschreibung zum Thema hinzu.
• Quelle: Wählen Sie eine Quelle aus der Dropdown-Liste aus.
• Ereignistyp: Wählen Sie den Ereignistyp aus der Dropdown-Liste aus.
• Ereignisuntertyp: Wählen Sie den Ereignisuntertyp aus der Dropdown-Liste Ereignisuntertyp aus.
• Schweregrad: Wählen Sie den Schweregrad aus der Dropdown-Liste Schweregrad aus.
• Erweiterte Bedingungen: Erstellen Sie Ihre eigenen benutzerdefinierten Bedingungen, die den JSONPath-Spezifikationen entsprechen müssen. Jsonpath-Ausdrücke können validiert werden unter jsonpath.com oder extendsclass.com.

Event Notifications-Subskription erstellen

Fahren Sie mit dem Schritt Abonnements fort. Klicken Sie auf Erstellen und geben Sie im Dialogfeld Abonnement erstellen die folgenden Abonnementdetails ein.

• Abonnementname: Geben Sie einen Namen für das Abonnement ein.
• Zieltyp: Zieltyp auswählen.
• Ziel: Ziel auswählen.

Klicken Sie auf Abonnement erstellen.

Event Notifications Firefox-Web-SDK einrichten

Das Firefox-Web-SDK ermöglicht Firefox-Websites den Empfang von Push-Benachrichtigungen. Führen Sie die folgenden Schritte aus, um das Event Notifications Firefox-Web-SDK zu installieren, das SDK zu initialisieren und sich für Benachrichtigungen für Ihre Website zu registrieren.

• Fügen Sie die Dateien ENPushSDK.js, ENPushServiceWorker.js und manifest_Website.json Ihrem Projektstammordner hinzu, um das SDK in Ihr Projekt aufzunehmen.

• Bearbeiten Sie die Datei 'manifest_Website.json'.

  {
     "name": "YOUR_WEBSITE_NAME"
  }
  

• Ändern Sie den Namen der Datei manifest_Website.json in manifest.json.

• Fügen Sie das in manifest.json das -Tag <head> Ihrer HTML-Datei ein.

  <link rel="manifest" href="https://github.com/IBM/event-notifications-destination-webpush-sdk/blob/main/manifest_Website.json">
  

• Fügen Sie das Web-Push-SDK von IBM Cloud in das Skript ein.

  <script src="https://github.com/IBM/event-notifications-destination-webpush-sdk/blob/main/ENPushSDK.js" async></script>
  

• Führen Sie die folgenden Schritte aus, damit die Website das SDK initialisieren kann.

  var enPush = new ENPush()
  function callback(response) {
     alert(response.response)
  }
  var initParams = {
     "instanceGUID": "<instance_guid>",
     "apikey": "<instance_apikey>",
     "region": "<region>",
     "deviceId": "<YOUR_DEVICE_ID>",
     "firefoxDestinationId": "<firefox_destination_id>",
     "firefoxApplicationServerKey": "<Firefox_VapId_public_key>"
  }
  enPush.initialize(initParams, callback)
  

  • region: Region der Event Notifications-Instanz. Zum Beispiel: us-south, eu-gb, au-syd, eu-de, oder eu-es.

  • deviceId: Optional deviceId für die Einheitenregistrierung.

• Um Benachrichtigungen zu abonnieren, verwenden Sie die oder register() API registerWithUserId(), um das Gerät beim IBM Cloud-Dienst unter Event Notifications zu registrieren. Wählen Sie eine der folgenden Optionen aus:

  • Ohne UserId registrieren:

     enPush.register(function(response) {
        alert(response.response)
     })
     ```
  * Registrieren Sie sich bei `UserId`. Bei einer auf `userId`-basierten Benachrichtigung akzeptiert die Register-Methode einen weiteren Parameter – `userId`.
  
  ```js {: codeblock}
     bmsPush.registerWithUserId("UserId",function(response) {
        alert(response.response)
     })
     ```
     `UserId` ist die Benutzer-ID, mit der Sie Geräte in der Push-Serviceinstanz registrieren möchten.
  
  

• Die API subscribe subskribiert das Gerät für einen Tag. Nachdem das Gerät einen bestimmten Tag abonniert hat, kann das Gerät Benachrichtigungen empfangen, die für diesen Tag gesendet werden. Fügen Sie das folgende Code-Snippet Ihrer Webanwendung hinzu, um eine Liste von Tags zu subskribieren.

  enPush.subscribe(tagName, function(response) {
     alert(response.response)
  })
  

• Führen Sie nach Abschluss der Konfiguration Ihre Anwendung aus und registrieren Sie sich für Push-Benachrichtigungen.

Benachrichtigungen an das Firefox-Gerät senden

Verwenden Sie die API zum Senden von Benachrichtigungen, um die Push-Benachrichtigung für das Firefox-Gerät zu senden. Sie können das Knoten- oder Go-Administrator-SDK verwenden, anstatt die API direkt aufzurufen.