Tutorial de Debian 13 / Configurar claves SSH sin perder el acceso al servidor

Para configurar la autenticación mediante clave de Secure Shell (SSH, protocolo de acceso remoto cifrado) en Debian 13, verifique la huella digital de la clave del servidor, registre su clave pública y pruebe una conexión separada autenticada por clave. Restringa las contraseñas y los inicios de sesión directos como root solo después de que esa prueba sea exitosa. Mantenga una sesión activa y la consola de la VM disponible mientras verifica la sintaxis de sshd, la política efectiva y las nuevas conexiones.

Preparar la conexión y la consola de recuperación

Use la VM mínima de Debian instalada con la tarea del servidor SSH. El ejemplo asume que lfstudent es su administrador sudo existente. Si su nombre de usuario es diferente, reemplácelo de manera consistente en cada comando. Revise el ejercicio sobre usuarios, grupos y permisos si necesita verificar el acceso sudo de la cuenta.

Para NAT de VirtualBox, reenvíe la dirección del host 127.0.0.1:22213 al puerto TCP 22 del invitado. Con la VM apagada, selecciónela en VirtualBox Manager, abra Configuración → Red → Adaptador 1, confirme NAT, luego abra Avanzado → Reenvío de puertos. Agregue una regla TCP con IP del host 127.0.0.1, Puerto del host 22213, IP del invitado en blanco y Puerto del invitado 22. Reutilice una regla coincidente existente y verifique conflictos de puerto del host. Esta regla vinculada al bucle local permite el acceso desde el host actual; 127.0.0.1 en otra computadora se refiere a esa computadora, no a esta VM.

Primero, verifique en la consola de Debian. Si no ha instalado openssh-server, ejecute sudo apt update y sudo apt install openssh-server en la consola y prepare el servicio.

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

Asegúrese de que el servicio esté activo y habilitado al inicio. sshd -t generalmente no muestra nada si tiene éxito. Si hay un error, no comience a cambiar la política de conexión. La verificación original del curso se realizó entre una VM de Debian 13.7 y un cliente OpenSSH de Windows.

Distinguir las claves de host del servidor de las claves de usuario

Distinción Objetivo a verificar Ubicación de almacenamiento y función
Clave de host del servidor Si es el servidor al que se conectó La identidad se verifica utilizando el /etc/ssh/ssh_host_* del servidor y los known_hosts del cliente.
Clave privada del usuario Verifique si el usuario que se conecta posee la clave Almacenada en el cliente. No la copie al servidor ni compartir con otros.
Clave pública del usuario La mitad pública que coincide con la clave privada permitida Registrada en .ssh/authorized_keys en el directorio de inicio del usuario del servidor.

Conéctese inicialmente desde Windows PowerShell con el comando siguiente. Dado que la clave aún no se ha registrado, puede ser necesaria la contraseña del usuario del servidor.

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

Compare la huella digital SHA256 mostrada inicialmente con la huella digital de la clave del host ED25519 que comprobó anteriormente en la consola de la VM antes de aprobarla. No escriba 'yes' solo porque una huella digital aparezca en la pantalla. ssh-keyscan es una herramienta para obtener claves desde la red, no un medio para verificar de manera independiente la identidad del servidor.

Si reinstala el servidor o cambia el destino NAT, la clave del host puede diferir. Si ve una advertencia REMOTE HOST IDENTIFICATION HAS CHANGED, primero compruebe la consola y el objetivo de la conexión. Elimine únicamente la entrada en PowerShell usando ssh-keygen -R "[127.0.0.1]:22213" y vuelva a verificar la huella digital si ha confirmado que el cambio es legítimo. No elimine todo el archivo known_hosts sin verificación.

Crear una clave Ed25519 de usuario en Windows

