Compilare query o regole di rilevamento con watchlist in Microsoft Sentinel

Correlare i dati della watchlist con i dati Microsoft Sentinel con gli operatori tabulari Kusto, ad join esempio e lookup. Quando si crea un elenco di controllo, si definisce SearchKey. La chiave di ricerca è il nome di una colonna nell'elenco di controllo che si prevede di usare come join con altri dati o come oggetto frequente delle ricerche.

Per prestazioni ottimali delle query, usare SearchKey come chiave per i join nelle query.

Importante

Dopo il 31 marzo 2027, Microsoft Sentinel non sarà più supportato nel portale di Azure e sarà disponibile solo nel portale di Microsoft Defender. Tutti i clienti che usano Microsoft Sentinel nel portale di Azure verranno reindirizzati al portale di Defender e useranno Microsoft Sentinel solo nel portale di Defender.

Se si usa ancora Microsoft Sentinel nel portale di Azure, è consigliabile iniziare a pianificare la transizione al portale di Defender per garantire una transizione senza problemi e sfruttare appieno l'esperienza di operazioni di sicurezza unificata offerta da Microsoft Defender.

Compilare query con watchlist

Per usare un watchlist nella query di ricerca, scrivere una query Kusto che usa la funzione _GetWatchlist('watchlist-name') e usa SearchKey come chiave per il join.

  1. Per Microsoft Sentinel nel portale di Defender selezionare Microsoft Sentinel>Watchlist di configurazione>. Per Microsoft Sentinel nel portale di Azure, in Configurazione selezionare Watchlist.

  2. Selezionare l'elenco di controllo da usare.

  3. Selezionare Visualizza nei log.

    Screenshot che mostra come usare gli elenchi di controllo nelle query.

  4. Esaminare la scheda Risultati . Gli elementi nell'elenco di controllo vengono estratti automaticamente per la query.

    L'esempio seguente mostra i risultati dell'estrazione dei campi Nome e Indirizzo IP . SearchKey viene visualizzato come colonna specifica.

    Screenshot che mostra le query con campi watchlist.

    Il timestamp per le query verrà ignorato sia nell'interfaccia utente della query che negli avvisi pianificati.

  5. Scrivere una query che usa la funzione _GetWatchlist('watchlist-name') e utilizza SearchKey come chiave per il join.

    La query di esempio seguente, ad esempio, unisce la RemoteIPCountry colonna nella Heartbeat tabella con la chiave di ricerca definita per l'elenco di controllo denominato mywatchlist.

    Heartbeat
    | lookup kind=leftouter _GetWatchlist('mywatchlist') 
     on $left.RemoteIPCountry == $right.SearchKey
    

    L'immagine seguente mostra i risultati di questa query di esempio in Log Analytics.

    Screenshot delle query su watchlist come ricerca.

Creare una regola di analisi con un elenco di controllo

Per usare watchlist nelle regole di analisi, creare una regola usando la funzione _GetWatchlist('watchlist-name') nella query.

  1. In Configurazione selezionare Analisi.

  2. Selezionare Crea e il tipo di regola da creare.

  3. Nella scheda Generale immettere le informazioni appropriate.

  4. Nella scheda Imposta logica regola , in Query regola usare la _GetWatchlist('<watchlist>') funzione nella query.

    Si supponga, ad esempio, di avere un elenco di controllo denominato ipwatchlist creato da un file CSV con i valori seguenti:

    IPAddress,Location
    10.0.100.11,Home
    172.16.107.23,Work
    10.0.150.39,Home
    172.20.32.117,Work

    Il file CSV è simile all'immagine seguente. Screenshot di quattro elementi in un file CSV usato per l'elenco di controllo.

    Per usare la _GetWatchlist funzione per questo esempio, la query sarà _GetWatchlist('ipwatchlist').

    Screenshot che mostra la query che restituisce i quattro elementi dell'elenco di controllo.

    In questo esempio vengono inclusi solo gli eventi degli indirizzi IP nell'elenco di controllo:

    //Watchlist as a variable
    let watchlist = (_GetWatchlist('ipwatchlist') | project IPAddress);
    Heartbeat
    | where ComputerIP in (watchlist)
    

    La query di esempio seguente usa l'elenco di controllo inline con la query e la chiave di ricerca definita per l'elenco di controllo.

    //Watchlist inline with the query
    //Use SearchKey for the best performance
    Heartbeat
    | where ComputerIP in ( 
        (_GetWatchlist('ipwatchlist')
        | project SearchKey)
    )
    

    L'immagine seguente mostra l'ultima query usata nella query delle regole.

    Screenshot che mostra come usare gli elenchi di controllo nelle regole di analisi.

  5. Completare le altre schede della procedura guidata regola di Analisi.

Gli elenchi di controllo vengono aggiornati nell'area di lavoro ogni 12 giorni, aggiornando il TimeGenerated campo. Per altre informazioni, vedere Creare regole di analisi personalizzate per rilevare le minacce.

Visualizzare l'elenco di alias watchlist

Potrebbe essere necessario visualizzare un elenco di alias watchlist per identificare una watchlist da usare in una regola di query o analisi.

  1. Per Microsoft Sentinel nel portale di Azure, in Generale selezionare Log.
    Nel portale di Defender selezionare Indagine & risposta>Ricerca>ricerca avanzata.

  2. Nella pagina Nuova query eseguire la query seguente: _GetWatchlistAlias.

  3. Esaminare l'elenco di alias nella scheda Risultati .

    Screenshot che mostra un elenco di watchlist.

Per altre informazioni sugli elementi seguenti usati negli esempi precedenti, vedere la documentazione di Kusto:

Per altre informazioni su KQL, vedere panoramica di Linguaggio di query Kusto (KQL).

Altre risorse:

In questo documento si è appreso come usare le watchlist in Microsoft Sentinel per arricchire i dati e migliorare le indagini. Per altre informazioni su Microsoft Sentinel, vedere gli articoli seguenti: