Configurer des champs calculés

Compatible avec :

Ce guide s'adresse aux analystes de sécurité et aux responsables SOC qui souhaitent automatiser l'enrichissement des données dans leurs opérations de sécurité. Il explique comment créer et gérer des champs calculés à l'aide de formules logiques pour dériver de nouvelles valeurs à partir des données de cas et d'alertes existantes. En suivant cette méthode, vous pouvez éliminer la saisie manuelle des données et vous assurer que les métriques critiques sont mises à jour en temps réel. La réussite de cette opération améliore les capacités d'analyse de la plate-forme et accélère le tri des incidents grâce au remplissage automatique des champs.

Les champs calculés vous permettent de dériver de manière dynamique de nouveaux points de données dans les cas et les alertes Google Security Operations. En définissant des formules logiques, vous pouvez calculer des valeurs en fonction de champs système ou personnalisés existants. La valeur calculée est automatiquement évaluée et stockée en temps réel dans un champ personnalisé préexistant sélectionné par l'utilisateur (appelé Champ cible).

Cas d'utilisation courants

Les scénarios suivants représentent les cas d'utilisation les plus fréquents des champs calculés par les organisations pour améliorer l'efficacité opérationnelle et la clarté des données.

Scoring de risque automatisé

  • Objectif : catégoriser les demandes en fonction du volume d'événements ou des niveaux de priorité.
  • Valeur : standardise le tri et garantit que les incidents à haut risque sont immédiatement visibles par l'équipe.

Normalisation des données

  • Objectif : marquer les alertes comme Test ou Production en fonction des conventions d'attribution de noms.
  • Avantage : réduit le bruit en permettant aux analystes de filtrer les données de test non critiques de leur vue principale.

Terminologie clé

  • Formule : expression logique textuelle que vous définissez à l'aide de fonctions, d'opérateurs et de références de champ pour calculer une valeur.
  • Champ cible : champ personnalisé existant (type Texte libre) dans lequel le résultat du calcul de la formule est stocké.
  • Dépendances : champs référencés dans votre formule. Lorsque la valeur d'un champ de dépendance change, le champ calculé est réévalué de manière synchrone.

Avant de commencer

Avant de créer un calcul, assurez-vous que votre environnement répond aux exigences techniques suivantes :

  • Autorisations : vous devez disposer d'un accès administrateur au menu Paramètres et des autorisations nécessaires pour gérer les balises.
  • Vérification de l'environnement : assurez-vous de disposer de champs personnalisés existants et actifs (de type Texte libre) qui serviront de champs cibles.

Assurez-vous de disposer de champs personnalisés existants à utiliser comme champs cibles dans votre système. Si ce n'est pas le cas, procédez comme suit :

  1. Accédez à Paramètres > Investigation > Champs personnalisés.
  2. Créez un champ personnalisé et définissez le type sur Texte libre.

Pour en savoir plus sur les champs personnalisés, consultez Créer un champ personnalisé.

Contraintes techniques et règles de validation

Avant de définir un calcul, assurez-vous que vos champs cibles et votre logique respectent ces contraintes système. Ces règles régissent la manière dont le moteur Google SecOps valide et conserve les résultats des formules.

Critères de validation des champs

Le moteur de calcul applique strictement les exigences suivantes pour tout champ désigné comme champ cible :

  • Type de données : le champ doit être de type Texte libre.
  • État opérationnel : le champ doit être défini sur Actif. Le système ne peut pas écrire dans des champs supprimés ou invalidés.
  • Mappage des dépendances : pour éviter toute logique circulaire, un champ ne peut pas être une cible s'il est déjà une dépendance pour un autre champ calculé.

Champ d'application des champs

Lorsque vous créez un champ personnalisé avec un champ d'application Both, le système génère des entrées uniques pour chaque contexte. Cela vous permet de conserver une logique distincte pour les demandes et les alertes au sein d'une même catégorie logique.

Dans le menu Champ cible, vous devez sélectionner le champ d'application spécifique à votre formule :

  • Champ d'application du cas : libellé CaseCustom.YourField (par exemple, CaseCustom.RiskLevel)
  • Champ d'application de l'alerte : libellé AlertCustom.YourField (par exemple, AlertCustom.RiskLevel)

