File size: 16,103 Bytes
5f12c93 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 | # Auditoría de Seguridad — Módulo 6 (Health Grid)
> Fecha de análisis: 2026-05-03 | Agente D (Security Auditor)
> ⚠️ Este documento contiene información sensible — acceso restringido al equipo de desarrollo
---
## Tabla de hallazgos (resumen ejecutivo)
| ID | Severidad | Área | Descripción breve |
|----|-----------|------|-------------------|
| F-01 | **CRÍTICO** | Configuración | Credenciales y JWT secret hardcodeados como defaults |
| F-02 | **CRÍTICO** | Secretos | Archivo `.env` con credenciales activas potencialmente versionado |
| F-03 | **CRÍTICO** | CORS | `allow_origins=["*"]` con `allow_credentials=True` (violación W3C) |
| F-04 | **CRÍTICO** | Autenticación | Endpoint de desarrollo que genera tokens JWT expuesto en producción |
| F-05 | **CRÍTICO** | Docker | `--reload` en imagen de producción con volumen montado |
| F-06 | **ALTO** | Autorización | Webhooks sin validación de firma/secret compartido |
| F-07 | **ALTO** | Autorización | Endpoint de crear reserva sin control de roles correcto |
| F-08 | **ALTO** | Secretos | JWT secret activo es valor placeholder predecible |
| F-09 | **ALTO** | Disponibilidad | Sin rate limiting en ningún endpoint |
| F-10 | **ALTO** | Red | Puerto PostgreSQL expuesto al host |
| F-11 | **MEDIO** | Validación | Campo `tipo` de asignación acepta strings arbitrarios |
| F-12 | **MEDIO** | Validación | Campos de texto sin límite de longitud en Pydantic |
| F-13 | **MEDIO** | Validación | Parámetros de query sin validación de enum |
| F-14 | **MEDIO** | Validación | Parámetros de fecha sin validación de formato |
| F-15 | **MEDIO** | Privacidad | Contraindicaciones médicas expuestas en mensajes de error HTTP |
| F-16 | **MEDIO** | Observabilidad | `print()` en lugar de logging estructurado |
| F-17 | **MEDIO** | Autenticación | Mensajes de error JWT diferenciados (oracle de timing) |
| F-18 | **BAJO** | Configuración | Ruta de webhook inconsistente dificulta políticas de red |
| F-19 | **BAJO** | Observabilidad | Errores de integración silenciados (sin log) |
| F-20 | **BAJO** | Supply Chain | Imagen Docker sin digest SHA fijo |
**Total: 5 CRÍTICOS · 5 ALTOS · 7 MEDIOS · 3 BAJOS**
---
## Hallazgos CRÍTICOS
---
### F-01 — CRÍTICO
**Área:** Configuración de secretos
**Archivo:línea:** `backend/config.py:6,9`
**Descripción:**
La clase `Settings` define valores por defecto hardcodeados para `database_url` (con usuario y contraseña en texto plano) y `jwt_secret`. Si el archivo `.env` no está presente o la variable no se define, la aplicación arranca con credenciales conocidas por cualquiera que lea el código fuente.
**Impacto potencial:**
- Acceso completo a la base de datos de producción si `.env` falta
- Capacidad de forjar tokens JWT válidos con cualquier rol (incluyendo ADMINISTRATIVO)
- Credenciales filtradas en repositorios públicos, CI/CD logs, Docker images
**Recomendación:**
```python
# Cambiar de:
database_url: str = "postgresql://admin:secret@..."
jwt_secret: str = "supersecretkey_change_in_production"
# A (campos requeridos sin default):
database_url: str
jwt_secret: str
```
Con `pydantic-settings`, un campo sin default lanzará `ValidationError` al startup si la variable no está definida en el entorno — comportamiento correcto y seguro.
---
### F-02 — CRÍTICO
**Área:** Gestión de secretos
**Archivo:** `.env`
**Descripción:**
El archivo `.env` contiene credenciales activas de PostgreSQL y el JWT secret. No se detectó `.gitignore` en el proyecto. Si este archivo fue incluido en algún commit de git, los secretos están permanentemente en el historial.
**Impacto potencial:**
- Credenciales de base de datos y JWT secret comprometidos permanentemente si el repo es accesible
- En entornos universitarios/compartidos, riesgo inmediato de acceso no autorizado
**Recomendación:**
1. Verificar historial: `git log --all --full-history -- .env`
2. Si fue comprometido: rotar TODAS las credenciales inmediatamente
3. Crear `.gitignore` con `.env` incluido
4. Crear `.env.example` con valores de placeholder documentados
5. **Nota:** No se imprimen los valores del `.env` en este reporte — solo se documenta su existencia.
---
### F-03 — CRÍTICO
**Área:** CORS
**Archivo:línea:** `backend/main.py:43-49`
**Descripción:**
```python
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
allow_credentials=True, # ← combinación inválida
...
)
```
La combinación de `allow_origins=["*"]` con `allow_credentials=True` viola la especificación W3C CORS. Los navegadores modernos rechazan esta combinación, pero más importante: en configuraciones menos estrictas permite ataques CSRF cross-origin donde cualquier sitio web puede realizar requests autenticados en nombre del usuario.
**Impacto potencial:**
- CSRF attacks sobre todos los endpoints de la API
- Exfiltración de datos médicos desde sitios maliciosos
**Recomendación:**
```python
allow_origins=["http://localhost:3000", "https://hospital.example.com"]
```
Si el origen varía por entorno, moverlo a `settings.allowed_origins: list[str]`.
---
### F-04 — CRÍTICO
**Área:** Autenticación
**Archivo:línea:** `backend/main.py:62-77`
**Descripción:**
```python
@app.get("/api/v1/auth/token")
async def generate_token(usuario: str, contraseña: str = "any"):
# Genera token JWT con cualquier contraseña, sin validación
return {"access_token": create_access_token(...)}
```
Endpoint de desarrollo expuesto públicamente. Acepta cualquier contraseña y genera tokens JWT con el rol solicitado (incluyendo `ADMINISTRATIVO`). No hay guard de entorno para deshabilitarlo en producción.
**Impacto potencial:**
- Cualquier persona con acceso a la URL obtiene control total del sistema
- Creación de camas, aprobación de solicitudes, acceso a todos los datos de pacientes
**Recomendación:**
Agregar guard de entorno:
```python
@app.get("/api/v1/auth/token")
async def generate_token(...):
if settings.environment != "development":
raise HTTPException(status_code=404, detail="Not Found")
...
```
O eliminar el endpoint y usar herramientas como `httpie` / Swagger UI con credenciales reales para testing.
---
### F-05 — CRÍTICO
**Área:** Docker / Infraestructura
**Archivo:línea:** `backend/Dockerfile:12`
**Descripción:**
```dockerfile
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]
```
La flag `--reload` activa el file watcher de uvicorn. Combinado con el bind mount `./backend:/app` en `docker-compose.yml`, el contenedor "de producción" recarga el código automáticamente ante cualquier cambio en el host. Elimina la inmutabilidad de los contenedores.
**Impacto potencial:**
- Modificación accidental del código en producción
- Overhead de recursos del file watcher
- Reinicios inesperados que interrumpen conexiones activas
**Recomendación:**
Remover `--reload` del Dockerfile. Usar `--reload` solo en el override de development en `docker-compose.override.yml`.
---
## Hallazgos ALTOS
---
### F-06 — ALTO
**Área:** Autenticación de webhooks
**Archivo:línea:** `backend/routers/webhooks.py:31-163`
**Descripción:**
Todos los webhooks de M1, M2 y M9 usan únicamente `Depends(get_current_user)` como autenticación. No hay:
- Validación de firma HMAC (secret compartido entre módulos)
- Whitelist de IPs de origen
- Header de autenticación específico entre servicios (service-to-service auth)
**Impacto potencial:**
Cualquier usuario con un token JWT válido (obtenible trivialmente via F-04) puede:
- Inyectar altas médicas fraudulentas (liberar camas que no corresponde)
- Crear reservas de quirófano de emergencia no autorizadas
- Cancelar cirugías programadas
- Generar alertas de emergencia falsas
**Recomendación:**
Implementar validación de firma HMAC-SHA256 con secret compartido:
```python
def verify_webhook_signature(request: Request, x_signature: str = Header(...)):
body = await request.body()
expected = hmac.new(settings.webhook_secret.encode(), body, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected, x_signature):
raise HTTPException(403, "Firma de webhook inválida")
```
---
### F-07 — ALTO
**Área:** Autorización de endpoints
**Archivo:línea:** `backend/routers/camas.py:162-173`
**Descripción:**
```python
@router.post("/{cama_id}/reservas")
async def crear_reserva(
current_user: dict = Depends(get_current_user), # ← sin control de rol
...
):
```
El endpoint de creación de reservas de quirófano usa `get_current_user` en lugar de `require_roles("MEDICO", "ADMINISTRATIVO")`. El rol `LIMPIEZA` puede crear reservas quirúrgicas.
**Impacto potencial:**
Usuarios de limpieza pueden reservar quirófanos, potencialmente bloqueando cirugías programadas.
**Recomendación:**
```python
current_user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO"))
```
---
### F-08 — ALTO
**Área:** Calidad del JWT secret
**Archivo:línea:** `backend/config.py:9` y `.env:7`
**Descripción:**
El JWT secret activo es el valor placeholder `supersecretkey_change_in_production`. Tiene baja entropía y es predecible — cualquier atacante que lo intente (o lo lea del código) puede firmar tokens arbitrarios.
**Recomendación:**
Generar un secret de alta entropía: `python -c "import secrets; print(secrets.token_hex(32))"`
Y nunca incluir el secret real en el código fuente (ver F-01).
---
### F-09 — ALTO
**Área:** Rate limiting
**Cobertura:** Toda la aplicación
**Descripción:**
No existe rate limiting en ningún endpoint. El endpoint de generación de tokens (F-04) y los webhooks aceptan volúmenes ilimitados de requests.
**Impacto potencial:**
- Ataques de fuerza bruta sobre endpoints de autenticación
- DoS mediante flooding de webhooks
- Saturación de la base de datos
**Recomendación:**
Implementar `slowapi` (integración nativa con FastAPI):
```python
from slowapi import Limiter
limiter = Limiter(key_func=get_remote_address)
@app.get("/api/v1/auth/token")
@limiter.limit("5/minute")
async def generate_token(...):
```
---
### F-10 — ALTO
**Área:** Exposición de red
**Archivo:línea:** `docker-compose.yml:14`
**Descripción:**
```yaml
db:
ports:
- "5432:5432" # PostgreSQL expuesto al host
```
Con las credenciales débiles documentadas en `.env`, la base de datos es directamente accesible desde la red del host (y potencialmente desde la red local).
**Recomendación:**
Eliminar la sección `ports` del servicio `db`. Los servicios en la misma red Docker se comunican por nombre de servicio sin necesidad de exponer puertos al host. Solo exponer si se necesita acceso desde herramientas externas de administración, y en ese caso, bindear a `127.0.0.1:5432:5432`.
---
## Hallazgos MEDIOS
---
### F-11 — MEDIO
**Área:** Validación de entrada
**Archivo:línea:** `backend/schemas/cama.py:48`
**Descripción:** Campo `tipo` en `AsignacionCamaRequest` definido como `str` libre. Valores inesperados se tratan silenciosamente como `INGRESO`.
**Recomendación:** Cambiar a `Literal["INGRESO", "TRASLADO"]` o usar el enum correspondiente.
---
### F-12 — MEDIO
**Área:** Validación de entrada
**Archivo:línea:** `backend/schemas/cama.py:9-14`, `backend/schemas/solicitud.py:64-83`
**Descripción:** Campos de texto (`numero`, `hospital_id`, `diagnostico_ingreso`, `observaciones`) sin límite de longitud en Pydantic. El modelo de BD tiene `String(20)`/`String(50)` pero Pydantic no lo valida. Posible truncamiento silencioso o error de BD.
**Recomendación:** Usar `Field(..., max_length=N)` para todos los campos de texto con restricciones en BD.
---
### F-13 — MEDIO
**Área:** Validación de parámetros
**Archivo:línea:** `backend/routers/solicitudes.py:14-26`
**Descripción:** Parámetros `estado` y `tipo` en `GET /solicitudes` aceptan strings libres sin validación.
**Recomendación:** Usar `EstadoSolicitudEnum` y `TipoSolicitudEnum` como tipo del Query param.
---
### F-14 — MEDIO
**Área:** Validación de parámetros
**Archivo:línea:** `backend/routers/camas.py:148-158`
**Descripción:** Parámetros `fecha_desde` y `fecha_hasta` sin validación de formato. Fechas inválidas generan errores 500 no controlados en lugar de 422.
**Recomendación:** Usar `datetime` como tipo del Query param para validación automática de FastAPI.
---
### F-15 — MEDIO
**Área:** Privacidad de datos clínicos
**Archivo:línea:** `backend/services/solicitud_service.py:143-145`, `backend/services/cama_service.py:168-188`
**Descripción:** Contraindicaciones médicas del paciente (ej. `"ALERGIA_LATEX"`, `"INMUNOSUPRIMIDO"`) se incluyen en el campo `detalle` de respuestas HTTP 422. Datos clínicos sensibles expuestos en respuestas de API.
**Recomendación:** Usar mensajes genéricos en las responses HTTP. Loggear el detalle clínico internamente.
---
### F-16 — MEDIO
**Área:** Logging y observabilidad
**Archivo:línea:** `backend/main.py:27`
**Descripción:** Uso de `print()` en lugar de un logger configurado. Sin control de nivel de log ni formateo estructurado.
**Recomendación:** Configurar `logging.getLogger(__name__)` y usar `logger.info/warning/error` con formato JSON para sistemas de agregación de logs.
---
### F-17 — MEDIO
**Área:** Autenticación
**Archivo:línea:** `backend/auth/jwt_handler.py:34-35`
**Descripción:** El mensaje de error `f"Token inválido: {e}"` propaga la excepción original, exponiendo diferencias entre tokens caducados y tokens forjados. Facilita ataques de timing/oracle.
**Recomendación:** Usar mensaje genérico: `raise HTTPException(401, detail="Credenciales inválidas")` sin incluir el error original.
---
## Hallazgos BAJOS
---
### F-18 — BAJO
**Área:** Consistencia de rutas
**Archivo:línea:** `backend/routers/webhooks.py:106`
**Descripción:** Ruta `/turnos/{turno_id}/cancelacion-quirofano` sin prefijo `/webhooks/`, inconsistente con las demás rutas de webhook.
**Recomendación:** Verificar si el router tiene prefijo `/api/v1/webhooks`. Si no, asegurar consistencia en todas las rutas de webhook.
---
### F-19 — BAJO
**Área:** Observabilidad
**Archivo:línea:** `backend/services/external_client.py:24,33`
**Descripción:** Errores de llamadas a servicios externos silenciados con `except Exception: return None` sin ningún log.
**Recomendación:** Agregar logging de warnings antes de retornar `None`.
---
### F-20 — BAJO
**Área:** Supply chain
**Archivo:línea:** `backend/Dockerfile:1`
**Descripción:** `FROM python:3.12-slim` sin digest SHA256 fijado. Builds no completamente reproducibles.
**Recomendación:** Usar `python:3.12-slim@sha256:<digest>` para builds reproducibles y protección contra supply chain attacks.
---
## Controles correctos identificados
Los siguientes aspectos de seguridad están implementados correctamente:
| Control | Estado | Detalle |
|---------|--------|---------|
| Inyección SQL | ✅ Correcto | SQLAlchemy ORM con queries parametrizadas en todos los accesos |
| Stack traces en HTTP | ✅ Correcto | Handlers globales devuelven JSON controlado, sin tracebacks |
| Confusión de algoritmo JWT | ✅ Correcto | `decode_token` fija `algorithms=[settings.jwt_algorithm]`, previene `alg=none` |
| JWT con expiración | ✅ Correcto | Campo `exp` incluido en todos los tokens (60 minutos por defecto) |
| Roles en endpoints | ✅ Mayoritariamente | `require_roles()` usado correctamente excepto F-07 |
| Separación de credenciales | ✅ Correcto | Credenciales en `.env`, no en código (excepto defaults de F-01) |
---
## Plan de remediación priorizado
| Prioridad | Hallazgos | Esfuerzo estimado |
|-----------|-----------|-------------------|
| **Inmediato** (antes de cualquier deploy) | F-01, F-02, F-03, F-04, F-08 | 2-4 horas |
| **Esta semana** | F-05, F-06, F-07, F-09, F-10 | 4-8 horas |
| **Próximas 2 semanas** | F-11 a F-17 | 4-6 horas |
| **Backlog** | F-18, F-19, F-20 | 1-2 horas |
|