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.
- 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 the App registrations from the list
3. Click “New Application registration” to add BizTalk360 as an application into your Azure Active Directory.
4. 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”.
5. 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 later be changed. For now, http://localhost/BizTalk360 will do.
6. Click the Create button to add the new application.
7. 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 the BizTalk360.
8. Select Settings and next 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 you save the application configuration. This is the Application secret key. Copy this value too.
9. For Tenant Id, select the properties of Azure Active Directory and copy the Directory ID.
10. 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,
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
4. 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.
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
2. Click Add Azure Subscription. In the Azure Subscription Details page, you will see the below fields:
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 in PowerShell. Please refer to the steps in this article to see 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.
10. Save - Click Save to save the Azure subscription details
The Azure subscription details will be updated on the Manage Azure Subscriptions page.