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 ou pela aba de contato do meu site.
Top comments (0)