Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Collecter les journaux Zix Email Encryption

Compatible avec :

Google SecOps SIEM

Ce document explique comment ingérer les journaux Zix Email Encryption dans Google Security Operations à l'aide de l'agent Bindplane.

Zix Email Encryption (désormais OpenText ZixEncrypt) est une plate-forme de chiffrement des e-mails et de protection contre la perte de données (DLP) qui permet de sécuriser les communications par e-mail et d'assurer la conformité. Il génère des journaux de transactions SMTP et des journaux d'événements de chiffrement sur l'appareil ZixGateway.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

Une instance Google SecOps
Windows Server 2016 ou version ultérieure, ou hôte Linux avec systemd
Connectivité réseau entre l'agent Bindplane et l'appliance Zix Email Encryption
Si vous exécutez l'agent derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts conformément aux exigences de l'agent BindPlane.
Accès privilégié à l'appliance de chiffrement des e-mails Zix (ZixGateway) avec des autorisations d'administrateur
Accès aux fichiers journaux de Zix Email Encryption (journaux des transactions SMTP, journaux des événements de chiffrement)

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.

Option 1 : Créer un compte de service pour l'API Chronicle (recommandé)

Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud associé à votre instance Google SecOps.
Accédez à IAM et administration > Comptes de service.
Cliquez sur Créer un compte de service.
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).
Cliquez sur Créer et continuer.
Dans la section Autoriser ce compte de service à accéder au projet, cliquez sur Sélectionner un rôle, puis sélectionnez Éditeur Chronicle.
Cliquez sur Continue (Continuer), puis sur Done (OK).
Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
Cliquez sur Ajouter une clé > Créer une clé.
Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
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.
Accédez à IAM et administration > Paramètres, puis copiez le numéro du projet. Vous en aurez besoin pour la configuration de l'exportateur.

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

Connectez-vous à la console Google SecOps.
Accédez à Paramètres SIEM> Agents de collecte.
Téléchargez le fichier d'authentification d'ingestion.
Enregistrez le fichier de manière sécurisée sur le système où l'agent BindPlane sera installé.

Obtenir l'ID client Google SecOps

Connectez-vous à la console Google SecOps.
Accédez à Paramètres SIEM > Profil.
Copiez et enregistrez le numéro client dans la section Détails de l'organisation.

Remarque : Le numéro client est requis pour configurer l'exportateur de l'agent BindPlane.

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

Ouvrez l'invite de commandes ou PowerShell en tant qu'administrateur.

Exécutez la commande suivante :

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

Attendez la fin de l'installation.
Vérifiez l'installation en exécutant la commande suivante :
```
sc query observiq-otel-collector
```
Le service doit s'afficher comme étant EN COURS D'EXÉCUTION.

Installation sous Linux

Ouvrez un terminal avec des droits d'accès racine ou sudo.

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

