Chave SSH no Git: Como Configurar chave SSH para usar no GitHub

O Git é a ferramenta mais popular para controle de versão de código, e o GitHub é a plataforma mais utilizada para armazenar seus códigos na nuvem. No entanto, ter que digitar usuário e senha toda vez que for interagir com o GitHub pode ser bastante inconveniente.

Nesse contexto entra a chave SSH, onde a chave é utilizada para estabelecer uma conexão segura entre sua máquina e o GitHub, sem a necessidade de inserir suas credenciais repetidamente. Neste artigo, vou te guiar, passo a passo, na configuração de uma chave SSH no GitHub para otimizar seu fluxo de trabalho.

Gerando a Chave SSH

O primeiro passo é gerar a chave SSH, você pode fazer isso executando o comando abaixo para gerar a chave SSH, e não se esqueça de substituir codigoaoponto@email.com pelo seu email cadastrado no GitHub:

ssh-keygen -t ed25519 -C "codigoaoponto@email.com"

Durante esse processo você será perguntado sobre:

  • Adicionar uma senha na chave SSH.
  • Alterar o diretório onde a chave SSH será salva.

Nesse tutorial, não vamos nos preocupar com essas opções, para ambas perguntas, você pode apenas digitar Enter. Após essas duas perguntas a chave SSH será gerada.

Se, por algum motivo, você querer gerar a chave no formato rsa, o comando será um pouco diferente, mas o processo será idêntico, bastando também digitar enter para as perguntas:

ssh-keygen -t rsa -b 4096 -C "codigoaoponto@email.com"

Obtendo a chave SSH gerada

O segundo passo é copiar a chave SSH gerada e você pode fazer isso executando o comando abaixo, onde diretorio_chave deve ser substituído pelo caminho do arquivo da chave SSH pública:

cat diretorio_chave

Se você seguiu todos os passos anteriores do tutorial, a chave SSH foi gerada no diretório padrão: ~/.ssh/id_ed25519.pub (ou ~/.ssh/id_rsa.pub se você gerou a chave no formato RSA). Caso você optou por salvar a chave SSH em outro diretório, basta colocar o caminho deste outro diretório após o comando cat.

Para exibir no terminal a chave SSH pública salva no diretório padrão é:

cat ~/.ssh/.id_rsa.pub

O comando cat imprime no terminal o conteúdo de um arquivo. Nesse caso, ele exibirá a chave SSH pública que você deve copiar.

Adicionando a Chave SSH à Sua Conta do GitHub

Agora que sua chave SSH está copiada, o próximo passo é vinculá-la à sua conta do GitHub:

  1. Estando logado no GitHub, no canto superior direito, clique na sua foto de perfil e selecione Configurações.
  2. No menu à esquerda, clique em Chaves SSH e GPG.
  3. Clique no botão Nova chave SSH.
  4. No campo Título, insira uma descrição para a chave, como "Computador Pessoal" ou "Computador Trabalho".
  5. No campo Chave, cole o conteúdo da sua chave pública que você copiou anteriormente.
  6. Clique em Adicionar chave SSH para salvar.

Feito isso, quando você executar algum comando do git como git pull ou git push, o GitHub passará a utilizar a chave SSH que você gerou e configurou.

página no GitHub para adicionar a chave SSH

Conclusão

Este artigo te guiou para fazer a geração da chave SSH e configurá-la no GitHub, se você quiser mais conteúdos complementares sobre o assunto, pode assistir esse video no Youtube do Código ao Ponto ou acessar a documentação oficial do GitHub.