Configurando o acesso via SSH no Github

Enviar arquivos pela rede mundial de computadores (vulgo, internet) requer a tomada de medidas para garantir a segurança de nossos arquivos e nossa máquina. Existem inúmeras formas de buscar segurança online e uma delas é o protocolo Secure Shell (SSH).

O que é SSH?

O SSH “é um protocolo de rede que estabelece conexões criptografadas entre computadores para acesso remoto seguro” (Cloudflare, 2026). Ele opera fornecendo autenticação e criptografia para proteger os dados que são transmitidos em redes consideradas não seguras.

Além de arquivos, o protocolo SSH também permite enviar comandos com segurança a um computador remoto. Por isso, ele é uma opção interessante para trocar comandos e arquivos entre seu repositório local Git e o repositório remoto no Github.

Passo a passo

Ao configurar uma chave SSH na conta Github, você poderá se conectar ao serviço da plataforma e realizar operações do Git – como push e pull – de forma segura, sem precisar digitar seu usuário e senha (ou token) a todo momento. Siga os passos abaixo para realizar essa configuração.

Verifique se você já possui chaves SSH 

Antes de criar uma nova, veja se já existe algum par de chaves no seu computador:

ls -al ~/.ssh

Procure por arquivos com nomes tipo id_ed25519.pub ou id_rsa.pub. Se você os encontrar, você pode pular para o passo 3 (Adicione a chave ao GitHub).

Gere uma nova chave SSH

Caso não tenha arquivos com os nomes citados, abra o terminal Linux (ou Git Bash no Windows) e execute: 

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

Utilize o e-mail que você cadastrou no Github, por garantia, e pressione Enter para salvar no local padrão. Você pode definir uma passphrase (senha extra) ou deixar o campo em branco.

Adicione a chave ao GitHub

Com o par de chaves criado, você precisará copiar sua chave pública e colá-la nas configurações da sua conta Github. Primeiro, copie a chave no seu computador conforme seu sistema operacional:

1. Windows: clip < ~/.ssh/id_ed25519.pub.
2. MacOS: pbcopy < ~/.ssh/id_ed25519.pub.
3. Linux: cat ~/.ssh/id_ed25519.pub

Observe o texto que surgirá no terminal e o copie manualmente. Agora, vá ao Github, faça login, entre nas configurações (settings) > SSH and GPG keys. Procure o botão e clique em New SSH key. Dê um título (ex: “Meu notebook”) e cole o conteúdo da chave no campo Key. Finalmente, salve a alteração.

Teste a conexão

Para garantir que deu tudo certo, use o comando:

ssh -T git@github.com

Se aparecer uma mensagem de sucesso com seu nome de usuário, como por exemplo “Hi username! You’ve successfully authenticated”, a configuração foi concluída.

Para encerrarmos, uma dica: quando for clonar repositórios do Github, certifique-se de usar a URL que começa com git@github.com:... em vez de https://... para que o Git use automaticamente sua chave SSH.

Obrigado pela leitura e bons estudos!

Referências

CLOUDFLARE. O que é SSH? | Protocolo Secure Shell (SSH). Disponível em: <https://www.cloudflare.com/pt-br/learning/access-management/what-is-ssh/#:~:text=O%20SSH%20(Secure%20Shell)%20%C3%A9,transmitidos%20por%20redes%20n%C3%A3o%20seguras.> Acesso em: 12 abr. 2026.