Amazon Rekognition is a machine learning service that allows you to add image and video analysis to your applications. This connector allows you to add the most popular Rekognition image processing capabilities to your OutSystems applications:

• Detect Moderation Labels

• Detect Personal Protective Equipment (PPE) in images, including:

  • Face covers (face masks)

  • Hand covers (gloves)

  • Head covers (helmets)

• Detect Text in photos and videos and convert it to machine-readable text

• Detect Faces to identify and return details on the 100 largest faces in an image

• Recognize Celebrities to reduce the time and effort needed to identify, tag, and organize content

• Detect Labels to identify entities (such as flowers, trees, and tables), events (such as weddings, graduations, and birthday parties), or concepts (such as landscape, evening, and nature)

• Compare Faces to compare a face in the source input image with each of the 100 largest faces detected in the target input image.

This component is based on the AWS SDK for .NET v3.

Requirements

To use this connector you must have:

• An AWS account, so you can use Amazon Rekognition

• An AWS access key (access key ID and secret access key)

All of the connector actions require an image file, which you can store in an S3 bucket. To use these capabilities, the AWS account must have permission to get objects from the specified bucket. If you choose to store the image file in an S3 bucket, you send the input parameter Image (Binary Data) as NullBinary().

See the AWS documentation for detailed information and instructions on getting started, developing, and working with Amazon Rekognition.

Authentication

To configure your connector to access Amazon Rekognition, you need the following information:

• The access key ID of your AWS access key

• The secret access key of your AWS access key

• The AWS Region of the service endpoint to which you want to connect. To reduce latency, choose a region close to your application server. See the API documentation for the list of region Names.

Use the above authentication information to fill in the AWSCredentials parameters in all of the public actions available in the AmazonRekognition_IS module. The OutSystems parameters are:

• AccessKey

• SecretKey

• Region

Each time you run an action from the connector, authentication in Amazon Rekognition follows this logic:

• If the AWSCredentials input parameter is passed (this parameter is mandatory), the parameter values are used to authenticate.

• If the values in the AWSCredentials input parameter are not set or are set incorrectly, this exception displays: “Invalid credentials to Amazon Rekognition service."

This logic is also visible in the ValidateCredentials action.