# phone.systems(TM) with S3 Cloud Storage

Connecting phone.systems(TM) with S3 Cloud Storage allows you to store call recordings and voicemail data securely in
your S3 environment.

Note

Ensure that you have the required S3 credentials and access to your bucket before starting the integration.

---



## S3 Compatibility

Amazon Simple Storage Service (S3) is a widely used object storage protocol that allows seamless data storage and
retrieval. Various cloud storage solutions implement the S3 API to enable interoperability across different platforms.

For this documentation, we will demonstrate the integration of **phone.systems(TM)** with **MinIO**, an S3-compatible
object storage solution.

Important

The same principles can generally be applied to other S3-compatible storage providers with minor modifications.

---

## Step 1: Launch phone.systems(TM) and create S3 Cloud Storage connection

Follow these steps to create the MinIO Cloud Storage connection:

> 1. Log in to your DIDWW account, and launch phone.systems(TM).
> 2. In phone.systems(TM), go to **Settings > Cloud Storage Integrations**.
> 3. Under S3 Cloud Storage, click **Connect**.

[![Create MinIO Cloud Storage Connection](../../../_images/1_create_minio_connection_in_phonesystems.png)](../../../_images/1_create_minio_connection_in_phonesystems.png)


**Fig. 1.** Create S3 Cloud Storage Connection

A new page will open, where it is required to fill in the details from your S3 IAM credentials:

> 1. **Endpoint**: Enter the S3 server endpoint (e.g., `https://play.min.io`).
> 2. **Bucket Region**: Enter the region configured for your S3 bucket (e.g., `eu-west-1`).
> 3. **Bucket Name**: Enter the name of your bucket.
> 4. **Access Key ID**: Enter your IAM user's access key ID.
> 5. **Secret Access Key**: Enter your IAM user's secret access key.

[![Requirements to Activate MinIO Cloud Storage](../../../_images/1_requirements_for_minio_connection.png)](../../../_images/1_requirements_for_minio_connection.png)


**Fig. 2.** Requirements to Activate MinIO Cloud Storage

## Step 2: Retrieve Endpoint, Bucket Region, and Bucket Name

1. Open your MinIO server or the [MinIO Console](https://min.io/).
2. Locate the endpoint.

   - The **Endpoint** is the URL where your MinIO server is hosted (e.g., `https://play.min.io`).
3. Retrieve the bucket region.

   - The **Bucket Region** is the region configured for your S3 bucket (e.g., `eu-west-1`).

   Note

   In MinIO or another S3-compatible storage provider, this value depends on your bucket or server configuration. If you
are unsure which region to use, check your storage settings or contact your storage administrator.
4. Retrieve the bucket name.

   - In the MinIO Console, navigate to **Buckets**.
   - Find the bucket name in the list or create a new bucket if needed.

## Step 3: Retrieve Access Key ID and Secret Access Key

1. Open the MinIO Console and sign in with your credentials.
2. Navigate to **Identity > Users** in the MinIO Console.

   - Locate the IAM user associated with your application.
   - If you need to create a new IAM user, follow the steps in the [MinIO IAM User Guide](https://min.io/docs/minio/linux/administration/identity-access-management/minio-user-management.html).
3. Generate or retrieve access keys.

   - Copy the **Access Key ID** and **Secret Access Key** associated with the IAM user.

Warning

The Secret Access Key is displayed only once when generated. Save it securely before leaving the page.

## Step 4: Connect the phone.systems(TM) S3 Cloud Storage

To establish the connection to S3 Cloud Storage, click **Connect** on the phone.systems(TM) page.
After the connection is complete, S3 Cloud Storage will appear under **Active Integrations** with the status
**Connected**.

[![Activate MinIO Cloud Storage](../../../_images/active_minio_cloud_storage.png)](../../../_images/active_minio_cloud_storage.png)


**Fig. 3.** Activate MinIO Cloud Storage

## Additional Resources

MinIO Documentation

Learn how to manage MinIO using the MinIO Console, including configuration, monitoring, and administration.

<https://min.io/docs/minio/linux/administration/minio-console.html>

MinIO IAM User Guide

Understand MinIO Identity and Access Management (IAM), including user roles, permissions, and authentication.

<https://min.io/docs/minio/linux/administration/identity-access-management/minio-user-management.html>

On this page