diff --git a/.tx/config b/.tx/config index 866c07208..46cca6f3f 100644 --- a/.tx/config +++ b/.tx/config @@ -471,4 +471,10 @@ source_file = build/locale/saml/tabs/for-entra.pot source_lang = en type = PO +[o:teclib:p:glpi-plugins-documentation:r:agent_config--index] +file_filter = source/locale//LC_MESSAGES/agent_config/index +source_file = build/locale/agent_config/index.pot +source_lang = en +type = PO + diff --git a/source/agent_config/images/asset.png b/source/agent_config/images/asset.png new file mode 100644 index 000000000..1c597d02b Binary files /dev/null and b/source/agent_config/images/asset.png differ diff --git a/source/agent_config/images/central.png b/source/agent_config/images/central.png new file mode 100644 index 000000000..a9ce34783 Binary files /dev/null and b/source/agent_config/images/central.png differ diff --git a/source/agent_config/images/deeplink.png b/source/agent_config/images/deeplink.png new file mode 100644 index 000000000..b929d42bd Binary files /dev/null and b/source/agent_config/images/deeplink.png differ diff --git a/source/agent_config/images/global_category.png b/source/agent_config/images/global_category.png new file mode 100644 index 000000000..0e935eb53 Binary files /dev/null and b/source/agent_config/images/global_category.png differ diff --git a/source/agent_config/images/install_agent.png b/source/agent_config/images/install_agent.png new file mode 100644 index 000000000..2ba1cb275 Binary files /dev/null and b/source/agent_config/images/install_agent.png differ diff --git a/source/agent_config/images/install_plugin.png b/source/agent_config/images/install_plugin.png new file mode 100644 index 000000000..12f81c613 Binary files /dev/null and b/source/agent_config/images/install_plugin.png differ diff --git a/source/agent_config/images/listservers.png b/source/agent_config/images/listservers.png new file mode 100644 index 000000000..2ceb9b0ca Binary files /dev/null and b/source/agent_config/images/listservers.png differ diff --git a/source/agent_config/images/listserversFilledField.png b/source/agent_config/images/listserversFilledField.png new file mode 100644 index 000000000..e1da0e24a Binary files /dev/null and b/source/agent_config/images/listserversFilledField.png differ diff --git a/source/agent_config/images/listserversFilledField2.png b/source/agent_config/images/listserversFilledField2.png new file mode 100644 index 000000000..e1da0e24a Binary files /dev/null and b/source/agent_config/images/listserversFilledField2.png differ diff --git a/source/agent_config/images/setup_plugin.png b/source/agent_config/images/setup_plugin.png new file mode 100644 index 000000000..6f1a9d61c Binary files /dev/null and b/source/agent_config/images/setup_plugin.png differ diff --git a/source/agent_config/index.rst b/source/agent_config/index.rst new file mode 100644 index 000000000..81ae65160 --- /dev/null +++ b/source/agent_config/index.rst @@ -0,0 +1,120 @@ +Agent Config +============ + +Requirements (on-premise) +------------------------- + +============ =========== =========== +GLPI Version Minimum PHP Recommended +============ =========== =========== +10.0.x 8.1 8.2 +============ =========== =========== + +.. Note:: + A `basic licence `_ (or higher) is required. This plugin is also available from the `Cloud `_. + +Install the plugin +------------------ + +- Go to the marketplace. Download and install the “`Agent config`” plugin. + +.. figure:: images/install_plugin.png + :alt: Install the plugin + :scale: 100% + + +Setting up the plugin +--------------------- + +In **Setup** > **General** > **GLPI Agent Contiguration**, select the options you want : + +* By default, the URL of the inventory is indicated +* To secure your instance and limit feedback from your mobile devices, you can enter a **login** and **password** for each mobile device to be inventoried +* You can use a **tag entity** (choose **Yes** and indicate your **tag** if needed) +* Choose the **asset type** by default (computers or phones, this information indicates the type of device by default, but can be modified individually from each device) + +* Display **QR Code** (on central page) +* Display **Deeplink** (on central page) +* Manage **automatic inventory and frequency** for android + +.. figure:: images/setup_plugin.png + :alt: setup the plugin + :scale: 50% + + +Central page +~~~~~~~~~~~~ + +* On **Home** > **GLPI Agent Config** use Deep link or QR Code to preconfigure the agent : + +.. figure:: images/asset.png + :alt: Deeplink of QRCode + :scale: 37% + + +.. tip:: When a factory reset is performed on the phone, the serial number automatically generated by the agent changes + You can use **Deep Link** / **QR Code** to configure the agent with the serial number previously generated and inventoried in GLPI. + + +Setup mobile device +------------------- + +* Download the **Agent GLPI** on the Google Store + +.. figure:: images/install_agent.png + :alt: Install agent on the Google Store + :scale: 100% + +With Deep Link +~~~~~~~~~~~~~~~ + +* Go to GLPI with your device web browser +* Click on the DeepLink + +.. figure:: images/deeplink.png + :alt: Click on Deeplink + :scale: 70% + +* App will open and pre-fill the fields for adding a server +* Then click on **Add server** + +.. figure:: images/listserversFilledField2.png + :alt: Add server + :scale: 70% + +With QR Code +~~~~~~~~~~~~ + +* Open **GLPI Agent** on your device +* Go to **Advanced Settings** > **Open List Server** > **Add servers** +* Click on **QR Code** button +* Flash QR Code + +.. figure:: images/listservers.png + :alt: Use QR Code + :scale: 70% + +* App pre-fill the fields for adding a server +* Then add server. + +.. figure:: images/listserversFilledField2.png + :alt: Add server + :scale: 70% + +Category Global +~~~~~~~~~~~~~~~ + +* In mobile device, menu > advanced settings > Category global, select/unselect the informations you want to inventory + +.. figure:: images/global_category.png + :alt: Show catgory you want to inventory + :scale: 70% + +Contributing +------------ + +* Open a ticket for each bug/feature so it can be discussed +* Follow `development guidelines `_ +* Refer to `GitFlow `_ process for branching +* Work on a new branch on your own fork +* Open a PR that will be reviewed by a developer diff --git a/source/index.rst b/source/index.rst index ab7260fac..6bc4be391 100644 --- a/source/index.rst +++ b/source/index.rst @@ -46,6 +46,7 @@ You'll find here user documentation for various `GLPI ` :caption: ⭐ GLPI-Network Plugins advanceddashboard/index + agent_config/index anonymize/index approvalbymail/index branding/index diff --git a/source/scim/entra.rst b/source/scim/entra.rst index 2dd041373..e298a539a 100644 --- a/source/scim/entra.rst +++ b/source/scim/entra.rst @@ -1,7 +1,7 @@ Entra ----- -References: +References ~~~~~~~~~~ - `Use SCIM to provision users and groups `_ @@ -120,4 +120,4 @@ Check synchronisation status :scale: 43 % .. Important:: - See the procedure for setting up the `OAuth SSO `_ plugin to authenticate users on GLPI. \ No newline at end of file + See the procedure for setting up the `OAuth SSO `_ plugin to authenticate users on GLPI.