Como configurar a chave SSH do Git?

Configurar uma chave SSH no Git é uma forma de autenticação que usa duas chaves criptografadas: uma privada, que fica no seu computador, e uma pública, que é compartilhada com o servidor.

Dessa forma, não é necessário digitar senhas manualmente a cada etapa da operação, já que a chave SSH permite acesso automático. Além disso, como a comunicação é criptografada, as interações com o repositório remoto são mais seguras.

Esse método é bastante útil, inclusive, para conexões com servidores remotos, como Servidores VPS.

Pré-requisitos

Antes de configurar a sua chave SSH para o Git, é importante verificar se você possui os pré-requisitos necessários.

1. Terminal ou console de comandos instalado: no Windows, você pode usar o Git Bash; no macOS ou Linux, o Terminal padrão já serve para isso;
2. Git instalado e configurado em sua máquina: caso ainda não tenha o Git instalado, não se preocupe, pois é um processo rápido e fácil;
3. Acesso à sua conta em um serviço de hospedagem de repositórios: os principais são o GitHub, GitLab e Bitbucket. Você precisa ter uma conta ativa e acesso a ela.

Com esses itens prontos, você estará preparado para seguir o passo a passo da configuração e se conectar ao servidor via SSH.

Verificar chaves já existentes

Antes de gerar uma nova chave SSH, é importante verificar se você já tem alguma configurada em sua máquina. Para fazer essa checagem, siga os passos abaixo:

1. Abra o terminal ou console de comandos e digite o seguinte comando para listar as chaves SSH já existentes:

ls -al ~/.ssh;

2. Caso existam chaves disponíveis, você verá uma lista de arquivos para escolher e selecionar. As chaves costumam ter os nomes id_rsa (chave privada) e id_rsa.pub (chave pública).

Caso não apareça nenhuma chave, você poderá gerar uma nova.

Gerar nova chave SSH

Para criar uma nova chave SSH, siga as etapas a seguir:

1. Abra o terminal do seu computador e digite o seguinte código:

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

– não se esqueça de substituir o seu endereço de e-mail no comando;

2. Defina onde deseja salvar a sua nova chave;

3. Aperte “Enter” para armazená-la no local padrão ou, se preferir, escolha outro local de armazenamento da sua preferência e confirme.

Você ainda pode cadastrar uma senha para a sua chave para obter uma camada extra de segurança, mas essa etapa não é obrigatória.

Adicionar chave privada no ssh-agent

Na sequência, você deverá adicionar a chave privada ao ssh-agent, que gerencia as chaves SSH e facilita a autenticação. Para isso, basta seguir os passos abaixo:

1. Primeiro, inicie o ssh-agent no terminal:

- - No Linux ou macOS, use o seguinte comando:

eval "$(ssh-agent -s)";

- - Para adicionar uma chave SSH no Windows, execute o código:

eval $(ssh-agent);

2. Na sequência, adicione a sua chave privada ao ssh-agent, por meio do comando:

- - ```
  ssh-add ~/.ssh/id_rsa.
```

Copiar chave pública

Agora, vamos copiar a chave pública para adicionar ao serviço de hospedagem de repositórios (como GitHub ou GitLab, por exemplo):

1. No terminal, use o comando a seguir para copiar o conteúdo da chave pública:
```
cat ~/.ssh/id_rsa.pub;
```
2. O terminal exibirá o conteúdo da sua chave pública;
3. Selecione e copie todo o texto, a partir de ssh-rsa até o final;
4. Cole essa chave pública no seu perfil do GitHub, GitLab ou outro serviço de repositório que utilizar.

Adicionar chave no Github

Chegou a hora de incorporar a chave SSH ao seu perfil do Github. Dessa forma, será possível se autenticar sem precisar digitar senhas o tempo todo.

O processo é simples e rápido:

1. Primeiramente, acesse a sua conta no Github;
2. Você deve ver seu nome de usuário ou foto de perfil no canto superior direito da tela. Clique nesse ícone e selecione a opção “Configurações” no menu suspenso;
3. Na barra lateral esquerda, clique em “Chaves SSH e GPG”. Esse é o local em que você vai adicionar a sua chave que foi gerada;
4. Clique no botão verde “Nova chave SSH” para iniciar o processo. Nessa tela, você precisará dar um título para identificar essa chave;
5. Em seguida, cole a chave pública que você copiou anteriormente no campo “Chave”;
6. Agora, basta clicar em “Adicionar chave SSH” para concluir o processo.

Vale ressaltar que manter as suas chaves SSH atualizadas e organizadas é essencial para a segurança dos seus projetos.

Sempre que mudar de computador ou achar necessário, você pode gerar uma nova chave e adicioná-la ao seu perfil no Github.

Testar a conexão SSH

Após adicionar a sua chave SSH ao seu perfil do GitHub, você deverá testar essa conexão para ter certeza de que tudo funciona corretamente. Basta seguir o passo a passo abaixo:

1. Abra o terminal ou o console de comandos do seu computador (o mesmo local no qual você digitou os comandos para gerar a sua chave SSH);
2. No terminal, digite o seguinte comando:

ssh -T git@github.com.

Esse comando vai testar a conexão SSH entre o seu computador e o servidor do GitHub. Caso seja a primeira vez que você se conecta via SSH, o terminal exibirá uma mensagem para perguntar se você confia no GitHub. Basta digitar “yes” e pressionar “Enter” para confirmar.

Se tudo estiver devidamente configurado, você verá uma mensagem semelhante a esta: “Hi, username! You’ve successfully authenticated, but GitHub does not provide shell access”.

Isso significa que a sua conexão SSH com o GitHub funciona corretamente e que você pode utilizar o Git de forma muito mais segura e prática.

Agora que você sabe como configurar a chave SSH no Git, pode utilizar o sistema de maneira mais segura, sem precisar inserir a senha a cada etapa do trabalho.

Deseja tornar o desenvolvimento dos seus projetos ainda mais prático? Experimente a hospedagem da Locaweb com domínio gratuito e tenha todas as ferramentas necessárias em um único lugar!

Este artigo foi útil ?

Yes No