Attendez la fin de l'installation.
Vérifiez l'installation en exécutant la commande suivante :
```
sudo systemctl status observiq-otel-collector
```
Le service doit être indiqué comme actif (en cours d'exécution).

Autres ressources d'installation

Pour obtenir d'autres options d'installation et de dépannage, consultez le guide d'installation de l'agent Bindplane.

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

Localiser le fichier de configuration

Linux :

sudo nano /opt/observiq-otel-collector/config.yaml

Windows :

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

Modifiez le fichier de configuration

Remplacez l'intégralité du contenu de config.yaml par la configuration suivante :

receivers:
  filelog:
    include:
      - /var/log/zix/*.log
      - /opt/zix/logs/*.log
    start_at: beginning

exporters:
  chronicle/zix_email:
    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
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: '<customer_id>'
    endpoint: chronicle.googleapis.com
    log_type: ZIX_EMAIL_ENCRYPTION
    raw_log_field: body
    ingestion_labels:
      env: production

service:
  pipelines:
    logs/zix_to_chronicle:
      receivers:
        - filelog
      exporters:
        - chronicle/zix_email

Paramètres de configuration

Remplacez les espaces réservés suivants :

Configuration du récepteur :
- filelog : type de récepteur pour collecter les fichiers journaux à partir du disque.
- include : liste des chemins d'accès aux fichiers ou des formats glob à surveiller :
  - Linux : /var/log/zix/*.log ou /opt/zix/logs/*.log
  - Windows : C:\Program Files\Zix\logs\*.log
  - Ajustez le chemin d'accès pour qu'il corresponde à l'emplacement de votre fichier journal ZixGateway.
- start_at : définissez la valeur sur beginning pour lire les fichiers journaux existants depuis le début ou sur end pour ne lire que les nouvelles entrées.
Configuration de l'exportateur :
- zix_email : nom descriptif de l'exportateur
- creds_file_path : chemin d'accès complet au fichier de clé JSON du compte de service (option 1) :
  - Linux : /opt/observiq-otel-collector/ingestion-auth.json
  - Windows : C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- <customer_id> : ID client de l'étape précédente
- location : 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. Pour obtenir la liste complète, consultez Points de terminaison régionaux.
- project : remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.
- endpoint : laissez la valeur définie sur chronicle.googleapis.com.
- ZIX_EMAIL_ENCRYPTION : type de journal exactement tel qu'il apparaît dans Chronicle
- ingestion_labels : étiquettes facultatives au format YAML (par exemple, env: production)
Configuration du pipeline :
- zix_to_chronicle : nom descriptif du pipeline

Ancien exportateur d'API d'ingestion

Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc exporters par ce qui suit. 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/zix_email:
    compression: gzip
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: '<customer_id>'
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: ZIX_EMAIL_ENCRYPTION
    raw_log_field: body
    ingestion_labels:
      env: production
```

Enregistrez le fichier de configuration.

Après avoir modifié le fichier, enregistrez-le :
- Linux : appuyez sur Ctrl+O, puis sur Enter, puis sur Ctrl+X.
- Windows : cliquez sur Fichier > Enregistrer.

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

Pour redémarrer l'agent BindPlane sous Linux, exécutez la commande suivante :
```
sudo systemctl restart observiq-otel-collector
```
1. Vérifiez que le service est en cours d'exécution :
```
sudo systemctl status observiq-otel-collector
```
2. Recherchez les erreurs dans les journaux :
```
sudo journalctl -u observiq-otel-collector -f
```
Pour redémarrer l'agent Bindplane dans Windows, choisissez l'une des options suivantes :
- Invite de commande ou PowerShell en tant qu'administrateur :
```
  net stop observiq-otel-collector && net start observiq-otel-collector
```
- Console Services :
  1. Appuyez sur Win+R, saisissez services.msc, puis appuyez sur Entrée.
  2. Localisez observIQ OpenTelemetry Collector.
  3. Effectuez un clic droit, puis sélectionnez Redémarrer.
  4. Vérifiez que le service est en cours d'exécution :
```
  sc query observiq-otel-collector
```
  5. Recherchez les erreurs dans les journaux :
```
  type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

Configurer la collecte de journaux Zix Email Encryption

L'agent Bindplane collecte les fichiers journaux directement à partir du système de fichiers de l'appliance ZixGateway.

Vérifier les emplacements des fichiers journaux

Connectez-vous à la console de gestion ZixGateway.
Accédez à Surveillance > Journaux.
Vérifiez le répertoire des fichiers journaux :
- Linux : /var/log/zix/ ou /opt/zix/logs/
- Windows : C:\Program Files\Zix\logs\
Remarque : Consultez le guide d'administration de ZixGateway pour connaître le chemin d'accès au répertoire de journaux. Assurez-vous que l'agent Bindplane dispose d'un accès en lecture au répertoire des journaux.
Vérifiez que les journaux des transactions SMTP et les journaux des événements de chiffrement sont écrits à l'emplacement prévu.
Mettez à jour les chemins d'accès include dans l'agent Bindplane config.yaml si le répertoire des journaux diffère de celui par défaut.

Table de mappage UDM

Champ de journal	Mappage UDM	Logique
intermédiaire	intermédiaire	Fusionné à partir d'un intermédiaire
relay_host	intermediary.hostname	Valeur copiée directement à partir de relay_host
relay_ip	intermediary.ip	Fusionné à partir de relay_ip
relay_port	intermediary.port	Valeur de relay_port convertie en entier
message_details	metadata.description	Valeur copiée directement à partir de message_details dans les blocs smtp, smtpd, cleanup ou error
principal_hostname, sender_email	metadata.event_type	Définissez sur "EMAIL_TRANSACTION" si principal_hostname et sender_email ne sont pas vides, sinon sur "NETWORK_CONNECTION" si principal_hostname et (target_host ou target_ip) ne sont pas vides, sinon sur "STATUS_UPDATE" si principal_hostname n'est pas vide et (target_host ou target_ip) est vide, sinon sur "GENERIC_EVENT"
	metadata.product_name	Définissez sur "Zix Email Encryption".
	metadata.vendor_name	Définissez-le sur "Zix".
message	network.application_protocol	Définissez sur "SMTP" si le message correspond à smtp ou smtpd.
sender_email	network.email.from	Valeur copiée directement si sender_email correspond à l'expression régulière d'adresse e-mail
subject	network.email.subject	Fusionné à partir du sujet
recipient_email	network.email.to	Fusionné à partir de recipient_email s'il correspond à l'expression régulière d'adresse e-mail
data_size	network.received_bytes	Valeur de data_size convertie en uinteger
tls_cipher	network.tls.cipher	Valeur copiée directement depuis tls_cipher
cert_data	network.tls.client.certificate.issuer	Valeur copiée directement depuis cert_data
daemon	principal.application	Valeur copiée directement à partir du daemon
principal_hostname	principal.hostname	Valeur copiée directement à partir de principal_hostname
fichier	principal.process.file.full_path	Valeur copiée directement à partir du fichier
pid	principal.process.pid	Valeur copiée directement à partir de pid
	principal.resource.type	Définie sur "CLEANUP_MESSAGE_ID" si le daemon est un daemon de nettoyage
sender_email	principal.user.user_display_name	Valeur copiée directement si sender_email ne correspond pas à l'expression régulière d'adresse e-mail
user_id	principal.user.userid	Valeur de user_id si elle n'est pas vide, sinon valeur de user_id dans le bloc "else"
security_result	security_result	Fusionné à partir de security_result
security_action	security_result.action	Fusionné depuis security_action
failure_reason	security_result.description	Valeur copiée directement à partir de failure_reason
security_summary	security_result.summary	Valeur copiée directement à partir de security_summary
fichier	target.file.full_path	Valeur copiée directement à partir du fichier
target_host	target.hostname	Valeur copiée directement à partir de target_host
target_ip	target.ip	Fusionné à partir de target_ip
target_port	target.port	Valeur de target_port convertie en entier
message_id	target.resource.name	Valeur copiée directement à partir de message_id
recipient_email	target.user.user_display_name	Valeur copiée directement si recipient_email ne correspond pas à l'expression régulière de l'adresse e-mail

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.