Errores CORS
============

El Intercambio de Recursos de Origen Cruzado (CORS, por sus siglas en inglés) es un estándar que permite a un servidor relajar la política del mismo origen. Esto se usa para permitir explícitamente algunas solicitudes de origen cruzado mientras se rechazan otras. Por ejemplo, si un sitio ofrece un servicio integrable, puede ser necesario relajar ciertas restricciones. Establecer una configuración CORS de este tipo no es necesariamente fácil y puede presentar algunos desafíos. En estas páginas, veremos algunos mensajes de error comunes de CORS y cómo resolverlos.

Si CORS no está configurado correctamente, la consola del navegador presentará un error como `"Solicitud desde otro origen bloqueada: la política de mismo origen impide leer el recurso remoto en $algunsitio"`, lo que indica que la solicitud fue bloqueada debido a la violación de la Reglas de seguridad CORS. Sin embargo, esto podría no ser necesariamente un error de configuración. Es posible que, de hecho, la aplicación web del usuario y el servicio externo remoto rechacen intencionalmente la solicitud. Sin embargo, si el punto final debe estar disponible, se necesita algo de depuración para tener éxito.

Identificando el problema
-------------------------

Para comprender el problema con la configuración de CORS, debe averiguar qué solicitud tiene la culpa y por qué. Estos pasos pueden ayudarlo a hacerlo:

1. Navegue hasta el sitio web o la aplicación web en cuestión y abra las Herramientas para desarrolladores.
2. Ahora intente reproducir la solicitud fallida y verifique la consola si ve un mensaje de error de infracción de CORS. Probablemente se verá así:

![Consola de Firefox que muestra un error CORS](/es/docs/Web/HTTP/CORS/Errors/cors-error2.png)

El texto del mensaje de error será algo similar al siguiente:
```

Solicitud desde otro origen bloqueada: la política de mismo origen
impide leer el recurso remoto en https://alguna-url-aqui (razón:
información adicional aquí).
```


**Nota:** Por razones de seguridad, los detalles sobre lo que salió mal con una solicitud CORS *no están disponibles para el código JavaScript*. Todo lo que el código sabe es que ocurrió un error. La única forma de determinar qué salió mal específicamente es mirar la consola del navegador para obtener más detalles.

Mensajes de error de CORS
-------------------------

La consola de Firefox muestra mensajes en su consola cuando las solicitudes fallan debido a CORS. Parte del texto de error es un mensaje de "razón" que proporciona información adicional sobre lo que salió mal. Los mensajes de motivo se enumeran a continuación; haga clic en el mensaje para abrir un artículo que explica el error con más detalle y ofrece posibles soluciones.

* Razón: CORS desactivado (en-US)
* Razón: Solicitud CORS sin éxito
* Razón: No se puede agregar el encabezado CORS 'Origin' (en-US)
* Razón: Solicitud CORS de redirección externa no permitida (en-US)
* Razón: la solicitud CORS no es http
* Razón: falta la cabecera CORS 'Access-Control-Allow-Origin'
* Razón: El encabezado CORS 'Access-Control-Allow-Origin' no coincide con 'xyz' (en-US)
* Razón: La credencial no es compatible si el encabezado CORS 'Access-Control-Allow-Origin' es '\*' (en-US)
* Razón: No se encontró el método en el encabezado CORS 'Access-Control-Allow-Methods' (en-US)
* Razón: esperado 'true' en el encabezado CORS 'Access-Control-Allow-Credentials' (en-US)
* Razón: El canal de verificación previa de CORS no tuvo éxito
* Razón: token no válido 'xyz' en el encabezado CORS 'Access-Control-Allow-Methods' (en-US)
* Razón: token no válido 'xyz' en el encabezado CORS 'Access-Control-Allow-Headers' (en-US)
* Razón: falta el token 'xyz' en el encabezado de CORS 'Access-Control-Allow-Headers' del canal de verificación previa de CORS (en-US)
* Razón: Encabezado CORS múltiple 'Access-Control-Allow-Origin' no permitido (en-US)
Véase también
-------------

* Glosario: CORS
* Introducción a CORS
* Configuración de CORS del lado del servidor
* Imagen habilitada para CORS
* Atributos de configuración de CORS
* https://www.test-cors.org – página para probar solicitudes CORS