Collecter les journaux Aware Signals

Version de l'analyseur : 1.0

Compatible avec :

Ce document explique comment configurer Aware pour qu'il transmette les journaux d'événements Signal à Google Security Operations à l'aide de webhooks.

Aware (by Mimecast) est une plate-forme de sécurité de la collaboration et de gestion des risques internes qui surveille le contenu des outils de communication d'entreprise tels que Slack, Microsoft Teams, Zoom, Cisco Webex et Workvivo. L'application Aware Signal utilise des modèles d'IA, la correspondance des mots clés, des expressions régulières et l'analyse des sentiments pour détecter les cas de non-respect des règles et générer des événements. Ces événements Signal peuvent être transférés vers une destination SIEM pour une surveillance de la sécurité et une corrélation centralisées.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un abonnement à la plate-forme Aware avec le module Signal activé
  • Un compte administrateur Aware ayant accès aux paramètres système
  • Au moins une plate-forme de collaboration (Slack, Microsoft Teams, Zoom, Webex ou Workvivo) connectée et ingérant du contenu dans Aware
  • Au moins une règle et une stratégie Signal configurées pour générer des événements
  • Accès à la console Google Cloud (pour la création de clés API)

Créer un flux de webhook dans Google SecOps

Créer le flux

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  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, Aware Signal Events).
  5. Sélectionnez Webhook comme type de source.
  6. Sélectionnez Signaux Aware comme Type de journal.
  7. Cliquez sur Suivant.
  8. Spécifiez les valeurs des paramètres d'entrée suivants :
    • Délimiteur de division : saisissez \n (délimiteur de saut de ligne pour les charges utiles NDJSON).
    • Espace de noms de l'élément : espace de noms de l'élément
    • Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux
  9. Cliquez sur Suivant.
  10. Vérifiez la configuration de votre nouveau flux sur l'écran Finaliser, puis cliquez sur Envoyer.

Générer et enregistrer la clé secrète

Après avoir créé le flux, vous devez générer une clé secrète pour l'authentification :

  1. Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
  2. Une boîte de dialogue affiche la clé secrète.
  3. Copiez et enregistrez la clé secrète de manière sécurisée.

Obtenir l'URL du point de terminaison du flux

  1. Accédez à l'onglet Détails du flux.
  2. Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
  3. Le format d'URL est le suivant :

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Où {region} est la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1) et {parent} est le chemin d'accès à la ressource au format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Enregistrez cette URL pour les étapes suivantes.

  5. Cliquez sur OK.

Créer une clé API Google Cloud

Google SecOps nécessite une clé API pour l'authentification. Créez une clé API restreinte dans la console Google Cloud .

Créer la clé API

  1. Accédez à la page Identifiants de la consoleGoogle Cloud .
  2. Sélectionnez votre projet (celui associé à votre instance Google SecOps).
  3. Cliquez sur Créer des identifiants > Clé API.
  4. Une clé API est créée et s'affiche dans une boîte de dialogue.
  5. Cliquez sur Modifier la clé API pour restreindre la clé.

Restreindre la clé API

  1. Sur la page des paramètres de la clé API :
    • Nom : saisissez un nom descriptif (par exemple, Chronicle Webhook API Key).
  2. Sous Restrictions relatives aux API :
    1. Sélectionnez Restreindre la clé.
    2. Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps (ou API Chronicle).
  3. Cliquez sur Enregistrer.
  4. Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
  5. Enregistrez la clé API de manière sécurisée.

Obtenir la clé API Aware

Aware utilise une clé API pour authentifier les intégrations externes. Pour obtenir la clé :

  1. Connectez-vous à Aware sur https://aware.work avec un compte administrateur.
  2. Cliquez sur Paramètres système en bas à gauche.
  3. Accédez à l'onglet Intégrations.
  4. Copiez la clé API affichée sur la page.

  5. Enregistrez la clé API de manière sécurisée pour l'utiliser lors des étapes suivantes.

Configurer le transfert de webhook Aware Signal

Créer l'URL de webhook

  • Combinez l'URL du point de terminaison Google SecOps, la clé API et la clé secrète :

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Exemple :

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Configurer le transfert d'événements dans Aware

Configurez Aware pour transférer les événements Signal vers le point de terminaison du webhook Google SecOps. La procédure exacte peut varier en fonction de la version de votre plate-forme Aware.

  1. Connectez-vous à Aware sur https://aware.work avec un compte administrateur.
  2. Cliquez sur Paramètres système en bas à gauche.
  3. Accédez à l'onglet Intégrations.
  4. Configurez une nouvelle destination de webhook avec les détails suivants :

    • URL de destination : collez l'URL complète du webhook, avec la clé API et la clé secrète ajoutées en tant que paramètres de requête :

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY
      
    • Type de contenu : sélectionnez application/json.

    • En-tête d'authentification (si compatible avec votre version d'Aware) : définissez le nom de l'en-tête sur X-Aware-Api-Key et la valeur sur votre clé API Aware.

  5. Sélectionnez les types d'événements à transférer. Pour une surveillance complète de la sécurité, activez le transfert de tous les événements Signal :

    • Événements de non-respect des règles
    • Événements de correspondance de mots clés
    • Événements de détection de l'IA/des sentiments
    • Événements de détection de comportements toxiques
  6. Cliquez sur Enregistrer pour activer la destination du webhook.

