Adding an Azure subscription to BizTalk360
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
Log into the new Azure Portal
Click Azure Active Directory from the left navigation menu. Select "App registrations" from the list
Click “New application registration”, to add BizTalk360 as an application into your Azure Active Directory
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”
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
Click the Create button to add the new application
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
- 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
- For Tenant Id, select Properties of Azure Active Directory and copy the Directory ID
- 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:
Install Azure PowerShell
Sign in to the Azure Management Portal
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
- 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.
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.
- 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
- Click Add Azure Subscription. In the Azure Subscription Details page, you will see the below fields:
Friendly Subscription Name - You can enter a friendly name for the subscription that you are adding to BizTalk360
Choose Environment - You can select the environment for which you want to add the Azure subscription
Tenant Identifier - The identifier that authorizes and provides single sign-on and directory access for the application that you integrated with Microsoft Azure AD
Client Identifier - The unique identifier for the application you integrated with Azure AD
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
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)
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
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
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.
- 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.