# 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](/files/uZaNil1vycWyN2WJ7CUW)

### Set up SNMP Credentials

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.