Overview
By integrating Microsoft Intune, you can automate the addition and updating of devices. Device information from Microsoft Intune can be imported into Josys's Devices ledger, serving as the master data for your device registry.
Key Features
- Imports device information from Microsoft Intune into Josys's Devices ledger.
- Automatically imports devices from Intune as new devices if they do not match any existing devices in Josys.
- Visualizes information from Microsoft Intune.
Importable Fields
For the following five fields, you can choose whether to prioritize the information from Microsoft Intune.
If Microsoft Intune is prioritized, the device registry in Josys will always be overwritten with the information from Microsoft Intune.
The five selectable fields are:
- Device Type
- Device Name
- Manufacturer
- Device Models
- OS
(The "Device Name" information will be populated in the "MDM Device Name" field under the Microsoft Intune section.)
Other Microsoft Intune Fields Retrieved
For devices synced with Microsoft Intune, the following fields will be displayed on the details page. These fields always prioritize the latest MDM values. If the integration with Microsoft Intune is disconnected, these fields will be removed from Josys.
| Field Name | Notes |
|---|---|
| Device Name | - |
| UUID | A unique ID automatically assigned to each device in Microsoft Intune |
| Enrolled Date/Time | The date and time the device was enrolled in Microsoft Intune |
| Last Check-in Date/Time | The last sync date and time between Microsoft Intune and the device |
| Primary User Email / UPN | The email address is prioritized; if empty, the UPN (User Principal Name) is retrieved |
| Disk Capacity | If the value is "0", it is treated as empty. The unit is GB |
| Enrollment Status | The enrollment state of the device. Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown. |
Integration Steps
1. Start the Integration
- Go to "Settings > External Data Sources" in the Josys left sidebar.
- Open the [IT Devices] tab and select Microsoft Intune.
- Click the Connect button.
2. Select the Integration
If you have integrated Microsoft Intune with multiple tenants or accounts, select which integration to use for syncing with the Devices ledger.
If you only have one integration, this page will not be displayed.
3. Select the Matching Key
Select the key to link devices in Josys with Intune devices. The following two fields can be selected as matching keys:
Microsoft Intune options:
- Serial Number
- Microsoft Intune UUID (Unique Device ID)
Josys options:
- Serial Number
- Asset Number
If the value set as the matching key matches between Josys and Microsoft Intune, they will be linked as the same device.
If they do not match, they will be treated as new devices, and new data will be registered from Microsoft Intune into Josys's Devices ledger.
4. Select the Asset Number Assignment Method
Intune devices that do not match existing devices in Josys using the specified matching key will be imported into Josys as new devices.
Configure the value to be assigned as the asset number. You can choose from the following two patterns:
- Use the value of a Microsoft Intune field as the asset number
You can select from the following fields:
- Device Name
- UUID
- Serial Number
- Set an auto-numbering rule
Set a prefix. After that, numbers will be automatically assigned sequentially starting from 1.
5. Configure User Assignment Settings
In Josys's Devices ledger, you can manage the "device user."
Reference: Assigning and Unassigning Devices
Through this integration, you can match the email address of the user assigned in Microsoft Intune with All Identities in Josys, and reflect them as the device user in Josys's Devices ledger.
During matching, Josys first checks the "Email" field in All Identities.
If no matching user is found by email address, it will also check against the "Alternate Email" field.
If you want to apply this, follow the steps below:
- Check the box for "Automatically assign devices to users."
- Select the email field to use for matching with All Identities. You can choose from Email or User Principal Name. (Alternate emails linked to users in Josys are also subject to matching.)
Devices that already have a user assigned in Josys will be overwritten with the user from Microsoft Intune.
If not applied, all changes and updates to the device user must be done within Josys.
6. Data Overwrite Settings
In Josys, you can select which fields to prioritize from Microsoft Intune among the synced items. The fields configured here will always overwrite Josys's Devices ledger with the information from Microsoft Intune.
The five selectable fields are listed below. Select the fields you want to overwrite:
- Device Type
- Device Name
- Manufacturer
- Device Models
- OS
7. Final Confirmation
Review your settings and complete the setup.
Screens After Integration
Details Screen
A section for Microsoft Intune fields is added at the bottom of the screen.
Device List Screen
"Source" and "Microsoft Intune Fields" will be available as display columns and filter options.
Syncing and Updating Device Information
- Josys matches MDM data with Josys data using the configured matching key.
- If matching data is found, Josys overwrites the information in the Devices ledger. If not found, it adds it as a new device.
Behavior After Disconnecting the Integration
If you disconnect the integration with Microsoft Intune, you can choose whether to delete the synced devices from Josys's Devices ledger or keep them in Josys.
If kept in Josys, the device source will change to "Josys," and all fields displayed under "Microsoft Intune Fields" will be removed from the screen.
If Data Is Not Syncing
Please try the following steps:
Account Permission Check 1: Verify in the Entra admin center, then reconnect the integration.
Account Permission Check 2: Run the API from MS Graph Explorer to check if data can be retrieved (refer to the steps in the file below), then reconnect.
Steps
- Access Graph Explorer.
- Log in with the account used for the Josys integration.
- Copy and paste the following URL and click "Run query": https://graph.microsoft.com/v1.0/deviceManagement/managedDevices
*If a permission error occurs, open the "Modify permissions" tab, click the [Consent] button, and grant the required permissions.
- Check if the device list can be retrieved as a result of the query, and contact us with the outcome.
Account Permission Check 3:
Go to Entra Applications > Enterprise Applications > Search for Josys > Permissions screen (displayed under the Admin Consent tab, or the User Consent tab if only the user account used for integration is allowed) > Verify the DeviceManagementManagedDevices.ReadWrite.All permission > Reconnect.
App Registration Check:
Go to Entra Applications > Enterprise Applications > Verify Josys app registration details (automatically registered at the time of integration) > If incorrect or if a different app is registered, correct it or delete the incorrect one (IDs must match) > Reconnect.
- App Name: Josys
- Application ID: 8101c315-0ba2-4e90-88e6-68616ec0f143
FAQ
What happens if there are duplicate matching keys on the Microsoft Intune side?
During data integration, the device first returned by Microsoft Intune will be linked to the device in Josys. Any subsequent devices will be created as new devices based on your asset number assignment rules.
What should I do if serial numbers do not match correctly and duplicate devices are accidentally created?
Since devices syncing with Microsoft Intune cannot be deleted, you should delete the device originally registered in Josys and use the device imported from Microsoft Intune.
You can easily transfer usage history by exporting and importing it via a CSV file.
What happens if I edit the serial number used as the matching key after the device is linked with Microsoft Intune?
After the initial sync and match, the device in Josys is assigned the UUID of the linked Intune device. Therefore, even if the matching key is edited, duplicate devices will not be imported again.
What happens if there is an asset number conflict (i.e., the asset number mapped from Microsoft Intune already exists in Josys)?
A new device record will be created with the prefix "SYS", and "SYS + sequential number" will become the asset number of the newly created device.
What happens if the asset number mapped from Microsoft Intune is blank?
If the asset number is blank, an asset number starting with "SYS + sequential number" will be generated.
If I delete a device in Intune, will it also be deleted from Josys's Devices ledger?
No, it will not be deleted from Josys's Devices ledger. The sync will be disconnected, and the device will remain in Josys as if it were manually registered.
If a device is deleted on the Intune side, what happens to its user assignment in Josys?
Even if the device is deleted on the Intune side, the user assignment in Josys will not be automatically removed.
I synced a device that has a user assigned in Microsoft Intune, but the user is not automatically assigned in Josys's Devices ledger. Why?
User assignments are only reprocessed during automatic sync in the following cases:
- When the "Last Check-in Date/Time" of the target device is updated on the Microsoft Intune side and becomes newer than the last sync time stored in Josys.
- When you force a sync (re-sync) on the Josys side.
Solution:
If you want to reflect user assignments after updating All Identities, please manually re-sync the integration from Integrations > External Data Sources, or perform a sync operation on the Microsoft Intune side for the target device to update its Last Check-in Date/Time before syncing.
Can I manually change the status of a device that is integrated with Intune?
・For devices with a user assigned on the Intune side:
The status is fixed to "In Use" and cannot be changed in Josys.・For devices without a user assigned on the Intune side:
The status in Josys will be "In Stock," and you can manually change it to "Disposed" or "Missing" in Josys.
(However, you cannot manually change it to "In Use." To assign a user and change the status to "In Use," you must perform the operation on the Intune side.)