Raccogli i log di rete di Cambium Networks
Versione parser: 2.0
Questo documento spiega come importare i log di Cambium Networks in Google Security Operations utilizzando l'agente Bindplane.
Gli switch di rete e i dispositivi wireless Cambium Networks generano messaggi syslog per eventi di rete, avvisi IDS e attività delle stazioni. Il parser estrae le coppie chiave-valore dai messaggi syslog 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 i dispositivi Cambium Networks
- Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
- Accesso amministrativo ai dispositivi Cambium Networks
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)
- Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
- Vai a IAM e amministrazione > Service account.
- Fai clic su Crea account di servizio.
- 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).
- Nome account di servizio: 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 e poi 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 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 > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > 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 > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.
Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.
Installa l'agente Bindplane
Installa l'agente Bindplane sul tuo sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.
Installazione di finestre
- 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-collectorIl servizio dovrebbe essere visualizzato come 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-collectorIl 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.
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.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/cambium_networks: 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: CAMBIUM_NETWORKS raw_log_field: body service: pipelines: logs/cambium_networks_to_chronicle: receivers: - udplog exporters: - chronicle/cambium_networks
Parametri di configurazione
Sostituisci i seguenti segnaposto:
Configurazione del ricevitore:
listen_address: indirizzo IP e porta su cui ascoltare:0.0.0.0per ascoltare su tutte le interfacce (consigliato)- La porta
514è la porta syslog standard (richiede l'accesso root su Linux; utilizza1514per 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
- Linux:
customer_id: ID cliente copiato dalla console Google SecOpslocation: 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 da IAM e amministrazione > Impostazioni.endpoint: mantieni l'impostazionechronicle.googleapis.com.
Esportatore API di importazione precedente
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'acquisizione e, se l'istanza si trova al di fuori degli Stati Uniti, sostituiscimalachiteingestion-pa.googleapis.comcon il tuo endpoint regionale (ad esempio,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/cambium_networks: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: CAMBIUM_NETWORKS raw_log_field: body
Salva il file di configurazione
- Dopo la modifica, salva il file:
- Linux: premi
Ctrl+O, poiEntere infineCtrl+X - Windows: fai clic su File > Salva.
- Linux: premi
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.
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"
- Premi
Configura l'esportazione di syslog dai dispositivi Cambium Networks
Cambium Networks ha più famiglie di dispositivi, ognuna con un percorso di configurazione syslog diverso.
ePMP 1000/2000/Force 180/200 ed ePMP Elevate
- Accedi alla GUI di Cambium Networks.
- Vai a Configure (Configura) > System (Sistema) > Syslog Logging (Logging Syslog).
- Configura le seguenti impostazioni:
- Syslog Mask (Maschera Syslog): fai clic su Select All (Seleziona tutto).
- Server 1: inserisci l'indirizzo IP dell'agente Bindplane.
- Fai clic su Salva.
ePMP 1000 HS e cnPilot E400/E500/E501
- Accedi alla GUI di Cambium Networks.
- Vai a Configure > System > Event Logging.
- Configura le seguenti impostazioni:
- Server Syslog 1: inserisci l'indirizzo IP dell'agente Bindplane.
- Fai clic su Salva.
(Facoltativo) Accedi alla CLI del dispositivo utilizzando SSH e inserisci il seguente comando per attivare il logging a livello di debug:
logging cnmaestro 7Salva e applica le impostazioni.
cnPilot R200/R201/R190
- Accedi alla GUI di Cambium Networks.
- Vai ad Administration (Amministrazione) > Management (Gestione) > System Log Settings (Impostazioni log di sistema).
- Configura le seguenti impostazioni:
- Syslog Enable (Attiva Syslog): seleziona Enable (Attiva).
- Syslog Level (Livello Syslog): seleziona INFO.
- Remote Syslog Enable (Attiva Syslog remoto): seleziona Enable (Attiva).
- Server Syslog remoto: inserisci l'indirizzo IP dell'agente Bindplane.
- Fai clic su Salva.
PMP 450/450i/450m AP
- Accedi alla GUI di Cambium Networks.
- Vai a Configuration > cnMaestro.
- Imposta cnMaestro Agent Debug Log Level (Livello di log di debug dell'agente cnMaestro) su INFO.
- Vai a Configuration > Syslog (Configurazione > Syslog).
- Configura le seguenti impostazioni:
- Syslog DNS Server Usage (Utilizzo del server DNS Syslog): seleziona Disable DNS Domain Name (Disattiva nome di dominio DNS).
- Server Syslog: inserisci l'indirizzo IP dell'agente Bindplane.
- Syslog Server Port (Porta server Syslog): inserisci il numero di porta dell'agente Bindplane.
- AP Syslog Transmit (Trasmissione syslog AP): seleziona Enabled (Attivata).
- SM Syslog Transmit (Trasmissione syslog SM): seleziona Enabled (Attivata).
- Syslog Minimum Level (Livello minimo syslog): seleziona info (informazioni).
- Fai clic su Salva.
PMP 450/450i/450m SM
- Accedi alla GUI di Cambium Networks.
- Vai a Configuration > cnMaestro.
- Imposta cnMaestro Agent Debug Log Level (Livello di log di debug dell'agente cnMaestro) su INFO.
- Vai a Configuration > Syslog (Configurazione > Syslog).
- Configura le seguenti impostazioni:
- Syslog Configuration Source (Origine configurazione Syslog): seleziona AP Preferred (AP preferito).
- Syslog DNS Server Usage (Utilizzo del server DNS Syslog): seleziona Disable DNS Domain Name (Disattiva nome di dominio DNS).
- Server Syslog: inserisci l'indirizzo IP dell'agente Bindplane.
- Syslog Server Port (Porta server Syslog): inserisci il numero di porta dell'agente Bindplane.
- Syslog Transmission (Trasmissione syslog): seleziona Obtain from AP (Ottieni da AP).
- Syslog Minimum Level Source (Origine livello minimo Syslog): seleziona AP Preferred (AP preferito).
- Syslog Minimum Level (Livello minimo syslog): seleziona info (informazioni).
- Fai clic su Salva.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| bssid | read_only_udm.principal.mac | Estratto da kv_fields utilizzando la chiave bssid. |
| canale | read_only_udm.security_result.about.resource.attribute.labels.value | Estratto da kv_fields utilizzando la chiave channel. Parte di un'etichetta. |
| host_name | read_only_udm.principal.hostname | Estratto dal messaggio di log utilizzando il pattern grok. |
| ids_event | read_only_udm.security_result.summary | Estratto da kv_fields utilizzando la chiave ids_event. |
| ids_status | read_only_udm.security_result.description | Estratto da kv_fields utilizzando la chiave ids_status. Utilizzato come descrizione, se presente. |
| iap | read_only_udm.security_result.about.resource.attribute.labels.value | Estratto da kv_fields utilizzando la chiave iap. Parte di un'etichetta. |
| produttore | read_only_udm.security_result.about.resource.attribute.labels.value | Estratto da kv_fields utilizzando la chiave manufacturer. Parte di un'etichetta. |
| rssi | read_only_udm.security_result.about.resource.attribute.labels.value | Estratto da kv_fields utilizzando la chiave rssi. Parte di un'etichetta. |
| sicurezza | read_only_udm.security_result.about.resource.attribute.labels.value | Estratto da kv_fields utilizzando la chiave security. Parte di un'etichetta. |
| gravità | read_only_udm.security_result.severity | Mappato dal messaggio di log utilizzando il pattern grok. alert viene mappato a HIGH, warn viene mappato a MEDIUM, tutto il resto viene mappato a LOW. |
| gravità | read_only_udm.security_result.severity_details | Mappato dal messaggio di log utilizzando il pattern grok. Conserva il valore di gravità originale. |
| ssid | read_only_udm.principal.application | Estratto da kv_fields utilizzando la chiave ssid. |
| timestamp | read_only_udm.metadata.event_timestamp | Estratto dal messaggio di log utilizzando il pattern grok e convertito in un timestamp. |
| read_only_udm.metadata.event_type | Determinato in base alla presenza di valori nei campi security_result e host_name. Se sono presenti entrambi i campi, il tipo di evento è impostato su STATUS_UPDATE, altrimenti è GENERIC_EVENT. |
|
| read_only_udm.security_result.about.resource.attribute.labels.key | Il valore di questo campo è determinato dalla logica del parser in base alla specifica coppia chiave-valore in fase di elaborazione. I valori possibili sono: Internet_Access_Provider, manufacturer, channel, received_signal_strength_indicator e encryption_standard. |
|
| read_only_udm.security_result.description | Se la gravità è warn, questo campo assume il valore kv_fields, altrimenti assume il valore ids_status. |
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.