Wesloo
Todos los temasTemas

Tecnologías web

que son los cors y por qué importan

Respuesta breve

CORS es un mecanismo de cabeceras HTTP que permite a un servidor indicar qué orígenes externos pueden leer recursos en el navegador. Su objetivo es ampliar la política del mismo origen sin renunciar a la seguridad.

Puntos clave

  • CORS no es un bloqueo del servidor; es una regla que el navegador aplica al leer respuestas.
  • El servidor decide qué orígenes, métodos y cabeceras acepta.
  • Las peticiones con métodos no simples o cabeceras personalizadas suelen disparar un preflight OPTIONS.
  • Los errores CORS no exponen detalles a JavaScript por seguridad.
  • Reflejar el Origin con credenciales activadas puede filtrar datos sensibles.

que son los cors: un sistema de cabeceras HTTP con el que un servidor declara qué orígenes ajenos pueden obtener recursos en el navegador. El navegador aplica esa decisión cuando un script intenta leer una respuesta de otro dominio, protocolo o puerto.

La pregunta importa porque la web moderna depende de APIs, fuentes, imágenes y servicios distribuidos. Sin una regla clara, cualquier página podría leer datos privados de otra sesión. CORS no bloquea todas las peticiones cruzadas; define cuáles respuestas puede leer el código del cliente.

que son los cors en una petición real

Imagina una aplicación servida desde app.ejemplo.com que llama a api.ejemplo.com. El navegador envía la petición con una cabecera Origin. Si la respuesta incluye Access-Control-Allow-Origin con un valor compatible, el navegador entrega los datos al script. Si no, la petición puede llegar al servidor y ejecutarse, pero el navegador oculta la respuesta al código.

Esa distinción es clave: CORS protege la lectura en el cliente, no necesariamente la ejecución en el servidor. Por eso un endpoint debe validar autenticación y autorización por su cuenta, aunque el navegador bloquee la respuesta.

Origen: dominio, esquema y puerto

Un origen es la combinación de esquema, host y puerto. https://app.ejemplo.com y http://app.ejemplo.com son orígenes distintos. También lo son https://app.ejemplo.com y https://api.ejemplo.com, o dos puertos distintos en el mismo host.

La política del mismo origen es la base. Por defecto, un script solo puede leer respuestas del mismo origen. CORS es la excepción controlada: el servidor externo declara, mediante cabeceras, que acepta peticiones desde un origen concreto o desde cualquiera. fetch() y XMLHttpRequest se rigen por la política del mismo origen.

Cabeceras que deciden el acceso

La cabecera principal es Access-Control-Allow-Origin. Puede contener un origen exacto o el comodín *. Cuando se usan credenciales, el comodín no es válido y debe indicarse el origen exacto.

CabeceraFunción
Access-Control-Allow-OriginOrígenes permitidos para leer la respuesta
Access-Control-Allow-MethodsMétodos HTTP permitidos
Access-Control-Allow-HeadersCabeceras de petición permitidas
Access-Control-Allow-CredentialsIndica si se envían cookies o credenciales
Access-Control-Max-AgeTiempo de caché del resultado del preflight
Access-Control-Expose-HeadersCabeceras de respuesta legibles por el cliente

El servidor también puede usar Access-Control-Expose-Headers para permitir que el cliente lea cabeceras de respuesta que por defecto no están disponibles, como una cabecera personalizada de paginación.

Preflight: la petición OPTIONS

Algunas peticiones cruzadas disparan una comprobación previa. El navegador envía una petición OPTIONS al mismo recurso para preguntar si el método y las cabeceras reales están permitidos. Solo si la respuesta autoriza, envía la petición principal.

Suelen disparar preflight los métodos distintos de GET, HEAD y POST, las cabeceras personalizadas como X-Auth-Token, y Content-Type: application/json. Una petición POST con Content-Type: application/x-www-form-urlencoded y sin cabeceras personalizadas puede no dispararlo.

El preflight añade latencia y carga al servidor. Por eso conviene cachear su resultado con Access-Control-Max-Age cuando el navegador lo respeta, y evitar cabeceras innecesarias en el cliente.

Flujo completo de una petición con preflight

  1. El script llama a fetch con método PUT y cabecera X-Auth-Token.
  2. El navegador envía OPTIONS al mismo recurso.
  3. El servidor responde con los métodos y cabeceras permitidos.
  4. Si la respuesta autoriza, el navegador envía PUT.
  5. El servidor procesa y responde; el navegador entrega la respuesta al script.

Si el servidor responde al OPTIONS con un error o sin las cabeceras adecuadas, el navegador detiene el flujo y el script recibe un error genérico.

Credenciales, cookies y riesgos

Si la petición debe incluir cookies o autorización HTTP, el cliente debe activar credentials y el servidor debe responder Access-Control-Allow-Credentials: true. Además, el origen permitido debe ser exacto, no *.

Reflejar el Origin recibido sin validarlo es peligroso. Si además se activan credenciales, un sitio malicioso puede hacer que el navegador envíe cookies de la víctima y leer la respuesta. La configuración debe basarse en una lista explícita de orígenes confiables.

CORS no sustituye a las defensas contra CSRF. Una petición simple puede enviarse aunque el navegador bloquee la lectura de la respuesta.

Esto es habitual al consumir una API REST desde un frontend separado.

Errores CORS y cómo diagnosticarlos

