Raccogli i log di Rapid7 Nexpose

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di Rapid7 Nexpose in Google Security Operations utilizzando l'agente Bindplane.

Rapid7 Nexpose (ora InsightVM) è una piattaforma di gestione delle vulnerabilità on-premise utilizzata per scansionare, valutare e dare priorità alle vulnerabilità di sicurezza nella tua rete. Fornisce una console di sicurezza basata sul web accessibile all'indirizzo https://<host>:3780 e supporta l'esportazione nativa di syslog per l'inoltro dei risultati della scansione, delle vulnerabilità rilevate e degli eventi di modifica degli asset.

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 la console di sicurezza Rapid7 Nexpose
• Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso con privilegi alla console di sicurezza Rapid7 Nexpose con il ruolo Amministratore globale o Gestore della sicurezza

Ottieni le credenziali di 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 alla dismissione dell'API Ingestion il 20 luglio 2027.

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

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea account di servizio.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome account di servizio: 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 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) o 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 > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > 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 precedente (malachiteingestion-pa.googleapis.com), che Google ha programmato per la fine del ciclo di vita il 20 luglio 2027. Pianifica il passaggio all'Opzione 1 prima di questa data.

Ottieni l'ID cliente Google SecOps

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.

3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

   Nota: l'ID cliente è obbligatorio 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 RUNNING.

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 il syslog e inviarlo 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/rapid7_nexpose:
      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: RAPID7_NEXPOSE
      raw_log_field: body
  
  service:
    pipelines:
      logs/rapid7_nexpose_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/rapid7_nexpose
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • listen_address: indirizzo IP e porta su cui ascoltare:
    • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
    • La porta 514 è la porta syslog standard (richiede l'accesso root su Linux; utilizza 1514 per l'accesso non root)

• Configurazione dell'esportatore:

  • creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: ID cliente copiato dalla console Google SecOps
  • 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.

Esportatore API di importazione precedente

• Se utilizzi il file di autenticazione dell'acquisizione 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/rapid7_nexpose:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: RAPID7_NEXPOSE
      raw_log_field: body
  

Nota: questo strumento di esportazione smetterà di funzionare quando l'API Ingestion non sarà più disponibile 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, esegui questo comando:

  sudo systemctl restart observiq-otel-collector
  

  1. Verifica che il servizio sia in esecuzione:

     sudo systemctl status observiq-otel-collector
     

  2. Controlla i log per verificare la presenza di 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 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.

    4. Verifica che il servizio sia in esecuzione:

       sc query observiq-otel-collector
       

    5. Controlla i log per verificare la presenza di errori:

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

Configura l'inoltro del syslog Rapid7 Nexpose

