Segredos e credenciais de clientes: acessos seguros sem compartilhar senhas
Publicado em 2026-11-14 por frfrand
Gerenciamento de chaves, rotação, permissões e revogação entre equipes e projetos.

O problema não é lembrar senhas: é controlar quem acessa o quê
Uma agência ou equipe técnica costuma administrar chaves SSH, tokens de API, acessos DNS, credenciais de banco de dados e contas de pagamento de clientes diferentes. Compartilhar tudo por chat ou reutilizar uma senha de administrador transforma um erro isolado em um problema para vários projetos.
Um inventário por cliente e por finalidade
Registre cada segredo com seu responsável, sistema, propósito, data de criação, data de revisão e procedimento de revogação. Não copie seu valor ao inventário: guarde esse valor em um cofre com criptografia, auditoria e controle de acesso.
A distinção essencial é entre identidade humana e credencial de serviço. Uma pessoa deve ter uma conta nominativa que possa ser desativada; uma integração deve ter sua própria identidade técnica, permissões mínimos e ciclo de vida independente. Evite contas compartilhadas de administrador quando o provedor permitir delegação.
Princípio do menor privilégio
Um técnico que mantém um site não precisa de acesso ao faturador nem a todos os servidores da empresa. Um pipeline que implanta uma API não precisa de permissões para excluir o banco de dados. Segmente permissões por ambiente, cliente e tarefa; exija MFA onde for possível e revise o acesso ao terminar cada projeto.
Para implantações automatizadas, priorize identidades de curta duração ou federação compatível com OIDC. Se você usar segredos armazenados no GitHub Actions, verifique o escopo de cada ambiente e quais workflows podem executá-los. Nunca coloque chaves em um repositório, no frontend, em uma imagem Docker publicada ou em logs.
Processo de admissão, rotação e desligamento
Quando um colaborador entra, solicite permissões nominativas e documente seu escopo. Quando uma chave muda, identifique primeiro os consumidores, crie a nova, atualize as dependências, valide seu funcionamento e revogue a anterior. Quando a colaboração terminar, desabilite identidades, tokens, SSH e sessões ativas de acordo com o sistema.
A rotação não é simplesmente mudar o texto em um arquivo. Um segredo de criptografia ou assinatura pode afetar sessões ou dados históricos. Projete compatibilidade temporal quando necessário e documente o plano de recuperação.
Resposta a um vazamento
Trate uma credencial exposta como potencialmente comprometida. Revogue-a, investigue onde foi usada, revise logs e permissões, substitua segredos derivados se for o caso e analise o escopo. Removê-la do último commit não a apaga do histórico nem garante que terceiros não a tenham copiado.
Modelo mínimo para uma pequena agência
Utilize um cofre corporativo com pastas por cliente, grupos de permissões, MFA, auditoria de acessos e recuperação. Reserve as credenciais de emergência sob procedimentos controlados. Em ambientes Linux, combine contas não privilegiadas, chaves SSH por pessoa e políticas de sudo ajustadas.
Você pode complementar este guia com GitHub Actions secrets e como evitar enviar segredos para o GitHub. ArduMaker oferece infraestrutura e ferramentas de implantação; avalie as capacidades de permissão necessárias antes de centralizar credenciais de clientes.
Perguntas frequentes
### Posso salvar chaves em variáveis de ambiente? São úteis para injeção de configuração, mas não substituem um armazenamento de segredos nem garantem proteção contra processos privilegiados. ### Cada cliente precisa de sua própria chave? Sim, sempre que a integração permitir, para limitar incidentes. ### Com que rotacioná-las? De acordo com a sensibilidade, duração, provedor e exposição; rotacione imediatamente diante de suspeita de vazamento.
Referência técnica: OWASP Secrets Management Cheat Sheet.