A senha do banco de dados de pedidos começou em um arquivo .env. Depois foi copiada para uma variável de CI para as migrations, para um Kubernetes Secret do serviço e para dois notebooks durante um incidente. Dois anos depois, ninguém conhece todas as cópias, então ninguém ousa rotacioná-la.
A GitGuardian contou 28,65 milhões de novos segredos fixos no código em commits públicos do GitHub em 2025, 34 % a mais em um ano, e mais de 64 % dos segredos que ela confirmou como válidos em 2022 ainda funcionavam em janeiro de 2026 (State of Secrets Sprawl 2026).
Este post monta uma arquitetura de gerenciamento de segredos sem senhas de banco de dados de longa duração: workload identity, credenciais dinâmicas de curta duração, envelope encryption com KMS, rotação e auditoria, com um diagrama do fluxo.
Onde os segredos estáticos dão errado
Cada cópia de um segredo estático é um lugar de onde ele pode vazar:
- O histórico do Git mantém o valor depois que você apaga a linha.
- Variáveis de CI podem ser lidas por qualquer pessoa que consiga alterar um job que as recebe.
- Variáveis de ambiente ficam visíveis para todos os processos do contêiner e acabam em logs e crash dumps. O cheat sheet de segredos da OWASP desaconselha seu uso, a menos que nada mais funcione.
- Kubernetes Secrets são armazenados sem criptografia no etcd por padrão, e qualquer pessoa que possa criar um Pod em um namespace consegue ler todos os Secrets dele, como alerta a documentação do Kubernetes.
Um gerenciador de segredos resolve o armazenamento, não o bootstrap: o app ainda precisa de uma credencial para buscar a sua credencial. A solução é uma identidade emitida pela plataforma, trocada por credenciais que expiram sozinhas.
Os blocos de construção
| Componente | Função | Exemplos |
|---|---|---|
| Gerenciador de segredos | Armazena e emite segredos, aplica políticas, acompanha leases | HashiCorp Vault, OpenBao, AWS Secrets Manager, Google Secret Manager, Azure Key Vault |
| KMS ou HSM | Guarda chaves de criptografia de chaves que nunca saem dele | AWS KMS, Google Cloud KMS, Azure Key Vault Managed HSM |
| Workload identity | Prova qual carga de trabalho está chamando, com tokens de plataforma de curta duração | Tokens de service account do Kubernetes, EKS Pod Identity, Workload Identity Federation for GKE, Microsoft Entra Workload ID |
| Entrega | Leva o segredo até o processo | Vault Agent, Secrets Store CSI Driver, External Secrets Operator, chamadas de SDK |
| Auditoria | Registra quem leu o quê e quando | Audit devices do Vault, AWS CloudTrail, um SIEM |
Envelope encryption com KMS
Um KMS não foi feito para dados em grande volume; o AWS KMS Encrypt aceita no máximo 4.096 bytes. A envelope encryption divide o trabalho:
GenerateDataKeydevolve uma chave de dados única em duas cópias: em texto puro e criptografada com a sua chave do KMS, a chave de criptografia de chaves (KEK).- Criptografe os dados localmente com a chave em texto puro e depois apague-a da memória.
- Armazene a chave de dados criptografada ao lado do texto cifrado. Para ler, envie-a ao
Decrypte descriptografe localmente.
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256
A KEK nunca sai do KMS sem criptografia, então todo uso é uma chamada de API que você pode autorizar e registrar em log (AWS KMS cryptography details). A rotação automática, depois de ativada, roda anualmente por padrão e altera só o material da chave para novas criptografias; o texto cifrado antigo continua sendo descriptografado.
O padrão aparece duas vezes aqui. O provider KMS do Kubernetes envolve as chaves de dados que criptografam os Secrets no etcd; use o KMS v2, pois o v1 está desativado por padrão desde o Kubernetes 1.29. O keyring do Vault é criptografado por uma chave raiz e, com auto-unseal, um KMS na nuvem descriptografa essa chave raiz quando o Vault inicia.
Como um Pod prova quem é
Todo Pod já tem uma identidade, sua service account, que também sustenta a identidade de workload em um service mesh. Com o método de autenticação Kubernetes do Vault:
- O kubelet solicita, pela API TokenRequest, um token de service account projetado com a audience
vault. Ele dura uma hora por padrão (mínimo de 10 minutos) e é renovado a 80 % do seu TTL. - O Vault Agent faz login com o token e uma role do Vault.
- O Vault valida o token com a API Kubernetes TokenReview. Um token vinculado se torna inválido quando expira ou quando seu Pod é excluído.
- O Vault confere a service account, o namespace e a audience com a role e devolve um token com suas políticas.
vault write auth/kubernetes/role/payments \
bound_service_account_names=payments-api \
bound_service_account_namespaces=payments \
audience=vault policies=payments-db token_ttl=1h
O token é uma credencial do portador, e a documentação de autenticação Kubernetes do Vault alerta contra compartilhá-lo com outros serviços. Uma audience dedicada faz com que os serviços que verificam aud o rejeitem.
Os serviços de workload identity da tabela trocam um token de service account projetado por credenciais de nuvem de curta duração, então nenhuma chave de nuvem é armazenada. O GitHub Actions OIDC faz o mesmo para jobs de deploy em um pipeline de CI/CD. O JWT authentication flow explica como esses tokens são verificados.
Credenciais dinâmicas de banco de dados
Um segredo dinâmico é criado sob demanda e destruído quando seu lease termina. Com o database secrets engine do Vault, cada leitura de database/creds/payments cria um novo usuário PostgreSQL:
vault write database/roles/payments db_name=orders \
creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO \"{{name}}\";" \
default_ttl=1h max_ttl=24h
Os leases podem ser renovados até max_ttl. O Vault Agent renova segredos renováveis após dois terços do lease e busca de novo os segredos com lease não renováveis a 90 % do TTL. Quando um lease expira ou é revogado, o Vault executa as instruções de revogação, por padrão uma instrução genérica de remoção de usuário. Sem TTL, vale o padrão do sistema do Vault de 768 horas (32 dias).
O que você ganha:
- Um usuário por Pod, de modo que uma consulta suspeita aponta para um lease, e não para todos os serviços que compartilham uma senha.
- Vazamentos expiram, no máximo uma hora após a emissão, a menos que o lease seja renovado.
- Resposta com um comando:
vault lease revoke -prefix database/creds/paymentsrevoga todas as credenciais ativas da role.
Uma pegadinha: VALID UNTIL faz a senha expirar, o que importa no login. Dê às conexões do pool uma vida máxima menor que o lease (o padrão do HikariCP é 30 minutos) e recarregue as credenciais quando o Vault Agent reescrever o arquivo.
Opções de entrega e trade-offs
| Entrega | Como funciona | Novos valores | Atenção a |
|---|---|---|---|
| Variáveis de ambiente | Definidas quando o contêiner inicia | Após uma reinicialização | Visíveis para todos os processos; vazam para logs e dumps |
| Kubernetes Secret sincronizado | O External Secrets Operator (atualização de hora em hora por padrão) ou o Vault Secrets Operator copia valores para um Secret | Volumes montados são atualizados; variáveis de ambiente não | Uma cópia no etcd: ative a criptografia em repouso e um RBAC restrito |
| Sidecar agent | O Vault Agent Injector renderiza os segredos em um volume em memória em /vault/secrets |
Sim, se o app reler o arquivo | Um sidecar e um init container em cada Pod |
| Volume CSI | O Secrets Store CSI Driver monta os segredos quando o Pod inicia | Só com a auto-rotação alpha, desativada por padrão | A sincronização opcional com um Secret traz de volta a cópia no etcd |
| Chamada de SDK | O app chama a API do gerenciador de segredos | Sim, no código | Autenticação, cache e retries em cada serviço |
Para credenciais dinâmicas, arquivos renderizados pelo agent são a melhor opção: o agent cuida do login, da renovação e da nova renderização. Use Secrets sincronizados quando Helm charts esperarem um ou quando você mantiver os secrets de um repositório GitOps como referências, e o SDK fora do Kubernetes.
Rotação sem downtime
A rotação tem uma regra: a nova credencial precisa funcionar antes que a antiga pare.
- Credenciais dinâmicas rotacionam por design, desde que os consumidores recarreguem a tempo.
- Senhas estáticas de banco de dados precisam de um job de rotação. No AWS Secrets Manager, a estratégia de usuário único mantém conexões abertas, mas pode negar chamadas por um instante, então os clientes precisam de retries; a estratégia de usuários alternados alterna entre dois usuários, de modo que um cliente que buscou o segredo no meio da rotação continua com credenciais válidas. A rotação pode rodar com a frequência de até a cada quatro horas.
- Chaves de API: faça o deploy da nova chave, confirme que o tráfego migrou e então revogue a antiga.
Logs de auditoria e acesso break-glass
O Vault envia uma entrada para cada requisição e resposta a todos os audit devices ativados e recusa requisições que nenhum device consiga registrar, por isso a HashiCorp recomenda ativar pelo menos dois. A maioria das strings é registrada como hashes HMAC-SHA256, e /sys/audit-hash calcula o hash de um valor conhecido para que você possa buscá-lo. Envie-o ao seu SIEM e crie alertas para o uso do root token e para mudanças de política.
O acesso break-glass deve ser tedioso e testado:
- Sem root token permanente. A HashiCorp recomenda root tokens só para a configuração inicial ou emergências, revogados logo depois.
vault operator generate-rootexige um quórum de detentores de chaves de unseal ou de recuperação. - Conheça suas dependências rígidas. Com auto-unseal, as chaves de recuperação não conseguem descriptografar a chave raiz, então o Vault não faz unseal sem sua chave do KMS. O AWS KMS espera de 7 a 30 dias antes de excluir uma chave; crie alertas para cada exclusão agendada.
O diagrama do fluxo de segredos
Conteúdo do diagrama
- Kubernetes API server
- Pod: payments-api
- Projected SA token
- Vault Agent (sidecar)
- App container
- Cloud KMS key
- Vault: auth, policies, leases
- Vault audit log to SIEM
- orders DB (PostgreSQL)
- 1 TokenRequest via kubelet
- read JWT
- 2 login: JWT + role payments
- 3 TokenReview
- 4 read database/creds/payments
- 5 CREATE ROLE ... VALID UNTIL
- 6 render /vault/secrets/db
- 7 connect as the short-lived user (TLS)
- 8 lease ends: DROP ROLE
- at startup: decrypt root key
- every request and response
Como ler:
- Esquerda: a moldura Pod com o token projetado, o sidecar Vault Agent e o app, sob o Kubernetes API server.
- Arestas roxas 1 a 3, identidade: TokenRequest (1), login com a role payments (2), TokenReview (3).
- Arestas verde-azuladas 4 a 7, a credencial: leitura de
database/creds/payments(4),CREATE ROLE ... VALID UNTIL(5), renderização de/vault/secrets/db(6), conexão via TLS (7). - Aresta vermelha tracejada 8: o lease termina e o Vault remove o usuário.
- Direita: o KMS descriptografa a chave raiz do Vault na inicialização; o log de auditoria recebe cada requisição e resposta.
- O bloco Markdown lista todos os tempos de vida.
Como desenhar diagramas de gerenciamento de segredos com clareza
- Numere os passos e pinte-os por fase: identidade, entrega, revogação.
- Escreva tempos de vida e audiences no diagrama. «aud vault, 1h» convida à revisão; «curta duração» convida à discussão.
- Mostre onde existe texto puro: memória, volumes em memória, variáveis de ambiente, etcd.
- Desenhe os caminhos de revogação e auditoria, não só o caminho feliz.
- Nunca coloque chaves, tokens ou hostnames internos reais em um diagrama.
- Deixe o armazenamento e os detalhes internos do cluster do Vault para um diagrama de operações.
O diagrama de fluxo de dados de threat modeling acrescenta limites de confiança, o modelo zero trust mostra o quadro de acesso mais amplo, e o diagrama de arquitetura do Kubernetes cobre o API server e o kubelet.
Monte no Archboard
- Entre com Google ou GitHub e crie um diagrama.
- Adicione uma Moldura do pacote Básico chamada Pod: payments-api. Dentro dela, empilhe um Token do pacote Segurança e dois nós Contêiner do pacote Docker: Vault Agent (sidecar) e App container.
- Acima da moldura, adicione um Cluster Kubernetes do pacote Nuvem com o rótulo Kubernetes API server.
- Adicione um Cofre do pacote Segurança no meio. À direita, adicione um Recurso de nuvem do pacote Nuvem para a chave do KMS, Registros do pacote DevOps para o log de auditoria e Postgres do pacote Dados.
- Desenhe as arestas 1 a 8 com setas de bloco (roxo para identidade, verde-azulado para a credencial, vermelho tracejado para DROP ROLE), além da aresta de inicialização até a chave do KMS e uma aresta tracejada até o log de auditoria.
- Adicione um bloco Markdown do pacote Básico com os tempos de vida e duas anotações de Texto do pacote Básico para a role do Vault e o usuário do banco de dados.
A ferramenta Kubernetes YAML to diagram transforma manifests existentes em um primeiro rascunho. O exemplo usa 10 nós de diagrama e fica dentro do plano Free.
Perguntas frequentes
Qual é a diferença entre um gerenciador de segredos e um KMS? Um KMS guarda chaves que nunca saem dele e criptografa itens pequenos, como chaves de dados. Um gerenciador de segredos armazena e emite os próprios segredos, como senhas e chaves de API, muitas vezes protegidos por um KMS.
Os Kubernetes Secrets são criptografados? Não por padrão. Ative a criptografia em repouso do etcd, de preferência com o provider KMS v2, e restrinja o RBAC: qualquer pessoa que possa criar Pods em um namespace pode ler os Secrets dele.
O que são segredos dinâmicos? Credenciais criadas sob demanda e excluídas quando o lease termina, como os usuários de banco de dados de uma hora que o database secrets engine do Vault cria a cada requisição.
Devo passar segredos como variáveis de ambiente? Evite quando puder: todos os processos do contêiner conseguem lê-las, elas vazam para logs e crash dumps e só mudam com uma reinicialização. Arquivos renderizados pelo agent são mais fáceis de proteger e rotacionar.
Com que frequência os segredos devem ser rotacionados? Credenciais dinâmicas expiram em horas e não precisam de agenda. Rotacione segredos estáticos em uma agenda e após qualquer suspeita de exposição ou troca de pessoal, e teste a rotação primeiro em staging.