Créer et gérer des champs calculés

Cette section explique comment définir un nouveau calcul et résoudre les problèmes courants lors du processus de configuration.

Créer un calcul

Pour créer un calcul, procédez comme suit :

  1. Accédez à Paramètres > Investigation > Champs calculés.
  2. Cliquez sur Ajouter Ajouter.
  3. Dans le champ Nom du champ calculé, saisissez un nom unique et une description pour votre calcul.
  4. Dans la zone Champ cible, sélectionnez le champ personnalisé existant pour stocker le résultat.

    1. Échec anticipé : le champ sélectionné n'apparaît pas dans le menu.
    2. Mesure corrective : vérifiez que le champ personnalisé est actif, qu'il est défini sur Texte libre et qu'il ne dépend pas déjà d'un autre calcul.
  5. Dans l'éditeur de texte, créez votre formule à l'aide des fonctions, des opérateurs et de la syntaxe compatibles. Créez une expression logique (par exemple, IF ([case.priority] == "High") THEN "Urgent" ELSE "Standard"). Pour en savoir plus, consultez Langage et syntaxe des formules.

  6. Cliquez sur Enregistrer.

    1. Échec anticipé : le système refuse l'enregistrement et affiche une erreur en rouge.
    2. Mesure corrective : recherchez les erreurs de syntaxe, telles que des parenthèses manquantes autour des conditions IF ou des mots clés en minuscules.

Accéder aux assets et références avancés

Les formules doivent respecter des règles strictes de grammaire et de sensibilité à la casse pour tous les opérateurs et fonctions intégrés. Utilisez les caractéristiques techniques suivantes pour vous assurer que vos calculs sont valides.

Exemples de formules

Les modèles suivants montrent comment combiner des fonctions et des opérateurs pour automatiser l'enrichissement des données. Vous pouvez copier et adapter ces extraits pour qu'ils correspondent aux noms de vos champs spécifiques et aux exigences de votre organisation.

Exemple 1 : Définir un niveau de risque

Utilisez cette formule pour classer les demandes en fonction de mots clés spécifiques trouvés dans leur titre.

  • Champ cible : CaseCustom.risk_level (texte)
  • Objectif : attribuer automatiquement l'état "Élevé" aux incidents urgents
  • Formule :

    IF (CONTAINS([case.name], "urgent")) THEN "High" ELSE "Medium"

Exemple 2 : Signalement d'alertes de test

Cette logique identifie et étiquette les données de test pour aider les analystes à filtrer leurs vues principales et à se concentrer sur les incidents de production.

  • Champ cible : AlertCustom.is_test (texte)
  • Objectif : détecter le suffixe -TEST ou la chaîne TEST dans un nom d'alerte
  • Formule :

    IF (CONTAINS([alert.name], "TEST") OR ENDS_WITH([alert.name], "-TEST"))
    THEN "TRUE"
    ELSE "FALSE"
    

Exemple 3 : Combiner des conditions

Cet exemple illustre une logique imbriquée permettant de hiérarchiser les examens en fonction du volume d'événements et des niveaux de priorité existants.

  • Champ cible : CaseCustom.review_status (texte)
  • Objectif : Déclencher un examen manuel uniquement lorsque la longueur du journal est importante et que la priorité n'est pas Low.
  • Formule :

    IF (LENGTH(\[AlertCustom.event\_details\]) \> 100 AND NOT IS(\[case.priority\], "Low"))
    THEN "Needs Review"
    ELSE "Auto-Closed"
    

Langage et syntaxe des formules

Le moteur de calcul est sensible à la casse pour tous les opérateurs, mots clés et fonctions intégrés. Vous devez écrire les mots clés (par exemple, IF, THEN, ELSE, AND, OR, NOT) et les noms de fonctions (par exemple, CONTAINS, LENGTH, STARTS_WITH, ENDS_WITH, IS, IS_NOT, DOES_NOT_CONTAIN) en majuscules. Toutefois, les tests de chaînes de texte dans les fonctions et les opérateurs d'égalité ne sont pas sensibles à la casse. Par exemple, la recherche "phishing" renverra "PHISHING" ou "Phishing".

