Raccogliere i log dei Digi Modem
Questo documento spiega come importare i log di Digi Modems in Google Security Operations utilizzando Bindplane. Il codice del parser estrae innanzitutto i campi come timestamp, nome host, tipo di prodotto e contenuti dei log dai messaggi syslog DIGI_MODEMS utilizzando i pattern grok. Successivamente, analizza ulteriormente i contenuti per identificare i tentativi di accesso (riusciti o non riusciti), estraendo dettagli come utente, indirizzo IP, porta e protocolli, mappando infine questi campi estratti in uno schema Unified Data Model (UDM) per l'analisi della sicurezza.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Istanza Google SecOps
- Windows 2016 o versioni successive oppure un host Linux con
systemd
- Se l'esecuzione avviene tramite un proxy, le porte del firewall sono aperte
- Accesso con privilegi a Digi Remote Manager o alla UI web del modem Digi locale
Recuperare il file di autenticazione importazione di Google SecOps
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Agenti di raccolta.
- 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
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Profilo.
- 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
- Apri il 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
Installazione di Linux
- Apri un terminale con privilegi di 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
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
- 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).
- Individua il file
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: 'DIGI_MODEMS' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
- Sostituisci la porta e l'indirizzo IP in base alle esigenze della tua infrastruttura.
- Sostituisci
<customer_id>
con l'ID cliente effettivo. - Aggiorna
/path/to/ingestion-authentication-file.json
al percorso in cui è stato salvato il file di autenticazione nella sezione Recupera il file di autenticazione per l'importazione di Google SecOps.
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
Configurare il server Syslog sul modem Digi
- Accedi a Digi Remote Manager o all'interfaccia utente web locale di Digi Modem.
- Accedi alla configurazione del dispositivo con Remote Manager:
- Individua il dispositivo per cui vuoi configurare Syslog.
- Fai clic su ID dispositivo > Impostazioni > Configurazione.
- Accedi alla configurazione del dispositivo con la UI web del modem Digi locale:
- Fai clic su Sistema > Configurazione > Configurazione dispositivo.
- Vai a Sistema > Log.
- Fai clic per espandere l'elenco dei server.
- Fai clic su Aggiungi server +.
- Fornisci i seguenti dettagli di configurazione:
- Server: inserisci l'indirizzo IP dell'agente Bindplane.
- Seleziona le categorie di eventi che verranno inviate al server (tutte le categorie di eventi sono attivate per impostazione predefinita).
- Porta di uscita syslog: inserisci il numero di porta dell'agente Bindplane (il valore predefinito è
514
). - Protocollo: seleziona UDP.
- Fai clic su Applica.
Tabella di mappatura UDM
Campo log | Mappatura UDM | Logic |
---|---|---|
contenuti | security_result.description | Mappato direttamente dal campo content dopo l'analisi iniziale di grok. |
http_method | network.http.method | Estratto dal campo content utilizzando un pattern grok. |
http_version | network.application_protocol_version | Estratto dal campo content utilizzando un pattern grok. |
nome host | principal.hostname | Estratto dal messaggio di log utilizzando un pattern grok. |
ip | target.ip | Estratto dal campo content utilizzando un pattern grok. |
porta | target.port | Estratto dal campo content utilizzando un pattern grok e convertito in un numero intero. |
proto | network.application_protocol | Estratto dal campo content utilizzando un pattern grok. |
ts | metadata.event_timestamp | Estratto dal messaggio di log utilizzando un pattern grok e convertito in un timestamp. |
tipo | login_type_label.value | Estratto dal campo content utilizzando un pattern grok. |
extensions.auth.type | Impostato su MACHINE dalla logica del parser. |
|
login_type_label.key | Impostato su Login type dalla logica del parser. |
|
metadata.event_type | Determinato dalla presenza di campi specifici come ip o user e impostato di conseguenza su NETWORK_CONNECTION o USER_LOGIN . |
|
metadata.log_type | Impostato su DIGI_MODEMS dalla logica del parser. |
|
metadata.product_event_type | Estratto dal campo product_type nel messaggio di log. |
|
metadata.product_name | Impostato su DIGI_MODEMS dalla logica del parser. |
|
metadata.vendor_name | Impostato su DIGI_MODEMS dalla logica del parser. |
|
security_result.action | Determinato dalla presenza di Login OK o Login failure nel messaggio e impostato rispettivamente su ALLOW o BLOCK . |
|
utente | target.user.userid | Estratto dal campo content utilizzando un pattern grok. |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.