Collecter les journaux Aware Signals
Version de l'analyseur : 1.0
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
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Sur la page suivante, cliquez sur Configurer un seul flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Aware Signal Events). - Sélectionnez Webhook comme type de source.
- Sélectionnez Signaux Aware comme Type de journal.
- Cliquez sur Suivant.
- 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
- Délimiteur de division : saisissez
- Cliquez sur Suivant.
- 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 :
- Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
- Une boîte de dialogue affiche la clé secrète.
- Copiez et enregistrez la clé secrète de manière sécurisée.
Obtenir l'URL du point de terminaison du flux
- Accédez à l'onglet Détails du flux.
- Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
Le format d'URL est le suivant :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importOù
{region}est la région de votre instance Google SecOps (par exemple,us,europeouasia-southeast1) et{parent}est le chemin d'accès à la ressource au formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Enregistrez cette URL pour les étapes suivantes.
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
- Accédez à la page Identifiants de la consoleGoogle Cloud .
- Sélectionnez votre projet (celui associé à votre instance Google SecOps).
- Cliquez sur Créer des identifiants > Clé API.
- Une clé API est créée et s'affiche dans une boîte de dialogue.
- Cliquez sur Modifier la clé API pour restreindre la clé.
Restreindre la clé API
- Sur la page des paramètres de la clé API :
- Nom : saisissez un nom descriptif (par exemple,
Chronicle Webhook API Key).
- Nom : saisissez un nom descriptif (par exemple,
- Sous Restrictions relatives aux API :
- Sélectionnez Restreindre la clé.
- Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps (ou API Chronicle).
- Cliquez sur Enregistrer.
- Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
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é :
- Connectez-vous à Aware sur https://aware.work avec un compte administrateur.
- Cliquez sur Paramètres système en bas à gauche.
- Accédez à l'onglet Intégrations.
Copiez la clé API affichée sur la page.
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.
- Connectez-vous à Aware sur https://aware.work avec un compte administrateur.
- Cliquez sur Paramètres système en bas à gauche.
- Accédez à l'onglet Intégrations.
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_KEYType 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-Keyet la valeur sur votre clé API Aware.
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
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.
- Créez une fonction Cloud Run (Python 3.12 ou version ultérieure) avec un déclencheur Pub/Sub.
- Configurez la fonction pour :
- Authentifiez-vous auprès de l'API Aware à l'aide de l'en-tête
X-Aware-Api-Key. - Interrogez les événements Signal à partir du point de terminaison de l'API Aware.
- Transférez chaque événement en tant que charge utile JSON vers l'URL du point de terminaison du webhook Google SecOps.
- Authentifiez-vous auprès de l'API Aware à l'aide de l'en-tête
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
- 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.
- Cliquez sur le flux Événements de signal Aware.
- Accédez à l'onglet État.
- Vérifiez que les événements sont bien reçus.
Vous pouvez également déclencher un événement Signal de test dans Aware :
- Dans Aware, accédez à Signal > Événements.
- Vérifiez que de nouveaux événements sont générés par vos règles.
- 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
\ndans 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 :
- 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.
- Cliquez sur votre flux d'événements de signaux Aware.
- Accédez à l'onglet État.
- Vérifiez si des erreurs d'ingestion se sont produites.
- Vérifiez que le type de journal est défini sur Signaux Aware.
- 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 :
- Vérifiez que la clé API Google SecOps est valide et qu'elle dispose de la restriction d'API appropriée.
- Vérifiez que la clé secrète correspond à celle générée lors de la création du flux.
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"}'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 :
- Réduisez le nombre de types d'événements transférés.
- Contactez l'assistance Aware pour configurer les limites de taille des charges utiles.
- 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.