home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2575.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  79.9 KB  |  2,131 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          B. Wijnen
  8. Request for Comments: 2575                     IBM T. J. Watson Research
  9. Obsoletes: 2275                                               R. Presuhn
  10. Category: Standards Track                             BMC Software, Inc.
  11.                                                            K. McCloghrie
  12.                                                      Cisco Systems, Inc.
  13.                                                               April 1999
  14.  
  15.  
  16.              View-based Access Control Model (VACM) for the
  17.                Simple Network Management Protocol (SNMP)
  18.  
  19. Status of this Memo
  20.  
  21.    This document specifies an Internet standards track protocol for the
  22.    Internet community, and requests discussion and suggestions for
  23.    improvements.  Please refer to the current edition of the "Internet
  24.    Official Protocol Standards" (STD 1) for the standardization state
  25.    and status of this protocol.  Distribution of this memo is unlimited.
  26.  
  27. Copyright Notice
  28.  
  29.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  30.  
  31. Abstract
  32.  
  33.    This document describes the View-based Access Control Model for use
  34.    in the SNMP architecture [RFC2571].  It defines the Elements of
  35.    Procedure for controlling access to management information.  This
  36.    document also includes a MIB for remotely managing the configuration
  37.    parameters for the View-based Access Control Model.
  38.  
  39. Table of Contents
  40.  
  41.    1.  Introduction                                             2
  42.    1.2.  Access Control                                         3
  43.    1.3.  Local Configuration Datastore                          3
  44.    2.  Elements of the Model                                    3
  45.    2.1.  Groups                                                 3
  46.    2.2.  securityLevel                                          4
  47.    2.3.  Contexts                                               4
  48.    2.4.  MIB Views and View Families                            4
  49.    2.4.1.  View Subtree                                         5
  50.    2.4.2.  ViewTreeFamily                                       5
  51.    2.5.  Access Policy                                          6
  52.    3.  Elements of Procedure                                    6
  53.    3.1.  Overview  of isAccessAllowed Process                   8
  54.    3.2.  Processing the isAccessAllowed Service Request         9
  55.  
  56.  
  57.  
  58. Wijnen, et al.              Standards Track                     [Page 1]
  59.  
  60. RFC 2575                     VACM for SNMP                    April 1999
  61.  
  62.  
  63.    4.  Definitions                                             10
  64.    5.  Intellectual Property                                   27
  65.    6.  Acknowledgements                                        28
  66.    7.  Security Considerations                                 29
  67.    7.1.  Recommended Practices                                 29
  68.    7.2.  Defining Groups                                       30
  69.    7.3.  Conformance                                           30
  70.    7.4.  Access to the SNMP-VIEW-BASED-ACM-MIB                 30
  71.    8.  References                                              31
  72.    9.  Editors' Addresses                                      32
  73.    A.1.  Installation Parameters                               33
  74.    B.  Change Log                                              37
  75.    C.  Full Copyright Statement                                38
  76.  
  77.  
  78. 1.  Introduction
  79.  
  80.    The Architecture for describing Internet Management Frameworks
  81.    [RFC2571] describes that an SNMP engine is composed of:
  82.  
  83.      1) a Dispatcher
  84.      2) a Message Processing Subsystem,
  85.      3) a Security Subsystem, and
  86.      4) an Access Control Subsystem.
  87.  
  88.    Applications make use of the services of these subsystems.
  89.  
  90.    It is important to understand the SNMP architecture and its
  91.    terminology to understand where the View-based Access Control Model
  92.    described in this document fits into the architecture and interacts
  93.    with other subsystems within the architecture.  The reader is
  94.    expected to have read and understood the description and terminology
  95.    of the SNMP architecture, as defined in [RFC2571].
  96.  
  97.    The Access Control Subsystem of an SNMP engine has the responsibility
  98.    for checking whether a specific type of access (read, write, notify)
  99.    to a particular object (instance) is allowed.
  100.  
  101.    It is the purpose of this document to define a specific model of the
  102.    Access Control Subsystem, designated the View-based Access Control
  103.    Model. Note that this is not necessarily the only Access Control
  104.    Model.
  105.  
  106.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  107.    "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
  108.    document are to be interpreted as described in [RFC2119].
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Wijnen, et al.              Standards Track                     [Page 2]
  115.  
  116. RFC 2575                     VACM for SNMP                    April 1999
  117.  
  118.  
  119. 1.2.  Access Control
  120.  
  121.    Access Control occurs (either implicitly or explicitly) in an SNMP
  122.    entity when processing SNMP retrieval or modification request
  123.    messages from an SNMP entity.  For example a Command Responder
  124.    application applies Access Control when processing requests that it
  125.    received from a Command Generator application.  These requests
  126.    contain Read Class and Write Class PDUs as defined in [RFC2571].
  127.  
  128.    Access Control also occurs in an SNMP entity when an SNMP
  129.    notification message is generated (by a Notification Originator
  130.    application).  These notification messages contain Notification Class
  131.    PDUs as defined in [RFC2571].
  132.  
  133.    The View-based Access Control Model defines a set of services that an
  134.    application (such as a Command Responder or a Notification Originator
  135.    application) can use for checking access rights.  It is the
  136.    responsibility of the application to make the proper service calls
  137.    for access checking.
  138.  
  139. 1.3.  Local Configuration Datastore
  140.  
  141.    To implement the model described in this document, an SNMP entity
  142.    needs to retain information about access rights and policies.  This
  143.    information is part of the SNMP engine's Local Configuration
  144.    Datastore (LCD). See [RFC2571] for the definition of LCD.
  145.  
  146.    In order to allow an SNMP entity's LCD to be remotely configured,
  147.    portions of the LCD need to be accessible as managed objects.  A MIB
  148.    module, the View-based Access Control Model Configuration MIB, which
  149.    defines these managed object types is included in this document.
  150.  
  151. 2.  Elements of the Model
  152.  
  153.    This section contains definitions to realize the access control
  154.    service provided by the View-based Access Control Model.
  155.  
  156. 2.1.  Groups
  157.  
  158.    A group is a set of zero or more <securityModel, securityName> tuples
  159.    on whose behalf SNMP management objects can be accessed.  A group
  160.    defines the access rights afforded to all securityNames which belong
  161.    to that group. The combination of a securityModel and a securityName
  162.    maps to at most one group.  A group is identified by a groupName.
  163.  
  164.    The Access Control module assumes that the securityName has already
  165.    been authenticated as needed and provides no further authentication
  166.    of its own.
  167.  
  168.  
  169.  
  170. Wijnen, et al.              Standards Track                     [Page 3]
  171.  
  172. RFC 2575                     VACM for SNMP                    April 1999
  173.  
  174.  
  175.    The View-based Access Control Model uses the securityModel and the
  176.    securityName as inputs to the Access Control module when called to
  177.    check for access rights.  It determines the groupName as a function
  178.    of securityModel and securityName.
  179.  
  180. 2.2.  securityLevel
  181.  
  182.    Different access rights for members of a group can be defined for
  183.    different levels of security, i.e., noAuthNoPriv, authNoPriv, and
  184.    authPriv. The securityLevel identifies the level of security that
  185.    will be assumed when checking for access rights.  See the SNMP
  186.    Architecture document [RFC2571] for a definition of securityLevel.
  187.  
  188.    The View-based Access Control Model requires that the securityLevel
  189.    is passed as input to the Access Control module when called to check
  190.    for access rights.
  191.  
  192. 2.3.  Contexts
  193.  
  194.    An SNMP context is a collection of management information accessible
  195.    by an SNMP entity.  An item of management information may exist in
  196.    more than one context.  An SNMP entity potentially has access to many
  197.    contexts.  Details about the naming of management information can be
  198.    found in the SNMP Architecture document [RFC2571].
  199.  
  200.    The View-based Access Control Model defines a vacmContextTable that
  201.    lists the locally available contexts by contextName.
  202.  
  203. 2.4.  MIB Views and View Families
  204.  
  205.    For security reasons, it is often valuable to be able to restrict the
  206.    access rights of some groups to only a subset of the management
  207.    information in the management domain.  To provide this capability,
  208.    access to a context is via a "MIB view" which details a specific set
  209.    of managed object types (and optionally, the specific instances of
  210.    object types) within that context.  For example, for a given context,
  211.    there will typically always be one MIB view which provides access to
  212.    all management information in that context, and often there will be
  213.    other MIB views each of which contains some subset of the
  214.    information.  So, the access allowed for a group can be restricted in
  215.    the desired manner by specifying its rights in terms of the
  216.    particular (subset) MIB view it can access within each appropriate
  217.    context.
  218.  
  219.    Since managed object types (and their instances) are identified via
  220.    the tree-like naming structure of ISO's OBJECT IDENTIFIERs [ISO-
  221.    ASN.1, RFC2578],  it is convenient to define a MIB view as the
  222.    combination of a set of "view subtrees", where each view subtree is a
  223.  
  224.  
  225.  
  226. Wijnen, et al.              Standards Track                     [Page 4]
  227.  
  228. RFC 2575                     VACM for SNMP                    April 1999
  229.  
  230.  
  231.    subtree within the managed object naming tree.  Thus, a simple MIB
  232.    view (e.g., all managed objects within the Internet Network
  233.    Management Framework) can be defined as a single view subtree, while
  234.    more complicated MIB views (e.g., all information relevant to a
  235.    particular network interface) can be represented by the union of
  236.    multiple view subtrees.
  237.  
  238.    While any set of managed objects can be described by the union of
  239.    some number of view subtrees, situations can arise that would require
  240.    a very large number of view subtrees.  This could happen, for
  241.    example, when specifying all columns in one conceptual row of a MIB
  242.    table because they would appear in separate subtrees, one per column,
  243.    each with a very similar format.  Because the formats are similar,
  244.    the required set of subtrees can easily be aggregated into one
  245.    structure.  This structure is named a family of view subtrees after
  246.    the set of subtrees that it conceptually represents.  A family of
  247.    view subtrees can either be included or excluded from a MIB view.
  248.  
  249. 2.4.1.  View Subtree
  250.  
  251.    A view subtree is the set of all MIB object instances which have a
  252.    common ASN.1 OBJECT IDENTIFIER prefix to their names.  A view subtree
  253.    is identified by the OBJECT IDENTIFIER value which is the longest
  254.    OBJECT IDENTIFIER prefix common to all (potential) MIB object
  255.    instances in that subtree.
  256.  
  257. 2.4.2.  ViewTreeFamily
  258.  
  259.    A family of view subtrees is a pairing of an OBJECT IDENTIFIER value
  260.    (called the family name) together with a bit string value (called the
  261.    family mask).  The family mask indicates which sub-identifiers of the
  262.    associated family name are significant to the family's definition.
  263.  
  264.    For each possible managed object instance, that instance belongs to a
  265.    particular ViewTreeFamily if both of the following conditions are
  266.    true:
  267.  
  268.    - the OBJECT IDENTIFIER name of the managed object instance
  269.      contains at least as many sub-identifiers as does the family name,
  270.      and
  271.  
  272.    - each sub-identifier in the OBJECT IDENTIFIER name of the managed
  273.      object instance matches the corresponding sub-identifier of the
  274.      family name whenever the corresponding bit of the associated family
  275.      mask is non-zero.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Wijnen, et al.              Standards Track                     [Page 5]
  283.  
  284. RFC 2575                     VACM for SNMP                    April 1999
  285.  
  286.  
  287.    When the configured value of the family mask is all ones, the view
  288.    subtree family is identical to the single view subtree identified by
  289.    the family name.
  290.  
  291.    When the configured value of the family mask is shorter than required
  292.    to perform the above test, its value is implicitly extended with
  293.    ones.  Consequently, a view subtree family having a family mask of
  294.    zero length always corresponds to a single view subtree.
  295.  
  296. 2.5.  Access Policy
  297.  
  298.    The View-based Access Control Model determines the access rights of a
  299.    group, representing zero or more securityNames which have the same
  300.    access rights.  For a particular context, identified by contextName,
  301.    to which a group, identified by groupName, has access using a
  302.    particular securityModel and securityLevel, that group's access
  303.    rights are given by a read-view, a write-view and a notify-view.
  304.  
  305.    The read-view represents the set of object instances authorized for
  306.    the group when reading objects.  Reading objects occurs when
  307.    processing a retrieval operation (when handling Read Class PDUs).
  308.  
  309.    The write-view represents the set of object instances authorized for
  310.    the group when writing objects.  Writing objects occurs when
  311.    processing a write operation (when handling Write Class PDUs).
  312.  
  313.    The notify-view represents the set of object instances authorized for
  314.    the group when sending objects in a notification, such as when
  315.    sending a notification (when sending Notification Class PDUs).
  316.  
  317. 3.  Elements of Procedure
  318.  
  319.    This section describes the procedures followed by an Access Control
  320.    module that implements the View-based Access Control Model when
  321.    checking access rights as requested by an application (for example a
  322.    Command Responder or a Notification Originator application).  The
  323.    abstract service primitive is:
  324.  
  325.      statusInformation =          -- success or errorIndication
  326.          isAccessAllowed(
  327.              securityModel        -- Security Model in use
  328.              securityName         -- principal who wants access
  329.              securityLevel        -- Level of Security
  330.              viewType             -- read, write, or notify view
  331.              contextName          -- context containing variableName
  332.              variableName         -- OID for the managed object
  333.              )
  334.  
  335.  
  336.  
  337.  
  338. Wijnen, et al.              Standards Track                     [Page 6]
  339.  
  340. RFC 2575                     VACM for SNMP                    April 1999
  341.  
  342.  
  343.    The abstract data elements are:
  344.  
  345.      statusInformation - one of the following:
  346.         accessAllowed  - a MIB view was found and access is granted.
  347.         notInView      - a MIB view was found but access is denied.
  348.                          The variableName is not in the configured
  349.                          MIB view for the specified viewType (e.g., in
  350.                          the relevant entry in the vacmAccessTable).
  351.         noSuchView     - no MIB view found because no view has been
  352.                          configured for specified viewType (e.g., in
  353.                          the relevant entry in the vacmAccessTable).
  354.         noSuchContext  - no MIB view found because of no entry in the
  355.                          vacmContextTable for specified contextName.
  356.         noGroupName    - no MIB view found because no entry has been
  357.                          configured in the vacmSecurityToGroupTable
  358.                          for the specified combination of
  359.                          securityModel and securityName.
  360.         noAccessEntry  - no MIB view found because no entry has been
  361.                          configured in the vacmAccessTable for the
  362.                          specified combination of contextName,
  363.                          groupName (from vacmSecurityToGroupTable),
  364.                          securityModel and securityLevel.
  365.         otherError     - failure, an undefined error occurred.
  366.      securityModel - Security Model under which access is requested.
  367.      securityName  - the principal on whose behalf access is requested.
  368.      securityLevel - Level of Security under which access is requested.
  369.      viewType      - view to be checked (read, write or notify).
  370.      contextName   - context in which access is requested.
  371.      variableName  - object instance to which access is requested.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. Wijnen, et al.              Standards Track                     [Page 7]
  395.  
  396. RFC 2575                     VACM for SNMP                    April 1999
  397.  
  398.  
  399. 3.1.  Overview  of isAccessAllowed Process
  400.  
  401.  The following picture shows how the decision for access control is made
  402.  by the View-based Access Control Model.
  403.  
  404.  +--------------------------------------------------------------------+
  405.  |                                                                    |
  406.  |      +-> securityModel -+                                          |
  407.  |      |   (a)            |                                          |
  408.  | who -+                  +-> groupName ----+                        |
  409.  | (1)  |                  |   (x)           |                        |
  410.  |      +-> securityName --+                 |                        |
  411.  |          (b)                              |                        |
  412.  |                                           |                        |
  413.  | where -> contextName ---------------------+                        |
  414.  | (2)      (e)                              |                        |
  415.  |                                           |                        |
  416.  |                                           |                        |
  417.  |      +-> securityModel -------------------+                        |
  418.  |      |   (a)                              |                        |
  419.  | how -+                                    +-> viewName -+          |
  420.  | (3)  |                                    |   (y)       |          |
  421.  |      +-> securityLevel -------------------+             |          |
  422.  |          (c)                              |             +-> yes/no |
  423.  |                                           |             | decision |
  424.  | why ---> viewType (read/write/notify) ----+             | (z)      |
  425.  | (4)      (d)                                            |          |
  426.  |                                                         |          |
  427.  | what --> object-type ------+                            |          |
  428.  | (5)      (m)               |                            |          |
  429.  |                            +-> variableName (OID) ------+          |
  430.  |                            |   (f)                                 |
  431.  | which -> object-instance --+                                       |
  432.  | (6)      (n)                                                       |
  433.  |                                                                    |
  434.  +--------------------------------------------------------------------+
  435.  
  436.  How the decision for isAccessAllowed is made.
  437.  
  438.  1) Inputs to the isAccessAllowed service are:
  439.  
  440.     (a)       securityModel    -- Security Model in use
  441.     (b)       securityName     -- principal who wants to access
  442.     (c)       securityLevel    -- Level of Security
  443.     (d)       viewType         -- read, write, or notify view
  444.     (e)       contextName      -- context containing variableName
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Wijnen, et al.              Standards Track                     [Page 8]
  451.  
  452. RFC 2575                     VACM for SNMP                    April 1999
  453.  
  454.  
  455.     (f)       variableName     -- OID for the managed object
  456.                                -- this is made up of:
  457.                                   - object-type (m)
  458.                                   - object-instance (n)
  459.  
  460.  2) The partial "who" (1), represented by the securityModel (a) and
  461.     the securityName (b), are used as the indices (a,b) into the
  462.     vacmSecurityToGroupTable to find a single entry that produces a
  463.     group, represented by groupName (x).
  464.  
  465.  3) The "where" (2), represented by the contextName (e), the "who",
  466.     represented by the groupName (x) from the previous step, and the
  467.     "how" (3), represented by securityModel (a) and securityLevel (c),
  468.     are used as indices (e,x,a,c) into the vacmAccessTable to find a
  469.     single entry that contains three MIB views.
  470.  
  471.  4) The "why" (4), represented by the viewType (d), is used to select
  472.     the proper MIB view, represented by a viewName (y), from the
  473.     vacmAccessEntry selected in the previous step. This viewName (y) is
  474.     an index into the vacmViewTreeFamilyTable and selects the set of
  475.     entries that define the variableNames which are included in or
  476.     excluded from the MIB view identified by the viewName (y).
  477.  
  478.  5) The "what" (5) type of management data and "which" (6) particular
  479.     instance, represented by the variableName (f), is then checked to be
  480.     in the MIB view or not, e.g., the yes/no decision (z).
  481.  
  482. 3.2.  Processing the isAccessAllowed Service Request
  483.  
  484.    This section describes the procedure followed by an Access Control
  485.    module that implements the View-based Access Control Model whenever
  486.    it receives an isAccessAllowed request.
  487.  
  488.    1) The vacmContextTable is consulted for information about
  489.       the SNMP context identified by the contextName.  If information
  490.       about this SNMP context is absent from the table, then an
  491.       errorIndication (noSuchContext) is returned to the calling module.
  492.  
  493.    2) The vacmSecurityToGroupTable is consulted for mapping the
  494.       securityModel and securityName to a groupName.  If the information
  495.       about this combination is absent from the table, then an
  496.       errorIndication (noGroupName) is returned to the calling module.
  497.  
  498.    3) The vacmAccessTable is consulted for information about the
  499.       groupName, contextName, securityModel and securityLevel.  If
  500.       information about this combination is absent from the table, then
  501.       an errorIndication (noAccessEntry) is returned to the calling
  502.       module.
  503.  
  504.  
  505.  
  506. Wijnen, et al.              Standards Track                     [Page 9]
  507.  
  508. RFC 2575                     VACM for SNMP                    April 1999
  509.  
  510.  
  511.    4) a) If the viewType is "read", then the read view is used for
  512.          checking access rights.
  513.  
  514.       b) If the viewType is "write", then the write view is used for
  515.          checking access rights.
  516.  
  517.       c) If the viewType is "notify", then the notify view is used
  518.          for checking access rights.
  519.  
  520.       If the view to be used is the empty view (zero length viewName)
  521.       then an errorIndication (noSuchView) is returned to the calling
  522.       module.
  523.  
  524.    5) a) If there is no view configured for the specified viewType,
  525.          then an errorIndication (noSuchView) is returned to the calling
  526.          module.
  527.  
  528.       b) If the specified variableName (object instance) is not in the
  529.          MIB view (see DESCRIPTION clause for vacmViewTreeFamilyTable in
  530.          section 4), then an errorIndication (notInView) is returned to
  531.          the calling module.
  532.  
  533.          Otherwise,
  534.  
  535.       c) The specified variableName is in the MIB view.
  536.          A statusInformation of success (accessAllowed) is returned to
  537.          the calling module.
  538.  
  539. 4.  Definitions
  540.  
  541. SNMP-VIEW-BASED-ACM-MIB DEFINITIONS ::= BEGIN
  542.  
  543. IMPORTS
  544.     MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF
  545.     MODULE-IDENTITY, OBJECT-TYPE,
  546.     snmpModules                           FROM SNMPv2-SMI
  547.     TestAndIncr,
  548.     RowStatus, StorageType                FROM SNMPv2-TC
  549.     SnmpAdminString,
  550.     SnmpSecurityLevel,
  551.     SnmpSecurityModel                     FROM SNMP-FRAMEWORK-MIB;
  552.  
  553. snmpVacmMIB       MODULE-IDENTITY
  554.     LAST-UPDATED "9901200000Z"            -- 20 Jan 1999, midnight
  555.     ORGANIZATION "SNMPv3 Working Group"
  556.     CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
  557.                   Subscribe:  majordomo@lists.tislabs.com
  558.                               In message body:  subscribe snmpv3
  559.  
  560.  
  561.  
  562. Wijnen, et al.              Standards Track                    [Page 10]
  563.  
  564. RFC 2575                     VACM for SNMP                    April 1999
  565.  
  566.  
  567.                   Chair:      Russ Mundy
  568.                               Trusted Information Systems
  569.                   postal:     3060 Washington Rd
  570.                               Glenwood MD 21738
  571.                               USA
  572.                   email:      mundy@tislabs.com
  573.                   phone:      +1-301-854-6889
  574.  
  575.                   Co-editor:  Bert Wijnen
  576.                               IBM T.J. Watson Research
  577.                   postal:     Schagen 33
  578.                               3461 GL Linschoten
  579.                               Netherlands
  580.                   email:      wijnen@vnet.ibm.com
  581.                   phone:      +31-348-432-794
  582.  
  583.                   Co-editor:  Randy Presuhn
  584.                               BMC Software, Inc
  585.                   postal:     965 Stewart Drive
  586.                               Sunnyvale, CA 94086
  587.                               USA
  588.                   email:      randy_presuhn@bmc.com
  589.                   phone:      +1-408-616-3100
  590.  
  591.                   Co-editor:  Keith McCloghrie
  592.                               Cisco Systems, Inc.
  593.                   postal:     170 West Tasman Drive
  594.                               San Jose, CA  95134-1706
  595.                               USA
  596.                   email:      kzm@cisco.com
  597.                   phone:      +1-408-526-5260
  598.                  "
  599.     DESCRIPTION  "The management information definitions for the
  600.                   View-based Access Control Model for SNMP.
  601.                  "
  602. --  Revision history
  603.     REVISION     "9901200000Z"            -- 20 Jan 1999, midnight
  604.     DESCRIPTION  "Clarifications, published as RFC2575"
  605.  
  606.     REVISION     "9711200000Z"            -- 20 Nov 1997, midnight
  607.     DESCRIPTION  "Initial version, published as RFC2275"
  608.  
  609.     ::= { snmpModules 16 }
  610.  
  611. -- Administrative assignments ****************************************
  612.  
  613. vacmMIBObjects      OBJECT IDENTIFIER ::= { snmpVacmMIB 1 }
  614. vacmMIBConformance  OBJECT IDENTIFIER ::= { snmpVacmMIB 2 }
  615.  
  616.  
  617.  
  618. Wijnen, et al.              Standards Track                    [Page 11]
  619.  
  620. RFC 2575                     VACM for SNMP                    April 1999
  621.  
  622.  
  623. -- Information about Local Contexts **********************************
  624.  
  625. vacmContextTable OBJECT-TYPE
  626.     SYNTAX       SEQUENCE OF VacmContextEntry
  627.     MAX-ACCESS   not-accessible
  628.     STATUS       current
  629.     DESCRIPTION "The table of locally available contexts.
  630.  
  631.                  This table provides information to SNMP Command
  632.                  Generator applications so that they can properly
  633.                  configure the vacmAccessTable to control access to
  634.                  all contexts at the SNMP entity.
  635.  
  636.                  This table may change dynamically if the SNMP entity
  637.                  allows that contexts are added/deleted dynamically
  638.                  (for instance when its configuration changes). Such
  639.                  changes would happen only if the management
  640.                  instrumentation at that SNMP entity recognizes more
  641.                  (or fewer) contexts.
  642.  
  643.                  The presence of entries in this table and of entries
  644.                  in the vacmAccessTable are independent.  That is, a
  645.                  context identified by an entry in this table is not
  646.                  necessarily referenced by any entries in the
  647.                  vacmAccessTable; and the context(s) referenced by an
  648.                  entry in the vacmAccessTable does not necessarily
  649.                  currently exist and thus need not be identified by an
  650.                  entry in this table.
  651.  
  652.                  This table must be made accessible via the default
  653.                  context so that Command Responder applications have
  654.                  a standard way of retrieving the information.
  655.  
  656.                  This table is read-only. It cannot be configured via
  657.                  SNMP.
  658.                 "
  659.     ::= { vacmMIBObjects 1 }
  660.  
  661. vacmContextEntry OBJECT-TYPE
  662.     SYNTAX       VacmContextEntry
  663.     MAX-ACCESS   not-accessible
  664.     STATUS       current
  665.     DESCRIPTION "Information about a particular context."
  666.     INDEX       {
  667.                   vacmContextName
  668.                 }
  669.     ::= { vacmContextTable 1 }
  670.  
  671.  
  672.  
  673.  
  674. Wijnen, et al.              Standards Track                    [Page 12]
  675.  
  676. RFC 2575                     VACM for SNMP                    April 1999
  677.  
  678.  
  679. VacmContextEntry ::= SEQUENCE
  680.     {
  681.         vacmContextName SnmpAdminString
  682.     }
  683.  
  684. vacmContextName  OBJECT-TYPE
  685.     SYNTAX       SnmpAdminString (SIZE(0..32))
  686.     MAX-ACCESS   read-only
  687.     STATUS       current
  688.     DESCRIPTION "A human readable name identifying a particular
  689.                  context at a particular SNMP entity.
  690.  
  691.                  The empty contextName (zero length) represents the
  692.                  default context.
  693.                 "
  694.     ::= { vacmContextEntry 1 }
  695.  
  696. -- Information about Groups ******************************************
  697.  
  698. vacmSecurityToGroupTable OBJECT-TYPE
  699.     SYNTAX       SEQUENCE OF VacmSecurityToGroupEntry
  700.     MAX-ACCESS   not-accessible
  701.     STATUS       current
  702.     DESCRIPTION "This table maps a combination of securityModel and
  703.                  securityName into a groupName which is used to define
  704.                  an access control policy for a group of principals.
  705.                 "
  706.     ::= { vacmMIBObjects 2 }
  707.  
  708. vacmSecurityToGroupEntry OBJECT-TYPE
  709.     SYNTAX       VacmSecurityToGroupEntry
  710.     MAX-ACCESS   not-accessible
  711.     STATUS       current
  712.     DESCRIPTION "An entry in this table maps the combination of a
  713.                  securityModel and securityName into a groupName.
  714.                 "
  715.     INDEX       {
  716.                   vacmSecurityModel,
  717.                   vacmSecurityName
  718.                 }
  719.     ::= { vacmSecurityToGroupTable 1 }
  720.  
  721. VacmSecurityToGroupEntry ::= SEQUENCE
  722.     {
  723.         vacmSecurityModel               SnmpSecurityModel,
  724.         vacmSecurityName                SnmpAdminString,
  725.         vacmGroupName                   SnmpAdminString,
  726.         vacmSecurityToGroupStorageType  StorageType,
  727.  
  728.  
  729.  
  730. Wijnen, et al.              Standards Track                    [Page 13]
  731.  
  732. RFC 2575                     VACM for SNMP                    April 1999
  733.  
  734.  
  735.         vacmSecurityToGroupStatus       RowStatus
  736.     }
  737.  
  738. vacmSecurityModel OBJECT-TYPE
  739.     SYNTAX       SnmpSecurityModel(1..2147483647)
  740.     MAX-ACCESS   not-accessible
  741.     STATUS       current
  742.     DESCRIPTION "The Security Model, by which the vacmSecurityName
  743.                  referenced by this entry is provided.
  744.  
  745.                  Note, this object may not take the 'any' (0) value.
  746.                 "
  747.     ::= { vacmSecurityToGroupEntry 1 }
  748.  
  749. vacmSecurityName OBJECT-TYPE
  750.     SYNTAX       SnmpAdminString (SIZE(1..32))
  751.     MAX-ACCESS   not-accessible
  752.     STATUS       current
  753.     DESCRIPTION "The securityName for the principal, represented in a
  754.                  Security Model independent format, which is mapped by
  755.                  this entry to a groupName.
  756.                 "
  757.     ::= { vacmSecurityToGroupEntry 2 }
  758.  
  759. vacmGroupName    OBJECT-TYPE
  760.     SYNTAX       SnmpAdminString (SIZE(1..32))
  761.     MAX-ACCESS   read-create
  762.     STATUS       current
  763.     DESCRIPTION "The name of the group to which this entry (e.g., the
  764.                  combination of securityModel and securityName)
  765.                  belongs.
  766.  
  767.                  This groupName is used as index into the
  768.                  vacmAccessTable to select an access control policy.
  769.                  However, a value in this table does not imply that an
  770.                  instance with the value exists in table vacmAccesTable.
  771.                 "
  772.     ::= { vacmSecurityToGroupEntry 3 }
  773.  
  774. vacmSecurityToGroupStorageType OBJECT-TYPE
  775.     SYNTAX       StorageType
  776.     MAX-ACCESS   read-create
  777.     STATUS       current
  778.     DESCRIPTION "The storage type for this conceptual row.
  779.                  Conceptual rows having the value 'permanent' need not
  780.                  allow write-access to any columnar objects in the row.
  781.                 "
  782.     DEFVAL      { nonVolatile }
  783.  
  784.  
  785.  
  786. Wijnen, et al.              Standards Track                    [Page 14]
  787.  
  788. RFC 2575                     VACM for SNMP                    April 1999
  789.  
  790.  
  791.     ::= { vacmSecurityToGroupEntry 4 }
  792.  
  793. vacmSecurityToGroupStatus OBJECT-TYPE
  794.     SYNTAX       RowStatus
  795.     MAX-ACCESS   read-create
  796.     STATUS       current
  797.     DESCRIPTION "The status of this conceptual row.
  798.  
  799.                  Until instances of all corresponding columns are
  800.                  appropriately configured, the value of the
  801.                  corresponding instance of the vacmSecurityToGroupStatus
  802.                  column is 'notReady'.
  803.  
  804.                  In particular, a newly created row cannot be made
  805.                  active until a value has been set for vacmGroupName.
  806.  
  807.                  The  RowStatus TC [RFC2579] requires that this
  808.                  DESCRIPTION clause states under which circumstances
  809.                  other objects in this row can be modified:
  810.  
  811.                  The value of this object has no effect on whether
  812.                  other objects in this conceptual row can be modified.
  813.                 "
  814.     ::= { vacmSecurityToGroupEntry 5 }
  815.  
  816. -- Information about Access Rights ***********************************
  817.  
  818. vacmAccessTable  OBJECT-TYPE
  819.     SYNTAX       SEQUENCE OF VacmAccessEntry
  820.     MAX-ACCESS   not-accessible
  821.     STATUS       current
  822.     DESCRIPTION "The table of access rights for groups.
  823.  
  824.                  Each entry is indexed by a groupName, a contextPrefix,
  825.                  a securityModel and a securityLevel.  To determine
  826.                  whether access is allowed, one entry from this table
  827.                  needs to be selected and the proper viewName from that
  828.                  entry must be used for access control checking.
  829.  
  830.                  To select the proper entry, follow these steps:
  831.  
  832.                  1) the set of possible matches is formed by the
  833.                     intersection of the following sets of entries:
  834.                       the set of entries with identical vacmGroupName
  835.                       the union of these two sets:
  836.                        - the set with identical vacmAccessContextPrefix
  837.                        - the set of entries with vacmAccessContextMatch
  838.                          value of 'prefix' and matching
  839.  
  840.  
  841.  
  842. Wijnen, et al.              Standards Track                    [Page 15]
  843.  
  844. RFC 2575                     VACM for SNMP                    April 1999
  845.  
  846.  
  847.                          vacmAccessContextPrefix
  848.                       intersected with the union of these two sets:
  849.                        - the set of entries with identical
  850.                          vacmSecurityModel
  851.                        - the set of entries with vacmSecurityModel
  852.                          value of 'any'
  853.                       intersected with the set of entries with
  854.                       vacmAccessSecurityLevel value less than or equal
  855.                       to the requested securityLevel
  856.  
  857.                  2) if this set has only one member, we're done
  858.                     otherwise, it comes down to deciding how to weight
  859.                     the preferences between ContextPrefixes,
  860.                     SecurityModels, and SecurityLevels as follows:
  861.                     a) if the subset of entries with securityModel
  862.                        matching the securityModel in the message is
  863.                        not empty, then discard the rest.
  864.                     b) if the subset of entries with
  865.                        vacmAccessContextPrefix matching the contextName
  866.                        in the message is not empty,
  867.                        then discard the rest
  868.                     c) discard all entries with ContextPrefixes shorter
  869.                        than the longest one remaining in the set
  870.                     d) select the entry with the highest securityLevel
  871.  
  872.                  Please note that for securityLevel noAuthNoPriv, all
  873.                  groups are really equivalent since the assumption that
  874.                  the securityName has been authenticated does not hold.
  875.                 "
  876.     ::= { vacmMIBObjects 4 }
  877.  
  878. vacmAccessEntry  OBJECT-TYPE
  879.     SYNTAX       VacmAccessEntry
  880.     MAX-ACCESS   not-accessible
  881.     STATUS       current
  882.     DESCRIPTION "An access right configured in the Local Configuration
  883.                  Datastore (LCD) authorizing access to an SNMP context.
  884.  
  885.                  Entries in this table can use an instance value for
  886.                  object vacmGroupName even if no entry in table
  887.                  vacmAccessSecurityToGroupTable has a corresponding
  888.                  value for object vacmGroupName.
  889.                 "
  890.     INDEX       { vacmGroupName,
  891.                   vacmAccessContextPrefix,
  892.                   vacmAccessSecurityModel,
  893.                   vacmAccessSecurityLevel
  894.                 }
  895.  
  896.  
  897.  
  898. Wijnen, et al.              Standards Track                    [Page 16]
  899.  
  900. RFC 2575                     VACM for SNMP                    April 1999
  901.  
  902.  
  903.     ::= { vacmAccessTable 1 }
  904.  
  905. VacmAccessEntry ::= SEQUENCE
  906.     {
  907.         vacmAccessContextPrefix    SnmpAdminString,
  908.         vacmAccessSecurityModel    SnmpSecurityModel,
  909.         vacmAccessSecurityLevel    SnmpSecurityLevel,
  910.         vacmAccessContextMatch     INTEGER,
  911.         vacmAccessReadViewName     SnmpAdminString,
  912.         vacmAccessWriteViewName    SnmpAdminString,
  913.         vacmAccessNotifyViewName   SnmpAdminString,
  914.         vacmAccessStorageType      StorageType,
  915.         vacmAccessStatus           RowStatus
  916.     }
  917.  
  918. vacmAccessContextPrefix OBJECT-TYPE
  919.     SYNTAX       SnmpAdminString (SIZE(0..32))
  920.     MAX-ACCESS   not-accessible
  921.     STATUS       current
  922.     DESCRIPTION "In order to gain the access rights allowed by this
  923.                  conceptual row, a contextName must match exactly
  924.                  (if the value of vacmAccessContextMatch is 'exact')
  925.                  or partially (if the value of vacmAccessContextMatch
  926.                  is 'prefix') to the value of the instance of this
  927.                  object.
  928.                 "
  929.     ::= { vacmAccessEntry 1 }
  930.  
  931. vacmAccessSecurityModel OBJECT-TYPE
  932.     SYNTAX       SnmpSecurityModel
  933.     MAX-ACCESS   not-accessible
  934.     STATUS       current
  935.     DESCRIPTION "In order to gain the access rights allowed by this
  936.                  conceptual row, this securityModel must be in use.
  937.                 "
  938.     ::= { vacmAccessEntry 2 }
  939.  
  940. vacmAccessSecurityLevel OBJECT-TYPE
  941.     SYNTAX       SnmpSecurityLevel
  942.     MAX-ACCESS   not-accessible
  943.     STATUS       current
  944.     DESCRIPTION "The minimum level of security required in order to
  945.                  gain the access rights allowed by this conceptual
  946.                  row.  A securityLevel of noAuthNoPriv is less than
  947.                  authNoPriv which in turn is less than authPriv.
  948.  
  949.                  If multiple entries are equally indexed except for
  950.                  this vacmAccessSecurityLevel index, then the entry
  951.  
  952.  
  953.  
  954. Wijnen, et al.              Standards Track                    [Page 17]
  955.  
  956. RFC 2575                     VACM for SNMP                    April 1999
  957.  
  958.  
  959.                  which has the highest value for
  960.                  vacmAccessSecurityLevel is selected.
  961.                 "
  962.     ::= { vacmAccessEntry 3 }
  963.  
  964. vacmAccessContextMatch OBJECT-TYPE
  965.     SYNTAX       INTEGER
  966.                 { exact (1), -- exact match of prefix and contextName
  967.                   prefix (2) -- Only match to the prefix
  968.                 }
  969.     MAX-ACCESS   read-create
  970.     STATUS       current
  971.     DESCRIPTION "If the value of this object is exact(1), then all
  972.                  rows where the contextName exactly matches
  973.                  vacmAccessContextPrefix are selected.
  974.  
  975.                  If the value of this object is prefix(2), then all
  976.                  rows where the contextName whose starting octets
  977.                  exactly match vacmAccessContextPrefix are selected.
  978.                  This allows for a simple form of wildcarding.
  979.                 "
  980.     DEFVAL      { exact }
  981.     ::= { vacmAccessEntry 4 }
  982.  
  983. vacmAccessReadViewName OBJECT-TYPE
  984.     SYNTAX       SnmpAdminString (SIZE(0..32))
  985.     MAX-ACCESS   read-create
  986.     STATUS       current
  987.     DESCRIPTION "The value of an instance of this object identifies
  988.                  the MIB view of the SNMP context to which this
  989.                  conceptual row authorizes read access.
  990.  
  991.                  The identified MIB view is that one for which the
  992.                  vacmViewTreeFamilyViewName has the same value as the
  993.                  instance of this object; if the value is the empty
  994.                  string or if there is no active MIB view having this
  995.                  value of vacmViewTreeFamilyViewName, then no access
  996.                  is granted.
  997.                 "
  998.     DEFVAL      { ''H }   -- the empty string
  999.     ::= { vacmAccessEntry 5 }
  1000.  
  1001. vacmAccessWriteViewName OBJECT-TYPE
  1002.     SYNTAX       SnmpAdminString (SIZE(0..32))
  1003.     MAX-ACCESS   read-create
  1004.     STATUS       current
  1005.     DESCRIPTION "The value of an instance of this object identifies
  1006.                  the MIB view of the SNMP context to which this
  1007.  
  1008.  
  1009.  
  1010. Wijnen, et al.              Standards Track                    [Page 18]
  1011.  
  1012. RFC 2575                     VACM for SNMP                    April 1999
  1013.  
  1014.  
  1015.                  conceptual row authorizes write access.
  1016.  
  1017.                  The identified MIB view is that one for which the
  1018.                  vacmViewTreeFamilyViewName has the same value as the
  1019.                  instance of this object; if the value is the empty
  1020.                  string or if there is no active MIB view having this
  1021.                  value of vacmViewTreeFamilyViewName, then no access
  1022.                  is granted.
  1023.                 "
  1024.     DEFVAL      { ''H }   -- the empty string
  1025.     ::= { vacmAccessEntry 6 }
  1026.  
  1027. vacmAccessNotifyViewName OBJECT-TYPE
  1028.     SYNTAX       SnmpAdminString (SIZE(0..32))
  1029.     MAX-ACCESS   read-create
  1030.     STATUS       current
  1031.     DESCRIPTION "The value of an instance of this object identifies
  1032.                  the MIB view of the SNMP context to which this
  1033.                  conceptual row authorizes access for notifications.
  1034.  
  1035.                  The identified MIB view is that one for which the
  1036.                  vacmViewTreeFamilyViewName has the same value as the
  1037.                  instance of this object; if the value is the empty
  1038.                  string or if there is no active MIB view having this
  1039.                  value of vacmViewTreeFamilyViewName, then no access
  1040.                  is granted.
  1041.                 "
  1042.     DEFVAL      { ''H }   -- the empty string
  1043.     ::= { vacmAccessEntry 7 }
  1044.  
  1045. vacmAccessStorageType OBJECT-TYPE
  1046.     SYNTAX       StorageType
  1047.     MAX-ACCESS   read-create
  1048.     STATUS       current
  1049.     DESCRIPTION "The storage type for this conceptual row.
  1050.  
  1051.                  Conceptual rows having the value 'permanent' need not
  1052.                  allow write-access to any columnar objects in the row.
  1053.                 "
  1054.     DEFVAL      { nonVolatile }
  1055.     ::= { vacmAccessEntry 8 }
  1056.  
  1057. vacmAccessStatus OBJECT-TYPE
  1058.     SYNTAX       RowStatus
  1059.     MAX-ACCESS   read-create
  1060.     STATUS       current
  1061.     DESCRIPTION "The status of this conceptual row.
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Wijnen, et al.              Standards Track                    [Page 19]
  1067.  
  1068. RFC 2575                     VACM for SNMP                    April 1999
  1069.  
  1070.  
  1071.                  The  RowStatus TC [RFC2579] requires that this
  1072.                  DESCRIPTION clause states under which circumstances
  1073.                  other objects in this row can be modified:
  1074.  
  1075.                  The value of this object has no effect on whether
  1076.                  other objects in this conceptual row can be modified.
  1077.                 "
  1078.     ::= { vacmAccessEntry 9 }
  1079.  
  1080. -- Information about MIB views ***************************************
  1081.  
  1082. -- Support for instance-level granularity is optional.
  1083. --
  1084. -- In some implementations, instance-level access control
  1085. -- granularity may come at a high performance cost.  Managers
  1086. -- should avoid requesting such configurations unnecessarily.
  1087.  
  1088. vacmMIBViews     OBJECT IDENTIFIER ::= { vacmMIBObjects 5 }
  1089.  
  1090. vacmViewSpinLock OBJECT-TYPE
  1091.     SYNTAX       TestAndIncr
  1092.     MAX-ACCESS   read-write
  1093.     STATUS       current
  1094.     DESCRIPTION "An advisory lock used to allow cooperating SNMP
  1095.                  Command Generator applications to coordinate their
  1096.                  use of the Set operation in creating or modifying
  1097.                  views.
  1098.  
  1099.                  When creating a new view or altering an existing
  1100.                  view, it is important to understand the potential
  1101.                  interactions with other uses of the view.  The
  1102.                  vacmViewSpinLock should be retrieved.  The name of
  1103.                  the view to be created should be determined to be
  1104.                  unique by the SNMP Command Generator application by
  1105.                  consulting the vacmViewTreeFamilyTable.  Finally,
  1106.                  the named view may be created (Set), including the
  1107.                  advisory lock.
  1108.                  If another SNMP Command Generator application has
  1109.                  altered the views in the meantime, then the spin
  1110.                  lock's value will have changed, and so this creation
  1111.                  will fail because it will specify the wrong value for
  1112.                  the spin lock.
  1113.  
  1114.                  Since this is an advisory lock, the use of this lock
  1115.                  is not enforced.
  1116.                 "
  1117.     ::= { vacmMIBViews 1 }
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Wijnen, et al.              Standards Track                    [Page 20]
  1123.  
  1124. RFC 2575                     VACM for SNMP                    April 1999
  1125.  
  1126.  
  1127. vacmViewTreeFamilyTable OBJECT-TYPE
  1128.     SYNTAX       SEQUENCE OF VacmViewTreeFamilyEntry
  1129.     MAX-ACCESS   not-accessible
  1130.     STATUS       current
  1131.     DESCRIPTION "Locally held information about families of subtrees
  1132.                  within MIB views.
  1133.  
  1134.                  Each MIB view is defined by two sets of view subtrees:
  1135.                    - the included view subtrees, and
  1136.                    - the excluded view subtrees.
  1137.                  Every such view subtree, both the included and the
  1138.                  excluded ones, is defined in this table.
  1139.  
  1140.                  To determine if a particular object instance is in
  1141.                  a particular MIB view, compare the object instance's
  1142.                  OBJECT IDENTIFIER with each of the MIB view's active
  1143.                  entries in this table.  If none match, then the
  1144.                  object instance is not in the MIB view.  If one or
  1145.                  more match, then the object instance is included in,
  1146.                  or excluded from, the MIB view according to the
  1147.                  value of vacmViewTreeFamilyType in the entry whose
  1148.                  value of vacmViewTreeFamilySubtree has the most
  1149.                  sub-identifiers.  If multiple entries match and have
  1150.                  the same number of sub-identifiers (when wildcarding
  1151.                  is specified with the value of vacmViewTreeFamilyMask),
  1152.                  then the lexicographically greatest instance of
  1153.                  vacmViewTreeFamilyType determines the inclusion or
  1154.                  exclusion.
  1155.  
  1156.                  An object instance's OBJECT IDENTIFIER X matches an
  1157.                  active entry in this table when the number of
  1158.                  sub-identifiers in X is at least as many as in the
  1159.                  value of vacmViewTreeFamilySubtree for the entry,
  1160.                  and each sub-identifier in the value of
  1161.                  vacmViewTreeFamilySubtree matches its corresponding
  1162.                  sub-identifier in X.  Two sub-identifiers match
  1163.                  either if the corresponding bit of the value of
  1164.                  vacmViewTreeFamilyMask for the entry is zero (the
  1165.                  'wild card' value), or if they are equal.
  1166.  
  1167.                  A 'family' of subtrees is the set of subtrees defined
  1168.                  by a particular combination of values of
  1169.                  vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask.
  1170.                  In the case where no 'wild card' is defined in the
  1171.                  vacmViewTreeFamilyMask, the family of subtrees reduces
  1172.                  to a single subtree.
  1173.  
  1174.                  When creating or changing MIB views, an SNMP Command
  1175.  
  1176.  
  1177.  
  1178. Wijnen, et al.              Standards Track                    [Page 21]
  1179.  
  1180. RFC 2575                     VACM for SNMP                    April 1999
  1181.  
  1182.  
  1183.                  Generator application should utilize the
  1184.                  vacmViewSpinLock to try to avoid collisions. See
  1185.                  DESCRIPTION clause of vacmViewSpinLock.
  1186.  
  1187.                  When creating MIB views, it is strongly advised that
  1188.                  first the 'excluded' vacmViewTreeFamilyEntries are
  1189.                  created and then the 'included' entries.
  1190.  
  1191.                  When deleting MIB views, it is strongly advised that
  1192.                  first the 'included' vacmViewTreeFamilyEntries are
  1193.                  deleted and then the 'excluded' entries.
  1194.  
  1195.                  If a create for an entry for instance-level access
  1196.                  control is received and the implementation does not
  1197.                  support instance-level granularity, then an
  1198.                  inconsistentName error must be returned.
  1199.                 "
  1200.     ::= { vacmMIBViews 2 }
  1201.  
  1202. vacmViewTreeFamilyEntry OBJECT-TYPE
  1203.     SYNTAX       VacmViewTreeFamilyEntry
  1204.     MAX-ACCESS   not-accessible
  1205.     STATUS       current
  1206.     DESCRIPTION "Information on a particular family of view subtrees
  1207.                  included in or excluded from a particular SNMP
  1208.                  context's MIB view.
  1209.  
  1210.                  Implementations must not restrict the number of
  1211.                  families of view subtrees for a given MIB view,
  1212.                  except as dictated by resource constraints on the
  1213.                  overall number of entries in the
  1214.                  vacmViewTreeFamilyTable.
  1215.  
  1216.                  If no conceptual rows exist in this table for a given
  1217.                  MIB view (viewName), that view may be thought of as
  1218.                  consisting of the empty set of view subtrees.
  1219.                 "
  1220.     INDEX       { vacmViewTreeFamilyViewName,
  1221.                   vacmViewTreeFamilySubtree
  1222.                 }
  1223.     ::= { vacmViewTreeFamilyTable 1 }
  1224.  
  1225. VacmViewTreeFamilyEntry ::= SEQUENCE
  1226.     {
  1227.         vacmViewTreeFamilyViewName     SnmpAdminString,
  1228.         vacmViewTreeFamilySubtree      OBJECT IDENTIFIER,
  1229.         vacmViewTreeFamilyMask         OCTET STRING,
  1230.         vacmViewTreeFamilyType         INTEGER,
  1231.  
  1232.  
  1233.  
  1234. Wijnen, et al.              Standards Track                    [Page 22]
  1235.  
  1236. RFC 2575                     VACM for SNMP                    April 1999
  1237.  
  1238.  
  1239.         vacmViewTreeFamilyStorageType  StorageType,
  1240.         vacmViewTreeFamilyStatus       RowStatus
  1241.     }
  1242.  
  1243. vacmViewTreeFamilyViewName OBJECT-TYPE
  1244.     SYNTAX       SnmpAdminString (SIZE(1..32))
  1245.     MAX-ACCESS   not-accessible
  1246.     STATUS       current
  1247.     DESCRIPTION "The human readable name for a family of view subtrees.
  1248.                 "
  1249.     ::= { vacmViewTreeFamilyEntry 1 }
  1250.  
  1251. vacmViewTreeFamilySubtree OBJECT-TYPE
  1252.     SYNTAX       OBJECT IDENTIFIER
  1253.     MAX-ACCESS   not-accessible
  1254.     STATUS       current
  1255.     DESCRIPTION "The MIB subtree which when combined with the
  1256.                  corresponding instance of vacmViewTreeFamilyMask
  1257.                  defines a family of view subtrees.
  1258.                 "
  1259.     ::= { vacmViewTreeFamilyEntry 2 }
  1260.  
  1261. vacmViewTreeFamilyMask OBJECT-TYPE
  1262.     SYNTAX       OCTET STRING (SIZE (0..16))
  1263.     MAX-ACCESS   read-create
  1264.     STATUS       current
  1265.     DESCRIPTION "The bit mask which, in combination with the
  1266.                  corresponding instance of vacmViewTreeFamilySubtree,
  1267.                  defines a family of view subtrees.
  1268.  
  1269.                  Each bit of this bit mask corresponds to a
  1270.                  sub-identifier of vacmViewTreeFamilySubtree, with the
  1271.                  most significant bit of the i-th octet of this octet
  1272.                  string value (extended if necessary, see below)
  1273.                  corresponding to the (8*i - 7)-th sub-identifier, and
  1274.                  the least significant bit of the i-th octet of this
  1275.                  octet string corresponding to the (8*i)-th
  1276.                  sub-identifier, where i is in the range 1 through 16.
  1277.  
  1278.                  Each bit of this bit mask specifies whether or not
  1279.                  the corresponding sub-identifiers must match when
  1280.                  determining if an OBJECT IDENTIFIER is in this
  1281.                  family of view subtrees; a '1' indicates that an
  1282.                  exact match must occur; a '0' indicates 'wild card',
  1283.                  i.e., any sub-identifier value matches.
  1284.  
  1285.                  Thus, the OBJECT IDENTIFIER X of an object instance
  1286.                  is contained in a family of view subtrees if, for
  1287.  
  1288.  
  1289.  
  1290. Wijnen, et al.              Standards Track                    [Page 23]
  1291.  
  1292. RFC 2575                     VACM for SNMP                    April 1999
  1293.  
  1294.  
  1295.                  each sub-identifier of the value of
  1296.                  vacmViewTreeFamilySubtree, either:
  1297.  
  1298.                    the i-th bit of vacmViewTreeFamilyMask is 0, or
  1299.  
  1300.                    the i-th sub-identifier of X is equal to the i-th
  1301.                    sub-identifier of the value of
  1302.                    vacmViewTreeFamilySubtree.
  1303.  
  1304.                  If the value of this bit mask is M bits long and
  1305.                  there are more than M sub-identifiers in the
  1306.                  corresponding instance of vacmViewTreeFamilySubtree,
  1307.                  then the bit mask is extended with 1's to be the
  1308.                  required length.
  1309.  
  1310.                  Note that when the value of this object is the
  1311.                  zero-length string, this extension rule results in
  1312.                  a mask of all-1's being used (i.e., no 'wild card'),
  1313.                  and the family of view subtrees is the one view
  1314.                  subtree uniquely identified by the corresponding
  1315.                  instance of vacmViewTreeFamilySubtree.
  1316.  
  1317.                  Note that masks of length greater than zero length
  1318.                  do not need to be supported. In this case this
  1319.                  object is made read-only.
  1320.                 "
  1321.     DEFVAL      { ''H }
  1322.     ::= { vacmViewTreeFamilyEntry 3 }
  1323.  
  1324. vacmViewTreeFamilyType OBJECT-TYPE
  1325.     SYNTAX       INTEGER  { included(1), excluded(2) }
  1326.     MAX-ACCESS   read-create
  1327.     STATUS       current
  1328.     DESCRIPTION "Indicates whether the corresponding instances of
  1329.                  vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask
  1330.                  define a family of view subtrees which is included in
  1331.                  or excluded from the MIB view.
  1332.                 "
  1333.     DEFVAL      { included }
  1334.     ::= { vacmViewTreeFamilyEntry 4 }
  1335.  
  1336. vacmViewTreeFamilyStorageType OBJECT-TYPE
  1337.     SYNTAX       StorageType
  1338.     MAX-ACCESS   read-create
  1339.     STATUS       current
  1340.     DESCRIPTION "The storage type for this conceptual row.
  1341.  
  1342.                  Conceptual rows having the value 'permanent' need not
  1343.  
  1344.  
  1345.  
  1346. Wijnen, et al.              Standards Track                    [Page 24]
  1347.  
  1348. RFC 2575                     VACM for SNMP                    April 1999
  1349.  
  1350.  
  1351.                  allow write-access to any columnar objects in the row.
  1352.                 "
  1353.     DEFVAL      { nonVolatile }
  1354.     ::= { vacmViewTreeFamilyEntry 5 }
  1355.  
  1356. vacmViewTreeFamilyStatus OBJECT-TYPE
  1357.     SYNTAX       RowStatus
  1358.     MAX-ACCESS   read-create
  1359.     STATUS       current
  1360.     DESCRIPTION "The status of this conceptual row.
  1361.  
  1362.                  The  RowStatus TC [RFC2579] requires that this
  1363.                  DESCRIPTION clause states under which circumstances
  1364.                  other objects in this row can be modified:
  1365.  
  1366.                  The value of this object has no effect on whether
  1367.                  other objects in this conceptual row can be modified.
  1368.                 "
  1369.     ::= { vacmViewTreeFamilyEntry 6 }
  1370.  
  1371. -- Conformance information *******************************************
  1372.  
  1373. vacmMIBCompliances  OBJECT IDENTIFIER ::= { vacmMIBConformance 1 }
  1374. vacmMIBGroups       OBJECT IDENTIFIER ::= { vacmMIBConformance 2 }
  1375.  
  1376. -- Compliance statements *********************************************
  1377.  
  1378. vacmMIBCompliance MODULE-COMPLIANCE
  1379.     STATUS       current
  1380.     DESCRIPTION "The compliance statement for SNMP engines which
  1381.                  implement the SNMP View-based Access Control Model
  1382.                  configuration MIB.
  1383.                 "
  1384.     MODULE -- this module
  1385.         MANDATORY-GROUPS { vacmBasicGroup }
  1386.  
  1387.         OBJECT        vacmAccessContextMatch
  1388.         MIN-ACCESS    read-only
  1389.         DESCRIPTION  "Write access is not required."
  1390.  
  1391.         OBJECT        vacmAccessReadViewName
  1392.         MIN-ACCESS    read-only
  1393.         DESCRIPTION  "Write access is not required."
  1394.  
  1395.         OBJECT        vacmAccessWriteViewName
  1396.         MIN-ACCESS    read-only
  1397.         DESCRIPTION  "Write access is not required."
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Wijnen, et al.              Standards Track                    [Page 25]
  1403.  
  1404. RFC 2575                     VACM for SNMP                    April 1999
  1405.  
  1406.  
  1407.         OBJECT        vacmAccessNotifyViewName
  1408.         MIN-ACCESS    read-only
  1409.         DESCRIPTION  "Write access is not required."
  1410.  
  1411.         OBJECT        vacmAccessStorageType
  1412.         MIN-ACCESS    read-only
  1413.         DESCRIPTION  "Write access is not required."
  1414.  
  1415.         OBJECT        vacmAccessStatus
  1416.         MIN-ACCESS    read-only
  1417.         DESCRIPTION  "Create/delete/modify access to the
  1418.                       vacmAccessTable is not required.
  1419.                      "
  1420.  
  1421.         OBJECT        vacmViewTreeFamilyMask
  1422.         WRITE-SYNTAX  OCTET STRING (SIZE (0))
  1423.         MIN-ACCESS    read-only
  1424.         DESCRIPTION  "Support for configuration via SNMP of subtree
  1425.                       families using wild-cards is not required.
  1426.                      "
  1427.  
  1428.         OBJECT        vacmViewTreeFamilyType
  1429.         MIN-ACCESS    read-only
  1430.         DESCRIPTION  "Write access is not required."
  1431.  
  1432.         OBJECT        vacmViewTreeFamilyStorageType
  1433.         MIN-ACCESS    read-only
  1434.         DESCRIPTION  "Write access is not required."
  1435.  
  1436.         OBJECT        vacmViewTreeFamilyStatus
  1437.         MIN-ACCESS    read-only
  1438.         DESCRIPTION  "Create/delete/modify access to the
  1439.                       vacmViewTreeFamilyTable is not required.
  1440.                      "
  1441.     ::= { vacmMIBCompliances 1 }
  1442.  
  1443. -- Units of conformance **********************************************
  1444.  
  1445. vacmBasicGroup OBJECT-GROUP
  1446.     OBJECTS {
  1447.               vacmContextName,
  1448.               vacmGroupName,
  1449.               vacmSecurityToGroupStorageType,
  1450.               vacmSecurityToGroupStatus,
  1451.               vacmAccessContextMatch,
  1452.               vacmAccessReadViewName,
  1453.               vacmAccessWriteViewName,
  1454.               vacmAccessNotifyViewName,
  1455.  
  1456.  
  1457.  
  1458. Wijnen, et al.              Standards Track                    [Page 26]
  1459.  
  1460. RFC 2575                     VACM for SNMP                    April 1999
  1461.  
  1462.  
  1463.               vacmAccessStorageType,
  1464.               vacmAccessStatus,
  1465.               vacmViewSpinLock,
  1466.               vacmViewTreeFamilyMask,
  1467.               vacmViewTreeFamilyType,
  1468.               vacmViewTreeFamilyStorageType,
  1469.               vacmViewTreeFamilyStatus
  1470.             }
  1471.     STATUS       current
  1472.     DESCRIPTION "A collection of objects providing for remote
  1473.                  configuration of an SNMP engine which implements
  1474.                  the SNMP View-based Access Control Model.
  1475.                 "
  1476.     ::= { vacmMIBGroups 1 }
  1477.  
  1478. END
  1479.  
  1480. 5.  Intellectual Property
  1481.  
  1482.    The IETF takes no position regarding the validity or scope of any
  1483.    intellectual property or other rights that might be claimed to
  1484.    pertain to the implementation or use of the technology described in
  1485.    this document or the extent to which any license under such rights
  1486.    might or might not be available; neither does it represent that it
  1487.    has made any effort to identify any such rights.  Information on the
  1488.    IETF's procedures with respect to rights in standards-track and
  1489.    standards-related documentation can be found in BCP-11.  Copies of
  1490.    claims of rights made available for publication and any assurances of
  1491.    licenses to be made available, or the result of an attempt made to
  1492.    obtain a general license or permission for the use of such
  1493.    proprietary rights by implementors or users of this specification can
  1494.    be obtained from the IETF Secretariat.
  1495.  
  1496.    The IETF invites any interested party to bring to its attention any
  1497.    copyrights, patents or patent applications, or other proprietary
  1498.    rights which may cover technology that may be required to practice
  1499.    this standard.  Please address the information to the IETF Executive
  1500.    Director.
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514. Wijnen, et al.              Standards Track                    [Page 27]
  1515.  
  1516. RFC 2575                     VACM for SNMP                    April 1999
  1517.  
  1518.  
  1519. 6.  Acknowledgements
  1520.  
  1521.    This document is the result of the efforts of the SNMPv3 Working
  1522.    Group.  Some special thanks are in order to the following SNMPv3 WG
  1523.    members:
  1524.  
  1525.    Harald Tveit Alvestrand (Maxware)
  1526.    Dave Battle (SNMP Research, Inc.)
  1527.    Alan Beard (Disney Worldwide Services)
  1528.    Paul Berrevoets (SWI Systemware/Halcyon Inc.)
  1529.    Martin Bjorklund (Ericsson)
  1530.    Uri Blumenthal (IBM T.J. Watson Research Center)
  1531.    Jeff Case (SNMP Research, Inc.)
  1532.    John Curran (BBN)
  1533.    Mike Daniele (Compaq Computer Corporation)
  1534.    T. Max Devlin (Eltrax Systems)
  1535.    John Flick (Hewlett Packard)
  1536.    Rob Frye (MCI)
  1537.    Wes Hardaker (U.C.Davis, Information Technology - D.C.A.S.)
  1538.    David Harrington (Cabletron Systems Inc.)
  1539.    Lauren Heintz (BMC Software, Inc.)
  1540.    N.C. Hien (IBM T.J. Watson Research Center)
  1541.    Michael Kirkham (InterWorking Labs, Inc.)
  1542.    Dave Levi (SNMP Research, Inc.)
  1543.    Louis A Mamakos (UUNET Technologies Inc.)
  1544.    Joe Marzot (Nortel Networks)
  1545.    Paul Meyer (Secure Computing Corporation)
  1546.    Keith McCloghrie (Cisco Systems)
  1547.    Bob Moore (IBM)
  1548.    Russ Mundy (TIS Labs at Network Associates)
  1549.    Bob Natale (ACE*COMM Corporation)
  1550.    Mike O'Dell (UUNET Technologies Inc.)
  1551.    Dave Perkins (DeskTalk)
  1552.    Peter Polkinghorne (Brunel University)
  1553.    Randy Presuhn (BMC Software, Inc.)
  1554.    David Reeder (TIS Labs at Network Associates)
  1555.    David Reid (SNMP Research, Inc.)
  1556.    Aleksey Romanov (Quality Quorum)
  1557.    Shawn Routhier (Epilogue)
  1558.    Juergen Schoenwaelder (TU Braunschweig)
  1559.    Bob Stewart (Cisco Systems)
  1560.    Mike Thatcher (Independent Consultant)
  1561.    Bert Wijnen (IBM T.J. Watson Research Center)
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570. Wijnen, et al.              Standards Track                    [Page 28]
  1571.  
  1572. RFC 2575                     VACM for SNMP                    April 1999
  1573.  
  1574.  
  1575.    The document is based on recommendations of the IETF Security and
  1576.    Administrative Framework Evolution for SNMP Advisory Team.  Members
  1577.    of that Advisory Team were:
  1578.  
  1579.    David Harrington (Cabletron Systems Inc.)
  1580.    Jeff Johnson (Cisco Systems)
  1581.    David Levi (SNMP Research Inc.)
  1582.    John Linn (Openvision)
  1583.    Russ Mundy (Trusted Information Systems) chair
  1584.    Shawn Routhier (Epilogue)
  1585.    Glenn Waters (Nortel)
  1586.    Bert Wijnen (IBM T. J. Watson Research Center)
  1587.  
  1588.    As recommended by the Advisory Team and the SNMPv3 Working Group
  1589.    Charter, the design incorporates as much as practical from previous
  1590.    RFCs and drafts. As a result, special thanks are due to the authors
  1591.    of previous designs known as SNMPv2u and SNMPv2*:
  1592.  
  1593.    Jeff Case (SNMP Research, Inc.)
  1594.    David Harrington (Cabletron Systems Inc.)
  1595.    David Levi (SNMP Research, Inc.)
  1596.    Keith McCloghrie (Cisco Systems)
  1597.    Brian O'Keefe (Hewlett Packard)
  1598.    Marshall T. Rose (Dover Beach Consulting)
  1599.    Jon Saperia (BGS Systems Inc.)
  1600.    Steve Waldbusser (International Network Services)
  1601.    Glenn W. Waters (Bell-Northern Research Ltd.)
  1602.  
  1603. 7.  Security Considerations
  1604.  
  1605. 7.1.  Recommended Practices
  1606.  
  1607.    This document is meant for use in the SNMP architecture.  The View-
  1608.    based Access Control Model described in this document checks access
  1609.    rights to management information based on:
  1610.  
  1611.    - contextName, representing a set of management information at the
  1612.      managed system where the Access Control module is running.
  1613.    - groupName, representing a set of zero or more securityNames.
  1614.      The combination of a securityModel and a securityName is mapped
  1615.      into a group in the View-based Access Control Model.
  1616.    - securityModel under which access is requested.
  1617.    - securityLevel under which access is requested.
  1618.    - operation performed on the management information.
  1619.    - MIB views for read, write or notify access.
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626. Wijnen, et al.              Standards Track                    [Page 29]
  1627.  
  1628. RFC 2575                     VACM for SNMP                    April 1999
  1629.  
  1630.  
  1631.    When the User-based Access Control module is called for checking
  1632.    access rights, it is assumed that the calling module has ensured the
  1633.    authentication and privacy aspects as specified by the securityLevel
  1634.    that is being passed.
  1635.  
  1636.    When creating entries in or deleting entries from the
  1637.    vacmViewTreeFamilyTable it is important to do such in the sequence as
  1638.    recommended in the DESCRIPTION clause of the vacmViewTreeFamilyTable
  1639.    definition. Otherwise unwanted access may be granted while changing
  1640.    the entries in the table.
  1641.  
  1642. 7.2.  Defining Groups
  1643.  
  1644.    The groupNames are used to give access to a group of zero or more
  1645.    securityNames.  Within the View-Based Access Control Model, a
  1646.    groupName is considered to exist if that groupName is listed in the
  1647.    vacmSecurityToGroupTable.
  1648.  
  1649.    By mapping the combination of a securityModel and securityName into a
  1650.    groupName, an SNMP Command Generator application can add/delete
  1651.    securityNames to/from a group, if proper access is allowed.
  1652.  
  1653.    Further it is important to realize that the grouping of
  1654.    <securityModel, securityName> tuples in the vacmSecurityToGroupTable
  1655.    does not take securityLevel into account. It is therefore important
  1656.    that the security administrator uses the securityLevel index in the
  1657.    vacmAccessTable to separate noAuthNoPriv from authPriv and/or
  1658.    authNoPriv access.
  1659.  
  1660. 7.3.  Conformance
  1661.  
  1662.    For an implementation of the View-based Access Control Model to be
  1663.    conformant, it MUST implement the SNMP-VIEW-BASED-ACM-MIB according
  1664.    to the vacmMIBCompliance.  It also SHOULD implement the initial
  1665.    configuration, described in appendix A.
  1666.  
  1667. 7.4.  Access to the SNMP-VIEW-BASED-ACM-MIB
  1668.  
  1669.    The objects in this MIB control the access to all MIB data that is
  1670.    accessible via the SNMP engine and they may be considered sensitive
  1671.    in many environments.  It is important to closely control (both read
  1672.    and write) access to these to these MIB objects by using
  1673.    appropriately configured Access Control models (for example the
  1674.    View-based Access Control Model as specified in this document).
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. Wijnen, et al.              Standards Track                    [Page 30]
  1683.  
  1684. RFC 2575                     VACM for SNMP                    April 1999
  1685.  
  1686.  
  1687. 8.  References
  1688.  
  1689.    [RFC2578]   McCloghrie, K., Perkins, D. and J. Schoenwaelder,
  1690.                "Structure of Management Information Version 2 (SMIv2)",
  1691.                STD 58, RFC 2578, April 1999.
  1692.  
  1693.    [RFC2579]   McCloghrie, K., Perkins, D. and J. Schoenwaelder,
  1694.                "Textual Conventions for SMIv2", STD 58, RFC 2579, April
  1695.                1999.
  1696.  
  1697.    [RFC2119]   Bradner, S., "Key words for use in RFCs to Indicate
  1698.                Requirement Levels", BCP 14, RFC 2119, March 1997.
  1699.  
  1700.    [RFC2571]   Harrington, D., Presuhn, R. and B. Wijnen, "An
  1701.                Architecture for describing SNMP Management Frameworks",
  1702.                RFC 2571, April 1999.
  1703.  
  1704.    [RFC2572]   Case, J., Harrington, D., Presuhn, R. and B. Wijnen,
  1705.                "Message Processing and Dispatching for the Simple
  1706.                Network Management Protocol (SNMP)", RFC 2572, April
  1707.                1999.
  1708.  
  1709.    [RFC2574]   Blumenthal, U. and B. Wijnen, "User-based Security Model
  1710.                (USM) for version 3 of the Simple Network Management
  1711.                Protocol (SNMPv3)", RFC 2574, April 1999.
  1712.  
  1713.    [ISO-ASN.1] Information processing systems - Open Systems
  1714.                Interconnection - Specification of Abstract Syntax
  1715.                Notation One (ASN.1), International Organization for
  1716.                Standardization.  International Standard 8824, (December,
  1717.                1987).
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Wijnen, et al.              Standards Track                    [Page 31]
  1739.  
  1740. RFC 2575                     VACM for SNMP                    April 1999
  1741.  
  1742.  
  1743. 9.  Editors' Addresses
  1744.  
  1745.    Bert Wijnen
  1746.    IBM T. J. Watson Research
  1747.    Schagen 33
  1748.    3461 GL Linschoten
  1749.    Netherlands
  1750.  
  1751.    Phone:      +31-348-432-794
  1752.    EMail:      wijnen@vnet.ibm.com
  1753.  
  1754.  
  1755.    Randy Presuhn
  1756.    BMC Software, Inc
  1757.    965 Stewart Drive
  1758.    Sunnyvale, CA 94086
  1759.    USA
  1760.  
  1761.    Phone:      +1-408-616-3100
  1762.    EMail:      randy_presuhn@bmc.com
  1763.  
  1764.  
  1765.    Keith McCloghrie
  1766.    Cisco Systems, Inc.
  1767.    170 West Tasman Drive
  1768.    San Jose, CA  95134-1706
  1769.    USA
  1770.  
  1771.    Phone:      +1-408-526-5260
  1772.    EMail:      kzm@cisco.com
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794. Wijnen, et al.              Standards Track                    [Page 32]
  1795.  
  1796. RFC 2575                     VACM for SNMP                    April 1999
  1797.  
  1798.  
  1799. APPENDIX A - Installation
  1800.  
  1801. A.1.  Installation Parameters
  1802.  
  1803.    During installation, an authoritative SNMP engine which supports this
  1804.    View-based Access Control Model SHOULD be configured with several
  1805.    initial parameters.  These include for the View-based Access Control
  1806.    Model:
  1807.  
  1808. 1) A security configuration
  1809.  
  1810.    The choice of security configuration determines if initial
  1811.    configuration is implemented and if so how.  One of three possible
  1812.    choices is selected:
  1813.  
  1814.         - initial-minimum-security-configuration
  1815.         - initial-semi-security-configuration
  1816.         - initial-no-access-configuration
  1817.  
  1818.    In the case of a initial-no-access-configuration, there is no initial
  1819.    configuration, and so the following steps are irrelevant.
  1820.  
  1821. 2) A default context
  1822.  
  1823.    One entry in the vacmContextTable with a contextName of "" (the empty
  1824.    string), representing the default context.  Note that this table gets
  1825.    created automatically if a default context exists.
  1826.  
  1827.      vacmContextName                  ""
  1828.  
  1829. 3) An initial group
  1830.  
  1831.    One entry in the vacmSecurityToGroupTable to allow access to group
  1832.    "initial".
  1833.  
  1834.      vacmSecurityModel                3 (USM)
  1835.      vacmSecurityName                 "initial"
  1836.      vacmGroupName                    "initial"
  1837.      vacmSecurityToGroupStorageType   anyValidStorageType
  1838.      vacmSecurityToGroupStatus        active
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850. Wijnen, et al.              Standards Track                    [Page 33]
  1851.  
  1852. RFC 2575                     VACM for SNMP                    April 1999
  1853.  
  1854.  
  1855. 4) Initial access rights
  1856.  
  1857.    Three entries in the vacmAccessTable as follows:
  1858.  
  1859.    - read-notify access for securityModel USM, securityLevel
  1860.      "noAuthNoPriv" on behalf of securityNames that belong to the group
  1861.      "initial" to the <restricted> MIB view in the default context with
  1862.      contextName "".
  1863.  
  1864.    - read-write-notify access for securityModel USM, securityLevel
  1865.      "authNoPriv" on behalf of securityNames that belong to the group
  1866.      "initial" to the <internet> MIB view in the default context with
  1867.      contextName "".
  1868.  
  1869.    - if privacy is supported,
  1870.      read-write-notify access for securityModel USM, securityLevel
  1871.      "authPriv" on behalf of securityNames that belong to the group
  1872.      "initial" to the <internet> MIB view in the default context with
  1873.      contextName "".
  1874.  
  1875.    That translates into the following entries in the vacmAccessTable.
  1876.  
  1877.    - One entry to be used for unauthenticated access (noAuthNoPriv):
  1878.  
  1879.      vacmGroupName                    "initial"
  1880.      vacmAccessContextPrefix          ""
  1881.      vacmAccessSecurityModel          3 (USM)
  1882.      vacmAccessSecurityLevel          noAuthNoPriv
  1883.      vacmAccessContextMatch           exact
  1884.      vacmAccessReadViewName           "restricted"
  1885.      vacmAccessWriteViewName          ""
  1886.      vacmAccessNotifyViewName         "restricted"
  1887.      vacmAccessStorageType            anyValidStorageType
  1888.      vacmAccessStatus                 active
  1889.  
  1890.    - One entry to be used for authenticated access (authNoPriv)
  1891.      with optional privacy (authPriv):
  1892.  
  1893.      vacmGroupName                    "initial"
  1894.      vacmAccessContextPrefix          ""
  1895.      vacmAccessSecurityModel          3 (USM)
  1896.      vacmAccessSecurityLevel          authNoPriv
  1897.      vacmAccessContextMatch           exact
  1898.      vacmAccessReadViewName           "internet"
  1899.      vacmAccessWriteViewName          "internet"
  1900.      vacmAccessNotifyViewName         "internet"
  1901.      vacmAccessStorageType            anyValidStorageType
  1902.      vacmAccessStatus                 active
  1903.  
  1904.  
  1905.  
  1906. Wijnen, et al.              Standards Track                    [Page 34]
  1907.  
  1908. RFC 2575                     VACM for SNMP                    April 1999
  1909.  
  1910.  
  1911. 5) Two MIB views, of which the second one depends on the security
  1912.    configuration.
  1913.  
  1914.    -  One view, the <internet> view, for authenticated access:
  1915.  
  1916.       -  the <internet> MIB view is the following subtree:
  1917.              "internet"  (subtree 1.3.6.1)
  1918.  
  1919.    -  A second view, the <restricted> view, for unauthenticated
  1920.       access.  This view is configured according to the selected
  1921.       security configuration:
  1922.  
  1923.       -  For the initial-no-access-configuration there is no default
  1924.          initial configuration, so no MIB views are pre-scribed.
  1925.  
  1926.       -  For the initial-semi-secure-configuration:
  1927.  
  1928.          the <restricted> MIB view is the union of these subtrees:
  1929.          (a) "system"       (subtree 1.3.6.1.2.1.1)      [RFC1907]
  1930.          (b) "snmp"         (subtree 1.3.6.1.2.1.11)     [RFC1907]
  1931.          (c) "snmpEngine"   (subtree 1.3.6.1.6.3.10.2.1) [RFC2571]
  1932.          (d) "snmpMPDStats" (subtree 1.3.6.1.6.3.11.2.1) [RFC2572]
  1933.          (e) "usmStats"     (subtree 1.3.6.1.6.3.15.1.1) [RFC2574]
  1934.  
  1935.       -  For the initial-minimum-secure-configuration:
  1936.  
  1937.          the <restricted> MIB view is the following subtree.
  1938.              "internet"  (subtree 1.3.6.1)
  1939.  
  1940.    This translates into the following "internet" entry in the
  1941.    vacmViewTreeFamilyTable:
  1942.  
  1943.                                 minimum-secure      semi-secure
  1944.                                 ----------------    ---------------
  1945.   vacmViewTreeFamilyViewName    "internet"          "internet"
  1946.   vacmViewTreeFamilySubtree     1.3.6.1             1.3.6.1
  1947.   vacmViewTreeFamilyMask        ""                  ""
  1948.   vacmViewTreeFamilyType        1 (included)        1 (included)
  1949.   vacmViewTreeFamilyStorageType anyValidStorageType anyValidStorageType
  1950.   vacmViewTreeFamilyStatus      active              active
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962. Wijnen, et al.              Standards Track                    [Page 35]
  1963.  
  1964. RFC 2575                     VACM for SNMP                    April 1999
  1965.  
  1966.  
  1967.    In addition it translates into the following "restricted" entries
  1968.    in the vacmViewTreeFamilyTable:
  1969.  
  1970.                                 minimum-secure      semi-secure
  1971.                                 ----------------    ---------------
  1972.   vacmViewTreeFamilyViewName    "restricted"        "restricted"
  1973.   vacmViewTreeFamilySubtree     1.3.6.1             1.3.6.1.2.1.1
  1974.   vacmViewTreeFamilyMask        ""                  ""
  1975.   vacmViewTreeFamilyType        1 (included)        1 (included)
  1976.   vacmViewTreeFamilyStorageType anyValidStorageType anyValidStorageType
  1977.   vacmViewTreeFamilyStatus      active              active
  1978.  
  1979.   vacmViewTreeFamilyViewName                        "restricted"
  1980.   vacmViewTreeFamilySubtree                         1.3.6.1.2.1.11
  1981.   vacmViewTreeFamilyMask                            ""
  1982.   vacmViewTreeFamilyType                            1 (included)
  1983.   vacmViewTreeFamilyStorageType                     anyValidStorageType
  1984.   vacmViewTreeFamilyStatus                          active
  1985.  
  1986.   vacmViewTreeFamilyViewName                        "restricted"
  1987.   vacmViewTreeFamilySubtree                         1.3.6.1.6.3.10.2.1
  1988.   vacmViewTreeFamilyMask                            ""
  1989.   vacmViewTreeFamilyType                            1 (included)
  1990.   vacmViewTreeFamilyStorageType                     anyValidStorageType
  1991.   vacmViewTreeFamilyStatus                          active
  1992.  
  1993.   vacmViewTreeFamilyViewName                        "restricted"
  1994.   vacmViewTreeFamilySubtree                         1.3.6.1.6.3.11.2.1
  1995.   vacmViewTreeFamilyMask                            ""
  1996.   vacmViewTreeFamilyType                            1 (included)
  1997.   vacmViewTreeFamilyStorageType                     anyValidStorageType
  1998.   vacmViewTreeFamilyStatus                          active
  1999.  
  2000.   vacmViewTreeFamilyViewName                        "restricted"
  2001.   vacmViewTreeFamilySubtree                         1.3.6.1.6.3.15.1.1
  2002.   vacmViewTreeFamilyMask                            ""
  2003.   vacmViewTreeFamilyType                            1 (included)
  2004.   vacmViewTreeFamilyStorageType                     anyValidStorageType
  2005.   vacmViewTreeFamilyStatus                          active
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018. Wijnen, et al.              Standards Track                    [Page 36]
  2019.  
  2020. RFC 2575                     VACM for SNMP                    April 1999
  2021.  
  2022.  
  2023. B.  Change Log
  2024.  
  2025.    Changes made since RFC2275:
  2026.  
  2027.    - Added text to vacmSecurityToGroupStatus DESCRIPTION clause to
  2028.      clarify under which conditions an entry in the
  2029.      vacmSecurityToGroupTable can be made active.
  2030.    - Added REVISION clauses to MODULE-IDENTITY
  2031.    - Clarified text in vacmAccessTable DESCRIPTION clause.
  2032.    - Added a DEFVAL clause to vacmAccessContextMatch object.
  2033.    - Added missing columns in Appendix A and re-arranged for clarity.
  2034.    - Fixed oids in appendix A.
  2035.    - Use the PDU Class terminology instead of RFC1905 PDU types.
  2036.    - Added section 7.4 about access control to the MIB.
  2037.    - Fixed references to new/revised documents
  2038.    - Fix Editor contact information.
  2039.    - fixed spelling errors
  2040.    - removed one vacmAccesEntry from sample in appendix A.
  2041.    - made some more clarifications.
  2042.    - updated acknowledgement section.
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074. Wijnen, et al.              Standards Track                    [Page 37]
  2075.  
  2076. RFC 2575                     VACM for SNMP                    April 1999
  2077.  
  2078.  
  2079. C.  Full Copyright Statement
  2080.  
  2081.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  2082.  
  2083.    This document and translations of it may be copied and furnished to
  2084.    others, and derivative works that comment on or otherwise explain it
  2085.    or assist in its implementation may be prepared, copied, published
  2086.    and distributed, in whole or in part, without restriction of any
  2087.    kind, provided that the above copyright notice and this paragraph are
  2088.    included on all such copies and derivative works.  However, this
  2089.    document itself may not be modified in any way, such as by removing
  2090.    the copyright notice or references to the Internet Society or other
  2091.    Internet organizations, except as needed for the purpose of
  2092.    developing Internet standards in which case the procedures for
  2093.    copyrights defined in the Internet Standards process must be
  2094.    followed, or as required to translate it into languages other than
  2095.    English.
  2096.  
  2097.    The limited permissions granted above are perpetual and will not be
  2098.    revoked by the Internet Society or its successors or assigns.
  2099.  
  2100.    This document and the information contained herein is provided on an
  2101.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  2102.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  2103.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  2104.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  2105.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  2106.  
  2107. Acknowledgement
  2108.  
  2109.    Funding for the RFC Editor function is currently provided by
  2110.    the Internet Society.
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129. Wijnen, et al.              Standards Track                    [Page 38]
  2130.  
  2131.