Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .tx/config
Original file line number Diff line number Diff line change
Expand Up @@ -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/<lang>/LC_MESSAGES/agent_config/index
source_file = build/locale/agent_config/index.pot
source_lang = en
type = PO


Binary file added source/agent_config/images/asset.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/central.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/deeplink.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/global_category.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/install_agent.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/install_plugin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/listservers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/agent_config/images/setup_plugin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
120 changes: 120 additions & 0 deletions source/agent_config/index.rst
Original file line number Diff line number Diff line change
@@ -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 <https://services.glpi-network.com/#offers>`_ (or higher) is required. This plugin is also available from the `Cloud <https://glpi-network.cloud/fr/>`_.

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 <http://glpi-developer-documentation.readthedocs.io/en/latest/plugins/index.html>`_
* Refer to `GitFlow <http://git-flow.readthedocs.io/>`_ process for branching
* Work on a new branch on your own fork
* Open a PR that will be reviewed by a developer
1 change: 1 addition & 0 deletions source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ You'll find here user documentation for various `GLPI <http://glpi-project.org>`
:caption: ⭐ GLPI-Network Plugins

advanceddashboard/index
agent_config/index
anonymize/index
approvalbymail/index
branding/index
Expand Down
4 changes: 2 additions & 2 deletions source/scim/entra.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Entra
-----

References:
References
~~~~~~~~~~

- `Use SCIM to provision users and groups <https://learn.microsoft.com/en-us/entra/identity/app-provisioning/use-scim-to-provision-users-and-groups#integrate-your-scim-endpoint-with-the-azure-ad-provisioning-service>`_
Expand Down Expand Up @@ -120,4 +120,4 @@ Check synchronisation status
:scale: 43 %

.. Important::
See the procedure for setting up the `OAuth SSO <https://glpi-plugins.readthedocs.io/en/latest/oauthsso/entra.html>`_ plugin to authenticate users on GLPI.
See the procedure for setting up the `OAuth SSO <https://glpi-plugins.readthedocs.io/en/latest/oauthsso/entra.html>`_ plugin to authenticate users on GLPI.