La guía de API referencia de la versión AWS SDK for JavaScript 3 describe en detalle todas las API operaciones de la AWS SDK for JavaScript versión 3 (V3).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Uso compartido de recursos entre orígenes (CORS)
El uso compartido de recursos entre orígenes o CORS es una característica de seguridad de los navegadores web modernos. Habilita a los navegadores web para que puedan negociar qué dominios pueden realizar solicitudes de sitios web o servicios externos.
CORS es un factor importante que hay que tener en cuenta cuando se desarrollan aplicaciones de navegador con AWS SDK for JavaScript, ya que la mayoría de las solicitudes a recursos se envían a un dominio externo como, por ejemplo, el punto de enlace de un servicio web. Si su JavaScript entorno aplica la seguridad de CORS, debe configurar CORS con el servicio.
CORS determina si se permitirá el uso compartido de recursos en una solicitud entre orígenes basándose en lo siguiente:
-
El dominio específico que efectúa la solicitud.
-
El tipo de solicitud HTTP que se realiza (GET, PUT, POST, DELETE, etc.).
Funcionamiento de CORS
En el caso más sencillo, el navegador script realiza una solicitud GET para obtener un recurso de un servidor que se encuentra en otro dominio. En función de cómo sea la configuración de CORS de dicho servidor, si la solicitud proviene de un dominio con permiso para enviar solicitudes GET, el servidor de orígenes cruzados responderá devolviendo el recurso que se ha solicitado.
Si el dominio de solicitud o el tipo de solicitud HTTP no está autorizado, se denegará la solicitud. Sin embargo, con CORS es posible realizar una solicitud preliminar antes de enviarla realmente. En dicho caso, se realiza una solicitud preliminar en la que se envía la operación de solicitud de acceso OPTIONS. Si la configuración CORS del servidor de origen otorga acceso al dominio que realiza la solicitud, el servidor enviará una respuesta preliminar que contenga una lista de todos los tipos de solicitud HTTP que el dominio que realiza la solicitud puede hacer al recurso solicitado.
¿Se requiere la configuración de CORS?
Es preciso configurar CORS en los buckets de Amazon S3 para poder realizar operaciones en ellos. En algunos JavaScript entornos, es posible que el CORS no se aplique y, por lo tanto, no sea necesario configurarlo. Por ejemplo, si aloja su aplicación de un bucket de Amazon S3 y obtiene acceso a recursos de *.s3.amazonaws.com o algún otro punto de conexión específico, sus solicitudes no tendrán acceso a un dominio externo. Por lo tanto, esta configuración no necesita CORS. En este caso, se seguirá utilizando CORS para servicios ajenos a Amazon S3.
Configurar CORS para un bucket de Amazon S3
Puede configurar un un bucket de Amazon S3 para utilizar CORS en la consola de Amazon S3.
Si está configurando CORS en la consola de administración de servicios AWS web, debe usar JSON para crear una configuración de CORS. La nueva consola de administración de servicios AWS web solo admite configuraciones CORS de JSON.
importante
En la nueva consola de administración de servicios AWS web, la configuración CORS debe ser JSON.
-
En la consola de administración de servicios AWS web, abra la consola de Amazon S3, busque el bucket que desee configurar y active su casilla de verificación.
-
En el panel que se abre, seleccione Permisos.
-
En la pestaña Permisos, elija Configuración de CORS.
-
Escriba su configuración de CORS en el Editor de configuración de CORS y, a continuación, seleccione Guardar.
Una configuración de CORS es un archivo XML que contiene una serie de reglas dentro de una <CORSRule>. Una configuración puede tener hasta 100 reglas. Una regla se define con una de las siguientes etiquetas:
-
<AllowedOrigin>: especifica orígenes de dominios a los que permite realizar solicitudes de dominio cruzado. -
<AllowedMethod>: especifica un tipo de solicitud que permite (GET, PUT, POST, DELETE, HEAD) en solicitudes de dominio cruzado. -
<AllowedHeader>: especifica los encabezados que están permitidos en una solicitud preliminar.
Para ver las configuraciones de ejemplo, consulte Cómo configurar CORS en mi bucket en la Guía del usuario de Amazon Simple Storage Service.
Ejemplo de configuración de CORS
El siguiente ejemplo de configuración de CORS permite a un usuario ver, añadir, eliminar o actualizar los objetos contenidos en un bucket del dominio example.org. Sin embargo, le recomendamos que mantenga <AllowedOrigin> en el dominio de su sitio web. Puede especificar "*" para permitir cualquier origen.
importante
En la nueva consola de S3, la configuración de CORS debe ser JSON.
Esta configuración no autoriza al usuario a realizar acciones en el bucket. Habilita al modelo de seguridad del navegador para que permita una solicitud a Amazon S3. Los permisos tienen que configurarse a través de permisos de bucket o permisos de rol de IAM.
Puede utilizar ExposeHeader para permitir que el SDK lea los encabezados de respuestas que devuelve Amazon S3. Por ejemplo, para leer el encabezado ETag de una operación PUT o una carga multiparte, debe incluir la etiqueta ExposeHeader en su configuración, tal y como se muestra en el ejemplo anterior. El SDK solo puede obtener acceso a los encabezados que se exponen a través de la configuración de CORS. Si establece metadatos en el objeto, los valores se devuelven como encabezados con el prefijo x-amz-meta-, como x-amz-meta-my-custom-header, y también deben exponerse de la misma manera.
