Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Gerar uma nova chave SSH e adicioná-la ao ssh-agent

Depois de verificar a existência de chaves SSH, é possível gerar uma nova chave SSH para autenticação e adicioná-la ao ssh-agent.

Neste artigo

Se você ainda não tem uma chave SSH, você deve gerar uma nova chave SSH. Caso não tenha certeza de que já tem uma chave SSH, procure por chaves existentes.

Caso não queira reinserir sua frase secreta cada vez que usa a chave SSH, é possível adicionar sua chave ao SSH agent, que poderá gerenciar suas chaves SSH e lembrar sua frase secreta.

Gerar uma nova chave SSH

  1. Abra TerminalTerminalGit Bash.

  2. Cole o texto abaixo, substituindo o endereço de e-mail pelo seu GitHub Enterprise Server.

    $ ssh-keygen -t ed25519 -C "your_email@example.com"

    Observação: Se você estiver usando um sistema legado que não é compatível com o algoritmo Ed25519, use:

    $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
    O comando criará uma nova chave SSH, usando o e-mail fornecido como uma etiqueta.
    > Generating public/private ed25519 key pair.
  3. Quando aparecer a solicitação "Enter a file in which to save the key" (Insira um arquivo no qual salvar a chave), presssione Enter. O local padrão do arquivo será aceito.

    > Enter a file in which to save the key (/Users/you/.ssh/id_ed25519): [Press enter]
    > Enter a file in which to save the key (/c/Users/you/.ssh/id_ed25519):[Press enter]
    > Enter a file in which to save the key (/home/you/.ssh/id_ed25519): [Press enter]
  4. Digite uma frase secreta segura no prompt. Para obter mais informações, consulte "Trabalhar com frases secretas da chave SSH".

    > Enter passphrase (empty for no passphrase): [Type a passphrase]
    > Enter same passphrase again: [Type passphrase again]

Adicionar sua chave SSH ao ssh-agent

Antes de adicionar uma nova chave SSH ao ssh-agent para gerenciar suas chaves, você deve ter verificado a existência de chaves SSH e gerado uma nova chave SSH. Ao adicionar sua chave SSH ao agent, use o comando padrão "ssh-add" do macOS, e não um aplicativo instalado por macports, homebrew ou qualquer outra fonte externa.

  1. Inicie o ssh-agent em segundo plano.

    $ eval "$(ssh-agent -s)"
    > Agent pid 59566
  2. Se estiver usando macOS Sierra 10.12.2 ou posterior, será necessário modificar seu arquivo ~/.ssh/config para carregar automaticamente as chaves no ssh-agent e armazenar as frases secretas em seu keychain.

    • Primeiro, verifique se o arquivo ~/.ssh/config existe no local padrão.

      $ open ~/.ssh/config
      > The file /Users/you/.ssh/config does not exist.
    • Se o arquivo não existir, crie o arquivo.

      $ touch ~/.ssh/config
    • Abre o seu arquivo ~/.ssh/config file, then modify the file, replacing ~/.ssh/id_ed25519 se você não estiver usando o local e nome padrão para a sua chave id_ed25519.

      Host *
        AddKeysToAgent yes
        UseKeychain yes
        IdentityFile ~/.ssh/id_ed25519
      

      Note: If you chose not to add a passphrase to your key, you should omit the UseKeychain line.

  3. Adicione sua chave SSH privada ao ssh-agent e armazene sua frase secreta no keychain. If you created your key with a different name, or if you are adding an existing key that has a different name, replace id_ed25519 in the command with the name of your private key file.

    $ ssh-add -K ~/.ssh/id_ed25519

    Observação: a opção -K está presente na versão padrão da Apple do ssh-add e armazena a frase secreta no keychain quando você adiciona uma chave SSH ao ssh-agent. If you chose not to add a passphrase to your key, run the command without the -K option.

    Caso não tenha a versão standard da Apple instalada, você poderá receber uma mensagem de erro. Para obter mais informações sobre como resolver esse erro, consulte "Erro: ssh-add: opção ilícita -- K".

  4. Adicione a chave SSH à sua conta GitHub.

Se você tiver o GitHub Desktop instalado, você pode usá-lo para clonar repositórios sem usar chaves SSH.

  1. Certifique-se de que o ssh-agent está em execução. Você pode usar as instruções "Lançamento automático do ssh-agent" em "Trabalhando com palavras-chave SSH" ou iniciá-lo manualmente:

    # inicie o ssh-agent em segundo plano
    $ eval $(ssh-agent -s)
    > Agent pid 59566
  2. Adicione sua chave SSH privada ao ssh-agent. If you created your key with a different name, or if you are adding an existing key that has a different name, replace id_ed25519 in the command with the name of your private key file.

    $ ssh-add ~/.ssh/id_ed25519
  3. Adicione a chave SSH à sua conta GitHub.

  1. Inicie o ssh-agent em segundo plano.

    $ eval "$(ssh-agent -s)"
    > Agent pid 59566
  2. Adicione sua chave SSH privada ao ssh-agent. If you created your key with a different name, or if you are adding an existing key that has a different name, replace id_ed25519 in the command with the name of your private key file.

    $ ssh-add ~/.ssh/id_ed25519
  3. Adicione a chave SSH à sua conta GitHub.

Leia mais

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.