Data Manager - Entra ID Device Adapter

Introduction

Entra ID Device is a tool produced by Microsoft that is used for Systems Management.

Entra ID Device uses a API connection to bring data into Assets Data Manager.

How do I connect this tool to Assets Data Manager?

Follow this procedure to connect this tool to Assets Data Manager using the custom-built Adapter:

1. Gather all of the information listed in the Data Manager Fields section, such as the Name, Object class, Data Source Name, and Data Source Type.

2. Gather all of the information in the Entra ID Device Fields section - this may require consultation with the subject matter expert (SME) for Entra ID-

3. Within Data Manager:

   1. Create a new job by selecting the Adapter that matches your tool.

   2. Configure all of the required fields with the appropriate information.

4. Within Entra ID Device:

   1. Follow all of the steps listed in the Authentication and Authorization section to properly configure Authentication and Authorization.

   2. Review the information in the API Call section and fields retrieved.

   3. Review the Fields Retrieved section.

Each time this job is run, the data you have selected will be brought into Data Manager using the configured Adapter and become raw data.

Data Manager Fields

You will need to specify the following information from Assets Data Manager:

1. Name - the name of the Connection, visible as the job name in Adapters.

2. Object - the name of the Object Class you want to the data to be loaded into.

3. Data Source Name - the type of data being created; which is usually the tool name, e.g AD, Qualys etc. Note: This can be the same as Name.

4. Data Source Type - what type of data is the tool providing? For example, Assets, CMDB, user location and more. The default setting for Entra ID is Azure Directory.

Entra ID Device Fields

You will need to specify the following information from Entra ID Device:

1. Tenant-ID - a unique identifier that identifies the Entra ID tenant to use for authentication.

2. Client-ID - a unique identifier to identify the Microsoft application in Entra ID.

3. Client Secret - a secret string that the application uses to prove it's identity when requesting a token.

4. API Timeout - the Api Timeout restricts the number of fields returned from the source. By default, the API Timeout is set to 0 for Adapters.

1. API Limit - the Api Limit field allows the enforcement of the amount of request/quantity of data (or records) to be consumed by the Data Manager and transferred to the back-end staging database.

Authentication and Authorization

Use the standard procedure for Entra ID Devices:

1. Register the application using the Entra ID Portal to obtain the Tenant ID, Client ID and the Application ID.

2. Generate the Client Secret to obtain the Client Secret ID.

3. On the application's Overview page, under Manage, select API Permissions > Add a permission.

4. Select Microsoft Graph from the list of available APIs. Then add the permission 'Device.Read.All' and grant admin consent.

5. Select Add Permissions.

API Call

The API call for Entra ID Device is: Device.Read.All.

Fields Retrieved

The following fields are retrieved: