Sobre a adição de chaves SSH à sua conta
É possível acessar e gravar dados em repositórios no GitHub.com 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ê precisará adicionar a chave pública ao GitHub.com para habilitar o acesso SSH na sua conta.
Pré-requisitos
Antes de adicionar uma nova chave SSH à sua conta no GitHub.com, conclua as etapas a seguir.
- Verifique se há chaves SSH existentes. Para obter mais informações, confira "Como verificar se há chaves SSH existentes".
- 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 GitHub.com, 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: 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.
-
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: com o ao WSL (Subsistema do Windows para Linux), você pode usar o
clip.exe
. Caso contrário, seclip
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. -
Na seção "Acesso" da barra lateral, clique em Chaves SSH e GPG.
-
Clique em Nova chave SSH ou Adicionar chave SSH.
-
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".
-
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".
-
Cole sua chave no campo "Key" (Chave).
-
Clique em Adicionar chave SSH.
-
Se solicitado, confirme acesso à sua conta em GitHub Enterprise Cloud. 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