Custom AWS S3 storage

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

WRITTEN tutorial:

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. In Object Ownership, select ACLs enabled and select Object writer.

      4. 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.

      5. 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 

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.