S3-compatible cloud storage

Voximplant allows developers to use custom S3-compatible cloud storages to store call and conference records.

To use cloud storage, you need to add it to your Voximplant account and attach it to an application. To add storage:

1. Open the Voximplant control panel.
2. Go to Settings → S3 storages.

3. Click the Add storage button at the center of the screen or at the top right corner.

4. Enter your S3-compatible storage credentials and click Add.

To add a new S3-compatible storage, you need the following credentials: host, region, bucket name, key_id, and secret_key.

5. Go to the Applications section, find the necessary application, click the three dots menu, and choose Edit.

6. Choose your newly created S3 storage from the dropdown list and click Save.

Now all call and conference records will be saved in your custom S3-compatible storage instead of the Voximplant cloud.

If you need to check if your cloud storage works correctly, you can test file uploading before you start recording calls or conferences.

To test your cloud storage, log in to your control panel, go to Settings → S3 storages, and find the necessary storage. Then click on the three dots menu and choose Test.

This starts uploading test to the custom storage and provides a result in a short time.

To use an S3-compatible storage with Voximplant, you need to set up storage permissions on the provider side. These permissions differ depending on the provider.

Refer to the S3 storage provider documentation to find out what permissions you need and how to set them up. Here are the instructions for the most popular storage providers. If your provider is not in the list, refer to your provider's documentation.

Amazon Web Services

To set up the AWS storage provider, do the following:

1. Create an IAM user at AWS.
2. Create access key for that user. Store the access and secret keys.

3. Grant the s3:PutObject permission to the user.
4. Set up the storage in the Voximplant control panel with the following host: https://s3.amazonaws.com/.

For more informanion, refer to the Amazon AWS documentation via the links below.

Google Cloud

To set up the Google storage provider, do the following:

1. Create a service account at Google cloud.
2. Grant the Storage Object Creator permission to the created account in the project where the target storage bucket is.
3. Create a HMAC key for the service account.
4. Store the access and secret keys.

5. Set up the storage in the Voximplant control panel with the following host: https://storage.googleapis.com,

For more informanion, refer to the Google documentation via the links below.

Yandex Cloud

To set up the Yandex storage provider, do the following:

1. Create a service account at Yandex.
2. Create a new static access key for the service account and save it.
3. Grant the storage → uploader role to the service account
4. Set up the storage in the Voximplant control panel with the following host: https://storage.yandexcloud.net

For more informanion, refer to the Yandex documentation via the links below.

MinIO

To set up the MinIO storage provider, do the following:

1. Create an account at MinIO
2. Grant the readwrite or writeonly rights in the settings.
3. Use the account's username and password as access key and secret key in Voximplant's control panel.

For more informanion, refer to the MinIO documentation via the links below.

When you try to access the existing records, you can get the following errors:

When you try to access the record in the S3-compatible storage, you can get another S3-specific errors.