Types de données et littéraux

Un littéral est une valeur fixe utilisée dans les expressions. Nous vous recommandons de vous assurer que vos opérations et arguments de fonction utilisent des types compatibles.

Type Syntaxe et règles Exemple
STRING Texte entre guillemets doubles. "critical", "N/A"
NUMBER Nombres entiers ou décimaux. 100, 3.14
BOOLEAN Doit être en majuscules. TRUE, FALSE
NULL Représente une valeur vide. NULL

Références de champ

Pour utiliser la valeur d'un autre champ, placez le nom du champ entre crochets, par exemple [object.field_name].

  • Règle de syntaxe : vous devez utiliser un préfixe avec les références de champ. Vous devez utiliser un préfixe (par exemple, case. ou AlertCustom.) suivi d'un point et du nom du champ. Le nom du champ peut contenir des lettres, des chiffres, des caractères de soulignement et des espaces. Par exemple : [case.name], [alert.priority], [AlertCustom.my_custom_field].
  • Vous pouvez utiliser les champs système suivants : case.name, case.stage, case.priority, alert.name, alert.priority, alert.rule_generator.
  • Vous pouvez référencer tous les champs personnalisés définis par l'utilisateur.
  • Une formule de champ calculé ne peut pas faire référence à un autre champ calculé.

Opérateurs

Utilisez des opérateurs pour les comparaisons et les opérations logiques. Utilisez des parenthèses () pour remplacer la priorité par défaut et regrouper les expressions.

  • Opérateurs de comparaison : ==, !=, >, >=, <, <=
  • Opérateurs logiques : AND, OR, NOT
  • Priorité des opérateurs : NOT, >, >=, <, <=, AND, OR,

Expressions conditionnelles

Le système accepte la logique conditionnelle à l'aide de la syntaxe IF (condition) THEN expression1 ELSE expression2. La partie ELSE est facultative. Si vous l'omettez et que la condition est FALSE, le résultat est NULL par défaut.

La condition doit être une expression qui renvoie TRUE ou FALSE.

Par exemple, IF ( [CaseCustom.score] > 75 ) THEN "High Risk" ELSE "Low Risk".

Fonctions

Les fonctions sont des opérations prédéfinies qui doivent être entièrement en majuscules. Le tableau suivant liste les fonctions compatibles pour la manipulation et l'évaluation des données.

Fonction Description Syntaxe Type renvoyé
CONTAINS(field, substring) Vérifie si un champ de texte contient une sous-chaîne (non sensible à la casse) CONTAINS([case.name], "phishing") BOOLEAN
DOES_NOT_CONTAIN(field, substring) Vérifie si un champ de texte ne contient pas de sous-chaîne (non sensible à la casse) DOES_NOT_CONTAIN([case.name], "test") BOOLEAN
LENGTH(field) Renvoie le nombre de caractères d'un champ LENGTH([case.name]) NUMBER
STARTS_WITH(field, prefix) Vérifie si le champ commence par un préfixe (non sensible à la casse) STARTS_WITH([CaseCustom.hostname], "srv-") BOOLEAN
ENDS_WITH(field, suffix) Vérifie si le champ se termine par un suffixe (non sensible à la casse) ENDS_WITH([AlertCustom.filename], ".exe") BOOLEAN
IS(field, literal) Vérifie si la valeur du champ est égale à la valeur littérale (non sensible à la casse) IS([alert.priority], "High") BOOLEAN
IS_NOT(field, literal) Vérifie si la valeur du champ n'est PAS égale au littéral (non sensible à la casse) IS_NOT([alert.priority], "Low") BOOLEAN

Mots clés et identifiants réservés

Le moteur de calcul réserve des mots spécifiques pour les opérations et fonctions logiques. Vous ne pouvez pas utiliser ces termes comme noms de champs personnalisés ni comme autres identifiants dans une formule :

  • Logique : AND, OR, NOT, IF, THEN, ELSE
  • Valeurs : NULL, TRUE, FALSE
  • Fonctions : CONTAINS, LENGTH, STARTS_WITH, ENDS_WITH, IS, IS_NOT, DOES_NOT_CONTAIN

