Series: Install and configure the Amazon Polly integration

Configure IAM role with permissions for Amazon Polly app


To access Amazon Polly, PureCloud must have permission to use resources in Amazon Web Services (AWS). This procedure explains how to set up an IAM role in AWS. Assign this role to the Amazon Polly integration later, when you configure and activate the app in PureCloud.

Notes:
  • 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 do in AWS. An IAM role can be assumed by trusted identities, including applications such as PureCloud, AWS services such as EC2, or a user. 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.
  • A valid subscription is required. If you do not have a valid subscription, the integration does not activate and returns an invalid credentials error.

To configure an IAM role:

  1. Log in to AWS.
  2. Navigate to the AWS Services page.
  3. Select IAM.
  4. Under Dashboard, select Roles.
  5. On the Roles page, click Create role.
  6. Select Another AWS Account as the type of trusted entity.
  7. In the Account ID box, enter 765628985471 in the Account ID box. This number is PureCloud’s production account ID.
  8. To enhance security, Genesys recommends that you check the Require External ID box and enter your organization’s ID. 
  9. Click Next: Permissions.
  10. Next, assign permission policies to the role. In the search box, type Amazon Polly. Then select the AmazonPollyFullAccess and AmazonPollyReadOnlyAccess policies check boxes.
    • AmazonPollyFullAccess provides full access to Amazon Polly services and resources. 
    • AmazonPollyReadOnly provides read-only access to Amazon Polly, allowing the role to view Amazon Polly resources.
      Note: These permissions do not give PureCloud any ability to edit Amazon Polly.
  11. Click Next: Tags.
  12. (Optional) Add metadata to the role by attaching tags as key-value pairs. For more information, see Tagging AIM Entities in the AWS Identitiy and Access Management User Guide.
  13. Click Next: Review.
  14. In the Role Name box, type a name.
  15. In the Role description box, enter descriptive text about the role.
  16. Verify that the account number for Trusted entities matches the PureCloud production account ID you entered in step 7.
  17. Click Create Role. A message appears, indicating that the role was created successfully.
  18. Click the newly created role’s hyperlink. Summary details about the role appear.
  19. Next to the Role ARN, click the Copy icon to copy the ARN to the Clipboard. Use the ARN to complete the next task, Activate and configure the Amazon Polly integration.
    Note: An Amazon Resource Name (ARN) is a unique identifier that unambiguously identifies a resource.