<rafael.geronimo.dev/blog>

Adicionando chave SSH ao GitHub

Rafael Gerônimo
Rafael Gerônimo

Neste artigo, vamos explicar tudo o que você precisa saber sobre chaves SSH, como gerá-las em diferentes sistemas operacionais e como adicioná-las ao GitHub, para garantir a segurança e autenticidade das duas ações na plataforma.

Imagem de capa para Adicionando chave SSH ao GitHub
Rafael Gerônimo
Rafael Gerônimo

O que são chaves SSH?

SSH (Secure Shell) é um protocolo de rede seguro que permite que você se conecte a outros computadores de maneira segura. As chaves SSH são um método de autenticação que você pode usar em vez de senhas para se conectar a outros computadores via SSH. Elas funcionam como uma combinação de uma chave pública e uma chave privada.

Por que usar chaves SSH?

Existem muitas razões para usar chaves SSH em vez de senhas. Aqui estão algumas delas:

  • Maior segurança: as chaves SSH são consideradas mais seguras do que as senhas, pois elas não podem ser facilmente adivinhadas ou hackeadas.
  • Conveniência: com as chaves SSH, você não precisa digitar sua senha todas as vezes que se conectar a outros computadores. Isso pode ser especialmente útil se você precisar se conectar a muitos computadores diferentes.
  • Automatização: as chaves SSH permitem que você automatize tarefas, como backups ou transferências de arquivos, sem precisar digitar sua senha.

Gerando uma chave SSH

Verifique a existência de uma chave:

⚠ Os comandos devem ser executados no Terminal (Linux/Mac) ou no PowerShell (Windows). ⚠

Comece executando esse comando para verificar se já existe alguma chave SSH gerada em seu sistema:

ls ~/.ssh

O nome do seu arquivo de chaves públicas pode ser algum da lista abaixo:

  • id_rsa.pub
  • id_dsa.pub
  • id_ecdsa.pub
  • id_ed25519.pub

Gere uma nova chave SSH se necessário

Se não encontrar nenhum dos arquivos da lista, significa que não há nenhuma chave SSH salva no diretório. Então, será necessário gerar uma nova chave. Execute esse comando:

ssh-keygen -t rsa -b 4096 -C "seu_email@exemplo.com"

Essa mensagem será exibida no terminal:

  • Linux
> Enter a file in which to save the key (/home/seu_nome/.ssh/id_rsa): [Aperte enter]
  • Windows
> Enter file in which to save the key
(C:\Users\seu_nome/.ssh/id_rsa): [Aperter enter]

A mensagem solicita um local e um nome para o seu arquivo de chave pública. Nesse caso, basta apenas pressionar a tecla [enter] para usar o local e o nome padrão ou então informar uma de sua preferência.

Em seguida, será solicitada a criação de uma senha, porém não é obrigatória. Caso prefira usar a segurança, não esqueça de anotar a senha em um local seguro, como um gerenciador de senhas.

Adicionando a chave SSH ao ssh-agent

Verifique se o ssh-agent está em execução ou então inicie o serviço com o comando:

  • Linux
$ eval `ssh-agent -s`
  • Windows
ssh-agent -s

Agora adicione a sua chave SSH privada ao ssh-agent com o comando:

ssh-add ~/.ssh/id_rsa.pub

Adicionando uma chave SSH ao GitHub

Para exibir sua chave SSH pública, execute o comando ls ~/.ssh, identifique o nome do arquivo e então mostre o conteúdo do arquivo no console com o comando:

cat ~/.ssh/id_rsa.pub

Então:

  • Copie a chave exibida no seu console após a execução do comando acima
  • Vá para a página de configuração de chaves SSH e GPG do GitHub
  • Clique em New SSH Key
  • Preencha o campo Title. Escolha um nome para identificar o computador, como Notebook Ubuntu Empresa
  • Cole a sua chave SSH no campo Key, pressionando o botão Add SSH key em seguida.

A partir de agora, todas as interações entre o seu computador e o GitHub, como clonepushpull e outros, podem ser realizados com segurança, sem a necessidade de informar seu nome de usuário e senha todas às vezes que executar um novo comando.