Introdução: Por Que a Gestão de Segredos É Crítica
Uma única API key exposta num repositório público pode custar milhares de euros em poucos minutos. Bots automáticos vasculham constantemente o GitHub em busca de credenciais commitadas por erro.
O Que Você Aprenderá Neste Artigo
- Por que a gestão de segredos é fundamental para a segurança
- Como funcionam os GitHub Secrets (repositório, ambiente, organização)
- A diferença entre variáveis de ambiente e segredos
- Como gerir a segurança dos ficheiros
.env - A diferença entre segredos runtime e build-time
- Estratégias de rotação de segredos
- Soluções vault: HashiCorp Vault, AWS Secrets Manager, GCP Secret Manager
- Como prevenir o leak de segredos com git-secrets e pre-commit hooks
1. GitHub Secrets: A Base da Gestão de Segredos
Níveis de GitHub Secrets
| Nível | Âmbito | Caso de Uso | Quem Pode Aceder |
|---|---|---|---|
| Repository | Repositório único | API keys específicas do projeto | Todos os workflows do repo |
| Environment | Ambiente específico | Credenciais de produção | Só workflows com environment |
| Organization | Toda a organização | Tokens partilhados | Repositórios selecionados |
2. Variáveis de Ambiente vs Segredos
3. Segurança dos Ficheiros .env
4. Segredos Runtime vs Build-Time
Regra Fundamental para o Frontend
Nunca incluir segredos no bundle frontend. Qualquer valor presente nos ficheiros
environment.ts do Angular é visível para qualquer pessoa que abra as ferramentas de desenvolvedor do navegador.
5. Rotação de Segredos
6. Soluções Vault Enterprise
7. Prevenir o Leak de Segredos
8. Audit Trail e Conformidade
Checklist de Segurança de Segredos
- Todos os ficheiros
.envestão no.gitignore - Existe um ficheiro
.env.examplesem valores reais - Os segredos de produção usam GitHub Environment Secrets
- O ambiente de produção tem as protection rules ativas
- Os pre-commit hooks controlam os padrões de segredos
- A rotação de segredos está planeada trimestralmente
- A equipa sabe o que fazer em caso de leak
- Nenhum segredo privado está presente no código frontend
Conclusão
A gestão de segredos é um aspeto da segurança que não se pode descuidar.
No próximo artigo concentrar-nos-emos na performance: configuraremos performance budgets e Lighthouse CI no pipeline.







