In order to be able to migrate your assets from a private S3 bucket to Cloudinary, the S3 bucket must first be whitelisted and follow our naming conventions. You can whitelist your own S3 bucket by adding an appropriately named file in your S3 bucket and allowing Cloudinary to access the bucket and read the file.
The file should have the following filename:
- The file can be blank, provided it's named the same as your cloud name and is added to the
.wellknown/cloudinary/folder in your bucket.
- By adding this file, you indicate that you have access to this bucket and that you permit Cloudinary to upload from this bucket to the specified cloud account.
- If you want this bucket to be whitelisted for more than one Cloudinary account (or sub-account), you can add an appropriately named file for each cloud name.
In addition, you must grant Cloudinary permission to read your protected content. Permission assignment can be done using Amazon's AWS S3 Console by following this procedure:
- Select the relevant bucket.
- Select the "Properties" tab (or click on the bucket and select Permissions | Bucket Policy).
- Paste the following policy-text (change
"BUCKETNAME"to the name of your bucket). If a policy already exists, append it to the existing one:
Following both of these steps will allow you to use S3 URLs for Upload APIs and Upload mapping.