Collecter les journaux de la base de données Teradata

Compatible avec :

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

Teradata Database est une plate-forme d'entrepôt de données d'entreprise qui génère des journaux de requêtes, d'accès, d'audit de sécurité et d'événements système. Il fournit des analyses et une gestion des données hautes performances pour les déploiements à grande échelle sur site.

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 le serveur Teradata Database
  • 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é au système de base de données Teradata avec des autorisations d'administrateur

Obtenir le fichier d'authentification d'ingestion Google SecOps

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

Obtenir l'ID client Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres du SIEM > Profil.
  3. Copiez et enregistrez le numéro client dans la section Informations sur 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 commandes 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
    
  3. Attendez la fin de l'installation.

  4. Vérifiez l'installation en exécutant la commande suivante :

    sc query observiq-otel-collector
    

Le service doit être indiqué comme RUNNING (EN COURS D'EXÉCUTION).

Installation de Linux

  1. Ouvrez un terminal avec des privilèges root 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
    
  3. Attendez la fin de l'installation.

  4. 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 /etc/bindplane-agent/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:
        tcplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/teradata_db:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: TERADATA_DB
            raw_log_field: body
    
    service:
        pipelines:
            logs/teradata_db_to_chronicle:
                receivers:
                    - tcplog
                exporters:
                    - chronicle/teradata_db
    

Paramètres de configuration

Remplacez les espaces réservés suivants :

  • Configuration du récepteur :

    • listen_address : adresse IP et port à écouter :
      • 0.0.0.0 pour écouter sur toutes les interfaces (recommandé)
      • Le port 514 est le port syslog standard (nécessite la racine sur Linux ; utilisez 1514 pour les utilisateurs non racine).
  • Configuration de l'exportateur :

    • creds_file_path : chemin d'accès complet au fichier d'authentification de l'ingestion :
      • Linux : /etc/bindplane-agent/ingestion-auth.json
      • Windows : C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id : ID client copié depuis la console Google SecOps
    • endpoint : URL du point de terminaison régional :
      • États-Unis : malachiteingestion-pa.googleapis.com
      • Europe : europe-malachiteingestion-pa.googleapis.com
      • Asie : asia-southeast1-malachiteingestion-pa.googleapis.com
      • Pour obtenir la liste complète, consultez Points de terminaison régionaux.

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 :

  1. Exécutez la commande suivante :

    sudo systemctl restart observiq-otel-collector
    
  2. Vérifiez que le service est en cours d'exécution :

    sudo systemctl status observiq-otel-collector
    
  3. Recherchez les erreurs dans les journaux :

    sudo journalctl -u observiq-otel-collector -f
    

Pour redémarrer l'agent Bindplane sous Windows :

  1. 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.
  2. Vérifiez que le service est en cours d'exécution :

    sc query observiq-otel-collector
    
  3. Recherchez les erreurs dans les journaux :

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

Configurer le transfert syslog de la base de données Teradata

  1. Connectez-vous au serveur Teradata Database en tant qu'administrateur.
  2. Configurez le transfert syslog à l'aide de la fonctionnalité de journalisation de la passerelle Teradata Database. Modifiez le fichier de configuration rsyslog :

    sudo nano /etc/rsyslog.d/teradata.conf
    
  3. Ajoutez les lignes suivantes pour transférer les journaux Teradata vers l'agent Bindplane :

    # Forward Teradata Database logs to Bindplane agent
    if $programname == 'teradata' then @@<bindplane-ip>:514
    
    • Remplacez <bindplane-ip> par l'adresse IP de l'hôte de l'agent Bindplane.
  4. Redémarrez le service rsyslog :

    sudo systemctl restart rsyslog
    
  5. Vérifiez que les journaux sont envoyés en consultant les journaux de l'agent Bindplane.

Table de mappage UDM

Champ de journal Mappage UDM Logique
additional.fields Fusionné à partir de différents libellés tels que collect_timestamp_label, logon_date_time_label, logon_source_label, protocol_label, remote_hostname_label, logon_details_label, port_label, connection_id_label, cid_label, jdbc_driver_info_label, request_mode_label, statement_group_label, statement_type_label
app_id target.asset.product_object_id Valeur copiée directement
client_addr principal.asset.hostname, principal.asset.ip, principal.hostname, principal.ip Valeur copiée directement dans tous les
client_id target.asset.asset_id Concaténé sous la forme CLIENT_ID:%{client_id}
collect_timestamp metadata.collected_timestamp Converti à l'aide de la correspondance de date avec les formats RFC 3339, UNIX_MS, UNIX, ISO8601, yyyy-MM-dd HH:mm:ss
default_database target.resource.name, target.resource.resource_type Valeur copiée directement dans le nom ; définie sur DATABASE pour resource_type
error_code network.http.response_code, additional.fields Converti en entier pour response_code ; copié dans error_code_label et fusionné dans additional.fields
error_text security_result.summary Valeur copiée directement
host_name principal.asset.hostname, principal.hostname Valeur copiée directement dans les deux
logon_date_time metadata.event_timestamp Converti à l'aide de la correspondance de date avec les formats ISO8601, aaaa-MM-jj HH:mm:ss
logon_source target.resource.parent Valeur copiée directement
logon_source additional.fields Extrait logonSource à l'aide de grok, puis défini sur %{logonSource}LSS dans logon_source_label fusionné dans additional.fields
logon_source additional.fields Protocole, remote_hostname, port, logon_details, connection_id, cid et jdbc_driver_info extraits à l'aide de grok, puis définis dans les libellés respectifs fusionnés dans additional.fields
proc_id target.resource.id Valeur copiée directement
profile_name target.resource.attribute.labels "Set in profile_name_label" fusionné dans attribute.labels
query_text target.process.command_line Valeur copiée directement
request_mode target.resource.resource_subtype, additional.fields Valeur copiée directement dans resource_subtype ; définie dans request_mode_label fusionnée dans additional.fields
session_id network.session_id Valeur copiée directement
statement_group principal.user.groupid, additional.fields Valeur copiée directement dans groupid ; définie dans statement_group_label fusionnée dans additional.fields
statement_type security_result.about.labels, additional.fields "statementtype_value_label" fusionné dans "about.labels" ; "statement_type_label" fusionné dans "additional.fields"
ts metadata.event_timestamp Converti à l'aide de la correspondance de date avec les formats MMM d HH:mm:ss, MMM dd HH:mm:ss, SYSLOGTIMESTAMP, RFC 3339, UNIX, ISO8601, UNIX_MS
tt_granularity target.resource.product_object_id Valeur copiée directement
user_id principal.user.userid Valeur copiée directement
user_name principal.user.user_display_name Valeur copiée directement
metadata.event_type Défini sur USER_RESOURCE_ACCESS si has_principal, has_principal_user et has_target_resource sont définis sur "true". Sinon, défini sur STATUS_UPDATE si has_principal est défini sur "true". Sinon, défini sur GENERIC_EVENT.
metadata.product_name Définissez-le sur "TERADATA_DB".
metadata.vendor_name Définie sur "TERADATA"
profile_name event.idm.read_only_udm.target.resource.attribute.labels Mappé à partir du journal des modifications
proc_id event.idm.read_only_udm.target.resource.id Mappé à partir du journal des modifications
user_id event.idm.read_only_udm.principal.user.userid Mappé à partir du journal des modifications
collect_timestamp event.idm.read_only_udm.metadata.collected_timestamp Mappé à partir du journal des modifications
logon_date_time event.idm.read_only_udm.metadata.event_timestamp Mappé à partir du journal des modifications
user_name event.idm.read_only_udm.principal.user.user_display_name Mappé à partir du journal des modifications
logon_source event.idm.read_only_udm.target.resource.parent Mappé à partir du journal des modifications
app_id event.idm.read_only_udm.target.asset.product_object_id Mappé à partir du journal des modifications
client_id event.idm.read_only_udm.target.asset.asset_id Mappé à partir du journal des modifications
error_code event.idm.read_only_udm.network.http.response_code Mappé à partir du journal des modifications
statement_type event.idm.read_only_udm.security_result.about.labels Mappé à partir du journal des modifications
statement_group event.idm.read_only_udm.principal.user.groupid Mappé à partir du journal des modifications
request_mode event.idm.read_only_udm.target.resource.resource_subtype Mappé à partir du journal des modifications
tt_granularity event.idm.read_only_udm.target.resource.product_object_id Mappé à partir du journal des modifications
protocol event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
remote_hostname event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
logon_details event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
connection_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
port event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cid event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
jdbc_driver_info event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
app_id principal.application Mappé à partir du journal des modifications
collect_timestamp event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
error_code security_result.detection_fields Mappé à partir du journal des modifications
logon_date_time event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
logon_source event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
proc_id principal.process.pid Mappé à partir du journal des modifications
request_mode event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
statement_group event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
statement_type event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
user_id target.user.userid Mappé à partir du journal des modifications
user_name target.user.user_display_name Mappé à partir du journal des modifications

Journal des modifications

Afficher le journal des modifications pour ce parseur

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