Raccogli i log di Aware Signals

Parser Version: 1.0

Supportata in:

Questo documento spiega come configurare Aware per inviare i log eventi di Signal a Google Security Operations utilizzando i webhook.

Aware (by Mimecast) è una piattaforma di sicurezza della collaborazione e di rischio interno che monitora i contenuti negli strumenti di comunicazione aziendale come Slack, Microsoft Teams, Zoom, Cisco Webex e Workvivo. L'applicazione Aware Signal utilizza modelli di AI, corrispondenza delle parole chiave, espressioni regolari e analisi del sentiment per rilevare violazioni delle policy e generare eventi. Questi eventi di Signal possono essere inoltrati a una destinazione SIEM per il monitoraggio della sicurezza centralizzato e la correlazione.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Un abbonamento alla piattaforma Aware con il modulo Signal abilitato
  • Un account amministratore di Aware con accesso alle impostazioni di sistema
  • Almeno una piattaforma di collaborazione (Slack, Microsoft Teams, Zoom, Webex o Workvivo) connessa e che importa contenuti in Aware
  • Almeno una regola e una policy di Signal configurate per generare eventi
  • Accesso alla console Google Cloud (per la creazione delle chiavi API)

Crea un feed webhook in Google SecOps

Crea il 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 di notizie.
  3. Nella pagina successiva, fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad es. Aware Signal Events).
  5. Seleziona Webhook come Tipo di origine.
  6. Seleziona Aware Signals come Tipo di log.
  7. Fai clic su Avanti.
  8. Specifica i valori per i seguenti parametri di input:
    • Delimitatore di suddivisione: inserisci \n (delimitatore di nuova riga per i payload NDJSON)
    • Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset
    • Etichette di importazione: l'etichetta da applicare agli eventi di questo feed
  9. Fai clic su Avanti.
  10. Controlla la nuova configurazione del feed di notizie nella schermata Finalizza, quindi fai clic su Invia.

Genera e salva la chiave segreta

Dopo aver creato il feed, devi generare una chiave segreta per l'autenticazione:

  1. Nella pagina dei dettagli del feed, fai clic su Genera chiave segreta.
  2. Viene visualizzata una finestra di dialogo con la chiave segreta.
  3. Copia e salva la chiave segreta in modo sicuro.

Ottieni l'URL dell'endpoint del feed

  1. Vai alla scheda Dettagli del feed.
  2. Nella sezione Informazioni sull'endpoint, copia l'URL endpoint del feed.
  3. Il formato dell'URL è:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Dove {region} è la regione dell'istanza Google SecOps (ad esempio us, europe o asia-southeast1) e {parent} è il percorso della risorsa nel formato projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Salva questo URL per i passaggi successivi.

  5. Fai clic su Fine.

Crea una chiave API Google Cloud

Google SecOps richiede una chiave API per l'autenticazione. Crea una chiave API limitata nella console Google Cloud .

Crea la chiave API

  1. Vai alla pagina Credenziali della consoleGoogle Cloud .
  2. Seleziona il tuo progetto (il progetto associato alla tua istanza di Google SecOps).
  3. Fai clic su Crea credenziali > Chiave API.
  4. Viene creata una chiave API, che viene visualizzata in una finestra di dialogo.
  5. Fai clic su Modifica chiave API per limitare la chiave.

Limita la chiave API

  1. Nella pagina delle impostazioni della chiave API:
    • Nome: inserisci un nome descrittivo (ad esempio Chronicle Webhook API Key)
  2. In Restrizioni API:
    1. Seleziona Limita chiave.
    2. Nel menu a discesa Seleziona API, cerca e seleziona API Google SecOps (o API Chronicle).
  3. Fai clic su Salva.
  4. Copia il valore della chiave API dal campo Chiave API nella parte superiore della pagina.
  5. Salva la chiave API in modo sicuro.

Ottieni la chiave API Aware

Aware utilizza una chiave API per autenticare le integrazioni esterne. Per ottenere la chiave:

  1. Accedi ad Aware all'indirizzo https://aware.work con un account amministratore.
  2. Fai clic su Impostazioni di sistema nell'angolo in basso a sinistra.
  3. Vai alla scheda Integrazioni.
  4. Copia la chiave API visualizzata nella pagina.

  5. Salva la chiave API in modo sicuro per utilizzarla nei passaggi successivi.

Configura l'inoltro dei webhook di Aware Signal

Crea l'URL webhook

  • Combina l'URL dell'endpoint Google SecOps, la chiave API e la chiave segreta:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Esempio:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Configura l'inoltro degli eventi in Aware

