|
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
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:** | |
| ```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 | | |