Dans le sous-onglet Lien de rappel HTTP (Webhooks) de vos paramètres PhishER, vous pouvez créer des liens de rappel HTTP permettant de connecter votre plateforme PhishER à d’autres plateformes que vous utilisez. Un lien de rappel HTTP, aussi appelé une API poussée HTTP, permet à une application de fournir des informations en temps réel à une autre application. Lorsque des messages sont déclenché par des actions PhishER spécifiques, les liens de rappel HTTP vous permettent d’envoyer des données des messages vers une autre application.

Après avoir intégré des liens de rappel HTTP dans votre plateforme PhishER, vous pouvez créer une action PhishER et sélectionner l’option Envoyer vers un lien de rappel HTTP (Send to Webhook). Cette option permet à PhishER d’envoyer les messages signalés qui sont affectés par cette action au lien de rappel HTTP de votre organisation. Une fois cette action déclenchée, vous pouvez cliquer sur un message associé dans votre Boîte de réception (Inbox) PhishER et voir le lien de rappel HTTP auquel le message est envoyé.

Créer un nouveau lien de rappel HTTP

Pour connecter un nouveau lien de rappel HTTP à votre plateforme PhishER, suivez les étapes ci-dessous :

1. Connectez-vous à votre plateforme PhishER.
2. Accédez à Paramètres (Settings) > Lien de rappel HTTP (Webhook).
3. Cliquez sur le bouton Nouveau lien de rappel HTTP (New Webhook) situé dans le coin supérieur droit de la page pour ouvrir la fenêtre contextuelle Ajouter un paramètre de lien de rappel HTTP (Add Webhook Setting).
4. Dans la fenêtre contextuelle Ajouter un paramètre de lien de rappel HTTP qui s’ouvre, configurez les paramètres de votre lien de rappel HTTP. Pour en apprendre davantage au sujet de ces paramètres, consultez la capture d’écran et la liste ci-dessous.
   1. Nom (Name) : Dans ce champ, entrez un nom personnalisé pour votre lien de rappel HTTP.
   2. URL : Dans ce champ, entrez l’URL vers laquelle vous essayez de faire un rappel. Pour une liste des modules de réécriture d’URL et raccourcisseurs d’URL compatibles avec PhishER, consultez notre article FAQ PhishER.
   3. Autorisation (Authorization) : Cliquez sur le menu déroulant pour sélectionner l’un des protocoles suivants : Aucune authentification (No Auth), Clé API (API Key), Jeton du porteur (Bearer Token) ou Authentification de base (Basic Auth).
   4. Données disponibles : Sélectionnez au moins un type de données que vous souhaitez envoyer au lien de rappel HTTP.
      Remarque :Le type de données Adresses (Addresses) envoie toutes les adresses courriel de la charge utile du lien de rappel HTTP, y compris les adresses courriel des champs De (From), À (To), CC, Répondre à (Reply To) et Signalé par (Reported By).
   5. Données personnalisées (Custom Data) : Pour ajouter des données personnalisées à la charge utile de votre lien de rappel HTTP, cliquez sur l’icône +. Puis, remplissez les valeurs des champs clé (key) et valeur (value). Par exemple, si votre application requiert "{ "System" : "PhishER" }" dans la charge utile pour recevoir des données, vous pourriez entrer "System" et "PhishER".
   6. En-têtes personnalisés (Custom Headers) : Si vous souhaitez ajouter un en-tête personnalisé, cliquez sur l’icône +. Puis, remplissez les valeurs des champs clé (key) et valeur (value). Par exemple, si votre pare-feu requiert l’en-tête "{ "Header" : "PhishER" }" pour permettre le passage des données, vous pourriez entrer "Header" et "PhishER".
   7. Étiquettes de message (Message Tags) : Cette section vous permet de cocher les cases Succès (Success) ou Échec (Failure) si vous souhaitez que PhishER assigne une étiquette lorsque le lien de rappel HTTP est utilisé pour envoyer les données. Puis, entrez le nom d’une étiquette dans le champ à côté de la case sélectionnée. 
   
5. Cliquez sur Créer (Create).

Gérer vos liens de rappel HTTP

À partir du sous-onglet Lien de rappel HTTP (Webhook) de vos paramètres PhishER, vous pouvez connecter et gérer vos liens de rappel HTTP. Pour mettre à jour un lien de rappel HTTP, vous pouvez cliquer sur le nom du lien pour ouvrir la fenêtre contextuelle Mettre à jour les paramètres du lien de rappel HTTP (Update Webhook Settings). Puis, vous pouvez mettre à jour les informations du lien de rappel HTTP.

Pour plus d’informations sur le sous-onglet Lien de rappel HTTP, consultez la capture d’écran et la liste ci-dessous.

1. Nouveau lien de rappel HTTP (New Webhook) : Vous pouvez cliquer sur ce bouton pour ajouter un nouveau lien de rappel HTTP. Pour plus d’informations au sujet de l’ajout d’un nouveau lien de rappel HTTP, consultez les sous-sections précédentes du présent article.
2. Nom (Name) : Cette colonne affiche le nom du lien de rappel HTTP.
3. URL : Cette colonne affiche l’URL du lien de rappel HTTP.
4. Données sélectionnées (Selected Data) : Cette colonne affiche les types de données que vous souhaitez envoyer au lien de rappel HTTP.
5. Étiquette de succès (Success Tag) : Cette colonne affiche l’étiquette que PhishER assigne à un message si le lien de rappel HTTP a envoyé avec succès des données et reçu une URL de rappel.
6. Étiquette d’échec (Failure Tag) : Cette colonne affiche l’étiquette que PhishER assigne à un message si le lien de rappel HTTP n’a pas pu envoyer les données et recevoir une URL de rappel.
7. Actions : Cette colonne affiche les actions qui peuvent être exécutées sur une entrée de lien de rappel HTTP. Vous pouvez cliquer sur l’icône de la poubelle pour supprimer l’entrée.