Por que não basta apagar o arquivo depois?
A chave continua no histórico do Git, e num repositório público robôs acham em minutos. O único conserto é trocar a chave no site do provedor. Por isso o melhor é não deixar entrar.
O gitleaks confere cada commit e barra os que levam uma chave de API ou uma senha, e o Git passa a ignorar os arquivos .env e as chaves em todos os projetos.
seguranca/segredos
Risco baixo
Pede a senha de administrador
Testada em máquina virtual no Ubuntu e no Debian
Em resumo
.env e as chaves privadas em todos os projetos, inclusive os que você clonar depois.core.hooksPath que você já tinha.core.hooksPath do projeto.git commit --no-verify, para quando o gitleaks errar.Passo a passo
As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.
Confere se o git e o gitleaks estão instalados, se o arquivo de exclusões globais tem o bloco do bora e se o core.hooksPath aponta para os ganchos do bora.
core.hooksPath.~/.config/git/ignore (ou ao arquivo do core.excludesFile).~/.config/git/ganchos-bora, com o gancho e um link para cada nome de gancho, e configura o core.hooksPath.Num repositório de teste, como a pessoa: um .env fica fora do Git, um commit com um token do GitHub inventado é barrado, um commit sem segredo passa e um gancho do próprio projeto continua rodando.
Tira o core.hooksPath e o bloco do bora, apaga os ganchos e remove os pacotes que a receita instalou. As suas outras linhas ficam.
No terminal
A saída de um teste no Ubuntu 24.04, encurtada nas linhas do apt.
Os porquês
A chave continua no histórico do Git, e num repositório público robôs acham em minutos. O único conserto é trocar a chave no site do provedor. Por isso o melhor é não deixar entrar.
Assim vale para todo projeto, inclusive os que você clonar amanhã, sem lembrar de instalar nada. O gancho do bora chama o .git/hooks de cada projeto depois, para não quebrar o que já existia.
Ele às vezes acha que um texto de exemplo é uma chave. Melhor um alarme falso do que uma chave de verdade no GitHub. Confira o que ele apontou e, se for alarme falso, faça o commit com git commit --no-verify.
Como
.env, *.pem, *.key e as chaves SSH.core.hooksPath aponta para cá.Parâmetros
| Parâmetro | Padrão | O que é |
|---|---|---|
usuario | auto | A conta que vai programar. "auto" é quem rodou o bora com sudo. |
No menu, o bora pergunta o que precisa. Num script ou num agente, passe os parâmetros na linha de comando:bora plano --receitas seguranca/segredos -p seguranca/segredos.usuario=auto
Confira você mesmo
gitleaks detectConfere o projeto inteiro, com todo o histórico.git check-ignore -v .envMostra qual regra faz o Git ignorar o arquivo.git config --global core.hooksPathMostra a pasta dos ganchos da sua conta.Onde funciona
| Distro | Onde | Data | Resultado |
|---|---|---|---|
| Debian 13 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 24.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 26.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Debian 13 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 24.04 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 26.04 | Máquina virtual | 09/11/2026 | Passou |
Testada em contêiner: passou nos testes automáticos dessa família, que rodam num contêiner a cada pull request, sem kernel, disco nem tela de login de verdade. Testada em VM: além disso, foi aplicada, conferida e desfeita numa máquina virtual (VM) de verdade, o que o CI faz toda semana. O registro acima mostra a última vez de cada distro. Enquanto uma receita só tem o teste em contêiner, o bora avisa quando monta o plano. Testar numa máquina sua é uma das ajudas mais valiosas.
Onde ela entra
Fontes
Bora melhorar
Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.
Uma opção nova, um comportamento diferente ou algo que esta receita ainda não faz.
Fazer um pedidoUsa Fedora, Arch ou outra família? Diga qual, e conte se puder testar.
Pedir outra distroUma mudança que o bora ainda não sabe fazer, dentro deste rolê ou fora dele.
Pedir uma receitaAlgo não funcionou como esta página diz? O formulário já vem com o roteiro.
RelatarFicou confuso? Sugira um jeito melhor de dizer, direto no arquivo.
Ver no GitHub