Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Raccogli i log di ForgeRock OpenDJ

Versione del parser: 2.0

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log di ForgeRock OpenDJ in Google Security Operations utilizzando Bindplane.

ForgeRock OpenDJ è un server di directory LDAP open source che fornisce servizi di archiviazione dei dati di identità e di autenticazione. Genera log di accesso, log di controllo e log degli errori per operazioni LDAP, eventi di autenticazione e modifiche alla directory. Il parser estrae i campi dalle voci di log OpenDJ e li mappa al modello UDM (Unified Data Model).

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 ForgeRock OpenDJ
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 ForgeRock OpenDJ con autorizzazioni di amministratore

Recuperare il file di autenticazione dell'importazione di Google SecOps

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

Nota :questo file JSON contiene le credenziali per l'autenticazione dell'agente Bindplane in Google SecOps.

Recuperare l'ID cliente Google SecOps

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

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

Installa l'agente Bindplane

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

Installazione di Windows

Apri Prompt dei comandi o PowerShell come amministratore.

Esegui questo comando:

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

Attendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
```
sc query observiq-otel-collector
```

Il servizio dovrebbe essere visualizzato come IN ESECUZIONE.

Installazione di Linux

Apri un terminale con privilegi root o sudo.

Esegui questo comando:

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

Attendi il completamento dell'installazione.

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:
    tcplog:
        listen_address: "0.0.0.0:514"

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

service:
    pipelines:
        logs/opendj:
            receivers:
                - tcplog
            exporters:
                - chronicle/opendj

Parametri di configurazione

Sostituisci i seguenti segnaposto:

Configurazione del ricevitore:
- tcplog: Il tipo di ricevitore in base al protocollo:
  - udplog per syslog UDP
  - tcplog per TCP syslog
  - 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 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:

Esegui questo comando:

sudo systemctl restart observiq-otel-collector

Verifica che il servizio sia in esecuzione:

sudo systemctl status observiq-otel-collector

Controlla i log per individuare eventuali errori:

sudo journalctl -u observiq-otel-collector -f

Per riavviare l'agente Bindplane in Windows:

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.
Verifica che il servizio sia in esecuzione:
```
sc query observiq-otel-collector
```

Controlla i log per individuare eventuali errori:

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

Configurare l'inoltro di Syslog di ForgeRock OpenDJ

ForgeRock OpenDJ archivia i log localmente sul server. Configura l'inoltro di syslog utilizzando il daemon syslog di sistema per inviare questi log all'agente Bindplane.

Identifica la directory dei log di OpenDJ. La località predefinita è:
```
/path/to/opendj/logs/
```
- I file di log chiave includono access, audit e errors.
Configura il daemon syslog di sistema (ad esempio rsyslog) per monitorare e inoltrare i file di log OpenDJ. Crea un nuovo file di configurazione rsyslog:
```
sudo nano /etc/rsyslog.d/opendj-forward.conf
```

Aggiungi i seguenti contenuti:

module(load="imfile")
input(type="imfile"
    File="/path/to/opendj/logs/access"
    Tag="opendj"
    Severity="info"
    Facility="local0")
input(type="imfile"
    File="/path/to/opendj/logs/errors"
    Tag="opendj"
    Severity="error"
    Facility="local0")
local0.* @@BINDPLANE_AGENT_IP:514

Riavvia il servizio rsyslog:
```
sudo systemctl restart rsyslog
```

Riferimento per la mappatura dei campi UDM

Campo log	Mappatura UDM	Logica
interim_server	intermediary.hostname	Nome host del dispositivo intermediario
	metadata.event_type	Tipo di evento (ad esempio USER_LOGIN, NETWORK_CONNECTION)
kv_fields.request.operation	metadata.product_event_type	Tipo di evento specifico per il prodotto
	network.application_protocol	Protocollo dell'applicazione utilizzato (ad esempio, HTTP, LDAP)
applicazione	principal.application	Nome dell'applicazione associata al soggetto
kv_fields.client.ip	principal.ip	Indirizzo IP del principal
kv_fields.client.port	principal.port	Numero di porta del principale
	security_result.action	Azione intrapresa dal sistema di sicurezza (ad esempio, CONSENTI, BLOCCA)
kv_fields.request.filter	security_result.description	Descrizione del risultato di sicurezza
kv_fields.server.ip	target.ip	Indirizzo IP della destinazione
kv_fields.server.port	target.port	Numero di porta della destinazione
kv_fields.request.dn	target.resource.name	Nome della risorsa
	target.resource.type	Il tipo di risorsa

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