Raccogli i log di Thinkst Canary
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
- Accedi alla console Thinkst Canary (
https://<DOMAIN_HASH>.canary.tools). - Fai clic sull'icona dell'ingranaggio nell'angolo in alto a destra e seleziona Impostazioni globali.
- Nel menu, fai clic su API.
- Se l'API è disabilitata, fai clic su Abilita API.
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).
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.
- Domain Hash: l'identificatore della tua console. Il nome host dell'API è
Configura un feed in Google SecOps per importare i log di Thinkst Canary
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed.
- Nella pagina successiva, fai clic su Configura un singolo feed.
- Nel campo Nome feed, inserisci un nome per il feed (ad es.
Thinkst Canary Logs). - Seleziona API di terze parti come Tipo di origine.
- Seleziona Thinkst Canary come Tipo di log.
- Fai clic su Avanti.
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.
- Intestazione HTTP di autenticazione: il token generato in precedenza, nel formato
Fai clic su Avanti.
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.