For the complete documentation index, see llms.txt. This page is also available as Markdown.

Android Inventory

In this article we will see how to inventory an Android mobile quick and easy with GLPI Agent and the Agent config plugin.

This requires GLPI inventory plugin installed and activated (in the Setup > Plugins menu).


Plugin Agent Config

In GLPI, in your list of Plugins, you will find Agent config.

This plugin allows you to facilitate the inventory of mobiles by configuring in advance the values ​​to enter to configure the agent.

This plugin will allow you to be scanned via QRcode or a DeepLink to quickly integrate your mobile into your inventory.

Once the plugin installed and activated, go to the configuration.

In the Configuration tab of the GLPI Agent, we must configure at least:

  • The URL of server, example: mon.glpi.fr/GLPI inventory/

  • Identifier

  • Password

Alt text

Create the OAuth Client

In GLPI, create a new OAuth client dedicated to the Android Inventory Agent.

Configure the following grants:

  • Client Credentials

  • Authorization Code

Configure the following scope:

  • Inventory

Using a dedicated OAuth client makes it possible to limit the permissions granted to the Android Inventory Agent to the operations required for inventory management.

Configure the Android Inventory Agent Plugin

Once the OAuth client has been created, configure the Android Inventory Agent plugin to use this OAuth client.

Select the OAuth client created in the previous step and save the configuration.

Configure the Inventory

Configure the inventory settings to explicitly indicate that the inventory must use the OAuth client for authentication.

Make sure that the Oauth - Client credentials authentication option is enabled.

Configure the Android Inventory Agent

The configuration can now be distributed to the Android Inventory Agent using the generated QR code.

Simply scan the QR code using the Android Inventory Agent application.

Once the QR code has been scanned, the application will automatically retrieve the OAuth configuration and use the dedicated OAuth client to authenticate with GLPI.

The Android Inventory Agent is then ready to perform inventory operations against your GLPI instance.

Security considerations

The QR code and deep link generated by the Android Inventory Agent plugin may contain the OAuth client_id and client_secret required to authenticate the agent.

For security reasons, access to this information is now protected by a dedicated permission in the Android Inventory Agent plugin.

Access to the QR code and deep link from the GLPI home page is restricted as follows:

  • Self-Service profiles do not have access to the QR code or deep link.

  • Other profiles must have the dedicated permission enabled to access the QR code or deep link.

  • Access to these credentials should only be granted to trusted users who are authorized to configure Android Inventory Agents.

This permission should therefore be granted according to the principle of least privilege, as the QR code / deep link may expose OAuth credentials in plain text.

Make sure that only authorized users have access to the generated QR code or deep link and avoid sharing them through untrusted channels.

Last updated