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_credentialsy 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.