The Server-Side Events API allows you to receive data via Amazon AWS.
This API is accessed via a subscription from a valid AWS Endpoint to one of the API Topics.
Currently we only support AWS Endpoints of type SQS or Lambda.
Before you can set up an SQS queue and/or Lambda trigger you must complete the necessary steps to prove your identity with AWS.
Assuming you do not already have an AWS account:
Further information regarding IAM Users:
https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html
Consult the AWS SQS Developer Guide for further info:
https://docs.aws.amazon.com/sqs/index.html
Note: Ensure you have attached the permission policy, AmazonSNSFullAccess, to the IAM User.
IAM users should have the SNSFullAccess permission enabled to be able to manage SNS queues.
Click Subscribe to Amazon SNS topic to continue.
The Subscribe to SNS topic form:
Choose one of the following ARNs:
Note: Always specify the ARN as specified. Using a wildcard i.e., “*” will result in no messages being delivered to the queue.
Click the Save button to continue. You should see the confirmation that the action was successful:
Verify the SQS Queue subscription has been added to the Topic:
Please contact MetDesk so we can authorise your IAM User and SQS Queue for access.
We will need to know the ARN for both e.g.
IAM User: arn:aws:iam::512410112332:user/test
SQS Queue: arn:aws:sqs:eu-west-2:512410112332:test
You must verify your subscription as per the documentation:
https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-crossaccount.html#SendMessageToSQS.cross.account.notqueueowner
The owner of the subscription endpoint needs to explicitly opt-in and confirm the subscription by replying to the confirmation message sent by Amazon SNS.
On the queue page, click the Send and receive messages button
The Send and receive messages page appears. Scroll to the bottom and click the Poll for messages button.
The page will show that messages are being found and also the status:
Congratulations, you have created the SQS Queue!
Integration into other systems can be achieved by polling the Queue programmatically.
This section assumes you have a working SQS setup as described in the earlier section.
You can use an AWS Lambda function to process messages in an Amazon Simple Queue Service (Amazon SQS) queue.
Connecting the Lambda function to the SQS is achieved via the Lambda Triggers option on the Queue Edit page:
Click the Configure Lambda Trigger Function button
Select your Lambda Function and Save to return to the Queue.