{"id":37125,"date":"2025-02-04T18:00:16","date_gmt":"2025-02-04T21:00:16","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&p=37125"},"modified":"2025-02-17T13:19:01","modified_gmt":"2025-02-17T16:19:01","slug":"configurar-chave-ssh-git","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/configurar-chave-ssh-git\/","title":{"rendered":"Como configurar a chave SSH do Git?"},"content":{"rendered":"

Configurar uma chave SSH no Git<\/strong> \u00e9 uma forma de autentica\u00e7\u00e3o que usa duas chaves criptografadas: uma privada, que fica no seu computador, e uma p\u00fablica, que \u00e9 compartilhada com o servidor.<\/p>\n

Dessa forma, n\u00e3o \u00e9 necess\u00e1rio digitar senhas manualmente a cada etapa da opera\u00e7\u00e3o, j\u00e1 que a chave SSH permite acesso autom\u00e1tico. Al\u00e9m disso, como a comunica\u00e7\u00e3o \u00e9 criptografada, as intera\u00e7\u00f5es com o reposit\u00f3rio remoto s\u00e3o mais seguras.<\/p>\n

Esse m\u00e9todo \u00e9 bastante \u00fatil, inclusive, para conex\u00f5es com servidores remotos, como Servidores VPS<\/a>.<\/p>\n

Pr\u00e9-requisitos<\/h2>\n

Antes de configurar a sua chave SSH para o Git, \u00e9 importante verificar se voc\u00ea possui os pr\u00e9-requisitos necess\u00e1rios.<\/p>\n

    \n
  1. \n
      \n
    1. Terminal ou console de comandos instalado<\/strong>: no Windows, voc\u00ea pode usar o Git Bash; no macOS ou Linux, o Terminal padr\u00e3o j\u00e1 serve para isso;<\/li>\n
    2. Git instalado e configurado em sua m\u00e1quina<\/strong>: caso ainda n\u00e3o tenha o Git instalado, n\u00e3o se preocupe, pois \u00e9 um processo r\u00e1pido e f\u00e1cil;<\/li>\n
    3. Acesso \u00e0 sua conta em um servi\u00e7o de hospedagem de reposit\u00f3rios<\/strong>: os principais s\u00e3o o GitHub<\/a>, GitLab e Bitbucket. Voc\u00ea precisa ter uma conta ativa e acesso a ela.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      Com esses itens prontos, voc\u00ea estar\u00e1 preparado para seguir o passo a passo da configura\u00e7\u00e3o e se conectar ao servidor via SSH<\/a>.<\/p>\n

      Verificar chaves j\u00e1 existentes<\/h2>\n

      Antes de gerar uma nova chave SSH, \u00e9 importante verificar se voc\u00ea j\u00e1 tem alguma configurada em sua m\u00e1quina. Para fazer essa checagem, siga os passos abaixo:<\/p>\n

      1. Abra o terminal ou console de comandos<\/strong> e digite o seguinte comando para listar as chaves SSH j\u00e1 existentes:<\/p>\n

      ls -al ~\/.ssh<\/em>;<\/pre>\n
      2. Caso existam chaves dispon\u00edveis, voc\u00ea ver\u00e1 uma lista de arquivos para escolher e selecionar. As chaves costumam ter os nomes id_rsa<\/em> (chave privada) e id_rsa.pub<\/em> (chave p\u00fablica).<\/p>\n
      Caso n\u00e3o apare\u00e7a nenhuma chave, voc\u00ea poder\u00e1 gerar uma nova<\/strong>.<\/p>\n
      Gerar nova chave SSH<\/h2>\n
      Para criar uma nova chave SSH, siga as etapas a seguir:<\/p>\n
      1. Abra o terminal do seu computador e digite o seguinte c\u00f3digo:<\/p>\n
      ssh-keygen -t rsa -b 4096 -C \"seuemail@exemplo.com\"<\/em><\/pre>\n
      – n\u00e3o se esque\u00e7a de substituir o seu endere\u00e7o de e-mail no comando;<\/p>\n
      2. Defina onde deseja salvar a sua nova chave;<\/p>\n
      3. Aperte \u201cEnter\u201d para armazen\u00e1-la no local padr\u00e3o ou, se preferir, escolha outro local de armazenamento da sua prefer\u00eancia e confirme.<\/p>\n
      Voc\u00ea ainda pode cadastrar uma senha para a sua chave para obter uma camada extra de seguran\u00e7a, mas essa etapa n\u00e3o \u00e9 obrigat\u00f3ria.<\/p>\n
      Adicionar chave privada no ssh-agent<\/h2>\n
      Na sequ\u00eancia, voc\u00ea dever\u00e1 adicionar a chave privada ao ssh-agent<\/em>, que gerencia as chaves SSH e facilita a autentica\u00e7\u00e3o. Para isso, basta seguir os passos abaixo:<\/p>\n
      1. Primeiro, inicie o ssh-agent<\/em> no terminal:<\/p>\n