Setting up an EventBridge integration

Create a Standard AWS SQS queue

1. Log in to the AWS Console.

2. Open Amazon SQS from the Services dropdown or the Services search bar at the top of the page.

3. Click Create queue.

4. Select Standard queue type.

5. Give your SQS queue a name, and click Create queue.

6. Make note of the ARN of the newly created queue.

Contact your Rightsline representative

1. Provide them with your AWS Account ID and the AWS region that you would like to set up your EventBridge integration.

2. Your Rightsline representative will provide you with your AWS EventBridge event source name. You will use this name to create your AWS EventBridge event bus.

Create an AWS EventBridge event bus (AWS CLI)

Because the event bus name has to start with aws.partner/rightsline.com/ it cannot be created in the UI. You must create your AWS EventBridge event bus via the AWS CLI. To do so, run the following commands:

aws events create-event-bus --name aws.partner/rightsline.com/{{EVENT_SOURCE_NAME}} --event-source-name aws.partner/rightsline.com/{{EVENT_SOURCE_NAME}} --region {{REGION}}

At this point the remainder of the setup can continue to be done via the CLI or you can scroll down to see how it can be set up in the Console.

In the above command, replace {{EVENT_SOURCE_NAME}} with the event source name provided by Rightsline in the second section above. Replace {{REGION}} with the desired region provided to Rightsline in the second section above.

aws events put-rule --cli-input-json file://rule.json --region {{REGION}}

In the above command, replace {{REGION}} with the desired region provided to Rightsline in the second section above. The file://rule.json file must exist in the directory you are running the command. The file should look like the following:

rule.json

{
    "Description": "Rule Description",
    "EventBusName": "aws.partner/rightsline.com/{{EVENT_SOURCE_NAME}}",
    "EventPattern": "{\"source\": [{\"prefix\": \"aws.partner/rightsline.com/{{EVENT_SOURCE_NAME}}\"}]}",
    "Name": "Rule Name",
    "State": "ENABLED"
}

In the above command, replace {{EVENT_SOURCE_NAME}} with the event source name provided by Rightsline in the second section above.

aws events put-targets --cli-input-json file://targets.json --region {{REGION}}

In the above command, replace {{REGION}} with the desired region provided to Rightsline in the second section above. The file://targets.json file must exist in the directory you are running the command. The file should look like the following:

targets.json

{
    "Rule": "Rule Name",
    "EventBusName": "aws.partner/rightsline.com/{{EVENT_SOURCE_NAME}}",
    "Targets": [{
            "Id": "1",
            "Arn": "{{SQS_QUEUE_ARN}}"
        }
    ]
}

In the above command, replace {{EVENT_SOURCE_NAME}} with the event source name provided by Rightsline in the second section above. Replace {{SQS_QUEUE_ARN}} with the SQS queue ARN from the first section above.

Create an AWS EventBridge Rule (Console)

Once the steps above have been completed to create the event bus via the CLI, the Rule setup can happen in the console as follows:

1. Open Rules in the left sidebar menu.

2. Select your new Event bus from the dropdown, and click Create rule.

3. Give your rule a name, and make sure Rule with an event pattern is selected. Click Next.

4. Under Event source, select AWS events or EventBridge partner events.

Rightsline event source

10. Under Event pattern, select EventBridge partners, and select Rightsline as the partner. For Event type, select All Events. Click Next.

Rightsline event pattern

11. Under Target 1, select AWS service, SQS queue, and the queue name created from the first section. Click Next.

12. Add any relevant Tags. Click Next.

13. Click Create Rule.