# JAMF

## Source

| Téléchargement                                 | Sources                               |
| ---------------------------------------------- | ------------------------------------- |
| <https://github.com/pluginsGLPI/jamf/releases> | <https://github.com/pluginsGLPI/jamf> |

***

## Requirements (self-hosted)

| Version GLPI | PHP minimum | Recommandé |
| ------------ | ----------- | ---------- |
| 10.0.x       | 8.1         | 8.2        |
| 11.0.x       | 8.2         | 8.4        |

{% hint style="info" %}
Ce plugin est disponible sans souscription [GLPI Network](https://services.glpi-network.com/#offers). Il est également disponible sur [GLPI Cloud](https://glpi-network.cloud).
{% endhint %}

***

## Features

The **Jamf Plugin** provides an integration between **Jamf Pro** and **GLPI**. It synchronizes Apple devices and their detailed metadata directly into your GLPI asset management system.

***

## Inventory Capabilities (Jamf → GLPI)

The plugin automatically maps Jamf Pro objects to native GLPI assets:

| Jamf Item Type           | GLPI Destination  | GLPI Object Type                                       |
| ------------------------ | ----------------- | ------------------------------------------------------ |
| **Computers**            | Computer          | `Computer`                                             |
| **Mobile Devices**       | Phone or Computer | `Phone` (iPhone/iPad) or `Computer` (Computer/AppleTV) |
| **Software**             | Software          | `Software` + `Version` + `Installation`                |
| **Extension Attributes** | Plugin Tables     | Searchable fields via GLPI engine                      |

#### Synchronized Data Points

* **Hardware & Network:** Model identifiers, UDID, Serial, Wi-Fi/Bluetooth MAC, and storage partitions.
* **OS Details:** Operating system name and precise versioning.
* **Financials:** Purchase orders, warranty dates, and AppleCare IDs (mapped to `Infocom`).
* **Security & State:** Activation Lock status, Supervision mode, and Lost Mode details.
* **User Mapping:** Automatic link to GLPI users based on Jamf `location.username`.

#### MDM commands

The plugin also allows users to issue MDM commands directly from the asset form in GLPI if the user has a Jamf account linked. The UI for MDM commands will adapt based on the user's Jamf permissions.

<table><thead><tr><th width="214">Command</th><th width="94" align="center">Icon</th><th>Summary</th></tr></thead><tbody><tr><td>Update Inventory</td><td align="center">📋</td><td>Forces the device to send its current inventory data to Jamf Pro.</td></tr><tr><td>Blank Push</td><td align="center">🔄</td><td>Sends an empty push notification to "wake up" the MDM communication.</td></tr><tr><td>Device Name</td><td align="center">✍️</td><td>Remotely renames the device (requires Supervised mode).</td></tr><tr><td>Update Location</td><td align="center">📍</td><td>Updates the GPS coordinates of the device (requires Lost Mode).</td></tr><tr><td>Lock Device</td><td align="center">🔒</td><td>Instantly locks the device with an optional custom message and phone number.</td></tr><tr><td>Enable Lost Mode</td><td align="center">🚩</td><td>Activates Lost Mode: locks the device and enables remote tracking.</td></tr><tr><td>Disable Lost Mode</td><td align="center">✅</td><td>Deactivates Lost Mode to restore normal device functionality.</td></tr><tr><td>Play Lost Mode Sound</td><td align="center">🔔</td><td>Triggers a loud sound on the device to help locate it physically.</td></tr><tr><td>Erase Device</td><td align="center">🧽</td><td>Remote Wipe: Factory resets the device (data is permanently erased).</td></tr><tr><td>Grace Period</td><td align="center">🕒</td><td>Sets the delay time before the passcode lock becomes active.</td></tr><tr><td>Restart Device</td><td align="center">♻️</td><td>Remotely triggers a system reboot of the device.</td></tr><tr><td>Shutdown Device</td><td align="center">⏻</td><td>Remotely powers off the device.</td></tr><tr><td>Schedule OS Update</td><td align="center">⬆️</td><td>Schedules the download and installation of iOS/iPadOS updates.</td></tr></tbody></table>

{% hint style="warning" %}
If a command you expect to see is missing from the interface, verify that the device is correctly `supervised` and that your Jamf Pro user account has the corresponding permissions in the Jamf Pro settings.

![](/files/w6vImdMIX63XWEwlOwRR)
{% endhint %}

***

## Configuration

### Accessing Settings

* Go to: **`Tools`** → **`Jamf`** → **`Configuration`**.

### Server Settings

* **JSS Server:** Your Jamf Pro URL (e.g., `https://your-company.jamfcloud.com`).
* **Credentials:** Jamf account with at least **Read** permissions for `Computers` and / or `Mobile Devices`.

<figure><img src="/files/pYaRUXjMR6xrqxhCXO13" alt=""><figcaption><p>JAMF server settings</p></figcaption></figure>

#### Other configurations

* **Sync Settings:** Toggle specific data imports (Financials, Software, Components) to match your needs.

<figure><img src="/files/BlXf0cp0v5eHZNhN02XI" alt=""><figcaption><p>JAMF ohter configurations</p></figcaption></figure>

{% hint style="warning" %}
If you wish to synchronize extension attributes, you must have read permissions for the `Computer Extension Attributes` and/or `Device Extension Attributes`.
{% endhint %}

* **Default Settings:** Define default manufacturers , type, and status for new device imports.

<figure><img src="/files/fsPsZtiT8JVI2BAOOMiH" alt=""><figcaption><p>JAMF default settings</p></figcaption></figure>

***

## Discovery & Import

* Go to: **`Tools`** → **`Jamf`** → **`Import`**.

This interface serves as the staging area for all devices discovered within your Jamf Pro instance. To ensure data integrity and prevent unwanted asset creation.

<figure><img src="/files/51fe9kJz7XX6JPmSxsVR" alt=""><figcaption><p>JAMF discover and import</p></figcaption></figure>

***

## Merge existing devices

* Go to: **`Tools`** → **`Jamf`** → **`Merge`**.

The Merge engine is a critical feature for maintaining a Single Source of Truth within your CMDB. It is specifically designed to handle scenarios where a device already exists in GLPI (e.g., via manual entry or a different discovery source).

Conflict Resolution: This page lists imported devices and highlights potential matches with existing GLPI items based on unique identifiers (Serial Number, UDID).

<figure><img src="/files/AfpClGv5JgKsrvGkthoh" alt=""><figcaption><p>JAMF merge existing devices</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.glpi-project.org/doc-plugins/plugins-glpi/jamf.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.