As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalhar com descobertas de amostras do Macie
Para explorar e aprender sobre os diferentes [tipos de descobertas](findings-types.md) que o Amazon Macie pode gerar, você pode criar amostras de descobertas. Amostras de descobertas usam dados de exemplo e valores de espaço reservado para demonstrar os tipos de informações que cada tipo de descoberta pode conter.
Por exemplo, o exemplo de descoberta **Policy: IAMUser /S3 BucketPublic** contém detalhes sobre um bucket fictício do Amazon Simple Storage Service (Amazon S3). Os detalhes da descoberta incluem dados de exemplo sobre um ator e uma ação que alteraram a lista de controle de acesso (ACL) do bucket e tornaram o bucket acessível ao público. Da mesma forma, a descoberta de **SensitiveDataamostra** de:s3object/multiple contém detalhes sobre uma pasta de trabalho fictícia do Microsoft Excel. Os detalhes da descoberta incluem exemplos de dados sobre os tipos e a localização de dados confidenciais na pasta de trabalho.
Além de se familiarizar com as informações que diferentes tipos de descobertas podem conter, você pode usar exemplos de descobertas para testar a integração com outros aplicativos, serviços e sistemas. Dependendo das [regras de supressão](findings-suppression.md) da sua conta, o Macie pode publicar exemplos de descobertas na Amazon EventBridge como eventos. Os dados de exemplo desses eventos podem ajudá-lo a desenvolver e testar soluções automatizadas para monitorar e processar descobertas com EventBridge. Dependendo das [configurações de publicação](findings-publish-frequency.md) da sua conta, o Macie também publica as descobertas no AWS Security Hub CSPM. Isso significa que você também pode usar amostras de descobertas para desenvolver e testar soluções para avaliar as descobertas do Macie com o Security Hub CSPM. Para obter informações sobre a publicação de descobertas nesses serviços, consulte [Monitorar e processar descobertas](findings-monitor.md).
**Topics**
+ [Como gerar amostras de descobertas](#findings-samples-create)
+ [Analisar exemplos de descobertas](#findings-samples-review)
+ [Suprimir exemplos de descobertas](#findings-samples-suppress)
## Como gerar amostras de descobertas
Você pode criar amostras de descobertas usando o console do Amazon Macie ou a API do Amazon Macie. Se você usa o console, o Macie gera automaticamente um exemplo de descoberta para cada tipo de descoberta compatível com o Macie. Se você usar a API, poderá criar um exemplo para cada tipo ou somente para determinados tipos que você especificar.
------
#### [ Console ]
Siga estas etapas para criar amostras de descobertas usando o console do Amazon Macie.
**Para criar exemplos de descobertas**
1. Abra o console do Amazon Macie em. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. No painel de navegação, selecione **Configurações**.
1. Em **Sample findings**, escolha **Generate sample findings**.
------
#### [ API ]
Para criar amostras de descobertas de forma programática, use a [CreateSampleFindings](https://docs.aws.amazon.com/macie/latest/APIReference/findings-sample.html)operação da API Amazon Macie. Ao enviar sua solicitação, opcionalmente use o parâmetro `findingTypes` para especificar somente determinados tipos de descobertas de amostra a serem criadas. Para criar automaticamente exemplos de todos os tipos, não inclua esse parâmetro na sua solicitação.
Para criar exemplos de descobertas usando o AWS Command Line Interface(AWS CLI), execute o [create-sample-findings](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-sample-findings.html)comando. Para criar automaticamente amostras de todos os tipos de descobertas, não inclua o parâmetro `finding-types`. Para criar exemplos somente de determinados tipos de descobertas, inclua esse parâmetro e especifique os tipos de exemplos de descobertas a serem criados. Por exemplo:
```
C:\> aws macie2 create-sample-findings --finding-types "{{SensitiveData:S3Object/Multiple}}" "{{Policy:IAMUser/S3BucketPublic}}"
```
Onde {{SensitiveData:S3Object/Multiple}} é um tipo de descoberta de dados confidenciais a ser criada e {{Policy:IAMUser/S3BucketPublic}} é um tipo de descoberta de política a ser criada.
Se o comando for executado com sucesso, o Macie retornará uma resposta vazia.
------
Se você criar amostras de descobertas novamente em 90 dias, o Macie gerará uma nova descoberta para cada tipo de descoberta de dados confidenciais que você criar. Para descobertas de políticas, o Macie atualiza cada descoberta de amostra existente incrementando a contagem de ocorrências e atualizando detalhes sobre quando a ocorrência subsequente ocorreu.
## Analisar exemplos de descobertas
Para ajudar você a identificar os exemplos de descobertas, o Amazon Macie define o valor do campo **Exemplo** de cada exemplo de descoberta como *Verdadeiro*. Além disso, o nome do bucket S3 afetado é o mesmo para todas as descobertas de amostra: *macie-sample-finding-bucket*. Se você analisar amostras de descobertas usando as páginas **Descobertas** no console do Amazon Macie, o Macie também exibirá o prefixo **[EXEMPLO]** no campo **Tipo de descoberta** para cada exemplo de descoberta.
------
#### [ Console ]
Siga estas etapas para analisar amostras de descobertas usando o console do Amazon Macie.
**Para revisar amostras de descobertas**
1. Abra o console do Amazon Macie em. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. No painel de navegação, selecione **Descobertas**.
1. Na página **Descobertas** siga um destes procedimentos:
+ Na coluna **Tipo de descoberta**, localize descobertas cujo tipo comece com **[EXEMPLO]**, conforme mostrado na imagem a seguir.
![A coluna Tipo de descoberta na página Descobertas. Lista as descobertas que têm o prefixo [EXEMPLO].](http://docs.aws.amazon.com/pt_br/macie/latest/user/images/scrn-findings-samples-all.png)
+ Usando a caixa **Critérios de filtro** acima da tabela, filtre a tabela para exibir somente descobertas de exemplos. Para fazer isso, coloque o cursor na caixa. Na lista de campos exibida, selecione **Exemplo**. Selecione **Verdadeiro** e, em seguida, selecione **Aplicar**.
1. Para analisar os detalhes de um exemplo de descoberta específico, selecione a descoberta. O painel de detalhes exibirá informações sobre a descoberta.
Você também pode baixar e salvar os detalhes de um ou mais exemplos de descobertas como um arquivo JSON. Para fazer isso, marque a caixa de seleção para cada amostra de descoberta que você deseja baixar e salvar. Em seguida, selecione **Exportar (JSON)** no menu **Ações** na parte superior da página **Descobertas**. Na janela exibida, selecione **Baixar**. Para obter descrições detalhadas dos campos JSON que uma descoberta pode incluir, consulte [Descobertas](https://docs.aws.amazon.com/macie/latest/APIReference/findings-describe.html) na *Referência de API do Amazon Macie*.
------
#### [ API ]
Para analisar as descobertas da amostra de forma programática, primeiro use a [ListFindings](https://docs.aws.amazon.com/macie/latest/APIReference/findings.html)operação da API do Amazon Macie para recuperar o identificador exclusivo `findingId` () para cada descoberta de amostra que você criou. Em seguida, use a [GetFindings](https://docs.aws.amazon.com/macie/latest/APIReference/findings-describe.html)operação para recuperar os detalhes dessas descobertas.
Ao enviar a solicitação de **ListFindings**, você pode especificar critérios de filtro para incluir somente resultados de amostra nos resultados. Para fazer isso, adicione uma condição de filtro onde o valor do campo `sample` seja `true`. Se você estiver usando o AWS CLI, execute o comando [list-findings](https://docs.aws.amazon.com/cli/latest/reference/macie2/list-findings.html) e use o `finding-criteria` parâmetro para especificar a condição do filtro. Por exemplo:
```
C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"sample\":{\"eq\":[\"true\"]}}}
```
Se a sua solicitação for realizada com êxito, o Macie retornará uma matriz `findingIds`. A matriz lista o identificador exclusivo de cada descoberta de exemplo para sua conta na Região da AWS atual.
Para então recuperar os detalhes das descobertas da amostra, especifique esses identificadores exclusivos em uma **GetFindings** solicitação ou, para o AWS CLI, ao executar o comando [get-findings](https://docs.aws.amazon.com/cli/latest/reference/macie2/get-findings.html).
------
## Suprimir exemplos de descobertas
Como outras descobertas, o Amazon Macie armazena exemplos de descobertas por 90 dias. Depois de concluir a revisão e a experimentação das amostras, você pode arquivá-las, opcionalmente, [criando uma regra de supressão](findings-suppression-rule-create.md). Se você fizer isso, os exemplos de descobertas deixarão de aparecer por padrão no console e seu status mudará para *arquivado*.
Para arquivar amostras de descobertas usando o console do Amazon Macie, configure a regra para arquivar descobertas em que o valor do campo **Amostra** seja **Verdadeiro**. Para arquivar amostras de descobertas usando a API do Amazon Macie, configure a regra para arquivar descobertas em que o valor do campo `sample` seja `true`.