Configura Aware per inoltrare gli eventi Signal all'endpoint webhook di Google SecOps. I passaggi esatti possono variare a seconda della versione della piattaforma Aware.

  1. Accedi ad Aware all'indirizzo https://aware.work con un account amministratore.
  2. Fai clic su Impostazioni di sistema nell'angolo in basso a sinistra.
  3. Vai alla scheda Integrazioni.
  4. Configura una nuova destinazione webhook con i seguenti dettagli:

    • URL di destinazione: incolla l'URL webhook completo con la chiave API e la chiave secret aggiunte come parametri di ricerca:

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY
      
    • Content Type (Tipo di contenuti): seleziona application/json

    • Intestazione di autenticazione (se supportata dalla tua versione di Aware): imposta il nome dell'intestazione su X-Aware-Api-Key e il valore sulla tua chiave API Aware

  5. Seleziona i tipi di eventi da inoltrare. Per un monitoraggio completo della sicurezza, attiva l'inoltro di tutti gli eventi di Signal:

    • Eventi di violazione delle norme
    • Eventi di corrispondenza delle parole chiave
    • Eventi di rilevamento di AI/sentiment
    • Eventi di rilevamento di comportamenti tossici
  6. Fai clic su Salva per attivare la destinazione webhook.

Alternativa: inoltra gli eventi utilizzando una funzione Cloud Run

Se la tua versione di Aware non supporta il push webhook nativo per gli eventi Signal, puoi utilizzare una funzione Cloud Run per eseguire il polling dell'API Aware e inoltrare gli eventi all'endpoint webhook di Google SecOps.

  1. Crea una funzione Cloud Run (Python 3.12 o versioni successive) con un trigger Pub/Sub.
  2. Configura la funzione in modo da:
    1. Esegui l'autenticazione all'API Aware utilizzando l'intestazione X-Aware-Api-Key.
    2. Esegui query sugli eventi di Signal dall'endpoint API Aware.
    3. Inoltra ogni evento come payload JSON all'URL dell'endpoint del webhook di Google SecOps.
  3. Utilizza Cloud Scheduler per richiamare la funzione a intervalli regolari (ad esempio ogni 5 minuti).

    • Esempio di richiesta di inoltro di eventi:

      curl -X POST "https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY" \
        -H "Content-Type: application/json" \
        -d '{"signal_id":"12345","event_type":"policy_violation","timestamp":"2026-01-15T10:30:00Z","user":"user@example.com","platform":"slack","policy":"Data Loss Prevention","rule":"Credit Card Numbers","message_snippet":"detected content"}'
      

Verifica l'invio degli eventi

  1. In Google SecOps, vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic sul feed Aware Signal Events (Eventi di segnale Aware).
  3. Vai alla scheda Stato.
  4. Verifica che gli eventi vengano ricevuti.
  5. In alternativa, attiva un evento di test di Segnale in Aware:

    1. In Aware, vai a Signal > Eventi.
    2. Verifica che i nuovi eventi vengano generati dalle tue policy.
    3. Attendi qualche minuto affinché gli eventi vengano visualizzati in Google SecOps.

Tipi di eventi di Aware Signal

Aware Signal rileva gli eventi su piattaforme di collaborazione collegate utilizzando una combinazione di modelli di AI, corrispondenza delle parole chiave, espressioni regolari e analisi del sentiment. In genere vengono generate le seguenti categorie di eventi:

Categoria Descrizione Esempi
Violazione delle norme Eventi attivati da regole delle policy definite Rilevamento di parole chiave, corrispondenza di pattern regex, dati sensibili
AI/Sentiment Eventi rilevati dai modelli di AI e sentiment Linguaggio tossico, sentiment negativo, molestie
Perdita dei dati Eventi correlati alla potenziale esfiltrazione di dati Violazioni della condivisione di file, condivisione esterna, esposizione delle credenziali
Rischio interno Eventi che indicano potenziali minacce interne Pattern di comportamento insoliti, anomalie di accesso, rischio di dipendenti in uscita
Conformità Eventi relativi alla conformità legale Esposizione di PII, condivisione di dati finanziari, violazioni dell'HIPAA

Riferimento ai metodi di autenticazione

I feed dei webhook di Google SecOps supportano diversi metodi di autenticazione. Scegli il metodo supportato dal tuo fornitore.

Metodo 1: parametri di query

Aggiungi le credenziali all'URL webhook.

  • Formato dell'URL:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Esempio:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Metodo 2: intestazioni personalizzate

Se la tua configurazione supporta le intestazioni HTTP personalizzate, utilizza questo metodo per una maggiore sicurezza.

  • Headers:

    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    

Vantaggi:

  • Chiave API e secret non visibili nell'URL
  • Più sicuro (le intestazioni non vengono registrate nei log di accesso del server web)

Limiti e best practice dei webhook

Limiti per le richieste

Limite Valore
Dimensioni massime della richiesta 4 MB
QPS (query al secondo) max 15.000
Timeout richieste 30 secondi
Comportamento dei nuovi tentativi Automatico con backoff esponenziale

