Rekognition connector

The Rekognition connector uses the Amazon Rekognition service to identify and label the objects in JPEG and PNG files that are less than 15mb in size.

The implementation value of the Rekognition connector in a service task would be similar to the following:

<bpmn2:serviceTask id="ServiceTask_2tfy1pr" implementation="rekognitionConnector.LABEL" />

Amazon Web Services (AWS) configuration

The Amazon Rekognition API that is called is the Detect Labels API.

The Rekognition connector requires an AWS account to access Amazon features. It also requires an Identity and Access Management (IAM) user to have the rekognition:DetectLabels permission.

Files between 5mb and 15mb are uploaded to an Amazon S3 bucket before processing. The IAM user configured previously requires access to this bucket, as does the Rekognition service itself.

Input parameters

The following are the parameters that can be passed to the Rekognition connector as input parameters using the LABEL action:

ParameterDescriptionTypeRequired?
nodeIdThe node ID of the image to use from Alfresco Content ServicesString*
uriThe URI of the image to useString*
filesA file uploaded in a process and set as a process variable or uploaded as part of a form or another connectorFile*
maxLabelsThe maximum number of labels returned by the service. The default value is 10IntegerNo
confidenceLevelThe minimum confidence level to use for a label. The default is 0.75StringNo
timeoutThe timeout period for calling the Rekognition service in millisecondsIntegerNo

* Only one of these parameters is required.

Output parameters

The following are the parameters that are returned to the process by the Rekognition connector as output parameters using the LABEL action:

ParameterDescriptionType
awsResultThe result of the image analysis from the the Rekognition serviceJSON
aisResponseThe result of the image analysis in Alfresco Intelligence Service formatJSON
labelsA list of the labels identified by the Rekognition serviceJSON
analysis.errorA list of errors if any are caught by the connectorString

Configuration parameters

Values for configuration parameters that are specific to a connector instance can be set in the modeling application or during application deployment.

The following are the configuration parameters that need to be set for the Rekognition connector:

ParameterDescriptionRequired?
AWS_ACCESS_KEY_IDThe access key to be used to authenticate against AWSYes
AWS_SECRET_KEYThe secret key to be used to authenticate against AWSYes
AWS_REGIONThe region of AWS to use the Rekognition service inYes
AWS_S3_BUCKETThe name of the S3 bucket to useYes
ALFRESCO_CONTENT_REPO_BASE_URLThe base URL of the Content Services deployment

© 2023 Alfresco Software, Inc. All Rights Reserved.