Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Adicionar uma nova chave SSH à sua conta do GitHub

Para configurar sua conta no your GitHub Enterprise Server instance para usar sua chave SSH nova (ou existente), você também precisará adicionar a chave à conta.

Sobre a adição de chaves SSH à sua conta

É possível acessar e gravar dados em repositórios no your GitHub Enterprise Server instance usando o SSH (protocolo Secure Shell). Ao se conectar por meio do SSH, você se autentica usando um arquivo de chave privada no computador local. Para obter mais informações, confira "Sobre o SSH."

Depois de gerar um par de chaves SSH, você precisará adicionar a chave pública ao your GitHub Enterprise Server instance para habilitar o acesso SSH na sua conta.

Pré-requisitos

Antes de adicionar uma nova chave SSH à sua conta no your GitHub Enterprise Server instance, conclua as etapas a seguir.

  1. Verifique se há chaves SSH existentes. Para obter mais informações, confira "Como verificar se há chaves SSH existentes".
  2. Gere uma nova chave SSH e adicione-a ao agente SSH do computador. Para obter mais informações, confira "Como gerar uma nova chave SSH e adicioná-la ao ssh-agent".

Como adicionar uma nova chave SSH à sua conta

Depois de adicionar uma nova chave SSH de autenticação à sua conta em your GitHub Enterprise Server instance, você poderá reconfigurar qualquer repositório local para usar o SSH. Para obter mais informações, confira "Como alternar URLs remotas de HTTPS para SSH".

Observação: por padrão, com GitHub Enterprise Server 3.6 e versões posteriores, a partir da data de corte de meia-noite UTC, em 1º de agosto de 2022, as conexões SSH que atenderem às duas condições a seguir falharão.


  • A chave RSA foi adicionada a uma conta de usuário no your GitHub Enterprise Server instance após a data de corte de meia-noite UTC em 1º de agosto de 2022.
  • O cliente SSH assina a tentativa de conexão com a função de hash SHA-1.

GitHub Enterprise Server 3.6 e versões posteriores também não dão suporte a conexões SSH que usam criptografias DSA, HMAC-SHA-1 ou CBC. As chaves SSH RSA carregadas antes da data de corte podem continuar sendo autenticadas usando a função de hash SHA-1, desde que a chave permaneça válida. Para obter mais informações sobre como encontrar a versão de GitHub Enterprise Server que você usa, confira "Sobre versões de GitHub Docs."

O administrador do site pode ajustar a data de corte para conexões que usam RSA-SHA-1 e pode bloquear todas as conexões que usam RSA-SHA-1. Para obter mais informações, entre em contato com o administrador do site ou confira "Como configurar conexões SSH com sua instância".

  1. Copie a chave pública SSH para a sua área de transferência.

    Se o seu arquivo de chave pública SSH tiver um nome diferente do código de exemplo, modifique o nome do arquivo para corresponder à sua configuração atual. Ao copiar sua chave, não adicione novas linhas nem espaços em branco.

    $ pbcopy < ~/.ssh/id_ed25519.pub
      # Copies the contents of the id_ed25519.pub file to your clipboard

    Dica: se pbcopy não estiver funcionando, localize a pasta oculta .ssh, abra o arquivo no seu editor de texto favorito e copie-o para a área de transferência.

    $ clip < ~/.ssh/id_ed25519.pub
      # Copies the contents of the id_ed25519.pub file to your clipboard

    Dica: se clip não estiver funcionando, localize a pasta oculta .ssh, abra o arquivo no seu editor de texto favorito e copie-o para a área de transferência.

    $ cat ~/.ssh/id_ed25519.pub
      # Then select and copy the contents of the id_ed25519.pub file
      # displayed in the terminal to your clipboard

    Dica: como alternativa, você pode localizar a pasta oculta .ssh, abrir o arquivo no seu editor de texto favorito e copiá-lo para a área de transferência.

    1. No canto superior direito de qualquer página, clique na foto do seu perfil e em **Configurações**.

    Ícone Settings (Configurações) na barra de usuário

  2. Na seção "Acesso" da barra lateral, clique em Chaves SSH e GPG.

  3. Clique em Nova chave SSH ou Adicionar chave SSH. Botão da chave SSH

  4. No campo "Title" (Título), adicione uma etiqueta descritiva para a nova chave. Por exemplo, se estiver usando um laptop pessoal, você poderá chamar essa chave de "Laptop pessoal".

  5. Cole a chave no campo "Key". O campo da chave

  6. Clique em Adicionar chave SSH. Botão Adicionar chave

  7. Se solicitado, confirme acesso à sua conta em GitHub Enterprise Server. Para obter mais informações, confira "Modo sudo".

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Antes de poder usar o GitHub CLI para adicionar uma chave SSH à sua conta, você deve efetuar a autenticação no GitHub CLI. Para obter mais informações, confira "gh auth login" na documentação da GitHub CLI.

Para adicionar uma chave de autenticação SSH à sua conta do GitHub, use o subcomando ssh-key add especificando a chave pública.

gh ssh-key add KEY-FILE

Para incluir um título para a nova chave, use o sinalizador -t ou --title.

gh ssh-key add KEY-FILE --title "personal laptop"

Se você gerou sua chave SSH seguindo as instruções descritas em "Como gerar uma nova chave SSH", adicione a chave à sua conta com este comando.

gh ssh-key add ~/.ssh/id_ed25519.pub