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.

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.

    screen readers look here
  5. In the “Register an application” page, fill in the following fields:
    • Name: pushbot-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.

    screen readers look here
  7. After the app registers, select it on the app registrations page.

    screen readers look here
  8. Select API permissions in the left side bar.
  9. Select Add a permission in the panel that opens up.

    screen readers look here
  10. Scroll down, and select Dynamics from the list of available APIs.

    screen readers look here
  11. Select Delegated permissions
  12. Scroll down, and select Directory.ReadWrite.All
  13. Select Add permissions

    screen readers look here
  14. Select Certificates & Secrets in the left side bar
  15. Give the secret a description, such as: catalyticsecretkey.
  16. Set Expires to Never
  17. Select Add

    screen readers look here
  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.

    screen readers look here

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.

screen readers look here

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. Select your photo or profile icon in the top right corner and select Integrations.
  2. Select the Add an Integration button in the top right corner.
  3. Select the Azure Active Directory integration then select Add this Connection.
  4. 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.
  5. Enter the Resource for your Azure Active Directory.
  6. Enter the Tenant ID for your Azure Active Directory. For details on finding this, see How to find your Client ID and Tenant ID.
  7. Set the integration permissions if necessary.
  8. Select Connect.