home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_q_t / draft-ietf-snmpv3-appl-03.txt < prev    next >
Text File  |  1997-10-13  |  143KB  |  4,366 lines
  1.  
  2.  
  3.  
  4. Draft                     SNMPv3 Applications               October 1997
  5.  
  6.  
  7.                           SNMPv3 Applications
  8.  
  9.                             October 9, 1997
  10.  
  11.                     <draft-ietf-snmpv3-appl-03.txt>
  12.  
  13.                              David B. Levi
  14.                           SNMP Research, Inc.
  15.                              levi@snmp.com
  16.  
  17.                                Paul Meyer
  18.                       Secure Computing Corporation
  19.                      paul_meyer@securecomputing.com
  20.  
  21.                               Bob Stewart
  22.                              Cisco Systems
  23.                            bstewart@cisco.com
  24.  
  25.  
  26.  
  27.  
  28.  
  29. Status of this Memo
  30.  
  31.    This document is an Internet-Draft. Internet-Drafts are working
  32.    documents of the Internet Engineering Task Force (IETF), its areas,
  33.    and its working groups.  Note that other groups may also distribute
  34.    working documents as Internet-Drafts.
  35.  
  36.    Internet-Drafts are draft documents valid for a maximum of six months
  37.    and may be updated, replaced, or obsoleted by other documents at any
  38.    time.  It is inappropriate to use Internet-Drafts as reference
  39.    material or to cite them other than as ``work in progress.''
  40.  
  41.    To learn the current status of any Internet-Draft, please check the
  42.    ``1id-abstracts.txt'' listing contained in the Internet-Drafts Shadow
  43.    Directories on ds.internic.net (US East Coast), nic.nordu.net
  44.    (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
  45.    Rim).
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Expires April 1998                                        [Page 1]
  59.  
  60. Draft                     SNMPv3 Applications               October 1997
  61.  
  62.  
  63. 1.  Abstract
  64.  
  65.    This memo describes five types of SNMP applications which make use of
  66.    an SNMP engine as described in [SNMP-ARCH].  The types of application
  67.    described are:
  68.  
  69.        -  Command Generators
  70.  
  71.        -  Command Responders
  72.  
  73.        -  Notification Originators
  74.  
  75.        -  Notification Receivers
  76.  
  77.        -  Proxy Forwarders
  78.  
  79.    This memo also defines MIB modules for specifying targets of
  80.    management operations, for notification filtering, and for proxy
  81.    forwarding.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Expires April 1998                                        [Page 2]
  115.  
  116. Draft                     SNMPv3 Applications               October 1997
  117.  
  118.  
  119. 2.  Overview
  120.  
  121.    This document describes five types of SNMP applications:
  122.  
  123.  
  124.        -  Applications which initiate SNMP Get, GetNext, GetBulk, and/or
  125.           Set requests, called 'command generators.'
  126.  
  127.        -  Applications which respond to SNMP Get, GetNext, GetBulk,
  128.           and/or Set requests, called 'command responders.'
  129.  
  130.        -  Applications which generate notifications, called
  131.           'notification originators.'
  132.  
  133.        -  Applications which receive notifications, called 'notification
  134.           receivers.'
  135.  
  136.        -  Applications which forward SNMP Get, GetNext, GetBulk, and/or
  137.           Set requests or notifications, called 'proxy forwarder.'
  138.  
  139.    Note that there are no restrictions on which types of applications
  140.    may be associated with a particular SNMP engine.  For example, a
  141.    single SNMP engine may, in fact, be associated with both command
  142.    generator and command responder applications.
  143.  
  144.  
  145. 2.1.  Command Generator Applications
  146.  
  147.    A command generator application initiates SNMP Get, GetNext, GetBulk,
  148.    and/or Set requests, as well as processing the response to a request
  149.    which it generated.
  150.  
  151.  
  152. 2.2.  Command Responder Applications
  153.  
  154.    A command responder application receives SNMP Get, GetNext, GetBulk,
  155.    and/or Set requests destined for the local system as indicated by the
  156.    fact that the contextEngineID in the received request is equal to
  157.    that of the local engine through which the request was received.  The
  158.    command responder application will perform the appropriate protocol
  159.    operation, using access control, and will generate a response message
  160.    to be sent to the request's originator.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Expires April 1998                                        [Page 3]
  171.  
  172. Draft                     SNMPv3 Applications               October 1997
  173.  
  174.  
  175. 2.3.  Notification Originator Applications
  176.  
  177.    A notification originator application conceptually monitors a system
  178.    for particular events or conditions, and generates Trap and/or Inform
  179.    messages based on these events or conditions.  A notification
  180.    originator must have a mechanism for determining where to send
  181.    messages, and what SNMP version and security parameters to use when
  182.    sending messages.  A mechanism and MIB module for this purpose is
  183.    provided in this document.
  184.  
  185.  
  186. 2.4.  Notification Receiver Applications
  187.  
  188.    A notification receiver application listens for notification
  189.    messages, and generates response messages when a message containing
  190.    an Inform PDU is received.
  191.  
  192.  
  193. 2.5.  Proxy Forwarder Applications
  194.  
  195.    A proxy forwarder application forwards SNMP messages.  Note that
  196.    implementation of a proxy forwarder application is optional.  The
  197.    sections describing proxy (4.5, 5.3, and 8) may be skipped for
  198.    implementations that do not include a proxy forwarder application.
  199.  
  200.    The term "proxy" has historically been used very loosely, with
  201.    multiple different meanings.  These different meanings include (among
  202.    others):
  203.  
  204. (1)  the forwarding of SNMP requests to other SNMP entities without
  205.      regard for what managed object types are being accessed; for
  206.      example, in order to forward an SNMP request from one transport
  207.      domain to another, or to translate SNMP requests of one version
  208.      into SNMP requests of another version;
  209.  
  210. (2)  the translation of SNMP requests into operations of some non-SNMP
  211.      management protocol; and
  212.  
  213. (3)  support for aggregated managed objects where the value of one
  214.      managed object instance depends upon the values of multiple other
  215.      (remote) items of management information.
  216.  
  217.    Each of these scenarios can be advantageous; for example, support for
  218.    aggregation of management information can significantly reduce the
  219.    bandwidth requirements of large-scale management activities.
  220.    However, using a single term to cover multiple different scenarios
  221.    causes confusion.
  222.  
  223.  
  224.  
  225.  
  226.  
  227. Expires April 1998                                        [Page 4]
  228.  
  229. Draft                     SNMPv3 Applications               October 1997
  230.  
  231.  
  232.    To avoid such confusion, this document uses the term "proxy" with a
  233.    much more tightly defined meaning.  The term "proxy" is used in this
  234.    document to refer to a proxy forwarder application which forwards
  235.    either SNMP requests, notifications, and responses without regard for
  236.    what managed objects are contained within requests or notifications.
  237.    This definition is most closely related to the first definition
  238.    above.  Note, however, that in the SNMP architecture [SNMP-ARCH], a
  239.    proxy forwarder is actually an application, and need not be
  240.    associated with what is traditionally thought of as an SNMP agent.
  241.  
  242.    Specifically, the distinction between a traditional SNMP agent and a
  243.    proxy forwarder application is simple:
  244.  
  245.        -  a proxy forwarder application forwards requests and/or
  246.           notifications to other SNMP engines according to the context,
  247.           and irrespective of the specific managed object types being
  248.           accessed, and forwards the response to such previously
  249.           forwarded messages back to the SNMP engine from which the
  250.           original message was received;
  251.  
  252.        -  in contrast, the command responder application that is part of
  253.           what is traditionally thought of as an SNMP agent, and which
  254.           processes SNMP requests according to the (names of the)
  255.           individual managed object types and instances being accessed,
  256.           is NOT a proxy forwarder application from the perspective of
  257.           this document.
  258.  
  259.    Thus, when a proxy forwarder application forwards a request or
  260.    notification for a particular contextEngineID / contextName pair, not
  261.    only is the information on how to forward the request specifically
  262.    associated with that context, but the proxy forwarder application has
  263.    no need of a detailed definition of a MIB view (since the proxy
  264.    forwarder application forwards the request irrespective of the
  265.    managed object types).
  266.  
  267.    In contrast, a command responder application must have the detailed
  268.    definition of the MIB view, and even if it needs to issue requests to
  269.    other entities, via SNMP or otherwise, that need is dependent on the
  270.    individual managed object instances being accessed (i.e., not only on
  271.    the context).
  272.  
  273.    Note that it is a design goal of a proxy forwarder application to act
  274.    as an intermediary between the endpoints of a transaction.  In
  275.    particular, when forwarding Inform requests, the associated response
  276.    is forwarded when it is received from the target to which the Inform
  277.    request was forwarded, rather than generating a response immediately
  278.    when an Inform request is received.
  279.  
  280.  
  281.  
  282.  
  283.  
  284. Expires April 1998                                        [Page 5]
  285.  
  286. Draft                     SNMPv3 Applications               October 1997
  287.  
  288.  
  289. 3.  Management Targets
  290.  
  291.    Some types of applications (notification generators and proxy
  292.    forwarders in particular) require a mechanism for determining where
  293.    and how to send generated messages.  This document provides a
  294.    mechanism and MIB module for this purpose.  The set of information
  295.    that describes where and how to send a message is called a
  296.    'Management Target', and consists of two kinds of information:
  297.  
  298.        -  Destination information, consisting of a transport domain and
  299.           a transport address.  This is also termed a transport
  300.           endpoint.
  301.  
  302.        -  SNMP parameters, consisting of message processing model,
  303.           security model, security level, and security name information.
  304.  
  305.    The SNMP-TARGET-MIB module described later in this document contains
  306.    one table for each of these types of information.  There can be a
  307.    many-to-many relationship in the MIB between these two types of
  308.    information.  That is, there may be multiple transport endpoints
  309.    associated with a particular set of SNMP parameters, or a particular
  310.    transport endpoint may be associated with several sets of SNMP
  311.    parameters.
  312.  
  313.  
  314. 4.  Elements Of Procedure
  315.  
  316.    The following sections describe the procedures followed by each type
  317.    of application when generating messages for transmission or when
  318.    processing received messages.  Applications communicate with the
  319.    Dispatcher using the abstract service interfaces defined in [SNMP-
  320.    ARCH].
  321.  
  322.  
  323. 4.1.  Command Generator Applications
  324.  
  325.    A command generator initiates an SNMP request by calling the
  326.    Dispatcher using the following abstract service interface:
  327.  
  328.        statusInformation =              -- sendPduHandle if success
  329.                                         -- errorIndication if failure
  330.          sendPdu(
  331.          IN   transportDomain           -- transport domain to be used
  332.          IN   transportAddress          -- destination network address
  333.          IN   messageProcessingModel    -- typically, SNMP version
  334.          IN   securityModel             -- Security Model to use
  335.          IN   securityName              -- on behalf of this principal
  336.  
  337.  
  338.  
  339.  
  340.  
  341. Expires April 1998                                        [Page 6]
  342.  
  343. Draft                     SNMPv3 Applications               October 1997
  344.  
  345.  
  346.          IN   securityLevel             -- Level of Security requested
  347.          IN   contextEngineID           -- data from/at this entity
  348.          IN   contextName               -- data from/in this context
  349.          IN   pduVersion                -- the version of the PDU
  350.          IN   PDU                       -- SNMP Protocol Data Unit
  351.          IN   expectResponse            -- TRUE or FALSE
  352.               )
  353.  
  354.    Where:
  355.  
  356.        -  The transportDomain is that of the destination of the message.
  357.  
  358.        -  The transportAddress is that of the destination of the
  359.           message.
  360.  
  361.        -  The messageProcessingModel indicates which Message Processing
  362.           Model the application wishes to use.
  363.  
  364.        -  The securityModel is the security model that the application
  365.           wishes to use.
  366.  
  367.        -  The securityName is the security model independent name for
  368.           the principal on whose behalf the application wishes the
  369.           message is to be generated.
  370.  
  371.        -  The securityLevel is the security level that the application
  372.           wishes to use.
  373.  
  374.        -  The contextEngineID is provided by the command generator if it
  375.           wishes to explicitly specify the location of the management
  376.           information it is requesting.
  377.  
  378.        -  The contextName is provided by the command generator if it
  379.           wishes to explicitly specify the local context name for the
  380.           management information it is requesting.
  381.  
  382.        -  The pduVersion indicates the version of the PDU to be sent.
  383.  
  384.        -  The PDU is a value constructed by the command generator
  385.           containing the management operation that the command generator
  386.           wishes to perform.
  387.  
  388.        -  The expectResponse argument indicates that a response is
  389.           expected.
  390.  
  391.    The result of the sendPdu interface indicates whether the PDU was
  392.    successfully sent.  If it was successfully sent, the returned value
  393.  
  394.  
  395.  
  396.  
  397.  
  398. Expires April 1998                                        [Page 7]
  399.  
  400. Draft                     SNMPv3 Applications               October 1997
  401.  
  402.  
  403.    will be a sendPduHandle.  The command generator should store the
  404.    sendPduHandle so that it can correlate a response to the original
  405.    request.
  406.  
  407.    The Dispatcher is responsible for delivering the response to a
  408.    particular request to the correct command generator application.  The
  409.    abstract service interface used is:
  410.  
  411.        processResponsePdu(              -- process Response PDU
  412.          IN   messageProcessingModel    -- typically, SNMP version
  413.          IN   securityModel             -- Security Model in use
  414.          IN   securityName              -- on behalf of this principal
  415.          IN   securityLevel             -- Level of Security
  416.          IN   contextEngineID           -- data from/at this SNMP entity
  417.          IN   contextName               -- data from/in this context
  418.          IN   pduVersion                -- the version of the PDU
  419.          IN   PDU                       -- SNMP Protocol Data Unit
  420.          IN   statusInformation         -- success or errorIndication
  421.          IN   sendPduHandle             -- handle from sendPDU
  422.               )
  423.  
  424.    Where:
  425.  
  426.        -  The messageProcessingModel is the value from the received
  427.           response.
  428.  
  429.        -  The securityModel is the value from the received response.
  430.  
  431.        -  The securityName is the value from the received response.
  432.  
  433.        -  The securityLevel is the value from the received response.
  434.  
  435.        -  The contextEngineID is the value from the received response.
  436.  
  437.        -  The contextName is the value from the received response.
  438.  
  439.        -  The pduVersion indicates the version of the PDU in the
  440.           received response.
  441.  
  442.        -  The PDU is the value from the received response.
  443.  
  444.        -  The statusInformation indicates success or failure in
  445.           receiving the response.
  446.  
  447.        -  The sendPduHandle is the value returned by the sendPdu call
  448.           which generated the original request to which this is a
  449.           response.
  450.  
  451.  
  452.  
  453.  
  454.  
  455. Expires April 1998                                        [Page 8]
  456.  
  457. Draft                     SNMPv3 Applications               October 1997
  458.  
  459.  
  460.    The procedure when a command generator receives a message is as
  461.    follows:
  462.  
  463. (1)  If the received values of messageProcessingModel, securityModel,
  464.      securityName, contextEngineID, contextName, and pduVersion are not
  465.      all equal to the values used in the original request, the response
  466.      is discarded.
  467.  
  468. (2)  The operation type, request-id, error-status, error-index, and
  469.      variable-bindings are extracted from the PDU and saved.  If the
  470.      request-id is not equal to the value used in the original request,
  471.      the response is discarded.
  472.  
  473. (3)  At this point, it is up to the application to take an appropriate
  474.      action.  The specific action is implementation dependent.  If the
  475.      statusInformation indicates that the request failed, an appropriate
  476.      action might be to attempt to transmit the request again, or to
  477.      notify the person operating the application that a failure
  478.      occurred.
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511. Expires April 1998                                        [Page 9]
  512.  
  513. Draft                     SNMPv3 Applications               October 1997
  514.  
  515.  
  516. 4.2.  Command Responder Applications
  517.  
  518.    Before a command responder application can process messages, it must
  519.    first associate itself with an SNMP engine.  The abstract service
  520.    interface used for this purpose is:
  521.  
  522.        statusInformation =        -- success or errorIndication
  523.          registerContextEngineID(
  524.          IN   contextEngineID     -- take responsibility for this one
  525.          IN   pduType             -- the pduType(s) to be registered
  526.               )
  527.  
  528.    Where:
  529.  
  530.        -  The statusInformation indicates success or failure of the
  531.           registration attempt.
  532.  
  533.        -  The contextEngineID is equal to the snmpEngineID of the SNMP
  534.           engine with which the command responder is registering.
  535.  
  536.        -  The pduType indicates a Get, GetNext, GetBulk, or Set pdu.
  537.  
  538.    Note that if another command responder application is already
  539.    registered with an SNMP engine, any further attempts to register with
  540.    the same contextEngineID and pduType will be denied.  This implies
  541.    that separate command responder applications could register
  542.    separately for the various pdu types.  However, in practice this is
  543.    undesirable, and only a single command responder application should
  544.    be registered with an SNMP engine at any given time.
  545.  
  546.    A command responder application can disassociate with an SNMP engine
  547.    using the following abstract service interface:
  548.  
  549.        unregisterContextEngineID(
  550.          IN   contextEngineID     -- give up responsibility for this one
  551.          IN   pduType             -- the pduType(s) to be unregistered
  552.               )
  553.  
  554.    Where:
  555.  
  556.        -  The contextEngineID is equal to the snmpEngineID of the SNMP
  557.           engine with which the command responder is cancelling the
  558.           registration.
  559.  
  560.        -  The pduType indicates a Get, GetNext, GetBulk, or Set pdu.
  561.  
  562.    Once the command responder has registered with the SNMP engine, it
  563.  
  564.  
  565.  
  566.  
  567.  
  568. Expires April 1998                                       [Page 10]
  569.  
  570. Draft                     SNMPv3 Applications               October 1997
  571.  
  572.  
  573.    waits to receive SNMP messages.  The abstract service interface used
  574.    for receiving messages is:
  575.  
  576.    processPdu(                     -- process Request/Notification PDU
  577.      IN   messageProcessingModel   -- typically, SNMP version
  578.      IN   securityModel            -- Security Model in use
  579.      IN   securityName             -- on behalf of this principal
  580.      IN   securityLevel            -- Level of Security
  581.      IN   contextEngineID          -- data from/at this SNMP entity
  582.      IN   contextName              -- data from/in this context
  583.      IN   pduVersion               -- the version of the PDU
  584.      IN   PDU                      -- SNMP Protocol Data Unit
  585.      IN   maxSizeResponseScopedPDU -- maximum size of the Response PDU
  586.      IN   stateReference           -- reference to state information
  587.           )                        -- needed when sending a response
  588.  
  589.    Where:
  590.  
  591.        -  The messageProcessingModel indicates which Message Processing
  592.           Model received and processed the message.
  593.  
  594.        -  The securityModel is the value from the received message.
  595.  
  596.        -  The securityName is the value from the received message.
  597.  
  598.        -  The securityLevel is the value from the received message.
  599.  
  600.        -  The contextEngineID is the value from the received message.
  601.  
  602.        -  The contextName is the value from the received message.
  603.  
  604.        -  The pduVersion indicates the version of the PDU in the
  605.           received message.
  606.  
  607.        -  The PDU is the value from the received message.
  608.  
  609.        -  The maxSizeResponseScopedPDU is the maximum allowable size of
  610.           a ScopedPDU containing a Response PDU (based on the maximum
  611.           message size that the originator of the message can accept).
  612.  
  613.        -  The stateReference is a value which references cached
  614.           information about each received request message.  This value
  615.           must be returned to the Dispatcher in order to generate a
  616.           response.
  617.  
  618.    The procedure when a message is received is as follows.
  619.  
  620.  
  621.  
  622.  
  623.  
  624. Expires April 1998                                       [Page 11]
  625.  
  626. Draft                     SNMPv3 Applications               October 1997
  627.  
  628.  
  629. (1)  The operation type is determined from the ASN.1 tag value
  630.      associated with the PDU parameter.  The operation type should
  631.      always be one of the types previously registered by the
  632.      application.
  633.  
  634. (2)  The request-id is extracted from the PDU and saved.
  635.  
  636. (3)  If the SNMPv2 operation type is GetBulk, the non-repeaters and
  637.      max-repetitions values are extracted from the PDU and saved.
  638.  
  639. (4)  The variable-bindings are extracted from the PDU and saved.
  640.  
  641. (5)  The management operation represented by the SNMPv2 operation type
  642.      is performed with respect to the relevant MIB view within the
  643.      context named by the contextName, according to the procedures set
  644.      forth in [RFC1905].  The relevant MIB view is determined by the
  645.      securityLevel, securityModel, contextName, securityName, and SNMPv2
  646.      operation type.  To determine whether a particular object instance
  647.      is within the relevant MIB view, the following abstract service
  648.      interface is called:
  649.  
  650.          statusInformation =      -- success or errorIndication
  651.            isAccessAllowed(
  652.            IN   securityModel     -- Security Model in use
  653.            IN   securityName      -- principal who wants to access
  654.            IN   securityLevel     -- Level of Security
  655.            IN   viewType          -- read, write, or notify view
  656.            IN   contextName       -- context containing variableName
  657.            IN   variableName      -- OID for the managed object
  658.                 )
  659.  
  660.      Where:
  661.  
  662.        -  The securityModel is the value from the received message.
  663.  
  664.        -  The securityName is the value from the received message.
  665.  
  666.        -  The securityLevel is the value from the received message.
  667.  
  668.        -  The viewType indicates whether the PDU type is a read or write
  669.           operation.
  670.  
  671.        -  The contextName is the value from the received message.
  672.  
  673.        -  The variableName is the object instance of the variable for
  674.           which access rights are to be checked.
  675.  
  676.  
  677.  
  678.  
  679.  
  680. Expires April 1998                                       [Page 12]
  681.  
  682. Draft                     SNMPv3 Applications               October 1997
  683.  
  684.  
  685.      Normally, the result of the management operation will be a new PDU
  686.      value, and processing will continue in step (6) below.  However, at
  687.      any time during the processing of the management operation:
  688.  
  689.        -  If the isAccessAllowed ASI returns a noSuchView,
  690.           noAccessEntry, or noGroupName error, processing of the
  691.           management operation is halted, a PDU value is contructed
  692.           using the values from the originally received PDU, but
  693.           replacing the error_status with an authorizationError code,
  694.           and error_index value of 0, and control is passed to step (6)
  695.           below.
  696.  
  697.        -  If the isAccessAllowed ASI returns an otherError, processing
  698.           of the management operation is halted, a different PDU value
  699.           is contructed using the values from the originally received
  700.           PDU, but replacing the error_status with a genError code, and
  701.           control is passed to step (6) below.
  702.  
  703.        -  If the isAccessAllowed ASI returns a noSuchContext error,
  704.           processing of the management operation is halted, no result
  705.           PDU is generated, the snmpUnknownContexts counter is
  706.           incremented, and control is passed to step (6) below.
  707.  
  708.        -  If the context named by the contextName parameter is
  709.           unavailable, processing of the management operation is halted,
  710.           no result PDU is generated, the snmpUnavailableContexts
  711.           counter is incremented, and control is passed to step (6)
  712.           below.
  713.  
  714.  
  715. (6)  The Dispatcher is called to generate a response or report message.
  716.      The abstract service interface is:
  717.  
  718.      returnResponsePdu(
  719.        IN   messageProcessingModel   -- typically, SNMP version
  720.        IN   securityModel            -- Security Model in use
  721.        IN   securityName             -- on behalf of this principal
  722.        IN   securityLevel            -- same as on incoming request
  723.        IN   contextEngineID          -- data from/at this SNMP entity
  724.        IN   contextName              -- data from/in this context
  725.        IN   pduVersion               -- the version of the PDU
  726.        IN   PDU                      -- SNMP Protocol Data Unit
  727.        IN   maxSizeResponseScopedPDU -- maximum size of the Response PDU
  728.        IN   stateReference           -- reference to state information
  729.                                      -- as presented with the request
  730.        IN   statusInformation        -- success or errorIndication
  731.             )                        -- error counter OID/value if error
  732.  
  733.  
  734.  
  735.  
  736.  
  737. Expires April 1998                                       [Page 13]
  738.  
  739. Draft                     SNMPv3 Applications               October 1997
  740.  
  741.  
  742.      Where:
  743.  
  744.        -  The messageProcessingModel is the value from the processPdu
  745.           call.
  746.  
  747.        -  The securityModel is the value from the processPdu call.
  748.  
  749.        -  The securityName is the value from the processPdu call.
  750.  
  751.        -  The securityLevel is the value from the processPdu call.
  752.  
  753.        -  The contextEngineID is the value from the processPdu call.
  754.  
  755.        -  The contextName is the value from the processPdu call.
  756.  
  757.        -  The pduVersion indicates the version of the PDU to be
  758.           returned.  If no result PDU was generated, the pduVersion is
  759.           an undefined value.
  760.  
  761.        -  The PDU is the result generated in step (5) above.  If no
  762.           result PDU was generated, the PDU is an undefined value.
  763.  
  764.        -  The maxSizeResponseScopedPDU is a local value indicating the
  765.           maximum size of a ScopedPDU that the application can accept.
  766.  
  767.        -  The stateReference is the value from the processPdu call.
  768.  
  769.        -  The statusInformation either contains an indication that no
  770.           error occurred and that a response should be generated, or
  771.           contains an indication that an error occurred along with the
  772.           OID and counter value of the appropriate error counter object.
  773.  
  774.    Note that a command responder application should always call the
  775.    returnResponsePdu abstract service interface, even in the event of an
  776.    error such as a resource allocation error.  In the event of such an
  777.    error, the PDU value passed to returnResponsePdu should contain
  778.    appropriate values for errorStatus and errorIndex.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793. Expires April 1998                                       [Page 14]
  794.  
  795. Draft                     SNMPv3 Applications               October 1997
  796.  
  797.  
  798. 4.3.  Notification Originator Applications
  799.  
  800.    A notification originator application generates SNMP notification
  801.    messages.  A notification message may, for example, contain an
  802.    SNMPv2-Trap PDU or an Inform PDU.  However, a particular
  803.    implementation is not required to be capable of generating both types
  804.    of messages.
  805.  
  806.    Notification originator applications require a mechanism for
  807.    identifying the management targets to which notifications should be
  808.    sent.  The particular mechanism used is implementation dependent.
  809.    However, if an implementation makes the configuration of management
  810.    targets SNMP manageable, it MUST use the SNMP-TARGET-MIB module
  811.    described in this document.
  812.  
  813.    When a notification originator wishes to generate a notification, it
  814.    must first determine in which context the information to be conveyed
  815.    in the notification exists, i.e., it must determine the
  816.    contextEngineID and contextName.  It must then determine the set of
  817.    management targets to which the notification should be sent.  The
  818.    application must also determine, for each management target, whether
  819.    the notification message should contain an SNMPv2-Trap PDU or Inform
  820.    PDU, and if it is to contain an Inform PDU, the number of retries and
  821.    retransmission algorithm.
  822.  
  823.    The mechanism by which a notification originator determines this
  824.    information is implementation dependent.  Once the application has
  825.    determined this information, the following procedure is performed for
  826.    each management target:
  827.  
  828. (1)  Any appropriate filtering mechanisms are applied to determine
  829.      whether the notification should be sent to the management target.
  830.      If such filtering mechanisms determine that the notification should
  831.      not be sent, processing continues with the next management target.
  832.      Otherwise,
  833.  
  834. (2)  The appropriate set of variable-bindings is retrieved from local
  835.      MIB instrumentation within the relevant MIB view.  The relevant MIB
  836.      view is determined by the securityLevel, securityModel,
  837.      contextName, and securityName of the management target.  To
  838.      determine whether a particular object instance is within the
  839.      relevant MIB view, the isAccessAllowed abstract service interface
  840.      is used, in the same manner as described in the preceding section.
  841.      If the statusInformation returned by isAccessAllowed does not
  842.      indicate accessAllowed, the notification is not sent to the
  843.      management target.
  844.  
  845.  
  846.  
  847.  
  848.  
  849. Expires April 1998                                       [Page 15]
  850.  
  851. Draft                     SNMPv3 Applications               October 1997
  852.  
  853.  
  854. (3)  A PDU is constructed using a locally unique request-id value, an
  855.      operation type of SNMPv2-Trap or Inform, an error-status and
  856.      error-index value of 0, and the variable-bindings supplied
  857.      previously in step (2).
  858.  
  859. (4)  If the notification contains an SNMPv2-Trap PDU, the Dispatcher is
  860.      called using the following abstract service interface:
  861.  
  862.          statusInformation =              -- sendPduHandle if success
  863.                                           -- errorIndication if failure
  864.            sendPdu(
  865.            IN   transportDomain           -- transport domain to be used
  866.            IN   transportAddress          -- destination network address
  867.            IN   messageProcessingModel    -- typically, SNMP version
  868.            IN   securityModel             -- Security Model to use
  869.            IN   securityName              -- on behalf of this principal
  870.            IN   securityLevel             -- Level of Security requested
  871.            IN   contextEngineID           -- data from/at this entity
  872.            IN   contextName               -- data from/in this context
  873.            IN   pduVersion                -- the version of the PDU
  874.            IN   PDU                       -- SNMP Protocol Data Unit
  875.            IN   expectResponse            -- TRUE or FALSE
  876.                 )
  877.  
  878.      Where:
  879.  
  880.        -  The transportDomain is that of the management target.
  881.  
  882.        -  The transportAddress is that of the management target.
  883.  
  884.        -  The messageProcessingModel is that of the management target.
  885.  
  886.        -  The securityModel is that of the management target.
  887.  
  888.        -  The securityName is that of the management target.
  889.  
  890.        -  The securityLevel is that of the management target.
  891.  
  892.        -  The contextEngineID is the value originally determined for the
  893.           notification.
  894.  
  895.        -  The contextName is the value originally determined for the
  896.           notification.
  897.  
  898.        -  The pduVersion is the version of the PDU to be sent.
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905. Expires April 1998                                       [Page 16]
  906.  
  907. Draft                     SNMPv3 Applications               October 1997
  908.  
  909.  
  910.        -  The PDU is the value constructed in step (3) above.
  911.  
  912.        -  The expectResponse argument indicates that no response is
  913.           expected.
  914.  
  915.      Otherwise,
  916.  
  917. (5)  If the notification contains an Inform PDU, then:
  918.  
  919.       a)  The Dispatcher is called using the sendPdu abstract service
  920.           interface as described in step (4) above, except that the
  921.           expectResponse argument indicates that a response is expected.
  922.  
  923.       b)   The application caches information about the management
  924.           target.
  925.  
  926.       c)  If a response is received within an appropriate time interval
  927.           from the transport endpoint of the management target, the
  928.           notification is considered acknowledged and the cached
  929.           information is deleted.  Otherwise,
  930.  
  931.       d)  If a response is not received within an appropriate time
  932.           period, or if a report indication is received, information
  933.           about the management target is retrieved from the cache, and
  934.           steps a) through d) are repeated.  The number of times these
  935.           steps are repeated is equal to the previously determined retry
  936.           count.  If this retry count is exceeded, the acknowledgement
  937.           of the notification is considered to have failed, and
  938.           processing of the notification for this management target is
  939.           halted.
  940.  
  941.    Responses to Inform PDU notifications will be received via the
  942.    processResponsePDU abstract service interface.
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961. Expires April 1998                                       [Page 17]
  962.  
  963. Draft                     SNMPv3 Applications               October 1997
  964.  
  965.  
  966. 4.4.  Notification Receiver Applications
  967.  
  968.    Notification receiver applications receive SNMP Notification messages
  969.    from the Dispatcher.  Before any messages can be received, the
  970.    notification receiver must register with the Dispatcher using the
  971.    registerContextEngineID abstract service interface.  The parameters
  972.    used are:
  973.  
  974.        -  The contextEngineID is an undefined 'wildcard' value.
  975.           Notifications are delivered to a registered notification
  976.           receiver regardless of the contextEngineID contained in the
  977.           notification message.
  978.  
  979.        -  The pduType indicates the type of notifications that the
  980.           application wishes to receive (for example, SNMPv2-Trap PDUs
  981.           or Inform PDUs).
  982.  
  983.    Once the notification receiver has registered with the Dispatcher,
  984.    messages are received using the processPdu abstract service
  985.    interface.  Parameters are:
  986.  
  987.        -  The messageProcessingModel indicates which Message Processing
  988.           Model received and processed the message.
  989.  
  990.        -  The securityModel is the value from the received message.
  991.  
  992.        -  The securityName is the value from the received message.
  993.  
  994.        -  The securityLevel is the value from the received message.
  995.  
  996.        -  The contextEngineID is the value from the received message.
  997.  
  998.        -  The contextName is the value from the received message.
  999.  
  1000.        -  The pduVersion indicates the version of the PDU in the
  1001.           received message.
  1002.  
  1003.        -  The PDU is the value from the received message.
  1004.  
  1005.        -  The maxSizeResponseScopedPDU is the maximum allowable size of
  1006.           a ScopedPDU containing a Response PDU (based on the maximum
  1007.           message size that the originator of the message can accept).
  1008.  
  1009.        -  If the message contains an SNMPv2-Trap PDU, the stateReference
  1010.           is undefined and unused.  Otherwise, the stateReference is a
  1011.           value which references cached information about the
  1012.           notification.  This value must be returned to the Dispatcher
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018. Expires April 1998                                       [Page 18]
  1019.  
  1020. Draft                     SNMPv3 Applications               October 1997
  1021.  
  1022.  
  1023.           in order to generate a response.
  1024.  
  1025.    When an SNMPv2-Trap PDU is delivered to a notification receiver
  1026.    application, it first extracts the SNMP operation type, request-id,
  1027.    error-status, error-index, and variable-bindings from the PDU.  After
  1028.    this, processing depends on the particular implementation.
  1029.  
  1030.    When an Inform PDU is received, the notification receiver application
  1031.    follows the following procedure:
  1032.  
  1033. (1)  The SNMPv2 operation type, request-id, error-status, error-index,
  1034.      and variable-bindings are extracted from the PDU.
  1035.  
  1036. (2)  A Response PDU is constructed using the extracted request-id and
  1037.      variable-bindings, and with error-status and error-index both set
  1038.      to 0.
  1039.  
  1040. (3)  The Dispatcher is called to generate a response message using the
  1041.      returnResponsePdu abstract service interface.  Parameters are:
  1042.  
  1043.        -  The messageProcessingModel is the value from the processPdu
  1044.           call.
  1045.  
  1046.        -  The securityModel is the value from the processPdu call.
  1047.  
  1048.        -  The securityName is the value from the processPdu call.
  1049.  
  1050.        -  The securityLevel is the value from the processPdu call.
  1051.  
  1052.        -  The contextEngineID is the value from the processPdu call.
  1053.  
  1054.        -  The contextName is the value from the processPdu call.
  1055.  
  1056.        -  The pduVersion indicates the version of the PDU to be
  1057.           returned.
  1058.  
  1059.        -  The PDU is the result generated in step (2) above.
  1060.  
  1061.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1062.           maximum size of a ScopedPDU that the application can accept.
  1063.  
  1064.        -  The stateReference is the value from the processPdu call.
  1065.  
  1066.        -  The statusInformation indicates that no error occurred and
  1067.           that a response should be generated.
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074. Expires April 1998                                       [Page 19]
  1075.  
  1076. Draft                     SNMPv3 Applications               October 1997
  1077.  
  1078.  
  1079. 4.5.  Proxy Forwarder Applications
  1080.  
  1081.    A proxy forwarder application deals with forwarding SNMP messages.
  1082.    There are four basic types of messages which a proxy forwarder
  1083.    application may need to forward.  These are grouped according to the
  1084.    PDU type contained in a message, or according to whether a report
  1085.    indication is contained in the message.  The four basic types of
  1086.    messages are:
  1087.  
  1088.        -  Those containing PDU types which were generated by a command
  1089.           generator application (for example, Get, GetNext, GetBulk, and
  1090.           Set PDU types).  These deal with requesting or modifying
  1091.           information located within a particular context.
  1092.  
  1093.        -  Those containing PDU types which were generated by a
  1094.           notification originator application (for example, SNMPv2-Trap
  1095.           and Inform PDU types).  These deal with notifications
  1096.           concerning information located within a particular context.
  1097.  
  1098.        -  Those containing a Response PDU type.  Forwarding of Response
  1099.           PDUs always occurs as a result of receiving a response to a
  1100.           previously forwarded message.
  1101.  
  1102.        -  Those containing a report indication.  Forwarding of report
  1103.           indications always occurs as a result of receiving a report
  1104.           indication for a previously forwarded message.
  1105.  
  1106.    For the first type, the proxy forwarder's role is to deliver a
  1107.    request for management information to an SNMP engine which is
  1108.    "closer" or "downstream in the path" to the SNMP engine which has
  1109.    access to that information, and to deliver the response containing
  1110.    the information back to the SNMP engine from which the request was
  1111.    received.  The context information in a request is used to determine
  1112.    which SNMP engine has access to the requested information, and this
  1113.    is used to determine where and how to forward the request.
  1114.  
  1115.    For the second type, the proxy forwarder's role is to determine which
  1116.    SNMP engines should receive notifications about management
  1117.    information from a particular location.  The context information in a
  1118.    notification message determines the location to which the information
  1119.    contained in the notification applies.  This is used to determine
  1120.    which SNMP engines should receive notification about this
  1121.    information.
  1122.  
  1123.    For the third type, the proxy forwarder's role is to determine which
  1124.    previously forwarded request or notification (if any) the response
  1125.    matches, and to forward the response back to the initiator of the
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131. Expires April 1998                                       [Page 20]
  1132.  
  1133. Draft                     SNMPv3 Applications               October 1997
  1134.  
  1135.  
  1136.    request or notification.
  1137.  
  1138.    For the fourth type, the proxy forwarder's role is to determine which
  1139.    previously forwarded request or notification (if any) the report
  1140.    indication matches, and to forward the report indication back to the
  1141.    initiator of the request or notification.
  1142.  
  1143.    When forwarding messages, a proxy forwarder application must perform
  1144.    a translation of incoming management target information into outgoing
  1145.    management target information.  How this translation is performed is
  1146.    implementation specific.  In many cases, this will be driven by a
  1147.    preconfigured translation table.  If a proxy forwarder application
  1148.    makes the contents of this table SNMP manageable, it MUST use the
  1149.    SNMP-PROXY-MIB module defined in this document.
  1150.  
  1151.  
  1152. 4.5.1.  Request Forwarding
  1153.  
  1154.    There are two phases for request forwarding.  First, the incoming
  1155.    request needs to be passed through the proxy application.  Then, the
  1156.    resulting response needs to be passed back.  These phases are
  1157.    described in the following two sections.
  1158.  
  1159.  
  1160. 4.5.1.1.  Processing an Incoming Request
  1161.  
  1162.    A proxy forwarder application that wishes to forward request messages
  1163.    must first register with the Dispatcher using the
  1164.    registerContextEngineID abstract service interface.  The proxy
  1165.    forwarder must register each contextEngineID for which it wishes to
  1166.    forward messages, as well as for each pduType.  Note that as the
  1167.    configuration of a proxy forwarder is changed, the particular
  1168.    contextEngineID values for which it is forwarding may change.  The
  1169.    proxy forwarder should call the registerContextEngineID and
  1170.    unregisterContextEngineID abstract service interfaces as needed to
  1171.    reflect its current configuration.
  1172.  
  1173.    A proxy forwarder application should never attempt to register a
  1174.    value of contextEngineID which is equal to the snmpEngineID of the
  1175.    SNMP engine to which the proxy forwarder is associated.
  1176.  
  1177.    Once the proxy forwarder has registered for the appropriate
  1178.    contextEngineId values, it can start processing messages.  The
  1179.    following procedure is used:
  1180.  
  1181. (1)  A message is received using the processPdu abstract service
  1182.      interface.  The incoming management target information received
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188. Expires April 1998                                       [Page 21]
  1189.  
  1190. Draft                     SNMPv3 Applications               October 1997
  1191.  
  1192.  
  1193.      from the processPdu interface is translated into outgoing
  1194.      management target information.  Note that this translation may vary
  1195.      for different values of contextEngineID and/or contextName.  The
  1196.      translation should result in a single management target.
  1197.  
  1198. (2)  If appropriate outgoing management target information cannot be
  1199.      found, the proxy forwarder increments the snmpProxyDrops counter
  1200.      [RFC1907], and then calls the Dispatcher using the
  1201.      returnResponsePdu abstract service interface.  Parameters are:
  1202.  
  1203.        -  The messageProcessingModel is the value from the processPdu
  1204.           call.
  1205.  
  1206.        -  The securityModel is the value from the processPdu call.
  1207.  
  1208.        -  The securityName is the value from the processPdu call.
  1209.  
  1210.        -  The securityLevel is the value from the processPdu call.
  1211.  
  1212.        -  The contextEngineID is the value from the processPdu call.
  1213.  
  1214.        -  The contextName is the value from the processPdu call.
  1215.  
  1216.        -  The pduVersion is the value from the processPdu call.
  1217.  
  1218.        -  The PDU is an undefined value.
  1219.  
  1220.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1221.           maximum size of a ScopedPDU that the application can accept.
  1222.  
  1223.        -  The stateReference is the value from the processPdu call.
  1224.  
  1225.        -  The statusInformation indicates that an error occurred and
  1226.           includes the OID and value of the snmpProxyDrops object.
  1227.  
  1228.      Processing of the message stops at this point.  Otherwise,
  1229.  
  1230. (3)  A new PDU is constructed.  A unique value of request-id should be
  1231.      used in the new PDU (this value will enable a subsequent response
  1232.      message to be correlated with this request).  The remainder of the
  1233.      new PDU is identical to the received PDU, unless the incoming SNMP
  1234.      version is SNMPv2 or SNMPv3 and the outgoing SNMP version is
  1235.      SNMPv1, in which case the proxy forwarder must apply the
  1236.      translation rules as documented in [RFC1908].
  1237.  
  1238. (4)  The proxy forwarder calls the Dispatcher to generate the forwarded
  1239.      message, using the sendPdu abstract service interface.  The
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245. Expires April 1998                                       [Page 22]
  1246.  
  1247. Draft                     SNMPv3 Applications               October 1997
  1248.  
  1249.  
  1250.      parameters are:
  1251.  
  1252.        -  The transportDomain is that of the outgoing management target.
  1253.  
  1254.        -  The transportAddress is that of the outgoing management
  1255.           target.
  1256.  
  1257.        -  The messageProcessingModel is that of the outgoing management
  1258.           target.
  1259.  
  1260.        -  The securityModel is that of the outgoing management target.
  1261.  
  1262.        -  The securityName is that of the outgoing management target.
  1263.  
  1264.        -  The securityLevel is that of the outgoing management target.
  1265.  
  1266.        -  The contextEngineID is the value originally received.
  1267.  
  1268.        -  The contextName is the value originally received.
  1269.  
  1270.        -  The pduVersion is the version of the PDU to be sent.
  1271.  
  1272.        -  The PDU is the value constructed in step (3) above.
  1273.  
  1274.        -  The expectResponse argument indicates that a response is
  1275.           expected.  If the sendPdu call is unsuccessful, the proxy
  1276.           forwarder performs the steps described in (2) above.
  1277.           Otherwise:
  1278.  
  1279. (5)  The proxy forwarder caches the following information in order to
  1280.      match an incoming response to the forwarded request:
  1281.  
  1282.        -  The sendPduHandle returned from the call to sendPdu,
  1283.  
  1284.        -  The request-id from the received PDU.
  1285.  
  1286.        -  the contextEngineID,
  1287.  
  1288.        -  the contextName,
  1289.  
  1290.        -  the stateReference,
  1291.  
  1292.        -  the incoming management target information,
  1293.  
  1294.        -  the outgoing management information,
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301. Expires April 1998                                       [Page 23]
  1302.  
  1303. Draft                     SNMPv3 Applications               October 1997
  1304.  
  1305.  
  1306.        -  any other information needed to match an incoming response to
  1307.           the forwarded request.
  1308.  
  1309.      If this information cannot be cached (possibly due to a lack of
  1310.      resources), the proxy forwarder performs the steps described in (2)
  1311.      above.  Otherwise:
  1312.  
  1313. (6)  Processing of the request stops until a response to the forwarded
  1314.      request is received, or until an appropriate time interval has
  1315.      expired.  If this time interval expires before a response has been
  1316.      received, the cached information about this request is removed.
  1317.  
  1318.  
  1319. 4.5.1.2.  Processing an Incoming Response
  1320.  
  1321.    A proxy forwarder follows the following procedure when an incoming
  1322.    response is received:
  1323.  
  1324. (1)  The incoming response is received using the processResponsePdu
  1325.      interface.  The proxy forwarder uses the received parameters to
  1326.      locate an entry in its cache of pending forwarded requests.  This
  1327.      is done by matching the received parameters with the cached values
  1328.      of sendPduHandle, contextEngineID, contextName, outgoing management
  1329.      target information, and the request-id contained in the received
  1330.      PDU (the proxy forwarder must extract the request-id for this
  1331.      purpose).  If an appropriate cache entry cannot be found,
  1332.      processing of the response is halted.  Otherwise:
  1333.  
  1334. (2)  The cache information is extracted, and removed from the cache.
  1335.  
  1336. (3)  A new Response PDU is constructed, using the request-id value from
  1337.      the original forwarded request (as extracted from the cache).  All
  1338.      other values are identical to those in the received Response PDU.
  1339.  
  1340. (4)  If the incoming SNMP version is SNMPv1 and the outgoing SNMP
  1341.      version is SNMPv2 or SNMPv3, the proxy forwarder must apply the
  1342.      translation rules documented in [RFC1908].
  1343.  
  1344. (5)  The proxy forwarder calls the Dispatcher using the
  1345.      returnResponsePdu abstract service interface.  Parameters are:
  1346.  
  1347.        -  The messageProcessingModel indicates the Message Processing
  1348.           Model by which the original incoming message was processed.
  1349.  
  1350.        -  The securityModel is that of the original incoming management
  1351.           target extracted from the cache.
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357. Expires April 1998                                       [Page 24]
  1358.  
  1359. Draft                     SNMPv3 Applications               October 1997
  1360.  
  1361.  
  1362.        -  The securityName is that of the original incoming management
  1363.           target extracted from the cache.
  1364.  
  1365.        -  The securityLevel is that of the original incoming management
  1366.           target extracted from the cache.
  1367.  
  1368.        -  The contextEngineID is the value extracted from the cache.
  1369.  
  1370.        -  The contextName is the value extracted from the cache.
  1371.  
  1372.        -  The pduVersion indicates the version of the PDU to be
  1373.           returned.
  1374.  
  1375.        -  The PDU is the (possibly translated) Response PDU.
  1376.  
  1377.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1378.           maximum size of a ScopedPDU that the application can accept.
  1379.  
  1380.        -  The stateReference is the value extracted from the cache.
  1381.  
  1382.        -  The statusInformation indicates that no error occurred and
  1383.           that a Response PDU message should be generated.
  1384.  
  1385.  
  1386. 4.5.1.3.  Processing an Incoming Report Indication
  1387.  
  1388.    A proxy forwarder follows the following procedure when an incoming
  1389.    report indication is received:
  1390.  
  1391. (1)  The incoming report indication is received using the
  1392.      processResponsePdu interface.  The proxy forwarder uses the
  1393.      received parameters to locate an entry in its cache of pending
  1394.      forwarded requests.  This is done by matching the received
  1395.      parameters with the cached values of sendPduHandle.  If an
  1396.      appropriate cache entry cannot be found, processing of the report
  1397.      indication is halted.  Otherwise:
  1398.  
  1399. (2)  The cache information is extracted, and removed from the cache.
  1400.  
  1401. (3)  If the original incoming management target information indicates
  1402.      SNMPv1, processing of the report indication is halted.
  1403.  
  1404. (4)  The proxy forwarder calls the Dispatcher using the
  1405.      returnResponsePdu abstract service interface.  Parameters are:
  1406.  
  1407.        -  The messageProcessingModel indicates the Message Processing
  1408.           Model by which the original incoming message was processed.
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414. Expires April 1998                                       [Page 25]
  1415.  
  1416. Draft                     SNMPv3 Applications               October 1997
  1417.  
  1418.  
  1419.        -  The securityModel is that of the original incoming management
  1420.           target extracted from the cache.
  1421.  
  1422.        -  The securityName is that of the original incoming management
  1423.           target extracted from the cache.
  1424.  
  1425.        -  The securityLevel is that of the original incoming management
  1426.           target extracted from the cache.
  1427.  
  1428.        -  The contextEngineID is the value extracted from the cache.
  1429.  
  1430.        -  The contextName is the value extracted from the cache.
  1431.  
  1432.        -  The pduVersion indicates the version of the PDU to be
  1433.           returned.
  1434.  
  1435.        -  The PDU is unused.
  1436.  
  1437.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1438.           maximum size of a ScopedPDU that the application can accept.
  1439.  
  1440.        -  The stateReference is the value extracted from the cache.
  1441.  
  1442.        -  The statusInformation contain the contextEngineID,
  1443.           contextName, counter OID, and counter value received in the
  1444.           report indication.
  1445.  
  1446.  
  1447. 4.5.2.  Notification Forwarding
  1448.  
  1449.    A proxy forwarder receives notifications in the same manner as a
  1450.    notification receiver application, using the processPdu abstract
  1451.    service interface.  The following procedure is used when a
  1452.    notification is received:
  1453.  
  1454. (1)  The incoming management target information received from the
  1455.      processPdu interface is translated into outgoing management target
  1456.      information.  Note that this translation may vary for different
  1457.      values of contextEngineId and/or contextName.  The translation may
  1458.      result in multiple management targets.
  1459.  
  1460. (2)  If appropriate outgoing management target information cannot be
  1461.      found and the notification was a Trap, processing of the
  1462.      notification is halted.  If appropriate outgoing management target
  1463.      information cannot be found and the notification was an Inform, the
  1464.      proxy forwarder increments the snmpProxyDrops object, and calls the
  1465.      Dispatcher using the returnResponsePdu abstract service interface.
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471. Expires April 1998                                       [Page 26]
  1472.  
  1473. Draft                     SNMPv3 Applications               October 1997
  1474.  
  1475.  
  1476.      The parameters are:
  1477.  
  1478.        -  The messageProcessingModel is the received value.
  1479.  
  1480.        -  The securityModel is the received value.
  1481.  
  1482.        -  The securityName is the received value.
  1483.  
  1484.        -  The securityLevel is the received value.
  1485.  
  1486.        -  The contextEngineID is the received value.
  1487.  
  1488.        -  The contextName is the received value.
  1489.  
  1490.        -  The pduVersion is the received value.
  1491.  
  1492.        -  The PDU is an undefined and unused value.
  1493.  
  1494.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1495.           maximum size of a ScopedPDU that the application can accept.
  1496.  
  1497.        -  The stateReference is the received value.
  1498.  
  1499.        -  The statusInformation indicates that an error occurred and
  1500.           that a Report message should be generated.
  1501.  
  1502.      Processing of the message stops at this point.  Otherwise,
  1503.  
  1504. (3)  The proxy forwarder generates a notification using the procedures
  1505.      described in the preceding section on Notification Originators,
  1506.      with the following exceptions:
  1507.  
  1508.        -  The contextEngineID and contextName values from the original
  1509.           received notification are used.
  1510.  
  1511.        -  The outgoing management targets previously determined are
  1512.           used.
  1513.  
  1514.        -  No filtering mechanisms are applied.
  1515.  
  1516.        -  The variable-bindings from the original received notification
  1517.           are used, rather than retrieving variable-bindings from local
  1518.           MIB instrumentation.  In particular, no access-control is
  1519.           applied to these variable-bindings.
  1520.  
  1521.        -  If for any of the outgoing management targets, the incoming
  1522.           SNMP version is SNMPv1 and the outgoing SNMP version is SNMPv2
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528. Expires April 1998                                       [Page 27]
  1529.  
  1530. Draft                     SNMPv3 Applications               October 1997
  1531.  
  1532.  
  1533.           or SNMPv3, the proxy forwarder must apply the translation
  1534.           rules as documented in [RFC1908].
  1535.  
  1536.        -  If for any of the outgoing management targets, the incoming
  1537.           SNMP version is SNMPv2 or SNMPv3, and the outgoing SNMP
  1538.           version is SNMPv1, this outgoing management target is not used
  1539.           when generating the forwarded notifications.
  1540.  
  1541. (4)  If the original received notification contains an SNMPv2-Trap PDU,
  1542.      processing of the notification is now completed.  Otherwise, the
  1543.      original received notification must contain an Inform PDU, and
  1544.      processing continues.
  1545.  
  1546. (5)  If the forwarded notifications included any Inform PDUs, processing
  1547.      continues when the procedures described in the section for
  1548.      Notification Originators determine that either:
  1549.  
  1550.        -  None of the generated notifications containing Inform PDUs
  1551.           have been successfully acknowledged within the longest of the
  1552.           time intervals, in which case processing of the original
  1553.           notification is halted, or,
  1554.  
  1555.        -  At least one of the generated notifications containing Inform
  1556.           PDUs is successfully acknowledged, in which case a response to
  1557.           the original received notification containing an Inform PDU is
  1558.           generated as described in the following steps.
  1559.  
  1560. (6)  A Response PDU is constructed, using the values of request-id and
  1561.      variable-bindings from the original received Inform PDU, and
  1562.      error-status and error-index values of 0.
  1563.  
  1564. (7)  The Dispatcher is called using the returnResponsePdu abstract
  1565.      service interface.  Parameters are:
  1566.  
  1567.        -  The messageProcessingModel is the originally received value.
  1568.  
  1569.        -  The securityModel is the originally received value.
  1570.  
  1571.        -  The securityName is the originally received value.
  1572.  
  1573.        -  The securityLevel is the originally received value.
  1574.  
  1575.        -  The contextEngineID is the originally received value.
  1576.  
  1577.        -  The contextName is the originally received value.
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584. Expires April 1998                                       [Page 28]
  1585.  
  1586. Draft                     SNMPv3 Applications               October 1997
  1587.  
  1588.  
  1589.        -  The pduVersion indicates the version of the PDU constructed in
  1590.           step (6) above.
  1591.  
  1592.        -  The PDU is the value constructed in step (6) above.
  1593.  
  1594.        -  The maxSizeResponseScopedPDU is a local value indicating the
  1595.           maximum size of a ScopedPDU that the application can accept.
  1596.  
  1597.        -  The stateReference is the originally received value.
  1598.  
  1599.        -  The statusInformation indicates that no error occurred and
  1600.           that a Response PDU message should be generated.
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640. Expires April 1998                                       [Page 29]
  1641.  
  1642. Draft                     SNMPv3 Applications               October 1997
  1643.  
  1644.  
  1645. 5.  The Structure of the MIB Modules
  1646.  
  1647.    There are three separate MIB modules described in this document, the
  1648.    management target MIB, the notification MIB, and the proxy MIB.  The
  1649.    following sections describe the structure of these three MIB modules.
  1650.  
  1651.    The use of these MIBs by particular types of applications is
  1652.    described later in this document:
  1653.  
  1654.        -  The use of the management target MIB and the notification MIB
  1655.           in notification originator applications is described in
  1656.           section 6.
  1657.  
  1658.        -  The use of the notification MIB for filtering notifications in
  1659.           notification originator applications is described in section
  1660.           7.
  1661.  
  1662.        -  The use of the management target MIB and the proxy MIB in
  1663.           proxy forwarding applications is described in section 8.
  1664.  
  1665.  
  1666.  
  1667. 5.1.  The Management Target MIB Module
  1668.  
  1669.    The SNMP-TARGET-MIB module contains objects for defining management
  1670.    targets.  It consists of two tables and conformance/compliance
  1671.    statements.
  1672.  
  1673.    The first table, the snmpTargetAddrTable, contains information about
  1674.    transport domains and addresses.  It also contains an object,
  1675.    snmpTargetAddrTagList, which provides a mechanism for grouping
  1676.    entries.
  1677.  
  1678.    The second table, the snmpTargetParamsTable, contains information
  1679.    about SNMP version and security information to be used when sending
  1680.    messages to particular transport domains and addresses.
  1681.  
  1682.  
  1683. 5.1.1.  Tag Lists
  1684.  
  1685.    The snmpTargetAddrTagList object is used for grouping entries in the
  1686.    snmpTargetAddrTable.  The value of this object contains a list of tag
  1687.    values which are used to select target addresses to be used for a
  1688.    particular operation.
  1689.  
  1690.    A tag value, which may also be used in MIB objects other than
  1691.    snmpTargetAddrTagList, is an arbitrary string of octets, but may not
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697. Expires April 1998                                       [Page 30]
  1698.  
  1699. Draft                     SNMPv3 Applications               October 1997
  1700.  
  1701.  
  1702.    contain a delimiter character.  Delimiter characters are defined to
  1703.    be one of the following characters:
  1704.  
  1705.        -  An ASCII space character (0x20).
  1706.  
  1707.        -  An ASCII TAB character (0x09).
  1708.  
  1709.        -  An ASCII carriage return (CR) character (0x0D).
  1710.  
  1711.        -  An ASCII line feed (LF) character (0x0B).
  1712.  
  1713.    In addition, a tag value may not have a zero length.  Generally, a
  1714.    particular MIB object may contain either
  1715.  
  1716.        -  a single tag value, in which case the value of the MIB object
  1717.           may not contain a delimiter character, or:
  1718.  
  1719.        -  a MIB object may contain a list of tag values, separated by
  1720.           single delimiter characters.
  1721.  
  1722.    For a list of tag values, these constraints imply certain
  1723.    restrictions on the value of a MIB object:
  1724.  
  1725.        -  There cannot be a leading or trailing delimiter character.
  1726.  
  1727.        -  There cannot be multiple adjacent delimiter charaters.
  1728.  
  1729.  
  1730. 5.1.2.  Definitions
  1731.  
  1732.    SNMP-TARGET-MIB DEFINITIONS ::= BEGIN
  1733.  
  1734.    IMPORTS
  1735.        TEXTUAL-CONVENTION,
  1736.        MODULE-IDENTITY,
  1737.        OBJECT-TYPE,
  1738.        snmpModules,
  1739.        Integer32
  1740.            FROM SNMPv2-SMI
  1741.  
  1742.        TDomain,
  1743.        TAddress,
  1744.        TimeInterval,
  1745.        RowStatus,
  1746.        StorageType,
  1747.        TestAndIncr
  1748.            FROM SNMPv2-TC
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754. Expires April 1998                                       [Page 31]
  1755.  
  1756. Draft                     SNMPv3 Applications               October 1997
  1757.  
  1758.  
  1759.        SnmpSecurityModel,
  1760.        SnmpMessageProcessingModel,
  1761.        SnmpSecurityLevel,
  1762.        SnmpAdminString
  1763.            FROM SNMP-FRAMEWORK-MIB
  1764.  
  1765.        OBJECT-GROUP
  1766.            FROM SNMPv2-CONF;
  1767.  
  1768.    snmpTargetMIB MODULE-IDENTITY
  1769.        LAST-UPDATED "9707140000Z"
  1770.        ORGANIZATION "IETF SNMPv3 Working Group"
  1771.        CONTACT-INFO
  1772.            "WG-email:   snmpv3@tis.com
  1773.             Subscribe:  majordomo@tis.com
  1774.                         In message body:  subscribe snmpv3
  1775.  
  1776.             Chair:      Russ Mundy
  1777.                         Trusted Information Systems
  1778.             Postal:     3060 Washington Rd
  1779.                         Glenwood MD 21738
  1780.                         USA
  1781.             Email:      mundy@tis.com
  1782.             Phone:      +1-301-854-6889
  1783.  
  1784.             Co-editor:  David B. Levi
  1785.                         SNMP Research, Inc.
  1786.             Postal:     3001 Kimberlin Heights Road
  1787.                         Knoxville, TN 37920-9716
  1788.             E-mail:     levi@snmp.com
  1789.             Phone:      +1 423 573 1434
  1790.  
  1791.             Co-editor:  Paul Meyer
  1792.                         Secure Computing Corporation
  1793.             Postal:     2675 Long Lake Road
  1794.                         Roseville, MN 55113
  1795.             E-mail:     paul_meyer@securecomputing.com
  1796.             Phone:      +1 612 628 1592
  1797.  
  1798.             Co-editor:  Bob Stewart
  1799.                         Cisco Systems, Inc.
  1800.             Postal:     170 West Tasman Drive
  1801.                         San Jose, CA 95134-1706
  1802.             E-mail:     bstewart@cisco.com
  1803.             Phone:      +1 603 654 6923"
  1804.        DESCRIPTION
  1805.            "This MIB module defines MIB objects which provide
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811. Expires April 1998                                       [Page 32]
  1812.  
  1813. Draft                     SNMPv3 Applications               October 1997
  1814.  
  1815.  
  1816.             mechanisms to remotely configure the parameters used
  1817.             by an SNMP entity for the generation of SNMP messages."
  1818.        REVISION        "9707140000Z"
  1819.        DESCRIPTION
  1820.            "The initial revision."
  1821.        ::= { snmpModules 11 }        -- TBD
  1822.  
  1823.    snmpTargetObjects       OBJECT IDENTIFIER ::= { snmpTargetMIB 1 }
  1824.    snmpTargetConformance   OBJECT IDENTIFIER ::= { snmpTargetMIB 3 }
  1825.  
  1826.    SnmpTagValue ::= TEXTUAL-CONVENTION
  1827.        DISPLAY-HINT "255a"
  1828.        STATUS       current
  1829.        DESCRIPTION
  1830.            "An octet string containing a tag value.
  1831.             Tag values are preferably in human-readable form.
  1832.  
  1833.             To facilitate internationalization, this information
  1834.             is represented using the ISO/IEC IS 10646-1 character
  1835.             set, encoded as an octet string using the UTF-8
  1836.             character encoding scheme described in RFC 2044.
  1837.  
  1838.             Since additional code points are added by amendments
  1839.             to the 10646 standard from time to time,
  1840.             implementations must be prepared to encounter any code
  1841.             point from 0x00000000 to 0x7fffffff.
  1842.  
  1843.             The use of control codes should be avoided, and certain
  1844.             control codes are not allowed as described below.
  1845.  
  1846.             For code points not directly supported by user
  1847.             interface hardware or software, an alternative means
  1848.             of entry and display, such as hexadecimal, may be
  1849.             provided.
  1850.  
  1851.             For information encoded in 7-bit US-ASCII, the UTF-8
  1852.             representation is identical to the US-ASCII encoding.
  1853.  
  1854.             Note that when this TC is used for an object that
  1855.             is used or envisioned to be used as an index, then a
  1856.             SIZE restriction must be specified so that the number
  1857.             sub-identifiers for any object instance do not exceed
  1858.             the limit of 128, as defined by [RFC1905].
  1859.  
  1860.             An object of this type contains a single tag value
  1861.             which is used to select a set of entries in a table.
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867. Expires April 1998                                       [Page 33]
  1868.  
  1869. Draft                     SNMPv3 Applications               October 1997
  1870.  
  1871.  
  1872.             A tag value is an arbitrary string of octets, but
  1873.             may not contain a delimiter character.  Delimiter
  1874.             characters are defined to be one of the following:
  1875.  
  1876.                 -  An ASCII space character (0x20).
  1877.  
  1878.                 -  An ASCII TAB character (0x09).
  1879.  
  1880.                 -  An ASCII carriage return (CR) character (0x0D).
  1881.  
  1882.                 -  An ASCII line feed (LF) character (0x0B).
  1883.  
  1884.             Delimiter characters are used to separate tag values
  1885.             in a tag list.  An object of this type may only
  1886.             contain a single tag value, and so delimiter
  1887.             characters are not allowed in a value of this type.
  1888.  
  1889.             Some examples of valid tag values are:
  1890.  
  1891.                 - 'acme'
  1892.  
  1893.                 - 'router'
  1894.  
  1895.                 - 'host'
  1896.  
  1897.             The use of a tag value to select table entries is
  1898.             application and MIB specific."
  1899.        SYNTAX       OCTET STRING (SIZE (0..255))
  1900.  
  1901.    SnmpTagList ::= TEXTUAL-CONVENTION
  1902.        DISPLAY-HINT "255a"
  1903.        STATUS       current
  1904.        DESCRIPTION
  1905.            "An octet string containing a list of tag values.
  1906.             Tag values are preferably in human-readable form.
  1907.  
  1908.             To facilitate internationalization, this information
  1909.             is represented using the ISO/IEC IS 10646-1 character
  1910.             set, encoded as an octet string using the UTF-8
  1911.             character encoding scheme described in RFC 2044.
  1912.  
  1913.             Since additional code points are added by amendments
  1914.             to the 10646 standard from time to time,
  1915.             implementations must be prepared to encounter any code
  1916.             point from 0x00000000 to 0x7fffffff.
  1917.  
  1918.             The use of control codes should be avoided, except as
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924. Expires April 1998                                       [Page 34]
  1925.  
  1926. Draft                     SNMPv3 Applications               October 1997
  1927.  
  1928.  
  1929.             described below.
  1930.  
  1931.             For code points not directly supported by user
  1932.             interface hardware or software, an alternative means
  1933.             of entry and display, such as hexadecimal, may be
  1934.             provided.
  1935.  
  1936.             For information encoded in 7-bit US-ASCII, the UTF-8
  1937.             representation is identical to the US-ASCII encoding.
  1938.  
  1939.             An object of this type contains a list of tag values
  1940.             which are used to select a set of entries in a table.
  1941.  
  1942.             A tag value is an arbitrary string of octets, but
  1943.             may not contain a delimiter character.  Delimiter
  1944.             characters are defined to be one of the following:
  1945.  
  1946.                 -  An ASCII space character (0x20).
  1947.  
  1948.                 -  An ASCII TAB character (0x09).
  1949.  
  1950.                 -  An ASCII carriage return (CR) character (0x0D).
  1951.  
  1952.                 -  An ASCII line feed (LF) character (0x0B).
  1953.  
  1954.             Delimiter characters are used to separate tag values
  1955.             in a tag list.  Only a single delimiter character may
  1956.             occur between two tag values.  A tag value may not
  1957.             have a zero length.  These constraints imply certain
  1958.             restrictions on the contents of this object:
  1959.  
  1960.                 - There cannot be a leading or trailing delimiter
  1961.                   character.
  1962.  
  1963.                 - There cannot be multiple adjacent delimiter
  1964.                   characters.
  1965.  
  1966.             Some examples of valid tag lists are:
  1967.  
  1968.                 - An empty string
  1969.  
  1970.                 - 'acme router'
  1971.  
  1972.                 - 'host managerStation'
  1973.  
  1974.             Note that although a tag value may not have a length of
  1975.             zero, an empty string is still valid.  This indicates
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981. Expires April 1998                                       [Page 35]
  1982.  
  1983. Draft                     SNMPv3 Applications               October 1997
  1984.  
  1985.  
  1986.             an empty list (i.e. there are no tag values in the list).
  1987.  
  1988.             The use of the tag list to select table entries is
  1989.             application and MIB specific.  Typically, an application
  1990.             will provide one or more tag values, and any entry
  1991.             which contains some combination of these tag values
  1992.             will be selected."
  1993.        SYNTAX       OCTET STRING (SIZE (0..255))
  1994.  
  1995.    --
  1996.    --
  1997.    -- The snmpTargetObjects group
  1998.    --
  1999.    --
  2000.  
  2001.    snmpTargetSpinLock OBJECT-TYPE
  2002.        SYNTAX      TestAndIncr
  2003.        MAX-ACCESS  read-write
  2004.        STATUS      current
  2005.        DESCRIPTION
  2006.            "This object is used to facilitate modification of table
  2007.             entries in the SNMP-TARGET-MIB module by multiple
  2008.             managers.  In particular, it is useful when modifying
  2009.             the value of the snmpTargetAddrTagList object.
  2010.  
  2011.             The procedure for modifying the snmpTargetAddrTagList
  2012.             object is as follows:
  2013.  
  2014.                 1.  Retrieve the value of snmpTargetSpinLock and
  2015.                     of snmpTargetAddrTagList.
  2016.  
  2017.                 2.  Generate a new value for snmpTargetAddrTagList.
  2018.  
  2019.                 3.  Set the value of snmpTargetSpinLock to the
  2020.                     retrieved value, and the value of
  2021.                     snmpTargetAddrTagList to the new value.  If
  2022.                     the set fails for the snmpTargetSpinLock
  2023.                     object, go back to step 1."
  2024.        ::= { snmpTargetObjects 1 }
  2025.  
  2026.    snmpTargetAddrTable OBJECT-TYPE
  2027.        SYNTAX      SEQUENCE OF SnmpTargetAddrEntry
  2028.        MAX-ACCESS  not-accessible
  2029.        STATUS      current
  2030.        DESCRIPTION
  2031.            "A table of transport addresses to be used in the generation
  2032.             of SNMP messages."
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038. Expires April 1998                                       [Page 36]
  2039.  
  2040. Draft                     SNMPv3 Applications               October 1997
  2041.  
  2042.  
  2043.        ::= { snmpTargetObjects 2 }
  2044.  
  2045.    snmpTargetAddrEntry OBJECT-TYPE
  2046.        SYNTAX      SnmpTargetAddrEntry
  2047.        MAX-ACCESS  not-accessible
  2048.        STATUS      current
  2049.        DESCRIPTION
  2050.            "A transport address to be used in the generation
  2051.             of SNMP operations.
  2052.  
  2053.             Entries in the snmpTargetAddrTable are created and
  2054.             deleted using the snmpTargetAddrRowStatus object."
  2055.        INDEX { IMPLIED snmpTargetAddrName }
  2056.        ::= { snmpTargetAddrTable 1 }
  2057.  
  2058.    SnmpTargetAddrEntry ::= SEQUENCE {
  2059.        snmpTargetAddrName         SnmpAdminString,
  2060.        snmpTargetAddrTDomain      TDomain,
  2061.        snmpTargetAddrTAddress     TAddress,
  2062.        snmpTargetAddrTimeout      TimeInterval,
  2063.        snmpTargetAddrRetryCount   Integer32,
  2064.        snmpTargetAddrTagList      SnmpTagList,
  2065.        snmpTargetAddrParams       SnmpAdminString,
  2066.        snmpTargetAddrStorageType  StorageType,
  2067.        snmpTargetAddrRowStatus    RowStatus
  2068.    }
  2069.  
  2070.    snmpTargetAddrName OBJECT-TYPE
  2071.        SYNTAX      SnmpAdminString (SIZE(1..32))
  2072.        MAX-ACCESS  not-accessible
  2073.        STATUS      current
  2074.        DESCRIPTION
  2075.            "The locally arbitrary, but unique identifier associated
  2076.             with this snmpTargetAddrEntry."
  2077.        ::= { snmpTargetAddrEntry 1 }
  2078.  
  2079.    snmpTargetAddrTDomain OBJECT-TYPE
  2080.        SYNTAX      TDomain
  2081.        MAX-ACCESS  read-create
  2082.        STATUS      current
  2083.        DESCRIPTION
  2084.            "This object indicates the transport type of the address
  2085.             contained in the snmpTargetAddrTAddress object."
  2086.        ::= { snmpTargetAddrEntry 2 }
  2087.  
  2088.    snmpTargetAddrTAddress OBJECT-TYPE
  2089.        SYNTAX      TAddress
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095. Expires April 1998                                       [Page 37]
  2096.  
  2097. Draft                     SNMPv3 Applications               October 1997
  2098.  
  2099.  
  2100.        MAX-ACCESS  read-create
  2101.        STATUS      current
  2102.        DESCRIPTION
  2103.            "This object contains a transport address.  The format of
  2104.             this address depends on the value of the
  2105.             snmpTargetAddrTDomain object."
  2106.        ::= { snmpTargetAddrEntry 3 }
  2107.  
  2108.    snmpTargetAddrTimeout OBJECT-TYPE
  2109.        SYNTAX      TimeInterval
  2110.        MAX-ACCESS  read-create
  2111.        STATUS      current
  2112.        DESCRIPTION
  2113.            "This object should reflect the expected maximum round
  2114.             trip time for communicating with the transport address
  2115.             defined by this row.  When a message is sent to this
  2116.             address, and a response (if one is expected) is not
  2117.             received within this time period, an implementation
  2118.             may assume that the response will not be delivered.
  2119.  
  2120.             Note that the time interval that an application waits
  2121.             for a response may actually be derived from the value
  2122.             of this object.  The method for deriving the actual time
  2123.             interval is implementation dependent.  One such method
  2124.             is to derive the expected round trip time based on a
  2125.             particular retransmission algorithm and on the number
  2126.             of timeouts which have occurred.  The type of message may
  2127.             also be considered when deriving expected round trip
  2128.             times for retransmissions.  For example, if a message is
  2129.             being sent with a securityLevel that indicates both
  2130.             authentication and privacy, the derived value may be
  2131.             increased to compensate for extra processing time spent
  2132.             during authentication and encryption processing."
  2133.        DEFVAL { 1500 }
  2134.        ::= { snmpTargetAddrEntry 4 }
  2135.  
  2136.    snmpTargetAddrRetryCount OBJECT-TYPE
  2137.        SYNTAX      Integer32 (0..255)
  2138.        MAX-ACCESS  read-create
  2139.        STATUS      current
  2140.        DESCRIPTION
  2141.            "This object specifies a default number of retries to be
  2142.             attempted when a response is not received for a generated
  2143.             message.  An application may provide its own retry count,
  2144.             in which case the value of this object is ignored."
  2145.        DEFVAL { 3 }
  2146.        ::= { snmpTargetAddrEntry 5 }
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152. Expires April 1998                                       [Page 38]
  2153.  
  2154. Draft                     SNMPv3 Applications               October 1997
  2155.  
  2156.  
  2157.    snmpTargetAddrTagList OBJECT-TYPE
  2158.        SYNTAX      SnmpTagList
  2159.        MAX-ACCESS  read-create
  2160.        STATUS      current
  2161.        DESCRIPTION
  2162.            "This object contains a list of tag values which are
  2163.             used to select target addresses for a particular
  2164.             operation."
  2165.        ::= { snmpTargetAddrEntry 6 }
  2166.  
  2167.    snmpTargetAddrParams OBJECT-TYPE
  2168.        SYNTAX      SnmpAdminString (SIZE(1..32))
  2169.        MAX-ACCESS  read-create
  2170.        STATUS      current
  2171.        DESCRIPTION
  2172.            "The value of this object identifies an entry in the
  2173.             snmpTargetParamsTable.  The identified entry
  2174.             contains SNMP parameters to be used when generating
  2175.             messages to be sent to this transport address."
  2176.        ::= { snmpTargetAddrEntry 7 }
  2177.  
  2178.    snmpTargetAddrStorageType OBJECT-TYPE
  2179.        SYNTAX      StorageType
  2180.        MAX-ACCESS  read-create
  2181.        STATUS      current
  2182.        DESCRIPTION
  2183.            "The storage type for this conceptual row."
  2184.        ::= { snmpTargetAddrEntry 8 }
  2185.  
  2186.    snmpTargetAddrRowStatus OBJECT-TYPE
  2187.        SYNTAX      RowStatus
  2188.        MAX-ACCESS  read-create
  2189.        STATUS      current
  2190.        DESCRIPTION
  2191.            "The status of this conceptual row.
  2192.  
  2193.             To create a row in this table, a manager must
  2194.             set this object to either createAndGo(4) or
  2195.             createAndWait(5).
  2196.  
  2197.             Until instances of all corresponding columns are
  2198.             appropriately configured, the value of the
  2199.             corresponding instance of the snmpTargetAddrRowStatus
  2200.             column is 'notReady'.
  2201.  
  2202.             In particular, a newly created row cannot be made
  2203.             active until the corresponding snmpTargetAddrTDomain
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209. Expires April 1998                                       [Page 39]
  2210.  
  2211. Draft                     SNMPv3 Applications               October 1997
  2212.  
  2213.  
  2214.             and snmpTargetAddrTAddress have both been set.
  2215.  
  2216.             The following objects may not be modified while the
  2217.             value of this object is active(1):
  2218.                 - snmpTargetAddrTDomain
  2219.                 - snmpTargetAddrTAddress"
  2220.        ::= { snmpTargetAddrEntry 9 }
  2221.  
  2222.    snmpTargetParamsTable OBJECT-TYPE
  2223.        SYNTAX      SEQUENCE OF SnmpTargetParamsEntry
  2224.        MAX-ACCESS  not-accessible
  2225.        STATUS      current
  2226.        DESCRIPTION
  2227.            "A table of SNMP target information to be used
  2228.             in the generation of SNMP messages."
  2229.        ::= { snmpTargetObjects 3 }
  2230.  
  2231.    snmpTargetParamsEntry OBJECT-TYPE
  2232.        SYNTAX      SnmpTargetParamsEntry
  2233.        MAX-ACCESS  not-accessible
  2234.        STATUS      current
  2235.        DESCRIPTION
  2236.            "A set of SNMP target information.
  2237.  
  2238.             Entries in the snmpTargetParamsTable are created and
  2239.             deleted using the snmpTargetParamsRowStatus object."
  2240.        INDEX { IMPLIED snmpTargetParamsName }
  2241.        ::= { snmpTargetParamsTable 1 }
  2242.  
  2243.    SnmpTargetParamsEntry ::= SEQUENCE {
  2244.        snmpTargetParamsName           SnmpAdminString,
  2245.        snmpTargetParamsMPModel        SnmpMessageProcessingModel,
  2246.        snmpTargetParamsSecurityModel  SnmpSecurityModel,
  2247.        snmpTargetParamsSecurityName   SnmpAdminString,
  2248.        snmpTargetParamsSecurityLevel  SnmpSecurityLevel,
  2249.        snmpTargetParamsStorageType    StorageType,
  2250.        snmpTargetParamsRowStatus      RowStatus
  2251.    }
  2252.  
  2253.    snmpTargetParamsName OBJECT-TYPE
  2254.        SYNTAX      SnmpAdminString (SIZE(1..32))
  2255.        MAX-ACCESS  not-accessible
  2256.        STATUS      current
  2257.        DESCRIPTION
  2258.            "The locally arbitrary, but unique identifier associated
  2259.             with this snmpTargetParamsEntry."
  2260.        ::= { snmpTargetParamsEntry 1 }
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266. Expires April 1998                                       [Page 40]
  2267.  
  2268. Draft                     SNMPv3 Applications               October 1997
  2269.  
  2270.  
  2271.    snmpTargetParamsMPModel OBJECT-TYPE
  2272.        SYNTAX      SnmpMessageProcessingModel
  2273.        MAX-ACCESS  read-create
  2274.        STATUS      current
  2275.        DESCRIPTION
  2276.            "The Message Processing Model to be used when generating
  2277.             SNMP messages using this entry."
  2278.        ::= { snmpTargetParamsEntry 2 }
  2279.  
  2280.    snmpTargetParamsSecurityModel OBJECT-TYPE
  2281.        SYNTAX      SnmpSecurityModel (0..254 | 256..2147483647)
  2282.        MAX-ACCESS  read-create
  2283.        STATUS      current
  2284.        DESCRIPTION
  2285.            "The Security Model to be used when generating SNMP
  2286.              messages using this entry."
  2287.        ::= { snmpTargetParamsEntry 3 }
  2288.  
  2289.    snmpTargetParamsSecurityName OBJECT-TYPE
  2290.        SYNTAX      SnmpAdminString
  2291.        MAX-ACCESS  read-create
  2292.        STATUS      current
  2293.        DESCRIPTION
  2294.            "The securityName which identifies the Principal on
  2295.             whose behalf SNMP messages will be generated using
  2296.             this entry."
  2297.        ::= { snmpTargetParamsEntry 4 }
  2298.  
  2299.    snmpTargetParamsSecurityLevel OBJECT-TYPE
  2300.        SYNTAX      SnmpSecurityLevel
  2301.        MAX-ACCESS  read-create
  2302.        STATUS      current
  2303.        DESCRIPTION
  2304.            "The Level of Security to be used when generating
  2305.             SNMP messages using this entry."
  2306.        ::= { snmpTargetParamsEntry 5 }
  2307.  
  2308.    snmpTargetParamsStorageType OBJECT-TYPE
  2309.        SYNTAX      StorageType
  2310.        MAX-ACCESS  read-create
  2311.        STATUS      current
  2312.        DESCRIPTION
  2313.            "The storage type for this conceptual row."
  2314.        ::= { snmpTargetParamsEntry 6 }
  2315.  
  2316.    snmpTargetParamsRowStatus OBJECT-TYPE
  2317.        SYNTAX      RowStatus
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323. Expires April 1998                                       [Page 41]
  2324.  
  2325. Draft                     SNMPv3 Applications               October 1997
  2326.  
  2327.  
  2328.        MAX-ACCESS  read-create
  2329.        STATUS      current
  2330.        DESCRIPTION
  2331.            "The status of this conceptual row.
  2332.  
  2333.             To create a row in this table, a manager must
  2334.             set this object to either createAndGo(4) or
  2335.             createAndWait(5).
  2336.  
  2337.             Until instances of all corresponding columns are
  2338.             appropriately configured, the value of the
  2339.             corresponding instance of the snmpTargetParamsRowStatus
  2340.             column is 'notReady'.
  2341.  
  2342.             In particular, a newly created row cannot be made
  2343.             active until the corresponding
  2344.             snmpTargetParamsMPModel,
  2345.             snmpTargetParamsSecurityModel,
  2346.             snmpTargetParamsSecurityName,
  2347.             and snmpTargetParamsSecurityLevel have all been set.
  2348.  
  2349.             The following objects may not be modified while the
  2350.             value of this object is active(1):
  2351.                 - snmpTargetParamsMPModel
  2352.                 - snmpTargetParamsSecurityModel
  2353.                 - snmpTargetParamsSecurityName
  2354.                 - snmpTargetParamsSecurityLevel"
  2355.        ::= { snmpTargetParamsEntry 7 }
  2356.  
  2357.    snmpUnavailableContexts OBJECT-TYPE
  2358.        SYNTAX       Counter32
  2359.        MAX-ACCESS   read-only
  2360.        STATUS       current
  2361.        DESCRIPTION
  2362.            "The total number of packets received by the SNMP
  2363.             engine which were dropped because the context
  2364.             contained in the mesage was unavailable."
  2365.        ::= { snmpTargetObjects 4 }
  2366.  
  2367.    snmpUnknownContexts OBJECT-TYPE
  2368.        SYNTAX       Counter32
  2369.        MAX-ACCESS   read-only
  2370.        STATUS       current
  2371.        DESCRIPTION
  2372.            "The total number of packets received by the SNMP
  2373.             engine which were dropped because the context
  2374.             contained in the mesage was unknown."
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380. Expires April 1998                                       [Page 42]
  2381.  
  2382. Draft                     SNMPv3 Applications               October 1997
  2383.  
  2384.  
  2385.        ::= { snmpTargetObjects 5 }
  2386.  
  2387.    --
  2388.    --
  2389.    -- Conformance information
  2390.    --
  2391.    --
  2392.  
  2393.    snmpTargetCompliances OBJECT IDENTIFIER ::=
  2394.                                            { snmpTargetConformance 1 }
  2395.    snmpTargetGroups      OBJECT IDENTIFIER ::=
  2396.                                            { snmpTargetConformance 2 }
  2397.  
  2398.    --
  2399.    --
  2400.    -- Compliance statements
  2401.    --
  2402.    --
  2403.  
  2404.  
  2405.    snmpTargetCommandResponderCompliance MODULE-COMPLIANCE
  2406.        STATUS      current
  2407.        DESCRIPTION
  2408.            "The compliance statement for SNMP entities which include
  2409.             a command responder application."
  2410.        MODULE -- This Module
  2411.            MANDATORY-GROUPS { snmpTargetCommandResponderGroup }
  2412.        ::= { snmpTargetCompliances 1 }
  2413.  
  2414.    snmpTargetBasicGroup OBJECT-GROUP
  2415.        OBJECTS {
  2416.            snmpTargetSpinLock,
  2417.            snmpTargetAddrTDomain,
  2418.            snmpTargetAddrTAddress,
  2419.            snmpTargetAddrTagList,
  2420.            snmpTargetAddrParams,
  2421.            snmpTargetAddrStorageType,
  2422.            snmpTargetAddrRowStatus,
  2423.            snmpTargetParamsMPModel,
  2424.            snmpTargetParamsSecurityModel,
  2425.            snmpTargetParamsSecurityName,
  2426.            snmpTargetParamsSecurityLevel,
  2427.            snmpTargetParamsStorageType,
  2428.            snmpTargetParamsRowStatus
  2429.        }
  2430.        STATUS      current
  2431.        DESCRIPTION
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437. Expires April 1998                                       [Page 43]
  2438.  
  2439. Draft                     SNMPv3 Applications               October 1997
  2440.  
  2441.  
  2442.            "A collection of objects providing basic remote
  2443.             configuration of management targets."
  2444.        ::= { snmpTargetGroups 1 }
  2445.  
  2446.    snmpTargetResponseGroup OBJECT-GROUP
  2447.        OBJECTS {
  2448.            snmpTargetAddrTimeout,
  2449.            snmpTargetAddrRetryCount
  2450.        }
  2451.        STATUS      current
  2452.        DESCRIPTION
  2453.            "A collection of objects providing remote configuration
  2454.             of management targets for applications which generate
  2455.             SNMP messages for which a response message would be
  2456.             expected."
  2457.        ::= { snmpTargetGroups 2 }
  2458.  
  2459.    snmpTargetCommandResponderGroup OBJECT-GROUP
  2460.        OBJECTS {
  2461.            snmpUnavailableContexts,
  2462.            snmpUnknownContexts
  2463.        }
  2464.        STATUS      current
  2465.        DESCRIPTION
  2466.            "A collection of objects required for command responder
  2467.             applications, used for counting error conditions."
  2468.        ::= { snmpTargetGroups 3 }
  2469.  
  2470.    END
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493. Expires April 1998                                       [Page 44]
  2494.  
  2495. Draft                     SNMPv3 Applications               October 1997
  2496.  
  2497.  
  2498. 5.2.  The Notification MIB Module
  2499.  
  2500.    The SNMP-NOTIFICATION-MIB module contains objects for the remote
  2501.    configuration of the parameters used by an SNMP entity for the
  2502.    generation of notifications.  It consists of three tables and
  2503.    conformance/compliance statements.  The first table, the
  2504.    snmpNotifyTable, contains entries which select which entries in the
  2505.    snmpTargetAddrTable should be used for generating notifications, and
  2506.    the type of notifications to be generated.
  2507.  
  2508.    The second table sparsely augments the snmpTargetAddrTable with an
  2509.    object which is used to associate a set of filters with a particular
  2510.    management target.
  2511.  
  2512.    The third table defines filters which are used to limit the number of
  2513.    notifications which are generated using particular management
  2514.    targets.
  2515.  
  2516.  
  2517. 5.2.1.  Definitions
  2518.  
  2519.    SNMP-NOTIFICATION-MIB DEFINITIONS ::= BEGIN
  2520.  
  2521.    IMPORTS
  2522.        MODULE-IDENTITY,
  2523.        OBJECT-TYPE,
  2524.        snmpModules
  2525.            FROM SNMPv2-SMI
  2526.  
  2527.        RowStatus,
  2528.        StorageType
  2529.            FROM SNMPv2-TC
  2530.  
  2531.        SnmpAdminString
  2532.            FROM SNMP-FRAMEWORK-MIB
  2533.  
  2534.        SnmpTagValue,
  2535.        snmpTargetParamsName
  2536.            FROM SNMP-TARGET-MIB
  2537.  
  2538.        MODULE-COMPLIANCE,
  2539.        OBJECT-GROUP
  2540.            FROM SNMPv2-CONF;
  2541.  
  2542.    snmpNotificationMIB MODULE-IDENTITY
  2543.        LAST-UPDATED "9707140000Z"
  2544.        ORGANIZATION "IETF SNMPv3 Working Group"
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550. Expires April 1998                                       [Page 45]
  2551.  
  2552. Draft                     SNMPv3 Applications               October 1997
  2553.  
  2554.  
  2555.        CONTACT-INFO
  2556.            "WG-email:   snmpv3@tis.com
  2557.             Subscribe:  majordomo@tis.com
  2558.                         In message body:  subscribe snmpv3
  2559.  
  2560.             Chair:      Russ Mundy
  2561.                         Trusted Information Systems
  2562.             Postal:     3060 Washington Rd
  2563.                         Glenwood MD 21738
  2564.                         USA
  2565.             Email:      mundy@tis.com
  2566.             Phone:      +1-301-854-6889
  2567.  
  2568.             Co-editor:  David B. Levi
  2569.                         SNMP Research, Inc.
  2570.             Postal:     3001 Kimberlin Heights Road
  2571.                         Knoxville, TN 37920-9716
  2572.             E-mail:     levi@snmp.com
  2573.             Phone:      +1 423 573 1434
  2574.  
  2575.             Co-editor:  Paul Meyer
  2576.                         Secure Computing Corporation
  2577.             Postal:     2675 Long Lake Road
  2578.                         Roseville, MN 55113
  2579.             E-mail:     paul_meyer@securecomputing.com
  2580.             Phone:      +1 612 628 1592
  2581.  
  2582.             Co-editor:  Bob Stewart
  2583.                         Cisco Systems, Inc.
  2584.             Postal:     170 West Tasman Drive
  2585.                         San Jose, CA 95134-1706
  2586.             E-mail:     bstewart@cisco.com
  2587.             Phone:      +1 603 654 6923"
  2588.        DESCRIPTION
  2589.            "This MIB module defines MIB objects which provide
  2590.             mechanisms to remotely configure the parameters
  2591.             used by an SNMP entity for the generation of
  2592.             notifications."
  2593.        REVISION    "9707140000Z"
  2594.        DESCRIPTION
  2595.            "The initial revision."
  2596.        ::= { snmpModules 12 }      -- TBD
  2597.  
  2598.    snmpNotifyObjects       OBJECT IDENTIFIER ::=
  2599.                                              { snmpNotificationMIB 1 }
  2600.    snmpNotifyConformance   OBJECT IDENTIFIER ::=
  2601.                                              { snmpNotificationMIB 3 }
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607. Expires April 1998                                       [Page 46]
  2608.  
  2609. Draft                     SNMPv3 Applications               October 1997
  2610.  
  2611.  
  2612.    --
  2613.    --
  2614.    -- The snmpNotifyObjects group
  2615.    --
  2616.    --
  2617.  
  2618.    snmpNotifyTable OBJECT-TYPE
  2619.        SYNTAX      SEQUENCE OF SnmpNotifyEntry
  2620.        MAX-ACCESS  not-accessible
  2621.        STATUS      current
  2622.        DESCRIPTION
  2623.            "This table is used to select management targets which should
  2624.             receive notifications, as well as the type of notification
  2625.             which should be sent to each selected management target."
  2626.        ::= { snmpNotifyObjects 1 }
  2627.  
  2628.    snmpNotifyEntry OBJECT-TYPE
  2629.        SYNTAX      SnmpNotifyEntry
  2630.        MAX-ACCESS  not-accessible
  2631.        STATUS      current
  2632.        DESCRIPTION
  2633.            "An entry in this table selects a set of management targets
  2634.             which should receive notifications, as well as the type of
  2635.             notification which should be sent to each selected
  2636.             management target.
  2637.  
  2638.             Entries in the snmpNotifyTable are created and
  2639.             deleted using the snmpNotifyRowStatus object."
  2640.        INDEX { IMPLIED snmpNotifyName }
  2641.        ::= { snmpNotifyTable 1 }
  2642.  
  2643.    SnmpNotifyEntry ::= SEQUENCE {
  2644.        snmpNotifyName         SnmpAdminString,
  2645.        snmpNotifyTag          SnmpTagValue,
  2646.        snmpNotifyType         INTEGER,
  2647.        snmpNotifyStorageType  StorageType,
  2648.        snmpNotifyRowStatus    RowStatus
  2649.    }
  2650.  
  2651.    snmpNotifyName OBJECT-TYPE
  2652.        SYNTAX      SnmpAdminString (SIZE(1..32))
  2653.        MAX-ACCESS  not-accessible
  2654.        STATUS      current
  2655.        DESCRIPTION
  2656.            "The locally arbitrary, but unique identifier associated
  2657.             with this snmpNotifyEntry."
  2658.        ::= { snmpNotifyEntry 1 }
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664. Expires April 1998                                       [Page 47]
  2665.  
  2666. Draft                     SNMPv3 Applications               October 1997
  2667.  
  2668.  
  2669.    snmpNotifyTag OBJECT-TYPE
  2670.        SYNTAX      SnmpTagValue
  2671.        MAX-ACCESS  read-create
  2672.        STATUS      current
  2673.        DESCRIPTION
  2674.            "This object contains a single tag value which is used
  2675.             to select entries in the snmpTargetAddrTable.  Any entry
  2676.             in the snmpTargetAddrTable which contains a tag value
  2677.             which is equal to the value of an instance of this
  2678.             object is selected.  If this object contains a value
  2679.             of zero length, no entries are selected."
  2680.        ::= { snmpNotifyEntry 2 }
  2681.  
  2682.    snmpNotifyType OBJECT-TYPE
  2683.        SYNTAX      INTEGER {
  2684.                        trap(1),
  2685.                        inform(2)
  2686.                    }
  2687.        MAX-ACCESS  read-create
  2688.        STATUS      current
  2689.        DESCRIPTION
  2690.            "This object determines the type of notification to
  2691.             be generated for entries in the snmpTargetAddrTable
  2692.             selected by the corresponding instance of
  2693.             snmpNotifyTag.
  2694.  
  2695.             If the value of this object is trap(1), then any
  2696.             messages generated for selected rows will contain
  2697.             SNMPv2-Trap PDUs.
  2698.  
  2699.             If the value of this object is inform(2), then any
  2700.             messages generated for selected rows will contain
  2701.             Inform PDUs.
  2702.  
  2703.             Note that if an SNMP entity only supports
  2704.             generation of traps (and not informs), then this
  2705.             object may be read-only."
  2706.        DEFVAL { trap }
  2707.        ::= { snmpNotifyEntry 3 }
  2708.  
  2709.    snmpNotifyStorageType OBJECT-TYPE
  2710.        SYNTAX      StorageType
  2711.        MAX-ACCESS  read-create
  2712.        STATUS      current
  2713.        DESCRIPTION
  2714.            "The storage type for this conceptual row."
  2715.        ::= { snmpNotifyEntry 4 }
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721. Expires April 1998                                       [Page 48]
  2722.  
  2723. Draft                     SNMPv3 Applications               October 1997
  2724.  
  2725.  
  2726.    snmpNotifyRowStatus OBJECT-TYPE
  2727.        SYNTAX      RowStatus
  2728.        MAX-ACCESS  read-create
  2729.        STATUS      current
  2730.        DESCRIPTION
  2731.            "The status of this conceptual row.
  2732.  
  2733.             To create a row in this table, a manager must
  2734.             set this object to either createAndGo(4) or
  2735.             createAndWait(5).
  2736.  
  2737.             Until instances of all corresponding columns are
  2738.             appropriately configured, the value of the
  2739.             corresponding instance of the snmpNotifyRowStatus
  2740.             column is 'notReady'.
  2741.  
  2742.             In particular, a newly created row cannot be made
  2743.             active until the corresponding snmpNotifyTag has
  2744.             been set."
  2745.        ::= { snmpNotifyEntry 5 }
  2746.  
  2747.    snmpNotifyFilterProfileTable OBJECT-TYPE
  2748.        SYNTAX      SEQUENCE OF SnmpNotifyFilterProfileEntry
  2749.        MAX-ACCESS  not-accessible
  2750.        STATUS      current
  2751.        DESCRIPTION
  2752.            "This table is used to associate a notification filter
  2753.             profile with a particular set of target parameters."
  2754.        ::= { snmpNotifyObjects 2 }
  2755.  
  2756.    snmpNotifyFilterProfileEntry OBJECT-TYPE
  2757.        SYNTAX      SnmpNotifyFilterProfileEntry
  2758.        MAX-ACCESS  not-accessible
  2759.        STATUS      current
  2760.        DESCRIPTION
  2761.            "An entry in this table indicates the name of the filter
  2762.             profile to be used when generating notifications using
  2763.             the corresponding entry in the snmpTargetParamsTable.
  2764.  
  2765.             Entries in the snmpNotifyFilterProfileTable are created
  2766.             and deleted using the snmpNotifyFilterProfileRowStatus
  2767.             object."
  2768.        INDEX { IMPLIED snmpTargetParamsName }
  2769.        ::= { snmpNotifyFilterProfileTable 1 }
  2770.  
  2771.    SnmpNotifyFilterProfileEntry ::= SEQUENCE {
  2772.        snmpNotifyFilterProfileName         SnmpAdminString,
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778. Expires April 1998                                       [Page 49]
  2779.  
  2780. Draft                     SNMPv3 Applications               October 1997
  2781.  
  2782.  
  2783.        snmpNotifyFilterProfileStorType     StorageType,
  2784.        snmpNotifyFilterProfileRowStatus    RowStatus
  2785.    }
  2786.  
  2787.    snmpNotifyFilterProfileName OBJECT-TYPE
  2788.        SYNTAX      SnmpAdminString (SIZE(1..32))
  2789.        MAX-ACCESS  read-create
  2790.        STATUS      current
  2791.        DESCRIPTION
  2792.            "The name of the filter profile to be used when generating
  2793.             notifications using the corresponding entry in the
  2794.             snmpTargetAddrTable."
  2795.        ::= { snmpNotifyFilterProfileEntry 1 }
  2796.  
  2797.    snmpNotifyFilterProfileStorType OBJECT-TYPE
  2798.        SYNTAX      StorageType
  2799.        MAX-ACCESS  read-create
  2800.        STATUS      current
  2801.        DESCRIPTION
  2802.            "The storage type of this conceptual row."
  2803.        ::= { snmpNotifyFilterProfileEntry 2 }
  2804.  
  2805.    snmpNotifyFilterProfileRowStatus OBJECT-TYPE
  2806.        SYNTAX      RowStatus
  2807.        MAX-ACCESS  read-create
  2808.        STATUS      current
  2809.        DESCRIPTION
  2810.            "The status of this conceptual row.
  2811.  
  2812.             To create a row in this table, a manager must
  2813.             set this object to either createAndGo(4) or
  2814.             createAndWait(5)."
  2815.        ::= { snmpNotifyFilterProfileEntry 3 }
  2816.  
  2817.    snmpNotifyFilterTable OBJECT-TYPE
  2818.        SYNTAX      SEQUENCE OF SnmpNotifyFilterEntry
  2819.        MAX-ACCESS  not-accessible
  2820.        STATUS      current
  2821.        DESCRIPTION
  2822.            "The table of filter profiles.  Filter profiles are used
  2823.             to determine whether particular management targets should
  2824.             receive particular notifications.
  2825.  
  2826.             When a notification is generated, it must be compared
  2827.             with the filters associated with each management target
  2828.             which is configured to receive notifications.  If the
  2829.             notification is matched by a filter, it is not sent to
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835. Expires April 1998                                       [Page 50]
  2836.  
  2837. Draft                     SNMPv3 Applications               October 1997
  2838.  
  2839.  
  2840.             the management target with which the filter is
  2841.             associated."
  2842.        ::= { snmpNotifyObjects 3 }
  2843.  
  2844.    snmpNotifyFilterEntry OBJECT-TYPE
  2845.        SYNTAX      SnmpNotifyFilterEntry
  2846.        MAX-ACCESS  not-accessible
  2847.        STATUS      current
  2848.        DESCRIPTION
  2849.            "An element of a filter profile.
  2850.  
  2851.             Entries in the snmpNotifyFilterTable are created and
  2852.             deleted using the snmpNotifyFilterRowStatus object."
  2853.        INDEX {         snmpNotifyFilterProfileName,
  2854.                IMPLIED snmpNotifyFilterSubtree }
  2855.        ::= { snmpNotifyFilterTable 1 }
  2856.  
  2857.    SnmpNotifyFilterEntry ::= SEQUENCE {
  2858.        snmpNotifyFilterSubtree           OBJECT IDENTIFIER,
  2859.        snmpNotifyFilterMask              OCTET STRING,
  2860.        snmpNotifyFilterType              INTEGER,
  2861.        snmpNotifyFilterStorageType       StorageType,
  2862.        snmpNotifyFilterRowStatus         RowStatus
  2863.    }
  2864.  
  2865.    snmpNotifyFilterSubtree OBJECT-TYPE
  2866.        SYNTAX      OBJECT IDENTIFIER
  2867.        MAX-ACCESS  not-accessible
  2868.        STATUS      current
  2869.        DESCRIPTION
  2870.            "The MIB subtree which, when combined with the corresponding
  2871.             instance of snmpNotifyFilterMask, defines a family of
  2872.             subtrees which are included in or excluded from the
  2873.             filter profile."
  2874.        ::= { snmpNotifyFilterEntry 1 }
  2875.  
  2876.    snmpNotifyFilterMask OBJECT-TYPE
  2877.        SYNTAX      OCTET STRING (SIZE(0..16))
  2878.        MAX-ACCESS  read-create
  2879.        STATUS      current
  2880.        DESCRIPTION
  2881.            "The bit mask which, in combination with the corresponding
  2882.             instance of snmpNotifyFilterSubtree, defines a family of
  2883.             subtrees which are included in or excluded from the
  2884.             filter profile.
  2885.  
  2886.             Each bit of this bit mask corresponds to a
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892. Expires April 1998                                       [Page 51]
  2893.  
  2894. Draft                     SNMPv3 Applications               October 1997
  2895.  
  2896.  
  2897.             sub-identifier of snmpNotifyFilterSubtree, with the
  2898.             most significant bit of the i-th octet of this octet
  2899.             string value (extended if necessary, see below)
  2900.             corresponding to the (8*i - 7)-th sub-identifier, and
  2901.             the least significant bit of the i-th octet of this
  2902.             octet string corresponding to the (8*i)-th
  2903.             sub-identifier, where i is in the range 1 through 16.
  2904.  
  2905.             Each bit of this bit mask specifies whether or not
  2906.             the corresponding sub-identifiers must match when
  2907.             determining if an OBJECT IDENTIFIER matches this
  2908.             family of filter subtrees; a '1' indicates that an
  2909.             exact match must occur; a '0' indicates 'wild card',
  2910.             i.e., any sub-identifier value matches.
  2911.  
  2912.             Thus, the OBJECT IDENTIFIER X of an object instance
  2913.             is contained in a family of filter subtrees if, for
  2914.             each sub-identifier of the value of
  2915.             snmpNotifyFilterSubtree, either:
  2916.  
  2917.               the i-th bit of snmpNotifyFilterMask is 0, or
  2918.  
  2919.               the i-th sub-identifier of X is equal to the i-th
  2920.               sub-identifier of the value of
  2921.               snmpNotifyFilterSubtree.
  2922.  
  2923.             If the value of this bit mask is M bits long and
  2924.             there are more than M sub-identifiers in the
  2925.             corresponding instance of snmpNotifyFilterSubtree,
  2926.             then the bit mask is extended with 1's to be the
  2927.             required length.
  2928.  
  2929.             Note that when the value of this object is the
  2930.             zero-length string, this extension rule results in
  2931.             a mask of all-1's being used (i.e., no 'wild card'),
  2932.             and the family of filter subtrees is the one
  2933.             subtree uniquely identified by the corresponding
  2934.             instance of snmpNotifyFilterSubtree."
  2935.        DEFVAL { ''H }
  2936.        ::= { snmpNotifyFilterEntry 2 }
  2937.  
  2938.    snmpNotifyFilterType OBJECT-TYPE
  2939.        SYNTAX      INTEGER {
  2940.                        included(1),
  2941.                        excluded(2)
  2942.                    }
  2943.        MAX-ACCESS  read-create
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949. Expires April 1998                                       [Page 52]
  2950.  
  2951. Draft                     SNMPv3 Applications               October 1997
  2952.  
  2953.  
  2954.        STATUS      current
  2955.        DESCRIPTION
  2956.            "This object indicates whether the family of filter subtrees
  2957.             defined by this entry are included in or excluded from a
  2958.             filter."
  2959.        DEFVAL { included }
  2960.        ::= { snmpNotifyFilterEntry 3 }
  2961.  
  2962.    snmpNotifyFilterStorageType OBJECT-TYPE
  2963.        SYNTAX      StorageType
  2964.        MAX-ACCESS  read-create
  2965.        STATUS      current
  2966.        DESCRIPTION
  2967.            "The storage type of this conceptual row."
  2968.        ::= { snmpNotifyFilterEntry 4 }
  2969.  
  2970.    snmpNotifyFilterRowStatus OBJECT-TYPE
  2971.        SYNTAX      RowStatus
  2972.        MAX-ACCESS  read-create
  2973.        STATUS      current
  2974.        DESCRIPTION
  2975.            "The status of this conceptual row.
  2976.  
  2977.             To create a row in this table, a manager must
  2978.             set this object to either createAndGo(4) or
  2979.             createAndWait(5)."
  2980.        ::= { snmpNotifyFilterEntry 5 }
  2981.  
  2982.    --
  2983.    --
  2984.    -- Conformance information
  2985.    --
  2986.    --
  2987.  
  2988.    snmpNotifyCompliances OBJECT IDENTIFIER ::=
  2989.                                            { snmpNotifyConformance 1 }
  2990.    snmpNotifyGroups      OBJECT IDENTIFIER ::=
  2991.                                            { snmpNotifyConformance 2 }
  2992.  
  2993.    --
  2994.    --
  2995.    -- Compliance statements
  2996.    --
  2997.    --
  2998.  
  2999.    snmpNotifyBasicCompliance MODULE-COMPLIANCE
  3000.        STATUS      current
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006. Expires April 1998                                       [Page 53]
  3007.  
  3008. Draft                     SNMPv3 Applications               October 1997
  3009.  
  3010.  
  3011.        DESCRIPTION
  3012.            "The compliance statement for minimal SNMP entities which
  3013.             implement only SNMP Traps and read-create operations on
  3014.             only the snmpTargetAddrTable."
  3015.        MODULE SNMP-TARGET-MIB
  3016.            MANDATORY-GROUPS { snmpTargetBasicGroup }
  3017.  
  3018.            OBJECT snmpTargetParamsMPModel
  3019.            MIN-ACCESS    read-only
  3020.            DESCRIPTION
  3021.                "Create/delete/modify access is not required."
  3022.  
  3023.            OBJECT snmpTargetParamsSecurityModel
  3024.            MIN-ACCESS    read-only
  3025.            DESCRIPTION
  3026.                "Create/delete/modify access is not required."
  3027.  
  3028.            OBJECT snmpTargetParamsSecurityName
  3029.            MIN-ACCESS    read-only
  3030.            DESCRIPTION
  3031.                "Create/delete/modify access is not required."
  3032.  
  3033.            OBJECT snmpTargetParamsSecurityLevel
  3034.            MIN-ACCESS    read-only
  3035.            DESCRIPTION
  3036.                "Create/delete/modify access is not required."
  3037.  
  3038.            OBJECT snmpTargetParamsStorageType
  3039.            SYNTAX INTEGER {
  3040.                readOnly(5)
  3041.            }
  3042.            MIN-ACCESS    read-only
  3043.            DESCRIPTION
  3044.                "Create/delete/modify access is not required.
  3045.                 Support of the values other(1), volatile(2),
  3046.                 nonVolatile(3), and permanent(4) is not required."
  3047.  
  3048.            OBJECT snmpTargetParamsRowStatus
  3049.            SYNTAX INTEGER {
  3050.                active(1)
  3051.            }
  3052.            MIN-ACCESS    read-only
  3053.            DESCRIPTION
  3054.                "Create/delete/modify access to the
  3055.                 snmpTargetParamsTable is not required.
  3056.                 Support of the values notInService(2), notReady(3),
  3057.                 createAndGo(4), createAndWait(5), and destroy(6) is
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063. Expires April 1998                                       [Page 54]
  3064.  
  3065. Draft                     SNMPv3 Applications               October 1997
  3066.  
  3067.  
  3068.                 not required."
  3069.  
  3070.        MODULE -- This Module
  3071.            MANDATORY-GROUPS { snmpNotifyGroup }
  3072.  
  3073.            OBJECT snmpNotifyTag
  3074.            MIN-ACCESS    read-only
  3075.            DESCRIPTION
  3076.                "Create/delete/modify access is not required."
  3077.  
  3078.            OBJECT snmpNotifyType
  3079.            SYNTAX INTEGER {
  3080.                trap(1)
  3081.            }
  3082.            MIN-ACCESS    read-only
  3083.            DESCRIPTION
  3084.                "Create/delete/modify access is not required.
  3085.                 Support of the value notify(2) is not required."
  3086.  
  3087.            OBJECT snmpNotifyStorageType
  3088.            SYNTAX INTEGER {
  3089.                readOnly(5)
  3090.            }
  3091.            MIN-ACCESS    read-only
  3092.            DESCRIPTION
  3093.                "Create/delete/modify access is not required.
  3094.                 Support of the values other(1), volatile(2),
  3095.                 nonVolatile(3), and permanent(4) is not required."
  3096.  
  3097.            OBJECT snmpNotifyRowStatus
  3098.            SYNTAX INTEGER {
  3099.                active(1)
  3100.            }
  3101.            MIN-ACCESS    read-only
  3102.            DESCRIPTION
  3103.                "Create/delete/modify access to the
  3104.                 snmpNotifyTable is not required.
  3105.                 Support of the values notInService(2), notReady(3),
  3106.                 createAndGo(4), createAndWait(5), and destroy(6) is
  3107.                 not required."
  3108.  
  3109.        ::= { snmpNotifyCompliances 1 }
  3110.  
  3111.    snmpNotifyBasicFiltersCompliance MODULE-COMPLIANCE
  3112.        STATUS      current
  3113.        DESCRIPTION
  3114.            "The compliance statement for SNMP entities which implement
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120. Expires April 1998                                       [Page 55]
  3121.  
  3122. Draft                     SNMPv3 Applications               October 1997
  3123.  
  3124.  
  3125.             SNMP Traps with filtering, and read-create operations on
  3126.             all related tables."
  3127.        MODULE SNMP-TARGET-MIB
  3128.            MANDATORY-GROUPS { snmpTargetBasicGroup }
  3129.        MODULE -- This Module
  3130.            MANDATORY-GROUPS { snmpNotifyGroup,
  3131.                               snmpNotifyFilterGroup }
  3132.        ::= { snmpNotifyCompliances 2 }
  3133.  
  3134.    snmpNotifyFullCompliance MODULE-COMPLIANCE
  3135.        STATUS      current
  3136.        DESCRIPTION
  3137.            "The compliance statement for SNMP entities which either
  3138.             implement only SNMP Informs, or both SNMP Traps and SNMP
  3139.             Informs, plus filtering and read-create operations on
  3140.             all related tables."
  3141.        MODULE SNMP-TARGET-MIB
  3142.            MANDATORY-GROUPS { snmpTargetBasicGroup,
  3143.                               snmpTargetResponseGroup }
  3144.        MODULE -- This Module
  3145.            MANDATORY-GROUPS { snmpNotifyGroup,
  3146.                               snmpNotifyFilterGroup }
  3147.        ::= { snmpNotifyCompliances 3 }
  3148.  
  3149.    snmpNotifyGroup OBJECT-GROUP
  3150.        OBJECTS {
  3151.            snmpNotifyTag,
  3152.            snmpNotifyType,
  3153.            snmpNotifyStorageType,
  3154.            snmpNotifyRowStatus
  3155.        }
  3156.        STATUS      current
  3157.        DESCRIPTION
  3158.            "A collection of objects for selecting which management
  3159.             targets are used for generating notifications, and the
  3160.             type of notification to be generated for each selected
  3161.             management target."
  3162.        ::= { snmpNotifyGroups 1 }
  3163.  
  3164.    snmpNotifyFilterGroup OBJECT-GROUP
  3165.        OBJECTS {
  3166.            snmpNotifyFilterProfileName,
  3167.            snmpNotifyFilterProfileStorType,
  3168.            snmpNotifyFilterProfileRowStatus,
  3169.            snmpNotifyFilterMask,
  3170.            snmpNotifyFilterType,
  3171.            snmpNotifyFilterStorageType,
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177. Expires April 1998                                       [Page 56]
  3178.  
  3179. Draft                     SNMPv3 Applications               October 1997
  3180.  
  3181.  
  3182.            snmpNotifyFilterRowStatus
  3183.        }
  3184.        STATUS      current
  3185.        DESCRIPTION
  3186.            "A collection of objects providing remote configuration
  3187.             of notification filters."
  3188.        ::= { snmpNotifyGroups 2 }
  3189.  
  3190.    END
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233. Expires April 1998                                       [Page 57]
  3234.  
  3235. Draft                     SNMPv3 Applications               October 1997
  3236.  
  3237.  
  3238. 5.3.  The Proxy MIB Module
  3239.  
  3240.    The SNMP-PROXY-MIB module, which defines MIB objects that provide
  3241.    mechanisms to remotely configure the parameters used by an SNMP
  3242.    entity for proxy forwarding operations, contains a single table.
  3243.    This table, snmpProxyTable, is used to define translations between
  3244.    management targets for use when forwarding messages.
  3245.  
  3246.  
  3247. 5.3.1.  Definitions
  3248.  
  3249.    SNMP-PROXY-MIB DEFINITIONS ::= BEGIN
  3250.  
  3251.    IMPORTS
  3252.        MODULE-IDENTITY,
  3253.        OBJECT-TYPE,
  3254.        snmpModules
  3255.            FROM SNMPv2-SMI
  3256.  
  3257.        RowStatus,
  3258.        StorageType
  3259.            FROM SNMPv2-TC
  3260.  
  3261.        SnmpEngineID,
  3262.        SnmpAdminString
  3263.            FROM SNMP-FRAMEWORK-MIB
  3264.  
  3265.        SnmpTagValue,
  3266.            FROM SNMP-TARGET-MIB
  3267.  
  3268.        MODULE-COMPLIANCE,
  3269.        OBJECT-GROUP
  3270.            FROM SNMPv2-CONF;
  3271.  
  3272.    snmpProxyMIB MODULE-IDENTITY
  3273.        LAST-UPDATED "9706140000Z"
  3274.        ORGANIZATION "IETF SNMPv3 Working Group"
  3275.        CONTACT-INFO
  3276.            "WG-email:   snmpv3@tis.com
  3277.             Subscribe:  majordomo@tis.com
  3278.                         In message body:  subscribe snmpv3
  3279.  
  3280.             Chair:      Russ Mundy
  3281.                         Trusted Information Systems
  3282.             Postal:     3060 Washington Rd
  3283.                         Glenwood MD 21738
  3284.                         USA
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290. Expires April 1998                                       [Page 58]
  3291.  
  3292. Draft                     SNMPv3 Applications               October 1997
  3293.  
  3294.  
  3295.             Email:      mundy@tis.com
  3296.             Phone:      +1-301-854-6889
  3297.  
  3298.             Co-editor:  David B. Levi
  3299.                         SNMP Research, Inc.
  3300.             Postal:     3001 Kimberlin Heights Road
  3301.                         Knoxville, TN 37920-9716
  3302.             E-mail:     levi@snmp.com
  3303.             Phone:      +1 423 573 1434
  3304.  
  3305.             Co-editor:  Paul Meyer
  3306.                         Secure Computing Corporation
  3307.             Postal:     2675 Long Lake Road
  3308.                         Roseville, MN 55113
  3309.             E-mail:     paul_meyer@securecomputing.com
  3310.             Phone:      +1 612 628 1592
  3311.  
  3312.             Co-editor:  Bob Stewart
  3313.                         Cisco Systems, Inc.
  3314.             Postal:     170 West Tasman Drive
  3315.                         San Jose, CA 95134-1706
  3316.             E-mail:     bstewart@cisco.com
  3317.             Phone:      +1 603 654 6923"
  3318.        DESCRIPTION
  3319.            "This MIB module defines MIB objects which provide
  3320.             mechanisms to remotely configure the parameters
  3321.             used by a proxy forwarding application."
  3322.        REVISION    "9707140000Z"
  3323.        DESCRIPTION
  3324.            "The initial revision."
  3325.        ::= { snmpModules 13 }      -- TBD
  3326.  
  3327.    snmpProxyObjects        OBJECT IDENTIFIER ::= { snmpProxyMIB 1 }
  3328.    snmpProxyConformance    OBJECT IDENTIFIER ::= { snmpProxyMIB 3 }
  3329.  
  3330.    --
  3331.    --
  3332.    -- The snmpProxyObjects group
  3333.    --
  3334.    --
  3335.  
  3336.    snmpProxyTable OBJECT-TYPE
  3337.        SYNTAX      SEQUENCE OF SnmpProxyEntry
  3338.        MAX-ACCESS  not-accessible
  3339.        STATUS      current
  3340.        DESCRIPTION
  3341.            "The table of translation parameters used by proxy forwarder
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347. Expires April 1998                                       [Page 59]
  3348.  
  3349. Draft                     SNMPv3 Applications               October 1997
  3350.  
  3351.  
  3352.             applications for forwarding SNMP messages."
  3353.        ::= { snmpProxyObjects 2 }
  3354.  
  3355.    snmpProxyEntry OBJECT-TYPE
  3356.        SYNTAX      SnmpProxyEntry
  3357.        MAX-ACCESS  not-accessible
  3358.        STATUS      current
  3359.        DESCRIPTION
  3360.            "A set of translation parameters used by a proxy forwarder
  3361.             application for forwarding SNMP messages.
  3362.  
  3363.             Entries in the snmpProxyTable are created and deleted
  3364.             using the snmpProxyRowStatus object."
  3365.        INDEX { IMPLIED snmpProxyName }
  3366.        ::= { snmpProxyTable 1 }
  3367.  
  3368.    SnmpProxyEntry ::= SEQUENCE {
  3369.        snmpProxyName               SnmpAdminString,
  3370.        snmpProxyType               INTEGER,
  3371.        snmpProxyContextEngineID    SnmpEngineID,
  3372.        snmpProxyContextName        SnmpAdminString,
  3373.        snmpProxyTargetParamsIn     SnmpAdminString,
  3374.        snmpProxySingleTargetOut    SnmpAdminString,
  3375.        snmpProxyMultipleTargetOut  SnmpTagValue,
  3376.        snmpProxyStorageType        StorageType,
  3377.        snmpProxyRowStatus          RowStatus
  3378.    }
  3379.  
  3380.    snmpProxyName OBJECT-TYPE
  3381.        SYNTAX      SnmpAdminString (SIZE(1..32))
  3382.        MAX-ACCESS  not-accessible
  3383.        STATUS      current
  3384.        DESCRIPTION
  3385.            "The locally arbitrary, but unique identifier associated
  3386.             with this snmpProxyEntry."
  3387.        ::= { snmpProxyEntry 1 }
  3388.  
  3389.    snmpProxyType OBJECT-TYPE
  3390.        SYNTAX      INTEGER {
  3391.                        read(1),
  3392.                        write(2),
  3393.                        trap(3),
  3394.                        inform(4)
  3395.                    }
  3396.        MAX-ACCESS  read-create
  3397.        STATUS      current
  3398.        DESCRIPTION
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404. Expires April 1998                                       [Page 60]
  3405.  
  3406. Draft                     SNMPv3 Applications               October 1997
  3407.  
  3408.  
  3409.            "The type of message that may be forwarded using
  3410.             the translation parameters defined by this entry."
  3411.        ::= { snmpProxyEntry 2 }
  3412.  
  3413.    snmpProxyContextEngineID OBJECT-TYPE
  3414.        SYNTAX      SnmpEngineID
  3415.        MAX-ACCESS  read-create
  3416.        STATUS      current
  3417.        DESCRIPTION
  3418.            "The contextEngineID contained in messages that
  3419.             may be forwarded using the translation parameters
  3420.             defined by this entry."
  3421.        ::= { snmpProxyEntry 3 }
  3422.  
  3423.    snmpProxyContextName OBJECT-TYPE
  3424.        SYNTAX      SnmpAdminString
  3425.        MAX-ACCESS  read-create
  3426.        STATUS      current
  3427.        DESCRIPTION
  3428.            "The contextName contained in messages that may be
  3429.             forwarded using the translation parameters defined
  3430.             by this entry.
  3431.  
  3432.             This object is optional, and if not supported, the
  3433.             contextName contained in a message is ignored when
  3434.             selecting an entry in the snmpProxyTable."
  3435.        ::= { snmpProxyEntry 4 }
  3436.  
  3437.    snmpProxyTargetParamsIn OBJECT-TYPE
  3438.        SYNTAX      SnmpAdminString
  3439.        MAX-ACCESS  read-create
  3440.        STATUS      current
  3441.        DESCRIPTION
  3442.            "This object selects an entry in the snmpTargetParamsTable.
  3443.             The selected entry is used to determine which row of the
  3444.             snmpProxyTable to use for forwarding received messages."
  3445.        ::= { snmpProxyEntry 5 }
  3446.  
  3447.    snmpProxySingleTargetOut OBJECT-TYPE
  3448.        SYNTAX      SnmpAdminString
  3449.        MAX-ACCESS  read-create
  3450.        STATUS      current
  3451.        DESCRIPTION
  3452.            "This object selects a management target defined in the
  3453.             snmpTargetAddrTable (in the SNMP-TARGET-MIB).  The
  3454.             selected target is defined by an entry in the
  3455.             snmpTargetAddrTable whose index value (snmpTargetAddrName)
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461. Expires April 1998                                       [Page 61]
  3462.  
  3463. Draft                     SNMPv3 Applications               October 1997
  3464.  
  3465.  
  3466.             is equal to this object.
  3467.  
  3468.             This object is only used when selection of a single
  3469.             target is required (i.e. when forwarding an incoming
  3470.             read or write request)."
  3471.        ::= { snmpProxyEntry 6 }
  3472.  
  3473.    snmpProxyMultipleTargetOut OBJECT-TYPE
  3474.        SYNTAX      SnmpTagValue
  3475.        MAX-ACCESS  read-create
  3476.        STATUS      current
  3477.        DESCRIPTION
  3478.            "This object selects a set of management targets defined
  3479.             in the snmpTargetAddrTable (in the SNMP-TARGET-MIB).
  3480.  
  3481.             This object is only used when selection of multiple
  3482.             targets is required (i.e. when forwarding an incoming
  3483.             notification)."
  3484.        ::= { snmpProxyEntry 7 }
  3485.  
  3486.    snmpProxyStorageType OBJECT-TYPE
  3487.        SYNTAX      StorageType
  3488.        MAX-ACCESS  read-create
  3489.        STATUS      current
  3490.        DESCRIPTION
  3491.            "The storage type of this conceptual row."
  3492.        ::= { snmpProxyEntry 8 }
  3493.  
  3494.    snmpProxyRowStatus OBJECT-TYPE
  3495.        SYNTAX      RowStatus
  3496.        MAX-ACCESS  read-create
  3497.        STATUS      current
  3498.        DESCRIPTION
  3499.            "The status of this conceptual row.
  3500.  
  3501.             To create a row in this table, a manager must
  3502.             set this object to either createAndGo(4) or
  3503.             createAndWait(5).
  3504.  
  3505.             The following objects may not be modified while the
  3506.             value of this object is active(1):
  3507.                 - snmpProxyType
  3508.                 - snmpProxyContextEngineID
  3509.                 - snmpProxyContextName
  3510.                 - snmpProxyTargetParamsIn
  3511.                 - snmpProxySingleTargetOut
  3512.                 - snmpProxyMultipleTargetOut"
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518. Expires April 1998                                       [Page 62]
  3519.  
  3520. Draft                     SNMPv3 Applications               October 1997
  3521.  
  3522.  
  3523.        ::= { snmpProxyEntry 9 }
  3524.  
  3525.    --
  3526.    --
  3527.    -- Conformance information
  3528.    --
  3529.    --
  3530.  
  3531.    snmpProxyCompliances OBJECT IDENTIFIER ::=
  3532.                                             { snmpProxyConformance 1 }
  3533.    snmpProxyGroups      OBJECT IDENTIFIER ::=
  3534.                                             { snmpProxyConformance 2 }
  3535.  
  3536.    --
  3537.    --
  3538.    -- Compliance statements
  3539.    --
  3540.    --
  3541.  
  3542.    snmpProxyCompliance MODULE-COMPLIANCE
  3543.        STATUS      current
  3544.        DESCRIPTION
  3545.            "The compliance statement for SNMP entities which include
  3546.             a proxy forwarding application."
  3547.        MODULE SNMP-TARGET-MIB
  3548.            MANDATORY-GROUPS { snmpTargetBasicGroup,
  3549.                               snmpTargetResponseGroup }
  3550.        MODULE -- This Module
  3551.            MANDATORY-GROUPS { snmpProxyGroup }
  3552.        ::= { snmpProxyCompliances 1 }
  3553.  
  3554.    snmpProxyGroup OBJECT-GROUP
  3555.        OBJECTS {
  3556.            snmpProxyType,
  3557.            snmpProxyContextEngineID,
  3558.            snmpProxyContextName,
  3559.            snmpProxyTargetParamsIn,
  3560.            snmpProxySingleTargetOut,
  3561.            snmpProxyMultipleTargetOut,
  3562.            snmpProxyStorageType,
  3563.            snmpProxyRowStatus
  3564.        }
  3565.        STATUS      current
  3566.        DESCRIPTION
  3567.            "A collection of objects providing remote configuration of
  3568.             management target translation parameters for use by
  3569.             proxy forwarder applications."
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575. Expires April 1998                                       [Page 63]
  3576.  
  3577. Draft                     SNMPv3 Applications               October 1997
  3578.  
  3579.  
  3580.        ::= { snmpProxyGroups 3 }
  3581.  
  3582.    END
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631. Expires April 1998                                       [Page 64]
  3632.  
  3633. Draft                     SNMPv3 Applications               October 1997
  3634.  
  3635.  
  3636. 6.  Identification of Management Targets in Notification Originators
  3637.  
  3638.    This section describes the mechanisms used by a notification
  3639.    originator application when using the MIB module described in this
  3640.    document to determine the set of management targets to be used when
  3641.    generating a notification.
  3642.  
  3643.    A notification originator uses the snmpNotifyTable to find the
  3644.    management targets to be used for generating notifications.  Each
  3645.    active entry in this table identifies zero or more entries in the
  3646.    snmpTargetAddrTable.  Any entry in the snmpTargetAddrTable whose
  3647.    snmpTargetAddrTagList object contains a tag value which is equal to a
  3648.    value of snmpNotifyTag is selected by the snmpNotifyEntry which
  3649.    contains that instance of snmpNotifyTag.  Note that a particular
  3650.    snmpTargetAddrEntry may be selected by multiple entries in the
  3651.    snmpNotifyTable, resulting in multiple notifications being generated
  3652.    using that snmpTargetAddrEntry.
  3653.  
  3654.    Each snmpTargetAddrEntry contains a pointer to the
  3655.    snmpTargetParamsTable (snmpTargetAddrParams).  This pointer selects a
  3656.    set of SNMP parameters to be used for generating notifications.  If
  3657.    the selected entry in the snmpTargetParamsTable does not exist, the
  3658.    management target is not used to generate notifications.
  3659.  
  3660.    The decision as to whether a notification should contain an SNMPv2-
  3661.    Trap or Inform PDU is determined by the value of the snmpNotifyType
  3662.    object.  If the value of this object is trap(1), the notification
  3663.    should contain an SNMPv2-Trap PDU.  If the value of this object is
  3664.    inform(2), then the notification should contain an Inform PDU, and
  3665.    the timeout time and number of retries for the Inform are the value
  3666.    of snmpTargetAddrTimeout and snmpTargetAddrRetryCount.  Note that the
  3667.    exception to these rules is when the snmpTargetParamsMPModel object
  3668.    indicates SNMPv1.  In this case, the notification is sent as a Trap
  3669.    if the value of snmpNotifyTargetType is either trap(1) or inform(2).
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687. Expires April 1998                                       [Page 65]
  3688.  
  3689. Draft                     SNMPv3 Applications               October 1997
  3690.  
  3691.  
  3692. 7.  Notification Filtering
  3693.  
  3694.    This section describes the mechanisms used by a notification
  3695.    originator application when using the MIB module described in this
  3696.    document to filter generation of notifications.
  3697.  
  3698.    A notification originator uses the snmpNotifyFilterTable to filter
  3699.    notifications.  A notification filter profile may be associated with
  3700.    a management target identified by a particular entry in the
  3701.    snmpTargetAddrTable.  The associated filter profile is identified by
  3702.    an entry in the snmpNotifyFilterProfileTable whose index is equal to
  3703.    the index of the entry in the snmpTargetAddrTable.  If no such entry
  3704.    exists in the snmpNotifyFilterProfileTable, no filtering is performed
  3705.    for that management target.
  3706.  
  3707.    If such an entry does exist, the value of snmpNotifyFilterProfileName
  3708.    of the entry is compared with the corresponding portion of the index
  3709.    of all active entries in the snmpNotifyFilterTable.  All such entries
  3710.    for which this comparison results in an exact match are used for
  3711.    filtering the notification.  If no such entries exist, no filtering
  3712.    is performed, and the notification may be sent to the management
  3713.    target.
  3714.  
  3715.    Otherwise, if matching entries do exist, the notification may be sent
  3716.    if the NOTIFICATION-TYPE OBJECT IDENTIFIER of the notification (this
  3717.    is the value of the element of the variable bindings whose name is
  3718.    snmpTrapOID.0, i.e., the second variable binding), and all of the
  3719.    object instances to be included in the variable-bindings of the
  3720.    notification, are not specifically excluded by the matching entries.
  3721.  
  3722.    Each set of snmpNotifyFilterTable entries is divided into two
  3723.    collections of filter subtrees:  the included filter subtrees, and
  3724.    the excluded filter subtrees.  The snmpNotifyFilterType object
  3725.    defines the collection to which each matching entry belongs.
  3726.  
  3727.    To determine whether a particular notification name or object
  3728.    instance is excluded by the set of matching entries, compare the
  3729.    notification name's or object instance's OBJECT IDENTIFIER with each
  3730.    of the matching entries.  If none match, then the notification name
  3731.    or object instance is considered excluded, and the notification
  3732.    should not be sent to this management target.  If one or more match,
  3733.    then the notification name or object instance is included or
  3734.    excluded, according to the value of snmpNotifyFilterType in the entry
  3735.    whose value of snmpNotifyFilterSubtree has the most sub-identifiers.
  3736.    If multiple entries match and have the same number of sub-
  3737.    identifiers, then the lexicographically greatest instance of
  3738.    snmpNotifyFilterType among those which match determines the inclusion
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744. Expires April 1998                                       [Page 66]
  3745.  
  3746. Draft                     SNMPv3 Applications               October 1997
  3747.  
  3748.  
  3749.    or exclusion.
  3750.  
  3751.    A notification name's or object instance's OBJECT IDENTIFIER X
  3752.    matches an entry in the snmpNotifyFilterTable when the number of
  3753.    sub-identifiers in X is at least as many as in the value of
  3754.    snmpNotifyFilterSubtree for the entry, and each sub-identifier in the
  3755.    value of snmpNotifyFilterSubtree matches its corresponding sub-
  3756.    identifier in X.  Two sub-identifiers match either if the
  3757.    corresponding bit of snmpNotifyFilterMask is zero (the 'wild card'
  3758.    value), or if the two sub-identifiers are equal.
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800. Expires April 1998                                       [Page 67]
  3801.  
  3802. Draft                     SNMPv3 Applications               October 1997
  3803.  
  3804.  
  3805. 8.  Management Target Translation in Proxy Forwarder Applications
  3806.  
  3807.    This section describes the mechanisms used by a proxy forwarder
  3808.    application when using the MIB module described in this document to
  3809.    translate incoming management target information into outgoing
  3810.    management target information for the purpose of forwarding messages.
  3811.    There are actually two mechanisms a proxy forwarder may use, one for
  3812.    forwarding request messages, and one for forwarding notification
  3813.    messages.
  3814.  
  3815.  
  3816. 8.1.  Management Target Translation for Request Forwarding
  3817.  
  3818.    When forwarding request messages, the proxy forwarder will select a
  3819.    single entry in the snmpProxyTable.  To select this entry, it will
  3820.    perform the following comparisons:
  3821.  
  3822.        -  The snmpProxyType must be read(1) if the request is a Get,
  3823.           GetNext, or GetBulk request.  The snmpProxyType must be
  3824.           write(2) if the request is a Set request.
  3825.  
  3826.        -  The contextEngineId must equal the snmpProxyContextEngineID
  3827.           object.
  3828.  
  3829.        -  If the snmpProxyContextName object is supported, it must equal
  3830.           the contextName.
  3831.  
  3832.        -  The snmpProxyTargetParamsIn object identifies an entry in the
  3833.           snmpTargetParamsTable.  The messageProcessingModel,
  3834.           securityLevel, security model, and securityName must match the
  3835.           values of snmpTargetParamsMPModel,
  3836.           snmpTargetParamsSecurityModel, snmpTargetParamsSecurityName,
  3837.           and snmpTargetParamsSecurityLevel of the identified entry in
  3838.           the snmpTargetParamsTable.
  3839.  
  3840.    There may be multiple entries in the snmpProxyTable for which these
  3841.    comparisons succeed.  The entry whose snmpProxyName has the
  3842.    lexicographically smallest value and for which the comparisons
  3843.    succeed will be selected by the proxy forwarder.
  3844.  
  3845.    The outgoing management target information is identified by the value
  3846.    of the snmpProxySingleTargetOut object of the selected entry.  This
  3847.    object identifies an entry in the snmpTargetAddrTable.  The
  3848.    identified entry in the snmpTargetAddrTable also contains a reference
  3849.    to the snmpTargetParamsTable (snmpTargetAddrParams).  If either the
  3850.    identified entry in the snmpTargetAddrTable does not exist, or the
  3851.    identified entry in the snmpTargetParamsTable does not exist, then
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857. Expires April 1998                                       [Page 68]
  3858.  
  3859. Draft                     SNMPv3 Applications               October 1997
  3860.  
  3861.  
  3862.    this snmpProxyEntry does not identify valid forwarding information,
  3863.    and the proxy forwarder should attempt to identify another row.
  3864.  
  3865.    If there is no entry in the snmpProxyTable for which all of the
  3866.    conditions above may be met, then there is no appropriate forwarding
  3867.    information, and the proxy forwarder should take appropriate actions.
  3868.  
  3869.    Otherwise, The snmpTargetAddrTDomain, snmpTargetAddrTAddress,
  3870.    snmpTargetAddrTimeout, and snmpTargetRetryCount of the identified
  3871.    snmpTargetAddrEntry, and the snmpTargetParamsMPModel,
  3872.    snmpTargetParamsSecurityModel, snmpTargetParamsSecurityName, and
  3873.    snmpTargetParamsSecurityLevel of the identified snmpTargetParamsEntry
  3874.    are used as the destination management target.
  3875.  
  3876.  
  3877. 8.2.  Management Target Translation for Notification Forwarding
  3878.  
  3879.    When forwarding notification messages, the proxy forwarder will
  3880.    select multiple entries in the snmpProxyTable.  To select these
  3881.    entries, it will perform the following comparisons:
  3882.  
  3883.        -  The snmpProxyType must be trap(3) if the notification is a
  3884.           Trap.  The snmpProxyType must be inform(4) if the request is
  3885.           an Inform.
  3886.  
  3887.        -  The contextEngineId must equal the snmpProxyContextEngineID
  3888.           object.
  3889.  
  3890.        -  If the snmpProxyContextName object is supported, it must equal
  3891.           the contextName.
  3892.  
  3893.        -  The snmpProxyTargetParamsIn object identifies an entry in the
  3894.           snmpTargetParamsTable.  The messageProcessingModel,
  3895.           securityLevel, security model, and securityName must match the
  3896.           values of snmpTargetParamsMPModel,
  3897.           snmpTargetParamsSecurityModel, snmpTargetParamsSecurityName,
  3898.           and snmpTargetParamsSecurityLevel of the identified entry in
  3899.           the snmpTargetParamsTable.
  3900.  
  3901.    All entries for which these conditions are met are selected.  The
  3902.    snmpProxyMultipleTargetOut object of each such entry is used to
  3903.    select a set of entries in the snmpTargetAddrTable.  Any
  3904.    snmpTargetAddrEntry whose snmpTargetAddrTagList object contains a tag
  3905.    value equal to the value of snmpProxyMultipleTargetOut, and whose
  3906.    snmpTargetAddrParams object references an existing entry in the
  3907.    snmpTargetParamsTable, is selected as a destination for the forwarded
  3908.    notification.
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914. Expires April 1998                                       [Page 69]
  3915.  
  3916. Draft                     SNMPv3 Applications               October 1997
  3917.  
  3918.  
  3919. 9.  Security Considerations
  3920.  
  3921.    The SNMP applications described in this document typically have
  3922.    direct access to MIB instrumentation.  Thus, it is very important
  3923.    that these applications be strict in their application of access
  3924.    control as described in this document.
  3925.  
  3926.    In addition, there may be some types of notification generator
  3927.    applications which, rather than accessing MIB instrumentation using
  3928.    access control, will obtain MIB information through other means (such
  3929.    as from a command line).  The implementors and users of such
  3930.    applications must be responsible for not divulging MIB information
  3931.    that normally would be inaccessible due to access control.
  3932.  
  3933.  
  3934.  
  3935. 10.  Editor's Address
  3936.  
  3937.      David B. Levi
  3938.      SNMP Research, Inc.
  3939.      3001 Kimberlin Heights Road
  3940.      Knoxville, TN 37920-9716
  3941.      U.S.A.
  3942.      Phone: +1 423 573 1434
  3943.      EMail: levi@snmp.com
  3944.  
  3945.      Paul Meyer
  3946.      Secure Computing Corporation
  3947.      2675 Long Lake Road
  3948.      Roseville, MN 55113
  3949.      U.S.A.
  3950.      Phone: +1 612 628 1592
  3951.      EMail: paul_meyer@securecomputing.com
  3952.  
  3953.      Bob Stewart
  3954.      Cisco Systems, Inc.
  3955.      170 West Tasman Drive
  3956.      San Jose, CA 95134-1706
  3957.      U.S.A.
  3958.      Phone: +1 603 654 6923
  3959.      EMail: bstewart@cisco.com
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970. Expires April 1998                                       [Page 70]
  3971.  
  3972. Draft                     SNMPv3 Applications               October 1997
  3973.  
  3974.  
  3975. 11.  Acknowledgments
  3976.  
  3977.    This document is the result of the efforts of the SNMPv3 Working
  3978.    Group.  Some special thanks are in order to the following SNMPv3 WG
  3979.    members:
  3980.  
  3981.        Dave Battle (SNMP Research, Inc.)
  3982.        Uri Blumenthal (IBM T.J. Watson Research Center)
  3983.        Jeff Case (SNMP Research, Inc.)
  3984.        John Curran (BBN)
  3985.        T. Max Devlin (Hi-TECH Connections)
  3986.        John Flick (Hewlett Packard)
  3987.        David Harrington (Cabletron Systems Inc.)
  3988.        N.C. Hien (IBM T.J. Watson Research Center)
  3989.        Dave Levi (SNMP Research, Inc.)
  3990.        Louis A Mamakos (UUNET Technologies Inc.)
  3991.        Paul Meyer (Secure Computing Corporation)
  3992.        Keith McCloghrie (Cisco Systems)
  3993.        Russ Mundy (Trusted Information Systems, Inc.)
  3994.        Bob Natale (ACE*COMM Corporation)
  3995.        Mike O'Dell (UUNET Technologies Inc.)
  3996.        Dave Perkins (DeskTalk)
  3997.        Peter Polkinghorne (Brunel University)
  3998.        Randy Presuhn (BMC Software, Inc.)
  3999.        David Reid (SNMP Research, Inc.)
  4000.        Shawn Routhier (Epilogue)
  4001.        Juergen Schoenwaelder (TU Braunschweig)
  4002.        Bob Stewart (Cisco Systems)
  4003.        Bert Wijnen (IBM T.J. Watson Research Center)
  4004.  
  4005.    The document is based on recommendations of the IETF Security and
  4006.    Administrative Framework Evolution for SNMP Advisory Team. Members of
  4007.    that Advisory Team were:
  4008.  
  4009.        David Harrington (Cabletron Systems Inc.)
  4010.        Jeff Johnson (Cisco Systems)
  4011.        David Levi (SNMP Research Inc.)
  4012.        John Linn (Openvision)
  4013.        Russ Mundy (Trusted Information Systems) chair
  4014.        Shawn Routhier (Epilogue)
  4015.        Glenn Waters (Nortel)
  4016.        Bert Wijnen (IBM T. J. Watson Research Center)
  4017.  
  4018.    As recommended by the Advisory Team and the SNMPv3 Working Group
  4019.    Charter, the design incorporates as much as practical from previous
  4020.    RFCs and drafts. As a result, special thanks are due to the authors
  4021.    of previous designs known as SNMPv2u and SNMPv2*:
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027. Expires April 1998                                       [Page 71]
  4028.  
  4029. Draft                     SNMPv3 Applications               October 1997
  4030.  
  4031.  
  4032.        Jeff Case (SNMP Research, Inc.)
  4033.        David Harrington (Cabletron Systems Inc.)
  4034.        David Levi (SNMP Research, Inc.)
  4035.        Keith McCloghrie (Cisco Systems)
  4036.        Brian O'Keefe (Hewlett Packard)
  4037.        Marshall T. Rose (Dover Beach Consulting)
  4038.        Jon Saperia (BGS Systems Inc.)
  4039.        Steve Waldbusser (International Network Services)
  4040.        Glenn W. Waters (Bell-Northern Research Ltd.)
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083. Expires April 1998                                       [Page 72]
  4084.  
  4085. Draft                     SNMPv3 Applications               October 1997
  4086.  
  4087.  
  4088. 12.  References
  4089.  
  4090. [RFC1157]
  4091.      Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  4092.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  4093.      International, Performance Systems International, MIT Laboratory
  4094.      for Computer Science, May 1990.
  4095.  
  4096. [RFC1213]
  4097.      McCloghrie, K., and M. Rose, Editors, "Management Information Base
  4098.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  4099.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  4100.      March 1991.
  4101.  
  4102. [RFC1902]
  4103.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  4104.      Waldbusser, "Structure of Management Information for Version 2 of
  4105.      the Simple Network Management Protocol (SNMPv2)", RFC1902, SNMP
  4106.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  4107.      International Network Services, January 1996.
  4108.  
  4109. [RFC1903]
  4110.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  4111.      Waldbusser, "Textual Conventions for Version 2 of the Simple
  4112.      Network Management Protocol (SNMPv2)", RFC1903, SNMP Research,Inc.,
  4113.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  4114.      Network Services, January 1996.
  4115.  
  4116. [RFC1905]
  4117.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  4118.      Waldbusser, "Protocol Operations for Version 2 of the Simple
  4119.      Network Management Protocol (SNMPv2)", RFC1905, SNMP Research,Inc.,
  4120.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  4121.      Network Services, January 1996.
  4122.  
  4123. [RFC1907]
  4124.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  4125.      Waldbusser, "Management Information Base for Version 2 of the
  4126.      Simple Network Management Protocol (SNMPv2)", RFC1905, SNMP
  4127.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  4128.      International Network Services, January 1996.
  4129.  
  4130. [RFC1908]
  4131.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  4132.      Waldbusser, "Coexistence between Version 1 and Version 2 of the
  4133.      Internet-standard Network Management Framework", RFC1905, SNMP
  4134.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140. Expires April 1998                                       [Page 73]
  4141.  
  4142. Draft                     SNMPv3 Applications               October 1997
  4143.  
  4144.  
  4145.      International Network Services, January 1996.
  4146.  
  4147. [SNMP-ARCH]
  4148.      The SNMPv3 Working Group, Harrington, D., Wijnen, B., "An
  4149.      Architecture for Describing SNMP Management Frameworks", draft-
  4150.      ietf-snmpv3-next-gen-arch-05.txt, September 1997.
  4151.  
  4152. [SNMP-MPD]
  4153.      The SNMPv3 Working Group, Case, J., Harrington, D., Wijnen, B.,
  4154.      "Message Processing and Dispatching for the Simple Network
  4155.      Management Protocol (SNMP)", draft-ietf-snmpv3-v3mpc-model-05.txt,
  4156.      October 1997.
  4157.  
  4158. [SNMP-ACM]
  4159.      The SNMPv3 Working Group, Wijnen, B., Presuhn, R., McCloghrie, K.,
  4160.      "View-based Access Control Model for the Simple Network Management
  4161.      Protocol (SNMP)", draft-ietf-snmpv3-acm-03.txt, September 1997.
  4162.  
  4163.  
  4164.  
  4165.    APPENDIX A - Trap Configuration Example
  4166.  
  4167.    This section describes an example configuration for a Notification
  4168.    Generator application which implements the snmpNotifyBasicCompliance
  4169.    level.  The example configuration specifies that the Notification
  4170.    Generator should send notifications to 3 separate managers, using
  4171.    authentication and no privacy for the first 2 managers, and using
  4172.    both authentication and privacy for the third manager.
  4173.  
  4174.    The configuration consists of three rows in the snmpTargetAddrTable,
  4175.    and two rows in the snmpTargetTable.
  4176.  
  4177.           snmpTargetAddrName         SnmpAdminString,
  4178.           snmpTargetAddrTDomain      TDomain,
  4179.           snmpTargetAddrTAddress     TAddress,
  4180.           snmpTargetAddrTimeout      TimeInterval,
  4181.           snmpTargetAddrRetryCount   Integer32,
  4182.           snmpTargetAddrTagList      SnmpAdminString,
  4183.           snmpTargetAddrParams       SnmpAdminString,
  4184.           snmpTargetAddrStorageType  StorageType,
  4185.           snmpTargetAddrRowStatus    RowStatus
  4186.  
  4187.         * snmpTargetAddrName        = "addr1"
  4188.           snmpTargetAddrTDomain     = snmpUDPDomain
  4189.           snmpTargetAddrTAddress    = 128.1.2.3:162
  4190.           snmpTargetAddrTagList     = "group1"
  4191.           snmpTargetAddrParams      = "AuthNoPriv joe"
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197. Expires April 1998                                       [Page 74]
  4198.  
  4199. Draft                     SNMPv3 Applications               October 1997
  4200.  
  4201.  
  4202.           snmpTargetAddrStorageType = readOnly(5)
  4203.           snmpTargetAddrRowStatus   = active(1)
  4204.  
  4205.         * snmpTargetAddrName        = "addr2"
  4206.           snmpTargetAddrTDomain     = snmpUDPDomain
  4207.           snmpTargetAddrTAddress    = 128.2.4.6:162
  4208.           snmpTargetAddrTagList     = "group1"
  4209.           snmpTargetAddrParams      = "AuthNoPriv-joe"
  4210.           snmpTargetAddrStorageType = readOnly(5)
  4211.           snmpTargetAddrRowStatus   = active(1)
  4212.  
  4213.         * snmpTargetAddrName        = "addr3"
  4214.           snmpTargetAddrTDomain     = snmpUDPDomain
  4215.           snmpTargetAddrTAddress    = 128.1.2.3:162
  4216.           snmpTargetAddrTagList     = "group2"
  4217.           snmpTargetAddrParams      = "AuthPriv-bob"
  4218.           snmpTargetAddrStorageType = readOnly(5)
  4219.           snmpTargetAddrRowStatus   = active(1)
  4220.  
  4221.         * snmpTargetParamsName                   = "AuthNoPriv-joe"
  4222.           snmpTargetParamsMPModel                = 3
  4223.           snmpTargetParamsSecurityModel          = 3 (USM)
  4224.           snmpTargetParamsSecurityName           = "joe"
  4225.           snmpTargetParamsSecurityLevel          = authNoPriv(2)
  4226.           snmpTargetParamsStorageType            = readOnly(5)
  4227.           snmpTargetParamsRowStatus              = active(1)
  4228.  
  4229.         * snmpTargetParamsName                   = "AuthPriv-bob"
  4230.           snmpTargetParamsMPModel                = 3
  4231.           snmpTargetParamsSecurityModel          = 3 (USM)
  4232.           snmpTargetParamsSecurityName           = "bob"
  4233.           snmpTargetParamsSecurityLevel          = authPriv(3)
  4234.           snmpTargetParamsStorageType            = readOnly(5)
  4235.           snmpTargetParamsRowStatus              = active(1)
  4236.  
  4237.         * snmpNotifyName         = "group1"
  4238.           snmpNotifyTag          = "group1"
  4239.           snmpNotifyType         = trap(1)
  4240.           snmpNotifyStorageType  = readOnly(5)
  4241.           snmpNotifyRowStatus    = active(1)
  4242.  
  4243.         * snmpNotifyName         = "group2"
  4244.           snmpNotifyTag          = "group2"
  4245.           snmpNotifyType         = trap(1)
  4246.           snmpNotifyStorageType  = readOnly(5)
  4247.           snmpNotifyRowStatus    = active(1)
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253. Expires April 1998                                       [Page 75]
  4254.  
  4255. Draft                     SNMPv3 Applications               October 1997
  4256.  
  4257.  
  4258.    These entries define two groups of management targets.  The first
  4259.    group contains two management targets:
  4260.  
  4261.                                 first target      second target
  4262.                                 ------------      -------------
  4263.        messageProcessingModel   SNMPv3            SNMPv3
  4264.                 securityModel   3 (USM)           3 (USM)
  4265.                  securityName   "joe"             "joe"
  4266.                 securityLevel   authNoPriv(2)     authNoPriv(2)
  4267.               transportDomain   snmpUDPDomain     snmpUDPDomain
  4268.              transportAddress   128.1.2.3:162     128.2.4.6:162
  4269.  
  4270.    And the second group contains a single management target:
  4271.  
  4272.        messageProcessingModel   SNMPv3
  4273.                 securityLevel   authPriv(3)
  4274.                 securityModel   3 (USM)
  4275.                  securityName   "bob"
  4276.               transportDomain   snmpUDPDomain
  4277.              transportAddress   128.1.5.9:162
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309. Expires April 1998                                       [Page 76]
  4310.  
  4311. Draft                     SNMPv3 Applications               October 1997
  4312.  
  4313.  
  4314.    Table of Contents
  4315.  
  4316.  
  4317.    1 Abstract .....................................................    2
  4318.    2 Overview .....................................................    3
  4319.    2.1 Command Generator Applications .............................    3
  4320.    2.2 Command Responder Applications .............................    3
  4321.    2.3 Notification Originator Applications .......................    4
  4322.    2.4 Notification Receiver Applications .........................    4
  4323.    2.5 Proxy Forwarder Applications ...............................    4
  4324.    3 Management Targets ...........................................    6
  4325.    4 Elements Of Procedure ........................................    6
  4326.    4.1 Command Generator Applications .............................    6
  4327.    4.2 Command Responder Applications .............................   10
  4328.    4.3 Notification Originator Applications .......................   15
  4329.    4.4 Notification Receiver Applications .........................   18
  4330.    4.5 Proxy Forwarder Applications ...............................   20
  4331.    4.5.1 Request Forwarding .......................................   21
  4332.    4.5.1.1 Processing an Incoming Request .........................   21
  4333.    4.5.1.2 Processing an Incoming Response ........................   24
  4334.    4.5.1.3 Processing an Incoming Report Indication ...............   25
  4335.    4.5.2 Notification Forwarding ..................................   26
  4336.    5 The Structure of the MIB Modules .............................   30
  4337.    5.1 The Management Target MIB Module ...........................   30
  4338.    5.1.1 Tag Lists ................................................   30
  4339.    5.1.2 Definitions ..............................................   31
  4340.    5.2 The Notification MIB Module ................................   45
  4341.    5.2.1 Definitions ..............................................   45
  4342.    5.3 The Proxy MIB Module .......................................   58
  4343.    5.3.1 Definitions ..............................................   58
  4344.    6 Identification of Management Targets in Notification Origi-
  4345.         nators ....................................................   65
  4346.    7 Notification Filtering .......................................   66
  4347.    8 Management Target Translation in Proxy  Forwarder  Applica-
  4348.         tions .....................................................   68
  4349.    8.1 Management Target Translation for Request Forwarding .......   68
  4350.    8.2 Management Target Translation for Notification Forwarding
  4351.         ...........................................................   69
  4352.    9 Security Considerations ......................................   70
  4353.    10 Editor's Address ............................................   70
  4354.    11 Acknowledgments .............................................   71
  4355.    12 References ..................................................   73
  4356.    Appendix A Trap Configuration Example ..........................   74
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365. Expires April 1998                                       [Page 77ENDPAGE
  4366.