• Get started
  • Documentation
Products
Get started
Documentation
Resources
Atlassian Support
/
Jira Service Management
/
Resources
/
Connect, cleanse, reconcile data with Assets Data Manager
/
Learn about Adapters
Cloud

Data Manager - InTune Adapter

Assets Data Manager for Jira Service Management Cloud is a Premium and Enterprise only feature that is currently in Open Beta development. View and vote on our list of upcoming features.

If you find a bug or have questions, please reach out to Atlassian Support or the Atlassian Community.

Introduction

InTune is a tool produced by Microsoft that is used for Systems Management and Patching.

InTune Adapter uses an API connection to bring data into Assets Data Manager.

How do I connect this tool to Assets Data Manager?

This task requires Data Manager Adapters admin permissions to complete. See how permissions and roles work in 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 InTune Fields section - this may require consultation with the subject matter expert (SME) for InTune.

  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 InTune:

    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 ensure the endpoints are available.

    3. Review the Fields Retrieved section to ensure that the required fields are available.

Each time this job is run, the data your 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.

InTune Fields

You will need to specify the following information from InTune:

  1. Tenant-ID - A unique identifier that identifies the Azure AD tenant to use for authentication.

  2. Client-ID - A unique identifier to identify the Microsoft Intune application in Azure AD.

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

  4. API Timeout - the amount of time that can pass before the service times out.

API Timeout

An API Timeout occurs if the service takes longer than expected to respond to a call. If a timeout occurs, it results in a ‘500 error’ status code with details about the timeout in the response. Timeouts are typically caused by one of two things:

  • the call involves too much data

  • there is a network or service issue 

The default value for this field is 0, but we recommend setting this field manually to a value of 9000.

If the data source server cannot handle this value, we recommend gradually lowering the API Timeout value to a minimum of 2000, or to consult the vendor documentation for further guidance.

  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.

By default, the API limit is set to 0 for the Adapter – meaning that there are no restrictions. However if connecting to a source that is heavily populated with data, the best practice is to limit the rate to 1000.

Authentication and Authorization

  1. Register the application using the Azure 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. Click on Add Permissions.

API Call

The API call for InTune is: Device.Read.All.

Fields Retrieved

The following fields are retrieved:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 Id EasDeviceId IsEncrypted Meid UserId EasActivationDateTime UserPrincipalName TotalStorageSpaceInBytes DeviceName AzureADRegistered Model FreeStorageSpaceInBytes ManagedDeviceOwnerType DeviceEnrollmentType Manufacturer ManagedDeviceName EnrolledDateTime EmailAddress Imei PartnerReportedThreatState LastSyncDateTime AzureADDeviceId ComplianceGracePeriodExpirationDateTime Iccid OperatingSystem DeviceRegistrationState SerialNumber Udid ComplianceState DeviceCategoryDisplayName PhoneNumber EthernetMacAddress JailBroken IsSupervised AndroidSecurityPatchLevel PhysicalMemoryInBytes ManagementAgent ExchangeLastSuccessfulSyncDateTime UserDisplayName OsVersion ExchangeAccessState WiFiMacAddress

Still need help?

The Atlassian Community is here for you.
Ask the Community
On this pageIntroductionHow do I connect this tool to Assets Data Manager?Data Manager FieldsInTune FieldsAuthentication and AuthorizationAPI CallFields Retrieved
CommunityQuestions, discussions, and articles