Jump toUpdate content
Setting CORS Rules on Object Storage buckets
The CORS standard describes new HTTP headers which provide browsers a way to request remote URLs only when they have permission. Although some validation and authorization can be performed by the server, it is generally the browser’s responsibility to support these headers and honor the restrictions they impose.
Before CORS became standardized it was not possible to call an API endpoint or other content under different domains for security reasons. This was (and to some degree still is) blocked by the Same-Origin Policy introduced with Netscape Navigator 2.0 in 1995.
XMLHttpRequest to make a request for
Enter the Object Storage section in the left menu of the console.
Create a new bucket or choose one of your existing buckets.
The CORS configuration should be provided in a json file. Create a new file called
cors.jsonlocally, open it in a text editor and copy the following content into the file before saving it.
"AllowedOrigins": ["http://MY_DOMAIN_NAME", "http://www.MY_DOMAIN_NAME"],
"AllowedMethods": ["GET", "HEAD", "POST", "PUT", "DELETE"],
http://MY_DOMAIN_NAMEwith the domain name to authorize for CORS. You can specify multiple domain names, or put an asterisk (
*) to allow all domains.
Set the CORS configuration of the bucket with AWS CLI:
aws s3api put-bucket-cors --bucket BUCKETNAME --cors-configuration file://cors.jsonNote:
BUCKETNAMEwith the name of the bucket.
To retrieve the CORS rules of a bucket, use
aws s3api get-bucket-cors --bucket BUCKETNAME
If CORS rules are set for the bucket, the API returns a JSON list like this example:
If there are no CORS rules set for the bucket, an error message appears:
An error occurred (NoSuchCORSConfiguration) when calling the GetBucketCors operation: The CORS configuration does not exist
To verify the CORS rules of a bucket, curl can be used with the different methods (
curl -X OPTIONS -H 'Origin: http://MY_DOMAIN_NAME' http://BUCKETNAME.s3.nl-ams.scw.cloud/index.html -H "Access-Control-Request-Method: GET"
To delete the CORS rules of a bucket, use
aws s3api delete-bucket-cors --bucket BUCKETNAME
If the operation is successful, no output returns.
For more information on CORS and the Object Storage features, refer to the documentation.