Ajuda

Gerar chave SSH: par Ed25519 ou RSA no navegador

Com esta ferramenta você pode criar uma chave SSH sem abrir um terminal nem usar o ssh-keygen. Escolha um Algoritmo, aperte Gerar par de chaves, baixe a chave privada e copie a linha da chave pública para o GitHub, o GitLab ou um servidor. As chaves são criadas no seu navegador e nunca saem dele. A página não consegue salvá-las nem enviá-las.


Como gerar uma chave SSH, passo a passo

  1. Deixe o algoritmo em Ed25519 (recomendado). Para um servidor antigo, escolha RSA 4096 bits ou RSA 2048 bits.
  2. Se quiser, digite um rótulo em Comentário (opcional), por exemplo voce@example.com. Ele pode ter até 100 caracteres.
  3. Aperte Gerar par de chaves. O Ed25519 sai na hora; o RSA 4096 bits pode levar alguns segundos.
  4. No cartão vermelho Chave privada, aperte Baixar chave privada. O arquivo se chama id_ed25519 no Ed25519 e id_rsa nos dois tamanhos de RSA.
  5. No cartão Chave pública, aperte Copiar para a área de transferência. O botão mostra “Copiado” por um instante.
  6. Aperte Recomeçar para voltar à primeira tela. O par de chaves não é guardado, então baixe antes.

Chave privada e chave pública: para que serve cada uma

A chave privada é um arquivo OpenSSH sem criptografia que começa com -----BEGIN OPENSSH PRIVATE KEY-----. Ela fica na sua pasta ~/.ssh e em nenhum outro lugar. Quem a tiver pode entrar como você, por isso a página a marca em vermelho.

A chave pública é uma linha só, como ssh-ed25519 AAAA... voce@example.com ou, no RSA, ssh-rsa AAAA.... Você pode compartilhá-la: ela vai nas configurações de chaves SSH do GitHub ou do GitLab, ou no arquivo authorized_keys de um servidor. Com o comentário vazio, a linha termina logo depois da chave, sem espaço no fim.

Gerar chave Ed25519 ou RSA: qual algoritmo escolher

Para gerar uma chave Ed25519, quase sempre basta a opção padrão. Ela é curta, rápida e aceita pelas versões atuais do GitHub, do GitLab e do OpenSSH. A chave pública começa com ssh-ed25519.

O RSA só é necessário se um servidor antigo recusar o Ed25519. O RSA 4096 bits tem mais margem, e o RSA 2048 bits é gerado mais rápido. Os dois são baixados como id_rsa e começam com ssh-rsa. Se você já tem uma chave com esse nome, renomeie o arquivo novo antes de movê-lo.

Criar chave SSH no Windows, macOS e Linux: ajuste as permissões

Um arquivo baixado chega com permissões comuns, e o ssh se recusa a usar uma chave privada que outros usuários possam ler, com uma mensagem como UNPROTECTED PRIVATE KEY FILE ou permissions are too open. No macOS e no Linux, coloque o arquivo na pasta .ssh e deixe-o legível só por você:

Para uma chave RSA, use id_rsa. No Windows, o arquivo também precisa ser legível apenas pela sua própria conta. A página repete o comando chmod na nota Depois de baixar.

Criar chave SSH no GitHub, chave SSH no GitLab ou em um servidor

No GitHub ou no GitLab, cole a linha copiada na caixa de nova chave SSH das configurações. Em um servidor, acrescente a linha a ~/.ssh/authorized_keys e depois conecte-se com a chave:

A página não tem botão para baixar a chave pública. Se quiser um arquivo .pub ao lado da chave privada, cole a linha copiada em um novo arquivo de texto chamado id_ed25519.pub.

Senha da chave e comentário

A chave privada gerada não é criptografada, e a página não tem campo de passphrase. Se o arquivo se perder ou for copiado, a chave funciona para quem o tiver. Para protegê-la, adicione uma passphrase no computador onde o arquivo está agora: ssh-keygen -p -f ~/.ssh/id_ed25519. A chave pública não muda, então nada precisa ser trocado no GitHub nem nos servidores.

