Before you can start using the Amazon Comprehend activities, you must complete a couple of steps to enable authorization from the AWS Identity and Access Management (IAM) service.
To enable authorization and start building your automation projects, complete the following:
Follow the Create an IAM User steps in the Amazon Comprehend documentation.
For reference, below is how we created an IAM user for our examples.
If you already have an IAM user with an Access Key ID and Secret Access Key (that include the AmazonComprehendFullAccess and AmazonS3ReadOnlyAccess permissions), you can proceed to the 2. Build your project step.
- Sign in to the AWS console using your AWS account credentials.
- Open the Identity and Access Management (IAM) service (you can enter IAM in the Find Services search bar).
- In the left-hand navigation panel, click Groups.
- Before creating an IAM user, create an IAM group. For more information, see Use Groups to Assign Permissions to IAM Users in the IAM Best Practices documentation.
- Click Create New Group.
- Enter a Group Name and click Next Step at the bottom of the page.
- Select the policies that you want to attach to the group and IAM user.
- It's recommended that you follow the Grant Least Privilege guidance in the IAM Best Practices documentation.
- At a minimum, the Amazon Comprehend activities require AmazonComprehendFullAccess and AmazonS3ReadOnlyAccess.
Establishing a principle of least privilege ensures that authenticated identities are only permitted to perform the most minimal set of functions necessary to fulfill a specific task, while balancing usability and efficiency. Operating on this principle limits the blast radius - or potential impact - of inappropriate use of valid credentials. The principle of least privilege allows you to enforce separation of duties for oversight and governance, and makes auditing the entitlements to your resources much simpler.
- Review your group details and click Create Group at the bottom of the page.
- In the left-hand navigation panel, click Users.
- Click Add user.
- Enter a User name and select Access type - Programmatic access.
- Under Set permissions, click Add user to group and select the group that you created in the steps above.
- Review your user details and click Create user at the bottom of the page.
- After you create the user, a Success window appears with the IAM user Access key ID and Secret access key.
- Take note of these values, you'll need them when you add the Amazon Comprehend Scope activity to your projects.
- For more information about your access keys, see Managing Access Keys for IAM Users in the AWS documentation.
- Create a new automation project.
- Open UiPath Studio.
- Under New Project, click Process (this opens a New Blank Process window).
- Enter a project Name, Location, and Description.
- Install the UiPath.Amazon.Comprehend.Activities package.
- In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
- Under All Packages, click Go!
- In the Search bar, enter Comprehend.
- Click, install and accept the license for the UiPath.Amazon.Comprehend.Activities.
- For more information about Uipath Studio packages, see Managing Packages in the Studio Guide.
Now that you have completed the setup, you can start adding the Amazon Comprehend activities to your project.
To learn more about the Amazon Comprehend activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.