Adding AWS S3 Bucket as Source

Search…
Using Pixboost, you can set up a private S3 bucket to be a source of your images. Here, we will go through requirements for the S3 bucket, how to add an integration to Pixboost and how to optimise images from the bucket using API.
AWS setup
We assume that you already have S3 bucket with your images stored there. If not then you can read how to do that here.
To setup a new user that you'll integrate with Pixboost:
Create a new IAM user​
​Add new credentials for the user.
​Update or create bucket policy and give the user s3:ListBucket and s3:GetObject permissions.
Below is an example of a bucket policy:
1
{
2
    "Version": "2012-10-17",
3
    "Statement": [
4
        {
5
            "Effect": "Allow",
6
            "Principal": {
7
                "AWS": "arn:aws:iam::<ACCOUNT_ID>:user/<USER_ID>"
8
            },
9
            "Action": "s3:ListBucket",
10
            "Resource": "arn:aws:s3:::<BUCKET_NAME>"
11
        },
12
        {
13
            "Effect": "Allow",
14
            "Principal": {
15
                "AWS": "arn:aws:iam::<ACCOUNT_ID>:user/<USER_ID>"
16
            },
17
            "Action": "s3:GetObject",
18
            "Resource": "arn:aws:s3:::<BUCKET_NAME>/*"
19
        }
20
    ]
21
}
Copied!
Pixboost setup
To set up the integration:
​Login to your Pixboost account.
Click on "Add source" link under the "Images Sources" panel
In the appeared form set Type to "Amazon AWS S3 Bucket" and fill in the details
Alias is a unique identifier of the images source that will be used in the URL when calling API
Bucket name is the name of a bucket
Region is an AWS region ID of the bucket
Path Prefix is an optional prefix that will be used for all requests. It could be used if all your images in
the bucket stored in one folder. In that case, you could set "Path prefix", and you won't need to add it to each API call.
Access Key is an AWS IAM user's access key created in the step above
Secret Key is an AWS IAM user's secret key created in the step above
Click on "Add" button and verify that the source has been created
Using API
All API requests follow the original pattern:
https://pixboost.com/api/2/img/[ALIAS]/[PATH_TO_THE_IMAGE]/[OPERATION]?[OPERATION_PARAMS]&auth=[API_KEY]
Let's consider a configuration from the step above. For instance, if there is an image in S3 bucket with a path (key): prefix/another-prefix/images/hello.png then to resize it we use the following API call:
https://pixboost.com/api/2/img/bucket/images/hello.png/resize?size=200&auth=[API_KEY]
In the example above /bucket (after /api/2/img) will be replaced with bucket name and path prefix - pixboost-test-source/prefix/another-prefix
Limitations
You could have a maximum of 10 images sources. That is a soft limit, so if you'd like to raise it, please email us at [email protected]
Adding HTTP image source
Managing API Keys
Last modified 11mo ago
Copy link
Contents