Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione e applicazione di filtri ai risultati di Macie

Per identificare e concentrarti sui risultati con caratteristiche specifiche, puoi filtrare i risultati sulla console Amazon Macie e nelle query inviate a livello di codice utilizzando Amazon Macie. API Quando crei un filtro, utilizzi attributi specifici dei risultati per definire criteri per includere o escludere i risultati da una vista o dai risultati delle query. Un attributo di ricerca è un campo che memorizza dati specifici per un risultato, come la gravità, il tipo o il nome della risorsa a cui si applica un risultato.

In Macie, un filtro è costituito da una o più condizioni. Ogni condizione, nota anche come criterio, è composta da tre parti:

Il modo in cui definisci e applichi le condizioni di filtro dipende dal fatto che utilizzi la console Amazon Macie o Amazon Macie. API

Filtrare i risultati utilizzando la console Amazon Macie

Se utilizzi la console Amazon Macie per filtrare i risultati, Macie offre opzioni per aiutarti a scegliere campi, operatori e valori per condizioni individuali. Puoi accedere a queste opzioni utilizzando le impostazioni dei filtri nelle pagine Findings, come mostrato nell'immagine seguente.

Utilizzando il menu Finding status, è possibile specificare se includere i risultati che sono stati soppressi (archiviati automaticamente) da una regola di soppressione. Utilizzando la casella Criteri di filtro, è possibile inserire le condizioni di filtro.

Quando posizionate il cursore nella casella Criteri di filtro, Macie visualizza un elenco di campi che è possibile utilizzare nelle condizioni di filtro. I campi sono organizzati per categorie logiche. Ad esempio, la categoria Campi comuni include campi che si applicano a qualsiasi tipo di ricerca e la categoria Campi di classificazione include campi che si applicano solo ai risultati di dati sensibili. I campi sono ordinati alfabeticamente all'interno di ogni categoria.

Per aggiungere una condizione, inizia scegliendo un campo dall'elenco. Per trovare un campo, sfoglia l'elenco completo o inserisci parte del nome del campo per restringere l'elenco dei campi.

A seconda del campo scelto, Macie mostra diverse opzioni. Le opzioni riflettono il tipo e la natura del campo scelto. Ad esempio, se scegli il campo Severità, Macie visualizza un elenco di valori tra cui scegliere: Basso, Medio e Alto. Se scegli il campo del nome del bucket S3, Macie visualizza una casella di testo in cui puoi inserire il nome del bucket. Qualunque campo tu scelga, Macie ti guida attraverso i passaggi per aggiungere una condizione che includa le impostazioni richieste per il campo.

Dopo aver aggiunto una condizione, Macie applica i criteri relativi alla condizione e aggiunge la condizione a un token di filtro nella casella Criteri del filtro, come mostrato nell'immagine seguente.

In questo esempio, la condizione è configurata per includere tutti i risultati di gravità media e alta e per escludere tutti i risultati di bassa gravità. Restituisce risultati in cui il valore del campo Severità è uguale a Medio o Alto.

Man mano che aggiungi altre condizioni, Macie applica i relativi criteri e li aggiunge ai token nella casella Filtra criteri. Puoi fare riferimento al riquadro in qualsiasi momento per determinare quali criteri hai applicato. Per rimuovere una condizione, scegli l'icona di rimozione della condizione ( ) nel token della condizione.

Filtraggio dei risultati in modo programmatico con Amazon Macie API

Per filtrare i risultati in modo programmatico, specifica i criteri di filtro nelle query inviate utilizzando Amazon Macie ListFindingso il GetFindingStatisticsfunzionamento di Amazon Macie. API L'ListFindingsoperazione restituisce una serie di risultatiIDs, un ID per ogni risultato che corrisponde ai criteri di filtro. L'GetFindingStatisticsoperazione restituisce dati statistici aggregati su tutti i risultati che corrispondono ai criteri di filtro, raggruppati in base a un campo specificato nella richiesta.

Tieni presente che le GetFindingStatistics operazioni ListFindings and sono diverse dalle operazioni utilizzate per sopprimere i risultati. A differenza delle operazioni di soppressione, che specificano anche criteri di filtro, le GetFindingStatistics operazioni ListFindings and interrogano solo i dati dei risultati. Non eseguono alcuna azione sui risultati che soddisfano i criteri di filtro. Per eliminare i risultati, utilizza il CreateFindingsFilterfunzionamento di Amazon API Macie.

Per specificare i criteri di filtro in una query, includi una mappa delle condizioni di filtro nella richiesta. Per ogni condizione, specificate un campo, un operatore e uno o più valori per il campo. Il tipo e il numero di valori dipendono dal campo e dall'operatore scelti. Per informazioni sui campi, gli operatori e i tipi di valori che è possibile utilizzare in una condizione, vedere Campi per filtrare i risultati di MacieUtilizzo degli operatori in condizioni, eSpecificare i valori per i campi.

