From beebacd3edb49434839855c77ed6e8b0dc5c7b6e Mon Sep 17 00:00:00 2001 From: Stanislas Kita Date: Wed, 11 Mar 2026 15:36:50 +0100 Subject: [PATCH 1/3] Feat(core): update README --- README.md | 87 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 75 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 473fd02..51dfe35 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,78 @@ -# JAMF Plugin for GLPI -Syncs data from JAMF Pro to GLPI. +# Jamf Plugin for GLPI -## Requirements -- GLPI >= 10.0.0 -- PHP >= 7.4.0 -- The latest version of Jamf Pro +[![License](https://img.shields.io/github/license/pluginsGLPI/jamf.svg?&label=License)](https://github.com/pluginsGLPI/jamf/blob/master/LICENSE) +[![Follow twitter](https://img.shields.io/twitter/follow/Teclib.svg?style=social&label=Twitter&style=flat-square)](https://twitter.com/teclib) +[![Telegram Group](https://img.shields.io/badge/Telegram-Group-blue.svg)](https://t.me/glpien) +[![Project Status: Active](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) +[![GitHub release](https://img.shields.io/github/release/pluginsGLPI/jamf.svg)](https://github.com/pluginsGLPI/jamf/releases) +[![GitHub build](https://travis-ci.org/pluginsGLPI/jamf.svg?)](https://travis-ci.org/pluginsGLPI/jamf/) -## Usage -- Server/sync configuration is found in Setup > Config under the JAMF Plugin tab. -- JSS User account used must have read access to mobile devices at least. Additional access may be required depending on what items are synced (software, etc). -- The two automatic actions "importJamf' and 'syncJamf" can only be run in CLI/Cron mode due to how long they can take. -- There is a rule engine used to filter out imported devices. The default import action is to allow the import. -- iPads and AppleTVs are imported as Computers, while iPhones can be imported as Phones or Computers. +The **Jamf Plugin** provides a robust integration between **Jamf Pro** and **GLPI**. It synchronizes Apple devices (macOS, iOS, iPadOS, tvOS) 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` (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 Integration + +The plugin 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. + + +### 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`. + +### Sync & Extension Attributes + +You can toggle specific data imports (Financials, Software, Components) to match your needs. + +> [!WARNING] +> If you wish to synchronize extension attributes, you must have read permissions for the `Computer Extension Attributes` and/or `Device Extension Attributes`. + +## Download + +Releases can be donwloaded on [GitHub](https://github.com/PluginsGLPI/jamf/releases). + +## Documentation + +We maintain a detailed [documentation](http://glpi-plugins.rtfd.io/en/latest/jamf/index.html). + + +## Professional Services + +The GLPI Network services are available through our [Partner's Network](http://www.teclib-edition.com/en/partners/). +We provide special training, bug fixes with editor subscription, contributions for new features, and more. + +## Contributing + +* Open a ticket for each bug/feature so it can be discussed +* Follow [development guidelines](http://glpi-developer-documentation.readthedocs.io/en/latest/plugins/index.html) +* Work on a new branch on your own fork +* Open a PR that will be reviewed by a developer + +## Copying + +* **Code**: you can redistribute it and/or modify it under the terms of the GNU General Public License ([GPL-2.0](https://www.gnu.org/licenses/gpl-2.0.en.html)). From c2c62203c377d8822b64fa665673dbe8c548c39f Mon Sep 17 00:00:00 2001 From: Stanislas Kita Date: Wed, 18 Mar 2026 11:58:06 +0100 Subject: [PATCH 2/3] update --- README.md | 54 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 35 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 51dfe35..0a35af4 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,15 @@ +# jamf Plugin For GLPI -# Jamf Plugin for GLPI +[![License](https://img.shields.io/github/license/pluginsGLPI/jamf.svg?&label=License&style=for-the-badge)](https://github.com/pluginsGLPI/jamf/blob/main/LICENSE) +![Static Badge](https://img.shields.io/badge/Project_Status-Active-green?style=for-the-badge) +![GitHub Actions Status](https://img.shields.io/github/actions/workflow/status/pluginsGLPI/jamf/continuous-integration.yml?style=for-the-badge) +[![GitHub release](https://img.shields.io/github/release/pluginsGLPI/jamf.svg?&style=for-the-badge)](https://github.com/pluginsGLPI/jamf/releases) +![GitHub Downloads](https://img.shields.io/github/downloads/pluginsGLPI/jamf/total?style=for-the-badge) + +

+ +

