Configure Azure integration with Microsoft Dynamics 365

 

Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Microsoft Dynamics 365 (online & on-premises) are capable of posting the message request data for the current core operation to cloud hosted applications listening on the Microsoft Azure Service Bus. To enable this capability in Microsoft Dynamics 365, perform the tasks detailed in this topic.

These tasks are expanded upon in this topic. After configuring Microsoft Dynamics 365 and Microsoft Azure integration, you will need to perform these additional tasks.

  1. Write and register a listener application with a Microsoft Azure Service Bus solution endpoint. For more information, see the Microsoft Azure Service Busdocumentation.

  2. Register a Microsoft Azure aware plug-in or a Microsoft Azure aware custom workflow activity with Microsoft Dynamics 365. More information: Walkthrough: Register an Azure-aware plug-in using the Plug-in Registration Tool

  3. Perform the necessary Microsoft Dynamics 365 operation that triggers the plug-in or custom workflow activity to run.

If all of the preceding steps were performed correctly, a message containing the Microsoft Dynamics 365 data context should be sent to a Microsoft Azure queue or topic and ultimately received by the listener application. You can navigate to the System Jobs grid in the Microsoft Dynamics 365 web application and check the status of the related System Job to see if the post to the Microsoft Azure Service Bus succeeded. In case of errors, the message section of the System Job displays the error details.

For more information, see the See Also links at the end of this topic.

Microsoft Dynamics 365 (online) users can download a public certificate from the web application by going to Settings > Customizations > Developer Resources. On that page, click the Download Certificate link below Microsoft Azure Issuer Certificate to download and save the public certificate. In addition, write down the issuer name because you’ll need it later.

For Microsoft Dynamics 365 on-premises and IFD installations, you can purchase a private certificate from an issuing authority. Import the certificate file into the Personal\Certificates store on your computer using the certificate Microsoft Management Console (MMC) snap-in. Next, export a public key file of your certificate in Base64 format. This public certificate will be used in the next task. For more information, see the MMC Help.

For Microsoft Dynamics 365 on-premises and IFD deployments, configuring the server for Microsoft Azure integration involves storing the public certificate in the Microsoft Dynamics 365 configuration database and setting the proper security access to the certificate so Microsoft Dynamics 365 can read it. Microsoft Dynamics 365 (online) comes pre-configured to work with Microsoft Azure.

Refer to the topic Walkthrough: Configure Dynamics 365 for integration with Microsoft Azure for step-by-step instructions on configuring Microsoft Dynamics 365 integration with the Microsoft Azure platform.

System_CAPS_security Security Note

For the Microsoft Dynamics 365 and Microsoft Azure Service Bus integration feature to work, the Microsoft Dynamics 365 asynchronous service must have access to the Internet through the server’s firewall. The server where the Asynchronous Service role is installed must be exposed to the Internet, and the account that the service runs under must have Internet access. Only outbound connections on ports 80 and 443 are required. Inbound connection access is not required. Use the Windows Firewall control panel to enable outbound connections for the CrmAsyncService.exe application located on the server in the %PROGRAMFILES%\Microsoft Dynamics CRM\Server\bin folder.

Regardless of whether you use ACS or SAS for authorization, you need to configure the rules and issuers of your Microsoft Azure solution to allow a listener application to read the Microsoft Dynamics 365 message posted to the Microsoft Azure Service Bus. In addition, you must configure the service bus rules to accept the Microsoft Dynamics 365 issuer claim. The recommended method to configure Azure is to use the Plug-in Registration Tool in the SDK download.

For instructions on configuring authorization seeWalkthrough: Configure Microsoft Azure (ACS) for integration with Dynamics 365 and Walkthrough: Configure Microsoft Azure (SAS) for integration with Dynamics 365.

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

Show: