REST API  4.0.0
REST API for SafeNet Network HSMs
PUT /api/lunasa/snmp/trap

PUT /api/lunasa/snmp/trap

This resource configures all SNMP trap parameters.

Parameters

address

This parameter specifies the ip address or hostname that receives traps.

Use: Required

JSON Schema:

    Object
    type:string

securityName

This parameter specifies the SNMP user to associate traps with. Note: This is user that is created with POST /api/lunasa/snmp/users

Use: Required

JSON Schema:

    Object
    type:string

engineId

Specifies the engine that receives traps and that has the authority to control the flow of information. Note: This value represents a hexadecimal value with a length of 10, 12, 14 or 16 (excluding the prepended 0x value).

Use: Required

JSON Schema:

    Object
    type:string

authenticationPassword

Specifies and confirms the password used to authenticate SNMPv3 trap messages. Note: This password must contain between 8 and 128 characters and is case-sensitive.

Use: Required

JSON Schema:

    Object
    type:string

authenticationProtocol

Specifies the HMAC (hash-based message authentication code) algorithm used to authenticate SNMPv3 trap messages. Note: Restricted to SHA.

Use: Required

JSON Schema:

    Object
    type:string

privacyPassword

Specifies and confirms the password used to encrypt SNMPv3 trap messages. Note: This password must contain between 8 and 128 characters and is case-sensitive.

Use: Required

JSON Schema:

    Object
    type:string

privacyProtocol

Specifies the algorithm used to encrypt SNMPv3 trap messages. Note: Restricted to AES.

Use: Required

JSON Schema:

    Object
    type:string

Responses

204

No content

400

Unexpected failure.

404

Security name does not exist.

Example Request

    PUT
    https://1.2.3.4:8443/api/lunasa/snmp/trap
    {
        "address" : "1.2.3.5",
        "securityName" : "myUser",
        "engineId" : "000000000F",
        "authenticationProtocol" : "SHA",
        "privacyProtocol" : "AES",
        "authenticationPassword" : "password1",
        "privacyPassword" : "password2"
    }

Example Response

{
}