Collecter les journaux Imperva Data Risk Analytics (DRA)

Compatible avec :

Ce document explique comment ingérer des journaux Imperva DRA dans Google Security Operations à l'aide de l'agent Bindplane.

L'analyseur extrait les champs des journaux au format syslog d'Imperva Data Risk Analytics. Il utilise grok et/ou kv pour analyser le message de journal, puis mappe ces valeurs au modèle de données unifié (UDM). Il définit également les valeurs de métadonnées par défaut pour la source et le type d'événement. Imperva DRA permet de détecter les activités suspectes liées aux données et de hiérarchiser les incidents critiques parmi des milliards d'événements d'audit.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un hôte Windows 2016 ou version ultérieure, ou Linux avec systemd
  • Si vous exécutez l'agent derrière un proxy, assurez-vous que les ports de pare-feu sont ouverts conformément aux exigences de l'agent BindPlane.
  • Accès privilégié à la console de gestion Imperva DRA

Obtenir des identifiants Google SecOps pour l'agent BindPlane

Pour authentifier l'agent Bindplane auprès de Google SecOps, choisissez l'une des méthodes suivantes :

  • Nouveaux déploiements : utilisez l'API Chronicle (option 1).
  • Anciens déploiements : continuez à utiliser le fichier d'authentification d'ingestion (option 2) jusqu'à l'arrêt de l'API Ingestion le 20 juillet 2027.
  1. Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud associé à votre instance Google SecOps.
  2. Accédez à IAM et administration > Comptes de service.
  3. Cliquez sur Créer un compte de service.
  4. Fournissez les informations de configuration suivantes :
    • Nom du compte de service : saisissez un nom pour le compte (par exemple, bindplane-ingest).
    • Description du compte de service : saisissez une description (par exemple, Bindplane agent log ingestion).
  5. Cliquez sur Créer et continuer.
  6. Dans la section Autoriser ce compte de service à accéder au projet, cliquez sur Sélectionner un rôle, puis sélectionnez Éditeur Chronicle.
  7. Cliquez sur Continue (Continuer), puis sur Done (OK).
  8. Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
  9. Cliquez sur Ajouter une clé > Créer une clé.
  10. Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
  11. Enregistrez le fichier de clé sous le nom ingestion-auth.json dans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.json sous Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json sous Windows), ou mettez à jour creds_file_path dans config.yaml pour qu'il corresponde au chemin d'accès où vous l'enregistrez.
  12. Accédez à IAM et administration > Paramètres, puis copiez le numéro du projet. Vous en aurez besoin pour configurer l'exportateur.

Option 2 : Télécharger le fichier d'authentification d'ingestion (ancien)

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres > Gestion des données > Agents de collecte. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Agents de collecte.
  3. Téléchargez le fichier d'authentification d'ingestion.
  4. Enregistrez le fichier de manière sécurisée sur le système où l'agent BindPlane sera installé.

Obtenir le numéro client Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres > Administration > Profil. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Profil.
  3. Copiez et enregistrez le numéro client de la section Détails de l'organisation.

Installer l'agent BindPlane

Installez l'agent BindPlane sur votre système d'exploitation Windows ou Linux en suivant les instructions ci-dessous.

Installation de Windows

  1. Ouvrez l'invite de commande ou PowerShell en tant qu'administrateur.
  2. Exécutez la commande suivante :

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Installation sous Linux

  1. Ouvrez un terminal avec des droits d'accès racine ou sudo.
  2. Exécutez la commande suivante :

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

Ressources d'installation supplémentaires

Pour connaître les autres options d'installation, consultez le guide d'installation de l'agent BindPlane.

Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps

  1. Accédez au fichier de configuration :

    • Trouvez le fichier config.yaml. En général, il se trouve dans le répertoire /opt/observiq-otel-collector/ sous Linux ou dans le répertoire d'installation sous Windows.
    • Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple, nano, vi ou Notepad).
  2. Modifiez le fichier config.yaml comme suit :

    receivers:
      udplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/chronicle_w_labels:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <CUSTOMER_ID>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'IMPERVA_DRA'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
    • Remplacez le port et l'adresse IP selon les besoins de votre infrastructure.
    • Remplacez <LOCATION> par la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1). L'exportateur ajoute cette valeur en préfixe à chronicle.googleapis.com.
    • Remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.
    • Remplacez <CUSTOMER_ID> par le numéro client réel.
    • Remplacez /path/to/ingestion-authentication-file.json par le chemin d'accès au fichier de clé du compte de service (option 1) enregistré à l'étape 1.

