Saltar al contenido principal

Usuarios SSH

Crea y administra usuarios con acceso SSH a tu servidor. Ideal para dar acceso a desarrolladores o colaboradores sin compartir la cuenta principal.

Abrir el Panel de Usuarios​

  1. Ve a tu Dashboard y selecciona un deployment
  2. En la sección "Herramientas Avanzadas", haz clic en "Usuarios SSH"
  3. Se abrirá el panel de administración de usuarios
Botón de Ayuda

En la esquina superior del modal verás un botón de ayuda (?) que te trae directamente a esta documentación.

Crear un Usuario​

  1. Haz clic en "Crear Usuario"
  2. Ingresa el nombre de usuario (solo letras, números, guiones y guiones bajos)
  3. Selecciona el método de autenticación:
    • Contraseña: Usuario tradicional con contraseña
    • SSH Key: Más seguro, genera un par de claves RSA 4096
  4. Haz clic en "Crear"

Con Contraseña​

  1. Ingresa una contraseña segura (mínimo 8 caracteres)
  2. Copia la contraseña y envíala de forma segura al usuario

Con SSH Key (Recomendado)​

  1. El sistema genera automáticamente un par de claves RSA 4096
  2. IMPORTANTE: Copia o descarga la clave privada - solo se muestra una vez
  3. El usuario debe guardar la clave en ~/.ssh/nombre_key
Guarda la Clave Privada

La clave privada solo se muestra una vez al crear el usuario. Si la pierdes, tendrás que regenerarla.

Datos de Conexión​

Después de crear el usuario, comparte estos datos:

Con Contraseña:

Host: tu-app.deployalo.com
Puerto: 22
Usuario: nombre_usuario
Contraseña: (la que copiaste)

Con SSH Key:

Host: tu-app.deployalo.com
Puerto: 22
Usuario: nombre_usuario
Clave privada: (archivo descargado)

Conectarse por SSH​

El usuario puede conectarse usando cualquier cliente SSH:

Con Contraseña​

# Mac/Linux/Windows PowerShell
ssh usuario@tu-app.deployalo.com
# Te pedirá la contraseña

Con SSH Key​

# Primero, guardar la clave con permisos correctos
chmod 600 ~/.ssh/mi_clave

# Conectarse usando la clave
ssh -i ~/.ssh/mi_clave usuario@tu-app.deployalo.com
Configurar SSH Config

Puedes simplificar la conexión agregando esto a ~/.ssh/config:

Host mi-servidor
    HostName tu-app.deployalo.com
    User usuario
    IdentityFile ~/.ssh/mi_clave

Después solo escribes: ssh mi-servidor

Desde un Cliente SSH​

Clientes recomendados:

Permisos de Usuario​

Los usuarios SSH creados tienen:

PermisoDescripción
Acceso al home/home/usuario/
Lectura de /appVer archivos de la aplicación
Docker (lectura)Ver logs y estado de contenedores
Limitaciones

Los usuarios creados NO pueden:

  • Modificar archivos de la aplicación
  • Ejecutar comandos de Docker que modifiquen contenedores
  • Acceder a archivos de otros usuarios
  • Usar sudo

Administrar Usuarios​

Ver Usuarios Existentes​

En el panel verás una lista de todos los usuarios con:

  • Nombre de usuario
  • Método de autenticación: 🔐 SSH Key o 🔑 Contraseña
  • Fecha de creación
  • Estado: Activo o Bloqueado
  • Comando SSH: Para copiar rápidamente

Bloquear Usuario​

Si necesitas revocar el acceso temporalmente:

  1. Encuentra el usuario en la lista
  2. Haz clic en el icono de candado
  3. El usuario no podrá conectarse hasta que lo desbloquees

Desbloquear Usuario​

  1. Encuentra el usuario bloqueado
  2. Haz clic en el icono de candado abierto
  3. El acceso se restaurará inmediatamente

Eliminar Usuario​

Para revocar el acceso permanentemente:

  1. Encuentra el usuario en la lista
  2. Haz clic en el icono de basura
  3. Confirma la eliminación
Acción Irreversible

Eliminar un usuario borra todos sus archivos en /home/usuario/. Esta acción no se puede deshacer.

Gestionar Credenciales​

Cambiar Contraseña (usuarios con contraseña)​

  1. Encuentra el usuario en la lista
  2. Haz clic en "Cambiar"
  3. Ingresa la nueva contraseña (mínimo 8 caracteres)
  4. Envía la nueva contraseña al usuario

Regenerar SSH Key (usuarios con SSH Key)​

Si un usuario pierde su clave privada:

  1. Encuentra el usuario en la lista
  2. Haz clic en "Nueva Key"
  3. Confirma la acción (la clave anterior dejará de funcionar)
  4. Copia o descarga la nueva clave privada
  5. Envíala de forma segura al usuario
Clave Anterior Inválida

Al regenerar una SSH Key, la clave anterior deja de funcionar inmediatamente. El usuario no podrá conectarse hasta que tenga la nueva clave.

Casos de Uso​

Dar acceso a un desarrollador​

  1. Crea un usuario con su nombre (ej: juan)
  2. Comparte los datos de conexión
  3. El desarrollador puede ver logs y depurar

Acceso temporal para soporte​

  1. Crea un usuario temporal (ej: soporte)
  2. Comparte los datos
  3. Cuando termine, elimina el usuario

Múltiples ambientes​

Si tienes varios deployments, puedes crear usuarios con el mismo nombre en cada uno para mantener consistencia.

Seguridad​

Mejores Prácticas​

  1. Usa nombres descriptivos: dev-juan, soporte-empresa
  2. Elimina usuarios inactivos: Revisa periódicamente
  3. No compartas contraseñas: Cada persona debe tener su propio usuario
  4. Bloquea antes de eliminar: Si no estás seguro, bloquea primero

Auditoría​

Todos los accesos SSH quedan registrados en /var/log/auth.log. Puedes verlos desde la terminal:

grep "usuario" /var/log/auth.log | tail -20

Solución de Problemas​

"Permission denied"​

  • Verifica que el usuario no esté bloqueado
  • Confirma que la contraseña sea correcta
  • Intenta resetear la contraseña

"Connection refused"​

  • El servidor puede estar reiniciando
  • Verifica que el deployment esté en estado "Running"
  • Espera unos minutos y reintenta

Usuario no aparece en la lista​

  • Recarga la página
  • El usuario puede haber sido eliminado
  • Crea uno nuevo si es necesario