# Device Credentials

The device Credentials module of Infraon is used by the administrator or authorized user to configure and store Device/Account information such as login credentials (user name, password, and other protocol-relevant parameters) for a specific connection protocol. Device Credentials are used in ‘Discovery‘ and are mandatory for discovering devices for monitoring and management.

Appropriate device communication protocol must be selected while configuring device credentials to build successful connectivity.

Each device shall be associated with a device credential at the time of discovery. Subsequent monitoring is done using these stored credentials. Should the login credentials (password) change, the administrator must update them to ensure seamless monitoring.

## **Devices and Protocols**

At this point, Infraon supports SNMP, WMI, SSH, and HTTP protocols below. Refer to the table below for details.

<table data-header-hidden><thead><tr><th width="159"></th><th width="215"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Protocols</strong></td><td><strong>Description</strong></td><td><strong>Supported Devices</strong></td><td><strong>Protocol Parameters</strong></td></tr><tr><td>SNMP</td><td>SNMP v1 and v2c versions use community-based security models and user read&#x26; Write Community for access.<br>SNMP v3 version uses an enhanced user-based security model and uses authentication and encryption.<br>If v3 is selected, related parameters need to be configured. Refer ’SNMP v3 Parameters’ section for details.</td><td>Most Network devices, Servers, and other SNMP-supported devices.</td><td><p>SNMP v1 and v2c: Read &#x26; Write Community, Port, Timeout, and Retries.</p><p>  SNMP v3: Username, Security Level, Authentication Type, SNM V3 Password, Privacy Type &#x26; Privacy Password.</p></td></tr><tr><td>SSH</td><td>SSH or Secure Shell protocol establishes an encrypted connection between network devices.</td><td>CLI Option for network devices, Linux, Unix-based servers, and Xen servers.</td><td>Login Name, Login Prompt, Password Port, SH Key File, Connection Command, Timeout, and Retries.</td></tr><tr><td>WMI</td><td>WMI commonly uses CIM conceptual model to represent various components of windows devices.</td><td>Windows Servers</td><td>Domain Name/user Name, Password, Authentication Level, Impersonation level, Timeout, and Retries.</td></tr><tr><td>HTTP</td><td>HTTP acts as the foundation of data exchange on the web.</td><td>vCenter, VMware  API, CUCM cluster</td><td>Username and Password</td></tr></tbody></table>

Click 'Test and Save' to test the credentials for authenticity before saving and proceeding to discovery.

### **What you see on the screen**

The device credentials page can be used to add, edit, and delete device credentials for SNMP, SSH, WMI, and HTTP.

Using the respective icon, the device credential view can be toggled between the card view and the list view.

#### **Instructions to 'Add Device Credential'**

* Go to Infraon Configuration -> IT Operations-> Device Credentials.
* Click on 'Add' and select 'Protocol' as desired.

There are two tabs on the 'Add Credential' page. Refer to the table for information.

**Configuration | Test**

Few fields vary based on the protocol selected. Refer to the 'Description' column for details.

<table data-header-hidden><thead><tr><th width="193"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/Example</strong></td></tr><tr><td>Profile Name*</td><td>Add a name for the credential.</td><td>Applicable for all protocols. A name is usually used as an identifier.</td></tr><tr><td>Description</td><td>Add a brief description of the profile.</td><td>Applicable for all protocols.</td></tr><tr><td>Port</td><td>The default value is auto-populated. This, however, can be changed.</td><td>Applicable for SNMP and SSH.</td></tr><tr><td>Timeout (Seconds)</td><td>The default value is auto-populated. This, however, can be changed.</td><td><p>Applicable for all protocols.</p><p>The number of seconds post which Infraon stops attempting to reach the device.</p></td></tr><tr><td>Retries</td><td>The default value is auto-populated. This, however, can be changed.</td><td><p>Applicable for all protocols.</p><p>The number of instances Infraon tries to reach the device.</p></td></tr><tr><td>For SNMP</td><td>Select the SNMP version, as applicable. Based on the selection, additional fields appear.</td><td><p>Applicable for SNMP only</p><p>V1 - Read Community*, Write Community</p><p>v2c - Read Community*, Write Community, Scan Requests</p><p>v3 - User Name, Context Name, Security Level, Authentication Protocol, Authentication Password*, Privacy Protocol, Privacy Password*, Scan Requests</p></td></tr><tr><td>For SSH</td><td>Select between Credential, and Public Key, as applicable. Based on the selection, additional fields appear.</td><td><p>Applicable for SSH only</p><p>Credential - Login Name*, Password, Login Prompt, Enable Password, Enable Prompt</p><p>Public Key - Hash Key*</p><p>v3 - User Name, Context Name, Security Level, Authentication Protocol, Authentication Password*, Privacy Protocol, Privacy Password*, Scan Requests.</p></td></tr><tr><td>For WMI</td><td>Select between WMIC, and WinRM, as applicable. Based on the selection, additional fields appear.</td><td><p>Applicable for WMI only</p><p>Login Name* and Password* are standard fields for WMIC and WinRM.</p><p>WMIC - Authentication</p><p>WinRM - WinRM Authentication Level, Protocol, WinRM Port, WinRM Certificate Validation, WinRM Certificate File, WinRM Public Key.</p></td></tr><tr><td>For HTTP</td><td>Select between HTTP, and HTTPS, as applicable. Based on the selection, additional fields appear.</td><td><p>Applicable for HTTP/HTTPS only</p><p>HTTP - Username*, Password*</p><p>HTTPS - Username*, Password*,</p></td></tr></tbody></table>

Once all the parameters are defined, click ‘Submit’ to save the credentials or click 'Test & Save' to test the credentials before saving.

**Configuration | Test**

<table data-header-hidden><thead><tr><th width="227"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Label</strong></td><td><strong>Action</strong></td><td><strong>Description/Example</strong></td></tr><tr><td>IP Address*</td><td>Add an IP address to test the credential.</td><td>Applicable for all protocols.</td></tr><tr><td>Agent*</td><td>Select agent to test.</td><td>Applicable for all protocols</td></tr></tbody></table>

Click 'Test.'

Saved credentials can be edited or deleted by using the respective action icons.

{% hint style="info" %}
**Note:** Credentials must be correct to ensure seamless discovery.
{% endhint %}


---

# 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://docs.infraon.io/infraon-help/infinity-user-guide/infraon-configuration/it-operations/device-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.