Afficher les lots de webhooks

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • Un enregistrement par lots de webhook est créé pour chaque exécution de webhook.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Afin de réduire le nombre d’appels d’API envoyés aux points de terminaison de webhook, le traitement par lots des é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 requête au point de terminaison webhook.

    Procédure

    1. Accédez à la Tous > Centre de sécurité des renseignements sur les menaces > 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 d’un webhook particulier.
    6. Accédez à la colonne Lot .
    7. Cliquez sur n’importe quel ID de lot.
      La page Lot de webhooks s’affiche.
      Remarque :
      Tous les lots sont stockés dans la table sn_sec_tisc_webhook_batch.
      Vous trouverez ci-dessous l’exemple de format de charge utile que le point de terminaison de webhook reçoit :
      {
    "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 l’identificateur unique pour un lot.
      Événements Tableau d'objets Contient un tableau d’événements qui sont 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 ainsi que les informations de déclenchement.
      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.