Azure Storage Queue

Azure Storage Queue is a managed message queue service in Azure. You can connect a queue from your Azure Storage account to Edlink and Edlink will publish Feed Events to it. The following document details how to do this.

Create or Select Queue

Sign in to the Azure Portal and navigate to your Storage Account.

If you do not already have a storage account, create one. Then open the storage account and select Queues from the left sidebar.

Create a new queue or select an existing queue. If you already have a queue you use for accepting events, you can reuse it, but be sure that you can differentiate between events. Otherwise, create a new one.

Queue names must be lowercase, may contain letters and numbers, and must be between 3 and 63 characters.

Grant Edlink Permission to Send Messages

Edlink authenticates to your queue using an Azure service principal. You must grant that principal permission to add messages to your queue.

1. In the Azure Portal, open your storage account.
2. Select Access Control (IAM) from the left sidebar.
3. Click Add role assignment.
4. Select the Storage Queue Data Contributor role.
5. Assign access to User, group, or service principal.
6. Search for and select the Edlink service principal. Contact Edlink support if you need the service principal name or application ID.
7. Save the role assignment.

Alternatively, you can grant the role at the queue scope instead of the storage account scope if you prefer more limited access.

Create a Subscriber in Edlink

Copy the queue URL from the Azure Portal. The URL follows this format:

https://<storage-account-name>.queue.core.windows.net/<queue-name>

Navigate to the Edlink platform. Select the relevant application and click on the Data Feeds tab in the left sidebar. Click Create Subscriber in the top right. Select Azure Storage Queue as the feed type.

Enter the queue URL in the Queue URL field. Select the events you want to receive and set the state to Active, then click Create Subscriber.

You can also create an Azure Storage Queue subscriber via the API:

{
  "name": "My Azure Queue Subscriber",
  "type": "azure_storage_queue",
  "configuration": {
    "queue_url": "https://mystorageaccount.queue.core.windows.net/my-queue"
  },
  "state": "active",
  "events": ["integration.created", "person.login"]
}

Supported Regions

Azure Storage Queue is available in all Azure regions where Storage Accounts are supported. Ensure your storage account is in a region that meets your data residency requirements.