barscaret-downcaret-leftcaret-rightcaret-upcheckchevron-leftchevron-rightfile-pdfinfosign-in-altsignin text-widthtimesyoutube

API & Integrations > Integrations

Connecting Miradore to Microsoft Entra ID

Updated on June 13th, 2024

To benefit from using automated workflows, Miradore provides you the ability to integrate with Microsoft Entra ID.

  1. Navigate to System > Integrations. The Integrations page is displayed, where you can get a list of all available applications or you can filter the list for applications that are already connected to Miradore.
  2. Select Microsoft Entra ID. The Microsoft Entra ID page is displayed where you can select the General or the Workflows tab. If you have not created the connection, the General tab is displayed by default.
  3. Click Connect. The Microsoft Entra ID connection page is displayed.
  4. Navigate to Azure and enable the integration between your Miradore site and Microsoft Entra ID. To enable the integration, you need to register an application for Miradore in Azure. For more information, see the Registering an application to integrate Miradore with Microsoft Entra ID subsection.
  5. Provide the required credentials of the registered Miradore site and after that click Connect. You can get the values for the required credentials when registering your Miradore site with Microsoft Entra ID.

Provide the following credentials:

      • Client ID (shown as Application (client) ID in Entra ID)
      • Client secret (shown as Directory (tenant) ID in Entra ID)
      • Tenant (shown as Value, not Secret ID, in Entra ID)

Result: Microsoft Entra ID is connected and ready to be used. The connected status is shown on the Integrations page in Miradore.

Registering an application to integrate Miradore with Microsoft Entra ID

Registering an application establishes trust between Miradore and Microsoft Entra ID.

Prerequisites

  • Admin account on Azure
  • Miradore Premium+ subscription
  1. Register an application in Azure to integrate Miradore with Microsoft Entra ID. When the registration is ready, copy the Client ID and Tenant information from the Overview pane, as you will need them to set up the connection in Miradore. For more information, see subsection Registering an application in Azure.
  2. Set the application permissions. For more information, see subsection Defining permissions for an application in Azure.
  3. Generate a client secret for the application. Copy the client secret value, as you will need it to set up the connection in Miradore. For more information, see subsection Generating a client secret in Azure.

Registering an application in Azure

  1. Log in to Azure at https://portal.azure.com/ as an admin.
  2. Navigate to Microsoft Entra ID. For example, on the Manage Microsoft Entra ID tile, select View.
  3. Select App registrations.
  4. Select New registration.
  5. Define a name for your application, which will be the user-facing name for your app.
  6. In Supported account types, select Accounts in this organizational directory only.
  7. Select Register.

Note: The Overview page contains the details of your registered application. Copy the Application (client) ID and the Directory (tenant) ID, as you will need them to create the connection in Miradore.

Learn more about registering your application.

Defining permissions for an application in Azure

Prerequisite: You have performed the procedure listed in subsection Registering an application in Azure.

  1. In Azure, navigate to the App registrations resource.
  2. In the left navigation menu, select API permissions.
  3. Select Add a permission.
  4. To open the permission interface, select Microsoft Graph.
  5. Select Application permissions.
  6. Under User, select User.Read.All.
  7. Select Add permissions. Note: You need admin permissions to grant the User.Read.All permission to your application.
  8. Select Grant admin consent for Default Directory. Note: You need admin permissions to perform this step.

The status of the user permission is modified to Granted for Default Directory.

Generating a client secret in Azure

Prerequisite: You have performed the procedure listed in subsection Registering an application in Azure.

  1. In Azure, navigate to the App registrations resource.
  2. In the left navigation menu, select Certificates & secrets.
  3. On the Client secrets tab, select New client secret.
  4. In Description, define the name, and in Expires, define the expiration date for the secret. The secret is generated.
  5. Using the clipboard icon, copy the value of the secret, as you will need it to create the connection in Miradore. Note: Take care to copy the value of the secret, not the ID of the secret.

Learn more about creating a client secret.

Previous Article:
«

Next Article:
»