Best practice

  • Attiva l'inoltro per tutti i tipi di eventi di indicatori per garantire una copertura di sicurezza completa
  • Monitora regolarmente lo stato di invio del webhook per verificare la presenza di errori o ritardi
  • Utilizza il delimitatore di suddivisione \n nella configurazione del feed di Google SecOps per gestire i payload NDJSON
  • Testa l'integrazione con una violazione delle norme nota prima di eseguire il deployment in produzione
  • Esamina periodicamente le policy di Aware Signal per assicurarti che vengano acquisiti gli eventi pertinenti

Risoluzione dei problemi

Gli eventi non vengono visualizzati in Google SecOps

Causa: gli eventi vengono generati in Aware, ma non vengono importati

Soluzione:

  1. In Google SecOps, vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic sul feed Eventi di Aware Signal.
  3. Vai alla scheda Stato.
  4. Controlla se sono presenti errori di importazione.
  5. Verifica che il tipo di log sia impostato su Aware Signals.
  6. Verifica che la chiave API e la chiave segreta nell'URL webhook siano corrette.

Errori di autenticazione

Causa: chiave API o chiave segreta non valida

Soluzione:

  1. Verifica che la chiave API di Google SecOps sia valida e che abbia la restrizione API corretta.
  2. Verifica che la chiave segreta corrisponda a quella generata durante la creazione del feed.
  3. Testa l'endpoint manualmente:

    curl -X POST "https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=YOUR_API_KEY&secret=YOUR_SECRET_KEY" \
        -H "Content-Type: application/json" \
        -d '{"test": "event"}'
    
  4. Se il test non va a buon fine, rigenera la chiave API o la chiave secret e aggiorna la configurazione del webhook in Aware.

Il payload supera le dimensioni massime

Causa: i payload degli eventi superano il limite di 4 MB

Soluzione:

  1. Riduci il numero di tipi di eventi inoltrati.
  2. Contatta l'assistenza di Aware per configurare i limiti di dimensione del payload.
  3. Se utilizzi l'approccio con Cloud Run Functions, implementa il raggruppamento in batch per suddividere i payload di grandi dimensioni in più richieste.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
has_principal metadata.event_type Mappatura: true → NETWORK_CONNECTION, true → STATUS_UPDATE
has_user metadata.event_type Mappatura: true → USER_UNCATEGORIZED
signalEventDetails.eventStatus security_result.action_details Mappatura diretta
contentObjectDetails_contentObjectIsChat_label security_result.detection_fields Unita
contentObjectDetails_contentObjectIsThread_label security_result.detection_fields Unita
detectionLength_label security_result.detection_fields Unita
detectionStart_label security_result.detection_fields Unita
ruleConditionMatches_label security_result.detection_fields Unita
search_label security_result.detection_fields Unita
signalEventDetails_createdTime_label security_result.detection_fields Unita
signalEventDetails_deletedTime_label security_result.detection_fields Unita
signalEventDetails_inspectionRequestId_label security_result.detection_fields Unita
signalEventDetails_isQuarantined_label security_result.detection_fields Unita
signalEventDetails_policyDetails_createdTime_label security_result.detection_fields Unita
signalEventDetails_policyDetails_policyId_label security_result.detection_fields Unita
signalEventDetails_policyDetails_policyName_label security_result.detection_fields Unita
signalEventDetails_ruleBehavior_label security_result.detection_fields Unita
signalEventDetails_ruleFamilyId_label security_result.detection_fields Unita
signalEventDetails_tenantId_label security_result.detection_fields Unita
signalEventId_label security_result.detection_fields Unita
signal_EventDetails_policyDetails_deletedTime_label security_result.detection_fields Unita
snippetContent_label security_result.detection_fields Unita
snippetLength_label security_result.detection_fields Unita
snippetStart_label security_result.detection_fields Unita
signalEventDetails_ruleId security_result.rule_id Mappatura diretta
signalEventDetails_ruleName security_result.rule_name Mappatura diretta
contentGroupDetails.contentGroupScope_label target.group.attribute.labels Unita
contentObjectDetails_contentGroupDetails_contentGroupTag_label target.group.attribute.labels Unita
contentGroupDetails_contentGroupName target.group.group_display_name Mappatura diretta
contentObjectDetails_contentPlatformId_label target.resource.attribute.labels Unita
contentObjectDetails_contentTime_label target.resource.attribute.labels Unita
contentObjectDetails_contentObjectId target.resource.product_object_id Mappatura diretta
contentObjectDetails_contentObjectType target.resource.resource_subtype Mappatura diretta
contentAuthorDetails_contentAuthorEmail target.user.email_addresses Unita
contentAuthorDetails_contentAuthorName target.user.user_display_name Mappatura diretta
contentAuthorDetails_contentAuthorId target.user.userid Mappatura diretta
N/D metadata.event_type Costante: NETWORK_CONNECTION
N/D metadata.product_name Costante: AWARE SIGNALS
N/D metadata.vendor_name Costante: AWARE SIGNALS

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.