O que é uma chave SSH?
Uma chave SSH é um par de chaves que são usadas para autenticar um usuário em um servidor. A chave pública é usada para criptografar os dados e a chave privada é usada para descriptografar os dados. A chave pública é compartilhada com o servidor e a chave privada é mantida em segredo pelo usuário.
existem diversos tipos de algoritmos de criptografia para gerar chaves SSH, mas neste tutorial eu vou ensinar como gerar uma chave SSH usando o algoritmo ED25519. O algoritmo ED25519 é um algoritmo de assinatura digital de curva elíptica que é considerado seguro e rápido.
para saber mais sobre o tema, eu indico esse artigo da Teleport: Artigo (em inglês)
Gerando uma chave SSH
A partir de agora irei separar esse tutorial em duas partes, uma para Linux e outra para Windows.
Antes de começar, você precisa ter o git instalado em sua máquina. Se você não tem, indico a documentação oficial do git para instalar o git em sua máquina: Documentação
Linux
Para gerar uma chave SSH no Linux, você precisa abrir o terminal e digitar o seguinte comando:
ssh-keygen -t ed25519 -C <seu-email>
Após digitar o comando, você vai ser solicitado a preencher alguns dados, como o nome da chave e a senha da chave. Você pode digitar o nome que quiser desde que não se esqueça dele, no meu caso, eu apenas apertei Enter para que o git gerasse o nome da chave automaticamente e que a chave não tenha senha.
Com a chave gerada você deve copiar a chave pública para a área de transferência. Para isso, navegue ate a pasta onde a chave foi gerada (por padrão ela fica na pasta ~/.ssh, como mostrado na imagem anterior) e digite o seguinte comando:
cat id_ed25519.pub
e copie a chave que aparecer na tela.
Agora você precisa ir até a página de configurações do github e adicionar a chave que você acabou de copiar.
aqui um atalho para você ir direto para a página de configurações de chaves SSH do github: Página de configurações de chaves SSH
aqui você deve ir em New SSH key e cole a chave que você copiou anteriormente.
Clicando em Add SSH key, você vai adicionar a chave SSH ao github.
Pronto, agora é só testar se a chave foi adicionada corretamente e fazer dar clone de qualquer repositório que você tenha acesso sempre utilizando o endereço SSH. Para testar se a cahve foi adicionada corretamente, você pode digitar o seguinte comando:
ssh git@github.com
se tudo der certo, você vai ver uma mensagem de sucesso e você já pode fazer o clone de qualquer repositório que você tenha acesso, no meu caso eu fiz o clone do meu próprio repositório.
Windows
Mesmo processo do linux com a exceção de que aqui eu usei o powershell para criar a chave SSH e o git bash para testar a chave SSH.
Primeiro você precisa abrir o powershell e digitar o seguinte comando:
ssh-keygen -t ed25519 -C <seu-email>
substitua <seu-email> pelo seu email do github.
Após digitar o comando, você vai ser solicitado a preencher alguns dados, como o nome da chave e a senha da chave. Você pode digitar o nome que quiser desde que não se esqueça dele, no meu caso, eu apenas apertei Enter para que o git gerasse o nome da chave automaticamente e que a chave não tenha senha.
Com a chave gerada você deve copiar a chave pública para a área de transferência. Para isso, navegue ate a pasta onde a chave foi gerada (por padrão ela fica na pasta C:\Users\ryans\.ssh, como mostrado na imagem anterior) e digite o seguinte comando:
type id_ed25519.pub
e copie a chave que aparecer na tela.
Enfim, agora você precisa ir até a página de configurações do github e adicionar a chave que você acabou de copiar. aqui um atalho para você ir direto para a página de configurações de chaves SSH do github: Página de configurações de chaves SSH
aqui você deve ir em New SSH key e cole a chave que você copiou anteriormente.
Clicando em Add SSH key, você vai adicionar a chave SSH ao github.
Agora basta verificar o funcionamento da chave SSH. Para isso, você precisa abrir o git bash e digitar o seguinte comando:
ssh git@github.com
se tudo der certo, você vai ver uma mensagem de sucesso e você já pode fazer o clone de qualquer repositório que você tenha acesso, no meu caso eu fiz o clone do meu próprio repositório.
Referências
Espero que esse tutorial tenha ajudado você a configurar a sua chave SSH no github. Se tiver alguma dúvida ou sugestão, deixe um comentário abaixo ou entre em contato comigo pelo LinkedIn.