Exemples de générateur d'expressions
Ce document fournit des cas d'utilisation qui expliquent en détail comment créer et implémenter des expressions dynamiques dans les actions de playbook sur la plate-forme Google Security Operations. Il se concentre sur l'utilisation du générateur d'expressions pour analyser, filtrer et extraire des données spécifiques à partir des résultats d'actions précédentes (telles que des données de liste, des détails sur les entités et des rapports d'analyse) afin de générer une logique d'automatisation complexe dans les étapes ultérieures du playbook.
Avant de commencer
Avant de commencer, suivez ces suggestions :
- Utilisez Qualys – List Scans pour obtenir les derniers scans de Qualys (30 jours codés en dur).
- Utilisez le générateur d'expressions pour extraire l'ID (REF) de la dernière analyse en tant qu'espace réservé afin de télécharger les résultats de l'analyse de VM. Téléchargez le rapport correspondant aux résultats de l'analyse de la VM.
- Utilisez List Operations pour extraire du rapport la liste des identifiants des failles et risques courants (CVE) détectés sur le réseau, puis comparez-la aux CVE de la demande.
- Utilisez une alerte IPS pour déclencher le playbook.
Cas d'utilisation : système de prévention d'intrusion (IPS)
Ce cas d'utilisation suppose que vous créez un playbook qui a détecté un flux malveillant dans un réseau.
Imaginez qu'un outil de gestion des failles, tel que Qualys, a planifié une analyse quotidienne.
Créer un espace réservé
Pour créer un espace réservé, procédez comme suit :
- Commencez par une action
Active Directory_Enrich Entitiespour enrichir toutes les entités potentiellement concernées. - Utilisez Qualys VM – List Scans pour récupérer les derniers résultats d'analyse des machines du réseau.
- Déterminez si l'un des résultats est vulnérable au flux détecté.
- Regardez
QualysVM_Download VM Scan Results_1. L'espace réservé et le générateur d'expressions ajouté devraient s'afficher.
Ajouter l'espace réservé
Pour ajouter l'espace réservé, procédez comme suit :
- Cliquez sur [ ] espace réservé. La boîte de dialogue Insérer un espace réservé s'affiche.
- Sélectionnez Playbook > QualysVM_list_Scans_1_JSONResult.
- Cliquez sur l'icône Générateur d'expressions. La page "Générateur d'expressions" s'affiche.
-
Dans le champ Expression, ajoutez ce qui suit : les expressions utilisent MAX pour obtenir le résultat le plus récent par date
LAUNCH_DATETIME, puis extraient l'ID d'analyse spécifique de l'analyse concernée, où REF correspond à l'ID d'analyse.
Exemple :| max(LAUNCH_DATETIME) | REF - Cliquez sur Exécuter. Les résultats attendus devraient s'afficher.
- Cliquez sur Insérer pour inclure le générateur d'expressions dans l'espace réservé.
- Cliquez sur Action > Lister les opérations en utilisant les CVE des requêtes. L'expression builder s'affiche.
-
Une fois le playbook déclenché en temps réel, vous pouvez consulter les résultats de l'analyse dans le panneau latéral, y compris l'analyse spécifique sous forme de fichier PDF.
Cas d'utilisation : trop de tentatives de connexion infructueuses
Ce cas d'utilisation traite des tentatives de connexion ayant échoué en enrichissant les données d'entité pour déterminer la gravité des alertes. L'objectif est de trouver rapidement le service de l'utilisateur et la date de la dernière modification de son mot de passe.
- Commencez par l'action
ActiveDirectory_Enrichpour recueillir des informations détaillées sur toutes les entités internes associées à l'alerte. - Dans le message Insight suivant, utilisez le générateur d'expressions pour extraire l'utilisateur cible et l'heure de sa dernière connexion.
Ajouter l'espace réservé
Pour ajouter ces espaces réservés :
- Dans le champ Message, cliquez sur [ ] Espace réservé.
-
Sur la page Insérer un espace réservé, cliquez sur l'icône du générateur d'expressions
à côté de
ActiveDirectory_Enrich entities_JSONResult. -
Ajoutez ce qui suit dans le champ de l'expression. Cela permettra de choisir l'identifiant de l'entité. Si plusieurs entités ont renvoyé des résultats, nous les obtiendrons sous la forme d'une liste d'éléments séparés par une virgule.
| Entité
-
Cliquez sur Exécuter. L'exemple de résultat s'affiche. Dans ce cas,
user@domain.com. - Cliquez sur Insérer pour l'utiliser dans votre message de substitution. Ajoutez le texte libre pertinent à votre message.
-
Cliquez sur [ ] espace réservé, puis sur l'icône du générateur d'expressions à côté de
ActiveDirectory_Enrich entities_JSONResult. - Ajoutez l'expression suivante. Elle indique la dernière heure de connexion de l'utilisateur spécifié. | EntityResult.lastLogon
- Cliquez sur Insérer, puis sur Enregistrer.
-
Une fois le playbook déclenché en temps réel, un message s'affiche dans le volet "Insight", indiquant le nom d'utilisateur et la dernière heure de connexion.
Cas d'utilisation : analyse de hachage VirusTotal
Ce cas d'utilisation montre comment extraire la réputation du hachage d'un fichier à partir d'un moteur d'analyse spécifique, tel que Kaspersky, pour déterminer si le fichier est malveillant et créer une entité correspondante.
- Utilisez l'action VirusTotal_Scan Hash pour récupérer le rapport sur le fichier.
L'action suivante, Siemplify_Create ou Update Entity Properties, crée ou modifie une propriété d'entité, telle que Detected by Kaspersky, en fonction des résultats de l'analyse.
Pour ajouter cet espace réservé :
- Dans le champ "Valeur du champ", cliquez sur Espace réservé [].
-
Sur la page Insérer un espace réservé, cliquez sur l'icône Générateur d'expressions
à côté de
VirusTotal_ScanHash_JSONResult.
-
Ajoutez l'expression suivante :
| filter(EntityResult.scans.Kaspersky.detected, "=", "true") | Entity
Si nous avons analysé plusieurs hachages, les résultats sont filtrés par tous les objets d'entité que Kaspersky a marqués comme malveillants, puis seul le nom de l'entité est renvoyé.
- Cliquez sur Insérer > cliquez sur Enregistrer. Les résultats s'affichent au moment de l'exécution.
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.