Infraestrutura
SSH com chave em VPS: bloqueie senhas com segurança
Aprenda a configurar SSH com chave em VPS, testar o acesso, desativar senhas e proteger o login administrativo no Ubuntu, Debian e Rocky Linux passo a passo.
Resposta direta
Para configurar SSH com chave em uma VPS, gere um par de chaves no computador local com ssh-keygen, copie somente a chave pública para o arquivo ~/.ssh/authorized_keys do usuário remoto e teste o login em uma segunda sessão. Depois que o acesso por chave estiver confirmado, configure o servidor OpenSSH para recusar senhas, valide o arquivo com sshd -t e recarregue o serviço. A chave privada nunca deve ser enviada à VPS nem compartilhada com outra pessoa. Use uma passphrase para protegê-la e mantenha o console web do provedor disponível durante a alteração. Essa sequência reduz o risco de bloqueio administrativo e impede tentativas de adivinhar a senha, embora não substitua firewall, atualizações, logs e uma política de usuários bem definida.
Resumo rápido
- Prefira Ed25519 para novos pares de chaves, salvo exigência de compatibilidade com sistemas antigos.
- Proteja a chave privada com uma passphrase longa e carregue-a no
ssh-agentquando necessário. - Copie apenas o arquivo terminado em
.pubpara a VPS. - Confirme o login em uma segunda janela antes de desativar senhas.
- Verifique a configuração efetiva com
sshd -T, não apenas o conteúdo do arquivo. - Use
PasswordAuthentication noeKbdInteractiveAuthentication noapós o teste. - Crie uma chave diferente para cada pessoa, computador ou processo automatizado.
Como a autenticação por chave SSH protege a VPS
A autenticação por chave SSH usa um par criptográfico. A chave privada permanece no computador do administrador, enquanto a chave pública é cadastrada na VPS. Durante o login, o servidor verifica se o cliente controla a chave privada correspondente, sem receber ou armazenar essa chave. Isso elimina o envio de uma senha reutilizável e torna ataques de força bruta contra credenciais muito menos úteis depois que o login por senha é desativado.
Chave pública e chave privada
O arquivo privado costuma ter nomes como id_ed25519 ou id_rsa. O arquivo público usa o mesmo nome acrescido de .pub. O conteúdo público pode ser instalado em servidores, mas a chave privada deve ficar fora da VPS, de repositórios Git, tickets e aplicativos de mensagem. Se alguém obtiver uma chave privada sem passphrase, essa pessoa poderá tentar usá-la imediatamente nos servidores que confiam nela.
Uma passphrase protege o arquivo privado em repouso. Ela não é enviada ao servidor. O custo é precisar digitá-la ou usar um agente local que mantenha a chave desbloqueada na memória por determinado período. Para um notebook pessoal, uma passphrase com quatro ou mais palavras aleatórias oferece uma barreira prática contra o uso de uma chave copiada do disco.
Ed25519, RSA ou chave de hardware
Para instalações atuais do OpenSSH, Ed25519 oferece chaves pequenas, geração rápida e boa segurança. RSA continua útil quando há clientes legados. Nesse caso, use pelo menos 3072 bits, sendo 4096 bits uma escolha comum quando o pequeno custo adicional de processamento não afeta o fluxo. DSA deve ser evitado, pois é antigo e não é aceito por configurações modernas.
| Tipo de chave | Comando de exemplo | Tamanho ou característica | Uso mais adequado |
|---|---|---|---|
| Ed25519 | ssh-keygen -t ed25519 -a 100 | Chave pública compacta | Administração diária em sistemas modernos |
| RSA | ssh-keygen -t rsa -b 4096 -o -a 100 | Módulo de 4096 bits | Compatibilidade com clientes ou appliances antigos |
| Ed25519 com FIDO2 | ssh-keygen -t ed25519-sk | Exige dispositivo compatível | Acesso privilegiado com presença física |
Uma chave FIDO2 adiciona um componente físico ao login, mas exige suporte do cliente, do token e da versão do OpenSSH. A chave certa reduz um risco específico. Ela não corrige um sistema desatualizado, uma conta com privilégios excessivos ou regras de rede abertas. O próximo passo natural é combinar esse controle com um firewall e hardening de segurança que limitem a superfície exposta.
Como gerar uma chave SSH no computador local
A geração deve ocorrer no dispositivo usado para administrar a VPS, nunca dentro do próprio servidor. Em Linux, macOS e versões atuais do Windows com o cliente OpenSSH instalado, o comando básico é o mesmo. Abra um terminal e confirme primeiro se já existem chaves, evitando sobrescrever um arquivo em uso:
ls -la ~/.ssh
Gerando uma chave Ed25519
Para criar uma chave exclusiva para a VPS de produção, use um nome descritivo. Isso evita confundir credenciais pessoais, ambientes de teste e automações:
ssh-keygen -t ed25519 -a 100 -f ~/.ssh/vps-producao-ed25519 -C admin-notebook-2026
O parâmetro -a 100 aumenta as rodadas da função usada para proteger a chave privada quando uma passphrase é definida. O comentário fornecido com -C ajuda a identificar a origem da chave no servidor. Ele não concede permissão e pode ser alterado sem modificar a parte criptográfica.
O comando gera vps-producao-ed25519, que é privado, e vps-producao-ed25519.pub, que pode ser copiado. Para conferir a impressão digital antes de cadastrar a chave, execute:
ssh-keygen -lf ~/.ssh/vps-producao-ed25519.pub
Windows, macOS e Linux
No PowerShell, os arquivos ficam normalmente em $HOME\.ssh. O comando ssh-keygen funciona quando o recurso OpenSSH Client está instalado. No macOS e em distribuições Linux, ele costuma vir no pacote de cliente OpenSSH. Se o comando não existir no Ubuntu ou Debian, instale openssh-client. Em Rocky Linux ou AlmaLinux, o pacote correspondente também é openssh-clients.
Quem usa vários servidores pode criar uma entrada em ~/.ssh/config para evitar parâmetros repetidos:
Host app-producao
HostName 203.0.113.20
User deploy
IdentityFile ~/.ssh/vps-producao-ed25519
IdentitiesOnly yes
O endereço 203.0.113.20 pertence a uma faixa reservada para documentação e deve ser substituído pelo IP real. Depois disso, ssh app-producao usa a conta e a chave definidas. A opção IdentitiesOnly yes impede que o cliente ofereça muitas chaves carregadas e alcance o limite de tentativas do servidor.
Passphrase e ssh-agent
Uma passphrase vazia simplifica scripts, mas aumenta o impacto do roubo do arquivo. Para uso humano, prefira passphrase e ssh-agent:
ssh-add ~/.ssh/vps-producao-ed25519
ssh-add -l
Em automações, avalie uma chave dedicada sem acesso interativo, com permissões restritas no servidor. Não coloque a chave privada em uma imagem Docker ou variável exibida em logs. Em pipelines, use o cofre de segredos da plataforma e limite o segredo ao projeto e ambiente corretos.
Como instalar a chave pública na VPS
A chave pública precisa ser acrescentada ao arquivo authorized_keys da conta que receberá o login. Faça o primeiro acesso com a credencial temporária entregue pelo provedor, preferencialmente por uma conexão confiável. Antes de aceitar a chave de host mostrada pelo cliente, compare a impressão digital com o console ou a documentação da instância quando essa informação estiver disponível.
Instalação com ssh-copy-id
Em Linux e em alguns ambientes macOS, ssh-copy-id automatiza a cópia e ajusta o arquivo de destino. Informe explicitamente a chave para não cadastrar a identidade errada:
ssh-copy-id -i ~/.ssh/vps-producao-ed25519.pub [email protected]
Se o SSH estiver em uma porta diferente, por exemplo 2222, passe a opção ao comando:
ssh-copy-id -i ~/.ssh/vps-producao-ed25519.pub -p 2222 [email protected]
Logo depois, abra outro terminal e teste ssh -i ~/.ssh/vps-producao-ed25519 [email protected]. Mantenha a sessão original aberta. Ela será o caminho de retorno se a nova sessão falhar.
Instalação manual
Quando ssh-copy-id não estiver disponível, exiba a chave pública local com cat ~/.ssh/vps-producao-ed25519.pub, copie a linha completa e, na VPS, prepare o diretório:
mkdir -p ~/.ssh
chmod 700 ~/.ssh
printf '%s\n' 'COLE_A_CHAVE_PUBLICA_COMPLETA_AQUI' >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
O placeholder deve ser substituído por uma única linha iniciada normalmente por ssh-ed25519 ou ssh-rsa. Não copie o cabeçalho de uma chave privada. Um arquivo privado começa com texto semelhante a BEGIN OPENSSH PRIVATE KEY e nunca deve entrar no authorized_keys.
Permissões do diretório .ssh
O OpenSSH pode ignorar o arquivo quando o diretório pessoal, .ssh ou authorized_keys permite escrita indevida por outros usuários. Além dos modos 700 e 600, confirme a propriedade:
chown -R deploy:deploy /home/deploy/.ssh
namei -l /home/deploy/.ssh/authorized_keys
Se a chave foi adicionada como root, mas o login ocorre como deploy, o servidor consultará outro diretório. Cada conta possui seu próprio authorized_keys. Em imagens cloud, a chave inicial também pode ser inserida no provisionamento. O artigo sobre como configurar cloud-init em VPS mostra como criar usuários e cadastrar chaves públicas na primeira inicialização, o que evita distribuir senhas temporárias.
Para equipes, não compartilhe uma única conta root. Crie usuários nominais, instale a chave correspondente em cada perfil e conceda sudo conforme a função. Essa separação melhora auditoria e permite remover uma pessoa sem trocar as credenciais de todos.
Como desativar senhas sem perder o acesso
A etapa mais arriscada não é criar a chave, mas desligar o método antigo antes de confirmar o novo. Mantenha a sessão autenticada por senha aberta, inicie uma segunda conexão usando a chave e execute um comando com sudo. Assim você testa três pontos: autenticação, associação ao usuário correto e capacidade administrativa.
Teste em uma segunda sessão
Use o modo verboso quando houver dúvida sobre qual chave está sendo oferecida:
ssh -vvv -i ~/.ssh/vps-producao-ed25519 [email protected]
sudo -v
A saída detalhada pode revelar arquivo inexistente, chave recusada ou excesso de identidades. Ela também contém nomes de usuário, caminhos e endereços, portanto remova esses dados antes de publicar o log em fóruns.
Confira a configuração efetiva do servidor antes da mudança:
sudo sshd -T | grep -E 'passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|permitrootlogin'
Configuração segura do sshd
Edite /etc/ssh/sshd_config ou um arquivo de inclusão suportado pela distribuição, como /etc/ssh/sshd_config.d/10-key-auth.conf. Use este conjunto inicial:
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin prohibit-password
PermitRootLogin prohibit-password permite chave para root, mas bloqueia senha. Uma política mais restrita usa PermitRootLogin no e exige login em uma conta nominal com sudo. Antes de escolher essa opção, confirme que o usuário administrativo pertence ao grupo correto e consegue elevar privilégios.
Algumas imagens cloud mantêm arquivos adicionais em sshd_config.d. Uma diretiva encontrada em outro arquivo pode produzir resultado diferente do esperado conforme a ordem de leitura e o contexto. Por isso, rode sshd -T novamente e verifique se passwordauthentication no aparece de fato. Se a VPS usa cloud-init, confira também se uma futura reprovisão poderá recriar uma configuração de senha.
Validação e recarga do serviço
Nunca reinicie o daemon sem validar a sintaxe:
sudo sshd -t
sudo systemctl reload ssh
Ubuntu e Debian normalmente chamam o serviço de ssh. Rocky Linux e AlmaLinux costumam usar sshd, então o segundo comando passa a ser sudo systemctl reload sshd. A recarga preserva conexões existentes, enquanto uma configuração inválida detectada por sshd -t deve ser corrigida antes de qualquer ação.
Teste outra vez em uma terceira sessão. Em seguida, confirme que uma tentativa forçando senha é recusada:
ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password [email protected]
Desativar senhas bloqueia uma classe comum de ataque, mas a porta continuará recebendo varreduras. Restrição por IP no firewall, atualizações automáticas avaliadas com cuidado, logs e bloqueio por taxa completam a proteção. Se dados pessoais ou registros de clientes passam pelo servidor, conecte essas decisões ao processo descrito em como adequar uma VPS à LGPD, principalmente nos controles de acesso e rastreabilidade.
Como administrar chaves de usuários e automações
Uma chave SSH deve representar uma pessoa, um dispositivo ou um processo. Usar o mesmo par no notebook de três desenvolvedores e em um pipeline impede saber quem acessou a VPS e torna a revogação trabalhosa. Se um computador for perdido, será necessário remover a chave compartilhada de todos os servidores e redistribuir outra para toda a equipe.
Uma chave para cada pessoa e dispositivo
Cadastre uma linha por identidade no authorized_keys e mantenha comentários claros, como ana-notebook-2026 ou ci-api-producao. Para listar impressões digitais sem expor chaves privadas, execute:
ssh-keygen -lf /home/deploy/.ssh/authorized_keys
Em uma equipe de cinco pessoas, o padrão mais simples é criar cinco contas nominais e cinco pares distintos. Se cada profissional usa notebook e estação de trabalho, podem existir duas chaves por conta. Quando alguém sair, remova apenas suas linhas e bloqueie o usuário com usermod -L nome, depois revise grupos, tarefas agendadas e tokens associados.
Chaves de deploy e restrições
Uma automação que só publica arquivos não precisa receber shell administrativo. O authorized_keys aceita opções antes da chave para limitar origem e recursos. Um exemplo conceitual é:
from="198.51.100.10",no-agent-forwarding,no-port-forwarding,no-pty ssh-ed25519 AAAA... ci-deploy
Substitua o IP documental pela origem real e mantenha a chave completa. Também é possível definir command= para forçar um script específico, mas esse script precisa validar argumentos e caminhos. Uma restrição mal desenhada pode permitir escape de shell ou impedir a implantação. Teste primeiro em homologação.
Evite encaminhamento do agente SSH em servidores que não sejam plenamente confiáveis. O agente não entrega diretamente a chave privada, mas um processo privilegiado no host intermediário pode tentar usar a sessão do agente enquanto ela estiver disponível. Para saltos de rede, prefira ProxyJump, regras de origem e contas separadas.
Rotação e revogação
Rotação não precisa causar indisponibilidade. Adicione a nova chave, teste o acesso e só então remova a antiga. Registre proprietário, finalidade, data de criação e servidores autorizados. Uma revisão trimestral pode ser suficiente para uma equipe pequena; ambientes críticos podem revisar mensalmente e revogar imediatamente chaves de dispositivos perdidos. Backups de configuração devem proteger authorized_keys, mas não devem conter chaves privadas dos administradores.
Erros comuns e como recuperar o acesso
Quando o login falha, não comece alterando várias opções ao mesmo tempo. Use a sessão ainda aberta ou o console do provedor para observar logs e isolar a causa. Em Ubuntu e Debian, consulte journalctl -u ssh. Em Rocky Linux e AlmaLinux, use journalctl -u sshd. Dependendo da distribuição, /var/log/auth.log ou /var/log/secure também registra a recusa.
Permission denied publickey
O erro Permission denied (publickey) indica que nenhum método oferecido foi aceito. Confirme o usuário, pois root@IP e deploy@IP consultam arquivos diferentes. Depois, force a identidade correta:
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/vps-producao-ed25519 [email protected]
Na VPS, revise proprietário e modos com namei -l, confirme se a linha pública está completa e verifique sshd -T. Em sistemas com SELinux ativo, arquivos copiados de forma incomum podem precisar de contexto restaurado:
sudo restorecon -Rv /home/deploy/.ssh
Outro caso comum ocorre quando o cliente oferece muitas chaves do agente e o servidor encerra as tentativas antes de receber a identidade certa. IdentitiesOnly yes no arquivo de cliente resolve esse cenário sem remover as outras chaves.
Host key changed
A mensagem sobre mudança da chave de host não se refere à chave do usuário. Ela informa que a identidade apresentada pelo servidor mudou. Isso pode acontecer após reinstalação da VPS ou troca de IP, mas também pode indicar interceptação. Confirme a nova impressão digital pelo console do provedor antes de remover o registro antigo. Após a verificação, use:
ssh-keygen -R 203.0.113.20
Conectar novamente sem validar a origem transforma um alerta de segurança em mera formalidade. Em produção, registre impressões digitais das chaves de host no inventário da infraestrutura.
Console web e modo de recuperação
Se todas as sessões foram encerradas e o daemon não aceita login, use o console web, console serial ou modo de recuperação oferecido pelo provedor. Entre no sistema, reverta a última mudança, rode sshd -t e recarregue o serviço. A disponibilidade desses mecanismos varia entre VPS tradicional, Cloud Server e cloud instance, portanto confirme o procedimento antes de alterar o acesso.
Um snapshot ajuda a recuperar o sistema de arquivos, mas restaurá-lo apenas por causa de uma linha incorreta pode reverter dados recentes. O console é normalmente a ferramenta menos destrutiva. Mantenha também uma conta de emergência protegida, monitorada e testada, sem transformar essa conta em um atalho compartilhado para o trabalho diário.
Recomendações por perfil
Desenvolvedor solo
Para um único administrador, use uma chave Ed25519 exclusiva por computador, protegida por passphrase, e configure um alias em ~/.ssh/config. Mantenha uma sessão aberta ao desativar senhas e confirme antes que o console do provedor funciona. Uma VPS pequena, mesmo com 1 vCPU e 1 GB de RAM, não terá consumo relevante causado pela autenticação por chave. O ponto crítico é operacional: guardar a chave privada em local seguro e manter uma cópia protegida ou um procedimento documentado para cadastrar uma nova chave. Não envie a chave privada para armazenamento público nem a deixe dentro do diretório do projeto.
Equipe técnica
Para times, crie contas nominais e uma chave por pessoa e dispositivo. Conceda sudo por grupo ou regra específica, em vez de compartilhar root. Registre impressões digitais, proprietários e datas de revogação em um inventário. Chaves de CI devem ser diferentes das humanas e receber restrições como ausência de TTY, encaminhamento e shell quando o fluxo permitir. Integre a remoção de chaves ao desligamento de colaboradores. Em uma equipe com seis profissionais e dois ambientes, homologação e produção devem ter políticas separadas, mesmo que alguns membros acessem ambos.
Produção crítica
Em sistemas com dados sensíveis ou alto impacto, considere chaves FIDO2 para administradores, acesso limitado por VPN ou endereços autorizados e uma camada de bastion host. Centralize logs, gere alertas para acessos fora do horário esperado e teste a recuperação pelo console. Desative login direto de root e use elevação auditável. A rotação deve adicionar e validar a nova chave antes de remover a anterior. Faça exercícios periódicos de perda de notebook e falha do sshd, pois um controle só é confiável quando a equipe consegue revogar credenciais e restaurar o acesso sem improviso.
Em todos os perfis, a sequência segura permanece igual: gerar localmente, instalar a chave pública, testar em sessão separada, validar o daemon e só depois bloquear senhas. Esse processo leva poucos minutos e evita que uma melhoria de segurança provoque uma indisponibilidade administrativa.
Continue lendo
Perguntas frequentes
Qual é o melhor tipo de chave SSH para uma VPS?
Ed25519 é a escolha mais prática para servidores e clientes modernos porque produz chaves compactas, tem bom desempenho e oferece segurança adequada. Quando o cliente, appliance ou sistema legado não aceita Ed25519, RSA com 3072 ou 4096 bits é uma alternativa compatível. Para acessos administrativos mais sensíveis, uma chave Ed25519 baseada em FIDO2 pode exigir a presença de um token físico. DSA não deve ser usado. Antes de padronizar o algoritmo, confirme as versões do OpenSSH existentes no computador local, na VPS e nas ferramentas de automação.
Posso desativar a senha logo após copiar a chave pública?
Não faça a mudança sem testar uma nova conexão. Mantenha a sessão atual aberta, inicie outro terminal e conecte usando explicitamente a chave privada. Confirme também que o usuário consegue executar `sudo`, caso a administração dependa desse recurso. Depois, altere a configuração, rode `sshd -t`, recarregue o serviço e teste uma terceira sessão. Só encerre a conexão original quando o acesso estiver confirmado. Ter o console web ou serial do provedor disponível reduz o risco de bloqueio se houver erro de sintaxe, permissão incorreta ou arquivo de configuração conflitante.
Onde fica a chave SSH no Windows?
No cliente OpenSSH do Windows, as chaves do usuário ficam normalmente na pasta `.ssh` dentro do diretório pessoal, acessível no PowerShell como `$HOME\.ssh`. Uma chave Ed25519 padrão pode aparecer como `id_ed25519`, acompanhada de `id_ed25519.pub`. O arquivo sem `.pub` é privado e não deve sair do computador. O arquivo com `.pub` pode ser cadastrado na VPS. Se houver várias identidades, crie nomes descritivos e use um arquivo `config` na mesma pasta para associar cada host ao usuário, endereço e arquivo de chave corretos.
O que fazer se aparecer Permission denied publickey?
Primeiro confirme se o nome do usuário está correto e force a chave esperada com `ssh -vvv -o IdentitiesOnly=yes -i caminho-da-chave usuario@servidor`. Na VPS, verifique se a chave pública completa está em `~/.ssh/authorized_keys` da mesma conta. O diretório `.ssh` deve pertencer ao usuário e normalmente usar permissão 700, enquanto `authorized_keys` usa 600. Consulte os logs do serviço e a saída de `sshd -T`. Em sistemas com SELinux, restaure o contexto com `restorecon`. Não desative controles de segurança apenas para contornar o erro.
É seguro usar uma chave SSH sem passphrase em automações?
Pode ser necessário, mas o risco deve ser limitado. Crie uma chave exclusiva para o processo, guarde-a no cofre de segredos da plataforma e nunca a inclua em uma imagem, repositório ou log. No servidor, restrinja origem, encaminhamento, TTY e comando quando o fluxo permitir. A conta também deve possuir apenas as permissões necessárias para a implantação ou tarefa executada. Uma chave de automação não deve ser reutilizada por administradores humanos. Se a plataforma suporta chave de hardware, certificado SSH ou identidade temporária, compare essas opções antes de manter uma chave privada estática.
Trocar a porta SSH substitui a autenticação por chave?
Não. Alterar a porta padrão pode reduzir ruído de varreduras automatizadas nos logs, mas não corrige senhas fracas nem impede um atacante de localizar o serviço. A proteção principal vem da autenticação por chave, do bloqueio de senhas, das atualizações, da separação de usuários e das regras de rede. Se a porta for alterada, atualize o firewall, a configuração do cliente e o procedimento de recuperação antes de recarregar o serviço. Teste a nova porta em outra sessão e mantenha a antiga temporariamente apenas durante uma migração controlada.
Fontes consultadas
- OpenSSH Manual Pages, ssh-keygen · coletado em 15/11/2026
- OpenSSH Manual Pages, sshd_config · coletado em 15/11/2026
- Ubuntu Server Documentation, OpenSSH server · coletado em 15/11/2026
- Red Hat Enterprise Linux Documentation, Using secure communications between two systems with OpenSSH · coletado em 15/11/2026