Implementa i parser della community in GitHub
Google Security Operations utilizza un repository open source su GitHub per consentire la collaborazione di community, partner e clienti per lo sviluppo e la manutenzione dei parser. Questo repository consente ai contributi della community di espandere e mantenere l'insieme di parser disponibili per Google SecOps.
Goals
- Abilita i contributi della community: consenti a utenti esterni, partner e clienti di contribuire con parser della community nuovi e aggiornati.
- Facilitare l'adozione: fornire agli utenti un meccanismo per adottare i parser della community nelle loro istanze di parser personalizzati.
- Garantire la qualità: mantenere un framework di controllo e test rigoroso per convalidare la sicurezza e la qualità funzionale di tutti i contributi prima della release.
Prima di iniziare
- Assicurati di disporre dell'autorizzazione
chronicle.parsers.create, che fa parte del ruolo IAMchronicle.admin. - Per contribuire ai parser della community, firma un Contratto di licenza per i collaboratori (CLA). Per i dettagli completi, consulta Firma il nostro Contratto di licenza per i collaboratori.
Struttura del repository
Tutti i parser sono organizzati nella directory parsers/ di primo livello nell'area Content Hub del repository GitHub. Ogni origine log ha la propria sottodirectory dedicata.
content-hub/
└── content/
└── parsers/
├── third_party/
│ ├── community/
│ │ ├── VENDOR1_PRODUCT1/cbn/
│ │ └── VENDOR2_PRODUCT2/cbn/
│ ├── partnerA/
│ │ └── VENDOR1_PRODUCT1/cbn/
│ └── partnerB/
│ └── VENDOR1_PRODUCT1/cbn/
...
Convenzioni di denominazione delle cartelle
Le convenzioni di denominazione delle cartelle per tutte le sottodirectory all'interno del repository third_party/community/parser sono definite in modo rigoroso. Questi standard garantiscono la compatibilità del sistema, la rilevabilità per i clienti e l'allineamento con le convenzioni interne di Google SecOps.
Crea un parser della community in GitHub
La sezione seguente descrive in dettaglio come creare e gestire i parser della community.
Individua e scarica i parser della community
- Vai alla cartella del tipo di log richiesto.
- Esamina il file
metadata.jsonper verificare la presenza di riferimenti relativi alle origini dei log supportate dal parser. - Scarica il file
parser.confche contiene la logica del parser di base nella sintassi CBN.
Esegui il deployment dei parser della community in Google SecOps
Il passaggio seguente spiega come copiare e convertire un parser della community nella tua istanza di parser personalizzato. Una volta eseguito il deployment, il parser funziona come un parser personalizzato che gestisci tu.
- Nella tua istanza di Google SecOps, carica o incolla i contenuti del file
parser.confscaricato nei campi corrispondenti della pagina Crea parser in Impostazioni > Gestione dei dati > Parser. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Parser.
Convalida il parser personalizzato
Dopo aver eseguito il deployment del parser nell'istanza Google SecOps, vengono attivate automaticamente le convalide dei parser specializzati integrate per verificare la presenza di potenziali errori della pipeline o problemi di normalizzazione. Se queste convalide non vanno a buon fine, devi correggere la logica del parser o modificare la copia del parser in modo che sia in linea con il tuo caso d'uso specifico. Ti invitiamo a contribuire con correzioni o miglioramenti al repository della community e a diventare un partecipante attivo della community open source.
Per informazioni dettagliate su come contribuire con nuovi parser o aggiornare quelli esistenti in GitHub, consulta le istruzioni per i parser di GitHub.
In caso di problemi con l'integrazione, apri una richiesta in GitHub. I parser della community non sono coperti dall'Assistenza Google.
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.