Raccogliere i log OpenLDAP

Supportato in:

Google SecOps SIEM

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 di OpenLDAP e li mappa al modello dei dati unificato (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'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso privilegiato al server OpenLDAP con autorizzazioni root o amministrative

Recupera le credenziali Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: utilizza l'API Chronicle (opzione 1).
• Deployment legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino al ritiro dell'API Ingestion il 20 luglio 2027.

Opzione 1: crea un account di servizio per l'API Chronicle (consigliata)

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome service account: inserisci un nome per l'account (ad esempio bindplane-ingest).
   • Descrizione service account: inserisci una descrizione (ad esempio Bindplane agent log ingestion).
5. Fai clic su Crea e continua.
6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
7. Fai clic su Continua e poi su Fine.
8. Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
9. Fai clic su Aggiungi chiave > Crea nuova chiave.
10. Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul tuo computer.
11. Salva il file della chiave come ingestion-auth.json nella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.json su Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json su Windows) oppure aggiorna creds_file_path in config.yaml in modo che corrisponda al percorso in cui lo salvi.
12. Vai a IAM e amministrazione > Impostazioni e copia il Numero progetto. Ti servirà per la configurazione dell'esportatore.

Nota: la chiave JSON è una credenziale. Limita l'accesso al file sull'host Bindplane e ruota la chiave in base alle policy della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)

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

Nota: questo file autentica l'agente nell'API Ingestion legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per il 20 luglio 2027. Pianifica di passare all'opzione 1 prima di questa data.

Ottieni 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 organizzazione.

   Nota: l'ID cliente è necessario per configurare l'esportatore dell'agente Bindplane.

Installa l'agente Bindplane

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

Installazione di finestre

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
   

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.

Nota: la configurazione dell'esportatore dell'API Chronicle richiede Bindplane Collector v1.106.0 o versioni successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade del raccoglitore prima di modificare la configurazione.

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

Individua il file di configurazione

• Linux:

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

• 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:
      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: 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 syslog TCP
    • syslog per syslog RFC 3164/5424
  • 0.0.0.0: indirizzo IP su cui ascoltare:
    • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
    • Indirizzo IP specifico per l'ascolto 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
  • location: sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio us, europe o asia-southeast1). L'esportatore aggiunge chronicle.googleapis.com come prefisso a questo valore. Per l'elenco completo, consulta Endpoint regionali.
  • project: sostituisci <PROJECT_NUMBER> con il numero di progetto da IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione chronicle.googleapis.com.
  • Modifica creds_file_path in base al percorso del file della chiave JSON del account di servizio (opzione 1), a seconda della piattaforma:
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json

Esportatore dell'API di importazione precedente

• Se utilizzi il file di autenticazione dell'importazione dell'opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'acquisizione e, se l'istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con il tuo endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/openldap:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: OPENLDAP
      raw_log_field: body
  

Nota: questo esportatore smetterà di funzionare quando l'API Ingestion verrà ritirata il 20 luglio 2027.

Salva 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 verificare la presenza di 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 verificare la presenza di 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 l'accesso a syslog. Controlla slapd.conf o cn=config per la direttiva loglevel:

   loglevel stats conns
   

   Nota: i livelli di log comuni includono stats (statistiche di connessione/operazione), conns (gestione della connessione) e ACL (elaborazione controllo dell'accesso). Regola il livello di log per acquisire gli eventi necessari.

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
   

   Nota: sostituisci BINDPLANE_AGENT_IP con l'indirizzo IP dell'host dell'agente Bindplane. Utilizza @@ anziché @ per TCP.

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 di 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, 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 di action (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 di immutable_user_id
inner_descrption, security_description	security_result.description	Valore 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.