Azure Active Directory Integration Setup Guide

Azure Active Directory is an identity and access management cloud solution from Microsoft.

Integrations can only be set up by Admin users and are enabled per team. See our General Integration Information page for an overview of integrations and some recommendations when configuring new integrations.

Required Setup

Configuring the Azure Active Directory integration requires your Azure Active Directory clientID, clientSecret, Resource, and Tenant information. Set up will require a Microsoft login and password from an Azure admin.

Before setting up the integration, walk through the steps below for How to create the Client Secret and How to find the Client ID and Tenant ID.

How to create the Client Secret

1. Start from your Microsoft Azure Portal at https://portal.azure.com.
2. Select Azure Active Directory on the left sidebar.
3. Select App registrations in the panel that opens up.

4. Select New registration at the top of the new panel.

   

5. In the “Register an application” page, fill in the following fields:
   • Name: workflow-activedirectory-integration
   • Supported Account Types: Accounts in this organizational directory (Single Tenant)
   • Redirect URI: https://security.pushbot.com/oauth

   💡   Tip: Make sure the Redirect URI drop-down stays set to Web

6. Select Register.

   

7. After the app registers, select it on the app registrations page.

   

8. Select API permissions in the left side bar.

9. Select Add a permission in the panel that opens up.

   

10. Scroll down, and select Dynamics from the list of available APIs.

    

11. Select Delegated permissions
12. Scroll down, and select Directory.ReadWrite.All

13. Select Add permissions

    

14. Select Certificates & Secrets in the left side bar
15. Give the secret a description, such as: pagerdutysecretkey.
16. Set Expires to Never

17. Select Add

    

18. At the bottom of the next page, the Client Secret is revealed. This key is only shown once, so copy it before leaving the page.

    

How to find the Client ID and Tenant ID

With the app registered, select Overview in the left sidebar. The Client ID is shown next to the display name.

Create Integration

The following instructions are for creating an integration for the first time. If you already have a connection, select the integration and select Add a Connection, or see How to create a new connection for an existing integration.

1. Open the overflow menu in the top navigation bar, and select Admin.
2. Select Integrations at the bottom of the page.
3. Select the Add an Integration button in the top right corner.
4. Select the Azure Active Directory integration then select Add this Connection.
5. Fill in the details. Enter the Client ID and Client Secret for your Azure Active Directory. For details on finding these, see How to create the clientSecret and How to find your Client ID and Tenant ID.
6. Enter the Resource for your Azure Active Directory.
7. Enter the Tenant ID for your Azure Active Directory. For details on finding this, see How to find your Client ID and Tenant ID.
8. Set the integration permissions if necessary.
9. Select Connect.