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 NameData TypeRequired (Yes/No)Associated GUI FieldAssociated PAPI MethodUsage and Guideline
Header-discoverysnmpv1v2credentialsStringYes
SNMPCredential
commentStringNoCommentcommentUse this field to set or retrieve the comment on SNMPv1 and SNMPv2 users.
community_stringStringYesRead Communitycommunity_string
_new_community_stringStringNo

Use this field to set or retrieve the public community string.
parentStringYesSNMPv1/v2
This is the existing credential.

SNMPv3 Credentials Format

Field NameData TypeRequired (Yes/No)Associated GUI FieldAssociated PAPI MethodUsage and Guideline
Header-discoverysnmpv3credentialsStringYes
SNMP3Credential
userStringYesNameuserUse this field to set or retrieve the SNMPv3 user name.
_new_userStringNoName
Add this field to overwrite the user field when you use the overwrite or merge option.
authentication_passwordString (if protocol is (MD5/SHA) NoAuth Passwordauthentication_passwordUse this field to set the authentication password if the authentication protocol is MD5 or SHA. This is a write-only attribute.
authentication_protocolString (valid values are MD5/SHA/NONE) NoAuth Protocolauthentication_protocolUse this field to set or retrieve the authentication protocol.
_new_authentication_protocolStringNo

Add this field to overwrite the authentication_protocol field when you use the overwrite or merge option.
commentStringNoComment
Add this field to overwrite the comment you entered for the credential.
parentStringYesSNMPv3

privacy_passwordString (if protocol is AES/DES/3DES) NoPrivacy Passwordprivacy_passwordUse this field to set the privacy password if the privacy protocol is 'AES', 'DES' or '3DES'. This is a write-only attribute.
privacy_protocolString (valid values: AES/DES/3DES/NONE) NoPrivacy Protocolprivacy_protocolUse this field to set or retrieve the privacy protocol.
_new_privacy_protocolStringNo

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