Ancien exportateur d'API d'ingestion

  • Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc exporters par le code suivant. Définissez creds_file_path sur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacez malachiteingestion-pa.googleapis.com par votre point de terminaison régional (par exemple, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <CUSTOMER_ID>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'IMPERVA_DRA'
        raw_log_field: body
        ingestion_labels:
    

Redémarrez l'agent BindPlane pour appliquer les modifications.

  1. Pour redémarrer l'agent BindPlane sous Linux, exécutez la commande suivante :

    sudo systemctl restart observiq-otel-collector
    
  2. Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :

    net stop observiq-otel-collector && net start observiq-otel-collector
    

Configurer le transfert Syslog sur Imperva DRA

  1. Connectez-vous à la console de gestion Imperva DRA.
  2. Accédez à Configuration > Intégration SIEM.
  3. Dans la section Serveur Syslog, fournissez les informations de configuration suivantes :

    • Adresse IP du serveur : saisissez l'adresse IP de l'agent BindPlane.
    • Port : saisissez le numéro de port de l'agent BindPlane (514 par défaut).
    • Protocole : sélectionnez UDP ou TCP, selon la configuration de votre agent Bindplane.
    • Facility (Fonction) : sélectionnez la fonction syslog appropriée (par exemple, LOCAL0).
  4. Cliquez sur Envoyer un message Syslog de test pour vérifier la connectivité.

  5. Dans la section Événements à envoyer, configurez les éléments suivants :

    • Classes d'événements : sélectionnez Détection des violations et/ou Réduction des risques en fonction de vos besoins.
    • Types de notifications : choisissez les actions d'ouverture, de fermeture et de réouverture d'incident, ainsi que leurs niveaux de gravité.
    • Format du message : sélectionnez JSON pour le format de données structurées ou Brut pour le format syslog de base.
  6. Configurez le seuil de gravité pour déterminer les niveaux de gravité à transférer.

  7. Enregistrez la configuration.

Table de mappage UDM

Champ du journal Mappage UDM Logique
category_label additional.fields Fusionné
clusterMemberNames_label additional.fields Fusionné
clusterNames_label additional.fields Fusionné
clusterNames_list additional.fields Fusionné
dbName_list additional.fields Fusionné
dbUser_list additional.fields Fusionné
destHostname_list additional.fields Fusionné
dstips_label additional.fields Fusionné
fileExtension_list additional.fields Fusionné
folder_list additional.fields Fusionné
numOfAccessedObjects_label additional.fields Fusionné
severity additional.fields Mappé : (?i)test-severity → severity_label
severity_label additional.fields Fusionné
sourceApps_list additional.fields Fusionné
srcApp_list additional.fields Fusionné
srcHostname_list additional.fields Fusionné
srcUser_list additional.fields Fusionné
suspiciousCommand_list additional.fields Fusionné
tableName_list additional.fields Fusionné
userAction_label additional.fields Fusionné
hostname intermediary.hostname Mappage direct
msg metadata.description Mappage direct
event_timestamp metadata.event_timestamp Analysé en tant que MMM dd HH:mm:ss
firstIncidentTime metadata.event_timestamp Analysé en tant que UNIX_MS
lastIncidentTime metadata.event_timestamp Analysé en tant que UNIX_MS
securityEventTimestamp metadata.event_timestamp Analysé en tant que UNIX
has_principal metadata.event_type Mappé : true → RESOURCE_CREATION, true → USER_UNCATEGORIZED, true → `NETWORK_CONNE...
type metadata.product_event_type Mappage direct
data.id metadata.product_log_id Mappage direct
id metadata.product_log_id Mappage direct
sapp principal.application Mappage direct
sourceApps principal.application Mappage direct
srcApp principal.application Mappage direct
shost principal.asset.hostname Mappage direct
srcHosts principal.asset.hostname Mappage direct
pri_ip principal.asset.ip Fusionné
src principal.asset.ip Fusionné
srcIp principal.asset.ip Fusionné
src_ip principal.asset.ip Fusionné
src_ips principal.asset.ip Fusionné
shost principal.hostname Mappage direct
srcHosts principal.hostname Mappage direct
pri_ip principal.ip Fusionné
src principal.ip Fusionné
srcIp principal.ip Fusionné
src_ip principal.ip Fusionné
src_ips principal.ip Fusionné
editUser principal.user.userid Mappage direct
srcUser principal.user.userid Mappage direct
srcUsers principal.user.userid Mappage direct
suser principal.user.userid Mappage direct
server_sec_res security_result Fusionné
user_sec_res security_result Fusionné
actionType security_result.action_details Mappage direct
data.ruleComment security_result.description Mappage direct
msg security_result.description Mappage direct
act_label security_result.detection_fields Fusionné
action_label security_result.detection_fields Fusionné
cat_label security_result.detection_fields Fusionné
dateEdited_label security_result.detection_fields Fusionné
firstIncidentTime_label security_result.detection_fields Fusionné
incidents_label security_result.detection_fields Fusionné
lastIncidentTime_label security_result.detection_fields Fusionné
num_of_Incidents_label security_result.detection_fields Fusionné
data.ruleName security_result.rule_name Mappage direct
severity security_result.severity Valeurs mappées (5 au total, par exemple (?i)Low → LOW, (?i)Medium → MEDIUM, (?i)High → HIGH)
severityScore security_result.severity_details Renommé/Mappé
srcHost src.asset.hostname Mappage direct
srcHost src.asset.ip Mappé : ^(?:[0-9]{1,3}[.]){3}[0-9]{1,3}$ → srcHost
srcHost src.hostname Mappage direct
srcHost src.ip Mappé : ^(?:[0-9]{1,3}[.]){3}[0-9]{1,3}$ → srcHost
dhost target.asset.hostname Mappage direct
dstHost target.asset.hostname Mappage direct
dstHosts target.asset.hostname Mappage direct
dest_ip target.asset.ip Fusionné
dst target.asset.ip Mappé : ^(?:[0-9]{1,3}[.]){3}[0-9]{1,3}$ → dst
dst_ip target.asset.ip Fusionné
dst_ips target.asset.ip Fusionné
tar_ip target.asset.ip Fusionné
dhost target.hostname Mappage direct
dstHost target.hostname Mappage direct
dstHosts target.hostname Mappage direct
dest_ip target.ip Fusionné
dst target.ip Mappé : ^(?:[0-9]{1,3}[.]){3}[0-9]{1,3}$ → dst
dst_ip target.ip Fusionné
dst_ips target.ip Fusionné
tar_ip target.ip Fusionné
clusterName target.resource.name Mappage direct
dest target.resource.name Mappage direct
destination target.resource.name Mappage direct
server.dbName target.resource.name Mappage direct
destinationType target.resource.resource_subtype Mappage direct
dstType target.resource.resource_subtype Mappage direct
server.dbType target.resource.resource_subtype Mappage direct
accessedTables target.resource.type Mappage direct
url target.url Mappage direct
acct target.user.userid Mappage direct
destinationAccount target.user.userid Mappage direct
server.dbUser target.user.userid Mappage direct
N/A metadata.event_type Constante : RESOURCE_CREATION
N/A metadata.product_name Constante : Data Risk Analytics
N/A metadata.vendor_name Constante : IMPERVA
N/A security_result.severity Constante : LOW
client_ip event.idm.read_only_udm.principal.ip et event.idm.read_only_udm.principal.asset.ip Mappé à partir du journal des modifications
source_ip event.idm.read_only_udm.principal.ip et event.idm.read_only_udm.principal.asset.ip Mappé à partir du journal des modifications
action_id event.idm.read_only_udm.security_result.rule_id Mappé à partir du journal des modifications
client_port event.idm.read_only_udm.principal.port Mappé à partir du journal des modifications
destination_ip event.idm.read_only_udm.target.ip et event.idm.read_only_udm.target.asset.ip Mappé à partir du journal des modifications
destination_port event.idm.read_only_udm.target.port Mappé à partir du journal des modifications
distinguished_name_device_id event.idm.read_only_udm.principal.asset.asset_id Mappé à partir du journal des modifications
distinguished_name event.idm.read_only_udm.principal.user.group_identifiers Mappé à partir du journal des modifications
distinguished_name_ou event.idm.read_only_udm.principal.user.group_identifiers Mappé à partir du journal des modifications
distinguished_name_user event.idm.read_only_udm.principal.user.email_addresses Mappé à partir du journal des modifications
rule_name event.idm.read_only_udm.security_result.rule_name Mappé à partir du journal des modifications
id event.idm.read_only_udm.metadata.product_log_id Mappé à partir du journal des modifications
packet_size event.idm.read_only_udm.network.sent_bytes Mappé à partir du journal des modifications
version event.idm.read_only_udm.metadata.product_version Mappé à partir du journal des modifications
collective_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
collective_name event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
connection_type event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
entitlement_token_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
json_wrapper.appname event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
json_wrapper.facility event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
start event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
json_wrapper.priority event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
rule_subnet event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.src.ip Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.src.asset.ip Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.src.hostname Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.src.asset.hostname Mappé à partir du journal des modifications
dstHosts event.idm.read_only_udm.target.asset.hostname Mappé à partir du journal des modifications
srcUsers event.idm.read_only_udm.principal.user.userid Mappé à partir du journal des modifications
srcIps event.idm.read_only_udm.principal.ip Mappé à partir du journal des modifications
srcIps event.idm.read_only_udm.principal.asset.ip Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.principal.hostname Mappé à partir du journal des modifications
srcHosts event.idm.read_only_udm.principal.asset.hostname Mappé à partir du journal des modifications
sourceApps event.idm.read_only_udm.principal.application Mappé à partir du journal des modifications
dstIps event.idm.read_only_udm.target.ip Mappé à partir du journal des modifications
dstIps event.idm.read_only_udm.target.asset.ip Mappé à partir du journal des modifications
dstHosts event.idm.read_only_udm.target.hostname Mappé à partir du journal des modifications
destinationAccount event.idm.read_only_udm.target.user.userid Mappé à partir du journal des modifications
destination event.idm.read_only_udm.target.resource.name Mappé à partir du journal des modifications
destinationType event.idm.read_only_udm.target.resource.resource_subtype Mappé à partir du journal des modifications
accessedTables event.idm.read_only_udm.target.resource.type Mappé à partir du journal des modifications
securityEventTimestamp event.idm.read_only_udm.metadata.event_timestamp Mappé à partir du journal des modifications
actionType event.idm.read_only_udm.security_result.action_details Mappé à partir du journal des modifications
severity event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
numOfAccessedObjects event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
userAction event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
clusterNames event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications

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.