Alternative : Transférer des événements à l'aide d'une fonction Cloud Run

Si votre version d'Aware n'est pas compatible avec le push de webhook natif pour les événements Signal, vous pouvez utiliser une fonction Cloud Run pour interroger l'API Aware et transférer les événements vers le point de terminaison du webhook Google SecOps.

  1. Créez une fonction Cloud Run (Python 3.12 ou version ultérieure) avec un déclencheur Pub/Sub.
  2. Configurez la fonction pour :
    1. Authentifiez-vous auprès de l'API Aware à l'aide de l'en-tête X-Aware-Api-Key.
    2. Interrogez les événements Signal à partir du point de terminaison de l'API Aware.
    3. Transférez chaque événement en tant que charge utile JSON vers l'URL du point de terminaison du webhook Google SecOps.
  3. Utilisez Cloud Scheduler pour appeler la fonction à intervalles réguliers (par exemple, toutes les cinq minutes).

    • Exemple de requête pour transférer des événements :

      curl -X POST "https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY" \
        -H "Content-Type: application/json" \
        -d '{"signal_id":"12345","event_type":"policy_violation","timestamp":"2026-01-15T10:30:00Z","user":"user@example.com","platform":"slack","policy":"Data Loss Prevention","rule":"Credit Card Numbers","message_snippet":"detected content"}'
      

Vérifier la diffusion des événements

  1. Dans Google SecOps, accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur le flux Événements de signal Aware.
  3. Accédez à l'onglet État.
  4. Vérifiez que les événements sont bien reçus.
  5. Vous pouvez également déclencher un événement Signal de test dans Aware :

    1. Dans Aware, accédez à Signal > Événements.
    2. Vérifiez que de nouveaux événements sont générés par vos règles.
    3. Attendez quelques minutes que les événements s'affichent dans Google SecOps.

Types d'événements Aware Signal

Aware Signal détecte les événements sur les plates-formes de collaboration connectées à l'aide d'une combinaison de modèles d'IA, de correspondance des mots clés, d'expressions régulières et d'analyse des sentiments. Les catégories d'événements suivantes sont couramment générées :

Catégorie Description Exemples
Non-respect des règles Événements déclenchés par des règles définies Détection de mots clés, correspondance de modèle d'expression régulière, données sensibles
IA/Sentiment Événements détectés par l'IA et les modèles de sentiments Langage toxique, sentiments négatifs, harcèlement
Perte de données Événements liés à une exfiltration de données potentielle Non-respect des règles de partage de fichiers, partage externe, exposition des identifiants
Risque interne Événements indiquant des menaces internes potentielles Comportements inhabituels, anomalies d'accès, risque lié au départ d'un employé
Conformité Événements liés à la conformité réglementaire Exposition des informations permettant d'identifier personnellement l'utilisateur, partage de données financières, violations de la loi HIPAA

Référence des méthodes d'authentification

Les flux de webhook Google SecOps sont compatibles avec plusieurs méthodes d'authentification. Choisissez la méthode compatible avec votre fournisseur.

Méthode 1 : Paramètres de requête

Ajoutez des identifiants à l'URL de webhook.

  • Format d'URL :

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Exemple :

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Méthode 2 : En-têtes personnalisés

Si votre configuration accepte les en-têtes HTTP personnalisés, utilisez cette méthode pour renforcer la sécurité.

  • Headers:

    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    