Ejecute el siguiente comando en Windows. Asegúrese de que no exista un archivo con el mismo nombre antes de crearlo. Si ya tiene una clave privada en uso, no la sobrescriba y elija un nombre de archivo nuevo apropiado. Si no puede encontrar el comando OpenSSH, verifique si el cliente OpenSSH está instalado en Funciones opcionales de 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"

Cree el par de claves solo si ambos resultados son False. La frase secreta (passphrase) es un texto que protege el uso del archivo de clave privada y es diferente de la contraseña de la cuenta del servidor. Para las claves de uso interactivo, establezca una frase única que sea difícil de adivinar y establezca una política de recuperación y almacenamiento.

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

El archivo debian13_lab generado sin una extensión es la clave privada; debian13_lab.pub es la clave pública. Copie únicamente la línea única de la clave pública que comienza con ssh-ed25519 al servidor. El manual de ssh-keygen documenta la creación de claves y las opciones de huella digital. Debian 13 ya no admite claves del Algoritmo de Firma Digital (DSA), como se explica en la sección de cambios de OpenSSH en las notas de Debian 13; no intente restaurar el acceso reactivando claves ssh-dss obsoletas.

Registre la clave pública y pruebe una nueva conexión

Ejecute lo siguiente dentro de Debian como lfstudent desde la sesión SSH existente o consola. Verifique que otros usuarios no puedan escribir en su directorio personal. Antes de ejecutar el comando de respaldo, verifique que ~/.ssh/authorized_keys.before-course07 no exista ya; si existe, elija un nombre de archivo de respaldo nuevo y úselo de manera consistente. Preserve las claves existentes mientras prepara .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

Si ya existe un archivo de respaldo, consérvelo con un nombre nuevo. En el editor, conserve las claves públicas existentes que sigan siendo válidas y agregue la nueva clave pública en una nueva línea. El hecho de que el contenido de la clave pública aparezca envuelto en la pantalla debido al ancho es diferente de los saltos de línea reales en el archivo. Una clave debe estar en una sola línea. Después de guardar, verifique el propietario y los permisos.

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

Verifique que el propietario de .ssh y authorized_keys sea lfstudent, y que los modos sean 700 y 600 respectivamente. Si un administrador los creó en su nombre, asegúrese de que no queden archivos propiedad de root incorrectos. No haga que el directorio home del servidor sea escribible por todos ni coloque claves privadas en authorized_keys.

Ejecute una conexión en una nueva ventana de PowerShell permitiendo solo la autenticación por clave, dejando la sesión existente como está. Aquí, se limita para evitar confundir un éxito que automáticamente cambie a la autenticación por contraseña como un éxito de autenticación por clave.

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

Puede aparecer un aviso para la frase de contraseña de la clave privada, pero no cambiará a la autenticación de contraseña de la cuenta del servidor. Después de conectarse, verifique id -un y sudo -v en Debian. Dado que las conexiones de autenticación por clave y la autenticación sudo son separadas, incluso si SSH es solo por clave, sudo puede requerir la contraseña del usuario. No desactive el inicio de sesión por contraseña hasta que se verifique la conexión de la nueva sesión y las operaciones administrativas.

Restringir los inicios de sesión por contraseña y de root y verificar la política efectiva

Mantenga la consola y la sesión SSH activa disponibles. Ejecute por separado el primer comando, que crea el directorio de copia de seguridad, y continúe solo si tiene éxito. Deténgase si falla alguna comprobación de las rutas de destino: no sobrescriba un respaldo anterior ni un /etc/ssh/sshd_config.d/00-lf-course.conf existente. Este ejemplo solo agrega un nuevo fragmento de configuración.

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 las siguientes cuatro líneas en el nuevo archivo. Estas son directivas de sshd_config, mostradas como texto plano en lugar de comandos de shell.

PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no

