Boas Práticas

Gestão de segredos: senhas, chaves de API e tokens

Chaves de API, tokens e senhas de servidor não devem ficar no código, no WhatsApp ou em planilha. Veja boas práticas de gestão de segredos.

V
Equipe Virtuault
· Publicado em
· Atualizado em

Quem desenvolve sites, cuida de lojas virtuais, administra servidores ou presta serviço de TI como autônomo acumula um tipo de credencial que vai além do login e senha: chaves de API, tokens de acesso, senhas de banco de dados, chaves SSH, credenciais de painéis de hospedagem e de gateways de pagamento. No jargão técnico, isso tudo é chamado de "segredo".

Este artigo mostra onde esses segredos costumam vazar, quais hábitos evitam o problema e quando faz sentido usar ferramentas de automação.

O que conta como "segredo"?

A diferença para uma senha comum é o impacto: uma chave de API vazada pode gerar cobranças altas em poucas horas, expor dados de clientes ou permitir que alguém altere o seu site.

Onde os segredos costumam vazar?

1. Dentro do código

Chave escrita direto no arquivo de configuração e enviada para um repositório. Mesmo que você apague depois, ela continua no histórico. Repositórios públicos são varridos por robôs que procuram chaves em minutos.

2. Arquivos de configuração copiados de um lado para outro

O arquivo com variáveis de ambiente vai por e-mail para um colega, fica no Downloads, entra num backup sem criptografia, aparece numa captura de tela.

3. WhatsApp, e-mail e chats de projeto

"Me passa a chave de produção?" A mensagem fica no histórico de todos os participantes, em todos os aparelhos e backups, sem prazo para sair.

4. Planilhas e blocos de notas

Uma planilha "acessos clientes" com dezenas de senhas e chaves é prática e perigosa pelos mesmos motivos descritos em senhas em planilha do Excel.

Quais são as boas práticas para guardar segredos?

  1. Nunca coloque segredos no código. Use variáveis de ambiente ou o recurso de segredos da sua plataforma de hospedagem e inclua os arquivos locais de configuração na lista de arquivos ignorados pelo controle de versão.
  2. Uma chave por finalidade. Chaves separadas para teste e produção, e para cada cliente ou projeto. Se uma vazar, você revoga só ela.
  3. Permissão mínima. Ao criar a chave, marque apenas as permissões necessárias. Muitas plataformas permitem restringir por domínio, IP ou tipo de operação.
  4. Prazo de validade e troca periódica. Prefira tokens com expiração e anote quando cada um foi criado.
  5. Um lugar central e criptografado para a cópia "humana". Você ainda precisa guardar a chave em algum lugar para consultar, configurar um servidor novo ou recuperar um acesso. Esse lugar deve ser criptografado e protegido por uma senha que só você conhece.
  6. Plano para vazamento. Saiba onde revogar cada chave e tenha os códigos de recuperação das contas críticas guardados.

Cofre pessoal ou gerenciador de segredos automatizado?

São ferramentas diferentes para problemas diferentes.

NecessidadeFerramenta adequada
Guardar e consultar chaves, tokens e senhas de servidor com segurançaCofre pessoal criptografado
Aplicação ler segredos automaticamente durante o deployGerenciador de segredos da sua nuvem ou ferramenta dedicada de infraestrutura
Rotação automática de senhas de banco de dadosFerramenta dedicada de infraestrutura
Vários profissionais acessando os mesmos segredos com controle de permissãoFerramenta com recurso de compartilhamento e registro de acesso

Para quem trabalha sozinho ou em um negócio pequeno, a primeira linha é a que mais faz falta. A automação completa vale quando a infraestrutura cresce a ponto de justificar o esforço de configuração.

Onde o Virtuault se encaixa?

O Virtuault é um cofre pessoal, não uma ferramenta de automação de infraestrutura. Ele não injeta segredos em aplicações nem faz rotação automática. O que ele faz bem é ser o lugar seguro para a cópia que você consulta:

Se você mantém acessos de vários clientes, vale também ler onde guardar as senhas da empresa.

Checklist de gestão de segredos

Tire suas chaves do bloco de notas

Guarde chaves de API, tokens e senhas de servidor como segredos criptografados no Virtuault. O plano grátis já inclui 10 segredos. Criar conta grátis →

Leia também

Não confie na sorte. Confie na matemática.

Guarde senhas, documentos e arquivos no Virtuault. Seus dados são criptografados no seu dispositivo antes de chegar ao servidor, que armazena apenas dados cifrados.

Criar meu cofre grátis