Microsoft Entra ID

Microsoft Entra ID is Microsoft’s cloud-based identity and access management service, which helps your employees sign in and access resources in:

  • External resources, such as Microsoft 365, the Azure portal, and thousands of other SaaS applications.
  • Internal resources, such as apps on your corporate network and intranet, along with any cloud apps developed by your own organization.

Microsoft Entra ID is a valuable source for discovery as it provides not only the ability to discover services and users but also can be leveraged to discover employee and department data.

Integration details

  • Integration categories:
    • Single Sign-on & CASB System
    • HRIS
  • Authentication mechanism:
    • API

Set up Microsoft Entra ID

Register new application in Microsoft Entra ID

  1. Sign in to the Azure portal (https://portal.azure.com/) with an Azure administrator account that is also a member of the Global Administrator directory role in your Microsoft Entra ID tenant.
  2. On the left navigation pane, click Microsoft Entra ID.

  1. On the Microsoft Entra ID page, click App registrations.
  2. On the App registrations page, in the toolbar on the top, click New registration.
  1. Register an application page opens, perform the following steps:
    1. In the Name textbox, type LeanIX SaaS Discovery Integration (it is just a label so it can be anything that will make you identify it relates to LeanIX integration).
    2. Under Supported account types select Accounts in this organizational directory only (Default Directory only - Single tenant)
    3. Click Register at the bottom of the screen.

Grant permissions to the application

  1. Now that we have the application we need to grant it permissions, in the left menu click API permissions
  2. Click Add a permission button.
  3. New configuration panel Request API permissions will display on the right, select the Microsoft Graph API, pick Application permissions and search for Application.Read.All.
  4. Click on the Add permissions button at the bottom to assign permission to the LeanIX application.
  5. Click on the Grant admin consent for Default Directory button to enable configured permissions for the application
  1. Next, click Yes to grant consent for the requested permissions.
  2. The permission status indicator in the API permissions page will change to approved.

Gather configuration settings

  1. Return back to the application overview section (App Registrations -> click on created app) from where you will need to grab the following identifiers: Application (client) ID and Directory (tenant) ID

    2. In the left menu - navigate to Certificates & secrets to generate a client secret, also referred to as the application password.
  2. Click on New client secret button to create a new password.
    1. Please choose the description for the secret (e.g. LeanIX SaaS Discovery Integration secret) or leave it empty
    2. Select the expiration length of the secret. Once the expiration date of the created client secret will be reached, you will have to create a new one and reconfigure the integration in LeanIX application.
    3. Click Add
  3. Copy the Secret Value to your clipboard.

🚧

Please make a note of the client secret value as soon as it is revealed. It will be masked when you navigate away from the Certificates & secrets panel.
This value needs to be added to LeanIX under Client Secret.

Pass configuration settings to LeanIX app

  1. Enter Directory (tenant) ID, Application (client) ID, and Client Secret into LeanIX page
  2. Click Integrate