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 |