Document toolboxDocument toolbox

Discovery Credentials

You can define a list of SNMP v1/v2c credentials or a list of SNMPv3 credentials to import through a CSV file. Sensitive authentication information may be part of an SNMP credential import, including SNMPv1 or SNMPv2c communities or SNMPv3 user/password tuples for privacy and authentication. This information is also stored in the NIOS database.
CSV import of credentials contains community strings and passwords in plain text. Imported CSV files are uploaded with a POST in an HTTPS session and are deleted immediately after the import operation completes, whether or not the import is successful.

SNMPv1/SNMPv2c Credentials Format

Field Name

Data Type

Required (Yes/No)

Associated GUI Field

Associated PAPI Method

Usage and Guideline

Field Name

Data Type

Required (Yes/No)

Associated GUI Field

Associated PAPI Method

Usage and Guideline

Header-discoverysnmpv1v2credentials

String

Yes



SNMPCredential



comment

String

No

Comment

comment

Use this field to set or retrieve the comment on SNMPv1 and SNMPv2 users.

community_string

String

Yes

Read Community

community_string



_new_community_string

String

No





Use this field to set or retrieve the public community string.

parent

String

Yes

SNMPv1/v2



This is the existing credential.

SNMPv3 Credentials Format

Field Name

Data Type

Required (Yes/No)

Associated GUI Field

Associated PAPI Method

Usage and Guideline

Field Name

Data Type

Required (Yes/No)

Associated GUI Field

Associated PAPI Method

Usage and Guideline

Header-discoverysnmpv3credentials

String

Yes



SNMP3Credential



user

String

Yes

Name

user

Use this field to set or retrieve the SNMPv3 user name.

_new_user

String

No

Name



Add this field to overwrite the user field when you use the overwrite or merge option.

authentication_password

String (if protocol is (MD5/SHA)

No

Auth Password

authentication_password

Use this field to set the authentication password if the authentication protocol is MD5 or SHA. This is a write-only attribute.

authentication_protocol

String (valid values are MD5/SHA/NONE/SHA-224/SHA-256/ SHA-384/SHA-512)

No

Auth Protocol

authentication_protocol

Use this field to set or retrieve the authentication protocol.

_new_authentication_protocol

String

No





Add this field to overwrite the authentication_protocol field when you use the overwrite or merge option.

comment

String

No

Comment



Add this field to overwrite the comment you entered for the credential.

parent

String

Yes

SNMPv3





privacy_password

String (if protocol is AES/DES/3DES)

No

Privacy Password

privacy_password

Use this field to set the privacy password if the privacy protocol is 'AES', 'DES' or '3DES'. This is a write-only attribute.

privacy_protocol

String (valid values: AES-128/DES/3DES/NONE/AES-192/AES-192C/AES-256/AES-256C)

No

Privacy Protocol

privacy_protocol

Use this field to set or retrieve the privacy protocol.

_new_privacy_protocol

String

No





Add this field to overwrite the privacy_protocol field when you use the overwrite or merge option.