Como configurar um agente SSH para não digitar a senha da chave toda vez imprimir

Chega de digitar a senha da chave SSH toda vez! 🔑

Oi, tudo bem? Aqui é a Sensei da GeHost! Se você usa acesso SSH pra mexer no seu servidor e já ficou cansado(a) de digitar a senha (passphrase) da sua chave toda santa vez que conecta, respira fundo: isso tem solução, é simples e ainda deixa seu acesso mais seguro. Vamos aprender juntos a usar um "agente SSH" — um programinha que guarda sua senha na memória, de forma protegida, e digita ela por você.

Antes de tudo: este guia parte do princípio de que você já tem uma chave SSH criada e configurada. Se o seu plano tem acesso SSH liberado mas você ainda não configurou nada, ou tem qualquer dúvida sobre isso, fale com nosso suporte ou dê uma olhada no painel.gehost.com.br antes de seguir.

O que é esse tal de "agente SSH"?

Pensa assim: toda vez que você conecta no servidor via SSH, o sistema pede a senha da sua chave privada pra provar que é realmente você. É como destravar o celular toda vez que quer usar um app. O agente SSH (o famoso ssh-agent) é tipo o "Face ID" disso: você destrava uma vez, ele guarda essa autorização na memória do computador (nunca em texto puro num arquivo!) e usa ela automaticamente nas próximas conexões, sem te incomodar de novo.

Importante: você não está removendo a senha da chave (isso seria menos seguro). Você só está ensinando o computador a "lembrar" que você já se autenticou naquela sessão.

Passo a passo no Linux e no macOS

1. Verifique se o agente já está rodando

Abra o terminal e digite:

eval "$(ssh-agent -s)"

Esse comando liga o agente SSH na sua sessão atual do terminal. Se aparecer uma mensagem tipo "Agent pid 1234", deu certo!

2. Adicione sua chave ao agente

Agora é a vez de "apresentar" sua chave pro agente. Digite:

ssh-add ~/.ssh/id_rsa

Troque id_rsa pelo nome do arquivo da sua chave privada, caso seja diferente (por exemplo, id_ed25519). Ele vai te pedir a senha da chave uma última vez — depois disso, o agente guarda ela na memória.

1. Digite a senha da chave quando for solicitado;
2. Pronto! Enquanto essa janela do terminal (e o agente) estiver ativa, você pode conectar via SSH quantas vezes quiser sem digitar a senha de novo.

Dica da Sensei: o agente "esquece" a senha quando você fecha o terminal ou reinicia o computador. Isso é uma proteção, não um bug — é o mesmo motivo de você não deixar o cartão do banco destravado pra sempre.

3. Quer que ele lembre pra sempre (sem refazer isso todo dia)?

Dá pra automatizar isso pra não precisar rodar aqueles comandos manualmente sempre que abrir o terminal. Existem duas formas bem tranquilas:

Opção A — macOS (usando o Chaveiro do sistema)

No Mac, você pode guardar a senha da chave no Chaveiro (Keychain) nativo do sistema. Edite (ou crie) o arquivo de configuração do SSH:

nano ~/.ssh/config

E adicione estas linhas:

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_rsa

Depois, adicione a chave uma vez com a opção de salvar no chaveiro:

ssh-add --apple-use-keychain ~/.ssh/id_rsa

Pronto — a partir de agora, o macOS lembra da senha da chave mesmo depois de reiniciar o computador, sem que você precise repetir o processo.

Opção B — Linux (usando o keychain ou o agente do ambiente gráfico)

A maioria das distribuições Linux com interface gráfica (GNOME, KDE etc.) já vem com um "cofre de senhas" que integra com o SSH automaticamente na hora do login. Se o seu não tiver, uma alternativa simples é instalar o utilitário keychain:

sudo apt install keychain

E adicionar esta linha no final do seu ~/.bashrc (ou ~/.zshrc, se usar zsh):

eval "$(keychain --eval --agents ssh id_rsa)"

Assim, toda vez que você abrir um terminal novo, ele reaproveita o agente já ativo em vez de te pedir a senha de novo.

Passo a passo no Windows

1. Usando o OpenSSH nativo do Windows

O Windows 10/11 já vem com um serviço de agente SSH embutido. Pra ativá-lo:

1. Abra o PowerShell como Administrador;
2. Digite Get-Service ssh-agent pra ver se o serviço existe;
3. Rode Set-Service -Name ssh-agent -StartupType Automatic pra ele iniciar sozinho sempre que o Windows ligar;
4. Depois, Start-Service ssh-agent pra ligar ele agora;
5. Por fim, num terminal normal (sem precisar ser admin), rode ssh-add apontando pra sua chave, como no exemplo do Linux/Mac acima.

2. Usando o PuTTY / Pageant (se você usa o PuTTY)

Se você prefere o PuTTY pra conectar, o "agente" dele se chama Pageant. É só abrir o Pageant, clicar em "Add Key", selecionar sua chave .ppk, digitar a senha uma vez — e o Pageant fica guardando ela enquanto estiver aberto na bandeja do sistema (perto do relógio).

Cuidados importantes 🛡️

Segurança em primeiro lugar: não recomendamos remover a senha da chave (deixá-la "em branco") só pra não ter que configurar o agente. A senha é uma camada extra de proteção caso alguém tenha acesso ao seu computador — o agente resolve a comodidade sem abrir mão dessa segurança.

• Evite configurar o agente em computadores compartilhados ou públicos;
• Se você usa vários dispositivos, cada um precisa da própria configuração — o agente não sincroniza entre máquinas;
• Trocou de computador ou perdeu a chave? Gere uma nova chave e atualize o acesso configurado no seu servidor.

Ficou com dúvida?

Sem problemas! SSH e chaves podem parecer um bicho de sete cabeças no começo, mas com a prática vira rotina. Se precisar de uma mãozinha, é só chamar nosso suporte — estamos aqui pra ajudar. 💛