Configurando uma Chave SSH no GitHub: Um Guia Passo a Passo

Este tutorial prático oferece um guia passo a passo simples sobre como configurar e usar chaves SSH para autenticação segura no GitHub. A autenticação SSH é fundamental para proteger suas interações com o GitHub e permite que você acesse seus repositórios sem a necessidade de inserir repetidamente suas credenciais. Nossas instruções detalhadas irão ajudá-lo a gerar e adicionar uma chave SSH à sua conta do GitHub, tornando o processo de colaboração e gerenciamento de repositórios mais seguro e conveniente. Não importa se você é um iniciante ou um usuário experiente, este guia o conduzirá por todo o processo, garantindo uma configuração bem-sucedida.

Postador por : at

Categoria : git


Configurar uma chave SSH no GitHub é uma etapa importante para autenticar sua identidade e permitir o acesso seguro aos repositórios sem a necessidade de inserir suas credenciais a cada vez que você interage com o GitHub. Neste tutorial, vou guiá-lo pelo processo de criação e configuração de uma chave SSH para uso com o GitHub de maneira simples e direta.

Passo 1: Verifique se você já possui uma chave SSH Antes de começar, verifique se você já possui uma chave SSH em sua máquina. Você pode verificar a existência de uma chave SSH digitando o seguinte comando em seu terminal:

ls ~/.ssh/

Se você já tiver chaves SSH, elas serão listadas com nomes como id_rsa (chave privada) e id_rsa.pub (chave pública). Caso contrário, você precisará gerar uma nova chave.

Passo 2: Gerar uma nova chave SSH Se você não tiver uma chave SSH, siga estas etapas para gerar uma:

  1. Abra um terminal.
  2. Use o comando abaixo para gerar uma nova chave SSH. Substitua seu endereço de e-mail pelo seu e-mail GitHub.
ssh-keygen -t ed25519 -C "[email protected]"
  1. O comando solicitará a criação de um nome de arquivo para a chave. Pressione Enter para aceitar o nome padrão (id_ed25519) ou forneça um nome personalizado.
  2. Você também pode escolher uma senha para proteger sua chave. É uma camada adicional de segurança, mas não é obrigatória. Se você quiser adicionar uma senha, digite-a e confirme-a quando solicitado.

Passo 3: Adicione sua chave SSH ao ssh-agent (opcional) Se você configurou uma senha para sua chave, é uma boa prática adicionar a chave ao ssh-agent para evitar a entrada repetitiva da senha. Use o seguinte comando para adicionar sua chave ao ssh-agent:

ssh-add ~/.ssh/sua-chave-ssh

Substitua sua-chave-ssh pelo nome da sua chave, caso você tenha dado um nome personalizado.

Passo 4: Adicione sua chave SSH ao GitHub Agora que você gerou sua chave SSH, você precisa adicioná-la à sua conta do GitHub. Siga estas etapas:

  1. Copie sua chave pública para a área de transferência. Você pode fazer isso com o seguinte comando:
cat ~/.ssh/sua-chave-ssh.pub
  1. Acesse o GitHub e faça login na sua conta.
  2. Clique na sua foto de perfil no canto superior direito e selecione “Settings” (Configurações).
  3. No menu à esquerda, clique em “SSH and GPG keys” (Chaves SSH e GPG).
  4. Clique em “New SSH key” (Nova chave SSH).
  5. Cole a chave pública que você copiou anteriormente na caixa “Key” (Chave).
  6. Dê um nome descritivo à sua chave no campo “Title” (Título).
  7. Clique em “Add SSH key” (Adicionar chave SSH) para salvar.

Agora, sua chave SSH está configurada no GitHub e você poderá usar autenticação SSH ao interagir com os repositórios.

Passo 5: Teste sua conexão SSH Para testar se sua chave SSH foi configurada corretamente, execute o seguinte comando:

ssh -T [email protected]

Se tudo estiver configurado corretamente, você receberá uma mensagem de confirmação.


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

Isso conclui o tutorial sobre como configurar uma chave SSH no GitHub. Agora você pode interagir com os repositórios do GitHub de forma segura e conveniente sem a necessidade de inserir suas credenciais a cada vez. Lembre-se de manter sua chave privada segura e não compartilhá-la com ninguém.