Raccogliere i log OpenLDAP

Supportato in:

Questo documento spiega come importare i log OpenLDAP in Google Security Operations utilizzando Bindplane.

OpenLDAP è un server di directory LDAP open source che genera log di accesso, controllo e replica. Il parser estrae i campi dalle voci di log OpenLDAP e li mappa al modello unificato dei dati (UDM), acquisendo l'identità dell'utente, gli eventi di autenticazione, le operazioni LDAP e i risultati di sicurezza.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows Server 2016 o versioni successive oppure host Linux con systemd
  • Connettività di rete tra l'agente Bindplane e il server OpenLDAP
  • Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso con privilegi al server OpenLDAP con autorizzazioni di amministratore o root

Recuperare il file di autenticazione dell'importazione di Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Agenti di raccolta.

  3. Scarica il file di autenticazione dell'acquisizione. 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 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

  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sc query observiq-otel-collector

Il servizio dovrebbe essere visualizzato come IN ESECUZIONE.

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

  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sudo systemctl status observiq-otel-collector

Il servizio dovrebbe essere visualizzato come attivo (in esecuzione).

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.

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

Individua il file di configurazione

  • Linux:

    sudo systemctl status observiq-otel-collector

  • Windows:

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

Modifica il file di configurazione

  • Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

    receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/openldap:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: OPENLDAP
        raw_log_field: body

service:
    pipelines:
        logs/openldap:
            receivers:
                - udplog
            exporters:
                - chronicle/openldap

Parametri di configurazione

Sostituisci i seguenti segnaposto:

  • Configurazione del ricevitore:

    • udplog: Il tipo di ricevitore in base al protocollo:
      • udplog per syslog UDP
      • tcplog per TCP syslog
      • syslog per RFC 3164/5424 syslog
    • 0.0.0.0: indirizzo IP su cui ascoltare:
      • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
      • Indirizzo IP specifico da ascoltare su un'interfaccia
    • 514: numero di porta su cui ascoltare (ad esempio, 514, 1514, 6514)

  • Configurazione dell'esportatore:

    • <customer_id>: l'ID cliente del passaggio precedente
    • malachiteingestion-pa.googleapis.com: URL endpoint regionale:
      • Stati Uniti: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Per un elenco completo, vedi Endpoint regionali.
    • Modifica creds_file_path a seconda della piattaforma:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json

Salvare il file di configurazione

  • Dopo la modifica, salva il file:
    • Linux: premi Ctrl+O, poi Enter e infine Ctrl+X.
    • Windows: fai clic su File > Salva.

Riavvia l'agente Bindplane per applicare le modifiche

Per riavviare l'agente Bindplane in Linux:

  1. Esegui questo comando:

    sudo systemctl restart observiq-otel-collector

  2. Verifica che il servizio sia in esecuzione:

    sudo systemctl status observiq-otel-collector

  3. Controlla i log per individuare eventuali errori:

    sudo journalctl -u observiq-otel-collector -f

Per riavviare l'agente Bindplane in Windows:

  1. Scegli una delle seguenti opzioni:

    • Prompt dei comandi o PowerShell come amministratore:
    net stop observiq-otel-collector && net start observiq-otel-collector
    • Console dei servizi:
      1. Premi Win+R, digita services.msc e premi Invio.
      2. Individua observIQ OpenTelemetry Collector.
      3. Fai clic con il tasto destro del mouse e seleziona Riavvia.

  2. Verifica che il servizio sia in esecuzione:

    sc query observiq-otel-collector

  3. Controlla i log per individuare eventuali errori:

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

Configurare l'inoltro di Syslog OpenLDAP