Avantages :

  • Clé API et code secret non visibles dans l'URL
  • Plus sécurisé (les en-têtes ne sont pas enregistrés dans les journaux d'accès du serveur Web)

Limites et bonnes pratiques concernant les webhooks

Limites de requêtes

Limite Valeur
Taille maximale de la requête 4 Mo
Nombre maximal de RPS (requêtes par seconde) 15 000
Délai avant expiration de la requête 30 seconds
Comportement de nouvelle tentative Automatique avec intervalle exponentiel entre les tentatives

Bonnes pratiques

  • Activez le transfert pour tous les types d'événements Signal afin d'assurer une couverture de sécurité complète.
  • Surveillez régulièrement l'état de distribution des webhooks pour détecter les échecs ou les retards.
  • Utiliser le délimiteur de division \n dans la configuration du flux Google SecOps pour gérer les charges utiles NDJSON
  • Testez l'intégration avec un cas connu de non-respect des règles avant de déployer en production.
  • Examinez régulièrement les règles Aware Signal pour vous assurer que les événements pertinents sont capturés.

Dépannage

Les événements n'apparaissent pas dans Google SecOps

Cause : Des événements sont générés dans Aware, mais ne sont pas ingérés.

Solution :

  1. Dans Google SecOps, accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur votre flux d'événements de signaux Aware.
  3. Accédez à l'onglet État.
  4. Vérifiez si des erreurs d'ingestion se sont produites.
  5. Vérifiez que le type de journal est défini sur Signaux Aware.
  6. Vérifiez que la clé API et la clé secrète de l'URL de webhook sont correctes.

Erreurs d'authentification

Cause : clé API ou clé secrète non valide

Solution :

  1. Vérifiez que la clé API Google SecOps est valide et qu'elle dispose de la restriction d'API appropriée.
  2. Vérifiez que la clé secrète correspond à celle générée lors de la création du flux.
  3. Testez le point de terminaison manuellement :

    curl -X POST "https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY" \
        -H "Content-Type: application/json" \
        -d '{"test": "event"}'
    
  4. Si le test échoue, regénérez la clé API ou la clé secrète, puis mettez à jour la configuration du webhook dans Aware.

La charge utile dépasse la taille maximale

Cause : Les charges utiles d'événement dépassent la limite de 4 Mo.

Solution :

  1. Réduisez le nombre de types d'événements transférés.
  2. Contactez l'assistance Aware pour configurer les limites de taille des charges utiles.
  3. Si vous utilisez l'approche des fonctions Cloud Run, implémentez le traitement par lot pour diviser les charges utiles volumineuses en plusieurs requêtes.

Table de mappage UDM

Champ du journal Mappage UDM Logique
has_principal metadata.event_type Mappé : true → NETWORK_CONNECTION, true → STATUS_UPDATE
has_user metadata.event_type Mappé : true → USER_UNCATEGORIZED
signalEventDetails.eventStatus security_result.action_details Mappage direct
contentObjectDetails_contentObjectIsChat_label security_result.detection_fields Fusionné
contentObjectDetails_contentObjectIsThread_label security_result.detection_fields Fusionné
detectionLength_label security_result.detection_fields Fusionné
detectionStart_label security_result.detection_fields Fusionné
ruleConditionMatches_label security_result.detection_fields Fusionné
search_label security_result.detection_fields Fusionné
signalEventDetails_createdTime_label security_result.detection_fields Fusionné
signalEventDetails_deletedTime_label security_result.detection_fields Fusionné
signalEventDetails_inspectionRequestId_label security_result.detection_fields Fusionné
signalEventDetails_isQuarantined_label security_result.detection_fields Fusionné
signalEventDetails_policyDetails_createdTime_label security_result.detection_fields Fusionné
signalEventDetails_policyDetails_policyId_label security_result.detection_fields Fusionné
signalEventDetails_policyDetails_policyName_label security_result.detection_fields Fusionné
signalEventDetails_ruleBehavior_label security_result.detection_fields Fusionné
signalEventDetails_ruleFamilyId_label security_result.detection_fields Fusionné
signalEventDetails_tenantId_label security_result.detection_fields Fusionné
signalEventId_label security_result.detection_fields Fusionné
signal_EventDetails_policyDetails_deletedTime_label security_result.detection_fields Fusionné
snippetContent_label security_result.detection_fields Fusionné
snippetLength_label security_result.detection_fields Fusionné
snippetStart_label security_result.detection_fields Fusionné
signalEventDetails_ruleId security_result.rule_id Mappage direct
signalEventDetails_ruleName security_result.rule_name Mappage direct
contentGroupDetails.contentGroupScope_label target.group.attribute.labels Fusionné
contentObjectDetails_contentGroupDetails_contentGroupTag_label target.group.attribute.labels Fusionné
contentGroupDetails_contentGroupName target.group.group_display_name Mappage direct
contentObjectDetails_contentPlatformId_label target.resource.attribute.labels Fusionné
contentObjectDetails_contentTime_label target.resource.attribute.labels Fusionné
contentObjectDetails_contentObjectId target.resource.product_object_id Mappage direct
contentObjectDetails_contentObjectType target.resource.resource_subtype Mappage direct
contentAuthorDetails_contentAuthorEmail target.user.email_addresses Fusionné
contentAuthorDetails_contentAuthorName target.user.user_display_name Mappage direct
contentAuthorDetails_contentAuthorId target.user.userid Mappage direct
N/A metadata.event_type Constante : NETWORK_CONNECTION
N/A metadata.product_name Constante : AWARE SIGNALS
N/A metadata.vendor_name Constante : AWARE SIGNALS

Journal des modifications

Afficher le journal des modifications de cet analyseur

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