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à.
# Definizione delle regole di filtro per i risultati di Macie
Per eseguire un'analisi coerente dei risultati, puoi creare e applicare regole di filtro. Una *regola di filtro* è un insieme di criteri di filtro che crei e salvi per riutilizzarli quando esamini i risultati sulla console Amazon Macie. Le regole di filtro possono aiutarti a eseguire analisi ripetute e coerenti di risultati con caratteristiche specifiche. Ad esempio, è possibile creare una regola di filtro per analizzare tutti i dati sensibili ad alta gravità che riportano tipi specifici di dati sensibili. Puoi creare un'altra regola di filtro per analizzare tutti i risultati delle policy ad alta severità per i bucket Amazon Simple Storage Service (Amazon S3) che memorizzano oggetti non crittografati.
Quando crei una regola di filtro, utilizzi attributi specifici dei risultati per definire criteri per includere o escludere i risultati da una vista. Un *attributo di ricerca* è un campo che memorizza dati specifici per un risultato, come la gravità, il tipo o il nome del bucket S3 a cui si applica un risultato. È inoltre necessario specificare un nome e, facoltativamente, una descrizione della regola. Per analizzare quindi i risultati che corrispondono ai criteri della regola, scegli la regola. Macie applica i criteri della regola e visualizza solo i risultati che corrispondono ai criteri. Macie visualizza anche i criteri per aiutarti a determinare quali criteri ha applicato.
Nota che le regole di filtro sono diverse dalle regole di soppressione. Una *regola di soppressione* è un insieme di criteri di filtro creati e salvati per archiviare automaticamente i risultati che corrispondono ai criteri della regola. Sebbene entrambi i tipi di regole memorizzino e applichino criteri di filtro, una regola di filtro non esegue alcuna azione sui risultati che soddisfano i criteri della regola. Invece, una regola di filtro determina solo quali risultati vengono visualizzati sulla console dopo l'applicazione della regola. Per informazioni sulle regole di soppressione, vedere[Eliminazione dei risultati](findings-suppression.md).
**Topics**
+ [Creazione di una regola di filtro](findings-filter-rule-create.md)
+ [Applicazione di una regola di filtro](findings-filter-rule-apply.md)
+ [Modifica di una regola di filtro](findings-filter-rule-change.md)
+ [Eliminazione di una regola di filtro](findings-filter-rule-delete.md)
# Creazione di una regola di filtro per i risultati di Macie
Una *regola di filtro* è un insieme di criteri di filtro che crei e salvi per riutilizzarli quando esamini i risultati sulla console Amazon Macie. Le regole di filtro possono aiutarti a eseguire analisi ripetute e coerenti di risultati con caratteristiche specifiche. Ad esempio, potresti creare una regola di filtro per analizzare tutti i dati sensibili ad alta gravità che segnalano le occorrenze di dati sensibili, in particolare i bucket Amazon Simple Storage Service (Amazon S3). Puoi quindi applicare quella regola di filtro ogni volta che desideri identificare e analizzare i risultati che presentano le caratteristiche specificate.
Quando si crea una regola di filtro, si specificano i criteri di filtro, un nome e, facoltativamente, una descrizione della regola. Per i criteri di filtro, si utilizzano attributi specifici dei risultati per specificare se includere o escludere i risultati da una vista. 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. I criteri di filtro sono costituiti da una o più condizioni. Ogni condizione, nota anche come *criterio*, è composta da tre parti:
+ ****Un campo basato su attributi, come Severity o Finding type.****
+ *Un operatore, ad esempio uguale o non *uguale*.*
+ Uno o più valori. Il tipo e il numero di valori dipendono dal campo e dall'operatore scelti.
Dopo aver creato e salvato una regola di filtro, puoi applicarne i criteri di filtro scegliendo la regola. Macie utilizza quindi i criteri per determinare quali risultati visualizzare. Macie visualizza anche i criteri per aiutarti a determinare quali criteri hai applicato.
Nota che le regole di filtro sono diverse dalle regole di soppressione. Una *regola di soppressione* è un insieme di criteri di filtro creati e salvati per archiviare automaticamente i risultati che corrispondono ai criteri della regola. Sebbene entrambi i tipi di regole memorizzino e applichino criteri di filtro, una regola di filtro non esegue alcuna azione sui risultati che soddisfano i criteri della regola. Invece, una regola di filtro determina solo quali risultati vengono visualizzati sulla console dopo l'applicazione della regola. Per informazioni sulle regole di soppressione, vedere[Eliminazione dei risultati](findings-suppression.md).
**Per creare una regola di filtro per i risultati**
Puoi creare una regola di filtro utilizzando la console Amazon Macie o l'API Amazon Macie.
------
#### [ Console ]
Segui questi passaggi per creare una regola di filtro utilizzando la console Amazon Macie.
**Per creare una regola di filtro**
1. Apri la console Amazon Macie all'indirizzo. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Nel riquadro di navigazione, seleziona **Esiti**.
**Suggerimento**
Per utilizzare una regola di filtro esistente come punto di partenza, scegli la regola dall'elenco **Regole salvate**.
È inoltre possibile semplificare la creazione di una regola impostando innanzitutto i risultati in base a un gruppo logico predefinito e analizzando i risultati in base a un gruppo logico predefinito. In questo caso, Macie crea e applica automaticamente le condizioni di filtro appropriate, che possono essere un utile punto di partenza per creare una regola. Per fare ciò, scegli **Per bucket**, **Per tipo** o Per **lavoro nel riquadro di** navigazione (sotto **Risultati**). Quindi scegli un elemento nella tabella. Nel pannello dei dettagli, scegli il link relativo al campo su cui eseguire il pivot.
1. Nella casella **Criteri di filtro**, aggiungi le condizioni che definiscono i criteri di filtro per la regola.
![\[La casella Filtra criteri nella pagina Risultati.\]](http://docs.aws.amazon.com/it_it/macie/latest/user/images/scrn-findings-filter-bar-empty-conditions.png)
Per informazioni su come aggiungere condizioni di filtro, consulta[Creazione e applicazione di filtri ai risultati di Macie](findings-filter-procedure.md).
1. Al termine della definizione dei criteri di filtro per la regola, scegli **Salva regola** nella casella **Criteri di filtro**.
![\[Il link Salva regola nella casella Filtro criteri nella pagina Risultati.\]](http://docs.aws.amazon.com/it_it/macie/latest/user/images/scrn-findings-filter-bar-save-rule.png)
1. In **Regola di filtro**, inserisci un nome e, facoltativamente, una descrizione della regola.
1. Scegli **Save** (Salva).
------
#### [ API ]
Per creare una regola di filtro a livello di codice, utilizza il [CreateFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html)funzionamento dell'API Amazon Macie e specifica i valori appropriati per i parametri richiesti:
+ Per il `action` parametro, specifica `NOOP` in modo che Macie non sopprima (archivi automaticamente) i risultati che corrispondono ai criteri della regola.
+ Per il `criterion` parametro, specifica una mappa di condizioni che definiscono i criteri di filtro per la regola.
Nella mappa, ogni condizione deve specificare 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 Macie](findings-filter-fields.md)[Utilizzo degli operatori in condizioni](findings-filter-basics.md#findings-filter-basics-operators), e[Specificare i valori per i campi](findings-filter-basics.md#findings-filter-basics-value-types).
Per creare una regola di filtro utilizzando AWS Command Line Interface (AWS CLI), esegui il [create-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-findings-filter.html)comando e specifica i valori appropriati per i parametri richiesti. Gli esempi seguenti creano una regola di filtro che restituisce tutti i dati sensibili rilevati nella versione corrente Regione AWS e riporta le occorrenze di informazioni personali (e nessun'altra categoria di dati sensibili) negli oggetti S3.
Questo esempio è formattato per Linux, macOS o Unix e utilizza il carattere di continuazione di barra rovesciata (\$1) per migliorare la leggibilità.
```
$ aws macie2 create-findings-filter \
--action NOOP \
--name my_filter_rule \
--finding-criteria '{"criterion":{"classificationDetails.result.sensitiveData.category":{"eqExactMatch":["PERSONAL_INFORMATION"]}}}'
```
Questo esempio è formattato per Microsoft Windows e utilizza il carattere di continuazione di riga (^) per migliorare la leggibilità.
```
C:\> aws macie2 create-findings-filter ^
--action NOOP ^
--name my_filter_rule ^
--finding-criteria={\"criterion\":{\"classificationDetails.result.sensitiveData.category\":{\"eqExactMatch\":[\"PERSONAL_INFORMATION\"]}}}
```
Dove:
+ *my\$1filter\$1rule*è il nome personalizzato per la regola.
+ `criterion`è una mappa delle condizioni di filtro per la regola:
+ *classificationDetails.result.sensitiveData.category*è il nome JSON del campo della **categoria di dati sensibili**.
+ *eqExactMatch*specifica l'operatore *equals exact match.*
+ *PERSONAL\$1INFORMATION***è un valore enumerato per il campo Categoria di dati sensibili.**
Se eseguirai il comando correttamente, riceverai un output simile al seguente.
```
{
"arn": "arn:aws:macie2:us-west-2:123456789012:findings-filter/9b2b4508-aa2f-4940-b347-d1451example",
"id": "9b2b4508-aa2f-4940-b347-d1451example"
}
```
`arn`Dov'è l'Amazon Resource Name (ARN) della regola di filtro che è stata creata e `id` l'identificatore univoco della regola.
Per ulteriori esempi di criteri di filtro, consulta. [Filtraggio dei risultati in modo programmatico con l'API Amazon Macie](findings-filter-procedure.md#findings-filter-procedure-api)
------
# Applicazione di una regola di filtro ai risultati di Macie
Quando applichi una regola di filtro, Amazon Macie utilizza i criteri della regola per determinare quali risultati includere o escludere dalla visualizzazione dei risultati sulla console. Macie visualizza anche i criteri per aiutarti a determinare quali criteri hai applicato.
**Suggerimento**
Sebbene le regole di filtro siano progettate per l'uso con la console Amazon Macie, puoi utilizzare i criteri di una regola per interrogare i dati dei risultati in modo programmatico con l'API Amazon Macie. A tale scopo, recupera i criteri di filtro per la regola, quindi aggiungi i criteri alla tua query. Per recuperare i criteri, utilizzare l'[GetFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters-id.html)operazione. Per identificare quindi i risultati che corrispondono ai criteri, utilizzate l'[ListFindings](https://docs.aws.amazon.com/macie/latest/APIReference/findings.html)operazione e specificate i criteri nella query. Per informazioni sulla specificazione dei criteri di filtro in una query, vedere[Creazione e applicazione di filtri ai risultati di Macie](findings-filter-procedure.md).
**Per applicare una regola di filtro ai risultati**
Segui questi passaggi per filtrare i risultati sulla console Amazon Macie applicando una regola di filtro.
1. Apri la console Amazon Macie all'indirizzo. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Nel riquadro di navigazione, seleziona **Esiti**.
1. Nell'elenco **Regole salvate**, scegli la regola di filtro che desideri applicare. Macie applica i criteri della regola e li visualizza nella casella **Filtra criteri**.
1. Per rifinire i criteri, utilizzate la casella **Filtro criteri** per aggiungere o rimuovere le condizioni di filtro. In tal caso, le modifiche non influiranno sulle impostazioni della regola. Macie salva le modifiche solo se le salvi esplicitamente come nuova regola.
1. Per applicare una regola di filtro diversa, ripeti il passaggio 3.
Dopo aver applicato una regola di filtro, puoi rimuovere rapidamente tutti i relativi criteri di filtro dalla tua visualizzazione. A tale scopo, scegli la **X** nella casella **Criteri di filtro**.
# Modifica di una regola di filtro per i risultati di Macie
Dopo aver creato una regola di filtro, puoi perfezionarne i criteri e modificare altre impostazioni per la regola. Una *regola di filtro* è un insieme di criteri di filtro che crei e salvi per riutilizzarli quando esamini i risultati sulla console Amazon Macie. Le regole di filtro possono aiutarti a eseguire analisi ripetute e coerenti di risultati con caratteristiche specifiche. Ogni regola è composta da un insieme di criteri di filtro, un nome e, facoltativamente, una descrizione.
Oltre a modificare i criteri di filtro o altre impostazioni di una regola, è possibile assegnare tag a una regola. Un *tag* è un'etichetta che definisci e assegni a determinati tipi di AWS risorse. Ogni tag è composto da una chiave di tag obbligatoria e da un valore di tag opzionale. I tag possono aiutarti a identificare, classificare e gestire le risorse in diversi modi, ad esempio per scopo, proprietario, ambiente o altri criteri. Per ulteriori informazioni, consulta [Etichettare le risorse di Macie](tagging-resources.md).
**Per modificare una regola di filtro per i risultati**
Per assegnare tag o modificare le impostazioni di una regola di filtro, puoi utilizzare la console Amazon Macie o l'API Amazon Macie.
------
#### [ Console ]
Segui questi passaggi per assegnare tag o modificare le impostazioni di una regola di filtro utilizzando la console Amazon Macie.
**Per modificare una regola di filtro**
1. Apri la console Amazon Macie all'indirizzo. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Nel riquadro di navigazione, seleziona **Esiti**.
1. Nell'elenco **delle regole salvate**, scegli l'icona di modifica (![\[The edit icon, which is a blue pencil.\]](http://docs.aws.amazon.com/it_it/macie/latest/user/images/icon-edit-resource-blue.png)) accanto alla regola di filtro che desideri modificare o a cui assegnare i tag.
1. Effettua una delle seguenti operazioni:
+ Per modificare i criteri di filtro della regola, utilizza la casella **Criteri di filtro**. Nella casella, inserite le condizioni per i criteri desiderati. Per scoprire come, consulta [Creazione e applicazione di filtri ai risultati di Macie](findings-filter-procedure.md).
+ Per modificare il nome della regola, inserisci un nuovo nome nella casella **Nome** sotto **Regola di filtro**.
+ Per modificare la descrizione della regola, inserisci una nuova descrizione nella casella **Descrizione** sotto **Regola di filtro**.
+ Per assegnare tag alla regola, scegli **Gestisci tag** in **Regola di filtro**. Quindi aggiungi, rivedi e modifica i tag secondo necessità. Una regola può avere fino a 50 tag.
1. Una volta completate le modifiche, scegliere **Save (Salva)**.
------
#### [ API ]
Per modificare una regola di filtro a livello di codice, utilizza il [UpdateFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters-id.html)funzionamento dell'API Amazon Macie. Quando invii la richiesta, utilizza i parametri supportati per specificare un nuovo valore per ogni impostazione che desideri modificare.
Per il `id` parametro, specifica l'identificatore univoco della regola da modificare. Puoi ottenere questo identificatore utilizzando l'[ListFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html)operazione per recuperare un elenco di regole di filtro e soppressione per il tuo account. Se stai usando il AWS Command Line Interface (AWS CLI), esegui il [list-findings-filters](https://docs.aws.amazon.com/cli/latest/reference/macie2/list-findings-filters.html)comando per recuperare questo elenco.
Per modificare una regola di filtro utilizzando il AWS CLI, esegui il [update-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/update-findings-filter.html)comando e utilizza i parametri supportati per specificare un nuovo valore per ogni impostazione che desideri modificare. Ad esempio, il comando seguente modifica il nome di una regola di filtro esistente.
```
C:\> aws macie2 update-findings-filter --id 9b2b4508-aa2f-4940-b347-d1451example --name personal_information_only
```
Dove:
+ *9b2b4508-aa2f-4940-b347-d1451example*è l'identificatore univoco della regola.
+ *personal\$1information\$1only*è il nuovo nome della regola.
Se eseguirai il comando correttamente, riceverai un output simile al seguente.
```
{
"arn": "arn:aws:macie2:us-west-2:123456789012:findings-filter/9b2b4508-aa2f-4940-b347-d1451example",
"id": "9b2b4508-aa2f-4940-b347-d1451example"
}
```
`arn`Dov'è l'Amazon Resource Name (ARN) della regola che è stata modificata e `id` l'identificatore univoco della regola.
Analogamente, l'esempio seguente converte una regola di [soppressione in una regola](findings-suppression.md) di filtro modificando il valore del parametro da a. `action` `ARCHIVE` `NOOP`
```
C:\> aws macie2 update-findings-filter --id 8a1c3508-aa2f-4940-b347-d1451example --action NOOP
```
Dove:
+ *8a1c3508-aa2f-4940-b347-d1451example*è l'identificatore univoco della regola.
+ *NOOP*è la nuova azione che Macie deve eseguire sui risultati che soddisfano i criteri della regola: non eseguire alcuna azione (non sopprimere i risultati).
Se il comando viene eseguito correttamente, si ottiene un output simile al seguente:
```
{
"arn": "arn:aws:macie2:us-west-2:123456789012:findings-filter/8a1c3508-aa2f-4940-b347-d1451example",
"id": "8a1c3508-aa2f-4940-b347-d1451example"
}
```
`arn`Dov'è l'Amazon Resource Name (ARN) della regola che è stata modificata e `id` l'identificatore univoco della regola.
------
# Eliminazione di una regola di filtro per i risultati di Macie
Se crei una regola di filtro, puoi eliminarla in qualsiasi momento. Una *regola di filtro* è un insieme di criteri di filtro che crei e salvi per riutilizzarli quando esamini i risultati sulla console Amazon Macie. Se elimini una regola di filtro, la modifica non influisce sui risultati che corrispondono ai criteri della regola. Una regola di filtro determina solo quali risultati vengono visualizzati sulla console dopo l'applicazione della regola.
**Per eliminare una regola di filtro per i risultati**
Puoi eliminare una regola di filtro utilizzando la console Amazon Macie o l'API Amazon Macie.
------
#### [ Console ]
Segui questi passaggi per eliminare una regola di filtro utilizzando la console Amazon Macie.
**Per eliminare una regola di filtro**
1. Apri la console Amazon Macie all'indirizzo. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Nel riquadro di navigazione, seleziona **Esiti**.
1. Nell'elenco **delle regole salvate**, scegli l'icona di modifica (![\[The edit icon, which is a blue pencil.\]](http://docs.aws.amazon.com/it_it/macie/latest/user/images/icon-edit-resource-blue.png)) accanto alla regola di filtro che desideri eliminare.
1. In **Regola di filtro**, scegli **Elimina**.
------
#### [ API ]
Per eliminare una regola di filtro a livello di codice, utilizza il [DeleteFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters-id.html)funzionamento dell'API Amazon Macie. Per il `id` parametro, specifica l'identificatore univoco per la regola di filtro da eliminare. Puoi ottenere questo identificatore utilizzando l'[ListFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html)operazione per recuperare un elenco di regole di filtro e soppressione per il tuo account. Se stai usando il AWS Command Line Interface (AWS CLI), esegui il [list-findings-filters](https://docs.aws.amazon.com/cli/latest/reference/macie2/list-findings-filters.html)comando per recuperare questo elenco.
Per eliminare una regola di filtro utilizzando il AWS CLI, esegui il [delete-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/delete-findings-filter.html)comando. Esempio:
```
C:\> aws macie2 delete-findings-filter --id 9b2b4508-aa2f-4940-b347-d1451example
```
*9b2b4508-aa2f-4940-b347-d1451example*Dov'è l'identificatore univoco della regola di filtro da eliminare.
Se il comando viene eseguito correttamente, Macie restituisce una risposta HTTP 200 vuota. Altrimenti, Macie restituisce una risposta HTTP 4 *xx* o 500 che indica il motivo per cui l'operazione non è riuscita.
------