Tutorial: Configure Azure (SAS) for integration with Common Data Service

This walkthrough guides you through configuring the Azure Service Bus issuer, scope, and rules to allow a listener application to read the Common Data Service messages posted to the Azure Service Bus.

Note

This walkthrough applies to any Common Data Service deployment when using SAS authorization for Azure messaging. For more information about Azure Service Bus authorization, see Service Bus authentication and authorization.

You must use the Plug-in Registration Tool. To download the plug-in registration tool, see Download tools from NuGet.

Prerequisites

  • An Azure account with a license to create Service Bus entities.

  • A SAS configured service bus namespace.

  • A SAS configured service bus messaging entity: queue, topic, relay, or event hub.

  • The messaging entity must have the Send policy permission at a minimum. For a two-way relay, the policy must also have the Listen permission.

  • The authorization connection string of your messaging entity.

Define the Azure policy permissions

Refer to the Create a Service Bus namespace using the Azure portal for instructions on how to create a Service Bus namespace and messaging entity.

Create a service endpoint

A ServiceEndpoint Entity contains configuration data that is required for external messaging with a Azure Service Bus solution endpoint. By using the Plug-in Registration Tool, you can easily create a service endpoint entity in a Common Data Service organization and configure the service bus endpoint issuer, scope, and rules.

Register a Service Endpoint

  1. Run the Plug-in Registration Tool and log into your target Common Data Service organization.

  2. Select Register > Register New Service Endpoint.

  3. Check Let's Start with the connection string from the Azure Service Bus Portal and paste the connection string of your service bus messaging entity.

Provide authorization connection string

  1. Select Next.

  2. Fill out the Service Endpoint Registration form by entering the Designation Type, Message Format, and optionally the User Information Sent and Description fields

Service endpoint registration

For more information about the message format, see Write a listener application for a Azure solution.

  1. Select Save.

  2. After a few seconds or so, you will see the new service endpoint in the Registered Plug-ins & Custom Workflow Activities list.

New service endpoint

See also

Azure Integration
Azure Service Bus