O comentário é só um rótulo no fim da chave pública, como seu e-mail ou o nome do notebook. Ele ajuda a distinguir chaves em uma lista e não afeta o funcionamento. Se você precisa de uma senha, e não de uma chave, existe o Gerador de Senhas.


Perguntas frequentes

Como gerar chave SSH online?

Deixe o algoritmo em “Ed25519 (recomendado)”, acrescente se quiser um comentário como seu e-mail e aperte “Gerar par de chaves”. Salve o arquivo com “Baixar chave privada” e copie a linha da chave pública com “Copiar para a área de transferência”. O Ed25519 aparece na hora; o RSA 4096 bits pode levar alguns segundos.

É seguro gerar uma chave SSH online?

Aqui o par de chaves é criado no seu navegador, a partir dos números aleatórios seguros do próprio navegador, e existe só na memória da página até você baixá-lo. A página não tem como salvar nem enviar suas chaves, e a chave privada some quando você sai. Se a chave for proteger um servidor de produção, gere-a em um computador de confiança e depois coloque uma passphrase.

Devo escolher Ed25519 ou RSA?

Escolha Ed25519, a menos que um servidor o recuse. As chaves Ed25519 são curtas, rápidas de criar e aceitas pelas versões atuais do GitHub, do GitLab e do OpenSSH. O RSA é para servidores antigos que não aceitam Ed25519.

RSA 4096 bits ou RSA 2048 bits?

O RSA 4096 bits tem mais margem e leva alguns segundos para ser criado. O RSA 2048 bits é mais rápido e ainda é amplamente aceito. Os dois são baixados como um arquivo chamado id_rsa e dão uma chave pública que começa com ssh-rsa.

Por que o ssh diz que o arquivo da chave privada está desprotegido ou com permissões abertas demais?

Um arquivo baixado recebe permissões comuns que outros usuários do computador podem ler, e o ssh recusa uma chave privada nesse estado. No macOS e no Linux, mova o arquivo para ~/.ssh e execute chmod 600 ~/.ssh/id_ed25519 (id_rsa para chave RSA). No Windows, o arquivo também precisa ser legível apenas pela sua própria conta.

Onde salvo a chave privada baixada?

Na pasta .ssh do seu diretório pessoal: ~/.ssh no macOS e no Linux, e C:\Users\usuário\.ssh no Windows. Mantenha o nome dado pela página, id_ed25519 ou id_rsa, para que o ssh a encontre sem opções extras. Os dois tamanhos de RSA são baixados como id_rsa, então renomeie o arquivo se você já tiver uma chave com esse nome.

Como adicionar a chave pública ao GitHub ou ao GitLab?

Aperte “Copiar para a área de transferência”, abra a página de chaves SSH nas configurações da sua conta, escolha adicionar uma nova chave e cole a linha inteira na caixa da chave. Cole só a chave pública, a linha que começa com ssh-ed25519 ou ssh-rsa, e nunca o arquivo da chave privada.

Como adicionar a chave pública ao authorized_keys de um servidor?

Acrescente a linha copiada, como uma linha única, a ~/.ssh/authorized_keys no servidor, por exemplo com echo "ssh-ed25519 AAAA... voce@example.com" >> ~/.ssh/authorized_keys. Depois conecte-se com ssh -i ~/.ssh/id_ed25519 user@host.

A chave tem passphrase, e posso adicionar uma depois?

A chave não tem passphrase, e a página não tem campo para isso. Para adicionar uma depois, execute ssh-keygen -p -f ~/.ssh/id_ed25519 no arquivo baixado e digite uma nova passphrase quando for pedido. Até lá, qualquer pessoa que obtiver o arquivo pode usar a chave.

Posso recuperar a mesma chave depois de fechar a página?

Não. O par de chaves não é guardado em lugar nenhum, então se você sair da página ou apertar “Recomeçar” sem baixar a chave privada, ela se perde e você gera um par novo. Baixe a chave privada antes de sair.