api / audit /DEPENDENCY_AUDIT.md
Mate11
Pirmer commit
5f12c93
|
Raw History Blame Contribute Delete
7.72 kB
# Auditoría de Dependencias — Módulo 6
> Generado: 2026-05-03 | Auditor: Agent B (Dependency Auditor)
---
## Resumen de dependencias declaradas
`backend/requirements.txt` declara **9 dependencias**, todas con versión fijada con `==`. No existe lockfile (ni `poetry.lock`, ni `requirements-lock.txt` de pip-tools, ni `Pipfile.lock`).
| # | Paquete | Versión | Tipo |
|---|---------|---------|------|
| 1 | `fastapi` | `0.115.0` | Producción |
| 2 | `uvicorn[standard]` | `0.31.0` | Producción |
| 3 | `sqlalchemy` | `2.0.35` | Producción |
| 4 | `psycopg2-binary` | `2.9.10` | Producción |
| 5 | `pydantic` | `2.9.2` | Producción |
| 6 | `pydantic-settings` | `2.5.2` | Producción |
| 7 | `python-jose[cryptography]` | `3.3.0` | Producción |
| 8 | `httpx` | `0.27.2` | Producción |
| 9 | `python-multipart` | `0.0.12` | Producción |
---
## Dependencias utilizadas vs. declaradas
| Paquete | Usado en fuente | Archivos | Notas |
|---------|----------------|----------|-------|
| `fastapi` | ✅ Sí | `main.py`, todos los routers, auth, services | Core framework |
| `uvicorn[standard]` | ✅ Sí (runtime) | `Dockerfile CMD` | No se importa en Python; esencial como servidor ASGI |
| `sqlalchemy` | ✅ Sí | `database.py`, `models/*.py`, `services/*.py` | ORM v2 |
| `psycopg2-binary` | ✅ Sí (runtime) | Driver de la URL `postgresql://` en `database.py` | SQLAlchemy lo carga en runtime |
| `pydantic` | ✅ Sí | `schemas/*.py` — `BaseModel`, `ConfigDict`, `field_validator` | Validación |
| `pydantic-settings` | ✅ Sí | `config.py` — `from pydantic_settings import BaseSettings` | Uso correcto con v2 |
| `python-jose[cryptography]` | ✅ Sí | `auth/jwt_handler.py` — `from jose import JWTError, jwt` | JWT |
| `httpx` | ✅ Sí | `services/external_client.py` — `import httpx` | HTTP a módulos externos |
| `python-multipart` | ⚠️ No explícito | Ningún router usa `Form`, `File` ni `UploadFile` | Potencialmente innecesario |
---
## Problemas encontrados
### CRÍTICO
**C-01: Secret JWT hardcodeado como valor por defecto**
- `config.py` línea 9: `jwt_secret: str = "supersecretkey_change_in_production"` — fallback hardcodeado en código fuente.
- `.env` línea 6: el mismo valor sin cambiar en el entorno real.
- Cualquier persona que lea el código puede firmar tokens JWT válidos.
- **Acción:** Eliminar el default, usar `jwt_secret: str` (campo obligatorio sin fallback). Generar con `openssl rand -hex 32`.
### ALTO
**A-01: Sin lockfile — builds no reproducibles**
- No existe `poetry.lock`, `requirements-lock.txt` ni `Pipfile.lock`.
- Las subdependencias no están fijadas; dos `pip install` en distintos momentos pueden instalar versiones diferentes.
- **Acción:** Adoptar pip-tools (`pip-compile`) o Poetry.
**A-02: Imagen Docker sin digest SHA256**
- `FROM python:3.12-slim` sin hash fijado.
- **Acción:** Usar `python:3.12-slim@sha256:<hash>` o versión patch completa.
**A-03: `python-jose` sin mantenimiento activo (última versión: 2022)**
- CVEs conocidos sin parche. El proyecto está virtualmente abandonado.
- **Acción:** Migrar a `authlib` (mantenido activamente, sin CVEs activos conocidos).
**A-04: `psycopg2-binary` desaconsejado en producción**
- Los propios maintainers advierten contra su uso en producción (conflictos con libs del sistema).
- **Acción:** Usar `psycopg2` compilado (añadir `libpq-dev gcc` al Dockerfile) o migrar a `psycopg` v3.
### MEDIO
**M-01: `python-multipart` declarada pero no utilizada**
- No hay `Form`, `File` ni `UploadFile` en ningún router. Dependencia prescindible actualmente.
**M-02: `version: "3.9"` obsoleto en docker-compose.yml**
- Campo deprecado en Docker Compose v2. Genera warnings.
- **Acción:** Eliminar la línea `version:`.
**M-03: `--reload` en CMD del Dockerfile de producción**
- `CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]`
- Flag de desarrollo en imagen de producción — file watchers, reinicios inesperados.
- **Acción:** Remover `--reload` del Dockerfile. Usarlo solo en `docker-compose.yml` para dev.
**M-04: Sin separación de dependencias dev/prod**
- No existe `requirements-dev.txt`. Sin estructura para aislar herramientas de testing/linting.
**M-05: Versiones potencialmente desactualizadas (a mayo 2026)**
- Las versiones datan de mediados/finales 2024. `fastapi`, `uvicorn`, `sqlalchemy`, `pydantic`, `httpx` probablemente tienen versiones más recientes con correcciones de seguridad.
### BAJO
**B-01: `.env` con credenciales sin `.gitignore` verificado**
- No se encontró `.gitignore`. Riesgo de commit accidental de credenciales.
**B-02: Sin `.dockerignore`**
- El contexto de build incluye `__pycache__`, `.pyc`, etc. Aumenta tiempo de build.
**B-03: Sin `pyproject.toml`**
- Sin metadatos de proyecto estándar para integración con herramientas modernas.
---
## Dependencias faltantes recomendadas
| Paquete | Justificación | Prioridad |
|---------|--------------|-----------|
| `alembic` | El proyecto usa `Base.metadata.create_all()` en startup — funciona en dev pero no en producción. Alembic permite migraciones versionadas y reversibles. | ALTA |
| `authlib` | Reemplazo directo de `python-jose` (abandonado). RFC 7519 completo, mantenimiento activo. | ALTA |
| `gunicorn` | Process manager para múltiples workers Uvicorn en producción (`-k uvicorn.workers.UvicornWorker`). | MEDIA |
| `pytest` + `pytest-asyncio` | No hay tests visibles. `httpx` ya declarado puede usarse con `AsyncClient`. | MEDIA |
| `ruff` | Linter/formatter moderno (dev). | BAJA |
| `mypy` | Type checker — el código usa type hints extensivamente. | BAJA |
> `python-dotenv` NO es necesario: `pydantic-settings` ya gestiona la carga del `.env` nativamente (configurado correctamente en `config.py` con `env_file = ".env"`).
---
## Análisis del entorno Docker
### Dockerfile
| Aspecto | Estado | Nota |
|---------|--------|------|
| Imagen base `python:3.12-slim` | ✅ Correcto | Versión Python correcta, variante slim apropiada |
| `--no-cache-dir` en pip install | ✅ Correcto | Reduce tamaño de imagen |
| Orden de layers | ✅ Correcto | `COPY requirements.txt` → `pip install` → `COPY . .` |
| Digest SHA256 fijado | ⚠️ Faltante | Sin hash fijado en imagen base |
| `--reload` en CMD | ⚠️ Problema | Solo para desarrollo, no producción |
| `.dockerignore` | ⚠️ Faltante | Contexto de build innecesariamente grande |
| Usuario no-root | ⚠️ Faltante | Corre como root |
### docker-compose.yml
| Aspecto | Estado | Nota |
|---------|--------|------|
| `postgres:16-alpine` | ✅ Correcto | Versión reciente y slim |
| `healthcheck` con `pg_isready` | ✅ Correcto | Con `condition: service_healthy` |
| Volumen nombrado | ✅ Correcto | Para persistencia de datos PostgreSQL |
| `restart: unless-stopped` | ✅ Correcto | Para el backend |
| Variables via `env_file: .env` | ✅ Correcto | |
| `version: "3.9"` | ⚠️ Obsoleto | Campo deprecado en Docker Compose v2 |
| Puerto `5432` expuesto al host | ⚠️ Riesgo | En producción no debería exponerse |
| Bind mount `./backend:/app` | ⚠️ Solo dev | No apropiado para producción |
---
## Acciones urgentes (por prioridad)
1. **[CRÍTICO]** Rotar el JWT secret — eliminar fallback hardcodeado y generar valor seguro
2. **[ALTO]** Reemplazar `python-jose` por `authlib`
3. **[ALTO]** Reemplazar `psycopg2-binary` por `psycopg2` compilado o `psycopg` v3
4. **[ALTO]** Generar un lockfile (pip-tools o Poetry)
5. **[MEDIO]** Remover `--reload` del Dockerfile
6. **[MEDIO]** Incorporar `alembic` para migraciones
7. **[MEDIO]** Crear `requirements-dev.txt` separado
8. **[BAJO]** Agregar `.gitignore` y `.dockerignore`