Para gerar uma nova chave de acesso SSH, digite isso em seu prompt de comandos, substituindo o [usuário] pelo seu e-mail do GitHub:
ssh-keygen -t rsa -C "[usuário]" -b 4096
Caso a chave já exista, basta copiar a chave existente e gravar no Git. Criando a chave pública e adicionando na pasta de chaves do autorizadas (Linux):
ssh-keygen -f ~/.ssh/id_rsa -y > ~/.ssh/id_rsa.pub
ssh-keygen -f ~/.ssh/id_rsa -y -e -m pem > ~/.ssh/id_rsa.pem
ssh-add ~/.ssh/id_rsa
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
Agora você já pode copiar a chave para criar o seu arquivo id_rsa
localmente:
cat ~/.ssh/id_rsa.pub # (linux)
type ~\.ssh\id_rsa.pub # (windows)
Copie o texto da chave dentro de um novo arquivo na pasta “.ssh”, que encontra-se na pasta raiz do seu usuário na sua máquina local. Não esqueça de excluir as quebras de linhas do código.
Também será necessário informar essa chave na lista de chaves autorizadas na ferramenta que você utiliza para hospedar o servidor, exemplo: Google Cloud, Bitbucket, etc.
Acesse o GitHub na página de Configuração de chaves SSH para vincular o seu computador/servidor ao repositório Git.
Adicione a chave criada seguindo o exemplo da imagem abaixo:
![[2025-07-06_18h29_45.png]]
Uma chave corretamente configurada e validada, deverá exibir dessa forma na lista:
![[2025-07-06_18h32_43.png]]
![[2025-07-06_18h37_57.png]]
Para clonar o seu repositório do GitHub, basta seguir o exemplo da imagem acima, e digitar o seguinte comando na raiz do seu servidor local:
![[2025-07-06_18h41_01.png]]
A raiz dos meus projetos locais ficam em C:\Projetos
, assim como configurei em meu XAMPP. Isso poderá mudar em seu computador.
Caso você esteja acessando o serviço SSH e esteja recebendo uma mensagem de formato inválido (invalid format), execute os seguintes passos.
Execute o seguinte comando no terminal do servidor para criar uma chave no formato privado OpenSSH:
puttygen <arquivo-de-origem> -O <formato> -o <arquivo-de-destino>
puttygen id_rsa -O private-openssh -o id_rsa_private
Talvez seja necessário executar o comando de instalação do puttygen: sudo apt-get install putty-tools
Adicionar o texto —–BEGIN OPENSSH PRIVATE KEY—– no início e —–END OPENSSH PRIVATE KEY—– no final do arquivo não funcionou para mim.
Execute o comando abaixo no servidor para exibir a chave privada. Agora copie o texto e crie o arquivo “id_rsa_private” dentro da pasta “.ssh”, localizado na pasta raiz do seu usuário na sua máquina local.
cat ~/.ssh/id_rsa_private
Esse formato de chave possui quebra de linhas, diferente do formato da primeira chave que geramos e removemos as quebras de linha criar o nosso arquivo local ‘id_rsa’.
Agora você pode acessar o servidor com o arquivo de senha no formato correto, usando o comando abaixo na sua máquina local:
ssh -i ~/.ssh/id_rsa_private [usuário]@[ip-do-servidor]
O usuário do comando acima deverá ser o mesmo que foi utilizado na criação da chave, conforme explicação nos primeiros passos.
Caso seja exibido a mensagem “too open”, então execute a mudança de permissão de acesso do arquivo de chave: “chmod 600 ~/.ssh/id_rsa_private“.
Renée Maksoud - julho de 2025