S3 Destination
NOTE: If you do not want to give Blitline permission to your buckets, please see Using S3 Signed Urls
SETTING YOUR AWS CANONICAL ID
It is VERY important that you set your AWS Canonical ID on your Blitline.com account if you are going to let Blitline push images to your bucket. You can set the Canonical ID by logging in to Blitline.com, and locating it on the logged in homepage.
Without the Canonical ID, we cannot make YOU the owner of the image. Even though it is in yourbucket, Blitline will still be the owner of the object and you will not be able to do anything to it (such as rename, or re-permission) and your only option will be to copy it somewhere, thus making you the owner of the copy. SO, make sure you set the Canonical ID!
HOW DO I GET MY AWS CANONICAL ID?
First, make sure you are logged in to the AWS web console. Then navigate to https://console.aws.amazon.com...
On this screen you will click the Account Identifiers section.
Copy and paste this into the Blitline.com homepage Canonical ID section, and click the Updatebutton.
S3 PERMISSION
Please make sure you have already set your Canonical ID before proceeding.
You will need to give Blitline permission to write to your S3 buckets.
You can do this through the AWS web console:
- Navigate to S3 and the list of your buckets
- Select your bucket in the left column
- Click the Properties button on the top of the screen
- Click the Add Bucket Policy bucket under Permissions
- In the text area that appears, copy and paste the following code (Replace the YOUR_BUCKET_NAME placeholder text with your actual bucket name)
{
"Version": "2008-10-17",
"Statement": [
{
"Sid": "AddCannedAcl",
"Effect": "Allow",
"Principal": {
"CanonicalUser": "dd81f2e5f9fd34f0fca01d29c62e6ae6cafd33079d99d14ad22fbbea41f36d9a"
},
"Action": [
"s3:PutObjectAcl",
"s3:PutObject"
],
"Resource": "arn:aws:s3:::YOUR_BUCKET_NAME\/*"
},
{
"Effect": "Allow",
"Principal": {
"CanonicalUser": "dd81f2e5f9fd34f0fca01d29c62e6ae6cafd33079d99d14ad22fbbea41f36d9a"
},
"Action": [
"s3:GetBucketLocation"
],
"Resource": "arn:aws:s3:::YOUR_BUCKET_NAME"
}
]
}
- Click the Save button.
- (Optional) If you want Blitline to be able to READ from your bucket, add s3:GetObject under Action as well…
This permission policy above allows Blitline to write to your bucket.
PUSHING TO YOUR S3 BUCKET
In your Blitline job, you will need to add an “s3_destination”. This “s3_destination” needs to have the following children:
- bucket (Your S3 bucket to push to)
- key (The S3 key for the image that you wish Blitline to write to)
- headers (Optional headers you wish to have added to your S3 item)
{
"application_id": "YOUR_APP_ID",
"src" : "http://www.google.com/logos/2011/houdini11-hp.jpg",
"postback_url" : "YOUR_WEBSITE_URL",
"functions" : [{
"name": "blur",
"save" : {
"image_identifier" : "YOUR_IMAGE_IDENTIFIER",
"s3_destination" : {
"bucket" : "YOUR_BUCKET_NAME",
"key" : "key value to save image as"
}
}
}]
}