Un fallo CORS aparece como error de red en el código, pero JavaScript no recibe detalles por seguridad. La consola del navegador muestra la causa: origen no permitido, método no autorizado o cabecera bloqueada.

La red de DevTools ayuda a distinguir dos casos. Si no hay petición OPTIONS, el problema puede estar en la respuesta final. Si hay OPTIONS con error, el servidor rechazó la comprobación previa y la petición principal no se envió.

No conviene desactivar la seguridad del navegador ni usar proxies opacos como solución permanente. Lo correcto es ajustar cabeceras en el servidor o, si el recurso es público, usar un origen permitido adecuado.

Buenas prácticas de configuración

  • Lista blanca de orígenes en lugar de reflejar cualquier Origin.
  • Permite solo los métodos y cabeceras que la aplicación necesita.
  • No combines * con credenciales.
  • Valida autenticación y autorización en el servidor, independientemente de CORS.
  • Documenta qué endpoints son públicos y cuáles requieren origen específico.

En desarrollo local, el frontend y el backend suelen estar en puertos distintos, por lo que CORS aparece aunque todo sea tuyo. Una configuración distinta para desarrollo y producción evita abrir orígenes en producción por comodidad.

Cuándo no hace falta CORS

Algunas inclusiones no requieren CORS porque no leen datos mediante script: imágenes, hojas de estilo, scripts o iframes incrustados. El navegador los carga, pero el código no puede inspeccionar su contenido si son de otro origen.

Aun así, los navegadores son cada vez más estrictos con las peticiones cruzadas, y las funciones nuevas que las inician suelen exigir CORS sin importar su naturaleza.

Relación con GraphQL y otros servicios

CORS no depende del estilo de API. Tanto un endpoint REST como un servidor GraphQL deben configurar las mismas cabeceras si el frontend está en otro origen.

El comodín * tiene sentido cuando el recurso es público, como una fuente web servida desde un alojamiento público. La especificación CORS anterior denominaba simples a las peticiones sin preflight, mientras que la especificación Fetch actual no emplea ese término.

Antes, el protocolo CORS exigía un comportamiento que después se retiró. Como no todos los navegadores aplicaron ese cambio, algunos conservan el comportamiento inicial.

Otras preguntas frecuentes

¿CORS bloquea la petición en el servidor?

No. CORS controla si el navegador entrega la respuesta al script. El servidor puede recibir y procesar la petición aunque luego el navegador la oculte.

¿Por qué aparece CORS en desarrollo local?

Porque el frontend y el backend suelen estar en puertos distintos, que son orígenes distintos. En producción conviene usar una configuración específica para cada entorno.

¿Puedo usar * con cookies?

No. Si se envían credenciales, el servidor debe indicar el origen exacto y activar Access-Control-Allow-Credentials.

¿Cómo sé qué falló en un error CORS?

JavaScript solo recibe un error genérico. La consola y la pestaña de red del navegador muestran el origen, método o cabecera rechazados.

Páginas relacionadas

  • Renderizado cliente vs servidor: diferencias y usos

    El renderizado del lado del cliente (CSR) genera el contenido HTML directamente en el navegador mediante JavaScript, mientras que el renderizado del lado del servidor (SSR) entrega un documento HTML completo procesado previamente en el servidor. La elección entre ambos modelos condiciona la velocidad de despliegue inicial, la carga en la infraestructura y la visibilidad ante los motores de búsqueda. Los desarrollos actuales combinan con frecuencia estrategias mixtas para equilibrar interactividad y posicionamiento.

  • Cookies web: funcionamiento, tipos y seguridad

    Las cookies web son pequeños bloques de datos enviados por un servidor y almacenados por el navegador para solventar la ausencia de memoria del protocolo HTTP. Permiten verificar la identidad del usuario tras iniciar sesión, guardar elecciones de configuración y dar continuidad a la experiencia en visitas posteriores. Mediante cabeceras de red automáticas, el cliente devuelve esta información al dominio emisor en cada petición.

  • Caché web: funcionamiento, tipos y limpieza

    El caché web es un almacenamiento temporal que guarda copias locales de recursos para que las páginas carguen más rápido. No es permanente: el navegador lo limpia solo y solo conviene vaciarlo cuando hay archivos obsoletos o dañados.

  • WebSocket what is it y cuándo usarlo

    WebSocket es un protocolo de red que permite intercambiar datos mediante una conexión TCP que se mantiene abierta entre cliente y servidor. Después del handshake HTTP, cliente y servidor pueden intercambiar mensajes en cualquier instante sin generar una petición nueva por cada envío. Resulta útil cuando una aplicación requiere actualizaciones frecuentes o en tiempo real.

  • GraphQL: qué es y cómo funciona

    GraphQL es un lenguaje para consultar APIs y un runtime que ejecuta esas consultas sobre un esquema definido. El cliente solicita solo los campos que necesita, incluso datos relacionados, en una sola operación. El servidor valida la consulta contra el esquema y devuelve una respuesta con la misma forma.

  • ¿Qué es una API REST y cómo funciona?

    Una API REST se basa en HTTP y en los principios de REST para operar sobre recursos con métodos como GET, POST, PUT y DELETE. Toda API REST pertenece al conjunto de las API, aunque muchas API no siguen REST. La diferencia entre una API REST flexible y una RESTful estricta afecta a la consistencia, la escalabilidad y el mantenimiento.

Cómo se preparó esta página

Antes de redactarla, el tema se investigó en las fuentes de abajo. Después, la página superó controles de calidad automáticos.

Informar de un error en esta página