Raccogliere i log di Veridium ID

Supportato in:

Questo documento spiega come importare i log di Veridium ID in Google Security Operations utilizzando Bindplane. Il parser estrae innanzitutto i campi dai messaggi syslog e li classifica in base a "log_identifier". Poi, utilizza la logica condizionale e l'analisi chiave-valore per mappare i campi estratti in una struttura Unified modello dei dati (UDM), gestendo sia i formati ActionLog che EventLog.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Istanza Google SecOps
  • Windows 2016 o versioni successive o un host Linux con systemd
  • Se l'esecuzione avviene tramite un proxy, assicurati che le porte del firewall siano aperte.
  • Accesso privilegiato a Veridium ID

Recuperare il file di autenticazione importazione di Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Agenti di raccolta.
  3. Scarica il file di autenticazione importazione. Salva il file in modo sicuro sul sistema in cui verrà installato Bindplane.

Recuperare l'ID cliente Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Profilo.
  3. Copia e salva l'ID cliente dalla sezione Dettagli dell'organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.

Installazione di Windows

  1. Apri il prompt dei comandi o PowerShell come amministratore.
  2. Esegui questo comando:

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

Installazione di Linux

  1. Apri un terminale con privilegi root o sudo.
  2. Esegui questo comando:

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

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione, consulta la guida all'installazione.

Configura l'agente Bindplane per importare Syslog e inviarli a Google SecOps

  1. Accedi al file di configurazione:
    • Individua il file config.yaml. In genere, si trova nella directory /etc/bindplane-agent/ su Linux o nella directory di installazione su Windows.
    • Apri il file utilizzando un editor di testo (ad esempio nano, vi o Blocco note).
  2. Modifica il file config.yaml come segue:

    receivers:
        udplog:
            # Replace the port and IP address as required
            listen_address: "0.0.0.0:514"
    
    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: 'VERIDIUM_ID'
            raw_log_field: body
            ingestion_labels:
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    

Riavvia l'agente Bindplane per applicare le modifiche

  • Per riavviare l'agente Bindplane in Linux, esegui questo comando:

    sudo systemctl restart bindplane-agent
    
  • Per riavviare l'agente Bindplane in Windows, puoi utilizzare la console Servizi o inserire il seguente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura Syslog per Veridium ID

  1. Accedi all'host Veridium ID utilizzando SSH o la CLI.
  2. Modifica il file /etc/rsyslog.conf o /etc/rsyslog.d/events.conf utilizzando VI.

    vi /etc/rsyslog.conf
    
  3. Inserisci i seguenti dettagli, sostituendo <bindplane-ip> e <bindplane-port> con i dettagli effettivi dell'agente Bindplane.

    module(load="imfile" PollingInterval="10")
    input(type="imfile" File="/var/log/veridiumid/websecadmin/events.log" Tag="ver-adminevents" reopenOnTruncate="on")
    input(type="imfile" File="/var/log/veridiumid/tomcat/events.log" Tag="ver-events" reopenOnTruncate="on")
    
    if $programname == 'ver-events' then @@<bindplane-ip>:<bindplane-port>
    if $programname == 'ver-adminevents' then @@<bindplane-ip>:<bindplane-port>
    
  4. Salva il file ed esci da VI.

Tabella di mappatura UDM

