Módulo 8 · Curso de Segurança para Sites e Servidores
Segredos e projeto final
O achado mais grave da auditoria não estava no servidor nem no WordPress: estava no histórico do repositório, onde chaves de nuvem, tokens e senhas antigas continuavam guardados. Este módulo ensina a responder a um vazamento na ordem certa, a impedir o próximo e fecha o curso com o roteiro para auditar o seu próprio site.
Neste módulo
Aula 28
O histórico não esquece
Em algum momento, quase todo projeto commita um segredo: um .env no primeiro commit, uma chave colada num script para testar, uma senha de banco num arquivo de configuração. Alguém percebe, apaga o arquivo num commit novo e considera o assunto encerrado. Não está. O git guarda cada versão de cada arquivo, e o segredo continua lá, a um git log -p de distância, em todos os clones e forks.
O problema é grande e está crescendo. O relatório da GitGuardian de 2025 encontrou 23,8 milhões de segredos novos em commits públicos do GitHub em 2024, 25% a mais que no ano anterior. Os números que mais importam para quem tem repositório privado estão no gráfico:
Segredos em repositórios, segundo a GitGuardian
Indicadores do relatório de 2025, em porcentagem. Cada barra é um indicador separado.
Fonte: GitGuardian, State of Secrets Sprawl 2025: 4,6% dos repositórios públicos com segredo, 35% dos repositórios privados de clientes com segredo em texto puro, 58% dos vazamentos são credenciais genéricas (senhas e chaves sem formato reconhecível) e 70% dos segredos vazados em 2022 ainda válidos.
Duas conclusões saem desses números. Repositório privado não é cofre: mais de um terço deles tinha segredo. E o risco não envelhece: a maior parte das credenciais vazadas continua válida anos depois, porque o arquivo foi apagado e a chave nunca foi trocada. Na auditoria do curso, o histórico de uma branch antiga guardava chave de nuvem, token de CDN, token pessoal do GitHub e senhas de banco, todos de uma época em que o projeto ainda era outro.
Fontes desta aula: GitGuardian: State of Secrets Sprawl 2025
Aula 29
Resposta a um vazamento: revogar antes de limpar
Quando um segredo aparece no repositório, a ordem das ações decide se o problema acaba ou só some de vista:
A ordem da resposta
- Inventariar: rode uma ferramenta como o gitleaks em todo o histórico e em todas as branches, não só na principal. Monte uma lista com cada segredo, o serviço e o arquivo.
- Revogar e trocar: no painel de cada serviço (nuvem, CDN, GitHub, banco), invalide a credencial e gere outra. Este é o passo que torna inúteis todas as cópias que já existem.
- Conferir uso indevido: veja nos registros de cada serviço se a credencial antiga foi usada por alguém que não você.
- Limpar: só então reescreva o histórico com o
git filter-repo, ou simplesmente apague a branch antiga se ela não for mais necessária. Reescrever exige força no push e que todos os colaboradores clonem de novo. - Prevenir: a próxima aula.
# 1) Encontrar segredos em todo o histórico (todas as branches)
gitleaks git --log-opts="--all" --report-path vazamentos.json
# 4) Depois de revogar: remover um arquivo de todo o histórico
git filter-repo --invert-paths --path config/.env
git push --force --all
Fontes desta aula: GitHub: removing sensitive data · Gitleaks · OWASP: Secrets Management
Aula 30
Prevenção: segredos fora do código
A melhor prevenção é não precisar que ninguém lembre. Quatro práticas, juntas, fazem o segredo nunca chegar ao repositório:
- Segredos gerados no servidor. Senhas do banco, chaves do WordPress e a senha inicial do administrador são criadas por um script no próprio servidor, na primeira instalação, e ficam só no
.envde lá. O repositório guarda o script que gera, nunca o valor. - Segredos do pipeline no cofre do pipeline. A chave de deploy fica nos segredos do ambiente de produção do GitHub, liberada só após aprovação (módulo 6). Nunca num arquivo do repositório.
- Bloqueio no push. O push protection do GitHub recusa pushes com padrões conhecidos de segredo. Ligue nas configurações de segurança do repositório.
- Checagem antes do commit. Um hook local com o gitleaks pega padrões genéricos, como senhas, que o GitHub não reconhece.
# .gitignore
.env
.env.*
*.pem
*.key
# .pre-commit-config.yaml: gitleaks antes de cada commit
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.24.2
hooks:
- id: gitleaks
Um último cuidado, que conecta com o resto do curso: quem usa agentes de IA para programar deve lembrar que tudo o que o agente consegue ler pode acabar num commit ou numa mensagem. O relatório da GitGuardian observou taxa de vazamento 40% maior em repositórios públicos com assistentes de código ativos. Deixe os arquivos de segredo fora do alcance do agente, e não só fora do repositório. O módulo 9 mostra como dar a cada agente uma chave SSH própria, separada da sua.
Fontes desta aula: GitHub: push protection · GitGuardian (2025)
Aula 31
Projeto final: audite o seu site
O projeto final é repetir, no seu site, a auditoria que deu origem ao curso. Use o checklist abaixo na ordem em que está. Ele segue a priorização do módulo 1: primeiro o que dá acesso total, depois o que é explorado em massa, depois detecção e borda.
| Etapa | Verificação | Módulo |
|---|---|---|
| 1. Hoje | Rodar o gitleaks em todo o histórico e revogar tudo o que aparecer | 8 |
| 1. Hoje | SSH sem senha, chaves sem dono removidas, fail2ban ativo | 4 |
| 1. Hoje | WordPress, PHP e plugins em versões com suporte | 2 |
| 2. Esta semana | Mu-plugin fechando usuários na REST, XML-RPC, senhas de aplicativo, cadastro e comentários | 2 |
| 2. Esta semana | PHP bloqueado em uploads, testado com um arquivo de teste | 3 |
| 2. Esta semana | HTTPS forçado, TLS 1.2, HSTS moderado, regras de WAF e limite no login | 7 |
| 2. Esta semana | Aviso de login SSH por WhatsApp e e-mail, testado canal por canal | 5 |
| 3. Este mês | Plugins no repositório, painel sem instalar código, atualização pela imagem | 2 |
| 3. Este mês | Verificador de integridade de hora em hora com sinal de vida | 3 e 5 |
| 3. Este mês | Deploy com chave travada, script no servidor, CODEOWNERS e aprovação | 6 |
| 3. Este mês | Uma chave SSH por agente de IA, chave pessoal com senha ou FIDO2 e uma chave de deploy por repositório | 9 |
| 4. Quando puder | Chaves FIDO2, SSH pela rede privada, SSL Full (strict) com certificado de origem, DNSSEC com DS cadastrado | 4 e 7 |
Escreva um relatório curto ao terminar: o que encontrou, o que corrigiu, o que ficou pendente e por quê. Um bom relatório separa claramente o que depende de você (trocar uma senha num painel, ligar uma opção paga) do que já foi feito, e registra as decisões de não fazer algo, como deixar o Bot Fight Mode desligado, com o motivo. Daqui a seis meses, é esse registro que vai permitir repetir a auditoria em uma hora.
A ideia que atravessa o curso
Segurança não é um produto instalado, é um conjunto de decisões de arquitetura: o código vem de um lugar só, cada chave pode só o necessário, nada executa onde só deveria haver dados, o servidor não obedece ao repositório e todo alarme sai da máquina vigiada. Com essas decisões tomadas, a maior parte das ferramentas vira detalhe.
Erros comuns
- Limpar o histórico e não trocar a chave. As cópias que já existem continuam funcionando.
- Procurar só na branch principal. Branches antigas e tags guardam o histórico inteiro.
- Confiar no repositório privado. Colaboradores, integrações e contas invadidas enxergam tudo.
- Commitar o .env de exemplo com valores reais. O arquivo de exemplo deve ter só nomes de variáveis.
- Auditar uma vez e esquecer. Repita o checklist a cada seis meses e depois de qualquer mudança grande de infraestrutura.
Siglas usadas neste módulo
- CI:
- Continuous Integration, integração contínua, como o GitHub Actions.
- API:
- Application Programming Interface, interface para programas conversarem entre si.
- PAT:
- Personal Access Token, token pessoal de acesso a serviços como o GitHub.
- SSH:
- Secure Shell, protocolo de acesso remoto seguro a servidores.
- WAF:
- Web Application Firewall, firewall de aplicação web.
- TLS:
- Transport Layer Security, protocolo de criptografia das conexões HTTPS.
- HSTS:
- HTTP Strict Transport Security, cabeçalho que obriga o navegador a usar HTTPS.
- DNSSEC:
- DNS Security Extensions, extensões que assinam as respostas de DNS.
- XML-RPC:
- XML Remote Procedure Call, protocolo antigo de chamadas remotas do WordPress.
- FIDO2:
- Fast IDentity Online 2, padrão de autenticação com chaves guardadas em dispositivos.
- OWASP:
- Open Worldwide Application Security Project, fundação de segurança de aplicações.
Perguntas frequentes
Apaguei o arquivo com a senha num commit novo. O problema está resolvido?
Por que revogar a credencial antes de limpar o histórico?
Repositório privado é suficiente para guardar segredos?
O que é push protection e como ela ajuda?
Por onde começar se eu só tiver uma tarde para melhorar a segurança do meu site?
Referências
Livros
JANCA, T. Alice and Bob Learn Application Security.
Wiley, 2020. Segurança no ciclo de desenvolvimento, incluindo gestão de segredos e checagens automáticas no pipeline.
ANDERSON, R. Security Engineering.
3. ed. Wiley, 2020. Os capítulos sobre controle de acesso e gestão de chaves dão a base conceitual para tratar credenciais como ativos.