Configure uma chave SSH

Uma chave SSH permite autenticar sua conta no servidor com um par de chaves. A parte pública é instalada no servidor. A parte privada fica sob seu controle. Mantenha a sessão que já funciona aberta durante a configuração.

Crie ou importe a chave

No desktop, abra Keychain e escolha Generate key. Informe um nome, selecione Ed25519 quando o servidor aceitar esse algoritmo e defina uma passphrase. Conclua em Generate & save.

Para importar uma chave já fornecida para a VPS, use New key e Import from key file. Importe o arquivo privado diretamente, sem enviá-lo por chat ou incluí-lo em um repositório. Guarde a passphrase separadamente.

Instale a parte pública

Com uma forma de acesso funcional, abra o menu da chave no Keychain e escolha Export to host. Selecione o host e confira a conta de destino. A ação adiciona a parte pública ao arquivo de chaves autorizadas dessa conta. Use Export and Attach depois de conferir o destino.

Em servidores com políticas próprias, peça ao administrador para instalar a chave pública. Evite substituir o arquivo inteiro: ele pode conter acessos de outros administradores ou serviços.

Teste uma segunda sessão

Abra uma nova conexão usando a chave e confirme o usuário com whoami. Só encerre a sessão anterior depois que essa conexão funcionar. Se houver Permission denied, confira a conta, a chave selecionada, a passphrase e as permissões de SSH com o administrador.

Esta etapa não exige desativar a autenticação por senha nem alterar o firewall. Faça mudanças no serviço SSH em um procedimento separado, com o console da VPS disponível.

Diferencie as duas chaves e a passphrase

A chave pública pode ser entregue ao administrador para autorizar seu acesso. A privada permanece com você e participa da autenticação. Um arquivo chamado id_ed25519.pub costuma conter a parte pública, enquanto id_ed25519 costuma conter a privada. O nome é uma convenção, por isso confira o conteúdo e a origem do arquivo antes de compartilhá-lo.

A passphrase protege o uso da chave privada. Ela pode ser solicitada ao abrir uma conexão, mas não é a senha do usuário Linux. Criar uma nova passphrase para uma nova chave não altera a senha da VPS.

A autorização pertence a um usuário do servidor

Imagine que você instalou a chave pública para o usuário aluno. Ao tentar entrar como outro usuário, o servidor consulta as autorizações desse outro usuário. A mesma chave pode ser recusada porque não foi instalada para ele, mesmo que o endereço e a porta estejam corretos.

Em uma configuração OpenSSH habitual, a autorização fica no arquivo .ssh/authorized_keys dentro do diretório pessoal do usuário. O servidor pode usar outra configuração, definida pelo administrador. Por isso, confira a conta escolhida em Export to host e depois o resultado de whoami na nova sessão.

Se a segunda sessão não abrir

Mantenha a primeira conexão disponível e confira o host, o usuário e a chave associada. Se o aplicativo solicitar a passphrase, use a da chave selecionada. Se o servidor recusar a autenticação, confira com o administrador a instalação da parte pública e as permissões do diretório SSH.

Evite gerar várias chaves seguidas para tentar resolver a mesma falha. Isso dificulta identificar qual parte pública foi instalada e qual privada está sendo usada. Depois de conseguir entrar com a chave correta, siga para a organização dos hosts.