Custom AWS S3 Storage

The Custom storage feature is available with the Plugin Expansion plan and higher.

If you're on the Plugin for Startup plan, consider upgrading to access this feature. For more details, visit our pricing page or contact support.

The Custom Cloud Storage feature in the Topol Plugin lets you connect your own storage provider. Alongside Google Cloud Storage, Cloudflare R2, and DigitalOcean Spaces, you can also use Amazon Web Services (AWS S3) — and this tutorial walks you through that setup, step by step.

Throughout this guide, you will create a few values that you'll need at the very end (your bucket name, access key, and secret key). Save each one somewhere safe as you go.

Create an S3 bucket dedicated to the TOPOL plugin integration

1) Log in to your AWS console at https://s3.console.aws.amazon.com/s3/home.

2) Click Create bucket and fill out the form:

• Bucket name — enter your own name (for example, topol-plugin). Save your bucket name elsewhere, as you will need it later.
• Under Object Ownership, select ACLs enabled, then select Object writer.
• Under Block Public Access settings, deselect Block all public access, then tick I acknowledge that the current settings might result in this bucket and the objects within becoming public. to confirm.
• Leave all remaining options at their defaults and click the Create bucket button.

Add a CORS configuration so the editor can interact with the bucket

1) Open the bucket you just created (find it on https://s3.console.aws.amazon.com/s3/home).

2) Open the Permissions tab.

3) Scroll to the bottom of the page. In the Cross-origin resource sharing (CORS) section, click the Edit button and paste in the following statement:

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "GET",
            "PUT",
            "POST",
            "DELETE"
        ],
        "AllowedOrigins": [
           "https://o6lwlm3sld.execute-api.eu-west-1.amazonaws.com",
           "https://d5aoblv5p04cg.cloudfront.net",
           "https://v3.develop.email-assets.topol.io",
           "https://v3.email-assets.topol.io",
           "https://v4.develop.email-assets.topol.io",
           "https://v4.email-assets.topol.io"
        ],
        "ExposeHeaders": []
    }
]

4) Click the Save changes button.

Create your own policy

1) Go to https://console.aws.amazon.com/iam/home#/policies.

2) Click Create policy.

3) In the form that appears, select the following:

• Service: S3
• Actions:
  • List -> ListBucket
  • Read -> GetObject
  • Write -> PutObject, DeleteObject
  • Permissions management -> PutObjectAcl
• Resources:
  • Select specific.
  • For bucket, click Add ARN. Type your bucket name from the first section and click the Add button.
  • For object, click Add ARN. Type your bucket name from the first section, and in the object name field select Any. Click the Add button.

4) Click Review policy.

5) Type a policy name.

6) Click Create policy.

Create an AWS user

1) Go to https://console.aws.amazon.com/iam/home#/users.

2) Click the Add user button.

3) Fill in the User name field (for example, topol-plugin-user).

4) Click the Next: Permissions button in the bottom-right corner.

5) Click Attach existing policies directly.

6) In the search field, type the name of the policy you created in the previous section (for example, topol-plugin).

7) Select the policy and click the Next button in the bottom-right corner.

8) Click the Next button in the bottom-right corner.

9) Click the Create user button in the bottom-right corner.

Create access keys

1) Go to https://console.aws.amazon.com/iam/home#/users.

2) Click the user you just created.

3) Open the Security credentials tab.

4) Scroll to Access keys.

5) Click Create Access key.

6) Select Third-party service.

7) Create the access key.

8) Copy the Access key and Secret key. Save both of them elsewhere, as you will need them later.

9) Click Done.

Set your AWS credentials for the API Token in TOPOL

1) Go to your Topol Settings.

2) In the left menu, select Plugin.

3) Find the API Token where you want to set up your own AWS S3 storage and click Storage options. A dialog will appear.

4) Click AWS S3 BUCKET.

5) Fill in your AWS S3 credentials (the bucket name, access key, and secret key you saved earlier).

Your AWS S3 storage setup is now complete.

If you encounter any issues or require additional instructions, please don't hesitate to contact our support.