Raccogliere i log dei Digi Modem

Supportato in:

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

  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 di 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: 'DIGI_MODEMS'
            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

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

    sudo systemctl restart bindplane-agent
    
  2. 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

  1. Accedi a Digi Remote Manager o all'interfaccia utente web locale di Digi Modem.
  2. Accedi alla configurazione del dispositivo con Remote Manager:
    • Individua il dispositivo per cui vuoi configurare Syslog.
    • Fai clic su ID dispositivo > Impostazioni > Configurazione.
  3. Accedi alla configurazione del dispositivo con la UI web del modem Digi locale:
    • Fai clic su Sistema > Configurazione > Configurazione dispositivo.
  4. Vai a Sistema > Log.
  5. Fai clic per espandere l'elenco dei server.
  6. Fai clic su Aggiungi server +.
  7. 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.
  8. 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.