Before using the Comprehend connector, you must configure AWS credentials and permissions that allow Studio Modeler to access Amazon Comprehend and, when applicable, Amazon S3 resources.
The connector uses the AWS SDK to communicate with Amazon Comprehend services for entity recognition, PII detection, and document classification. The configured AWS user or role must have sufficient permissions to perform the required Comprehend operations.
The simplest configuration is to assign the AWS managed policy ComprehendFullAccess. This policy grants access to Amazon Comprehend operations required by the connector. If your organization uses more restrictive security policies, grant only the permissions required by the Amazon Comprehend features used by your processes.
Some Comprehend operations process documents asynchronously and require access to Amazon S3. For these operations the configured IAM user or role must have permission to read from and write to the configured S3 bucket and the Amazon Comprehend must also be granted access to the S3 bucket through the configured IAM role. Document classification and large-scale document processing typically require S3 access.
The connector requires AWS credentials to authenticate with AWS services. The following information must be available:
- AWS access key ID
- AWS secret access key
- AWS region
- Amazon S3 bucket name
- IAM role ARN used by Amazon Comprehend
These values are configured through the Comprehend connector configuration parameters.
The Amazon Comprehend APIs that are called using the connector are:
- DetectDominantLanguage
- DetectEntities
- BatchDetectEntities
- StartEntitiesDetectionJob
- DescribeEntitiesDetectionJob
- DetectPiiEntities
- StartPiiEntitiesDetectionJob
- DescribePiiEntitiesDetectionJob
- StartDocumentClassificationJob