Gli esempi seguenti mostrano come specificare i criteri di filtro nelle query inviate utilizzando AWS Command Line Interface (AWS CLI). Puoi farlo anche utilizzando la versione corrente di un altro strumento a riga di AWS comando o un AWS SDK, oppure inviando HTTPS richieste direttamente a Macie. Per informazioni sugli AWS strumenti eSDKs, consulta Tools to Build on AWS.

Negli esempi viene utilizzato il comando list-finding. Se un esempio viene eseguito correttamente, Macie restituisce un array. findingIds L'array elenca l'identificatore univoco per ogni risultato che corrisponde ai criteri di filtro, come illustrato nell'esempio seguente.

{
    "findingIds": [
        "1f1c2d74db5d8caa76859ec52example",
        "6cfa9ac820dd6d55cad30d851example",
        "702a6fd8750e567d1a3a63138example",
        "826e94e2a820312f9f964cf60example",
        "274511c3fdcd87010a19a3a42example"
    ]
}

Se nessun risultato corrisponde ai criteri di filtro, Macie restituisce un array vuotofindingIds.

{
    "findingIds": []
}

Esempio 1: filtra i risultati in base alla gravità

In questo esempio viene utilizzato il comando list-findings per recuperare i risultati di tutti i risultati di gravità elevata e media presenti nella versione corrente. IDs Regione AWS

Per Linux, macOS o Unix:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"severity.description":{"eq":["High","Medium"]}}}'

Per Microsoft Windows:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"severity.description\":{\"eq\":[\"High\",\"Medium\"]}}}

Dove:

Esempio 2: filtra i risultati in base alla categoria di dati sensibili

Questo esempio utilizza il comando list-finding IDs per recuperare i risultati di tutti i dati sensibili rilevati nella regione corrente e riportare le occorrenze di informazioni finanziarie (e nessun'altra categoria di dati sensibili) negli oggetti S3.

Per Linux, macOS o Unix, utilizzando il carattere di continuazione di riga con barra rovesciata (\) per migliorare la leggibilità:

$ aws macie2 list-findings \
--finding-criteria '{"criterion":{"classificationDetails.result.sensitiveData.category":{"eqExactMatch":["FINANCIAL_INFORMATION"]}}}'

Per Microsoft Windows, utilizzando il carattere di continuazione di riga con cursore (^) per migliorare la leggibilità:

C:\> aws macie2 list-findings ^
--finding-criteria={\"criterion\":{\"classificationDetails.result.sensitiveData.category\":{\"eqExactMatch\":[\"FINANCIAL_INFORMATION\"]}}}

Dove:

Esempio 3: filtra i risultati in base a un intervallo di tempo fisso

Questo esempio utilizza il comando list-findings IDs per recuperare i risultati di tutti i risultati che si trovano nella regione corrente e sono stati creati tra le 07:00 del 5 UTC ottobre 2020 e le 07:00 del 5 UTC novembre 2020 (inclusi).

Per Linux, macOS o Unix:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"createdAt":{"gte":1601881200000,"lte":1604559600000}}}'

Per Microsoft Windows:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"createdAt\":{\"gte\":1601881200000,\"lte\":1604559600000}}}

Dove:

Esempio 4: filtra i risultati in base allo stato di soppressione

Questo esempio utilizza il comando list-finding IDs per recuperare i risultati di tutti i risultati che si trovano nella regione corrente e che sono stati soppressi (archiviati automaticamente) da una regola di soppressione.

Per Linux, macOS o Unix:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"archived":{"eq":["true"]}}}'

Per Microsoft Windows:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"archived\":{\"eq\":[\"true\"]}}}

Dove:

Esempio 5: filtra i risultati in base a più campi e tipi di valori

Questo esempio utilizza il comando list-finding IDs per recuperare i risultati per tutti i risultati relativi ai dati sensibili che si trovano nella regione corrente e soddisfano i seguenti criteri: sono stati creati tra le 07:00 del 5 UTC ottobre 2020 e le 07:00 del 5 UTC novembre 2020 (esclusivamente); segnala le occorrenze di dati finanziari e nessun'altra categoria di dati sensibili negli oggetti S3; e non sono stati soppressi (archiviati automaticamente) da una regola di soppressione.

Per Linux, macOS o Unix, utilizzando il carattere di continuazione di riga con barra rovesciata (\) per migliorare la leggibilità:

$ aws macie2 list-findings \
--finding-criteria '{"criterion":{"createdAt":{"gt":1601881200000,"lt":1604559600000},"classificationDetails.result.sensitiveData.category":{"eqExactMatch":["FINANCIAL_INFORMATION"]},"archived":{"eq":["false"]}}}'

Per Microsoft Windows, utilizzando il carattere di continuazione di riga con cursore (^) per migliorare la leggibilità:

C:\> aws macie2 list-findings ^
--finding-criteria={\"criterion\":{\"createdAt\":{\"gt\":1601881200000,\"lt\":1604559600000},\"classificationDetails.result.sensitiveData.category\":{\"eqExactMatch\":[\"FINANCIAL_INFORMATION\"]},\"archived\":{\"eq\":[\"false\"]}}}

Dove: