Tutorial do Debian 13 / Configurar autenticação por chave SSH sem perder o acesso

Para configurar a autenticação por chave no Secure Shell (SSH, protocolo de acesso remoto criptografado) no Debian 13, verifique a impressão digital da chave do host do servidor, registre sua chave pública e teste uma conexão separada autenticada por chave. Restrinja o login por senha e o acesso direto de root somente depois que esse teste for bem-sucedido. Mantenha uma sessão funcionando e o console da VM disponível enquanto verifica a sintaxe do sshd, a política efetiva e novas conexões.

Prepare o caminho da conexão e o console de recuperação

Use a VM Debian mínima instalada com a tarefa do servidor SSH. O exemplo assume que lfstudent é seu administrador sudo existente. Se seu nome de usuário for diferente, substitua-o consistentemente em todos os comandos. Revise o exercício sobre usuários, grupos e permissões se precisar verificar o acesso sudo da conta.

Para o NAT do VirtualBox, encaminhe o endereço do host 127.0.0.1:22213 para a porta TCP 22 do convidado. Com a VM desligada, selecione-a no VirtualBox Manager, abra Configurações → Rede → Adaptador 1, confirme NAT, depois abra Avançado → Encaminhamento de Portas. Adicione uma regra TCP com IP do Host 127.0.0.1, Porta do Host 22213, IP do Convidado em branco e Porta do Convidado 22. Reutilize uma regra existente correspondente e verifique conflitos da porta do host. Esta regra vinculada ao loopback permite acesso a partir do host atual; 127.0.0.1 em outro computador refere-se a esse computador, não a esta VM.

Primeiro, verifique no console do Debian. Se você não instalou o openssh-server, execute sudo apt update e sudo apt install openssh-server no console e prepare o serviço.

systemctl is-active ssh
systemctl is-enabled ssh
ss -lnt | grep ':22 '
sudo /usr/sbin/sshd -t
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Certifique-se de que o serviço está ativo e habilitado na inicialização. sshd -t geralmente não retorna nada se for bem-sucedido. Se houver um erro, não comece a alterar a política de conexão. O registro do curso original corresponde a uma VM Debian 13.7 e um cliente OpenSSH do Windows.

Distinga as chaves do servidor das chaves do usuário

Distinção Alvo a verificar Local de armazenamento e função
Chave do host do servidor Se é o servidor ao qual você se conectou A identidade é verificada usando os arquivos /etc/ssh/ssh_host_* do servidor e o known_hosts do cliente.
Chave privada do usuário Verifique se o usuário conectado possui a chave Armazenada no cliente. Não copie para o servidor nem compartilhe com outros.
Chave pública do usuário A metade pública correspondente à chave privada permitida Registrada em .ssh/authorized_keys no diretório home do usuário do servidor.

Conecte-se inicialmente a partir do Windows PowerShell usando o seguinte. Como a chave ainda não foi registrada, a senha do usuário do servidor pode ser necessária.

ssh -o HostKeyAlgorithms=ssh-ed25519 -p 22213 lfstudent@127.0.0.1

Compare a impressão digital SHA256 exibida inicialmente com a impressão digital da chave do host ED25519 verificada anteriormente no console da VM antes de aprová-la. Não digite 'yes' apenas porque uma impressão digital aparece na tela. ssh-keyscan é uma ferramenta para buscar chaves na rede, não um meio de verificar de forma independente a identidade do servidor.

Se você reinstalar o servidor ou alterar o alvo NAT, a chave do host pode ser diferente. Se você vir um aviso REMOTE HOST IDENTIFICATION HAS CHANGED, primeiro verifique o console e o alvo da conexão. Remova a entrada no PowerShell usando ssh-keygen -R "[127.0.0.1]:22213" e re-verifique a impressão digital apenas se tiver confirmado que a alteração é legítima. Não exclua todo o arquivo known_hosts sem verificação.

Crie uma chave Ed25519 de usuário no Windows

Execute o seguinte comando no Windows. Certifique-se de que não exista um arquivo com o mesmo nome antes de criá-lo. Se você já possui uma chave privada em uso, não a substitua e escolha um novo nome de arquivo apropriado. Se não conseguir encontrar o comando OpenSSH, verifique se o cliente OpenSSH está instalado nos Recursos Opcionais do Windows.

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ssh" | Out-Null
Test-Path "$env:USERPROFILE\.ssh\debian13_lab"
Test-Path "$env:USERPROFILE\.ssh\debian13_lab.pub"

Crie o par de chaves somente se os dois resultados forem False. A frase secreta (passphrase) é um texto que protege o uso do arquivo de chave privada e é diferente da senha da conta do servidor. Para chaves usadas em conexões interativas, defina uma frase única que seja difícil de adivinhar e estabeleça uma política de recuperação e armazenamento.

ssh-keygen -t ed25519 -f "$env:USERPROFILE\.ssh\debian13_lab" -C "debian13-lab-admin"
Get-Content "$env:USERPROFILE\.ssh\debian13_lab.pub"

O arquivo debian13_lab gerado sem extensão é a chave privada; debian13_lab.pub é a chave pública. Copie apenas a linha única da chave pública que começa com ssh-ed25519 para o servidor. O manual do ssh-keygen documenta a criação de chaves e opções de impressão digital. O Debian 13 não suporta mais chaves Digital Signature Algorithm (DSA), como explicado nas alterações do OpenSSH nas notas de lançamento do Debian 13; não tente restaurar o acesso reativando chaves ssh-dss obsoletas.

Registre a chave pública e teste uma nova conexão

Execute o seguinte dentro do Debian como lfstudent a partir da sessão SSH existente ou do console. Verifique se outros usuários não podem escrever no seu diretório home. Antes de executar o comando de backup, verifique se ~/.ssh/authorized_keys.before-course07 já não existe; se existir, escolha um nome de arquivo de backup novo e use-o de forma consistente. Preserve as chaves existentes enquanto prepara o .ssh.

whoami
ls -ld ~
mkdir -p ~/.ssh
chmod 700 ~/.ssh
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
cp -a ~/.ssh/authorized_keys ~/.ssh/authorized_keys.before-course07
nano ~/.ssh/authorized_keys

Se um arquivo de backup já existir, preserve-o usando um nome novo. No editor, preserve as chaves públicas existentes que ainda sejam válidas e adicione a nova chave pública em uma nova linha. O fato de o conteúdo da chave pública aparecer quebrado na tela devido à largura é diferente das quebras de linha reais no arquivo. Uma chave deve estar em uma única linha. Após salvar, verifique o proprietário e as permissões.

stat -c '%a %U %G %n' ~ ~/.ssh ~/.ssh/authorized_keys

Verifique se o proprietário de .ssh e authorized_keys é lfstudent, e se os modos são 700 e 600 respectivamente. Se um administrador os criou em nome do usuário, certifique-se de que não haja arquivos de propriedade root incorretos restantes. Não torne a home do servidor gravável por todos nem coloque chaves privadas em authorized_keys.

Execute uma conexão em uma nova janela do PowerShell permitindo apenas autenticação por chave, deixando a sessão existente como está. Aqui, é limitado para evitar confundir um sucesso que automaticamente muda para autenticação por senha como um sucesso de autenticação por chave.

ssh -i "$env:USERPROFILE\.ssh\debian13_lab" -o IdentitiesOnly=yes -o PreferredAuthentications=publickey -o PasswordAuthentication=no -p 22213 lfstudent@127.0.0.1

Uma solicitação para a frase secreta da chave privada pode aparecer, mas ela não mudará para a autenticação de senha da conta do servidor. Após conectar, verifique id -un e sudo -v no Debian. Como as conexões de autenticação por chave e a autenticação sudo são separadas, mesmo que o SSH seja apenas por chave, o sudo pode exigir a senha do usuário. Não desative o login por senha até que a conexão da nova sessão e as operações administrativas sejam verificadas.

Restrinja o login por senha e de root e confira a política efetiva

Mantenha o console e a sessão SSH ativa disponíveis. Execute separadamente o primeiro comando, que cria o diretório de backup e continue apenas se ele for bem-sucedido. Pare se qualquer verificação dos caminhos de destino falhar: não sobrescreva um backup anterior ou um /etc/ssh/sshd_config.d/00-lf-course.conf existente. Este exemplo adiciona apenas um novo fragmento de configuração.

sudo test ! -e /var/backups/lf-debian13-07 && sudo install -d -m 700 /var/backups/lf-debian13-07
sudo cp -a /etc/ssh/sshd_config /etc/ssh/sshd_config.d /var/backups/lf-debian13-07/
sudo test ! -e /etc/ssh/sshd_config.d/00-lf-course.conf
sudo nano /etc/ssh/sshd_config.d/00-lf-course.conf

Coloque as seguintes quatro linhas no novo arquivo. Estas são diretivas do sshd_config, mostradas como texto simples em vez de comandos de shell.

PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no

PasswordAuthentication controla a autenticação por senha, e KbdInteractiveAuthentication controla o caminho de autenticação interativa. Não aplique essas quatro linhas como estão em um servidor operacional usando autenticação interativa em autenticação multifator (MFA); primeiro verifique a política da sua organização. PermitRootLogin no impede o login SSH direto como root e é separado de um administrador comum usando sudo.

sudo chmod 600 /etc/ssh/sshd_config.d/00-lf-course.conf
sudo /usr/sbin/sshd -t
sudo /usr/sbin/sshd -T -C user=lfstudent,host=localhost,addr=10.0.2.2 | grep -E '^(pubkeyauthentication|passwordauthentication|kbdinteractiveauthentication|permitrootlogin) '

Se o -t falhar, corrija o erro antes de recarregar. A opção -T imprime as configurações efetivas, enquanto -C fornece condições de conexão. Neste laboratório NAT do VirtualBox, o convidado vê 10.0.2.2 como o endereço do lado do cliente. Substitua o endereço de exemplo e as condições Match pelas da sua sessão atual, usando a saída de printf '%s\n' "$SSH_CONNECTION". Se você usar correspondência de hostname, forneça também a condição real do hostname do cliente.

permitrootlogin no
pubkeyauthentication yes
passwordauthentication no
kbdinteractiveauthentication no

manual do sshd_config explica que a maioria das configurações usa o valor obtido primeiro. Um nome de arquivo que aparece depois na ordenação, ou uma diretiva colocada por último, não assume automaticamente precedência. O resultado pode variar dependendo da localização do Include no arquivo Debian padrão, outros fragmentos de configuração e condições Match, portanto, verifique se o resultado do -T corresponde à sua intenção.

Recarregue e verifique outra nova conexão

Se a sintaxe for válida e a política efetiva corresponder ao que você pretende, recarregue a configuração sem interromper o serviço.

sudo systemctl reload ssh
systemctl is-active ssh

Uma vez que o serviço esteja ativo, abra outra nova conexão com o comando PowerShell anterior somente com a chave. Uma sessão existente ativa não prova que novas tentativas de autenticação funcionam. O manual do sshd documenta testes de configuração; uma conexão real bem-sucedida verifica uma parte separada da configuração.

No teste do curso original, uma nova chave Ed25519 foi criada e registrada em uma VM dedicada, com novas conexões verificadas antes e depois da alteração da política. Um arquivo separado com configuração inválida foi rejeitado por -t e não foi aplicado ao serviço. Chaves de automação exigem uma política de gestão diferente das chaves protegidas por frase secreta para conexões interativas. Ao final do teste original, a chave pública foi removida e uma nova tentativa de conexão com ela foi recusada.

Se a conexão falhar, verifique sudo journalctl -u ssh -b --no-pager -n 50 no servidor. A mensagem Permission denied (publickey) indica que você deve conferir a conta, a chave, as permissões e a política de autenticação. Para Connection refused, comece pelo serviço em escuta e pelo destino do encaminhamento de porta. Se houver tempo limite excedido, verifique primeiro o caminho da rede e o firewall. A saída detalhada ssh -v do cliente é útil para diagnósticos, mas revise o nome de usuário, o caminho e as informações do servidor antes de compartilhá-las com outros.

Recupere o acesso e revogue chaves desnecessárias

Se apenas os arquivos recém-adicionados neste exercício forem a causa, remova somente a configuração adicionada aqui, usando a sessão funcional preservada ou o console da VM. Verifique com precisão o alvo da exclusão e não aplique a arquivos criados por outros administradores.

sudo rm -- /etc/ssh/sshd_config.d/00-lf-course.conf
sudo /usr/sbin/sshd -t && sudo systemctl reload ssh
sudo /usr/sbin/sshd -T | grep -E '^(pubkeyauthentication|passwordauthentication|kbdinteractiveauthentication|permitrootlogin) '

Se você também modificou /etc/ssh/sshd_config ou outros fragmentos de configuração, restaure as alterações comparando-as com o backup e execute novamente sshd -t antes de recarregar. Se a conexão SSH estiver completamente quebrada, não tente repetidamente corrigir isso pela rede; faça login através do console da VM. Você também deve verificar antes de começar o trabalho se pode usar a autenticação do console e o sudo.

Ao revogar uma chave de teste, remova apenas aquela linha de chave pública do authorized_keys. Não exclua chaves existentes que várias pessoas estejam usando juntas. Você só pode restaurar o backup original do authorized_keys se nenhuma outra chave válida tiver sido adicionada desde o backup. Se você perder uma chave privada, simplesmente mudar a senha não remove o acesso dessa chave, portanto ela também deve ser revogada da lista de chaves permitidas do servidor.