Custom AWS S3 storage

We prepare a tutorial on how you can connect your Amazon web services (AWS) account to TOPOL. 

WRITTEN tutorial:

1. Go to Your Topol Settings
2. In the left menu select “Plugin”
   
   
   
3. Find API Token where You want to setup Your own AWS S3 storage. Click on the cog button. (a dialog will appear)
   
   
   
   
4. Click on “Add own storage”
   
   
5. Click on “AWS S3 BUCKET”
   
   
6. Now You have to fill in Your AWS S3 credentials. (Follow the guide below) 

Create an S3 bucket dedicated to TOPOL plugin integration

1. 1. Log in to Your AWS console https://s3.console.aws.amazon.com/s3/home

   2. Click on “Create bucket”

   3. Fill form:

      1. Bucket name -> your-bucket-name (for example topol-plugin)

      2. AWS Region -> Select desired region (for example eu-central-1)

      3. Deselect “Block all public access” and select “ - I acknowledge that the current settings might result in this bucket and the objects within becoming public.” for confirmation.

      4. Rest leave with defaults and click on the “Create bucket” button

Add CORS configuration for the bucket to enable the editor to interact with the bucket

1. Click on the created bucket (can be found on https://s3.console.aws.amazon.com/s3/home)
2. Click on the “Permissions” tab
3. Scroll down to the bottom of the page. In the section with the name “Cross-origin resource sharing (CORS)” and click on the “Edit” button.
4. Paste in the following statement:

   [

       {

           "AllowedHeaders": [

               "*"

           ],

           "AllowedMethods": [

               "GET",

               "PUT",

               "POST",

               "DELETE"

           ],

           "AllowedOrigins": [

                       "https://o3s5p0dx21.execute-api.eu-west-1.amazonaws.com/v4/","https://d5aoblv5p04cg.cloudfront.net"

           ],

           "ExposeHeaders": []

       }

   ]

   
   
5. Click the “Save changes” button

Create own policy

1. Go to https://console.aws.amazon.com/iam/home#/policies
2. Click on “Create policy”
3. In the following form select: Service: S3
   Actions:
   List -> ListBucket
   Read -> GetObject
   Write -> PutObject, DeleteObject
   Permissions management -> PutObjectAcl
   Resources:
   - Select specific
   - For “bucket” click on “Add ARN”. Type Your bucket name from step 1 and click on the “Add” button.
   - For object click on “Add ARN”. Type Your bucket name from step 1, in the “object” name field select “Any”. Click on the “Add” button.
4. Click on “Review policy”.
5. Click on “Save changes.”

Create AWS user

1. Go to https://console.aws.amazon.com/iam/home#/users
2. Click on the “Add user” button
3. Fill “User name” field -> for example topol-plugin-user
4. Select AWS access type -> select “Programmatic access”
5. Click on the “Next: Permissions” button in the right bottom corner
6. In the next step click on “Attach existing policies directly”.
7. Filter policies via search where you type the name of Your created policy from step 3. (example: topol-plugin)
8. Select policy and click the “Next: Tags” button in the right bottom corner.
9. Click the “Next: Review” button in the right bottom corner.
10. Click the “Create user” button in the right bottom corner.
11. Copy Access key ID and Secret access key we will need them later in step 5 (Set AWS credentials to API Token).

Set AWS credentials to API Token in TOPOL (above)

All images will be stored on your bucket now.