> 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/documentation/tabs/common_fields/snmp_credentials.md).

# SNMP Credentials

SNMP Credentials are parameters used to enable GLPI to interact with network devices through the SNMP (Simple Network Management Protocol). They are used to automatically retrieve information about devices for inventory.

## Role of SNMP Credentials in GLPI

### Device Identification

GLPI uses SNMP Credentials to query a network device (such as a switch, router, or printer) and retrieve specific details (name, firmware version, IP address, etc.).

### Data Collection

Credentials allow GLPI to collect data such as:

* Port status.
* MAC and IP addresses.
* Hardware details (model, manufacturer, software version, etc.).

### Automated Inventory

With SNMP enabled, GLPI can automatically enrich the inventory of devices without manual input.

## Main SNMP Credentials in GLPI

### SNMP Community Name

A "key" shared between the client (GLPI) and the device, used for authentication. Default:

* **public** (read-only)
* **private** (read/write).

### SNMP Version

GLPI supports multiple versions of SNMP:

* **SNMP v1**: Basic version, no security.
* **SNMP v2c**: Improved performance, still without strong security.
* **SNMP v3**: Advanced security (authentication and encryption).

{% hint style="success" %}
For SNMP v3, user credentials with authentication and encryption keys are required. Wherever possible, we recommend this method as it is safer.
{% endhint %}

### OID (Object Credentials)

Used to specify the information GLPI wants to query (e.g., `sysDescr`, `sysName`, `interfaces`, etc.).

### Device IP Address or FQDN

GLPI uses this information to target a specific device.

## Configuring SNMP Credentials in GLPI

### Enable the SNMP Module

Ensure that support for the target agent is activated

![Support agent for SNMP inventory](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-f5bd4b402e927e9702241f0a9512a5ebaa6beedb%2FSNMP_credentials.png?alt=media)

### Set up SNMP Credentials

In **Administration** > **Inventory** > **SNMP Credentials**, you can add or modify specific parameters.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.glpi-project.org/documentation/tabs/common_fields/snmp_credentials.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.