Raccogli i log di HP ProCurve

Supportata in:

Google SecOps SIEM

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

HP ProCurve è una linea di switch di rete che generano messaggi syslog per eventi di autenticazione, modifiche alla configurazione, attività di rete ed eventi di sistema. Il parser estrae i campi dai log formattati in syslog, analizza le coppie chiave-valore e le descrizioni e le 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 lo switch HP ProCurve
• Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso SSH allo switch HP ProCurve

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/hp_procurve:
      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: HP_PROCURVE
      raw_log_field: body
  
  service:
    pipelines:
      logs/hp_procurve_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/hp_procurve
  

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/hp_procurve:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: HP_PROCURVE
      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 syslog sullo switch HP ProCurve

1. Accedi allo switch HP ProCurve con SSH.

2. Verifica l'interfaccia dello switch utilizzando il seguente comando:

   show ip int br
   

3. Attiva la modalità di configurazione sullo switch utilizzando il seguente comando:

   console# conf t
   

4. Configura lo switch per l'invio dei log utilizzando i seguenti comandi:

   logging host <bindplane-server-ip> transport <udp/tcp> port <port-number>
   logging facility syslog
   logging trap informational
   logging buffer 65536
   logging origin-id hostname
   logging source-interface <interface>
   

   • Sostituisci <bindplane-server-ip> con l'indirizzo IP dell'agente Bindplane.
   • Sostituisci <port-number> con la porta configurata (predefinita: 514).
   • Sostituisci <interface> con l'interfaccia di origine per il traffico syslog.

Tabella di mappatura UDM

