Install Azure integration

Azure configuration

To install Microsoft Azure integration:

Step 1: Get Subscription ID and Offer ID

1. Log in to the Azure portal.

2. Click Subscriptions.

3. From the list of subscriptions, click the subscription name.

4. From the subscription details page, copy the Subscription ID and Offer ID on a text editor such as Notepad.

   You need Offer ID to allow OpsRamp to collect cost analytics.

   

Step 2: Register an application in Azure Active Directory (AAD)

1. Select Azure Active Directory.

2. Check applicable permissions to create an application in Azure Active Directory. For instructions, see the Microsoft documentation on Check Azure Active Directory permissions.

3. Register an AAD application.
   For instructions, see Register an application with Azure AD.

   OpsRamp supports OAuth 2.0 as authentication method for App registration.

4. Assign a role to the registered application. For instructions, see Assign a role to the application.

Step 3: Get Tenant ID, Client ID and secret key

1. Select Azure Active Directory.

2. On the left pane, click App Registrations.

3. From the list of applications, click the application name. The details of the application are displayed.

4. Copy the Client ID (Application ID) and save it to a text editor such as Notepad.

5. Copy the Tenant ID (Directory ID) and save it to the text editor.

   

6. On the left pane, click Certificates & secrets > New Client Secret. For details, refer to Create a Client secret.

7. Enter the description, expiry time and click Add.
   The Client secret is displayed.

8. Copy the value of the Client secret in a text editor. Copy the secret value and store it safely because you cannot retrieve it later.

You now have the subscription ID, Tenant ID, Client ID and Client secret key. Use these details to install Azure integration on the OpsRamp console.

OpsRamp configuration

After you have copied all the details from your Azure account, use the details to install Azure integration on the OpsRamp console.

To install Azure integration:

1. Go to Setup > Integrations and Apps. If apps are already installed, the INSTALLED APPS page is displayed, else the AVAILABLE APPS page is displayed.

2. Search for Azure app using the search option. You can also use the All Categories dropdown and select the appropriate public cloud category.

3. Click ADD. The Add Azure page is displayed.

   

4. Provide the details in the fields:

   • Name: Provide a suitable name for the integration.
   • Subscription ID: Enter the subscription ID.
   • Enter the Tenant ID, Client ID and Secret key.
   • Environment: Choose Azure.
     
     

5. Click NEXT.

6. In the Filter page, you will have two ways to filter:

   • Filter by Resource Tag
   • Filter by Resource Type

Filter by Resource Tag

• Choose ALL or ANY to match any one or all of the defined conditions for filtering.
• Provide the following details:
  • Key: Add the input key
  • Operator: Select a operator from the drop down list
  • Value: Value corresponding to the attribute name and logical condition.

Filter by Resource Type

• Choose ALL or SELECT to match any one or all of the defined conditions for filtering.
  • ALL: If you choose ALL, means all existing and future resources will be discovered.
  • SELECT: Select the required resource types from the list.

1. Click NEXT.
2. Select the actions to be performed on the resources.
   • Manage Device: Select this option such that all the discovered resources are in a managed state.
   • Collect Cost Analytics: Select this option to collect projects cost details resources utilized and enter the Azure billing Offer ID.
   • Stream Azure Events: Provide Azure connection string-primary key. See instructions for configuring connection string.
   • Assign Gateway Management Profile: Select a gateway management profile from the drop-down list.
     
     
3. Click Install Agent (Linux only) if the agent needs to be installed on the device and select the device credentials.
   Select Agent Type as Direct or Proxy.
   If you select Proxy, then select a gateway management profile from the drop-down list.
4. Select the Discovery Schedule option to schedule a discovery and define the preferred Recurrence pattern.
5. Click FINISH. The Azure app is installed.

   

   All the discovered services are visible in the Infrastructure page under
   Resources > Azure
6. Click Azure. The list of installed Azure integrations are displayed. You can perform actions like Edit, Uninstall, Rescan.