Phidiax Tech Blog

Recently, we were tasked to update our client's BizTalk 2013 application to use AssureSign. One of the main steps is to enhance BizTalk to receive a notification from AssureSign once the document is signed. This blog is part of a 3-part series to accomplish integration between AssureSign and BizTalk utilizing Azure Services like Logic Apps to facilitate the transaction.

1. Part 1 - AssureSign - Integration between AssureSign DocumentTRAK and Azure Logic App, as well as Service Bus
2. Part 2 - AssureSign - Integration between Azure Service Bus and BizTalk Server
3. Part 3 - AssureSign - API Management

With the Classic Azure portal, we know that we can create an ACS Service Bus external endpoint to receive the notification. However, our client is moving away from Classic Azure portal. Therefore, we've decided to use a Logic App request action to create an external endpoint. We also created a SAS Service Bus endpoint with a queue to hold the message for BizTalk to consume.

High-level Architecture

In this part 1, we focus on the integration between AssureSign DocumentTRAK and Azure Logic App, as well as Azure Service Bus.

Create a notification message for the "Complete Document Transmission:"

We logon to the AssureSign web portal and navigate to the Notifications option (under the Administration tab) and then create the message for the "Completed Document Transmission".  We enter the dummy service endpoint (URL) and then we update it with the real URL later with the Azure Logic App request address. 

Create a SAS Service Bus with queue

We logon to the Microsoft Azure port and create an Azure Service Bus with one queue to house the incoming message.

Create Azure Logic App

While we're still on Microsoft Azure portal, we create a new Azure Logic App which consists of three steps (Request, Service Bus Send message, and Response).

Once the Azure Logic App is created. We save the URL under the Request step so that we can update the Service Endpoint of the Notifications message in the previous step on the AssureSign configuration.

Testing

Since there are lengthy steps to trigger a notification message form AssureSign, we used Postman to send a test XML message to the Logic App which will send the same message to Service Bus queue.

Validating your test result

We used Service Bus Explorer (SBE) to review the test message in the queue by right clicking on the queue name and selecting the "Receive Messages" option.  The input message in Postman is observed in Service Bus Explorer.

In the next part of this blog series, we will integrate between BizTalk Server and Azure Service Bus.

1. Part 1 - AssureSign - Integration between AssureSign DocumentTRAK and Azure Logic App, as well as Service Bus
2. Part 2 - AssureSign - Integration between Azure Service Bus and BizTalk Server
3. Part 3 - AssureSign - API Management