Raccogli i log del router Cisco

Versione parser: 24.0

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log del router Cisco in Google Security Operations utilizzando l'agente Bindplane.

I router Cisco generano messaggi syslog per eventi di rete, corrispondenze ACL, autenticazione e operazioni di sistema. Il parser estrae i campi utilizzando i pattern grok 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 router Cisco
• Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso privilegiato alla CLI del router Cisco

Ottieni le credenziali di Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuove implementazioni: 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 (consigliata)

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome service account: 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, quindi 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 tuo 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) oppure 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 di 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 norme della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > 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 legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per 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 SIEM > Profilo.

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

   Nota: l'ID cliente è necessario 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 Windows

1. Apri 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 dell'agente di raccolta prima di modificare la configurazione.

Configura l'agente Bindplane per importare syslog e inviarli 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/cisco_router:
      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: CISCO_ROUTER
      raw_log_field: body
  
  service:
    pipelines:
      logs/cisco_router_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/cisco_router
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • listen_address: Indirizzo IP e porta da 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 in IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione chronicle.googleapis.com.

Esportatore dell'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/cisco_router:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: CISCO_ROUTER
      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:

     ```bash
     sudo systemctl status observiq-otel-collector
     ```
     

  2. Controlla i log per individuare eventuali errori:

     ```bash
     sudo journalctl -u observiq-otel-collector -f
     ```
     

Configura syslog su un router Cisco

1. Accedi al router Cisco.

2. Aumento dei privilegi:

   enable
   

3. Passa alla modalità di configurazione:

   conf t
   

4. Configura Syslog:

   logging host <BINDPLANE_IP> transport <tcp/udp> port <PORT>
   logging source-interface <INTERFACE>
   

   • Sostituisci <BINDPLANE_IP> con l'indirizzo IP dell'agente Bindplane.
   • Sostituisci <tcp/udp> con il protocollo di ascolto configurato (ad esempio, udp).
   • Sostituisci <INTERFACE> con l'ID interfaccia Cisco (ad esempio Ethernet1/1).

5. Imposta il livello di priorità:

   logging trap Informational
   logging console Informational
   logging severity Informational
   

6. Imposta la funzionalità syslog:

   logging facility local6
   

7. Attiva i timestamp:

   service timestamps log datetime
   

8. Salva ed esci.

9. Salva la configurazione per mantenerla dopo il riavvio:

   copy running-config startup-config
   

Tabella di mappatura UDM

