Adding an Azure subscription to BizTalk360
  • Updated on 17 Dec 2018
  • 4 minutes to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Adding an Azure subscription to BizTalk360

  • Print
  • Share
  • Dark
    Light

In this article, we will explain the steps you need to follow to get the Azure Subscription details such as Client Identifier, Tenant Identifier, Application Secret Key, and the Publish Settings file from Azure.

Let's assume you are trying to connect BizTalk360 with Azure Active Directory. We will explain the detailed process of adding BizTalk360 to the Active directory and retrieving the subscription details.

This process consists of the following steps:

  • Adding BizTalk360 to Active Directory and retrieving the subscription details
  • Retrieving the Publish Settings File
  • Adding the Azure Subscription details to BizTalk360

Adding BizTalk360 to Active Directory & retrieving the subscription details

  1. Log into the new Azure Portal

  2. Click Azure Active Directory from the left navigation menu. Select "App registrations" from the list

f9843d2a-b730-4059-8737-e4e3cac54929.png

  1. Click “New application registration”, to add BizTalk360 as an application into your Azure Active Directory

  2. Enter a Name for the application that you want to add to the Azure Active Directory. Ex: BizTalk360. Choose the Application Type as “Web app / API”

  3. Enter the Sign-On URL (the URL where the users can sign-in and use the application) and App ID URI (a unique URI that Azure AD can use for this application). This URL can be changed later. For now, http://localhost/BizTalk360 will do

Create'.png

  1. Click the Create button to add the new application

  2. Once the application is created, copy the Application ID (Application Identifier) in the portal, which will be applied as a Client ID (Client Identifier) in BizTalk360

Application ID.png

  1. Select Settings and then Keys. Under the Passwords section, choose the duration of the validity of the keys (say, 1 year or 2 years). The key will be displayed only once when you save the application configuration. This is the Application secret key . Copy this value too

75c19c18-3b6b-42de-9247-23cb16586084.png

16732cf3-ce7c-4591-ae41-b1c05fd2065d.png

  1. For Tenant Id, select Properties of Azure Active Directory and copy the Directory ID

10f08b65-5b22-4b22-9e87-25d68db7f53a.png

  1. By now, you should have copied the 3 different keys that are required to add the Azure subscription to BizTalk360

Retrieving the Publish Settings File

In addition to retrieving the Client identifier, Tenant identifier, and Application key from the new Azure Portal, you also need to retrieve the Publish Settings (subscription) file. This file will contain the secure credentials and additional information about the subscription that you can use in the development environment. To download the publish settings file, you need to do the following:

  1. Install Azure PowerShell

  2. Sign in to the Azure Management Portal

  3. Open the Azure PowerShell console as an Administrator as follows:

  • Choose Start, in the Search box, type Azure PowerShell
  • Right-click the Azure PowerShell link, and then choose Run as Administrator
  1. At the command prompt, type the command “Get-AzurePublishSettingsFile”, and then press Enter

Another way is by using the link http://go.microsoft.com/fwlink/?LinkID=294709 which will directly take you to the download location.

GenerateSettings.png

PublishSettings.png

Adding the Azure Subscription details to BizTalk360

In this section, let us look at the process of adding an Azure subscription (with the Client Identifier, Tenant Identifier, and Application Secret key information) to BizTalk360.

  1. Log into BizTalk360 (as a Super User). Click the Settings icon at the top of the screen. Navigate to Monitoring and Notification > Manage Azure Subscriptions

Monitoring_Notification.png

  1. Click Add Azure Subscription. In the Azure Subscription Details page, you will see the below fields:

AddAzure.png

EnablePermission.png

  1. Friendly Subscription Name - You can enter a friendly name for the subscription that you are adding to BizTalk360

  2. Choose Environment - You can select the environment for which you want to add the Azure subscription

  3. Tenant Identifier - The identifier that authorizes and provides single sign-on and directory access for the application that you integrated with Microsoft Azure AD

  4. Client Identifier - The unique identifier for the application you integrated with Azure AD

  5. Application Secret Key - To be able to have BizTalk360 read and/or write data in Microsoft Azure AD, you need to enter the application key

  6. Publish Settings File - A simple XML file with the subscription details and the management certificate for authenticating the management API requests. You can download the Publish Settings file by clicking the link. You need to add this file to validate the Azure subscription details (in addition to the previously entered details in Step 3, 4, 5)

  7. Enable Subscription for Monitoring - You need to toggle the icon to the Active state to enable the subscription for monitoring with BizTalk360. If you disable the toggle icon, you will notice the Monitoring Availability status as Not Available

  8. Validate - Click the button to validate the entered subscription details. You will be prompted to copy a command and execute this in PowerShell. Please refer to the steps in this article to view the process of enabling the permission for BizTalk360 to access the Azure subscription

  9. Done - Once you have successfully executed the command in PowerShell, click Done. You will notice the confirmation message as "You have successfully validated the configurations. Click Save to start monitoring the Azure Resources"

If the PowerShell execution did not happen as expected or if you clicked Done without performing the PowerShell operation, you will notice an error message as "Azure PowerShell command not executed properly. Try to execute the command successfully and click Done." The Validate button will change to Validated and will be in the disabled state. For further information about the process of executing the PowerShell command, please click the Need Help link.

  1. Save - Click Save to save the Azure subscription details

Domains to be allowed to Add an Azure subscription to BizTalk360

Please allow/check the below domains and to configure the Azure portal in BizTalk360.

https://management.core.windows.net
https://login.microsoftonline.com
https://login.windows.net
https://management.azure.com

Was this article helpful?