All MIBs › SNMP-USM-DH-OBJECTS-MIB › usmDHKickstartMgrPublic
usmDHKickstartMgrPublic
Module: SNMP-USM-DH-OBJECTS-MIB
OID (symbolic): SNMP-USM-DH-OBJECTS-MIB::usmDHKickstartMgrPublic
OID (numeric): 1.3.6.1.3.101.1.2.1.1.3
Node type: OBJECT-TYPE
Type: OCTET STRING
Access: read-only
Description: The manager's Diffie-Hellman public value for this row. Note that this value is not set via the SNMP agent, but may be set via some out of band method, such as the device's configuration file.
The manager calculates this value in the same manner and using the same parameter set as the agent does. E.g. it selects a random number 'r', calculates y = g^r mod p and provides 'y' as the public number expressed as an OCTET STRING. See usmDHKickstartMyPublic for details.
When this object is set with a valid value during initialization, a row is created in the usmUserTable with the following values:
usmUserEngineID localEngineID usmUserName [value of usmDHKickstartSecurityName] usmUserSecurityName [value of usmDHKickstartSecurityName] usmUserCloneFrom ZeroDotZero usmUserAuthProtocol usmHMACMD5AuthProtocol usmUserAuthKeyChange -- derived from set value usmUserOwnAuthKeyChange -- derived from set value usmUserPrivProtocol usmDESPrivProtocol usmUserPrivKeyChange -- derived from set value usmUserOwnPrivKeyChange -- derived from set value usmUserPublic '' usmUserStorageType permanent usmUserStatus active
A shared secret 'sk' is calculated at the agent as sk = mgrPublic^r mod p where r is the agents random number and p is the DH prime from the common parameters. The underlying privacy key for this row is derived from sk by applying the key derivation function PBKDF2 defined in PKCS#5v2.0 with a salt of 0xd1310ba6, and iterationCount of 500, a keyLength of 16 (for usmDESPrivProtocol), and a prf (pseudo random function) of 'id-hmacWithSHA1'. The underlying authentication key for this row is derived from sk by applying the key derivation function PBKDF2 with a salt of 0x98dfb5ac , an interation count of 500, a keyLength of 16 (for usmHMAC5AuthProtocol), and a prf of 'id-hmacWithSHA1'. Note: The salts are the first two words in the ks0 [key schedule 0] of the BLOWFISH cipher from 'Applied Cryptography' by Bruce Schnier - they could be any relatively random string of bits.
The manager can use its knowledge of its own random number and the agent's public value to kickstart its access to the agent in a secure manner. Note that the security of this approach is directly related to the strength of the authorization security of the out of band provisioning of the managers public value (e.g. the configuration file), but is not dependent at all on the strength of the confidentiality of the out of band provisioning data.
What is usmDHKickstartMgrPublic?
Holds the manager's Diffie-Hellman public value for this kickstart row, supplied out-of-band (such as via a configuration file) rather than computed by the agent. Setting it with a valid value triggers the creation of a new row in the usmUserTable, effectively bootstrapping a fresh SNMPv3 user without ever transmitting a raw key. During initial device provisioning, a configuration management tool would write the manager's public DH value here to complete the key agreement and create the associated user account.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.3.101.1.2.1.1.3 snmpwalk -v2c -c public <target> SNMP-USM-DH-OBJECTS-MIB::usmDHKickstartMgrPublic
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.3.101.1.2.1.1.3.1 snmpget -v2c -c public <target> SNMP-USM-DH-OBJECTS-MIB::usmDHKickstartMgrPublic.1
Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device or host (Diffie-Hellman key-agreement/kickstart) with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the SNMP-USM-DH-OBJECTS-MIB::usmDHKickstartMgrPublic OID value, configure state conditions and alerts, and monitor any vendor-neutral, standards-based MIB, any SNMPv3-capable network device or host (Diffie-Hellman key-agreement/kickstart) from a single console.
OID Breakdown
Upper-level ancestors (5 from the standard OID tree / other modules)
| Numeric OID | Name | Module |
|---|---|---|
| 1 | iso | LANART-AGENT |
| 1.3 | org | AirPair-MIB |
| 1.3.6 | dod | AirPair-MIB |
| 1.3.6.1 | internet | AirPair-MIB |
| 1.3.6.1.3 | experimental | APERTUS-NPG-MIB |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.3.101 | snmpUsmDHObjectsMIB | SNMP-USM-DH-OBJECTS-MIB |
| 1.3.6.1.3.101.1 | usmDHKeyObjects | SNMP-USM-DH-OBJECTS-MIB |
| 1.3.6.1.3.101.1.2 | usmDHKickstartGroup | SNMP-USM-DH-OBJECTS-MIB |
| 1.3.6.1.3.101.1.2.1 | usmDHKickstartTable | SNMP-USM-DH-OBJECTS-MIB |
| 1.3.6.1.3.101.1.2.1.1 | usmDHKickstartEntry | SNMP-USM-DH-OBJECTS-MIB |
| 1.3.6.1.3.101.1.2.1.1.3 | usmDHKickstartMgrPublic | SNMP-USM-DH-OBJECTS-MIB |