Como gerar e configurar um par de chaves SSH no Windows com PuTTY

Como gerar e configurar um par de chaves SSH no Windows com PuTTY

Oi! Eu sou a Sensei da GeHost e vou te acompanhar nesse passo a passo com calma. Se você nunca mexeu com SSH antes, relaxa: a ideia aqui é trocar a senha digitada por um "par de chaves" — uma parte fica só com você (a chave privada) e a outra fica no servidor (a chave pública). É mais seguro e, depois de configurado, até mais prático.

Chave privada = seu segredo, nunca compartilhe com ninguém (nem com o suporte). Chave pública = pode ser enviada e cadastrada sem problema, ela sozinha não abre porta nenhuma.

O que você vai precisar

• Um computador com Windows.
• O PuTTY instalado (o pacote de instalação já traz o PuTTYgen, que é a ferramenta usada para gerar as chaves).
• Acesso ao seu painel do cliente GeHost (painel.gehost.com.br) ou ao cPanel da sua hospedagem, para saber o endereço do servidor e cadastrar a chave pública.

Passo 1 — Instalar o PuTTY

1. Baixe o instalador oficial do PuTTY no site do desenvolvedor.
2. Execute o instalador e siga o assistente normalmente (Avançar, Avançar, Concluir).
3. Ao final, você terá dois programas no menu Iniciar: PuTTY (o cliente de conexão) e PuTTYgen (o gerador de chaves). É o PuTTYgen que vamos usar primeiro.

Passo 2 — Gerar o par de chaves com o PuTTYgen

1. Abra o PuTTYgen (procure por "PuTTYgen" no menu Iniciar).
2. Em "Type of key to generate", deixe selecionado RSA (é o tipo mais compatível). Se aparecer um campo de tamanho de bits, use pelo menos 2048.
3. Clique no botão "Generate".
4. Agora vem a parte divertida: o programa vai pedir para você mexer o mouse aleatoriamente sobre a área em branco. Isso não é enfeite — esse movimento gera a aleatoriedade que torna sua chave única e segura. Continue mexendo até a barra de progresso terminar.

Dica da Sensei: quanto mais "sem padrão" você mexer o mouse (círculos, ziguezague, parado um pouco e depois rápido), melhor. Não tem certo ou errado, só continue até a barra encher.

Passo 3 — Proteger a chave privada com senha (passphrase)

1. Depois de gerada a chave, você verá um campo grande com o texto da chave pública — não mexe nele por enquanto.
2. Mais abaixo, preencha "Key passphrase" e "Confirm passphrase" com uma senha forte. Essa senha protege sua chave privada caso alguém tenha acesso ao seu computador.
3. É recomendado sempre usar uma passphrase. Se você deixar em branco, qualquer pessoa que copiar seu arquivo de chave privada conseguiria usá-la sem digitar nada.

Passo 4 — Salvar as chaves

1. Clique em "Save private key". Confirme que quer salvar mesmo sem senha caso você tenha pulado a passphrase (não recomendado). Salve em um local seguro do seu computador, com um nome fácil de identificar, por exemplo minha-chave.ppk.
2. Clique em "Save public key" e salve também (por exemplo minha-chave.pub).
3. Copie o conteúdo do campo de texto que mostra a chave pública (o texto que começa com "ssh-rsa..."). Você vai usar esse texto no próximo passo — vamos precisar dele para cadastrar no servidor.

Guarde o arquivo .ppk (chave privada) com carinho, tipo senha de banco. Se você perder ele, vai precisar gerar um par novo e recadastrar a chave pública no servidor.

Passo 5 — Cadastrar a chave pública na sua hospedagem

1. Acesse o seu cPanel (o link e os dados de acesso ficam no painel.gehost.com.br ou no e-mail de boas-vindas que você recebeu).
2. Procure pela seção de "SSH Access" (Acesso SSH) no cPanel.
3. Escolha a opção de gerenciar/importar chaves autorizadas e cole o conteúdo da chave pública que você copiou no Passo 4.
4. Confirme e autorize a chave, se o cPanel pedir esse passo extra depois de importar.

Se você não encontrar essa opção no seu cPanel ou tiver dúvida sobre qual conta/domínio usar, é só chamar o suporte da GeHost — eles te orientam certinho pra não errar em nenhuma etapa.

Passo 6 — Conectar usando o PuTTY

1. Abra o PuTTY (o programa principal, não o PuTTYgen).
2. Em "Host Name (or IP address)", digite o endereço do seu servidor (você encontra essa informação no painel do cliente ou no e-mail de boas-vindas).
3. No menu à esquerda, vá em Connection → SSH → Auth (em versões mais novas pode aparecer como "Credentials").
4. No campo de arquivo de chave privada, clique em "Browse" e selecione o arquivo .ppk que você salvou no Passo 4.
5. Volte para a categoria Session (lá em cima da árvore de opções), dê um nome pra essa configuração no campo "Saved Sessions" e clique em "Save" — assim você não precisa repetir esses passos toda vez.
6. Clique em "Open" para conectar. Se for a primeira conexão, o PuTTY pode perguntar se você confia na chave do servidor — pode confirmar com "Yes" ou "Accept".
7. Digite o usuário da sua hospedagem e, se você definiu uma passphrase, ela será solicitada agora para desbloquear sua chave privada.

Prontinho!

Com isso, você já tem seu par de chaves gerado, sua chave pública cadastrada no servidor e uma sessão salva no PuTTY pronta pra usar sempre que precisar. Se algo não funcionar como esperado, confira se copiou a chave pública completa (sem cortar nenhuma linha) e, se precisar de ajuda, fale com a nossa equipe de suporte — estamos por aqui pra te ajudar. 💚