Sobre a adição de chaves SSH à sua conta
Você pode acessar e gravar dados em repositórios no sua instância do GitHub Enterprise Server 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 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.
- Verifique se há chaves SSH existentes. Para obter mais informações, confira "Verificar se há chaves SSH".
- 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".
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 sua instância do GitHub Enterprise Server 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 saber mais sobre como determinar a versão de GitHub Enterprise Server que você está usando, confira "Sobre versões da Documentação do GitHub".
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 para sua instância".
-
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, 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. - 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
indicandoThe '<' operator is reserved for future use.
Nesse caso, o seguinte comando alternativoclip
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.
-
No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.
-
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 saber mais sobre a assinatura de commit, confira "Sobre a verificação de assinatura de commit".
-
No campo "Chave", cole sua chave pública.
-
Clique em Adicionar chave SSH.
-
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