Internet Draft Party MIB for SNMPv2 March 1995 Party MIB for Version 2 of the Simple Network Management Protocol (SNMPv2) 19 March 1995 | draft-ietf-snmpv2-party-ds-01.txt | Jeffrey D. Case | SNMP Research, Inc. | case@snmp.com | James Galvin | Trusted Information Systems galvin@tis.com Keith McCloghrie | Cisco Systems, Inc. | kzm@cisco.com | Marshall T. Rose | Dover Beach Consulting, Inc. | mrose@dbc.mtview.ca.us | Steven Waldbusser | Carnegie Mellon University | waldbusser@cmu.edu | Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as ``work in progress.'' To learn the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow Expires September 1995 [Page 1] Internet Draft Party MIB for SNMPv2 March 1995 Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim). Expires September 1995 [Page 2] Internet Draft Party MIB for SNMPv2 March 1995 1. Introduction A management system contains: several (potentially many) nodes, each with a processing entity, termed an agent, which has access to management instrumentation; at least one management station; and, a management protocol, used to convey management information between the agents and management stations. Operations of the protocol are carried out under an administrative framework which defines authentication, authorization, access control, and privacy policies. Management stations execute management applications which monitor and control managed elements. Managed elements are devices such as hosts, routers, terminal servers, etc., which are monitored and controlled via access to their management information. Management information is viewed as a collection of managed objects, residing in a virtual information store, termed the Management Information Base (MIB). Collections of related objects are defined in MIB modules. These modules are written using a subset of OSI's Abstract Syntax Notation One (ASN.1) [1], termed the Structure of Management Information (SMI) [2]. The Administrative Infrastructure for SNMPv2 document [3] defines the | properties associated with SNMPv2 parties, SNMPv2 contexts, and access control policies. It is the purpose of this document, the Party MIB for SNMPv2, to define managed objects which correspond to these properties. 1.1. A Note on Terminology For the purpose of exposition, the original Internet-standard Network Management Framework, as described in RFCs 1155, 1157, and 1212, is termed the SNMP version 1 framework (SNMPv1). The current framework is termed the SNMP version 2 framework (SNMPv2). 1.2. Change Log For the 19 March version: + - The many changes adopted by the SNMPv2 Working Group. + For the 1 November version: Expires September 1995 [Page 3] Internet Draft Party MIB for SNMPv2 March 1995 - recast RFC 1447 into an Internet-Draft, - fixed typos, - added snmpUDPDomain to the IMPORTS clause, - added descriptive text for the initial Context conventions, - added text to the DESCRIPTIONs of partyStatus, contextStatus, | acStatus, and viewStatus, specifying that columnar objects can | be modified without having to set the status column to 'notInService', - added clarifying text to the DESCRIPTIONs of contextLocal, contextLocalEntity, contextProxySrcParty, contextProxyDstParty, contextProxyContext, and contextStatus, - removed auxiliary objects from the definition of partyMIBGroup. Expires September 1995 [Page 4] Internet Draft Party MIB for SNMPv2 March 1995 2. Definitions SNMPv2-PARTY-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-IDENTITY, OBJECT-TYPE, snmpModules, | UInteger32, zeroDotZero | FROM SNMPv2-SMI snmpUDPDomain FROM SNMPv2-TM TEXTUAL-CONVENTION, RowStatus, TruthValue FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF; partyMIB MODULE-IDENTITY LAST-UPDATED "9503190000Z" | ORGANIZATION "IETF SNMPv2 Working Group" | CONTACT-INFO " Keith McCloghrie Postal: Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA Phone: +1 408 526 5260 Email: kzm@cisco.com" DESCRIPTION "The MIB module describing SNMPv2 parties." REVISION "9104300000Z" + DESCRIPTION + "The initial revision of this MIB module was published as + RFC 1447." + ::= { snmpModules 3 } Expires September 1995 [Page 5] Internet Draft Party MIB for SNMPv2 March 1995 -- textual conventions Party ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Denotes a SNMPv2 party identifier. Note that agents may impose implementation limitations on the length of OIDs used to identify Parties. As such, management stations creating new parties should be aware that using an excessively long OID may result in the agent refusing to perform the set operation and instead returning the appropriate error response, e.g., noCreation." SYNTAX OBJECT IDENTIFIER TAddress ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Denotes a transport service address. For snmpUDPDomain, a TAddress is 6 octets long, the initial 4 octets containing the IP-address in network-byte order and the last 2 containing the UDP port in network-byte order. Consult [5] for further information on snmpUDPDomain." SYNTAX OCTET STRING Clock ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "A party's authentication clock - a non-negative integer which is incremented as specified/allowed by the party's Authentication Protocol. For noAuth, a party's authentication clock is unused and its value is undefined. For v2md5AuthProtocol, a party's authentication clock is a relative clock with 1-second granularity." SYNTAX UInteger32 (0..2147483647) | Expires September 1995 [Page 6] Internet Draft Party MIB for SNMPv2 March 1995 Context ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Denotes a SNMPv2 context identifier. Note that agents may impose implementation limitations on the length of OIDs used to identify Contexts. As such, management stations creating new contexts should be aware that using an excessively long OID may result in the agent refusing to perform the set operation and instead returning the appropriate error response, e.g., noCreation." SYNTAX OBJECT IDENTIFIER AccessPrivileges ::= TEXTUAL-CONVENTION | STATUS current | DESCRIPTION | "A set of access privileges which specify the authorized set | of management operations between two SNMPv2 entities. | These privileges are specified as a sum of values, where | each value specifies a SNMPv2 PDU type by which the subject | party may request a permitted operation. The value for a | particular PDU type is computed as 2 raised to the value of | the ASN.1 context-specific tag for the appropriate SNMPv2 | PDU type. The values (for the tags defined in [5]) are | defined in [3] as: | Get : 1 | GetNext : 2 | Response : 4 | Set : 8 | unused : 16 | GetBulk : 32 | Inform : 64 | SNMPv2-Trap : 128 | The null set is represented by the value zero." | SYNTAX INTEGER (0..255) | Expires September 1995 [Page 7] Internet Draft Party MIB for SNMPv2 March 1995 StorageType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Describes the memory realization of a conceptual row. A | row which is volatile(2) is lost upon reboot. A row which | is either nonVolatile(3), permanent(4) or readOnly(5), is | backed up by stable storage. A row which is permanent(4) | can be changed but not deleted. A row which is readOnly(5) | cannot be changed nor deleted. | If the value of an object with this syntax is either | permanent(4) or readOnly(5), it cannot be modified. | Conversely, if the value is either other(1), volatile(2) or | nonVolatile(3), it cannot be modified to be permanent(4) or | readOnly(5). | Every usage of this textual convention is required to | specify the columnar objects which a permanent(4) row must | at a minimum allow to be writable." | SYNTAX INTEGER { other(1), -- eh? volatile(2), -- e.g., in RAM nonVolatile(3), -- e.g., in NVRAM permanent(4), -- e.g., partially in ROM | readOnly(5) -- e.g., completely in ROM | } Expires September 1995 [Page 8] Internet Draft Party MIB for SNMPv2 March 1995 -- administrative assignments partyAdmin OBJECT IDENTIFIER ::= { partyMIB 1 } -- definitions of security protocols partyProtocols OBJECT IDENTIFIER ::= { partyAdmin 1 } noAuth OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The protocol without authentication." | ::= { partyProtocols 1 } | noPriv OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The protocol without privacy." | ::= { partyProtocols 2 } | -- defined in [4] | desPrivProtocol OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The DES Privacy Protocol." | ::= { partyProtocols 3 } | -- defined in [4] | v2md5AuthProtocol OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The MD5 Authentication Protocol." | ::= { partyProtocols 4 } | Expires September 1995 [Page 9] Internet Draft Party MIB for SNMPv2 March 1995 -- definitions of temporal domains - temporalDomains OBJECT IDENTIFIER ::= { partyAdmin 2 } currentTime OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The temporal domain which refers to management information | at the current time." | ::= { temporalDomains 1 } | restartTime OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The temporal domain which refers to management information | upon the next re-initialization of the managed device." | ::= { temporalDomains 2 } | cacheTime OBJECT-IDENTITY | STATUS current | DESCRIPTION | "The prefix for temporal domains which refer to management | information that is cached. In particular, the temporal | domain: | { cacheTime N } | and guaranteed to be at most N seconds old." | ::= { temporalDomains 3 } | Expires September 1995 [Page 10] Internet Draft Party MIB for SNMPv2 March 1995 -- object assignments - partyMIBObjects OBJECT IDENTIFIER ::= { partyMIB 2 } -- SNMPv2 party information | snmpParties OBJECT IDENTIFIER ::= { partyMIBObjects 1 } partyTable OBJECT-TYPE SYNTAX SEQUENCE OF PartyEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SNMPv2 Party database." ::= { snmpParties 1 } partyEntry OBJECT-TYPE SYNTAX PartyEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Locally held information about a particular SNMPv2 party." INDEX { IMPLIED partyIdentity } ::= { partyTable 1 } Expires September 1995 [Page 11] Internet Draft Party MIB for SNMPv2 March 1995 PartyEntry ::= SEQUENCE { partyIdentity Party, partyIndex INTEGER, partyTDomain OBJECT IDENTIFIER, partyTAddress TAddress, partyMaxMessageSize INTEGER, partyLocal TruthValue, partyAuthProtocol OBJECT IDENTIFIER, partyAuthClock Clock, partyAuthPrivate OCTET STRING, partyAuthPublic OCTET STRING, partyAuthLifetime INTEGER, partyPrivProtocol OBJECT IDENTIFIER, partyPrivPrivate OCTET STRING, partyPrivPublic OCTET STRING, partyCloneFrom Party, partyStorageType StorageType, partyStatus RowStatus, | partyAuthChange OCTET STRING, | partyPrivChange OCTET STRING | } partyIdentity OBJECT-TYPE SYNTAX Party MAX-ACCESS not-accessible STATUS current DESCRIPTION "A party identifier uniquely identifying a particular SNMPv2 | party. This object is prohibited from taking the value { 0 | 0 }." | ::= { partyEntry 1 } Expires September 1995 [Page 12] Internet Draft Party MIB for SNMPv2 March 1995 partyIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) | MAX-ACCESS read-only STATUS current DESCRIPTION "An arbitrary unique value for each SNMPv2 party. | The value for each SNMPv2 party must remain constant at least from one re-initialization of the entity's network | management system to the next re-initialization. | The specific value is meaningful only within a given SNMPv2 | entity, i.e., it is not meaningful to any other SNMPv2 | entity except to uniquely identify the party within the set | of all parties known to this agent." | ::= { partyEntry 2 } partyTDomain OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the kind of transport service by which the party receives network management traffic." DEFVAL { snmpUDPDomain } ::= { partyEntry 3 } partyTAddress OBJECT-TYPE SYNTAX TAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The transport service address by which the party receives network management traffic, formatted according to the corresponding value of partyTDomain. The agent must listen + for SNMPv2 requests sent to this address. The default + assignment of a transport-layer 'port' is that specified by + the standard Transport Mapping for the kind of transport + service given by the corresponding value of partyTDomain. + For snmpUDPDomain, partyTAddress is formatted as a 4-octet IP Address concatenated with a 2-octet UDP port number." DEFVAL { '000000000000'H } ::= { partyEntry 4 } Expires September 1995 [Page 13] Internet Draft Party MIB for SNMPv2 March 1995 partyMaxMessageSize OBJECT-TYPE SYNTAX INTEGER (484..65507) MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum length in octets of a SNMPv2 message which this party will accept. For parties which execute at an agent, the agent initializes this object to the maximum length supported by the agent, and does not let the object be set to any larger value. For parties which do not execute at the agent, the agent must allow the manager to set this object to any legal value, even if it is larger than the agent can generate." DEFVAL { 484 } ::= { partyEntry 5 } partyLocal OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "An indication of whether this party executes at this SNMPv2 entity. If this object has a value of true(1), then the SNMPv2 entity will listen for SNMPv2 messages on the partyTAddress associated with this party. If this object has the value false(2), then the SNMPv2 entity will not listen for SNMPv2 messages on the partyTAddress associated with this party." DEFVAL { false } ::= { partyEntry 6 } Expires September 1995 [Page 14] Internet Draft Party MIB for SNMPv2 March 1995 partyAuthProtocol OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The authentication protocol by which all messages generated by the party are authenticated as to origin and integrity. The value noAuth signifies that messages generated by the party are not authenticated. An instance of this object is created concurrently with the | creation of any other object instance for the same party | (i.e., as part of the processing of the set operation which | creates the first object instance in the same conceptual | row). Once created, the value of an instance of this object | can not be changed." | DEFVAL { v2md5AuthProtocol } ::= { partyEntry 7 } partyAuthClock OBJECT-TYPE SYNTAX Clock MAX-ACCESS read-create STATUS current DESCRIPTION "The authentication clock which represents the local notion of the current time specific to the party. This value must not be decremented unless the party's private authentication key is changed simultaneously." DEFVAL { 0 } ::= { partyEntry 8 } Expires September 1995 [Page 15] Internet Draft Party MIB for SNMPv2 March 1995 partyAuthPrivate OBJECT-TYPE SYNTAX OCTET STRING -- for v2md5AuthProtocol: (SIZE (16)) MAX-ACCESS read-create STATUS current DESCRIPTION "An encoding of the party's private authentication key which may be needed to support the authentication protocol. Although the value of this variable may be altered by a management operation (e.g., a SNMPv2 Set-Request), its value can never be retrieved by a management operation: when read, the value of this variable is the zero length OCTET STRING. The private authentication key is NOT directly represented by the value of this variable, but rather it is represented according to an encoding. This encoding is the bitwise exclusive-OR of the old key with the new key, i.e., of the old private authentication key (prior to the alteration) with the new private authentication key (after the alteration). Thus, when processing a received protocol Set operation, the new private authentication key is obtained from the value of this variable as the result of a bitwise exclusive-OR of the variable's value and the old private authentication key. In calculating the exclusive-OR, if the old key is shorter than the new key, zero-valued padding is appended to the old key. If no value for the old key exists, a zero-length OCTET STRING is used in the calculation." DEFVAL { ''H } -- the empty string ::= { partyEntry 9 } Expires September 1995 [Page 16] Internet Draft Party MIB for SNMPv2 March 1995 partyAuthPublic OBJECT-TYPE SYNTAX OCTET STRING -- for v2md5AuthProtocol: (SIZE (0..16)) MAX-ACCESS read-create STATUS current DESCRIPTION "A publically-readable value for the party. Depending on the party's authentication protocol, this value may be needed to support the party's authentication protocol. Alternatively, it may be used by a manager during the procedure for altering secret information about a party. (For example, by altering the value of an instance of this object in the same SNMPv2 Set-Request used to update an instance of partyAuthPrivate, a subsequent Get-Request can determine if the Set-Request was successful in the event that no response to the Set-Request is received, see [4].) The length of the value is dependent on the party's authentication protocol. If not used by the authentication protocol, it is recommended that agents support values of any length up to and including the length of the corresponding partyAuthPrivate object." DEFVAL { ''H } -- the empty string ::= { partyEntry 10 } partyAuthLifetime OBJECT-TYPE SYNTAX INTEGER (0..2147483647) UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The lifetime (in units of seconds) which represents an administrative upper bound on acceptable delivery delay for protocol messages generated by the party. An instance of this object is created concurrently with the | creation of any other object instance for the same party | (i.e., as part of the processing of the set operation which | creates the first object instance in the same conceptual | row). Once created, the value of an instance of this object | can not be changed." | DEFVAL { 300 } ::= { partyEntry 11 } Expires September 1995 [Page 17] Internet Draft Party MIB for SNMPv2 March 1995 partyPrivProtocol OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The privacy protocol by which all protocol messages received by the party are protected from disclosure. The value noPriv signifies that messages received by the party are not protected. An instance of this object is created concurrently with the | creation of any other object instance for the same party | (i.e., as part of the processing of the set operation which | creates the first object instance in the same conceptual | row). Once created, the value of an instance of this object | can not be changed." | DEFVAL { noPriv } ::= { partyEntry 12 } Expires September 1995 [Page 18] Internet Draft Party MIB for SNMPv2 March 1995 partyPrivPrivate OBJECT-TYPE SYNTAX OCTET STRING -- for desPrivProtocol: (SIZE (16)) MAX-ACCESS read-create STATUS current DESCRIPTION "An encoding of the party's private encryption key which may be needed to support the privacy protocol. Although the value of this variable may be altered by a management operation (e.g., a SNMPv2 Set-Request), its value can never be retrieved by a management operation: when read, the value of this variable is the zero length OCTET STRING. The private encryption key is NOT directly represented by the value of this variable, but rather it is represented according to an encoding. This encoding is the bitwise exclusive-OR of the old key with the new key, i.e., of the old private encryption key (prior to the alteration) with the new private encryption key (after the alteration). Thus, when processing a received protocol Set operation, the new private encryption key is obtained from the value of this variable as the result of a bitwise exclusive-OR of the variable's value and the old private encryption key. In calculating the exclusive-OR, if the old key is shorter than the new key, zero-valued padding is appended to the old key. If no value for the old key exists, a zero-length OCTET STRING is used in the calculation." DEFVAL { ''H } -- the empty string ::= { partyEntry 13 } Expires September 1995 [Page 19] Internet Draft Party MIB for SNMPv2 March 1995 partyPrivPublic OBJECT-TYPE SYNTAX OCTET STRING -- for desPrivProtocol: (SIZE (0..16)) MAX-ACCESS read-create STATUS current DESCRIPTION "A publically-readable value for the party. Depending on the party's privacy protocol, this value may be needed to support the party's privacy protocol. Alternatively, it may be used by a manager as a part of its procedure for altering secret information about a party. (For example, by altering the value of an instance of this object in the same SNMPv2 Set-Request used to update an instance of partyPrivPrivate, a subsequent Get-Request can determine if the Set-Request was successful in the event that no response to the Set-Request is received, see [4].) The length of the value is dependent on the party's privacy protocol. If not used by the privacy protocol, it is recommended that agents support values of any length up to and including the length of the corresponding partyPrivPrivate object." DEFVAL { ''H } -- the empty string ::= { partyEntry 14 } Expires September 1995 [Page 20] Internet Draft Party MIB for SNMPv2 March 1995 partyCloneFrom OBJECT-TYPE SYNTAX Party MAX-ACCESS read-create STATUS current DESCRIPTION "The identity of a party to clone authentication and privacy parameters from. When read, the value { 0 0 } is returned. This value must be written exactly once, when the associated instance of partyStatus either does not exist or has the value `notReady'. When written, the value identifies a party, the cloning party, whose status column has the value `active'. The cloning party is used in two ways. One, if instances of the following objects do not exist for the party being created, then they are created with values identical to those of the corresponding objects for the cloning party: partyAuthProtocol partyAuthPublic partyAuthLifetime partyPrivProtocol partyPrivPublic Two, instances of the following objects are updated using the corresponding values of the cloning party: partyAuthPrivate partyPrivPrivate (e.g., the value of the cloning party's instance of the partyAuthPrivate object is XOR'd with the value of the partyAuthPrivate instances of the party being created.)" ::= { partyEntry 15 } Expires September 1995 [Page 21] Internet Draft Party MIB for SNMPv2 March 1995 partyStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row in the partyTable. | Conceptual rows having the value 'permanent' must allow | write-access at a minimum to: partyTDomain and partyTAddress | for all parties; partyAuthClock, partyAuthPrivate and | partyAuthPublic for parties employing authentication; and | partyPrivPrivate and partyPrivPublic for parties employing | privacy. | Note that any party which employs authentication or privacy | must allow its clock and secrets to be updated and thus | cannot be 'readOnly'." | DEFVAL { nonVolatile } ::= { partyEntry 16 } partyStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this conceptual row in the partyTable. A party is not qualified for activation until instances of all columns of its partyEntry row have an appropriate value. | In particular, one or more management set operations are | required to configure the party: | a value must be written to the party's partyCloneFrom | object, and | if the value of the party's partyAuthProtocol object is | not noAuth, | then the corresponding instance of partyAuthPrivate must contain a secret of the appropriate length. Further, at least one management protocol set operation updating the value of the party's partyAuthPrivate object must be | successfully processed before the partyAuthPrivate column | is considered appropriately configured, and | if the value of party's partyPrivProtocol object is not | Expires September 1995 [Page 22] Internet Draft Party MIB for SNMPv2 March 1995 noPriv, | then the corresponding instance of partyPrivPrivate must contain a secret of the appropriate length. Further, at least one management protocol set operation updating the value of the party's partyPrivPrivate object must be | successfully processed | before the partyPrivPrivate column is considered appropriately configured. Until instances of all corresponding columns are appropriately configured, the value of the corresponding instance of the partyStatus column is `notReady'. For those columnar objects which permit write-access (after | their initial creation), | their value in an existing conceptual row can be changed irrespective of the value of partyStatus for that row." ::= { partyEntry 17 } partyAuthChange OBJECT-TYPE + SYNTAX OCTET STRING -- typically (SIZE (0..32)) + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "A manager-generated, partially-random value which, when + modified, causes the corresponding instance of + partyAuthPrivate to be modified via a one-way function. + The value of an instance of this object is the concatenation + of two components: a 'random' component and a 'delta' + component. The lengths of the random and delta components + are given by the corresponding value of partyAuthProtocol; + for authentication protocols requiring partyAuthPrivate to + be a fixed length, the length of both the random and delta + components is that fixed length; for authentication + protocols allowing the length of partyAuthPrivate to be + variable up to a particular maximum length, the length of + the random component is that maximum length and the length + of the delta component is any length less than or equal to + the maximum length. For example, v2md5AuthProtocol requires + a fixed length of 16 octets, and for the purposes of this + definition, noAuth and rfc1157noAuth allow a variable length + up to a maximum of 16 octets. Other authentication + protocols may define other sizes, as deemed appropriate. + Expires September 1995 [Page 23] Internet Draft Party MIB for SNMPv2 March 1995 When an instance of this object is modified to have a new + value by the management protocol, the agent generates a new + value of the corresponding instance of partyAuthPrivate as + follows: + - the existing value of the corresponding instance of + partyAuthPrivate is extended if necessary with zero-value + padding to be the same length as the random component; + - the new value of the random component is appended to the + (possibly extended) value of the corresponding instance of + partyAuthPrivate, and the result is subjected to the MD5 + hash algorithm to produce a digest value; + - this digest value, truncated if necessary to be the same + length as the new value of the delta component, is XOR-ed + with the new value of the delta component to produce the + new value of the corresponding instance of + partyAuthPrivate. + i.e., + keyIntermediate = md5(keyold XOR randomComponent) + keynew = deltaComponent XOR keyIntermediate + The value of this object whenever it is retrieved by the + management protocol is always the zero-length string." + DEFVAL { ''H } -- the empty string + ::= { partyEntry 18 } + partyPrivChange OBJECT-TYPE + SYNTAX OCTET STRING -- typically (SIZE (0..32)) + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "A manager-generated, partially-random value which, when + modified, causes the corresponding instance of + partyPrivPrivate to be modified via a one-way function. + The value of an instance of this object is the concatenation + of two components: a 'random' component and a 'delta' + component. The lengths of the random and delta components + are given by the corresponding value of partyPrivProtocol; + for privacy protocols requiring partyPrivPrivate to be a + fixed length, the length of both the random and delta + components is that fixed length; for privacy protocols + allowing the length of partyPrivPrivate to be variable up to + Expires September 1995 [Page 24] Internet Draft Party MIB for SNMPv2 March 1995 a particular maximum length, the length of the random + component is that maximum length and the length of the delta + component is any length less than or equal to the maximum + length. For example, desPrivProtocol requires a fixed + length of 16 octets, and for the purposes of this + definition, noPriv allows a variable length up to a maximum + of 16 octets. Other privacy protocols may define other + sizes, as deemed appropriate. + When an instance of this object is modified to have a new + value by the management protocol, the agent generates a new + value of the corresponding instance of partyPrivPrivate as + follows: + - the existing value of the corresponding instance of + partyPrivPrivate is extended if necessary with zero-value + padding to be the same length as the random component; + - the new value of the random component is appended to the + (possibly extended) value of the corresponding instance of + partyPrivPrivate, and the result is subjected to the MD5 + hash algorithm to produce a digest value; + - this digest value, truncated if necessary to be the same + length as the new value of the delta component, is XOR-ed + with the new value of the delta component to produce the + new value of the corresponding instance of + partyPrivPrivate. + i.e., + keyIntermediate = md5(keyold XOR randomComponent) + keynew = deltaComponent XOR keyIntermediate + The value of this object whenever it is retrieved by the + management protocol is always the zero-length string." + DEFVAL { ''H } -- the empty string + ::= { partyEntry 19 } + partySecretSpinLock OBJECT-TYPE + SYNTAX TestAndIncr + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "An advisory lock used to allow several cooperating SNMPv2 + entities, all acting in a manager role, to coordinate their + Expires September 1995 [Page 25] Internet Draft Party MIB for SNMPv2 March 1995 use of facilities to alter secrets in the Party Table." + ::= { snmpParties 2 } + Expires September 1995 [Page 26] Internet Draft Party MIB for SNMPv2 March 1995 -- Agent Identifier | agentID OBJECT-TYPE + SYNTAX OCTET STRING (SIZE (12)) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The agent's administratively-unique identifier. + The initial value for this object may be configured via an + operator console entry or via an algorithmic function. In + the later case, the following guidelines are recommended: + 1) The first four octets should be set to the binary + equivalent of the agent's SNMP network management + private enterprise number as assigned by the Internet + Assigned Numbers Authority (IANA). For example, if + Acme Networks has been assigned { enterprises 696 }, + the first four octets would be assigned '000002b8'H. + 2) The remaining eight octets are the cookie whose + contents are determined via one or more enterprise- + specific methods. Such methods must be designed so as + to maximize the possibility that the value of this + object will be unique in the agent's administrative + domain. For example, the cookie may be the IP address + of the agent, or the MAC address of one of the + interfaces, with each address suitably padded with + random octets. If multiple methods are defined, then + it is recommended that the cookie be further divided + into one octet that indicates the method being used and + seven octets which are a function of the method. + If set by a management operation, the value must be + persistent across re-initializations of the entity's network + management system." + ::= { snmpParties 3 } + Expires September 1995 [Page 27] Internet Draft Party MIB for SNMPv2 March 1995 -- SNMPv2 contexts + snmpContexts OBJECT IDENTIFIER ::= { partyMIBObjects 2 } contextTable OBJECT-TYPE SYNTAX SEQUENCE OF ContextEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SNMPv2 Context database." ::= { snmpContexts 1 } contextEntry OBJECT-TYPE SYNTAX ContextEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Locally held information about a particular SNMPv2 context." INDEX { IMPLIED contextIdentity } ::= { contextTable 1 } ContextEntry ::= SEQUENCE { contextIdentity Context, contextIndex INTEGER, contextLocalEntity OCTET STRING, - contextLocalTime OBJECT IDENTIFIER, contextProxyDstParty Party, contextProxySrcParty Party, contextProxyContext OBJECT IDENTIFIER, contextStorageType StorageType, contextStatus RowStatus, | contextType INTEGER | } Expires September 1995 [Page 28] Internet Draft Party MIB for SNMPv2 March 1995 contextIdentity OBJECT-TYPE SYNTAX Context MAX-ACCESS not-accessible STATUS current DESCRIPTION "A context identifier uniquely identifying a particular | SNMPv2 context. This object is prohibited from taking the | value { 0 x } for any value of x." | ::= { contextEntry 1 } contextIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) | MAX-ACCESS read-only STATUS current DESCRIPTION "An arbitrary unique value for each SNMPv2 context. | The value for each SNMPv2 context must remain constant at least from one re-initialization of the entity's network | management system to the next re-initialization. | The specific value is meaningful only within a given SNMPv2 | entity, i.e., it is not meaningful to any other SNMPv2 | entity except to uniquely identify the context within the | set of all contexts known to this agent." | ::= { contextEntry 2 } -- ::= { contextEntry 3 } this OID is obsolete | -- ::= { contextEntry 4 } this OID is obsolete | Expires September 1995 [Page 29] Internet Draft Party MIB for SNMPv2 March 1995 contextLocalEntity OBJECT-TYPE - SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION "If the value of the corresponding instance of the | contextType is local(1), then the value of an instance of | this object uniquely identifies the local entity (e.g., a | logical device managed by the same agent) | whose management information is in the SNMPv2 context's MIB view. The empty string indicates that the MIB view contains the SNMPv2 entity's own local management information; otherwise, a non-empty string indicates that the MIB view contains management information of some other local entity, e.g., 'Repeater1'. If the value of the corresponding instance of the | contextType is remote(2), then the value of an instance of | this object identifies an entity which is local to the | SNMPv2 entity which realizes this SNMPv2 context, and whose | management information is in the SNMPv2 context's MIB view. | If the value of the corresponding instance of the | contextType is proxy(3), then the value of an instance of | this object is ignored and can take any value at the agent's | discretion, e.g., the zero-length string." | DEFVAL { ''H } -- the empty string ::= { contextEntry 5 } contextLocalTime OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "If the value of the corresponding instance of the | contextType is local(1) or remote(2), | then the value of an instance of this object identifies the temporal context of the management information in the MIB view. If the value of the corresponding instance of the | contextType is proxy(3), then the value of an instance of | this object is ignored and can take any value at the agent's | discretion, e.g., { 0 0 }." | DEFVAL { currentTime } Expires September 1995 [Page 30] Internet Draft Party MIB for SNMPv2 March 1995 ::= { contextEntry 6 } contextProxyDstParty OBJECT-TYPE SYNTAX Party MAX-ACCESS read-create STATUS current DESCRIPTION "If the corresponding instance of contextType has the value | proxy(3), and if requests referencing this context are to be | forwarded, then the value of an instance of this object | identifies the proxy destination party to be used in such | forwarded requests. Otherwise, the value of an instance of | this object is ignored and can take any value at the agent's | discretion, e.g., { 0 0 }." | DEFVAL { zeroDotZero } + ::= { contextEntry 7 } contextProxySrcParty OBJECT-TYPE SYNTAX Party MAX-ACCESS read-create STATUS current DESCRIPTION "If the corresponding instance of contextType has the value | proxy(3), and if requests referencing this context are to be | forwarded, then the value of an instance of this object | identifies the proxy source party to be used in such | forwarded requests. Otherwise, the value of an instance of | this object is ignored and can take any value at the agent's | discretion, e.g., { 0 0 }. | Interpretation of an instance of this object depends upon the transport domain of the proxy destination party (i.e., upon the value of partyTDomain for the party identified by the corresponding instance of contextProxyDstParty)." | DEFVAL { zeroDotZero } + ::= { contextEntry 8 } Expires September 1995 [Page 31] Internet Draft Party MIB for SNMPv2 March 1995 contextProxyContext OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "If the corresponding instance of contextType has the value | proxy(3), and if requests referencing this context are to be | forwarded, then the value of an instance of this object | identifies the context to be used in such forwarded | requests. Otherwise, the value of an instance of this | object is ignored and can take any value at the agent's | discretion, e.g., { 0 0 }. | Interpretation of an instance of this object depends upon the value of the transport domain associated with the SNMPv2 party used as the proxy destination for this proxy context." | DEFVAL { zeroDotZero } + ::= { contextEntry 9 } contextStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row in the | contextTable. Conceptual rows having the value 'permanent' | need not allow write-access to any columnar objects in the | row, unless they are proxy contexts in which case they must | allow at a minimum write-access to: contextProxyDstParty, | contextProxySrcParty and contextProxyContext." | DEFVAL { nonVolatile } ::= { contextEntry 10 } Expires September 1995 [Page 32] Internet Draft Party MIB for SNMPv2 March 1995 contextStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this conceptual row in the contextTable. A context is not qualified for activation until instances of | all corresponding columns have consistent values. | For those columnar objects which permit write-access, their - value in an existing conceptual row can be changed irrespective of the value of contextStatus for that row." ::= { contextEntry 11 } contextType OBJECT-TYPE + SYNTAX INTEGER { local(1), remote(2), proxy(3) } + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The type of context. + local(1) - this conceptual row refers to a SNMPv2 context + containing MIB views of a locally accessible entity; + the value of the corresponding instances of the + contextLocalEntity and contextLocalTime objects provide + further information on the local entity and its + temporal domain. + remote(2) - this conceptual row refers to a SNMPv2 context + which is realized by a remote SNMPv2 entity. + proxy(3) - this conceptual row refers to a SNMPv2 proxy + context; the values of the corresponding instances of + the contextProxyDstParty, contextProxySrcParty, and + contextProxyContext objects provide further information + on the proxied context and the parties used to access + it." + DEFVAL { local } + ::= { contextEntry 12 } + Expires September 1995 [Page 33] Internet Draft Party MIB for SNMPv2 March 1995 -- SNMPv2 access privileges | snmpAccess OBJECT IDENTIFIER ::= { partyMIBObjects 3 } -- ::= { snmpAccess 1 } this OID is obsolete + acTable OBJECT-TYPE | SYNTAX SEQUENCE OF AcEntry | MAX-ACCESS not-accessible STATUS current DESCRIPTION "The access privileges database." ::= { snmpAccess 2 } | acEntry OBJECT-TYPE | SYNTAX AcEntry | MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each conceptual row in this table represents an individual | access policy, called an ACL (for historical reasons). | An ACL specifies the access privileges authorized for | communication from one SNMPv2 party to another concerning | information contained in a particular SNMPv2 context. | For each conceptual row in this table which is retained | across a re-initialization of the entity's network | management system, the combination of the partyIdentity | values of the referenced parties and the contextIdentity | value of the referenced context must be the same after the | re-initialization as it was before the re-initialization, | even if the values of acTarget, acSubject and acContext | vary." | INDEX { acTarget, acSubject, acContext } | ::= { acTable 1 } | Expires September 1995 [Page 34] Internet Draft Party MIB for SNMPv2 March 1995 AcEntry ::= | SEQUENCE { acTarget INTEGER, | acSubject INTEGER, | acContext INTEGER, | acPrivileges AccessPrivileges, | acReadViewIndex INTEGER, | acWriteViewIndex INTEGER, | acStorageType StorageType, | acStatus RowStatus | } acTarget OBJECT-TYPE | SYNTAX INTEGER (1..2147483647) | MAX-ACCESS not-accessible STATUS current DESCRIPTION "The value of partyIndex for one of the SNMPv2 parties | between which communication is authorized concerning | information contained in a particular SNMPv2 context. In | particular, for retrieval or set operations, this object | identifies the destination party; for notification | operations, this object identifies the source party." | ::= { acEntry 1 } | acSubject OBJECT-TYPE | SYNTAX INTEGER (1..2147483647) | MAX-ACCESS not-accessible STATUS current DESCRIPTION "The value of partyIndex for one of the SNMPv2 parties | between which communication is authorized concerning | information contained in a particular SNMPv2 context. In | particular, for retrieval or set operations, this object | identifies the source party; for notification operations, | this object identifies the destination party." | ::= { acEntry 2 } | Expires September 1995 [Page 35] Internet Draft Party MIB for SNMPv2 March 1995 acContext OBJECT-TYPE | SYNTAX INTEGER (1..2147483647) | MAX-ACCESS not-accessible STATUS current DESCRIPTION "The value of this instance identifies the SNMPv2 context | associated with a particular set of access privileges, | and has the same value as the instance of the contextIndex object for that SNMPv2 context." ::= { acEntry 3 } | Expires September 1995 [Page 36] Internet Draft Party MIB for SNMPv2 March 1995 acPrivileges OBJECT-TYPE | SYNTAX AccessPrivileges | MAX-ACCESS read-create STATUS current DESCRIPTION "The access privileges authorized for communication between | a particular local SNMPv2 party and a particular remote | SNMPv2 party concerning information contained in a | particular SNMPv2 context." | DEFVAL { 35 } -- Get, Get-Next & Get-Bulk | ::= { acEntry 4 } | acReadViewIndex OBJECT-TYPE + SYNTAX INTEGER (0..2147483647) + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "If, for the SNMPv2 context identified by the corresponding + instance of acContext, the value of contextType is local(1), + then the value of an instance of this object identifies the + MIB view of the SNMPv2 context to which this conceptual row + authorizes read access. The identified MIB view is that for + which viewIndex has the same value as the instance of this + object; if the value is zero or there are no active view + subtrees for that value, then the identified MIB view is the + empty set of view subtrees. (Note that read access includes + access via retrieval requests as well as transmission of + information via notification requests.) + Otherwise, this object is ignored and can take any value at + the agent's discretion, e.g., zero." + DEFVAL { 0 } | ::= { acEntry 5 } | Expires September 1995 [Page 37] Internet Draft Party MIB for SNMPv2 March 1995 acWriteViewIndex OBJECT-TYPE | SYNTAX INTEGER (0..2147483647) | MAX-ACCESS read-create | STATUS current | DESCRIPTION | "If, for the SNMPv2 context identified by the corresponding | instance of acContext, the value of contextType is local(1), | then the value of an instance of this object identifies the | MIB view of the SNMPv2 context to which this conceptual row | authorizes write access. The identified MIB view is that | for which viewIndex has the same value as the instance of | this object; if the value is zero or there are no active | view subtrees for that value, then the identified MIB view | is the empty set of view subtrees. | Otherwise, this object is ignored and can take any value at | the agent's discretion, e.g., zero." | DEFVAL { 0 } | ::= { acEntry 6 } | acStorageType OBJECT-TYPE | SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row in the acTable. | Conceptual rows having the value 'permanent' need not allow | write-access to any columnar objects in the row." | DEFVAL { nonVolatile } ::= { acEntry 7 } | acStatus OBJECT-TYPE | SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this conceptual row in the acTable. | For those columnar objects which permit write-access, their value in an existing conceptual row can be changed | irrespective of the value of acStatus for that row. | A conceptual row in this table is not qualified for | activation until the context and both parties it references | are active. Further, a conceptual row in this table is | Expires September 1995 [Page 38] Internet Draft Party MIB for SNMPv2 March 1995 immediately made notInService whenever the status of the | context or either party it references is made notInService, | Finally, a conceptual row in this table is immediately | destroyed whenever the context or either party it references | is destroyed." | ::= { acEntry 8 } | Expires September 1995 [Page 39] Internet Draft Party MIB for SNMPv2 March 1995 -- MIB views | snmpViews OBJECT IDENTIFIER ::= { partyMIBObjects 4 } viewNextIndex OBJECT-TYPE + SYNTAX INTEGER (0..2147483647) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The next unassigned value of viewIndex. The value 0 + indicates that no unassigned values are available. + Reading a non-zero value causes the assignment of the + retrieved value for use as the viewIndex of a future MIB + view, and thus causes the value of this object to change. + The algorithm for changing nextViewIndex is implementation- + dependent, and the agent may use a subset of values within + 1..2147483647, but the agent must guarantee that the value + held by this object is not assigned to any in-use value of + viewIndex, e.g., is not pointed to by any other MIB object. + A management station creates a new MIB view using this + algorithm: first, issue a management protocol retrieval + operation to obtain the value of viewNextIndex - this value + is used as the viewIndex of the new MIB view; and, second, + issue a management protocol set operation to create an + instance of the viewStatus object setting its value to + `createAndGo' or `createAndWait' (as specified in the + description of the RowStatus textual convention)." + ::= { snmpViews 2 } + viewTable OBJECT-TYPE SYNTAX SEQUENCE OF ViewEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Locally held information about the subtrees of MIB views | known to this SNMPv2 entity. Note that a MIB view which has | no subtrees defined for it has no entries in this table. | Each SNMPv2 context which is locally accessible has zero or | more MIB views. Each MIB view is defined by two collections | of view subtrees: the included view subtrees, and the | excluded view subtrees. | Expires September 1995 [Page 40] Internet Draft Party MIB for SNMPv2 March 1995 Every such subtree, both included and excluded, is defined in this table. To determine if a particular object instance is in a particular MIB view, compare the object instance's OBJECT IDENTIFIER with each of the MIB view's active entries | in this table. If none match, then the object instance is not in the MIB view. If one or more match, then the object instance is included in, or excluded from, the MIB view according to the value of viewType in the entry whose value of viewSubtree has the most sub-identifiers. If multiple entries match and have the same number of sub-identifiers, then the lexicographically greatest instance of viewType determines the inclusion or exclusion. An object instance's OBJECT IDENTIFIER X matches an active | entry in this table | when the number of sub-identifiers in X is at least as many as in the value of viewSubtree for the entry, and each sub- identifier in the value of viewSubtree matches its corresponding sub-identifier in X. Two sub-identifiers match either if the corresponding bit of viewMask is zero (the 'wild card' value), or if they are equal. Due to this 'wild card' capability, we introduce the term, a 'family' of view subtrees, to refer to the set of subtrees defined by a particular combination of values of viewSubtree and viewMask. In the case where no 'wild card' is defined in viewMask, the family of view subtrees reduces to a single view subtree." ::= { snmpViews 1 } Expires September 1995 [Page 41] Internet Draft Party MIB for SNMPv2 March 1995 viewEntry OBJECT-TYPE SYNTAX ViewEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information on a particular family of view subtrees included in or excluded from a particular SNMPv2 context's MIB view. Implementations must not restrict the number of families of view subtrees for a given MIB view, except as dictated by resource constraints on the overall number of entries in the viewTable." INDEX { viewIndex, IMPLIED viewSubtree } ::= { viewTable 1 } ViewEntry ::= SEQUENCE { viewIndex INTEGER, viewSubtree OBJECT IDENTIFIER, viewMask OCTET STRING, viewType INTEGER, viewStorageType StorageType, viewStatus RowStatus } viewIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) | MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary unique value for each MIB view. | The value for each MIB view must remain constant at least from one re-initialization of the entity's network | management system to the next re-initialization. | The specific value is meaningful only within a given SNMPv2 | entity, i.e., it is not meaningful to any other SNMPv2 | entity except to uniquely identify the view within the set | of all views known to this agent." | ::= { viewEntry 1 } Expires September 1995 [Page 42] Internet Draft Party MIB for SNMPv2 March 1995 viewSubtree OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS not-accessible STATUS current DESCRIPTION "A MIB subtree." ::= { viewEntry 2 } viewMask OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..16)) MAX-ACCESS read-create STATUS current DESCRIPTION "The bit mask which, in combination with the corresponding instance of viewSubtree, defines a family of view subtrees. Each bit of this bit mask corresponds to a sub-identifier of viewSubtree, with the most significant bit of the i-th octet of this octet string value (extended if necessary, see below) corresponding to the (8*i - 7)-th sub-identifier, and the least significant bit of the i-th octet of this octet string corresponding to the (8*i)-th sub-identifier, where i is in the range 1 through 16. Each bit of this bit mask specifies whether or not the corresponding sub-identifiers must match when determining if an OBJECT IDENTIFIER is in this family of view subtrees; a '1' indicates that an exact match must occur; a '0' indicates 'wild card', i.e., any sub-identifier value matches. Thus, the OBJECT IDENTIFIER X of an object instance is contained in a family of view subtrees if the following criteria are met: for each sub-identifier of the value of viewSubtree, either: the i-th bit of viewMask is 0, or the i-th sub-identifier of X is equal to the i-th sub-identifier of the value of viewSubtree. If the value of this bit mask is M bits long and there are more than M sub-identifiers in the corresponding instance of Expires September 1995 [Page 43] Internet Draft Party MIB for SNMPv2 March 1995 viewSubtree, then the bit mask is extended with 1's to be the required length. Note that when the value of this object is the zero-length string, this extension rule results in a mask of all-1's being used (i.e., no 'wild card'), and the family of view subtrees is the one view subtree uniquely identified by the corresponding instance of viewSubtree." DEFVAL { ''H } ::= { viewEntry 3 } viewType OBJECT-TYPE SYNTAX INTEGER { included(1), excluded(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "The status of a particular family of view subtrees within the particular SNMPv2 context's MIB view. The value 'included(1)' indicates that the corresponding instances of viewSubtree and viewMask define a family of view subtrees included in the MIB view. The value 'excluded(2)' indicates that the corresponding instances of viewSubtree and viewMask define a family of view subtrees excluded from the MIB view." DEFVAL { included } ::= { viewEntry 4 } viewStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row in the viewTable. | Conceptual rows having the value 'permanent' need not allow | write-access to any columnar objects in the row." | DEFVAL { nonVolatile } ::= { viewEntry 5 } Expires September 1995 [Page 44] Internet Draft Party MIB for SNMPv2 March 1995 viewStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this conceptual row in the viewTable. For those columnar objects which permit write-access, their value in an existing conceptual row can be changed irrespective of the value of viewStatus for that row." ::= { viewEntry 6 } Expires September 1995 [Page 45] Internet Draft Party MIB for SNMPv2 March 1995 -- conformance information + partyMIBConformance OBJECT IDENTIFIER ::= { partyMIB 3 } partyMIBCompliances OBJECT IDENTIFIER ::= { partyMIBConformance 1 } partyMIBGroups OBJECT IDENTIFIER ::= { partyMIBConformance 2 } -- compliance statements unSecurableCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Party MIB, but do not support any authentication or privacy protocols (i.e., only the noAuth and noPriv protocols are supported)." MODULE -- this module MANDATORY-GROUPS { partyMIBGroup } ::= { partyMIBCompliances 1 } partyNoPrivacyCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Party MIB, and support an authentication protocol, but do not support any privacy protocols (i.e., only the noAuth, v2md5AuthProtocol, and noPriv protocols are supported)." MODULE -- this module MANDATORY-GROUPS { partyMIBGroup } ::= { partyMIBCompliances 2 } Expires September 1995 [Page 46] Internet Draft Party MIB for SNMPv2 March 1995 partyPrivacyCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Party MIB, support an authentication protocol, and support a privacy protocol ONLY for the purpose of accessing security parameters. For all acTable entries authorizing a local and/or remote | SNMPv2 party | whose privacy protocol is desPrivProtocol, to be used in accessing a SNMPv2 context, the MIB view for that SNMPv2 context shall include only those objects subordinate to partyMIBObjects, or a subset thereof, e.g., viewSubtree = { partyMIBObjects } viewMask = ''H viewType = { included } Any attempt to configure an entry in the partyTable, the contextTable, the acTable or the viewTable such that | a party using the desPrivProtocol would be authorized for use in accessing objects outside of the partyMIBObjects subtree shall result in the appropriate error response (e.g., wrongValue or inconsistentValue)." MODULE -- this module MANDATORY-GROUPS { partyMIBGroup } ::= { partyMIBCompliances 3 } fullPrivacyCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Party MIB, support an authentication protocol, and support a privacy protocol without restrictions on its use." MODULE -- this module MANDATORY-GROUPS { partyMIBGroup } ::= { partyMIBCompliances 4 } Expires September 1995 [Page 47] Internet Draft Party MIB for SNMPv2 March 1995 -- units of conformance partyMIBGroup OBJECT-GROUP OBJECTS { partyIndex, partyTDomain, partyTAddress, partyMaxMessageSize, partyLocal, partyAuthProtocol, partyAuthClock, partyAuthPrivate, partyAuthPublic, partyAuthLifetime, partyPrivProtocol, partyPrivPrivate, partyPrivPublic, partyStorageType, partyStatus, partyCloneFrom, partyAuthChange, partyPrivChange, | partySecretSpinLock, | agentID, | contextIndex, contextType, contextLocalEntity, | contextLocalTime, contextStorageType, contextStatus, acPrivileges, acStorageType, acStatus, | acReadViewIndex, acWriteViewIndex, | viewNextIndex, | viewMask, viewType, viewStorageType, viewStatus } STATUS current DESCRIPTION "The collection of objects allowing the description and configuration of SNMPv2 parties. Note that objects which support proxy contexts are not included in this conformance group." ::= { partyMIBGroups 1 } partyMIBProxyGroup OBJECT-GROUP + OBJECTS { contextProxySrcParty, contextProxyDstParty, + contextProxyContext } + STATUS current + DESCRIPTION + "The collection of objects needed for the support of proxy + SNMPv2 contexts." + ::= { partyMIBGroups 2 } + END + Expires September 1995 [Page 48] Internet Draft Party MIB for SNMPv2 March 1995 3. Acknowledgments The authors wish to acknowledge the contributions of the SNMPv2 Working Group in general. In particular, the following individuals Dave Arneson (Cabletron), Uri Blumenthal (IBM), Doug Book (Chipcom), Maria Greene (Ascom Timeplex), Deirdre Kostik (Bellcore), Dave Harrington (Cabletron), Jeff Johnson (Cisco Systems), Brian O'Keefe (Hewlett Packard), Dave Perkins (Bay Networks), Randy Presuhn (Peer Networks), Shawn Routhier (Epilogue), Bob Stewart (Cisco Systems), Kaj Tesink (Bellcore). deserve special thanks for their contributions. 4. References [1] Information processing systems - Open Systems Interconnection - Specification of Abstract Syntax Notation One (ASN.1), International Organization for Standardization. International Standard 8824, (December, 1987). [2] Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2)", Internet Draft, SNMP Research, Inc., Cisco Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, November 1994. [3] Case, J., Galvin, J., McCloghrie, K., Rose, M., and Waldbusser, S., | "Administrative Infrastructure for Version 2 of the Simple Network | Management Protocol (SNMPv2)", | Internet Draft, SNMP Research, Inc., Trusted Information Systems, | Cisco Systems, Dover Beach Consulting, Inc., Carnegie Mellon | University, | November 1994. [4] Case, J., Galvin, J., McCloghrie, K., Rose, M., and Waldbusser, S., | "Security Protocols for Version 2 of the Simple Network Management Expires September 1995 [Page 49] Internet Draft Party MIB for SNMPv2 March 1995 Protocol (SNMPv2)", Internet Draft, SNMP Research, Inc., Trusted | Information Systems, Cisco Systems, Dover Beach Consulting, Inc., | Carnegie Mellon University, | November 1994. [5] Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)", Internet Draft, SNMP Research, Inc., Cisco Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, November 1994. [5] Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2)", Internet Draft, SNMP Research, Inc., Cisco Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, November 1994. Expires September 1995 [Page 50] Internet Draft Party MIB for SNMPv2 March 1995 5. Security Considerations Security issues are not discussed in this memo. 6. Authors' Addresses Jeffrey D. Case | SNMP Research, Inc. | 3001 Kimberlin Heights Rd. | Knoxville, TN 37920-9716 | US | Phone: +1 615 573 1434 | Email: case@snmp.com | James M. Galvin Trusted Information Systems, Inc. 3060 Washington Road, Route 97 Glenwood, MD 21738 Phone: +1 301 854-6889 EMail: galvin@tis.com Keith McCloghrie + Cisco Systems, Inc. + 170 West Tasman Drive, + San Jose CA 95134-1706. + Phone: +1 408 526 5260 + Email: kzm@cisco.com + Marshall T. Rose + Dover Beach Consulting, Inc. + 420 Whisman Court + Mountain View, CA 94043-2186 + US + Phone: +1 415 968 1052 + Email: mrose@dbc.mtview.ca.us + Expires September 1995 [Page 51] Internet Draft Party MIB for SNMPv2 March 1995 Steven Waldbusser + Carnegie Mellon University + 5000 Forbes Ave + Pittsburgh, PA 15213 + US + Phone: +1 412 268 6628 + Email: waldbusser@cmu.edu + Expires September 1995 [Page 52] Internet Draft Party MIB for SNMPv2 March 1995 Table of Contents 1 Introduction .................................................... 3 1.1 A Note on Terminology ......................................... 3 1.2 Change Log .................................................... 3 2 Definitions ..................................................... 5 3.1 Textual Conventions ........................................... 6 3.2 Administrative Assignments .................................... 9 3.3 Object Assignments ............................................ 11 3.4 SNMPv2 Party Information ...................................... 11 3.5 Agent Identifier .............................................. 27 3.6 SNMPv2 Contexts ............................................... 28 3.7 SNMPv2 Access Privileges ...................................... 34 3.8 MIB Views ..................................................... 40 3.9 Conformance Information ....................................... 46 3.9.1 Compliance Statements ....................................... 46 3.9.2 Units of Conformance ........................................ 48 3 Acknowledgments ................................................. 49 4 References ...................................................... 49 5 Security Considerations ......................................... 51 6 Authors' Addresses .............................................. 51 Expires September 1995 [Page 53]