> For the complete documentation index, see [llms.txt](https://help.glpi-project.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.glpi-project.org/tutorials/inventory/android_inventory.md).

# 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](https://2961961068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGALtnzA2IROeldmXKt5%2Fuploads%2Fgit-blob-075ffb96a965e49d740375a2f368d19af2a6f66d%2Fandroid_inventory-1.png?alt=media)

#### 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.

<figure><img src="https://2961961068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGALtnzA2IROeldmXKt5%2Fuploads%2FFR3OEVnhYnkaT7YeCNsN%2Fimage.png?alt=media&amp;token=82977f13-1042-4fc7-85c4-c4669d3f008c" alt=""><figcaption></figcaption></figure>

#### Configure the Android Inventory Agent Plugin

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

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

<figure><img src="https://2961961068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGALtnzA2IROeldmXKt5%2Fuploads%2FaPGpSbtlCNins4e7RLhX%2Fimage.png?alt=media&amp;token=c3b56592-ce17-4b3f-b939-5a18a724510f" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://2961961068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGALtnzA2IROeldmXKt5%2Fuploads%2FkQjVQk42CaHSm0w6leRS%2Fimage.png?alt=media&amp;token=473f2045-5626-4cb9-8e4b-3c34934a0970" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://2961961068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsGALtnzA2IROeldmXKt5%2Fuploads%2FeA4g8q1GRbF8lnNX296C%2Fimage.png?alt=media&amp;token=926f0d18-8000-43f6-9f55-19af324d1cb4" alt=""><figcaption></figcaption></figure>

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.glpi-project.org/tutorials/inventory/android_inventory.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
