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) chave SSH, você também deverá adicionar a chave à sua conta.

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

You can access and write data in repositories on GitHub.com using SSH (Secure Shell Protocol). When you connect via SSH, you authenticate using a private key file on your local machine. Para obter mais informações, consulte "Sobre SSH".

Após gerar um par de chaves SSH, você deve adicionar a chave pública em GitHub.com para habilitar o acesso SSH para a sua conta.

Pré-requisitos

Antes de adicionar uma nova chave SSH à sua conta em GitHub.com, siga os seguintes passos.

  1. Verifique se há chaves SSH existentes. Para obter mais informações, consulte "Verificar as chaves SSH existentes".
  2. Gere uma nova chave SSH e adicione-a ao agente SSH da sua máquina. Para obter mais informações, consulte "Gerar uma nova chave SSH e adicioná-la ao ssh-agent".

Adicionando uma nova chave SSH à sua conta

Depois de adicionar uma nova chave SSH à sua conta em GitHub.com, você poderá reconfigurar quaisquer repositórios locais para usar SSH. Para obter mais informações, consulte "Alternar URLs remotos de HTTPS para SSH".

Note: GitHub improved security by dropping older, insecure key types on March 15, 2022.

As of that date, DSA keys (ssh-dss) are no longer supported. You cannot add new DSA keys to your personal account on GitHub.com.

RSA keys (ssh-rsa) with a valid_after before November 2, 2021 may continue to use any signature algorithm. RSA keys generated after that date must use a SHA-2 signature algorithm. Some older clients may need to be upgraded in order to use SHA-2 signatures.

  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, você poderá localizar a pasta .ssh oculta, abrir o arquivo no seu editor de texto de preferência e copiá-lo na área de transferência.

  2. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. Clique em New SSH key (Nova chave SSH) ou Add SSH key (Adicionar chave SSH). Botão SSH Key (Chave SSH)

  5. No campo "Title" (Título), adicione uma etiqueta descritiva para a nova chave. Por exemplo, se estiver usando um Mac pessoal, você poderá chamar essa chave de "MacBook Air Pessoal".

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

  7. Clique em Add SSH key (Adicionar chave SSH). O botão Add key (Adicionar chave)

  8. If prompted, confirm access to your account on GitHub. Para obter mais informações, consulte "modo Sudo".

  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.

    $ clip < ~/.ssh/id_ed25519.pub
    # Copies the contents of the id_ed25519.pub file to your clipboard

    Dica: se clip não estiver funcionando, você poderá localizar a pasta .ssh oculta, abrir o arquivo no seu editor de texto de preferência e copiá-lo na área de transferência.

  2. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. Clique em New SSH key (Nova chave SSH) ou Add SSH key (Adicionar chave SSH). Botão SSH Key (Chave SSH)

  5. No campo "Title" (Título), adicione uma etiqueta descritiva para a nova chave. Por exemplo, se estiver usando um Mac pessoal, você poderá chamar essa chave de "MacBook Air Pessoal".

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

  7. Clique em Add SSH key (Adicionar chave SSH). O botão Add key (Adicionar chave)

  8. If prompted, confirm access to your account on GitHub. Para obter mais informações, consulte "modo Sudo".

  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.

    $ 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 de .ssh, abrir o arquivo no seu editor de texto favorito e copiá-lo na sua área de transferência.

  2. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. Clique em New SSH key (Nova chave SSH) ou Add SSH key (Adicionar chave SSH). Botão SSH Key (Chave SSH)

  5. No campo "Title" (Título), adicione uma etiqueta descritiva para a nova chave. Por exemplo, se estiver usando um Mac pessoal, você poderá chamar essa chave de "MacBook Air Pessoal".

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

  7. Clique em Add SSH key (Adicionar chave SSH). O botão Add key (Adicionar chave)

  8. If prompted, confirm access to your account on GitHub. Para obter mais informações, consulte "modo Sudo".

Para saber mais sobre GitHub CLI, consulte "Sobre 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, consulte login login gh na documentação do GitHub CLI.

Para adicionar uma chave SSH à sua conta do GitHub, use o subcomando ssh-key add, especificando a sua 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 a sua chave SSH seguindo as instruções em "Gerando uma nova chave SSH", você pode adicionar a chave à sua conta usando este comando.

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

Leia mais