Conectando-se ao GitHub com SSH: Um Guia Passo a Passo

Quando você trabalha com GitHub, é comum autenticar-se para realizar operações como clonar repositórios, fazer commits, e criar pull requests. Uma maneira mais segura e conveniente de se conectar ao GitHub é usando uma chave SSH. Isso evita a necessidade de fornecer suas credenciais em cada operação e melhora a segurança. Neste tutorial, vamos guiá-lo por todas as etapas para configurar e conectar-se ao GitHub via SSH.

1. Verifique se já tem uma chave SSH existente

Antes de criar uma nova chave SSH, é importante verificar se você já tem uma configurada. No terminal, execute o seguinte comando:

ls -al ~/.ssh

Este comando lista os arquivos no diretório .ssh. Se você vir arquivos como id_rsa ou id_ed25519, significa que você já possui uma chave SSH.

2. Gerar uma nova chave SSH

Caso não tenha uma chave SSH existente ou queira criar uma nova, use o seguinte comando:

ssh-keygen -t ed25519 -C "seu_email@example.com"

Se o seu sistema não suportar o algoritmo ed25519, você pode usar rsa:

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

Aqui está o que cada parte do comando faz:

• ssh-keygen: Comando para gerar uma nova chave SSH.
• -t ed25519: Especifica o tipo de chave (recomendado o uso do ed25519, um algoritmo mais moderno e seguro).
• -C "seu_email@example.com": Um comentário para identificar a chave, geralmente seu e-mail GitHub.

Ao ser solicitado o local para salvar a chave, pressione Enter para aceitar o caminho padrão (/home/usuario/.ssh/id_ed25519 ou /home/usuario/.ssh/id_rsa).

3. Adicionar sua chave SSH ao agente SSH

Depois de criar a chave, você precisa adicioná-la ao seu agente SSH para que ele possa gerenciar suas chaves privadas. Primeiro, inicie o agente SSH:

eval "$(ssh-agent -s)"

Agora, adicione a chave privada ao agente SSH:

ssh-add ~/.ssh/id_ed25519

Se você usou o algoritmo RSA, substitua id_ed25519 por id_rsa.

4. Adicionar a chave SSH ao GitHub

Agora que você gerou a chave SSH e a adicionou ao agente, o próximo passo é adicionar sua chave pública ao GitHub. Para isso, copie o conteúdo da chave pública:

cat ~/.ssh/id_ed25519.pub

Ou, se usou RSA:

cat ~/.ssh/id_rsa.pub

Copie o conteúdo exibido, que começa com ssh-ed25519 ou ssh-rsa.

Agora, siga estes passos:

1. Acesse o GitHub.
2. No canto superior direito, clique na sua foto de perfil e vá em Settings.
3. No menu da barra lateral esquerda, vá em SSH and GPG keys.
4. Clique em New SSH Key.
5. Cole sua chave pública no campo “Key” e adicione um título descritivo para a chave.

5. Testar a conexão SSH com o GitHub

Agora que a chave SSH está configurada, você pode testar a conexão executando o seguinte comando:

ssh -T git@github.com

Se tudo estiver configurado corretamente, você verá uma mensagem como esta:

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

6. Usando SSH para clonar repositórios

Depois de configurar e testar sua chave SSH, você pode usar SSH para clonar repositórios. Para isso, copie o link SSH do repositório que deseja clonar. O link estará no formato:

git@github.com:username/repository.git

Então, execute o comando git clone:

git clone git@github.com:username/repository.git

Agora, você poderá interagir com o repositório sem a necessidade de autenticar-se com suas credenciais.

Conclusão

Configurar o SSH para trabalhar com GitHub é uma maneira eficiente de melhorar a segurança e a praticidade do seu fluxo de trabalho. Seguindo as etapas descritas, você poderá autenticar-se sem digitar suas credenciais a cada operação e minimizará os riscos de segurança associados ao uso de senhas. Certifique-se de manter sua chave SSH privada segura e de revogar chaves antigas quando não forem mais necessárias.

.