Raccogli i log di Thinkst Canary

Supportata in:

Questo documento spiega come raccogliere i log di Thinkst Canary configurando un feed di Google Security Operations utilizzando l'API di terze parti.

Thinkst Canary fornisce un rilevamento delle minacce basato sull'inganno: i Canary hardware, virtuali e cloud simulano asset reali e i Canarytoken fungono da trappole in file, credenziali e URL. Quando un aggressore tocca un Canary o attiva un token, la console Canary registra un incidente. Il feed recupera gli incidenti dall'API Console.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Accesso con privilegi alla console Thinkst Canary

Configura l'API REST in Thinkst Canary

  1. Accedi alla console Thinkst Canary (https://<DOMAIN_HASH>.canary.tools).
  2. Fai clic sull'icona dell'ingranaggio nell'angolo in alto a destra e seleziona Impostazioni globali.
  3. Nel menu, fai clic su API.
  4. Se l'API è disabilitata, fai clic su Abilita API.
  5. Utilizza la chiave API predefinita esistente o fai clic su + Aggiungi nuova chiave API per crearne una dedicata:

    • API key type (Tipo di chiave API): seleziona Read-Only (Sola lettura). Questo è sufficiente per la raccolta dei log.
    • Nota: inserisci un nome per la chiave (ad esempio Google SecOps Integration).
  6. Copia e salva i seguenti dati in un luogo sicuro:

    • Domain Hash: l'identificatore della tua console. Il nome host dell'API è <DOMAIN_HASH>.canary.tools.
    • Token di autenticazione: la chiave API utilizzata per autenticare le richieste.

Configura un feed in Google SecOps per importare i log di Thinkst Canary

  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 es. Thinkst Canary Logs).
  5. Seleziona API di terze parti come Tipo di origine.
  6. Seleziona Thinkst Canary come Tipo di log.
  7. Fai clic su Avanti.
  8. Specifica i valori per i seguenti parametri di input:

    • Intestazione HTTP di autenticazione: il token generato in precedenza, nel formato auth_token:<TOKEN> (ad esempio, auth_token:AAAABBBBCCCC111122223333).
    • Nome host API: il nome di dominio completo dell'endpoint API REST Thinkst Canary, nel formato <DOMAIN_HASH>.canary.tools (ad esempio, myinstance.canary.tools).
    • 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.

Dopo la configurazione, il feed inizia a recuperare i log dall'istanza Thinkst Canary in ordine cronologico.

Aggiornamenti sugli incidenti e nuovo invio

L'API Canary Console restituisce un incidente ogni volta che viene aggiornato, non solo quando viene creato. Canary raggruppa gli eventi simili successivi provenienti dalla stessa origine nell'incidente esistente. Ad esempio, ogni tentativo di attacco brute-force diventa un evento all'interno di un singolo incidente. Anche altre modifiche agli incidenti possono attivare la nuova consegna.

In Google SecOps, aspettati il seguente comportamento:

  • Gli incidenti già pubblicati vengono visualizzati di nuovo nel feed dopo l'aggiornamento.
  • Un incidente inviato nuovamente può essere visualizzato con un timestamp dell'evento notevolmente precedente al momento in cui è stato inviato nuovamente. Questo perché il parser ricava i timestamp degli eventi dall'ora di creazione originale dell'incidente e dalle ore di occorrenza degli eventi raggruppati, non dall'ora di aggiornamento.

La nuova consegna è il comportamento documentato dell'API di raccolta degli incidenti (filtra in base al contatore degli aggiornamenti dell'incidente), non una perdita di dati o un difetto dell'analizzatore sintattico.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
_canary_uptime_label additional.fields Unita
desc_events_n_func_code_label additional.fields Unita
desc_events_n_func_name_label additional.fields Unita
desc_events_n_sfunc_code_label additional.fields Unita
desc_events_n_sfunc_name_label additional.fields Unita
desc_events_n_timestamp_std_label additional.fields Unita
desc_events_n_unit_id_label additional.fields Unita
description_created_std_label additional.fields Unita
description_events_list_label additional.fields Unita
event_data_list additional.fields Unita
event_descrip_label additional.fields Unita
events_url_label additional.fields Unita
local_time_label additional.fields Unita
locale_label additional.fields Unita
lt_label additional.fields Unita
offline_text_label additional.fields Unita
updated_label additional.fields Unita
updated_std_label additional.fields Unita
_auth extensions.auth Rinominato/mappato
_metadata metadata Rinominato/mappato
_event_time metadata.event_timestamp Analizzato come UNIX
_metadata_event_timestamp metadata.event_timestamp Analizzato come UNIX
description.created_std metadata.event_timestamp Analizzato come UNIX_MS
elem.timestamp_std metadata.event_timestamp Analizzato come yyyy-MM-dd HH:mm:ss ZZZ+0000
updated metadata.event_timestamp Analizzato come EEE, dd MMM yyyy HH:mm:ss ZZZ
updated_std metadata.event_timestamp Analizzato come UNIX_MS
format metadata.event_type Mappatura: grok → STATUS_UPDATE, grok → GENERIC_EVENT
has_principal_hostname metadata.event_type Mappatura: true → STATUS_UPDATE
_network network Rinominato/mappato
_observer observer Rinominato/mappato
_principal principal Rinominato/mappato
ThinkstCanary_Process principal.application Mappatura diretta
ThinkstCanary_Process principal.asset.hostname Mappatura diretta
ThinkstCanary_Hostname principal.hostname Mappatura diretta
_md_product_event_type security_result Valori mappati (10 in totale, ad es. Shared File Opened → _security_result, Host Port Scan → …
_security_result security_result Unita
format security_result Mappatura: kv → _security_result, json → _security_result
_source src Rinominato/mappato
_target target Rinominato/mappato
N/D metadata.event_type Costante: STATUS_UPDATE

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.