-[![License](https://img.shields.io/github/license/pluginsGLPI/jamf.svg?&label=License)](https://github.com/pluginsGLPI/jamf/blob/master/LICENSE) -[![Follow twitter](https://img.shields.io/twitter/follow/Teclib.svg?style=social&label=Twitter&style=flat-square)](https://twitter.com/teclib) -[![Telegram Group](https://img.shields.io/badge/Telegram-Group-blue.svg)](https://t.me/glpien) -[![Project Status: Active](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) -[![GitHub release](https://img.shields.io/github/release/pluginsGLPI/jamf.svg)](https://github.com/pluginsGLPI/jamf/releases) -[![GitHub build](https://travis-ci.org/pluginsGLPI/jamf.svg?)](https://travis-ci.org/pluginsGLPI/jamf/) The **Jamf Plugin** provides a robust integration between **Jamf Pro** and **GLPI**. It synchronizes Apple devices (macOS, iOS, iPadOS, tvOS) and their detailed metadata directly into your GLPI asset management system. @@ -52,27 +55,40 @@ You can toggle specific data imports (Financials, Software, Components) to match > [!WARNING] > If you wish to synchronize extension attributes, you must have read permissions for the `Computer Extension Attributes` and/or `Device Extension Attributes`. -## Download - -Releases can be donwloaded on [GitHub](https://github.com/PluginsGLPI/jamf/releases). ## Documentation -We maintain a detailed [documentation](http://glpi-plugins.rtfd.io/en/latest/jamf/index.html). +Full plugin documentation is available [here](https://help.glpi-project.org/doc-plugins/plugins-glpi/jamf). ## Professional Services -The GLPI Network services are available through our [Partner's Network](http://www.teclib-edition.com/en/partners/). -We provide special training, bug fixes with editor subscription, contributions for new features, and more. +GLPI professional services are offered through the [Partner Network](http://www.teclib-edition.com/en/partners/): + +- Specialized training +- Bug fixes with an editor subscription +- Contributions for new features +- Personalized support and consulting + +Experience a tailored service with exclusive advantages and opportunities. + ## Contributing -* Open a ticket for each bug/feature so it can be discussed -* Follow [development guidelines](http://glpi-developer-documentation.readthedocs.io/en/latest/plugins/index.html) -* Work on a new branch on your own fork -* Open a PR that will be reviewed by a developer +We welcome contributions! Here's how you can help: + +- Report bugs or request features via [Issues](https://github.com/pluginsGLPI/sccm/issues) +- Follow the [development guidelines](http://glpi-developer-documentation.readthedocs.io/en/latest/plugins/index.html) +- Use [GitFlow](http://git-flow.readthedocs.io/) for branching +- Work on a new branch in your fork +- Submit a Pull Request (PR) for review + -## Copying +## Social Media -* **Code**: you can redistribute it and/or modify it under the terms of the GNU General Public License ([GPL-2.0](https://www.gnu.org/licenses/gpl-2.0.en.html)). +[![Facebook GLPI](https://img.shields.io/badge/Facebook-GLPI-1877F2.svg?style=for-the-badge)](https://www.facebook.com/glpiproject/) +[![X (formerly Twitter)](https://img.shields.io/badge/Twitter-GLPI%20Project-26A2FA.svg?style=for-the-badge)](https://x.com/GLPI_PROJECT) +[![YouTube GLPI](https://img.shields.io/badge/YouTube-GLPI-FF0033.svg?style=for-the-badge)](https://www.youtube.com/channel/UCoIMi7aKeIvQRxi7ggd6VNA) +[![Instagram GLPI](https://img.shields.io/badge/Instagram-GLPI-E1306C.svg?style=for-the-badge)](https://www.instagram.com/glpi_project/) +[![LinkedIn GLPI](https://img.shields.io/badge/LinkedIn-GLPI-0A66C2.svg?style=for-the-badge)](https://www.linkedin.com/products/teclib-glpi/) +[![Telegram GLPI](https://img.shields.io/badge/Telegram-GLPI-blue.svg?style=for-the-badge)](https://t.me/glpien) From 04875f65f32c8cbf4778e78c3ad4c7346750e69e Mon Sep 17 00:00:00 2001 From: Stanislas Kita Date: Wed, 18 Mar 2026 12:00:06 +0100 Subject: [PATCH 3/3] update --- jamf.xml | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/jamf.xml b/jamf.xml index 8ae04d6..1425d61 100644 --- a/jamf.xml +++ b/jamf.xml @@ -18,6 +18,15 @@ Usage - The two automatic actions "importJamf' and 'syncJamf" can only be run in CLI/Cron mode due to how long they can take. - There is a rule engine used to filter out imported devices. The default import action is to allow the import. ]]> + Générale sous l'onglet Plugin JAMF. +- Le compte utilisateur JSS utilisé doit posséder au moins un accès en lecture aux appareils mobiles et aux ordinateurs. Des accès supplémentaires peuvent être requis selon les éléments synchronisés (logiciels, etc.). +- Les deux actions automatiques "importJamf" et "syncJamf" ne peuvent être exécutées qu'en mode CLI/Cron en raison de leur durée d'exécution. +- Un moteur de règles est utilisé pour filtrer les appareils importés. Par défaut, l'action d'importation est autorisée. + ]]> https://github.com/pluginsGLPI/jamf @@ -146,7 +155,7 @@ Usage - https://raw.githubusercontent.com/pluginsGLPI/jamf/master/screenshots/imports.png - https://raw.githubusercontent.com/pluginsGLPI/jamf/master/screenshots/mobiledevice.png + https://raw.githubusercontent.com/pluginsGLPI/jamf/main/screenshots/imports.png + https://raw.githubusercontent.com/pluginsGLPI/jamf/main/screenshots/mobiledevice.png