AWS S3

You can add your existing Amazon S3 bucket as a datasource in PixelBin. This allows you to use PixelBin's real-time file delivery and transformation features on all existing files stored in the bucket.

---

Setting up AWS S3

1. Creating a new user in AWS

PixelBin only needs a set of permissions to use your S3 bucket. It is recommended that you create a separate user in AWS for use in PixelBin.

You can create a new user by going to the AWS IAM console. Create a new user with Programmatic access, i.e. access using keys, enabled.

Once the user is created, copy its access key and secret key as we will use them later to integrate with PixelBin.

2. Assigning access to a bucket

1. To do this, click on the "Add Permissions" button for the created user. Select "Attach existing policies directly" and then click on "Create Policy".

2. Select the JSON creator option for the policy and use the following JSON to create the policy that provides the access to your bucket. Note, that you need to change the bucket name to that of your bucket.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "s3:GetObject",
                   "s3:List*",
               ],
               "Resource": [
                   "arn:aws:s3:::my-bucket-name",
                   "arn:aws:s3:::my-bucket-name/*"
               ]
           }
       ]
   }

3. Attach this newly created policy to the user and confirm that the user in the IAM panel has this policy attached.

---

Configure Datasource

1. After entering basic details for the datasource, choose AWS S3 from the set of datasource types.
2. Fill out the S3 bucket name, access key id and secret access key.
3. Click Save.

note

We do not start copying files from your bucket as soon as you add the datasource. Instead, we will fetch the particular file when you request it through the PixelBin URL endpoint. The files accessed from this origin will not appear in your Storage library.