Campo del log	mappatura UDM	Logica
AAAScheme	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è AAAScheme
AAAType	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è AAAType
ID telaio	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo description se la chiave è Chassis ID
Il comando è	read_only_udm.security_result.detection_fields.value	Testo dopo Command is nel campo commandInfo
CommandSource	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è CommandSource
Config-Method	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come config_method
ConfigDestination	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è ConfigDestination
ConfigSource	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è ConfigSource
Nome dispositivo	read_only_udm.principal.hostname	Se il campo esiste nel log, viene mappato al nome host dell'entità e al nome host dell'asset
ID evento	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come event_id
EventIndex	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è EventIndex
IfIndex	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo description se la chiave è IfIndex
IP: %{IP:IPAddr}	read_only_udm.target.ip, read_only_udm.target.asset.ip	Indirizzo IP estratto dal campo desc e mappato all'IP di destinazione e all'IP dell'asset di destinazione
IPAddr	read_only_udm.target.ip, read_only_udm.target.asset.ip	Se il campo esiste nel log, viene mappato all'IP di destinazione e all'IP dell'asset di destinazione
Notice-Type	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come notice_type
ID porta	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo description se la chiave è Port ID
Remote-IP-Address	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come remote_ip_address
Servizio	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è Service
Attività	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo descrip se la chiave è Task
Utente	read_only_udm.principal.user.userid	Se il campo esiste nel log, viene mappato all'ID utente principale
User-Name	read_only_udm.principal.user.userid	Se il campo esiste nel log, viene mappato all'ID utente principale
Nome utente	read_only_udm.principal.user.userid	Se il campo esiste nel log, viene mappato all'ID utente principale
UserService	read_only_udm.security_result.detection_fields.value	Valore estratto dal campo desc se la chiave è UserService
collection_time.seconds	read_only_udm.metadata.event_timestamp.seconds	Secondi del timestamp dell'evento
dati		Questo campo contiene il messaggio di log non elaborato e viene analizzato per estrarre altri campi. Non è mappato all'UDM.
decr	read_only_udm.security_result.description	Descrizione estratta dal messaggio di log
descrip		Descrizione estratta dal campo desc, analizzata ulteriormente per le coppie chiave-valore. Non è mappato all'UDM.
descrizione	read_only_udm.security_result.description	Se il campo esiste nel log, viene mappato alla descrizione del risultato di sicurezza
descript	read_only_udm.metadata.description	Se il campo esiste nel log, viene mappato alla descrizione dei metadati
event_id	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come event_id
eventId	read_only_udm.metadata.product_event_type	ID evento estratto dal messaggio di log
nome host	read_only_udm.principal.hostname, read_only_udm.principal.asset.hostname	Nome host estratto dal messaggio di log e mappato al nome host del principal e al nome host dell'asset
inter_ip	read_only_udm.additional.fields.value.string_value, read_only_udm.intermediary.ip	Se il campo esiste nel log ed è un IP valido, viene mappato all'IP intermediario. In caso contrario, viene inserito nei campi aggiuntivi come inter_ip
notice_type	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come notice_type
pid	read_only_udm.principal.process.pid	Se il campo esiste nel log, viene mappato al PID del processo principale
programma		Informazioni sul programma estratte dal messaggio di log, analizzate ulteriormente per estrarre modulo, gravità e azione. Non è mappato all'UDM.
proto	read_only_udm.network.application_protocol, read_only_udm.additional.fields.value.string_value	Protocollo estratto dal messaggio di log. Se corrisponde a protocolli noti, viene mappato al protocollo dell'applicazione. In caso contrario, viene inserito nei campi aggiuntivi come Application Protocol
remote_ip_address	read_only_udm.principal.ip, read_only_udm.principal.asset.ip, read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log ed è un IP valido, viene mappato all'IP del principal e all'IP dell'asset del principal. In caso contrario, viene inserito nei campi aggiuntivi come remote_ip_address
gravità	read_only_udm.security_result.severity, read_only_udm.security_result.severity_details	Gravità estratta dal campo program dopo la suddivisione per /. Viene mappato ai livelli di gravità UDM e archiviato anche come dettagli di gravità non elaborati
src_ip	read_only_udm.principal.ip, read_only_udm.principal.asset.ip	IP di origine estratto dal messaggio di log e mappato all'IP dell'entità e all'IP dell'asset dell'entità
stato	read_only_udm.additional.fields.value.string_value	Se il campo esiste nel log, viene inserito nei campi aggiuntivi come status
targetHostname	read_only_udm.target.hostname, read_only_udm.target.asset.ip	Se il campo esiste nel log, viene mappato al nome host di destinazione e all'IP dell'asset di destinazione
target_ip	read_only_udm.target.ip, read_only_udm.target.asset.ip	IP di destinazione estratto dal messaggio di log e mappato all'IP di destinazione e all'IP dell'asset di destinazione
timestamp	read_only_udm.metadata.event_timestamp.seconds	Timestamp estratto dal messaggio di log e convertito in timestamp dell'evento
timestamp.seconds	read_only_udm.metadata.event_timestamp.seconds	Secondi del timestamp dell'evento
nome utente	read_only_udm.principal.user.userid	Se il campo esiste nel log, viene mappato all'ID utente principale
	read_only_udm.metadata.event_type	Determinato in base a una combinazione di campi e logica: - NETWORK_CONNECTION: se has_principal e has_target sono true. - USER_LOGOUT: se action è WEBOPT_LOGOUT, LOGOUT o SHELL_LOGOUT. - USER_LOGIN: se action è LOGIN o WEBOPT_LOGIN_SUC. - STATUS_UPDATE: se action non è vuoto o src_ip/hostname non sono vuoti. - USER_UNCATEGORIZED: se has_user è true. - GENERIC_EVENT: se nessuna di queste condizioni è soddisfatta.
	read_only_udm.metadata.product_name	Impostato come hardcoded su Procurve
	read_only_udm.metadata.vendor_name	Impostato come hardcoded su HP
	read_only_udm.extensions.auth.type	Imposta su MACHINE se event_type è USER_LOGOUT o USER_LOGIN
ts	event.idm.read_only_udm.metadata.event_timestamp	Mappato dal log delle modifiche
prin_app	event.idm.read_only_udm.principal.application	Mappato dal log delle modifiche
DHCP	network.application_protocol	Mappato dal log delle modifiche
prin_port	principal.port	Mappato dal log delle modifiche
status", "config_method", "event_id", and "notice_type	additional.fields	Mappato dal log delle modifiche
target_mac	target.mac	Mappato dal log delle modifiche
msg	metadata.description	Mappato dal log delle modifiche
src_mac	principal.mac	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.