Raccogli i log IDS di Cyber 2.0
Versione parser: 2.0
Questo documento spiega come importare i log di Cyber 2.0 IDS in Google Security Operations utilizzando l'agente Bindplane.
Gli IDS Cyber 2.0 forniscono sicurezza di rete di livello enterprise con funzionalità integrate di rilevamento e prevenzione delle intrusioni. Le appliance MX utilizzano il motore di rilevamento delle intrusioni Snort per monitorare il traffico di rete alla ricerca di attività dannose e generare avvisi IDS basati sulla threat intelligence di Cisco Talos. Gli avvisi IDS vengono generati in due formati: tipi legacy ids-alerts e attuali security_event, con livelli di priorità che vanno da 1 (alta) a 4 (molto bassa) in base alle classificazioni delle firme Snort.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- Windows Server 2016 o versioni successive o host Linux con
systemd - Connettività di rete tra l'agente Bindplane e Cyber 2.0 IDS
- Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
- Accesso amministrativo alla dashboard di Cisco Meraki
- Cyber 2.0 IDS con licenza Advanced Security Edition (richiesta per le funzionalità IDS/IPS)
- Connettività di rete dall'appliance Meraki MX all'host dell'agente Bindplane (porta UDP 514 o porta personalizzata)
Recupera le credenziali 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)
- Accedi alla Google Cloud console e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
- Vai a IAM e amministrazione > Service account.
- Fai clic su Crea service account.
- 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).
- Nome service account: inserisci un nome per l'account (ad esempio,
- Fai clic su Crea e continua.
- Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
- Fai clic su Continua, quindi su Fine.
- Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
- Fai clic su Aggiungi chiave > Crea nuova chiave.
- Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul tuo computer.
- Salva il file della chiave come
ingestion-auth.jsonnella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonsu Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonsu Windows) o aggiornacreds_file_pathinconfig.yamlin modo che corrisponda al percorso in cui lo salvi. - Vai a IAM e amministrazione > Impostazioni e copia il Numero progetto. Ti servirà per la configurazione dell'esportatore.
Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Agenti di raccolta.
- Scarica il file di autenticazione dell'acquisizione.
- Salva il file in modo sicuro sul sistema in cui verrà installato l'agente Bindplane.
Ottieni 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" /quietAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sc query observiq-otel-collectorLo stato del servizio deve essere RUNNING.
Installazione di Linux
- Apri un terminale con privilegi 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.shAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sudo systemctl status observiq-otel-collectorLo stato del servizio deve essere active (running).
Risorse aggiuntive per l'installazione
Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.
Configura l'agente Bindplane per importare il syslog e inviare i log a Google SecOps
Individua il file di configurazione
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Modifica il file di configurazione
Sostituisci l'intero contenuto di
config.yamlcon la seguente configurazione:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/meraki_ids: 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: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: chronicle.googleapis.com log_type: CYBER_2_IDS raw_log_field: body ingestion_labels: vendor: cisco_meraki product: mx_security_appliance service: pipelines: logs/meraki_to_chronicle: receivers: - udplog exporters: - chronicle/meraki_idsSostituisci i seguenti segnaposto:
Configurazione del ricevitore:
- Il ricevitore è configurato per ascoltare su tutte le interfacce (
0.0.0.0) sulla porta UDP514(porta syslog standard) - Se la porta 514 è già in uso o se devi eseguire l'operazione come utente non root su Linux, cambia la porta in
1514o in un'altra porta disponibile
- Il ricevitore è configurato per ascoltare su tutte le interfacce (
Configurazione dell'esportatore:
<CREDS_FILE_PATH>: percorso completo del file JSON della chiave del account di servizio (opzione 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
<CUSTOMER_ID>: l'ID cliente copiato dal passaggio precedentelocation: sostituisci<LOCATION>con la regione della tua istanza Google SecOps (ad esempious,europeoasia-southeast1). L'esportatore aggiungechronicle.googleapis.comcome 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'impostazionechronicle.googleapis.com.log_type: impostalo suCYBER_2_IDSper gli avvisi IDS di Cisco Meraki.ingestion_labels: etichette facoltative per categorizzare i log in Google SecOps.
Configurazione di esempio
receivers:
udplog:
listen_address: "0.0.0.0:514"
exporters:
chronicle/meraki_ids:
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: 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6'
endpoint: chronicle.googleapis.com
log_type: CYBER_2_IDS
raw_log_field: body
ingestion_labels:
vendor: cisco_meraki
product: mx_security_appliance
environment: production
service:
pipelines:
logs/meraki_to_chronicle:
receivers:
- udplog
exporters:
- chronicle/meraki_ids
Esportatore API di importazione legacy
Se utilizzi il file di autenticazione dell'acquisizione dell'Opzione 2, sostituisci il blocco
exporterscon il seguente. Impostacreds_file_pathsul percorso del file di autenticazione dell'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituiscimalachiteingestion-pa.googleapis.comcon l'endpoint regionale (ad esempio,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/meraki_ids: compression: gzip creds_file_path: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: CYBER_2_IDS raw_log_field: body ingestion_labels: vendor: cisco_meraki product: mx_security_appliance
Salva il file di configurazione
Dopo la modifica, salva il file:
- Linux: premi
Ctrl+O, poiEntere infineCtrl+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-collectorVerifica che il servizio sia in esecuzione:
sudo systemctl status observiq-otel-collectorControlla 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-collectorConsole Servizi:
- Premi
Win+R, digitaservices.msce premi Invio. - Individua observIQ OpenTelemetry Collector.
- Fai clic con il tasto destro del mouse e seleziona Riavvia.
- Premi
Verifica che il servizio sia in esecuzione:
sc query observiq-otel-collectorControlla i log per verificare la presenza di errori:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Configura l'inoltro del syslog di Cyber 2.0 IDS
- Accedi alla dashboard di Cisco Meraki all'indirizzo https://dashboard.meraki.com.
- Seleziona la tua organizzazione dal menu a discesa Organizzazione in alto a sinistra.
- Seleziona la rete contenente l'appliance di sicurezza MX dal menu a discesa delle reti.
- Vai a A livello di rete > Configura > Generale.
- Scorri verso il basso fino alla sezione Reporting.
- Nella sezione Server Syslog, fai clic su Aggiungi un server Syslog.
- Configura il server syslog con le seguenti impostazioni:
- IP server: inserisci l'indirizzo IP dell'host dell'agente Bindplane (ad esempio,
192.168.1.100). - Porta: inserisci
514(o la porta personalizzata configurata nell'agente Bindplane, se diversa). - Ruoli: seleziona i seguenti ruoli per inoltrare gli avvisi IDS:
- Controlla gli avvisi IDS (per gli eventi in formato
ids-alertsprecedente) - Controlla gli eventi di sicurezza (per gli eventi nel formato
security_eventcorrente, inclusi gli avvisi IDS e i rilevamenti di malware AMP)
- Controlla gli avvisi IDS (per gli eventi in formato
- IP server: inserisci l'indirizzo IP dell'host dell'agente Bindplane (ad esempio,
- Fai clic su Salva modifiche nella parte inferiore della pagina.
- Verifica che IDS/IPS sia abilitato sulla tua appliance di sicurezza MX:
- Vai a Security & SD-WAN > Configure > Threat protection.
- Assicurati che la modalità sia impostata su Rilevamento (IDS) o Prevenzione (IPS).
- Seleziona un insieme di regole: Connettività, Bilanciato o Sicurezza, in base ai tuoi requisiti di sicurezza.
- Fai clic su Salva modifiche.
Genera traffico di test per verificare l'inoltro dei log:
- Vai a Sicurezza e SD-WAN > Monitora > Centro sicurezza.
- Verifica che vengano generati avvisi IDS.
- Controlla i log dell'agente Bindplane per verificare che gli eventi vengano ricevuti e inoltrati a Google SecOps.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| time1, monthnum+day+time2, time | metadata.event_timestamp | Timestamp di quando si è verificato l'evento |
| app_version | about.resource.attribute.labels | Elenco di coppie chiave-valore per gli attributi delle risorse |
| prod_event_type | metadata.product_event_type | Tipo di evento specifico del prodotto |
| Gruppi | principal.group.group_display_name | Nome visualizzato del gruppo |
| app_name, app_version, hostname, principal_ip, md5_value | about | Informazioni sull'evento |
| inter_host | intermediary.hostname | Nome host dell'intermediario |
| descrizione | metadata.description | Descrizione dell'evento |
| Protocollo | network.ip_protocol | Protocollo IP utilizzato nella connessione di rete |
| Direzione | network.direction | Direzione del traffico di rete |
| Origine | principal.port | Numero di porta del principal |
| Destinazione | target.port | Numero di porta della destinazione |
| SourceIP, principal_ip | principal.ip | Indirizzo IP del principale |
| SourceIP, principal_ip | principal.asset.ip | Indirizzo IP dell'asset dell'entità |
| DestinationIP | target.ip | Indirizzo IP del target |
| DestinationIP | target.asset.ip | Indirizzo IP dell'asset del target |
| HostName, hostname | principal.hostname | Nome host dell'entità |
| HostName, hostname | principal.asset.hostname | Nome host dell'asset del principal |
| ApplicationName | target.application | Nome dell'applicazione di destinazione |
| Nome utente | principal.user.userid | ID utente dell'entità |
| FullPath | target.file.full_path | Percorso completo del file |
| Stato | security_result.action | Azione intrapresa dal sistema di sicurezza |
| pid | principal.process.pid | ID di processo |
| src_application | principal.application | Nome dell'applicazione dell'entità |
| SubSeqNumber, FlowHandle, ClientZValue, MACAddress, State, IsXCast, FlowState, DLLMode | security_result.detection_fields | Campi di rilevamento del risultato di sicurezza |
| gravità | security_result.severity | Gravità del risultato di sicurezza |
| DB, NewApps, UniqueApps, Computers, Duration | additional.fields | Campi aggiuntivi |
| metadata.event_type | Tipo di evento | |
| metadata.product_name | Nome del prodotto | |
| metadata.vendor_name | Nome fornitore |
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.