# Excluindo pastas e arquivos da varredura de segredos
Você pode personalizar secret scanning para fechar automaticamente alertas para segredos encontrados em diretórios ou arquivos específicos configurando um secret_scanning.yml arquivo em seu repositório.
Você pode ter um motivo para confirmar um segredo em um repositório, como quando deseja fornecer um segredo falso na documentação ou em um aplicativo de exemplo. Nesses cenários, você pode descartar rapidamente o alerta e documentar os motivos. No entanto, pode haver casos em que você deseja ignorar totalmente um diretório para evitar a criação de alertas falsos positivos em escala. Por exemplo, você pode ter um aplicativo monolítico com várias integrações contendo um arquivo de chaves fictícias que podem disparar vários alertas falsos para triagem.
Você pode configurar um `secret_scanning.yml` arquivo para fechar automaticamente os alertas encontrados em diretórios específicos secret scanninge excluir esses diretórios incluídos na proteção por push. Esses alertas são fechados como “ignorados pela configuração”.
## Excluindo diretórios de alertas de verificação de segredos para usuários
1. Em GitHub, acesse a página principal do repositório.
2. Acima da lista de arquivos, selecione o menu suspenso **Add file** e clique em ** Create new file**.
Como alternativa, é possível clicar em na exibição em árvore de arquivos à esquerda.
3. No campo de nome do arquivo, insira ".github/secret\_scanning.yml".
4. Em **Editar novo arquivo, digite**`paths-ignore:` seguido pelos caminhos dos secret scanningquais você deseja excluir.
```yaml copy
paths-ignore:
- "docs/**"
```
Isso instrui secret scanning a fechar alertas automaticamente para tudo que estiver no diretório `docs`. Você pode usar esse arquivo de exemplo como um modelo para adicionar os arquivos e pastas que deseja excluir de seus próprios repositórios.
Você também pode usar caracteres especiais, como `*` para filtrar caminhos. Para obter mais informações sobre os padrões de filtro, confira [Sintaxe de fluxo de trabalho do GitHub Actions](/pt/actions/reference/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet).
```yaml copy
paths-ignore:
- "foo/bar/*.js"
```
> \[!NOTE]
>
> * Se houver mais de 1.000 entradas, `paths-ignore`secret scanning apenas excluirá os primeiros 1.000 diretórios das verificações.
> * Se `secret_scanning.yml` for maior que 1 MB, secret scanning ignorará todo o arquivo.
## Verificando se a pasta está excluída de secret scanning
1. Abra um arquivo em um diretório que você excluiu da varredura de segredos
2. Cole um segredo pré-invalidado ou um segredo de teste.
3. Confirme a alteração.
4. Em GitHub, acesse a página principal do repositório.
5. No nome do repositório, clique na ** Security and quality** guia. Se você não conseguir ver a guia " Security and quality", selecione o **** menu suspenso e clique em ** Security and quality**. Não deve haver novos alertas abertos para o segredo que você acabou de introduzir no arquivo.
## Práticas recomendadas
Melhores práticas incluem:
* Minimizar o número de diretórios excluídos e ser o mais preciso possível ao definir exclusões. Isso garante que as instruções sejam o mais claras possível e que as exclusões funcionem conforme o esperado.
* Explicar por que um determinado arquivo ou pasta é excluído em um comentário no arquivo `secret_scanning.yml`. Assim como em código normal, o uso de comentários esclarece sua intenção, tornando mais fácil para outras pessoas entender o comportamento desejado.
* Revisar o arquivo `secret_scanning.yml` regularmente. Algumas exclusões podem não se aplicar mais com o tempo, e é uma boa prática manter o arquivo limpo e atualizado. O uso de comentários, conforme aconselhado acima, pode ajudar nisso.
* Informar à equipe de segurança quais arquivos e pastas você excluiu e por quê. Uma boa comunicação é vital para garantir que todos estejam na mesma página e entendam por que pastas ou arquivos específicos são excluídos.