Connecting AWS S3 Storage

Instructions for connecting AWS S3 as cloud storage for automatic uploading of call recordings from MikoPBX

Creating a Bucket

1. Go to the AWS console (link). Navigate to "All services" -> "Storage" -> "S3".

"S3" section in AWS

1. Click "Create bucket".

Button for creating a bucket

1. Enter any name for the bucket (field "Bucket name"). Leave all other parameters as default and click "Create bucket".

Parameters of the bucket being created

Creating an IAM User and Access Keys

1. Go to "All services" -> "Security, Identity, & Compliance" -> "IAM".

"IAM" section

1. Next, create a new IAM user. Go to the "Access Management" tab, then "Users". Click "Create user".

Creating a new IAM user

1. Enter the name of the IAM user in the "User name" field.

Click "Next".

"Specify user details" tab

1. Select "Attach policies directly" as the "Permissions options". Scroll down the page.

Selecting "Permissions options"

1. In the "Permissions policies" section click "Create policy".

"Create policy" button

1. In the newly opened tab, in the "Policy editor", select "JSON" as the format and paste the following content into the parameters field:

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

Replace "your-bucket-name" with the name of the bucket you created earlier (in this guide — "aws-s3-mikopbxstorage").

Click "Next".

Creating a new policy. Step 1

1. Next, specify any name for the policy being created.

Click "Next".

Creating a new policy. Step 2

1. Return to the user creation tab, refresh the policy list, and select the previously created policy (in this guide — "access-mikopbx").

Click "Next".

Selecting the previously created policy

1. Confirm user creation: click "Create user".

Confirming user creation

1. Open the page of the created user by clicking on the username.

Opening the created user's page

1. Go to the "Security credentials" section. Click "Create access key".

Creating an access key

1. Select "Application running outside AWS". Click "Next".

Selecting parameters when creating the key

1. Enter a description for the key so that you can identify it later. Click "Create access key".

Key description

The Access key and Secret access key will be displayed. Save them — they will be needed later when configuring MikoPBX.

The secret access key can only be viewed or downloaded now. It cannot be recovered later.

Access key and Secret access key

Connecting to MikoPBX

1. Go to the "Maintenance" -> "Storage" tab.

"Maintenance" -> "Storage" section

1. Open the "S3 Cloud Storage" tab and fill in the following fields:

• Automatic recording upload to cloud storage — enable the switch.

• S3 endpoint URL — enter the S3 AWS endpoint depending on the region of your bucket (link to the table with all URLs). In this guide — https://s3.ap-southeast-1.amazonaws.com

• S3 region — specify the region of your bucket. In this guide — ap-southeast-1

• S3 bucket name — enter the name of the bucket created in AWS (for example aws-s3-mikopbxstorage in this guide)

• Access key and Secret key — paste the values obtained when creating the service account access key.

Configure the “Local storage period (S3 mode)” slider — choose how long recordings will be stored locally before being deleted after uploading to the cloud.

Shorter local storage periods free up disk space faster.

Click “Save”.

Parameters for connecting S3 cloud storage in MikoPBX

After saving the settings, click "Test connection". If the connection is successful, the message “S3 connection successful” will appear and synchronization of call recordings will begin.

Successful connection