Compatibilité des types de données

Pour garantir une évaluation réussie, vérifiez que toutes les opérations et tous les arguments de fonction utilisent des types compatibles. Les types acceptés sont STRING, NUMBER, BOOLEAN et NULL.

Le résultat final de la formule doit correspondre au type attendu du champ cible. Étant donné que les champs cibles sont limités au "texte libre", votre formule doit finalement se résoudre en une chaîne ou une valeur pouvant être implicitement convertie au format de la cible.

Mise en forme et espaces blancs

Bien que les espaces, les tabulations et les sauts de ligne soient généralement ignorés entre les jetons, ils sont strictement requis pour séparer les mots clés des identifiants. Utilisez les espaces de manière stratégique pour structurer les formules complexes sur plusieurs lignes afin d'améliorer la maintenance et l'examen par les pairs.

Rédiger des formules efficaces

Bien que le moteur de calcul soit flexible avec les espaces, suivez ces normes de mise en forme pour éviter les erreurs de logique et simplifier le dépannage.

  • Regroupement explicite : utilisez des parenthèses pour définir clairement l'ordre des opérations, même lorsque vous vous appuyez sur la priorité standard. Cela permet d'éviter toute ambiguïté logique.
  • Structure visuelle : appliquez des espaces autour des opérateurs (==, AND, OR) et insérez des sauts de ligne pour les instructions IF/THEN imbriquées afin de faciliter la lecture de la logique.
  • Validation du type : vérifiez toujours que le résultat final de votre formule correspond au type attendu du champ cible pour éviter les erreurs d'évaluation.

    IF (
        (IS([CaseCustom.event_count], "100") AND NOT IS([case.priority], "Low"))
        OR CONTAINS([case.name], "Critical")
    )
    THEN "Needs Immediate Review"
    ELSE "Standard Review"
    

Dépannage

Cette section décrit les attentes en termes de performances et fournit des solutions en libre-service pour les problèmes de déploiement courants rencontrés lors de la création ou de la gestion de formules.

Latence et limites

Les champs calculés sont évalués de manière synchrone chaque fois qu'un champ de dépendance change. Pour maintenir les performances du système, un champ calculé ne peut pas faire référence à un autre champ calculé. Le système bloque ces dépendances en chaîne pour éviter la récursion et les retards de traitement.

Correction des erreurs

Lorsque vous écrivez des formules manuellement, des erreurs peuvent se produire en raison d'une syntaxe incorrecte ou d'une incompatibilité de types de données. Utilisez le tableau suivant pour faire correspondre des codes d'erreur spécifiques liés au parcours à leurs solutions exactes et exploitables.

Type d'erreur Problème Corriger
Syntaxe La formule ne respecte pas les règles de grammaire (par exemple, parenthèses non appariées ou mots clés en minuscules). Encapsulez toutes les conditions IF entre parenthèses () et vérifiez que tous les mots clés sont en MAJUSCULES.
Validation La formule fait référence à un champ inconnu (par exemple, [\case.typo]) ou entraîne une incompatibilité de type. Vérifiez les noms des champs entre crochets et confirmez que le résultat correspond au type de champ cible.
Évaluation La formule est valide, mais échoue lors de l'exécution, affichant souvent #ERROR!. Recherchez les problèmes d'exécution, comme la transmission d'une valeur non-chaîne à une fonction telle que LENGTH().

Modifier ou supprimer des champs cibles

Le système protège activement les champs sur lesquels reposent vos formules afin de préserver l'intégrité des données. Si vous essayez de supprimer ou de modifier un champ personnalisé utilisé comme champ cible, le système bloque l'action et affiche un avertissement indiquant qu'il est utilisé dans un champ calculé.

Validation et test

Après avoir enregistré un nouveau calcul, vérifiez les résultats en accédant à une demande ou à une alerte, puis en mettant à jour un champ de dépendance. Vérifiez que le champ cible est renseigné avec la valeur attendue en temps réel.

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