Skip to main content

Adicionar uma nova chave SSH à sua conta do GitHub

Para configurar sua conta em para usar sua chave SSH nova (ou existente) chave SSH, você também deverá adicionar a chave à sua 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."

Você também pode usar SSH para assinar confirmações e marcas. Para obter mais informações sobre como assinar uma confirmação, confira "Sobre a verificação de assinaturas de confirmação".

Depois de gerar um par de chaves SSH, você precisa adicionar a chave pública a para habilitar o acesso SSH para sua conta.

Pré-requisitos

Antes de adicionar uma nova chave SSH à sua conta em , 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 , você poderá reconfigurar qualquer repositório local para usar 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. Selecione o tipo de chave: autenticação ou assinatura. Para obter mais informações sobre a assinatura de confirmações, confira "Sobre a verificação de assinaturas de confirmação".

  6. Cole sua chave no campo "Key" (Chave). O campo da chave

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

  8. 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.

No momento, você só pode usar GitHub CLI para adicionar chaves de autenticação SSH, não é possível adicionar chaves de assinatura SSH.

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