Qu'est-ce qu'Event Notifications ?

Event Notifications est un service de routage des notifications d'événements qui vous informe des événements critiques survenant dans votre compte IBM Cloud ou qui déclenche des actions automatisées à l'aide de webhooks. Vous pouvez filtrer et acheminer les notifications d'événements provenant des services d' IBM Cloud, tels que Availability Monitoring, vers des e-mails, des SMS, des notifications push et des webhooks.

Comment les clients utilisent-ils les notifications push Firefox Web ?

Le diagramme suivant montre comment les clients utilisent les notifications push Firefox Web.

Objectifs

Ce tutoriel explique comment envoyer des notifications push comme suit :

• Créez un site Web avec Event Notifications.
• Obtenez les données d'identification Firefox Web.
• Téléchargez le SDK et effectuez la configuration des notifications.
• Configurez et envoyez des notifications push Firefox Web à un navigateur.

Création d'une instance de service Event Notifications

• Connectez-vous à votre compte IBM Cloud.
• Dans le catalogue IBM Cloud, recherchez Event Notifications > Event Notifications.
• Sélectionnez une région dans la liste des régions prises en charge, puis choisissez une formule tarifaire.
• Fournissez un nom de service.
• Sélectionnez un Groupe de ressources.
• Acceptez les contrats de licence et les dispositions en cochant la case.
• Cliquez sur Créer.

Ajouter une source d'API générique

Pour créer une source API générique :

• Cliquez sur Sources dans l'instance d' Event Notifications.
• Cliquez sur Créer et sélectionnez une source API dans la boîte de dialogue Créer une source.
• Saisissez un nom et, si vous le souhaitez, une description, puis cliquez sur Créer une source.

Créer une destination Event Notifications

Cliquez sur Destinations dans l'instance d' Event Notifications, puis cliquez sur Créer.

Saisissez les informations suivantes concernant la destination dans la boîte de dialogue Créer une destination.

• Nom: ajoutez un nom pour la destination.
• Description: ajoutez une description facultative pour la destination.
• Type: sélectionnez le type de notifications push Firefox dans la liste déroulante.
• Sélectionnez un plan de destination: Destination de préproduction ou Destination de production.
  • Destination de pré-production: sélectionnez cette destination comme destination de déploiement à faible coût pour vos environnements de développement et de test.
  • Destination de production: exploitez pleinement les capacités de cette destination. Nombre illimité d'appareils et de messages sortants autorisés.
• Indiquez l'URL de votre site Web.
• Cliquez sur Créer une destination.
• Une fois la destination Firefox créée, modifiez-la pour obtenir la clé publique vapID requise pour le SDK Web.

Créer une Event Notifications rubrique

Cliquez sur Topics dans l'instance d' Event Notifications, puis cliquez sur Create. Saisissez le sujet et les détails de filtrage suivants dans les étapes Détails du sujet et Filtres d'événements:

• Nom: saisissez un nom pour la rubrique.
• Description: ajoutez une description facultative pour le sujet.
• Source: sélectionnez une source dans la liste déroulante.
• Type d'événement: sélectionnez le type d'événement dans la liste déroulante.
• Sous-type d'événement: sélectionnez le sous-type d'événement dans la liste déroulante des sous-types d'événements.
• Gravité: sélectionnez le niveau de gravité dans la liste déroulante correspondante.
• Conditions avancées: rédigez vos propres conditions personnalisées, qui doivent respecter les spécifications jsonpath. Les expressions Jsonpath peuvent être validées à jsonpath.com ou extendsclass.com.

Créer un Event Notifications abonnement

Passez à l'étape Abonnements. Cliquez sur Créer, puis saisissez les informations d'abonnement suivantes dans la boîte de dialogue Créer un abonnement.

• Nom de l'abonnement: saisissez un nom pour l'abonnement.
• Type de destination: sélectionnez le type de destination.
• Destination: sélectionnez une destination.

Cliquez sur Créer un abonnement.

Configurer le SDK Firefox Web Event Notifications

Le SDK Firefox Web permet aux sites Web Firefox de recevoir des notifications push. Procédez comme suit pour installer le SDK Firefox Web Event Notifications, initialiser le SDK et sélectionner l'envoi de notifications pour votre site Web.

• Pour inclure le SDK dans votre projet, ajoutez les fichiers ENPushSDK.js,ENPushServiceWorker.js et manifest_Website.json à votre dossier racine de projet.

• Modifiez le fichier manifest_Website.json.

  {
     "name": "YOUR_WEBSITE_NAME"
  }
  

• Changez le nom de fichier manifest_Website.json en manifest.json.

• Insérez-le dans manifest.json la balise <head> de votre fichier HTML.

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

• Intégrez le SDK Web Push d' IBM Cloud au script.

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

• Suivez les étapes suivantes pour permettre au site web d'initialiser le SDK.

  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: Région de l'instance d' Event Notifications. Par exemple, us-south, eu-gb, au-syd, eu-de, ou eu-es.

  • deviceId: facultatif deviceId pour l'enregistrement d'appareil.

• Pour vous inscrire aux notifications, utilisez l'API registerWithUserId() ou register() afin d'enregistrer l'appareil auprès du service IBM Cloud Event Notifications. Sélectionnez l'une des options suivantes :

  • S'enregistrer sans UserId :

     enPush.register(function(response) {
        alert(response.response)
     })
     ```
  * Inscrivez-vous sur `UserId`. Pour les notifications `userId` basées sur, la méthode register accepte un paramètre supplémentaire : `userId`.
  
  ```js {: codeblock}
     bmsPush.registerWithUserId("UserId",function(response) {
        alert(response.response)
     })
     ```
     `UserId` est la valeur de l'identificateur utilisateur avec lequel vous souhaitez enregistrer les périphériques dans l'instance de service push.
  
  

• L'API subscribe abonne le périphérique à une balise. Une fois que le périphérique est abonné à une balise particulière, il peut recevoir des notifications envoyées pour cette balise. Ajoutez le fragment de code suivant à votre application Web pour vous abonner à une liste de balises.

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

• Une fois la configuration terminée, exécutez votre application et enregistrez pour les notifications push.

Envoyer des notifications au périphérique Firefox

Utilisez l'API d'envoi de notifications pour envoyer la notification push pour le périphérique Firefox. Vous pouvez utiliser le SDK d'administration Nœud ou Go au lieu d'appeler directement l'API.