1. Accedi all'interfaccia web della console di sicurezza Rapid7 Nexpose all'indirizzo https://<nexpose-host>:3780.
2. Vai ad Administration (Amministrazione) > Global Settings (Impostazioni globali).
3. Scorri verso il basso fino alla sezione Syslog.
4. Attiva l'inoltro di syslog e fornisci i seguenti dettagli di configurazione:
   • Server Syslog: inserisci l'indirizzo IP dell'host dell'agente Bindplane.
   • Porta: inserisci 514 (o la porta configurata nel ricevitore dell'agente Bindplane).
   • Protocollo: seleziona UDP (o TCP se configurato nel ricevitore).
5. Fai clic su Salva.

6. Per verificare che i messaggi syslog vengano inviati, esegui una scansione e controlla i log dell'agente Bindplane per verificare la presenza di messaggi in arrivo.

   Nota: la console di sicurezza Nexpose invia messaggi syslog per i risultati della scansione, i rilevamenti di vulnerabilità e le modifiche agli asset. Assicurati che l'host dell'agente Bindplane sia raggiungibile dalla console Nexpose sulla porta configurata.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
	additional.fields	Uniti dall'array delle categorie come coppie chiave-valore "App Stack"; uniti dai campi pci (adjustedCVSSScore, adjustedSeverityScore, fail, status) come coppie chiave-valore; uniti dai campi cvss v2/v3 come campi di rilevamento in sec_result
asset_id	principal.asset.asset_id	Impostato su "assetID: %{asset_id}" se asset_id != ""
categorie	additional.fields	Uniti come elenco di coppie chiave-valore "App Stack"
cve_id, cve_year	extensions.vulns.vulnerabilities.cve_id	Concatenato da cve_year e cve_id se entrambi presenti
cvss.links, cvss.v2.accessComplexity, cvss.v2.accessVector, cvss.v2.authentication, cvss.v2.availabilityImpact, cvss.v2.confidentialityImpact, cvss.v2.integrityImpact, cvss.v2.vector, cvss.v3.attackComplexity, cvss.v3.attackVector, cvss.v3.availabilityImpact, cvss.v3.confidentialityImpact, cvss.v3.integrityImpact, cvss.v3.privilegeRequired, cvss.v3.scope, cvss.v3.userInteraction, cvss.v3.vector, links	security_result.detection_fields	Uniti da link e cvss.links come coppie chiave-valore; uniti da campi cvss v2/v3 come coppie chiave-valore con prefisso (ad es. "v2 accessComplexity")
decr	extensions.vulns.vulnerabilities.description	Valore copiato direttamente da desc, se presente
descrizione	metadata.description	Valore di description.text se description è vuoto, altrimenti valore copiato direttamente
description.text	metadata.description	Valore copiato direttamente se la descrizione è vuota
event_type	metadata.event_type	Impostato su "SCAN_VULN_HOST" se vulnerability_description o vulnerability_data sono presenti, altrimenti su "SCAN_HOST" se has_principal è true, altrimenti su "GENERIC_EVENT"
has_principal		Impostato su true se sono impostati ip_address, host_name o asset_id
has_target		Impostato su true se target_ip è impostato
host_name	principal.hostname, principal.asset.hostname	Valore copiato direttamente se host_name != ""
ip_address	principal.ip, principal.asset.ip	Valore copiato direttamente se ip_address != ""
last_assessed_for_vulnerabilities		Convertito in timestamp utilizzando vari formati di data o UNIX/UNIX_MS
pci.adjustedCVSSScore	additional.fields	Unito come coppia chiave-valore "adjustedCVSSScore" se non è vuoto
pci.adjustedSeverityScore	additional.fields	Unito come coppia chiave-valore "adjustedSeverityScore" se non è vuoto
pci.fail	additional.fields	Uniti come coppia chiave-valore "fail" se non vuoti
pci.status	additional.fields	Unito come coppia chiave-valore "status" se non vuoto
sec_result	security_result	Valore copiato direttamente se sec_result != ""
target_ip	target.ip, target.asset.ip	Valore copiato direttamente se target_ip != ""
timestamp		Convertito utilizzando i formati di timestamp di syslog
titolo	extensions.vulns.vulnerabilities.description	Valore di vulnerability.Vulnerability_Title, se presente
vulnerability.Vulnerability_Severity	extensions.vulns.vulnerabilities.severity	Impostato su "HIGH" se "Severe", "CRITICAL" se "Critical", "MEDIUM" se "Moderate"
vulnerability.Vulnerability_Title	extensions.vulns.vulnerabilities.description	Valore copiato direttamente
vulnerability.vulnerability_id	extensions.vulns.vulnerabilities.vendor_vulnerability_id	Valore copiato direttamente, se presente
vulnerability_data	extensions.vulns.vulnerabilities	Uniti da ogni oggetto vulnerabilità con gravità, cve_id, descrizione, vendor_vulnerability_id
vulnerability_description	extensions.vulns.vulnerabilities.description, metadata.description	Unito come oggetto di vulnerabilità se presente; impostato su metadata.description
	metadata.product_name	Imposta su "Nexpose"
	metadata.vendor_name	Imposta su "Rapid7"
categories", "pci.adjustedCVSSScore", "pci.adjustedSeverityScore", "pci.fail", and "pci.status	additional.fields	Mappato dal log delle modifiche
cvss.v2.accessComplexity", "cvss.v2.accessVector", "cvss.v2.authentication", "cvss.v2.availabilityImpact", "cvss.v2.confidentialityImpact", "cvss.v2.integrityImpact", "cvss.v2.vector", "cvss.v3.attackComplexity", "cvss.v3.attackVector", "cvss.v3.availabilityImpact", "cvss.v3.confidentialityImpact", "cvss.v3.privilegeRequired", "cvss.v3.integrityImpact", "cvss.v3.scope", "cvss.v3.userInteraction", and "cvss.v3.vector	security_result.detection_fields	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.