OpenLDAP (slapd) può essere configurato per la registrazione tramite syslog. Configura il daemon syslog per inoltrare i log OpenLDAP all'agente Bindplane.

  1. Verifica che OpenLDAP sia configurato per registrare i log in syslog. Controlla slapd.conf o cn=config per la direttiva loglevel:

    loglevel stats conns

  2. OpenLDAP registra i log nella funzionalità syslog local4 per impostazione predefinita. Configura rsyslog per inoltrare questi log all'agente Bindplane. Crea un file di configurazione:

    sudo nano /etc/rsyslog.d/openldap-forward.conf

  3. Aggiungi i seguenti contenuti:

    local4.* @BINDPLANE_AGENT_IP:514

  4. Riavvia il servizio rsyslog:

    sudo systemctl restart rsyslog

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
op, fd, ou, cn, dc, dc1, base1, base2, base3, scope_data, valueData, method, filter, tag_data, err, attrData, ou_2, ou_1, syslog_message, immutable_user_id, resource additional.fields Unite alle etichette create da questi campi
extensions.auth.type Impostato su "AUTHTYPE_UNSPECIFIED"
caller_ip, proxy1_ip, proxy2_ip intermediario Unito da intermediario, proxy_1, proxy_2
msg1, inner_message metadata.description Valore da msg1 o inner_message
metadata.event_type Impostato inizialmente su "GENERIC_EVENT", poi su "STATUS_UPDATE" se è presente l'IP principale, su "USER_UNCATEGORIZED" se è presente l'utente e su "USER_LOGIN" se è presente il timestamp o inner_ts
ldap_action metadata.product_event_type Valore di ldap_action convertito in minuscolo
ldap_conn metadata.product_log_id Valore di ldap_conn dopo la rimozione di "conn="
user_agent network.http.user_agent Valore copiato direttamente
session_id network.session_id Valore copiato direttamente
principal_ip, prin_ip, caller_ip, r_ip_or_host, proxy_client_ip, src_ip, client_ip principal.asset.ip Unito da principal_ip (dopo aver sostituito - con .), prin_ip, caller_ip, r_ip_or_host (se IP), proxy_client_ip, src_ip, client_ip
r_ip_or_host, src_host principal.hostname Valore di r_ip_or_host se nome host, altrimenti src_host
principal_ip, prin_ip, caller_ip, r_ip_or_host, proxy_client_ip, src_ip, client_ip principal.ip Unito da principal_ip (dopo aver sostituito - con .), prin_ip, caller_ip, r_ip_or_host (se IP), proxy_client_ip, src_ip, client_ip
country principal.location.country_or_region Valore copiato direttamente
prin_port, port, src_port principal.port Valore di prin_port, port o src_port, convertito in numero intero
syslog_process principal.process.file.full_path Valore copiato direttamente
syslog_pid principal.process.pid Valore copiato direttamente
org_name principal.user.company_name Valore copiato direttamente
user, cn, uid principal.user.userid Valore da user, cn o uid
security_result security_result Unito direttamente
action, sec_action security_result.action Valore dell'azione (in base ai codici di errore) o sec_action (in base a login_status)
resource, immutable_user_id security_result.detection_fields Unito alle etichette della risorsa e immutable_user_id
inner_descrption, security_description security_result.description Valore ottenuto da inner_descrption o security_description
tuser, username, userid target.user.userid Valore di tuser, username o userid
metadata.product_name Imposta su "OpenLDAP"
metadata.vendor_name Imposta su "OpenLDAP"
eventType event.idm.read_only_udm.metadata.product_event_type Mappato dal log delle modifiche
cn event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
sequenceId event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
dc_2 event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
dc_3 event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
dc event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
dc_1 event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
user event.idm.read_only_udm.principal.user.userid Mappato dal log delle modifiche
path event.idm.read_only_udm.principal.process.file.full_path Mappato dal log delle modifiche
ip1 principal.ip Mappato dal log delle modifiche
base", "err", "attr", "tag", "scope", and "valueData additional.fields Mappato dal log delle modifiche
security_result.action ALLOW Mappato dal log delle modifiche
security_result.action BLOCK Mappato dal log delle modifiche

Log delle modifiche

Visualizza il log delle modifiche per questo parser

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