Menu
Amazon Comprehend
Developer Guide

Using Identity-Based Polices (IAM Policies) for Amazon Comprehend

This topic provides examples of identity-based policies that demonstrate how an account administrator can attach permissions policies to IAM identities (that is, users, groups, and roles) and thereby grant permissions to perform Amazon Comprehend actions.

Important

Before you proceed, we recommend that you review Overview of Managing Access Permissions to Amazon Comprehend Resources.

The following is the permissions policy required to use the Amazon Comprehend DetectEntities action:

Copy
{ "Version": "2012-10-17", "Statement": [{ "Sid": "AllowDetect -Actions", "Effect": "Allow", "Action": [ "comprehend:DetectEntities", "comprehend:DetectKeyPhrases", "comprehend:DetectDominantLanguage", "comprehend:DetectSentiment" ], "Resource": "*" ] } ] }

The policy has one statement that grants permission to use the DetectEntities, DetectKeyPhrases, DetectDominantLanguage and DetectSentiment actions. A user with this policy would not be able to perform batch actions in your account.

The policy doesn't specify the Principal element because you don't specify the principal who gets the permission in an identity-based policy. When you attach a policy to a user, the user is the implicit principal. When you attach a permissions policy to an IAM role, the principal identified in the role's trust policy gets the permissions.

For a table showing all of the Amazon Comprehend API actions and the resources that they apply to, see Amazon Comprehend API Permissions: Actions, Resources, and Conditions Reference.

Permissions Required to Use the Amazon Comprehend Console

The permissions reference table lists the Amazon Comprehend API operations and shows the required permissions for each operation. For more information, about Amazon Comprehend API permissions, see Amazon Comprehend API Permissions: Actions, Resources, and Conditions Reference.

To use the Amazon Comprehend console, you need to grant permissions for the actions shown in the following policy:

Copy
{ "Version": "2012-10-17", "Statement": [ { "Action": [ "comprehend:*", "iam:ListRoles", "iam:GetRole", "s3:ListAllMyBuckets", "s3:ListBucket", "s3:GetBucketLocation" ], "Effect": "Allow", "Resource": "*" } ] }

The Amazon Comprehend console needs these additional permissions for the following reasons:

  • iam permissions to list the available IAM roles for your account.

  • s3 permissions to access the Amazon S3 buckets and objects that contain the data for topic modeling.

When you create a topic modeling job using the console, you have the option to have the console create an IAM role for your job. To create an IAM role, users must be granted the following additional permissions to create IAM roles and policies, and to attach policies to roles:

Copy
{ "Version": "2012-10-17" "Statement": [ { "Action": [ "iam:CreateRole", "iam:CreatePolicy", "iam:AttachRolePolicy", "iam:PassRole" ], "Effect": "Allow", "Resource": "*" } ] }

The Amazon Comprehend console needs these additional permissions for the following reasons:

  • iam permissions to create roles and policies and to attach roles and polices. The iam:PassRole action enables the console to pass the role to Amazon Comprehend.

AWS Managed (Predefined) Policies for Amazon Comprehend

AWS addresses many common use cases by providing standalone IAM policies that are created and administered by AWS. These AWS managed policies grant necessary permissions for common use cases so that you can avoid having to investigate what permissions are needed. For more information, see AWS Managed Policies in the IAM User Guide.

The following AWS managed policies, which you can attach to users in your account, are specific to Amazon Comprehend:

  • ComprehendFullAccess – Grants full access to Amazon Comprehend resources including running topic modeling jobs. Includes permission to list and get IAM roles.

  • ComprehendReadOnly – Grants permission to run all Amazon Comprehend actions except StartTopicsDetectionJob.

You need to apply the following additional policy to any user that will use Amazon Comprehend:

Copy
{ "Version": "2012-10-17" "Statement": [ { "Action": [ "iam:PassRole" ], "Effect": "Allow", "Resource": "*" } ] }

You can review the managed permissions policies by signing in to the IAM console and searching for specific policies there.

These policies work when you are using AWS SDKs or the AWS CLI.

You can also create your own custom IAM policies to allow permissions for Amazon Comprehend actions and resources. You can attach these custom policies to the IAM users or groups that require those permissions.

Role-Based Permissions Required for Topic Detection

To use the Amazon Comprehend topic detection operations, you must grant Amazon Comprehend access to the Amazon S3 bucket that contains your document collection. You do this by creating a data access role in your account to trust the Amazon Comprehend service principal. For more information about creating a role, see Creating a Role to Delegate Permissions to an AWS Service in the AWS Identity and Access Management User Guide.

The following is the role's trust policy:

Copy
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "comprehend.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

After you have created the role, you must create an access policy for that role. The should grant the Amazon S3 GetObject and ListBucket permissions to the Amazon S3 bucket that contains your input data, and the Amazon S3 PutObject permission to your Amazon S3 output data bucket.

The following example access policy contains those permissions.

Copy
{ "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::input bucket/*" ], "Effect": "Allow" }, { "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::input bucket" ], "Effect": "Allow" }, { "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::output bucket/*" ], "Effect": "Allow" } ] }

Customer Managed Policy Examples

In this section, you can find example user policies that grant permissions for various Amazon Comprehend actions. These policies work when you are using AWS SDKs or the AWS CLI. When you are using the console, you need to grant permissions to all the Amazon Comprehend APIs. This is discussed in Permissions Required to Use the Amazon Comprehend Console.

Note

All examples use the us-east-2 region and contain fictitious account IDs.

Examples

Example 1: Allow All Amazon Comprehend Actions

After you sign up for AWS, you create an administrator user to manage your account, including creating users and managing their permissions.

You might choose to create a user who has permissions for all Amazon Comprehend actions (think of this user as a service-specific administrator) for working with Amazon Comprehend. You can attach the following permissions policy to this user.

Copy
{ "Version": "2012-10-17", "Statement": [{ "Sid": "AllowAllComprehendActions", "Effect": "Allow", "Action": [ "comprehend:*"], "Resource": "*" } ] }

Example 2: Allow Topic Modeling Actions

The following permissions policy grants user permissions to perform the Amazon Comprehend topic modeling operations.

Copy
{ "Version": "2012-10-17", "Statement": [{ "Sid": "AllowTopicModelingActions", "Effect": "Allow", "Action": [ "comprehend:DescribeTopicsDetectionJob", "comprehend:ListTopicsDetectionJobs", "comprehend:StartTopicsDetectionJob", ], "Resource": "*" ] } ] }