Download audit/SECURITY_AUDIT.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 16.1 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/SECURITY_AUDIT.md
- Command line
-
hf download hf://spaces/Modulo-6/api/audit/SECURITY_AUDIT.md
-
curl -L -o SECURITY_AUDIT.md https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/SECURITY_AUDIT.md
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
.envfalta - 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:
# 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:
- Verificar historial:
git log --all --full-history -- .env - Si fue comprometido: rotar TODAS las credenciales inmediatamente
- Crear
.gitignorecon.envincluido - Crear
.env.examplecon valores de placeholder documentados - Nota: No se imprimen los valores del
.enven este reporte — solo se documenta su existencia.
F-03 — CRÍTICO
Área: CORS
Archivo:línea: backend/main.py:43-49
Descripción:
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:
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:
@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:
@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:
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:
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:
@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:
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):
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:
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 |