Afficher les lots de webhooks

Un enregistrement de lot Webhook est créé pour chaque exécution de Webhook.

Avant de commencer

Rôle requis : administrateur

Pourquoi et quand exécuter cette tâche

Afin de réduire le nombre d’appels d’API envoyés aux points de terminaison Webhook, le traitement par lots d’événements est implémenté dans les webhooks. Pour chaque webhook, si plusieurs événements sont déclenchés presque en même temps, tous ces événements sont envoyés dans le cadre de la même demande au point de terminaison webhook.

Procédure

1. Accédez à la Tout > Threat Intelligence Security Center > Administration.
2. Sélectionner Webhooks Configurations > Webhooks.
   La page Webhooks s’affiche.
3. Sélectionnez le webhook.
4. Accédez aux journaux d’erreurs.
5. Affichez les journaux d’erreurs.
   La vue de liste affiche tous les journaux d’erreurs à partir d’un webhook particulier.
6. Accéder à la colonne Lot
7. Cliquez sur n’importe quel ID de lot.
   La page Lot Webhook s’affiche.

   Remarque :

   Tous les lots sont stockés dans la table sn_sec_tisc_webhook_batch.

   Voici l’exemple de format de charge utile reçu par le point de terminaison webhook :

   {
       "batch_id": "06eeb3693b6bca10f6f82a60c5e45a7b",
       "events": [
           {
               "record": "Observable",
               "record_fields": {
                   "is_false_positive": "false",
                   "reputation": "malicious",
                   "sys_updated_on": "2024-07-22T14:31:26.000Z",
                   "type": "url",
                   "sys_updated_by": "admin",
                   "sys_created_on": "2024-07-04T06:45:20.000Z",
                   "id": "url--1e77adb7eb8b06107750fa86cad0cd70",
                   "is_defanged": "false",
                   "sys_created_by": "SecCommon.System",
                   "tags": "Enriched",
                   "taxonomies": "T1: V1",
                   "domain": "urlhaus.abuse.ch",
                   "status": "active",
                   "source_count": "1",
                   "threat_score": "20",
                   "sys_id": "da77adb7eb8b06107750fa86cad0cd70",
                   "value": "https://urlhaus.abuse.ch/url/2578255/",
                   "confidence": "89",
                   "expiration_time": "2025-10-07T07:13:18.000Z",
                   "tlp": "CLEAR"
               },
               "trigger": {
                   "name": "Observable Update",
                   "type": "UPDATE",
                   "trigger_time": "2024-07-22T14:31:26.000Z",
                   "trigger_fields": [
                       {
                           "field_name": "reputation",
                           "previous_value": null,
                           "current_value": "malicious"
                       }
                   ]
               }
           },
           {
               "record": "Observable",
               "record_fields": {
                   "is_false_positive": "false",
                   "reputation": "malicious",
                   "sys_updated_on": "2024-07-22T14:31:19.000Z",
                   "type": "url",
                   "sys_updated_by": "admin",
                   "sys_created_on": "2024-07-04T06:45:20.000Z",
                   "id": "url--9a77adb7eb8b06107750fa86cad0cd6f",
                   "is_defanged": "false",
                   "sys_created_by": "SecCommon.System",
                   "tags": "Enriched",
                   "taxonomies": "T1: V1",
                   "domain": "urlhaus.abuse.ch",
                   "status": "active",
                   "source_count": "1",
                   "threat_score": "20",
                   "sys_id": "5a77adb7eb8b06107750fa86cad0cd6f",
                   "value": "https://urlhaus.abuse.ch/url/2578264/",
                   "confidence": "89",
                   "expiration_time": "2025-10-07T07:13:18.000Z",
                   "tlp": "CLEAR"
               },
               "trigger": {
                   "name": "Observable Update",
                   "type": "UPDATE",
                   "trigger_time": "2024-07-22T14:31:19.000Z",
                   "trigger_fields": [
                       {
                           "field_name": "reputation",
                           "previous_value": null,
                           "current_value": "malicious"
                       }
                   ]
               }
           }
       ]
   }

   La table suivante répertorie la structure de charge utile par lots et ses attributs qui seront envoyés aux utilisateurs en tant que charge utile webhook :

   Paramètres dans la charge utile par lots	Type	Description
   batch_id	Chaîne	Spécifie un identificateur unique pour un lot.
   Événements	Tableau d'objets	Contient un tableau d’événements déclenchés dans le cadre de ce webhook. Chaque événement contient l’instantané des valeurs de champ au moment de la génération de l’événement et contient également les informations du déclencheur. Remarque : Pour plus d’informations sur l’affichage des paramètres dans l’objet d’événement, reportez-vous à la section Déclencheurs de webhook.

   Remarque :
8. Cliquez sur le bouton Réessayer le lot pour réessayer le lot ayant échoué.
   Remarque :

   Vous pouvez également déclencher le lot de nouvelles tentatives pour les lots terminés.