Skip to main content

Adicionar uma nova chave SSH à sua conta do GitHub

Para configurar sua conta em GitHub.com 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 em repositórios no GitHub.com usando o protocolo SSH. 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 confirmações e marcas. 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 GitHub.com para permitir que o SSH acesse sua conta.

Pré-requisitos

Antes de adicionar uma nova chave SSH à sua conta em GitHub.com, 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 GitHub.com, você poderá reconfigurar qualquer repositório local para usar o SSH. Para obter mais informações, confira "Gerenciar repositórios remote".

Observação: o GitHub aprimorou a segurança removendo tipos de chaves mais antigos e não seguros em 15 de março de 2022.

Desde essa data, não há mais suporte para as chaves DSA (ssh-dss). Não é possível adicionar novas chaves DSA à conta pessoal em GitHub.com.

As chaves RSA (ssh-rsa) com um valid_after antes de 2 de novembro de 2021 podem continuar usando qualquer algoritmo de assinatura. As chaves RSA geradas após essa data precisam usar um algoritmo de assinatura SHA-2. Talvez alguns clientes mais antigos precisem ser atualizados para usar as assinaturas SHA-2.

  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, clique na foto do seu perfil e em Configurações.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

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

Leitura adicional