Skip to main content

Esta versão do GitHub Enterprise Server foi descontinuada em 2024-09-25. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Adicionar uma nova chave SSH à sua conta do GitHub

Para configurar sua conta em sua instância do GitHub Enterprise Server para usar sua chave SSH nova (ou existente), você também precisará adicionar a chave à conta.

Platform navigation

Tool navigation

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

Você pode acessar e gravar dados nos repositórios em GitHub usando o protocolo SSH (Secure Shell Protocol). Ao se conectar por meio do SSH, você se autentica usando um arquivo de chave privada no computador local. Para saber mais, confira "Sobre o SSH".

Você também pode usar SSH para assinar commits e tags. Para saber mais sobre a assinatura de commit, confira "Sobre a verificação de assinatura de commit".

Depois de gerar um par de chaves de SSH, você pode adicionar a chave pública em sua instância do GitHub Enterprise Server para permitir que o SSH acesse sua conta.

Pré-requisitos

Antes de adicionar uma nova chave SSH à sua conta em sua instância do GitHub Enterprise Server, conclua as etapas a seguir.

  1. Verifique se há chaves SSH existentes. Para obter mais informações, confira "Verificar se há chaves SSH".
  2. Gere uma nova chave SSH e adicione-a ao agente SSH do computador. Para obter mais informações, confira "Gerando uma nova chave SSH e adicionando-a ao agente SSH".

Como adicionar uma nova chave SSH à sua conta

Você pode adicionar uma chave SSH e usá-la para autenticação, assinatura de confirmação ou ambos. Se desejar usar a mesma chave SSH para autenticação e assinatura, será necessário fazer upload da chave duas vezes.

Depois de adicionar uma nova chave SSH de autenticação à sua conta em sua instância do GitHub Enterprise Server, você poderá reconfigurar qualquer repositório local para usar o SSH. Para obter mais informações, confira "Gerenciar repositórios remote".

  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

Observações:

  • Com o ao WSL (Subsistema do Windows para Linux), você pode usar o clip.exe. Caso contrário, 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.
  • Em versões mais recentes do Windows que usam o Terminal do Windows, ou em qualquer outro lugar que use a linha de comando do PowerShell, você pode receber um ParseError indicando The '&lt;' operator is reserved for future use. Nesse caso, o seguinte comando alternativo clip deve ser usado:
$ cat ~/.ssh/id_ed25519.pub | clip
# Copies the contents of the id_ed25519.pub file to your clipboard
$ 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 do GitHub, clique sua foto de perfil e, em seguida, clique em Configurações.

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

  3. Clique em Nova chave SSH ou Adicionar 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 saber mais sobre a assinatura de commit, confira "Sobre a verificação de assinatura de commit".

  6. No campo "Chave", cole sua chave pública.

  7. Clique em Adicionar chave SSH.

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

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

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 SSH à sua conta do GitHub, use o subcomando ssh-key add especificando a chave pública. Para chaves de autenticação, se for solicitado que você requisite escopos adicionais, siga as instruções na linha de comando.

gh ssh-key add KEY-FILE --type {authentication|signing}

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 "Gerando uma nova chave SSH e adicionando-a ao agente SSH", adicione a chave à sua conta com este comando.

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