Como Configurar uma Chave SSH no Ubuntu para o GitHub

Este guia apresenta, passo a passo, como criar uma chave SSH no Ubuntu e configurá-la para funcionar com o GitHub.

---

1. Verificar se já existe uma chave SSH

Antes de criar uma nova chave SSH, é necessário verificar se já existe uma:

ls -al ~/.ssh

• Se aparecerem ficheiros como id_rsa ou id_ed25519, significa que já existe uma chave SSH.
• Caso não seja necessário criar uma nova, pode-se avançar para a secção Adicionar a Chave ao Agente SSH.
• Se não existirem chaves, continuar para a próxima secção.

---

2. Criar uma Nova Chave SSH

Para criar uma nova chave SSH, usar o comando abaixo:

ssh-keygen -t ed25519 -C "seu-email@example.com"

Explicação:

• -t ed25519: Especifica o tipo da chave (recomendado por ser mais seguro e rápido). Caso o sistema não suporte, usar rsa:

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

• -C: Adiciona um comentário para identificação (normalmente, o e-mail).

Durante a criação:

• Caminho para guardar a chave: Pressionar Enter para usar o valor predefinido (~/.ssh/id_ed25519).
• Palavra-passe (opcional): Definir uma palavra-passe para proteger a chave (recomendado).

---

3. Adicionar a Chave SSH ao Agente SSH

Para garantir que a chave funcione corretamente, é necessário adicioná-la ao agente SSH:

1. Iniciar o agente SSH:

   eval "$(ssh-agent -s)"

2. Adicionar a chave recém-criada:

   ssh-add ~/.ssh/id_ed25519

---

4. Copiar a Chave Pública

A chave pública será adicionada ao GitHub. Para copiá-la, usar o comando:

cat ~/.ssh/id_ed25519.pub

Copiar o conteúdo exibido no terminal (começa com ssh-ed25519 ou ssh-rsa).

---

5. Adicionar a Chave ao GitHub

1. Aceder às Configurações de SSH no GitHub.
2. Clicar em "New SSH key".
3. Preencher:
   • Title: Nome para identificar a chave (ex.: "Chave SSH Ubuntu").
   • Key: Colar o conteúdo da chave pública copiada anteriormente.
4. Clicar em "Add SSH key".

---

6. Testar a Conexão com o GitHub

Para verificar se a configuração foi concluída com sucesso, testar a conexão:

ssh -T git@github.com

Se tudo estiver correto, será exibida uma mensagem semelhante a:

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

---

Notas Finais

• Segurança: Nunca partilhar a chave privada (id_ed25519 ou id_rsa). Apenas a chave pública (.pub) deve ser utilizada para autenticação.
• Múltiplas Contas no GitHub: Para utilizar várias contas, configurar ficheiros config no diretório ~/.ssh. Consultar a documentação oficial para mais detalhes.

---

Com estes passos, a chave SSH está configurada para trabalhar com o GitHub.