Collecter les journaux de sécurité ServiceNow

Compatible avec :

Présentation

Ce parseur extrait les données d'événements de sécurité des journaux JSON ServiceNow, en mappant les champs pertinents sur l'UDM. Il gère différents types d'événements, comme les connexions et les modifications d'autorisations, en renseignant les informations sur l'utilisateur principal/cible, les adresses IP et les métadonnées telles que les détails du fournisseur et du produit.

Avant de commencer

Assurez-vous de remplir les conditions préalables suivantes :

  • Instance Google SecOps.
  • Accès privilégié à la sécurité ServiceNow.

Configurer des flux

Il existe deux points d'entrée différents pour configurer les flux dans la plate-forme Google SecOps :

  • Paramètres SIEM> Flux
  • Plate-forme de contenu > Packs de contenu

Configurer des flux à partir de Paramètres SIEM > Flux

Pour configurer un flux, procédez comme suit :

  1. Accédez à Paramètres SIEM > Flux.
  2. Cliquez sur Add New Feed (Ajouter un flux).
  3. Sur la page suivante, cliquez sur Configurer un seul flux.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Journaux de sécurité ServiceNow).
  5. Sélectionnez Webhook comme type de source.
  6. Sélectionnez ServiceNow Security comme Type de journal.
  7. Cliquez sur Suivant.
  8. Facultatif : Spécifiez les valeurs des paramètres d'entrée suivants :
    • Délimiteur de fractionnement : délimiteur utilisé pour séparer les lignes de journaux, tel que \n.
  9. Cliquez sur Suivant.
  10. Vérifiez la configuration du flux sur l'écran Finaliser, puis cliquez sur Envoyer.
  11. Cliquez sur Générer une clé secrète pour générer une clé secrète permettant d'authentifier ce flux.
  12. Copiez et stockez la clé secrète. Vous ne pourrez plus afficher cette clé secrète. Si nécessaire, vous pouvez générer une nouvelle clé secrète, mais l'ancienne deviendra obsolète.
  13. Dans l'onglet Détails, copiez l'URL du point de terminaison du flux à partir du champ Informations sur le point de terminaison. Vous devez spécifier cette URL de point de terminaison dans votre application cliente.
  14. Cliquez sur OK.

Configurer des flux depuis le Hub de contenu

Indiquez les valeurs des champs suivants :

  • Délimiteur de fractionnement : délimiteur utilisé pour séparer les lignes de journaux, tel que \n.

Options avancées

  • Nom du flux : valeur préremplie qui identifie le flux.
  • Type de source : méthode utilisée pour collecter les journaux dans Google SecOps.
  • Espace de noms de l'élément : espace de noms associé au flux.

  • Libellés d'ingestion : libellés appliqués à tous les événements de ce flux.

  • Cliquez sur Générer une clé secrète pour générer une clé secrète permettant d'authentifier ce flux.

  • Copiez et stockez la clé secrète. Vous ne pourrez plus afficher cette clé secrète. Si nécessaire, vous pouvez générer une nouvelle clé secrète, mais l'ancienne deviendra obsolète.

  • Dans l'onglet Détails, copiez l'URL du point de terminaison du flux à partir du champ Informations sur le point de terminaison. Vous devez spécifier cette URL de point de terminaison dans votre application cliente.

Créer une clé API pour le flux de webhook

  1. Accédez à la consoleGoogle Cloud > Identifiants.

    Accéder à "Identifiants"

  2. Cliquez sur Créer des identifiants, puis sélectionnez Clé API.

  3. Restreignez l'accès à la clé API à l'API Google Security Operations.

Spécifier l'URL du point de terminaison

  1. Dans votre application cliente, spécifiez l'URL du point de terminaison HTTPS fournie dans le flux de webhook.

  2. Activez l'authentification en spécifiant la clé API et la clé secrète dans l'en-tête personnalisé au format suivant :

    X-goog-api-key = API_KEY
X-Webhook-Access-Key = SECRET

    Recommandation : Spécifiez la clé API en tant qu'en-tête au lieu de la spécifier dans l'URL.

  3. Si votre client de webhook n'accepte pas les en-têtes personnalisés, vous pouvez spécifier la clé API et la clé secrète à l'aide de paramètres de requête au format suivant :

    ENDPOINT_URL?key=API_KEY&secret=SECRET

    Remplacez les éléments suivants :

    • ENDPOINT_URL : URL du point de terminaison du flux.
    • API_KEY : clé API pour l'authentification auprès de Google SecOps.
    • SECRET : clé secrète que vous avez générée pour authentifier le flux.

Configurer le webhook dans ServiceNow

  1. Connectez-vous à ServiceNow Security avec un compte privilégié.
  2. Accédez à Configuration > Surveillance > Connexions.
  3. Cliquez sur Ajouter .
  4. Sélectionnez Webhook.
  5. Spécifiez les valeurs des paramètres suivants :
    • Nom : indiquez un nom descriptif pour le webhook (par exemple, Google SecOps).
    • URL : saisissez l'ENDPOINT_URL Google SecOps avec API_KEY et SECRET.
  6. Cliquez sur Enregistrer pour terminer la configuration du webhook.

Mappage UDM

Champ du journal Mappage UDM Logique
created_by target.user.userid Mappé sur target.user.userid si snc_user est vide.
événement metadata.product_event_type Mappé directement à partir du champ de journal brut "event".
event_created metadata.event_timestamp.seconds Converti en secondes à partir du champ de journal brut "event_created" à l'aide du filtre date.
ip_address principal.ip Mappé directement à partir du champ de journal brut "ip_address" s'il n'est pas vide.
snc_user target.user.userid Mappé directement à partir du champ de journal brut "snc_user" s'il n'est pas vide.
utilisateur principal.user.userid Directement mappé à partir du champ de journal brut "user" (utilisateur) s'il n'est pas vide ou "null" (nul).
extensions.auth.type Définissez la valeur sur "MACHINE" si le champ event est défini sur "Échec de la connexion", "Connexion SNC", "Connexion administrateur" ou "Usurpation d'identité".
metadata.event_type Définissez-le sur "USER_LOGIN" si le champ event est "Échec de la connexion", "Connexion SNC", "Connexion administrateur" ou "Usurpation d'identité". Définissez la valeur sur "USER_CHANGE_PERMISSIONS" si le champ event est "Security Elevation".
metadata.log_type Codé en dur sur "SERVICENOW_SECURITY".
metadata.product_name Codé en dur sur "SERVICENOW_SECURITY".
metadata.vendor_name Codé en dur sur "SERVICENOW".
principal.user.userid Définissez la valeur sur "UNKNOWN" si le champ user est vide ou défini sur "null".

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.