Integrasi Amazon S3 (transfer dan simpan data suara ke cloud storage)

Anda dapat mentransfer dan menyimpan data suara dari panggilan MiiTel ke Amazon S3 perusahaan Anda (penyimpanan cloud). Jika Anda ingin membatasi alamat IP selama integrasi, atur kebijakan yang dijelaskan dalam "Secure IP address during Amazon S3 Integration" Untuk pengguna IAM dan ember yang digunakan untuk integrasi S3, dan konfigurasikan pengaturan integrasi.

Contents

  NOTE

  •   You will need to subscribe to Amazon S3 integration. If you want to integrate MiiTel with Amazon S3, please contact us..

How to set the policy for IAM role

For the IAM role that is using the S3 integration, set the policy as below.

  IMPORTANT

  •   If you are currently using the old settings, please switch them to the new settings by August 28, 2024. If you don't change the settings, the Amazon S3 integration will be disconnected.
  • Set the following to the Permissions tab of the IAM role created in the AWS management console.
{ 
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
      "AWS": "<ARN created by RevComm account displayed in Third Party Integration > Amazon S3 of MiiTel Admin>"
    },
      "Action": "sts:AssumeRole",
      "Condition": {
       "StringEquals": {
        "sts:ExternalId": "<External ID displayed in Third Party Integration > Amazon S3 of MiiTel Admin>"
    }
   }
  }
 ]
}
  • Attach the high-level policy that has access to the bucket and folder names used for this integration to the Trust relationship tab. (Change<bucket> and <folder> to the bucket and folder names used in the integration.)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::<bucket>/<folder>/*"
  },
  {
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "*"
  }
 ]
}

  NOTE

  •   If you do not set a folder in Amazon S3 integration settings (MiiTel Admin), replace "Resource": "arn:aws:s3:::<backet>/<folder>/*" with "Resource": "arn:aws:s3:::<backet>/*".

Reference: Fixed IP address for Amazon S3 integration

Please set the policy below for the IAM role that is used for the S3 integration.

  • For<bucket>and<folder>: Enter the name of the bucket and folder you will use for the integration.
{
   "Version": "2012-10-17",
   "Statement": [
       {
           "Sid": "MiiTelPutObject",
           "Effect": "Allow",
           "Action": "s3:PutObject",
           "Resource": "arn:aws:s3:::<bucket>/<folder>/*",
           "Condition": {
               "IpAddress": {
                   "aws:SourceIp": [
                      "18.177.83.94/32", "35.73.236.241/32"
                   ]
               }
           }
       },
       {
           "Sid": "MiiTelConnectionCheck",
           "Effect": "Allow",
           "Action": [
               "s3:ListBucket"
           ],
          "Resource": "*",
           "Condition": {
               "IpAddress": {
                   "aws:SourceIp": [
                      "18.177.83.94/32", "35.73.236.241/32"
                   ]
               }
           }
       }
   ]
}

  NOTE

  •   In the name of the audio file uploaded to Amazon S3, part of the URL in the corresponding call history (Parent sequence ID) will be used. (ID consists of numbers and alphabets after https:// <CompanyID>.miitel.jp/app/calls/ in the displayed URL after clicking the corresponding call history in MiiTel Analytics.)
  •   If you are looking for a specific audio, download the call history list as CSV in MiiTel Analytics, check the Parent sequence ID of the corresponding call history, and search for the file name that includes the corresponding Parent sequence ID.
  •   Below is the format of the audio file saved in Amazon S3.
    • Audio channel: Stereo
    • Sample rate: 8 kHz
    • Bit / sample: 16

How to integrate

  IMPORTANT

  •   If you are currently using the old settings, please switch them to the new settings by August 28, 2024. If you don't change the settings, the Amazon S3 integration will be disconnected.
  1. Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
  2. Click cog-solid Open MiiTel Admin on the top right of the page.
  3. Click Third Party Integration > Amazon S3 integration.
  4. Configure the following settings and click Integrate.

eng_S3_july2024.png

1Bucket: Set the bucket name for Amazon S3 that will save MiiTel audio data.

  NOTE

  •   If the path of the bucket name is s3://bucket_name/ or https://bucket_name.<region-name>.amazonaws.com/ , please set it as bucket_name.

2Folder (optional): Set the folder name for Amazon S3 that will save MiiTel audio data.

  NOTE

  •   Use half-width alphabets or numbers, and special characters "_", "-", and "/" to enter the folder name.

3Create IAM role: Set the ARN for the created IAM role (The ARN is displayed in Summary when you select the role you created in Amazon S3 under IAM > Roles)

4External ID: Use this ID when you set up the policy for IAM role.

5IAM ARN created by RevComm account: Use this when you set up the policy for IAM role.

How to remove Amazon S3 integration

Follow the instructions below to remove the Amazon S3 integration.

  1. Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
  2. Click cog-solid Open MiiTel Admin on the top right of the page.

  3. Click Third Party Integration > Amazon S3.
  4. Click Remove integration

Optional settings: Email notification settings for external integration error

When an error occurs in Amazon S3 integration or other external integrations for any reason, you can receive error notification emails and check the details of the error.

For setting procedures, please check Email notification settings for external integration error.

Apakah artikel ini membantu?