CORS cabecera rechazada — Allow-Headers

Por qué 'Request header field x-auth-token is not allowed' salta y cómo configurar Allow-Headers en el servidor.

Escenarios

Petición — lado del navegador (página)

Method

Content-Type

Cabecera personalizada

Access-Control-Request-Headers: content-type, x-auth-token

Respuesta — cabeceras que envía el servidor

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

Cabeceras que la petición necesita + comunes — clic para alternar

Pasos del navegador

→

La página lanza un fetch

•

No es petición simple — se requiere preflight OPTIONS

→

Preflight OPTIONS enviado

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, x-auth-token
←

Llega la respuesta preflight del servidor

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST, PUT
Access-Control-Allow-Headers: content-type
✓

Allow-Origin coincide con el origen — pasa

✓

El método está en Allow-Methods — pasa

✗

Una cabecera falta en Allow-Headersx-auth-token

—

Sin credenciales — comprobación omitida

✗

El navegador bloquea la respuesta y rechaza el fetch

Consola del navegador

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Request header field content-type is not allowed by Access-Control-Allow-Headers in preflight response.

(index):1

Cambia cualquier valor y los pasos se recalculan al instante. Prueba «credentials + *» para ver por qué el comodín falla.

Cabeceras como Authorization o X-Api-Key — e incluso un Content-Type JSON — viajan en el ACRH del preflight. Si Allow-Headers no las cubre todas, bloquea con 'header field X is not allowed'.

La trampa no son las mayúsculas (las cabeceras no distinguen caso) sino la omisión: olvidar que content-type también debe estar permitido. Solo con authorization sigue fallando. Simulador CORS

Preguntas frecuentes

¿Authorization también va en Allow-Headers?
Sí — no está en el safelist. Las APIs JWT suelen necesitar content-type y authorization.
¿Vale * en Allow-Headers?
Sin credenciales, en general sí; con credenciales mejor lista explícita.

Otros escenarios