Saltar a contenido

0011. Política CORS: orígenes explícitos y sin credenciales

Estado: Aceptado Fecha: 2026-10-05 Autor: David Garcia Módulo(s) afectado(s): app/core/config.py, app/main.py

Contexto

Los frontends del CRM llaman al servicio desde el navegador. El servicio se autentica sólo con el JWT en Authorization (ADR 0007), nunca con cookies. Starlette compara cada origen texto a texto con la cabecera Origin, así que un origen mal escrito en la configuración nunca coincide y falla en silencio.

Decisión

  • Los orígenes vienen de CORS_ORIGINS; sin orígenes no se registra el middleware y ningún navegador puede llamar al servicio.
  • No se admite *.
  • Cada origen se valida en forma canónica, como la envía el navegador: esquema http/https, host en minúsculas y ASCII (punycode), sin puerto por defecto, sin ruta, barra final, query, fragmento ni credenciales. Uno mal escrito impide arrancar y el error sugiere la forma correcta.
  • allow_credentials=False.
  • Métodos (GET, POST, PUT, PATCH, DELETE) y cabeceras (Authorization, Content-Type) son fijos en el código: son contrato de la API, no del despliegue. Preflight cacheado 600 s.

Alternativas descartadas

  • * — cualquier sitio podría llamar al servicio con el token que tenga el navegador en memoria.
  • Aceptar el origen tal como venga y normalizarlo — oculta el error de configuración en lugar de corregirlo donde se escribe.
  • Métodos y cabeceras configurables — cambiaría el contrato según el entorno.

Consecuencias

  • Un frontend nuevo requiere agregar su origen y reiniciar el servicio.
  • Si algún día se usan cookies, hay que revisar allow_credentials y CSRF.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.