Bonnes pratiques de recherche
Ce document décrit les bonnes pratiques recommandées par Google pour utiliser la fonctionnalité de recherche dans Google Security Operations. Les recherches peuvent nécessiter des ressources de calcul importantes si elles ne sont pas construites avec soin. Les performances varient également en fonction de la taille et de la complexité des données de votre instance Google SecOps.
Utilisez des filtres spécifiques dans les requêtes pour optimiser la vitesse et les performances.
Le moyen le plus efficace d'améliorer les performances de recherche consiste à créer des requêtes à l'aide de champs UDM (Unified Data Model) spécifiques et optimisés. Ces champs sont optimisés pour une récupération rapide, ce qui garantit que vos recherches s'exécutent rapidement et utilisent moins de ressources de calcul.
Les sections suivantes listent les champs UDM hautes performances à utiliser comme filtres dans vos requêtes.
Champs de métadonnées
metadata.event_timestamp.secondsmetadata.event_typemetadata.log_typemetadata.product_event_typemetadata.product_namemetadata.vendor_name
Champs du principal
principal.applicationprincipal.asset_idprincipal.file.md5principal.file.sha1principal.file.sha256principal.hostnameprincipal.ipprincipal.macprincipal.process.file.md5principal.process.file.sha1principal.process.file.sha256principal.process.pidprincipal.user.email_addressesprincipal.user.userid
Champs source
src.asset_idsrc.hostnamesrc.ipsrc.macsrc.user.userid
Champs cible
target.applicationtarget.asset_idtarget.file.md5target.file.sha1target.file.sha256target.hostnametarget.iptarget.mactarget.process.file.md5target.process.file.sha1target.process.file.sha256target.user.email_addressestarget.user.employee_idtarget.user.useridtarget.user.windows_sid
Champs de réseau
network.dhcp.chaddrnetwork.dhcp.ciaddrnetwork.dhcp.client_hostnamenetwork.dhcp.yiaddrnetwork.dns.answers.classnetwork.dns.answers.namenetwork.dns.answers.typenetwork.dns.questions.classnetwork.dns.questions.namenetwork.dns.questions.typenetwork.email.fromnetwork.email.tonetwork.http.method
Champs des résultats de sécurité
security_result.actionsecurity_result.categorysecurity_result.rule_name
Interroger les données d'entité et les données contextuelles
Si vous recherchez des types de journaux d'entité ou de contexte (comme AZURE_AD_CONTEXT ou WORKSPACE_USERS) à l'aide de metadata.log_type = "<LOG_TYPE>", la recherche ne renvoie aucun résultat, même si les journaux bruts sont visibles dans la recherche de journaux bruts. En effet, la recherche UDM n'interroge que les enregistrements d'événements UDM.
Pour rechercher des données d'entité et des données contextuelles, utilisez la syntaxe graph :
Pour rechercher un type de journal d'entité ou de contexte, interrogez les champs de métadonnées
graph. Exemple :graph.metadata.event_metadata.log_type = "<LOG_TYPE>"Pour rechercher des champs d'entité, utilisez le préfixe
graph.entity.noun.field. Exemple :graph.entity.user.email_addresses = "foo_email"
Pour en savoir plus, consultez Rechercher des données contextuelles d'entité.
Créer des requêtes de recherche efficaces pour améliorer les performances
L'écriture de requêtes optimisées est essentielle pour maximiser la vitesse et minimiser la consommation de ressources dans vos données de sécurité. Toutes les conditions de requête doivent respecter strictement cette structure fondamentale :
udm-field operator value
Par exemple : principal.hostname = "win-server"
Affiner la période de votre recherche
Étant donné que Google SecOps peut ingérer une grande quantité de données lors d'une recherche, réduire la période et le champ d'application de votre requête peut améliorer les performances de recherche.
Utiliser des expressions régulières dans la requête de recherche
Vous pouvez utiliser des opérateurs logiques et de comparaison standards lorsque vous construisez vos requêtes de recherche UDM pour créer des expressions complexes :
- Opérateurs logiques : utilisez
AND,ORetNOTpour combiner des conditions.ANDest utilisé par défaut si vous omettez un opérateur entre deux conditions. - Priorité des opérateurs : utilisez des parenthèses () pour remplacer l'ordre de priorité par défaut. Vous pouvez utiliser un maximum de 169 opérateurs logiques (
OR,AND,NOT) entre parenthèses. - Opérateurs de comparaison : selon le type de champ UDM (chaîne, entier, code temporel), les opérateurs de champ peuvent inclure :
=,!=,>=,>,<,<=.
Google SecOps utilise le moteur d'expressions régulières RE2.
Vous pouvez également utiliser les listes de référence pour rechercher efficacement un grand ensemble de valeurs.
Utiliser nocase comme modificateur de recherche
Vous pouvez ajouter le modificateur nocase à une condition de comparaison de chaînes pour que la recherche ne soit pas sensible à la casse (les majuscules sont ignorées).
Par exemple, la recherche suivante ignore la casse et correspond à toutes les combinaisons contenant tim.smith, quelle que soit la casse :
target.user.userid = "TIM.SMITH" nocase
Éviter d'utiliser des expressions régulières dans les champs énumérés
Vous ne pouvez pas utiliser d'expressions régulières lorsque vous recherchez des champs énumérés (champs avec une plage de valeurs prédéfinies) tels que metadata.event_type ou network.ip_protocol.
L'exemple suivant est une recherche non valide :
metadata.event_type = /NETWORK_*/
En revanche, l'exemple suivant est une recherche valide :
(metadata.event_type = "NETWORK_CONNECTION" ou metadata.event_type = "NETWORK_DHCP")
Utilisez tous les opérateurs dans le champ "Événements".
Dans Recherche, certains champs UDM (comme principal.ip ou target.file.md5) sont étiquetés comme répétés, car ils peuvent contenir une liste de valeurs ou de types de messages dans un seul événement. Par défaut, les champs répétés sont toujours traités avec l'opérateur any (il n'est pas possible de spécifier all).
Lorsque l'opérateur any est utilisé, le prédicat est évalué comme true si une valeur du champ répété remplit la condition. Par exemple, si vous recherchez principal.ip != "1.2.3.4" et que les événements de votre recherche incluent à la fois principal.ip = "1.2.3.4" et principal.ip = "5.6.7.8", une correspondance est générée. Cela élargit votre recherche pour inclure les résultats qui correspondent à l'un des opérateurs au lieu de correspondre à tous.
Chaque élément du champ répété est traité individuellement. Si le champ répété est trouvé dans les événements de la recherche, les événements sont évalués pour chaque élément du champ. Cela peut entraîner un comportement inattendu, en particulier lors d'une recherche à l'aide de l'opérateur !=.
Lorsque vous utilisez l'opérateur any, le prédicat est évalué comme true si une valeur du champ répété remplit la condition.
Utiliser l'heure epoch Unix pour les codes temporels ou utiliser les fonctions YARA-L pour la conversion de date
Les champs de code temporel sont mis en correspondance à l'aide de l'heure epoch Unix (le nombre total de secondes écoulées depuis le jeudi 1er janvier 1970 à 00:00:00 UTC). Vous pouvez également utiliser les fonctions YARA-L pour la conversion de date.
Lorsque vous recherchez un code temporel spécifique, le format suivant (en temps epoch) est valide :
metadata.ingested_timestamp.seconds = 1660784400
Le code temporel suivant n'est pas valide :
metadata.ingested_timestamp = "2022-08-18T01:00:00Z"
Lorsque vous recherchez un code temporel spécifique, la syntaxe suivante (qui utilise une fonction YARA-L pour la conversion de date) est valide :
metadata.event_type = "NETWORK_CONNECTION"
timestamp.get_date(metadata.ingested_timestamp.seconds) = "2026-03-15"
L'exemple YARA-L suivant utilise les fonctions timestamp pour vérifier les périodes d'ingestion :
metadata.event_type = "NETWORK_CONNECTION"
$date = timestamp.get_date(metadata.ingested_timestamp.seconds)
$date > "2026-03-15" AND $date < "2026-03-17"
Interroger des données récemment ingérées avec des codes temporels plus anciens
Vous ne pouvez pas rechercher les événements récemment ingérés qui ont un code temporel plus ancien, sauf si vous spécifiez la période de l'événement à interroger. En effet, la période est basée sur le code temporel de l'événement analysé, et non sur le code temporel d'ingestion de l'événement de journal brut.
Pour rechercher des événements UDM pour les journaux ingérés avec des codes temporels d'événements plus anciens, vous pouvez utiliser l'option Toutes les périodes pour rechercher et interroger metadata.ingested_timestamp.
Champs exclus des filtres
Les champs suivants sont intentionnellement exclus des filtres de recherche :
metadata.idmetadata.product_log_id*.timestamp
Bien que ces champs contiennent des métadonnées importantes, leurs valeurs uniques introduisent une cardinalité et une variance élevées dans les statistiques, ce qui a un impact négatif sur les performances de recherche.
Dépannage
Si vous recevez un message d'erreur générique, tel que "Erreur : La recherche a rencontré une erreur et n'a pas pu charger les données", suivez les étapes ci-dessous pour résoudre le problème. Si l'erreur persiste, contactez l'assistance client.
- Connectez-vous à Google SecOps à partir d'un autre réseau. Par exemple, utilisez une VM cloud pour identifier les problèmes de réseau.
- Assurez-vous que les appels d'API Chronicle sont autorisés par la configuration ou la règle de pare-feu ou de proxy de votre organisation.
- Vérifiez qu'aucune limite de données n'est configurée pour les appels d'API Search, car les recherches peuvent renvoyer des ensembles de données volumineux.
- Les requêtes de recherche peuvent s'exécuter de manière asynchrone et nécessiter plus de temps pour renvoyer des données. Vous pouvez afficher les recherches effectuées précédemment dans l'historique des recherches et les sélectionner pour afficher les résultats plus tard.
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.