api / audit /SECURITY_AUDIT.md
Mate11
Pirmer commit
5f12c93
|
Raw History Blame Contribute Delete
16.1 kB

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:

# 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:

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