mibs/ietf/SNMP-COMMUNITY-MIB

   1 SNMP-COMMUNITY-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     IpAddress,
   5     MODULE-IDENTITY,
   6     OBJECT-TYPE,
   7     Integer32,
   8     snmpModules
   9         FROM SNMPv2-SMI
  10     RowStatus,
  11     StorageType
  12         FROM SNMPv2-TC
  13     SnmpAdminString,
  14     SnmpEngineID
  15         FROM SNMP-FRAMEWORK-MIB
  16     SnmpTagValue,
  17     snmpTargetAddrEntry
  18         FROM SNMP-TARGET-MIB
  19     MODULE-COMPLIANCE,
  20     OBJECT-GROUP
  21         FROM SNMPv2-CONF;
  22
  23 snmpCommunityMIB MODULE-IDENTITY
  24     LAST-UPDATED "200003060000Z"          -- 6 Mar 2000, midnight
  25     ORGANIZATION "SNMPv3 Working Group"
  26     CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
  27                   Subscribe:  majordomo@lists.tislabs.com
  28                               In msg body:  subscribe snmpv3
  29
  30                   Chair:      Russ Mundy
  31                               TIS Labs at Network Associates
  32                   Postal:     3060 Washington Rd
  33                               Glenwood MD 21738
  34                               USA
  35                   Email:      mundy@tislabs.com
  36                   Phone:      +1-301-854-6889
  37
  38
  39
  40                   Co-editor:  Rob Frye
  41                               CoSine Communications
  42                   Postal:     1200 Bridge Parkway
  43                               Redwood City, CA 94065
  44                               USA
  45                   E-mail:     rfrye@cosinecom.com
  46                   Phone:      +1 703 725 1130
  47
  48                   Co-editor:  David B. Levi
  49                               Nortel Networks
  50                   Postal:     3505 Kesterwood Drive
  51                               Knoxville, TN 37918
  52                   E-mail:     dlevi@nortelnetworks.com
  53                   Phone:      +1 423 686 0432
  54
  55                   Co-editor:  Shawn A. Routhier
  56                               Integrated Systems Inc.
  57                   Postal:     333 North Ave 4th Floor
  58                               Wakefield, MA 01880
  59                   E-mail:     sar@epilogue.com
  60                   Phone:      +1 781 245 0804
  61
  62                   Co-editor:  Bert Wijnen
  63                               Lucent Technologies
  64                   Postal:     Schagen 33
  65                               3461 GL Linschoten
  66                               Netherlands
  67                   Email:      bwijnen@lucent.com
  68                   Phone:      +31-348-407-775
  69                  "
  70
  71         DESCRIPTION
  72             "This MIB module defines objects to help support coexistence
  73              between SNMPv1, SNMPv2c, and SNMPv3."
  74         REVISION "200003060000Z" -- 6 Mar 2000
  75         DESCRIPTION "This version published as RFC 2576."
  76         REVISION "199905130000Z" -- 13 May 1999
  77         DESCRIPTION "The Initial Revision"
  78     ::= { snmpModules 18 }
  79
  80 -- Administrative assignments ****************************************
  81
  82 snmpCommunityMIBObjects     OBJECT IDENTIFIER ::= { snmpCommunityMIB 1 }
  83 snmpCommunityMIBConformance OBJECT IDENTIFIER ::= { snmpCommunityMIB 2 }
  84
  85 --
  86 -- The snmpCommunityTable contains a database of community strings.
  87 -- This table provides mappings between community strings, and the
  88
  89
  90 -- parameters required for View-based Access Control.
  91 --
  92
  93 snmpCommunityTable OBJECT-TYPE
  94     SYNTAX       SEQUENCE OF SnmpCommunityEntry
  95     MAX-ACCESS   not-accessible
  96     STATUS       current
  97     DESCRIPTION
  98         "The table of community strings configured in the SNMP
  99          engine's Local Configuration Datastore (LCD)."
 100     ::= { snmpCommunityMIBObjects 1 }
 101
 102 snmpCommunityEntry OBJECT-TYPE
 103     SYNTAX       SnmpCommunityEntry
 104     MAX-ACCESS   not-accessible
 105     STATUS       current
 106     DESCRIPTION
 107         "Information about a particular community string."
 108     INDEX       { IMPLIED snmpCommunityIndex }
 109     ::= { snmpCommunityTable 1 }
 110
 111 SnmpCommunityEntry ::= SEQUENCE {
 112     snmpCommunityIndex               SnmpAdminString,
 113     snmpCommunityName                OCTET STRING,
 114     snmpCommunitySecurityName        SnmpAdminString,
 115     snmpCommunityContextEngineID     SnmpEngineID,
 116     snmpCommunityContextName         SnmpAdminString,
 117     snmpCommunityTransportTag        SnmpTagValue,
 118     snmpCommunityStorageType         StorageType,
 119     snmpCommunityStatus              RowStatus
 120 }
 121
 122 snmpCommunityIndex OBJECT-TYPE
 123     SYNTAX      SnmpAdminString (SIZE(1..32))
 124     MAX-ACCESS  not-accessible
 125     STATUS      current
 126     DESCRIPTION
 127         "The unique index value of a row in this table."
 128     ::= { snmpCommunityEntry 1 }
 129
 130 snmpCommunityName OBJECT-TYPE
 131     SYNTAX       OCTET STRING
 132     MAX-ACCESS   read-create
 133     STATUS       current
 134     DESCRIPTION
 135         "The community string for which a row in this table
 136          represents a configuration."
 137     ::= { snmpCommunityEntry 2 }
 138
 139
 140 snmpCommunitySecurityName OBJECT-TYPE
 141     SYNTAX       SnmpAdminString (SIZE(1..32))
 142     MAX-ACCESS   read-create
 143     STATUS       current
 144     DESCRIPTION
 145         "A human readable string representing the corresponding
 146          value of snmpCommunityName in a Security Model
 147          independent format."
 148     ::= { snmpCommunityEntry 3 }
 149
 150 snmpCommunityContextEngineID OBJECT-TYPE
 151     SYNTAX       SnmpEngineID
 152     MAX-ACCESS   read-create
 153     STATUS       current
 154     DESCRIPTION
 155         "The contextEngineID indicating the location of the
 156          context in which management information is accessed
 157          when using the community string specified by the
 158          corresponding instance of snmpCommunityName.
 159
 160          The default value is the snmpEngineID of the entity in
 161          which this object is instantiated."
 162     ::= { snmpCommunityEntry 4 }
 163
 164 snmpCommunityContextName OBJECT-TYPE
 165     SYNTAX       SnmpAdminString (SIZE(0..32))
 166     MAX-ACCESS   read-create
 167     STATUS       current
 168     DESCRIPTION
 169         "The context in which management information is accessed
 170          when using the community string specified by the corresponding
 171          instance of snmpCommunityName."
 172     DEFVAL      { ''H }   -- the empty string
 173     ::= { snmpCommunityEntry 5 }
 174
 175 snmpCommunityTransportTag OBJECT-TYPE
 176     SYNTAX       SnmpTagValue
 177     MAX-ACCESS   read-create
 178     STATUS       current
 179     DESCRIPTION
 180         "This object specifies a set of transport endpoints
 181          from which a command responder application will accept
 182          management requests.  If a management request containing
 183          this community is received on a transport endpoint other
 184          than the transport endpoints identified by this object,
 185          the request is deemed unauthentic.
 186
 187          The transports identified by this object are specified
 188
 189
 190          in the snmpTargetAddrTable.  Entries in that table
 191          whose snmpTargetAddrTagList contains this tag value
 192          are identified.
 193
 194          If the value of this object has zero-length, transport
 195          endpoints are not checked when authenticating messages
 196          containing this community string."
 197     DEFVAL      { ''H }   -- the empty string
 198     ::= { snmpCommunityEntry 6 }
 199
 200 snmpCommunityStorageType OBJECT-TYPE
 201     SYNTAX       StorageType
 202     MAX-ACCESS   read-create
 203     STATUS       current
 204     DESCRIPTION
 205         "The storage type for this conceptual row in the
 206          snmpCommunityTable.  Conceptual rows having the value
 207          'permanent' need not allow write-access to any
 208          columnar object in the row."
 209     ::= { snmpCommunityEntry 7 }
 210
 211 snmpCommunityStatus OBJECT-TYPE
 212     SYNTAX       RowStatus
 213     MAX-ACCESS   read-create
 214     STATUS       current
 215     DESCRIPTION
 216         "The status of this conceptual row in the snmpCommunityTable.
 217
 218          An entry in this table is not qualified for activation
 219          until instances of all corresponding columns have been
 220          initialized, either through default values, or through
 221          Set operations.  The snmpCommunityName and
 222          snmpCommunitySecurityName objects must be explicitly set.
 223
 224          There is no restriction on setting columns in this table
 225          when the value of snmpCommunityStatus is active(1)."
 226     ::= { snmpCommunityEntry 8 }
 227
 228 --
 229 -- The snmpTargetAddrExtTable
 230 --
 231
 232 snmpTargetAddrExtTable OBJECT-TYPE
 233     SYNTAX       SEQUENCE OF SnmpTargetAddrExtEntry
 234     MAX-ACCESS   not-accessible
 235     STATUS       current
 236     DESCRIPTION
 237         "The table of mask and mms values associated with the
 238
 239
 240          snmpTargetAddrTable.
 241
 242          The snmpTargetAddrExtTable augments the
 243          snmpTargetAddrTable with a transport address mask value
 244          and a maximum message size value.  The transport address
 245          mask allows entries in the snmpTargetAddrTable to define
 246          a set of addresses instead of just a single address.
 247          The maximum message size value allows the maximum
 248          message size of another SNMP entity to be configured for
 249          use in SNMPv1 (and SNMPv2c) transactions, where the
 250          message format does not specify a maximum message size."
 251     ::= { snmpCommunityMIBObjects 2 }
 252
 253 snmpTargetAddrExtEntry OBJECT-TYPE
 254     SYNTAX       SnmpTargetAddrExtEntry
 255     MAX-ACCESS   not-accessible
 256     STATUS       current
 257     DESCRIPTION
 258         "Information about a particular mask and mms value."
 259     AUGMENTS       { snmpTargetAddrEntry }
 260     ::= { snmpTargetAddrExtTable 1 }
 261
 262 SnmpTargetAddrExtEntry ::= SEQUENCE {
 263     snmpTargetAddrTMask              OCTET STRING,
 264     snmpTargetAddrMMS                Integer32
 265 }
 266
 267 snmpTargetAddrTMask OBJECT-TYPE
 268     SYNTAX      OCTET STRING (SIZE (0..255))
 269     MAX-ACCESS  read-create
 270     STATUS      current
 271     DESCRIPTION
 272         "The mask value associated with an entry in the
 273          snmpTargetAddrTable.  The value of this object must
 274          have the same length as the corresponding instance of
 275          snmpTargetAddrTAddress, or must have length 0.  An
 276          attempt to set it to any other value will result in
 277          an inconsistentValue error.
 278
 279          The value of this object allows an entry in the
 280          snmpTargetAddrTable to specify multiple addresses.
 281          The mask value is used to select which bits of
 282          a transport address must match bits of the corresponding
 283          instance of snmpTargetAddrTAddress, in order for the
 284          transport address to match a particular entry in the
 285          snmpTargetAddrTable.  Bits which are 1 in the mask
 286          value indicate bits in the transport address which
 287          must match bits in the snmpTargetAddrTAddress value.
 288
 289
 290          Bits which are 0 in the mask indicate bits in the
 291          transport address which need not match.  If the
 292          length of the mask is 0, the mask should be treated
 293          as if all its bits were 1 and its length were equal
 294          to the length of the corresponding value of
 295          snmpTargetAddrTable.
 296
 297          This object may not be modified while the value of the
 298          corresponding instance of snmpTargetAddrRowStatus is
 299          active(1).  An attempt to set this object in this case
 300          will result in an inconsistentValue error."
 301     DEFVAL { ''H }
 302     ::= { snmpTargetAddrExtEntry 1 }
 303
 304 snmpTargetAddrMMS OBJECT-TYPE
 305     SYNTAX      Integer32 (0|484..2147483647)
 306     MAX-ACCESS  read-create
 307     STATUS      current
 308     DESCRIPTION
 309         "The maximum message size value associated with an entry
 310          in the snmpTargetAddrTable."
 311     DEFVAL { 484 }
 312     ::= { snmpTargetAddrExtEntry 2 }
 313
 314 --
 315 -- The snmpTrapAddress and snmpTrapCommunity objects are included
 316 -- in notifications that are forwarded by a proxy, which were
 317 -- originally received as SNMPv1 Trap messages.
 318 --
 319
 320 snmpTrapAddress OBJECT-TYPE
 321     SYNTAX      IpAddress
 322     MAX-ACCESS  accessible-for-notify
 323     STATUS      current
 324     DESCRIPTION
 325         "The value of the agent-addr field of a Trap PDU which
 326          is forwarded by a proxy forwarder application using
 327          an SNMP version other than SNMPv1.  The value of this
 328          object SHOULD contain the value of the agent-addr field
 329          from the original Trap PDU as generated by an SNMPv1
 330          agent."
 331     ::= { snmpCommunityMIBObjects 3 }
 332
 333 snmpTrapCommunity OBJECT-TYPE
 334     SYNTAX      OCTET STRING
 335     MAX-ACCESS  accessible-for-notify
 336     STATUS      current
 337     DESCRIPTION
 338
 339
 340         "The value of the community string field of an SNMPv1
 341          message containing a Trap PDU which is forwarded by a
 342          a proxy forwarder application using an SNMP version
 343          other than SNMPv1.  The value of this object SHOULD
 344          contain the value of the community string field from
 345          the original SNMPv1 message containing a Trap PDU as
 346          generated by an SNMPv1 agent."
 347     ::= { snmpCommunityMIBObjects 4 }
 348
 349 -- Conformance Information *******************************************
 350
 351 snmpCommunityMIBCompliances OBJECT IDENTIFIER
 352                             ::= { snmpCommunityMIBConformance 1 }
 353 snmpCommunityMIBGroups      OBJECT IDENTIFIER
 354                             ::= { snmpCommunityMIBConformance 2 }
 355
 356 -- Compliance statements
 357
 358 snmpCommunityMIBCompliance MODULE-COMPLIANCE
 359     STATUS       current
 360     DESCRIPTION
 361         "The compliance statement for SNMP engines which
 362          implement the SNMP-COMMUNITY-MIB."
 363
 364     MODULE       -- this module
 365         MANDATORY-GROUPS { snmpCommunityGroup }
 366
 367         OBJECT           snmpCommunityName
 368         MIN-ACCESS       read-only
 369         DESCRIPTION     "Write access is not required."
 370
 371         OBJECT           snmpCommunitySecurityName
 372         MIN-ACCESS       read-only
 373         DESCRIPTION     "Write access is not required."
 374
 375         OBJECT           snmpCommunityContextEngineID
 376         MIN-ACCESS       read-only
 377         DESCRIPTION     "Write access is not required."
 378
 379         OBJECT           snmpCommunityContextName
 380         MIN-ACCESS       read-only
 381         DESCRIPTION     "Write access is not required."
 382
 383         OBJECT           snmpCommunityTransportTag
 384         MIN-ACCESS       read-only
 385         DESCRIPTION     "Write access is not required."
 386
 387         OBJECT           snmpCommunityStorageType
 388
 389
 390         MIN-ACCESS       read-only
 391         DESCRIPTION     "Write access is not required."
 392
 393         OBJECT           snmpCommunityStatus
 394         MIN-ACCESS       read-only
 395         DESCRIPTION     "Write access is not required."
 396
 397     ::= { snmpCommunityMIBCompliances 1 }
 398
 399 snmpProxyTrapForwardCompliance MODULE-COMPLIANCE
 400     STATUS       current
 401     DESCRIPTION
 402         "The compliance statement for SNMP engines which
 403          contain a proxy forwarding application which is
 404          capable of forwarding SNMPv1 traps using SNMPv2c
 405          or SNMPv3."
 406     MODULE       -- this module
 407         MANDATORY-GROUPS { snmpProxyTrapForwardGroup }
 408     ::= { snmpCommunityMIBCompliances 2 }
 409
 410 snmpCommunityGroup OBJECT-GROUP
 411     OBJECTS {
 412         snmpCommunityName,
 413         snmpCommunitySecurityName,
 414         snmpCommunityContextEngineID,
 415         snmpCommunityContextName,
 416         snmpCommunityTransportTag,
 417         snmpCommunityStorageType,
 418         snmpCommunityStatus,
 419         snmpTargetAddrTMask,
 420         snmpTargetAddrMMS
 421     }
 422     STATUS       current
 423     DESCRIPTION
 424         "A collection of objects providing for configuration
 425          of community strings for SNMPv1 (and SNMPv2c) usage."
 426     ::= { snmpCommunityMIBGroups 1 }
 427
 428 snmpProxyTrapForwardGroup OBJECT-GROUP
 429     OBJECTS {
 430         snmpTrapAddress,
 431         snmpTrapCommunity
 432     }
 433     STATUS       current
 434     DESCRIPTION
 435         "Objects which are used by proxy forwarding applications
 436          when translating traps between SNMP versions.  These are
 437          used to preserve SNMPv1-specific information when
 438
 439
 440          translating to SNMPv2c or SNMPv3."
 441     ::= { snmpCommunityMIBGroups 3 }
 442
 443 END