Campo log	mappatura UDM	Logica
client_ip	target.ip, target.asset.ip	Il valore viene preso dal campo client_ip estratto dal parser grok.
client_mac	target.mac	Il valore viene preso dal campo client_mac estratto dal parser grok.
dst_ip	target.ip, target.asset.ip	Il valore viene preso dal campo dst_ip estratto dal parser grok.
dst_port	target.port	Il valore viene preso dal campo dst_port estratto dall'analizzatore sintattico grok e convertito in un numero intero.
duration	-	Questo campo non è mappato all'UDM.
host_ip	target.ip, target.asset.ip	Il valore viene estratto dal campo host_ip dal parser grok.
local_proxy	intermediary.ip	Il valore viene preso dal campo local_proxy estratto dal parser grok.
message_data	metadata.description	Il valore viene preso dal campo message_data estratto dal parser grok.
protocol	network.ip_protocol	Il valore viene estratto dal campo protocol dal parser Grok e convertito in maiuscolo.
received_bytes	network.received_bytes	Il valore viene preso dal campo received_bytes estratto dal parser grok e convertito in un numero intero senza segno.
referral_url	network.http.referral_url	Il valore viene preso dal campo referral_url estratto dal parser grok.
remote_proxy	intermediary.ip	Il valore viene preso dal campo remote_proxy estratto dal parser grok.
send_bytes	network.sent_bytes	Il valore viene estratto dal campo send_bytes dal parser grok e convertito in un numero intero senza segno.
sent_bytes	network.sent_bytes	Il valore viene preso dal campo sent_bytes estratto dal parser grok e convertito in un numero intero senza segno.
server_host	target.hostname, target.asset.hostname	Il valore viene preso dal campo server_host estratto dal parser grok.
server_ip	target.ip, target.asset.ip	Il valore viene estratto dal campo server_ip dal parser grok.
src_ip	principal.ip, principal.asset.ip	Il valore viene estratto dal campo src_ip dal parser grok.
src_port	principal.port	Il valore viene estratto dal campo src_port dal parser grok e convertito in un numero intero.
user_ip	target.ip, target.asset.ip	Il valore viene estratto dal campo user_ip dal parser grok.
user_mail	principal.user.userid, principal.user.email_addresses	Il valore viene preso dal campo user_mail estratto dal parser grok.
username	target.user.userid	Il valore viene estratto dal campo username dal parser grok.
-	metadata.event_timestamp	Il valore viene preso dal campo create_time.
-	metadata.event_type	Il valore è impostato su GENERIC_EVENT per impostazione predefinita e viene modificato in tipi di eventi specifici in base al messaggio di log analizzato.
-	metadata.log_type	Il valore è impostato su CISCO_ROUTER.
-	metadata.product_event_type	Il valore viene estratto dal campo message_type, generato combinando i campi facility, priority e mnemonics.
-	metadata.product_name	Il valore è impostato su Router.
-	metadata.vendor_name	Il valore è impostato su Cisco.
-	network.application_protocol	Il valore è impostato su HTTP o HTTPS se il campo protocol è rispettivamente http o https.
-	extensions.auth.type	Il valore è impostato su AUTHTYPE_UNSPECIFIED per impostazione predefinita e viene modificato in tipi di autenticazione specifici in base al messaggio di log analizzato.
-	security_result.action	Il valore è impostato su ALLOW per gli accessi riusciti e su BLOCK per gli accessi non riusciti.
-	security_result.category	Il valore è impostato su NETWORK_SUSPICIOUS per gli eventi con opzioni IP e su AUTH_VIOLATION per gli accessi non riusciti.
-	security_result.description	Il valore è impostato su messaggi specifici per eventi diversi.
-	security_result.severity	Il valore è impostato su LOW per gli accessi riusciti, MEDIUM per gli accessi non riusciti e INFORMATIONAL per altri eventi.
-	security_result.severity_details	Il valore viene estratto dal campo fail_reason per gli accessi non riusciti e impostato su Informational message per gli eventi con opzioni IP.
-	security_result.summary	Il valore è impostato su messaggi specifici per eventi diversi.
SN	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
P	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
C	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
target_ip	event.idm.read_only_udm.target.ip	Mappato dal log delle modifiche
target_ip	event.idm.read_only_udm.target.asset.ip	Mappato dal log delle modifiche
target_port	event.idm.read_only_udm.target.port	Mappato dal log delle modifiche
src_ip	event.idm.read_only_udm.principal.ip	Mappato dal log delle modifiche
src_ip	event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
dst_user	event.idm.read_only_udm.target.user.userid	Mappato dal log delle modifiche
packet_count	event.idm.read_only_udm.additional	Mappato dal log delle modifiche
status	event.idm.read_only_udm.security_result.action	Mappato dal log delle modifiche
src_port	event.idm.read_only_udm.principal.port	Mappato dal log delle modifiche
src_ip	event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
user_name_	event.idm.read_only_udm.principal.user.userid	Mappato dal log delle modifiche
sc_description	event.idm.read_only_udm.security_result.description	Mappato dal log delle modifiche
packets	event.idm.read_only_udm.network.received_bytes	Mappato dal log delle modifiche
tar_port	event.idm.read_only_udm.target.port	Mappato dal log delle modifiche
tar_ip	event.idm.read_only_udm.target.ip	Mappato dal log delle modifiche
tar_ip	event.idm.read_only_udm.target.asset.ip	Mappato dal log delle modifiche
proto	event.idm.read_only_udm.network.ip_protocol	Mappato dal log delle modifiche
src_ip_port	event.idm.read_only_udm.principal.port	Mappato dal log delle modifiche
src_ip_msg	event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
src_ip_msg_data	event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
intermediary_host	intermediary.hostname	Mappato dal log delle modifiche
srcip	principal.ip	Mappato dal log delle modifiche
inter_hostname	intermediary.ip	Mappato dal log delle modifiche
MessageSourceAddress	principal.ip	Mappato dal log delle modifiche
SourceModuleName" and "SourceModuleType	principal.resource.attribute.labels	Mappato dal log delle modifiche
resourcename	principal.resource.name	Mappato dal log delle modifiche
app_protocol	network.application.protocol	Mappato dal log delle modifiche
app	target.application	Mappato dal log delle modifiche
source_port	principal.port	Mappato dal log delle modifiche
source_ip	principal.ip	Mappato dal log delle modifiche
device_ip	target.ip	Mappato dal log delle modifiche
intermediary_ip	intermediary.ip	Mappato dal log delle modifiche
sec_action	security_result.action	Mappato dal log delle modifiche
sec_summary	security_result.summary	Mappato dal log delle modifiche
facility	principal.resource.type	Mappato dal log delle modifiche
sc_summary	metadata.description	Mappato dal log delle modifiche
sr_action	security_result.action	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.