Microsoft Azure Active Directory

Azure Active Directory (Azure AD) 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.

Azure AD 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

Discovery Capabilities

Available entities

Entity description

Azure AD resource

New services

Service discovery is the process of automatically identifying services and applications. All discovered services are added to SMP automatically.

servicePrincipal

Users

Users represent all discovered people who use a specific SaaS.

auditLogs (signIns)

Employees

Employees are discovered to get a complete overview of all employees of an organization and enrich the data for each discovered user.

users

Departments

Departments represent the organisational structure of an organization relate to employees. This data is used to identify where in the organization which SaaS is used.

users

Set up Azure AD

Register new application in Azure AD

  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 Azure AD tenant.
  2. On the left navigation pane, click Azure Active Directory.
  1. On the Azure Active Directory page, click App registrations.
  1. On the App registrations page, in the toolbar on the top, click New application
    registration
    .
  1. On the Register an application page, perform the following steps:
  1. In the Name textbox, type LeanIX SMP.
  2. Under Supported account types select Accounts in this organizational directory only.
  3. Under the Redirect URI type https://si-oauth.leanix.net/oauth_cb/discover_integrations/azure_ad for the Web platform depending on the region of your LeanIX instance.
  4. Click Register at the bottom of the screen.

Grant permissions

  1. Next, we will configure the API permissions for the application.
  2. Click on API permissions to define a list of permissions for the application.
  1. On the API permissions page click Add a permission button.
  1. New configuration pane Request API permissions will display on the right, and select the Microsoft Graph API.
  1. In the next step, you will have to define which type of permissions the LeanIX SMP requires.

  2. Next, select the Application permissions option, search for directory, and in the Directory section check permission Directory.Read.All.
    Repeat the same for AuditLog.Read.All.

  1. Click on the Add permissions button at the bottom to assign permission to the LeanIX SMP application.
  1. Click on the Grant admin consent for Default Directory button to enable configured permissions for the application.
  2. Next, click Yes to grant consent for the requested permissions.
  1. The permission status indicator in the API permissions page will change to approved.

Gather configuration settings

Return back to the application overview section (App Registrations -> click on created app) from where you will need to grab the following identifiers:

  • Directory (tenant) ID
    You need these values when granting LeanIX access to your Microsoft Azure:

Next, navigate to Certificates & secrets to generate a client secret, also referred to as the application password. Click on New client secret button to create a new password.
Please select the expiration length of the password. Once the expiration date of the created client secret will be reached, you will have to create a new one and reconnect the service in LeanIX SMP.
The description field is optional.

Important note: 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 SMP under Client Secret.

Integrate Azure AD in LeanIX SMP

  1. Log in to LeanIX SMP. Navigate to Settings > Discover Integrations > Azure AD - click Add and enter settings.
  1. Enter Directory ID, Application ID, and Client Secret and click on Connect.

Did this page help you?