PasswordAuthentication controla la autenticación mediante contraseña, y KbdInteractiveAuthentication controla la ruta de autenticación interactiva. No aplique estas cuatro líneas tal como están en un servidor operativo que use autenticación interactiva en autenticación multifactor (MFA); primero consulte la política de su organización. La directiva PermitRootLogin no impide el inicio de sesión SSH directo como root y es independiente de un administrador regular que use 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) '

Si -t falla, corrija el error antes de recargar. La opción -T imprime la configuración efectiva, mientras que -C suministra las condiciones de conexión. En este laboratorio NAT de VirtualBox, el invitado ve 10.0.2.2 como la dirección del lado del cliente. Sustituya la dirección de ejemplo y las condiciones de Match por las de su sesión real, usando la salida de printf '%s\n' "$SSH_CONNECTION". Si utiliza la coincidencia de nombres de host, proporcione también la condición del nombre de host del cliente real.

permitrootlogin no
pubkeyauthentication yes
passwordauthentication no
kbdinteractiveauthentication no

manual de sshd_config explica que la mayoría de las configuraciones usan el valor obtenido primero. Un nombre de archivo que se ordena más tarde, o una directiva colocada al final, no toma automáticamente la precedencia. El resultado puede variar dependiendo de la ubicación del Include en el archivo predeterminado de Debian, otros archivos fragmentos y las condiciones de Match, por lo que debe comprobar que el resultado de -T corresponde a su intención.

Recargar y verificar otra conexión nueva

Si la sintaxis es válida y la política efectiva es la deseada, recargue la configuración sin detener el servicio.

sudo systemctl reload ssh
systemctl is-active ssh

Una vez que el servicio informe que está activo, abra otra nueva conexión con el comando PowerShell solo con clave anterior. Una sesión activa existente no demuestra que los nuevos intentos de autenticación funcionen. El manual sshd documenta las pruebas de configuración; una conexión real exitosa verifica una parte separada de la configuración.

En el registro original del curso se creó y registró una clave Ed25519 en una VM dedicada, verificando nuevas conexiones antes y después del cambio de política. Un archivo separado con una opción inválida fue rechazado por -t y no se aplicó al servicio. Las claves de automatización requieren una política de gestión distinta de las claves protegidas con frase secreta para uso interactivo. Al terminar el ensayo original se retiró la clave pública y se comprobó que un nuevo intento con esa clave era rechazado.

Si la conexión falla, verifique sudo journalctl -u ssh -b --no-pager -n 50 en el servidor. Ante Permission denied (publickey), compruebe la cuenta, la clave, los permisos y la política de autenticación. Ante Connection refused, empiece por el servicio en escucha y el destino del reenvío. Si se agota el tiempo de espera, revise primero la ruta de red y el cortafuegos. La salida detallada de ssh -v del cliente es útil para el diagnóstico, pero revise el nombre de usuario, la ruta y la información del servidor antes de compartirla con otros.

Recuperar acceso y revocar claves innecesarias

Si solo los archivos recién agregados en este ejercicio son la causa, elimínelos desde una sesión normal mantenida o desde la consola de la VM. Verifique con precisión el objetivo de eliminación y no lo aplique a archivos creados por otros 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) '

Si también ha modificado /etc/ssh/sshd_config u otros fragmentos de configuración, restaure los cambios comparándolos con la copia de seguridad y ejecute de nuevo sshd -t antes de recargar. Si la conexión SSH está completamente rota, no intente arreglarla repetidamente a través de la red; inicie sesión a través de la consola de la VM. También debe comprobar antes de comenzar el trabajo si puede usar la autenticación por consola y sudo.

Al revocar una clave de prueba, solo elimine esa línea de clave pública del archivo authorized_keys. No borre las claves existentes que varias personas estén usando juntas. Solo puede restaurar la copia de seguridad original de authorized_keys si no se han añadido otras claves válidas desde la copia de seguridad. Si pierde una clave privada, simplemente cambiar la contraseña no elimina el acceso de esa clave, por lo que también debe revocarse de la lista de claves permitidas del servidor.