Campo log Mappatura UDM Logic
_caller.accountId principal.user.userid Mappato direttamente dal campo _caller.accountId.
_caller.accountEmailAddressInfo principal.user.email_addresses Mappato direttamente dal campo _caller.accountEmailAddressInfo.
_caller.accountExternalId principal.user.email_addresses Mappato direttamente dal campo _caller.accountExternalId.
_caller.accountStatus principal.user.attribute.labels[account_status].value Mappato direttamente dal campo _caller.accountStatus.
_caller.deviceId principal.asset.asset_id Con il prefisso "VERIDIUM_ID:" e mappato dal campo _caller.deviceId.
_caller.deviceDescription principal.asset.attribute.labels[device_description].value Mappato direttamente dal campo _caller.deviceDescription.
_caller.deviceManufacturer principal.asset.attribute.labels[device_manufacturer].value Mappato direttamente dal campo _caller.deviceManufacturer.
_caller.deviceName principal.asset.attribute.labels[device_name].value Mappato direttamente dal campo _caller.deviceName.
_caller.deviceOs principal.asset.platform_software.platform Mappato dal campo _caller.deviceOs. Se il valore è "iOS", viene mappato a "IOS". Se il valore è "Android", viene mappato su "ANDROID". Se il valore è "WIN" o "Windows", viene mappato a "WINDOWS".
_caller.deviceStatus principal.asset.attribute.labels[device_status].value Mappato direttamente dal campo _caller.deviceStatus.
_caller.deviceType principal.asset.attribute.labels[device_type].value Mappato direttamente dal campo _caller.deviceType.
actionDate additional.fields[action_date].value.string_value Mappato direttamente dal campo actionDate.
actionName metadata.product_event_type Mappato direttamente dal campo actionName.
accountEmail principal.user.email_addresses Mappato direttamente dal campo accountEmail.
accountExternalId principal.user.email_addresses Mappato direttamente dal campo accountExternalId.
accountId principal.user.userid Mappato direttamente dal campo accountId.
authenticatorDeviceContext.deviceMake intermediary.asset.hardware.manufacturer Mappato direttamente dal campo authenticatorDeviceContext.deviceMake.
authenticatorDeviceContext.ip intermediary.ip Mappato direttamente dal campo authenticatorDeviceContext.ip.
authenticatorDeviceContext.location.city intermediary.asset.location.city Mappato direttamente dal campo authenticatorDeviceContext.location.coordinates.latitude.
authenticatorDeviceContext.location.coordinates.latitude intermediary.asset.location.region_latitude Mappato direttamente dal campo authenticatorDeviceContext.location.coordinates.latitude.
authenticatorDeviceContext.location.coordinates.longitude intermediary.asset.location.region_longitude Mappato direttamente dal campo authenticatorDeviceContext.location.coordinates.longitude.
authenticatorDeviceContext.location.countryName intermediary.asset.location.country_or_region Mappato direttamente dal campo authenticatorDeviceContext.location.countryName.
authenticatorDeviceContext.location.ip intermediary.ip Mappato direttamente dal campo authenticatorDeviceContext.location.ip.
authenticationDeviceDescription intermediary.asset.attribute.labels[authentication_device_description].value Mappato direttamente dal campo authenticationDeviceDescription.
authenticationDeviceName intermediary.asset.asset_id Con il prefisso "VERIDIUM_ID:" e mappato dal campo authenticationDeviceName.
authenticationDeviceOs intermediary.asset.platform_software.platform Mappato dal campo authenticationDeviceOs. Se il valore è "iOS", viene mappato a "IOS". Se il valore è "Android", viene mappato su "ANDROID". Se il valore è "WIN" o "Windows", viene mappato a "WINDOWS".
authenticationDeviceOsVersion intermediary.asset.platform_software.platform_version Mappato direttamente dal campo authenticationDeviceOsVersion.
authenticationDevicePhone intermediary.asset.attribute.labels[authentication_device_phone].value Mappato direttamente dal campo authenticationDevicePhone.
authenticationDevicePhoneModel intermediary.asset.attribute.labels[authentication_device_phone_model].value Mappato direttamente dal campo authenticationDevicePhoneModel.
authenticationDeviceRegistrationTime intermediary.asset.attribute.labels[authentication_device_registeration_time].value Mappato direttamente dal campo authenticationDeviceRegistrationTime.
authenticationDeviceType intermediary.asset.attribute.labels[authentication_device_type].value Mappato direttamente dal campo authenticationDeviceType.
authenticationResult extensions.auth.auth_details Mappato direttamente dal campo authenticationResult.
context.deviceMake principal.asset.hardware.manufacturer Mappato direttamente dal campo context.deviceMake.
context.ip principal.ip Mappato direttamente dal campo context.ip.
context.location.countryName principal.location.country_or_region Mappato direttamente dal campo context.location.countryName.
context.location.ip principal.ip Mappato direttamente dal campo context.location.ip.
context.osVersion principal.asset.platform_software.platform_version Mappato direttamente dal campo context.osVersion.
context.userAgentRaw network.http.user_agent Mappato direttamente dal campo context.userAgentRaw.
exploiterDeviceContext.deviceMake src.asset.hardware.manufacturer Mappato direttamente dal campo exploiterDeviceContext.deviceMake.
exploiterDeviceContext.ip src.ip Mappato direttamente dal campo exploiterDeviceContext.ip.
exploiterDeviceContext.location.city src.asset.location.city Mappato direttamente dal campo exploiterDeviceContext.location.city.
exploiterDeviceContext.location.coordinates.latitude src.asset.location.region_latitude Mappato direttamente dal campo exploiterDeviceContext.location.coordinates.latitude.
exploiterDeviceContext.location.coordinates.longitude src.asset.location.region_longitude Mappato direttamente dal campo exploiterDeviceContext.location.coordinates.longitude.
exploiterDeviceContext.location.countryName src.asset.location.country_or_region Mappato direttamente dal campo exploiterDeviceContext.location.countryName.
exploiterDeviceContext.location.ip src.ip Mappato direttamente dal campo exploiterDeviceContext.location.ip.
exploiterDeviceContext.osName src.asset.platform_software.platform Mappato dal campo exploiterDeviceContext.osName. Se il valore è "WIN" o "Windows", viene mappato a "WINDOWS". Se il valore è "iOS", viene mappato a "IOS". Se il valore è "Android", viene mappato su "ANDROID".
exploiterDeviceContext.osVersion src.asset.platform_software.platform_version Mappato direttamente dal campo exploiterDeviceContext.osVersion.
exploiterDeviceName src.asset.attribute.labels[exploiter_device_name].value Mappato direttamente dal campo exploiterDeviceName.
hostname principal.hostname Mappato direttamente dal campo hostname.
ipAddress principal.ip Mappato direttamente dal campo ipAddress.
location principal.location.city Mappato direttamente dal campo location.
location.city about.location.city Mappato direttamente dal campo location.city.
location.coordinates.latitude about.location.region_latitude Mappato direttamente dal campo location.coordinates.latitude.
location.coordinates.longitude about.location.region_longitude Mappato direttamente dal campo location.coordinates.longitude.
location.countryName about.location.country_or_region Mappato direttamente dal campo location.countryName.
location.ip about.ip Mappato direttamente dal campo location.ip.
metadata.collected_timestamp metadata.collected_timestamp Mappato direttamente dal campo collected_time.
metadata.event_timestamp metadata.event_timestamp Mappato direttamente dal campo event_time.
metadata.event_type metadata.event_type Imposta il valore su "USER_UNCATEGORIZED".
metadata.product_event_type metadata.product_event_type Mappato direttamente dal campo actionName.
metadata.product_name metadata.product_name Imposta su "VERIDIUM_ID".
namespace principal.namespace Mappato direttamente dal campo namespace.
pid principal.process.pid Mappato direttamente dal campo pid.
request.context.userAgentRaw network.http.user_agent Mappato direttamente dal campo request.context.userAgentRaw.
request.sessionId network.session_id Mappato direttamente dal campo request.sessionId.
requestMethod network.http.method Mappato direttamente dal campo requestMethod.
requestURI network.http.referral_url Mappato direttamente dal campo requestURI.
security_result.severity security_result.severity Mappato dal campo severity. Se il valore è "INFO", viene mappato su "INFORMATIONAL".
principal.application Mappato direttamente dal campo application.
principal.asset.hostname Mappato direttamente dal campo hostname.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.