Raccogli i log di Aqua Security

Parser Version: 1.0

Supportata in:

Questo parser estrae i campi dai log di Aqua Security, trasformandoli nel formato Unified Data Model (UDM). Analizza il campo message come JSON, estrae l'utente, l'IP di origine e altri campi pertinenti, li mappa ai campi UDM e classifica gli eventi in base al campo action, arricchendo i dati con il contesto di sicurezza come nomi delle regole, descrizioni e dettagli CVE.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Istanza Google SecOps.
  • Accesso con privilegi alla console di gestione di Aqua Security.

Configura i feed

Per configurare un feed:

  1. Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic su Aggiungi nuovo feed.
  3. Nella pagina successiva, fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad esempio, Aqua Security Logs).
  5. Seleziona Webhook come Tipo di origine.
  6. Seleziona Aqua Security come Tipo di log.
  7. Fai clic su Avanti.
  8. (Facoltativo) Specifica i valori per i seguenti parametri di input:
    • Delimitatore di suddivisione: il delimitatore utilizzato per separare le righe di log, ad esempio \n.
    • Asset namespace: lo spazio dei nomi dell'asset.
    • Etichette di importazione: l'etichetta applicata agli eventi di questo feed.
  9. Fai clic su Avanti.
  10. Rivedi la configurazione del feed nella schermata Finalizza, quindi fai clic su Invia.
  11. Fai clic su Genera chiave segreta per generare una chiave segreta per autenticare questo feed.
  12. Copia e memorizza la chiave secret. Non potrai più visualizzare questa chiave segreta. Se necessario, puoi rigenerare una nuova chiave secret, ma questa azione rende obsoleta la chiave secret precedente.
  13. Nella scheda Dettagli, copia l'URL dell'endpoint del feed dal campo Informazioni sull'endpoint. Devi specificare questo URL dell'endpoint nella tua applicazione client.
  14. Fai clic su Fine.

Crea una chiave API per il feed del webhook

  1. Vai alla consoleGoogle Cloud > Credenziali.

    Vai a credenziali

  2. Fai clic su Crea credenziali e poi seleziona Chiave API.

  3. Limita l'accesso della chiave API all'API Chronicle.

Specifica l'URL dell'endpoint

  1. Nell'applicazione client, specifica l'URL dell'endpoint HTTPS fornito nel feed del webhook.
  2. Attiva l'autenticazione specificando la chiave API e la chiave segreta come parte dell'intestazione personalizzata nel seguente formato:

    X-goog-api-key = API_KEY
    X-Webhook-Access-Key = SECRET
    

    Suggerimento: specifica la chiave API come intestazione anziché nell'URL.

  3. Se il tuo client webhook non supporta le intestazioni personalizzate, puoi specificare la chiave API e la chiave segreta utilizzando parametri di ricerca nel seguente formato:

    ENDPOINT_URL?key=API_KEY&secret=SECRET
    

    Sostituisci quanto segue:

    • ENDPOINT_URL: l'URL dell'endpoint del feed.
    • API_KEY: la chiave API per l'autenticazione in Google SecOps.
    • SECRET: la chiave secret che hai generato per autenticare il feed.

Creazione di un webhook in Aqua Security per Google SecOps

  1. Accedi alla console Aqua Security.
  2. Vai a Impostazioni > Webhook dei risultati della scansione delle immagini.
  3. Seleziona la casella di controllo Abilita l'invio dei risultati della scansione delle immagini.
  4. Inserisci <ENDPOINT_URL>, seguito da <API_KEY> e <SECRET>.
  5. Fai clic su Salva.

Tabella di mappatura UDM

Campo log (crescente) Mappatura UDM Logica
jsonPayload.action metadata.event_type Mappato in base al valore di "jsonPayload.action". Consulta il codice del parser per le mappature specifiche.
jsonPayload.action security_result.summary Mappato direttamente.
jsonPayload.adjective target.file.full_path Mappato direttamente se "jsonPayload.container" è vuoto.
jsonPayload.category target.asset.category Mappato direttamente.
jsonPayload.cfappname target.application Mappato direttamente.
jsonPayload.cfspace principal.user.userid Mappato direttamente se "jsonPayload.user" è vuoto.
jsonPayload.command principal.ip Estratto utilizzando il pattern grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.command principal.user.userid Estratto utilizzando il pattern grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.container target.asset.product_object_id Mappato direttamente.
jsonPayload.data security_result.detection_fields Analizzato come coppie chiave-valore e mappato a singoli campi all'interno di "security_result.detection_fields".
jsonPayload.description security_result.description Mappato direttamente se "jsonPayload.reason" è vuoto.
jsonPayload.host principal.hostname Mappato direttamente.
jsonPayload.hostgroup target.group.group_display_name Mappato direttamente.
jsonPayload.hostid target.asset_id Mappato come "ID host: %{jsonPayload.hostid}".
jsonPayload.hostip target.ip Mappato direttamente.
jsonPayload.image target.file.full_path Mappato direttamente.
jsonPayload.level security_result.action Impostato su "ALLOW" se "jsonPayload.level" è "success".
jsonPayload.reason security_result.description Mappato direttamente.
jsonPayload.rule security_result.rule_name Mappato direttamente.
jsonPayload.user principal.user.userid Mappato direttamente.
jsonPayload.vm_location target.asset.location.name Mappato direttamente.
jsonPayload.vm_name target.resource.name Mappato direttamente.
resource.labels.instance_id target.resource.id Mappato direttamente.
resource.labels.project_id target.asset.attribute.cloud.project.id Mappato direttamente.
resource.labels.zone target.asset.attribute.cloud.availability_zone Mappato direttamente.
timestamp metadata.event_timestamp Mappato direttamente dopo la conversione nel formato ISO8601.
extensions.auth.type Impostato su "SSO" se "jsonPayload.description" contiene "SAML", altrimenti impostato su "AUTHTYPE_UNSPECIFIED" se "jsonPayload.action" è "login" o "Login".
metadata.log_type Imposta su "AQUA_SECURITY".
metadata.product_name Imposta su "AQUA_SECURITY".
metadata.vendor_name Imposta su "AQUA_SECURITY".
target.asset.attribute.cloud.environment Impostato su "GOOGLE_CLOUD_PLATFORM".
target.resource.type Impostato su "VIRTUAL_MACHINE".

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.