Túnel SSH
El tunneleo SSH es un método seguro para acceder a bases de datos que no están directamente disponibles desde tu instancia de Gigantics. En esta página aprenderás qué es un túnel SSH, cuándo conviene utilizarlo y cómo configurarlo correctamente.
¿Qué es un túnel SSH?
SSH (Secure Shell) permite crear un canal cifrado entre dos máquinas. Al habilitar el túnel, Gigantics se conecta primero a un servidor SSH intermedio y a través de él reenvía la comunicación hacia el servidor de base de datos.
Gigantics ⇄ Servidor SSH ⇄ Base de datosDe este modo:
- Los paquetes viajan cifrados de extremo a extremo.
- Se pueden atravesar firewalls o redes privadas donde la base sólo escucha en
localhost. - Se evita exponer el puerto de la base de datos al exterior.
Cuándo usar un túnel SSH
Utilízalo cuando:
- La base no sea accesible directamente (red privada o tras un firewall).
- La base sólo escuche en
127.0.0.1por motivos de seguridad. - Se requiera cifrado para todo el tráfico.
- La base esté en otra red o VPC y exponga únicamente SSH.
Flujo de conexión
- Gigantics establece la sesión SSH con las credenciales indicadas.
- El servidor SSH reenvía el puerto local al remoto de la base.
- Toda operación de la base cruza ese canal seguro.
(El diagrama SVG del original se mantiene sin cambios, pues el lenguaje no afecta al gráfico.)
Parámetros de configuración
El túnel se define en la sección Avanzado del formulario del tap o del sink. Marca ¿Habilitar SSH? para mostrar sus campos:
| Campo UI | Descripción | Requerido | Predeterminado |
|---|---|---|---|
| ¿Habilitar SSH? | Marca para conectar con la base de datos a través de un túnel SSH | No | Desmarcado |
| Host/IP | Nombre o IP del servidor SSH | Sí | – |
| Puerto | Puerto del servidor SSH | Sí | – (normalmente 22) |
| Usuario | Usuario para la autenticación SSH | Sí | – |
| Modo de autentificación | Cómo autenticarse en el servidor SSH: Contraseña o Clave privada | No | Contraseña |
Métodos de autenticación
Los campos que aparecen bajo Modo de autentificación dependen de la opción elegida:
| Modo | Campos UI | Descripción |
|---|---|---|
| Contraseña | Contraseña (requerido) | Autenticación clásica con usuario y contraseña |
| Clave privada | Definir la ruta de la llave + Ruta + Frase de acceso | Autenticación por clave con un fichero de clave en el servidor de Gigantics. Si la ruta está vacía, se usa la clave ~/.ssh/id_rsa del usuario que ejecuta Gigantics |
| Clave privada | Meter la clave + Clave privada (requerido) + Frase de acceso | Autenticación por clave con la clave pegada en el formulario |
La Frase de acceso es opcional: rellénala sólo si la clave privada está cifrada.
Buenas prácticas
- Prefiere clave sobre contraseña cuando puedas.
- Limita los permisos del usuario SSH al mínimo necesario.
- Usa puertos no estándar si tu política lo permite.
- Rota las claves periódicamente y actualízalas en Gigantics.
- Monitoriza los registros SSH para detectar accesos no autorizados.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| Timeout de conexión | SSH inaccesible o puerto erróneo | Verifica conectividad y puerto |
| Fallo de autenticación | Credenciales incorrectas | Revisa usuario, contraseña/clave, passphrase |
| Permission denied | Usuario sin permisos sobre la base | Ajusta privilegios en el servidor |
| Formato de clave inválido | Clave no PEM | Convierte a un formato compatible |
Documentación relacionada
Las páginas de cada controlador que admite túnel SSH enlazan a este documento para la configuración genérica del túnel.