MIB Browser

SNMP-USM-DH-OBJECTS-MIB

Standards (IETF experimental)
The management information definitions for providing forward
secrecy for key changes for the usmUserTable, and for providing a
method for 'kickstarting' access to the agent via a Diffie-Helman
key agreement.
Organization
Excite@Home
Root OID
1.3.6.1.3.101
Last updated
Objects
24
Source
Show full MIB
snmptranslate -m SNMP-USM-DH-OBJECTS-MIB -Tp
snmpwalk -v2c -c <community> -m SNMP-USM-DH-OBJECTS-MIB <host> 1.3.6.1.3.101

Imports

SNMP-FRAMEWORK-MIBSnmpAdminString
SNMP-USER-BASED-SM-MIBusmUserEntry
SNMPv2-CONFMODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP
SNMPv2-SMIBits, Integer32, IpAddress, MODULE-IDENTITY, MibIdentifier, OBJECT-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32, experimental, iso
SNMPv2-TCDisplayString, PhysAddress, TEXTUAL-CONVENTION

OID tree

NameOIDTypeAccessStatus
IsnmpUsmDHObjectsMIB1.3.6.1.3.101
NusmDHKeyObjects1.3.6.1.3.101.1
NusmDHPublicObjects1.3.6.1.3.101.1.1
SusmDHParameters1.3.6.1.3.101.1.1.1OCTET STRINGRW
TusmDHUserKeyTable1.3.6.1.3.101.1.1.2NA
RusmDHUserKeyEntry1.3.6.1.3.101.1.1.2.1NA
CusmDHUserAuthKeyChange1.3.6.1.3.101.1.1.2.1.1DHKeyChangeRC
CusmDHUserOwnAuthKeyChange1.3.6.1.3.101.1.1.2.1.2DHKeyChangeRC
CusmDHUserPrivKeyChange1.3.6.1.3.101.1.1.2.1.3DHKeyChangeRC
CusmDHUserOwnPrivKeyChange1.3.6.1.3.101.1.1.2.1.4DHKeyChangeRC
NusmDHKickstartGroup1.3.6.1.3.101.1.2
TusmDHKickstartTable1.3.6.1.3.101.1.2.1NA
RusmDHKickstartEntry1.3.6.1.3.101.1.2.1.1NA
CusmDHKickstartIndex1.3.6.1.3.101.1.2.1.1.1Integer32 (1..2147483647)NA
CusmDHKickstartMyPublic1.3.6.1.3.101.1.2.1.1.2OCTET STRINGRO
CusmDHKickstartMgrPublic1.3.6.1.3.101.1.2.1.1.3OCTET STRINGRO
CusmDHKickstartSecurityName1.3.6.1.3.101.1.2.1.1.4SnmpAdminStringRO
NusmDHKeyConformance1.3.6.1.3.101.2
NusmDHKeyMIBCompliances1.3.6.1.3.101.2.1
MusmDHKeyMIBCompliance1.3.6.1.3.101.2.1.1
NusmDHKeyMIBGroups1.3.6.1.3.101.2.2
GusmDHKeyMIBBasicGroup1.3.6.1.3.101.2.2.1
GusmDHKeyParamGroup1.3.6.1.3.101.2.2.2
GusmDHKeyKickstartGroup1.3.6.1.3.101.2.2.3

Textual conventions

DHKeyChange OCTET STRING
Upon initialization, or upon creation of a row containing an
object of this type, and after any successful SET of this value, a
GET of this value returns 'y' where y = g^xa MOD p, and where g is
the base from usmDHParameters, p is the prime from
usmDHParameters, and xa is a new random integer selected by the
agent in the interval 2^(l-1) <= xa < 2^l < p-1.  'l' is the
optional privateValueLength from usmDHParameters in bits.  If 'l'
is omitted, then xa (and xr below) is selected in the interval 0
<= xa < p-1.  y is expressed as an OCTET STRING 'PV' of length 'k'
which satisfies

          k
    y =  SUM   2^(8(k-i)) PV'i
         i=1

    where PV1,...,PVk are the octets of PV from first to last, and
    where PV1 <> 0.

A successful SET consists of the value 'y' expressed as an OCTET
STRING as above concatenated with the value 'z'(expressed as an
OCTET STRING in the same manner as y) where z = g^xr MOD p, where
g, p and l are as above, and where xr is a new random integer
selected by the manager in the interval 2^(l-1) <= xr < 2^l <
p-1. A SET to an object of this type will fail with the error
wrongValue if the current 'y' does not match the 'y' portion of
the value of the varbind for the object. (E.g. GET yout, SET
concat(yin, z), yout <> yin).

Note that the private values xa and xr are never transmitted from
manager to device or vice versa, only the values y and z.
Obviously, these values must be retained until a successful SET on
the associated object.

The shared secret 'sk' is calculated at the agent as sk = z^xa MOD
p, and at the manager as sk = y^xr MOD p.

Each object definition of this type MUST describe how to map from
the shared secret 'sk' to the operational key value used by the
protocols and operations related to the object.  In general, if n
bits of key are required, the author suggests using the n
right-most bits of the shared secret as the operational key value.