Create IAM resources for AWS S3 bucket
Note: This article applies to the AWS S3 recording bulk actions integration.
To access AWS S3 functions, Genesys Cloud must have permission to use resources in your Amazon Web Services (AWS) account. This procedure explains how to create a policy, create an IAM role in AWS, and attach this role to the policy. Later you assign this role to the AWS S3 integration in Genesys Cloud.
Note: AWS Identity and Access Management (IAM) is a web service that controls access to AWS resources. An IAM role is similar to a user, because it defines an AWS identity with permission policies that determine what the identity can and cannot do in AWS. Trusted identities, including applications such as Genesys Cloud, AWS services such as EC2, or a user, assume the IAM role. Each IAM role defines necessary permissions to make AWS service requests. For more information, see IAM Roles in Amazon’s AWS Identity and Access Management User Guide.
To create a policy, create an IAM role, and attach this role to the policy, follow these steps:
- Log in to AWS.
- Navigate to the AWS Services page.
- To create an S3 bucket, click S3.
- After you create an S3 bucket, go to the AWS Services page and click IAM.
- Create a policy. Policies specify what resources roles can act on and how roles can act on the resources.
- Under Dashboard, select Policies.
- Click Create policy.
- On the Visual editor tab, configure the following items:
- Under Service, click Select a service and click S3. This setting specifies what service the policy calls.
- Under Actions and Access level, click the arrow next to Write and select the PutObject check box. This setting specifies what actions the policy grants to the AWS S3 bucket.
- Under Read, select GetBucketLocation and GetEncryptionConfiguration.
- Under Permission Management, select PutObjectAcl.
- Under Resources, select Specific and click Add ARN. For Bucket Name, enter the name of the S3 bucket you created. For Object Name, check the box next to Any. Click Add.
- Click Review policy.
- In the Name box, type a name for the policy.
- Click Create policy.
- Create a role that uses this policy.
- Under Dashboard, click Roles.
- On the Roles page, click Create role.
- Select Another AWS Account as the type of trusted entity.
- In the Account ID box, enter 765628985471 (Core/Satellite regions) or 325654371633 (FedRAMP region [US-East-2]). This number is Genesys Cloud’s production account ID.
- Select the Require external ID check box and enter your Genesys Cloud organization ID.
- Click Next: Permissions.
- Attach permission policies to this role.
- Select the policy that you created.
- Click Next: Tags
- Click Next: Review.
- In the Role name box, type a name for the role.
- In the Role description box, enter descriptive text about the role.
- Verify that the account number for Trusted entities matches the Genesys Cloud production AWS account ID that you entered earlier.
- Click Create role.
Next, Add the AWS S3 Recording Bulk Actions Integration.
Note: By default, the export process will use an AWS Managed Key (KMS) for encryption of the files stored in the S3 bucket. If usage of a Customer Managed Key (CMK) is needed, see Use a CMK key for export (optional).