Dans le sous-onglet Webhooks (Liens de rappel HTTP) 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 Send to Webhook (Envoyer au lien de rappel HTTP). 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 Inbox (Boîte de réception) 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 à Settings (Paramètres) > Webhook (Lien de rappel HTTP).
3. Cliquez sur le bouton New Webhook (Nouveau lien de rappel HTTP) situé dans le coin supérieur droit de la page pour ouvrir la fenêtre contextuelle Add Webhook Setting (Ajouter un paramètre de lien de rappel HTTP).
4. Dans la fenêtre contextuelle Add Webhook Setting (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. Name (Nom) : 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. Authorization (Autorisation) : Cliquez sur le menu déroulant pour sélectionner l’un des protocoles suivants : No Auth (Aucune autorisation), API Key (Clé API), Bearer Token (Jeton du porteur) ou Basic Auth (Autorisation de base).
   4. Available data (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 Addresses (Adresses) envoie toutes les adresses courriel de la charge utile du lien de rappel HTTP, y compris les adresses courriel des champs From (De), To (À), CC, Reply To (Répondre à) et Reported By (Signalé par).
   5. Custom Data (Données personnalisées) : 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 key (clé) et value (valeur). Par exemple, si votre application requiert "{ "System" : "PhishER" }" dans la charge utile pour recevoir des données, vous pourriez entrer "System" et "PhishER".
   6. Custom Headers (En-têtes personnalisés) : Si vous souhaitez ajouter un en-tête personnalisé, cliquez sur l’icône +. Puis, remplissez les valeurs des champs key (clé) et value (valeur). 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. Message Tags (Étiquettes de message) : Cette section vous permet de cocher les cases Success (Succès) ou Failure (Échec) 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 Create (Créer).

Gérer vos liens de rappel HTTP

À partir du sous-onglet Webhook (Lien de rappel HTTP) 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 Update Webhook Settings (Mettre à jour les paramètres du lien de rappel HTTP). Puis, vous pouvez mettre à jour les informations du lien de rappel HTTP.

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

1. New Webhook (Nouveau lien de rappel HTTP) : 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. Name (Nom) : Cette colonne affiche le nom du lien de rappel HTTP.
3. URL : Cette colonne affiche l’URL du lien de rappel HTTP.
4. Selected Data (Données sélectionnées) : Cette colonne affiche les types de données que vous souhaitez envoyer au lien de rappel HTTP.
5. Success Tag (Étiquette de succès) : 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. Failure Tag (Étiquette d’échec) : 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.