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