# relay-sshd — sshd del relay en contenedor

Alternativa al sshd del host (`relay/sshd/50-alumnos.conf`): mismo patrón que el contenedor `bastion`
(Alpine + openssh-server, solo certificados de la CA de Vault), pero con reenvío **remoto** a sockets
Unix y cuentas que se crean y borran **en caliente**. Las cuentas viven dentro del contenedor, no en
el `/etc/passwd` del servidor.

```
nginx-alumnos ──► volumen «relay-sockets» ◄── relay-sshd (:2223)
                  /var/lib/alumnos/<id>/web.sock    cuentas al_<id>, certificados de Vault
```

## Ficheros
| Fichero | Para qué |
|---|---|
| `Dockerfile`, `sshd_config` | Imagen y política de sshd |
| `entrypoint.sh` | Clave de host persistente, alta inicial y bucle de sincronización |
| `relay-sync.sh` | Crea/borra cuentas `al_<id>` y sus directorios según `alumnos.txt` |
| `docker-compose.yml` | Servicio, capacidades, volúmenes |
| `nginx-sockets.override.yml` | Hace que `nginx-alumnos` lea los sockets del volumen compartido |
| `conf/alumnos.txt.example` | Formato de la lista (un id por línea) |
| `test-local.sh` | Prueba completa en local (37 comprobaciones) |

## Probar en local
```bash
bash relay/relay-sshd/test-local.sh      # necesita Docker y OpenSSH; no toca ningún servidor
```
Una CA de prueba hace de Vault y firma certificados con principal `al_<id>`.

## Verificado en local (0 fallos de 37)
- Solo entra quien tiene un certificado de la CA, con principal = nombre de la cuenta: se rechazan
  clave sin certificado, CA ajena, certificado caducado, principal de otro alumno y alumno sin cuenta.
- Sin shell ni comandos; un `authorized_keys` propio del alumno no abre nada (`AuthorizedKeysFile none`).
- `ana` no puede crear sockets en el directorio de `luis`, ni abrir puertos TCP (127.0.0.1 ni 0.0.0.0).
- Extremo a extremo `x.ana.alumnos…` y `a.b.c.ana.alumnos…` → nginx → socket → `ssh -R` → servidor del alumno.
- Altas y bajas en caliente sin cortar los túneles de los demás; una lista vacía no borra a nadie.
- 1000 cuentas: alta en ≈ 20 s, baja en ≈ 6 s, ≈ 5 MiB de memoria del contenedor (con un túnel).
- La clave de host se conserva al reiniciar el contenedor.

## Hallazgos (importan también fuera de este contenedor)
1. **Falta `CAP_FSETID`.** Con `cap_drop: ALL` (como el bastión) el kernel borra en silencio el bit
   `setgid` de los directorios de los alumnos, los sockets nacen con el grupo del alumno y nginx no puede
   conectar. Ya está en `cap_add`.
2. **`PerSourcePenalties` (sshd ≥ 9.8) bloquea toda la IP de origen tras unos fallos de autenticación.**
   Con alumnos tras la NAT de un centro, unos certificados caducados cortarían a toda la clase.
   Aquí está desactivado (`PerSourcePenalties no`). **El `bastion` actual lo tiene activo por defecto**
   (`authfail:5 min:15 max:600`): mismo riesgo.
3. `AllowTcpForwarding no` desactiva también los sockets Unix; se usa `remote` + `PermitListen 127.0.0.1:1`.
4. El puerto 18443 de este Mac lo usa el Traefik del borde: en pruebas locales usa otro para el servidor TLS.

## Desplegado (alumnos-vm, 2026-11-07)
Desplegado en `/opt/platform/relay-sshd`, puerto 2223, con la CA de Vault del bastión, y **en servicio**: nginx
lee el volumen `relay-sockets` y el túnel de `jviejo` entra con un certificado de Vault (`relay/alumno/relay-login.sh`).
Validado también en el servidor real con una CA de prueba (túnel -> nginx temporal en loopback -> servidor local).

## NO verificado / pendiente
- Falta el job que genera `alumnos.txt` desde el grupo de Keycloak (hoy la lista es manual: solo `jviejo`).
- Hoy el relay usa el MISMO rol/CA de Vault que el bastión (`ssh/sign/alumno`); valorar un rol propio.
- El certificado dura 8 h: para túneles permanentes usar `relay-login.sh --tunel` (renueva y reconecta).
- El 2223 está abierto en GCP y se alcanza desde tu red; no se ha comprobado desde redes de alumnos con salida restringida.
- La extrapolación a 1000 túnels simultáneos (≈ 8,5 GB) sigue siendo una estimación, no una prueba de carga.

## Despliegue (cuando se decida)
```bash
docker volume create relay-sockets
cp /opt/platform/bastion/ca.pub relay/relay-sshd/conf/ca.pub     # o la CA de un rol propio del relay
cp relay/relay-sshd/conf/alumnos.txt.example relay/relay-sshd/conf/alumnos.txt
docker compose -f relay/relay-sshd/docker-compose.yml up -d --build
docker compose -f relay/docker-compose.yml -f relay/relay-sshd/nginx-sockets.override.yml up -d
```
Después, quitar el drop-in de sshd del host y migrar los túneles de los alumnos al puerto nuevo.
