Definitions of Managed Objects for the RPKI-Router Protocol
draft-ietf-sidr-rpki-rtr-protocol-mib-00
The information below is for an old version of the document.
Document | Type |
This is an older version of an Internet-Draft that was ultimately published as RFC 6945.
|
|
---|---|---|---|
Authors | Randy Bush , Bert Wijnen , Keyur Patel , Michael Baer | ||
Last updated | 2012-09-14 (Latest revision 2012-03-26) | ||
RFC stream | Internet Engineering Task Force (IETF) | ||
Formats | |||
Reviews |
GENART Telechat review
(of
-04)
by Brian Carpenter
Ready w/issues
GENART Last Call review
(of
-04)
by Brian Carpenter
On the Right Track
|
||
Additional resources | Mailing list discussion | ||
Stream | WG state | Waiting for WG Chair Go-Ahead | |
Document shepherd | Alexey Melnikov | ||
IESG | IESG state | Became RFC 6945 (Proposed Standard) | |
Consensus boilerplate | Unknown | ||
Telechat date | (None) | ||
Responsible AD | (None) | ||
Send notices to | (None) |
draft-ietf-sidr-rpki-rtr-protocol-mib-00
Bush, et al. Expires September 27, 2012 [Page 5] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 REVISION "201110140000Z" DESCRIPTION "Initial version, published as RFCxxxx." -- Note to RFC Editor: pls fill in above (2 times) RFC -- number for xxxx and delete these 2 lines. ::= { mib-2 XXX } -- XXX to be assigned by IANA rpkiRtrNotifications OBJECT IDENTIFIER ::= { rpkiRtrMIB 0 } rpkiRtrObjects OBJECT IDENTIFIER ::= { rpkiRtrMIB 1 } rpkiRtrConformance OBJECT IDENTIFIER ::= { rpkiRtrMIB 2 } -- ============================================================== -- Textual Conventions used in this MIB module -- ============================================================== RpkiRtrConnectionType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The connection type or transport security suite (transport plus security mecahnism) used between a router (as a client) and a cache server. The following types have been defined in RFCnnnn: -- RFC Editor: pls fill out RFCnnnn number that will be or has -- been assigned to draft-ietf-sidr-rpki-rtr-nn.txt ssh(1) - sect 7.1, see also RFC4252. tls(2) - sect 7.2, see also RFC5246. tcpMD5(3) - sect 7.3, see also RFC2385. tcpAO(4) - sect 7.4, see also RFC5925. tcp(5) - sect 7. ipsec(6) - sect 7, see also RFC4301. other(7) - non of the above " REFERENCE "The RPKI/Rtr Protocol, RFCnnnn - section 7" -- RFC Editor: pls fill out RFCnnnn number that will be or has been -- assigned to draft-ietf-sidr-rpki-rtr-nn.txt SYNTAX INTEGER { ssh(1), tls(2), tcpMD5(3), tcpAO(4), tcp(5), ipsec(6), other(7) } -- ============================================================== -- Scalar objects -- ============================================================== rpkiRtrDiscontinuityTimer OBJECT-TYPE Bush, et al. Expires September 27, 2012 [Page 6] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "This timer represents the timestamp (value of sysUpTime) at which time any of the Counter32 ojects in this MIB module encountered a discontinuity. In principle that should only happen if the SNMP agent or the instrumentation for this MIB module (re-)starts." ::= { rpkiRtrObjects 1 } -- ============================================================== -- RPKI Router Cache Server Connection Table -- ============================================================== rpkiRtrCacheServerTable OBJECT-TYPE SYNTAX SEQUENCE OF RpkiRtrCacheServerTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table lists the RPKI cache servers known to this router/system." ::= { rpkiRtrObjects 2 } rpkiRtrCacheServerTableEntry OBJECT-TYPE SYNTAX RpkiRtrCacheServerTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the rpkiRtrCacheServerTable. It holds management attributes associated with one connection to a RPKI cache server." INDEX { rpkiRtrCacheServerAddressType, rpkiRtrCacheServerRemoteAddress, rpkiRtrCacheServerRemotePort } ::= { rpkiRtrCacheServerTable 1 } RpkiRtrCacheServerTableEntry ::= SEQUENCE { rpkiRtrCacheServerAddressType InetAddressType, rpkiRtrCacheServerRemoteAddress InetAddress, rpkiRtrCacheServerRemotePort InetPortNumber, rpkiRtrCacheServerLocalAddress InetAddress, rpkiRtrCacheServerLocalPort InetPortNumber, rpkiRtrCacheServerPreference Unsigned32, rpkiRtrCacheServerConnectionType RpkiRtrConnectionType, rpkiRtrCacheServerConnectionStatus INTEGER, rpkiRtrCacheServerDescription LongUtf8String, Bush, et al. Expires September 27, 2012 [Page 7] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 rpkiRtrCacheServerMsgsReceived Counter32, rpkiRtrCacheServerMsgsSent Counter32, rpkiRtrCacheServerV4ActiveRecords Gauge32, rpkiRtrCacheServerV4Announcements Counter32, rpkiRtrCacheServerV4Withdrawals Counter32, rpkiRtrCacheServerV6ActiveRecords Gauge32, rpkiRtrCacheServerV6Announcements Counter32, rpkiRtrCacheServerV6Withdrawals Counter32, rpkiRtrCacheServerLatestSerial Unsigned32, rpkiRtrCacheServerNonce Unsigned32, rpkiRtrCacheServerRefreshTimer Unsigned32, rpkiRtrCacheServerTimeToRefresh Integer32, rpkiRtrCacheServerId Unsigned32 } rpkiRtrCacheServerAddressType OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6 (2) } MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network address type of the connection to this RPKI cache server. Only IPv4 and IPv6 are supported." ::= { rpkiRtrCacheServerTableEntry 1 } rpkiRtrCacheServerRemoteAddress OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The remote network address for this connection to this RPKI cache server. The format of the address is defined by the value of the corresponding instance of rpkiRtrCacheServerAddressType." ::= { rpkiRtrCacheServerTableEntry 2 } rpkiRtrCacheServerRemotePort OBJECT-TYPE SYNTAX InetPortNumber (1..65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The remote port number for this connection to this RPKI cache server." ::= { rpkiRtrCacheServerTableEntry 3 } rpkiRtrCacheServerLocalAddress OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only Bush, et al. Expires September 27, 2012 [Page 8] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 STATUS current DESCRIPTION "The local network address for this connection to this RPKI cache server. The format of the address is defined by the value of the corresponding instance of rpkiRtrCacheServerAddressType." ::= { rpkiRtrCacheServerTableEntry 4 } rpkiRtrCacheServerLocalPort OBJECT-TYPE SYNTAX InetPortNumber (1..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "The local port number for this connection to this RPKI cache server." ::= { rpkiRtrCacheServerTableEntry 5 } rpkiRtrCacheServerPreference OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The routers' preference for this RPKI cache server. A lower value means more preferred. If two entries have the same preference, then the order is arbitrary. If no order is specified in the configuration then this value is set to 255." REFERENCE "The RPKI/Rtr Protocol, RFCnnnn - section 8." -- RFC-Editor: pls update RFCnnnn with the actual RFC number -- assigned to draft-ietf-sidr-rpki-rtr-nn.txt ::= { rpkiRtrCacheServerTableEntry 6 } rpkiRtrCacheServerConnectionType OBJECT-TYPE SYNTAX RpkiRtrConnectionType MAX-ACCESS read-only STATUS current DESCRIPTION "The connection type or transport security suite in use for this RPKI cache server." ::= { rpkiRtrCacheServerTableEntry 7 } rpkiRtrCacheServerConnectionStatus OBJECT-TYPE SYNTAX INTEGER { up(1), down(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The connection status for this entry Bush, et al. Expires September 27, 2012 [Page 9] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 (connection to this RPKI cache server)." ::= { rpkiRtrCacheServerTableEntry 8 } rpkiRtrCacheServerDescription OBJECT-TYPE SYNTAX LongUtf8String MAX-ACCESS read-only STATUS current DESCRIPTION "Free form description/information for this connection to this RPKI cache server." ::= { rpkiRtrCacheServerTableEntry 9 } rpkiRtrCacheServerMsgsReceived OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of messages received from this RPKI cache server via this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 10 } rpkiRtrCacheServerMsgsSent OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of messages sent to this RPKI cache server via this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 11 } rpkiRtrCacheServerV4ActiveRecords OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of active IPv4 records received from this RPKI cache server via this connection." ::= { rpkiRtrCacheServerTableEntry 12 } rpkiRtrCacheServerV4Announcements OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of IPv4 records announced by the RPKI cache Server via this connection. Bush, et al. Expires September 27, 2012 [Page 10] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 13 } rpkiRtrCacheServerV4Withdrawals OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of IPv4 records withdrawn by the RPKI cache Server via this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 14 } rpkiRtrCacheServerV6ActiveRecords OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of active IPv6 records received from this RPKI cache server via this connection." ::= { rpkiRtrCacheServerTableEntry 15 } rpkiRtrCacheServerV6Announcements OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of IPv6 records announced by the RPKI cache Server via this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 16 } rpkiRtrCacheServerV6Withdrawals OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of IPv6 records withdrawn by the RPKI cache Server via this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerTableEntry 17 } rpkiRtrCacheServerLatestSerial OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only Bush, et al. Expires September 27, 2012 [Page 11] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 STATUS current DESCRIPTION "The latest serial number of data received from this RPKI server on this connection. Note: this value wraps back to zero when it reaches its maximum value." REFERENCE "RFCnnnn section 2 and RFC1982" -- RFC-Editor: please fill out nnnn with the RFC number assigned -- to draft-ietf-sidr-rpki-rtr-nn.txt ::= { rpkiRtrCacheServerTableEntry 18 } rpkiRtrCacheServerNonce OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "The nonce associated with the RPKI cache server at the other end of this connection." REFERENCE "RFCnnnn section 2" ::= { rpkiRtrCacheServerTableEntry 19 } rpkiRtrCacheServerRefreshTimer OBJECT-TYPE SYNTAX Unsigned32 (60..7200) UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of seconds configured for the refresh timer for this connection to this RPKI cache server." ::= { rpkiRtrCacheServerTableEntry 20 } rpkiRtrCacheServerTimeToRefresh OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of seconds remaining before a new refresh is performed via a Serial Query to this cache server over this connection. A negative value means that the refresh time has passed this many seconds and the refresh has not yet been completed. Upon a completed refresh (i.e. a successful rnd complete esponse to a Serial Query) the value of this attribute will be re-initialized with the value of the corresponding rpkiRtrCacheServerRefreshTimer attribute." Bush, et al. Expires September 27, 2012 [Page 12] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 ::= { rpkiRtrCacheServerTableEntry 21 } rpkiRtrCacheServerId OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "The unique ID for this connection. An implementation must make sure this ID is unique within this table. It is this ID that can be used to find entries in the rpkiRtrPrefixOriginTable that were created by announcements received on this connection from this cache server." ::= { rpkiRtrCacheServerTableEntry 22 } -- ============================================================== -- Errors Table -- ============================================================== rpkiRtrCacheServerErrorsTable OBJECT-TYPE SYNTAX SEQUENCE OF RpkiRtrCacheServerErrorsTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides statistics on errors per RPKI peer connection. These can be used for debuging." ::= { rpkiRtrObjects 3 } rpkiRtrCacheServerErrorsTableEntry OBJECT-TYPE SYNTAX RpkiRtrCacheServerErrorsTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the rpkiCacheServerErrorTable. It holds management objects associated with errors that were detected for the specified connection to a specific cache server." AUGMENTS { rpkiRtrCacheServerTableEntry } ::= { rpkiRtrCacheServerErrorsTable 1 } RpkiRtrCacheServerErrorsTableEntry ::= SEQUENCE { rpkiRtrCacheServerErrorsCorruptData Counter32, rpkiRtrCacheServerErrorsInternalError Counter32, rpkiRtrCacheServerErrorsNoData Counter32, rpkiRtrCacheServerErrorsInvalidRequest Counter32, rpkiRtrCacheServerErrorsUnsupportedVersion Counter32, rpkiRtrCacheServerErrorsUnsupportedPdu Counter32, rpkiRtrCacheServerErrorsWithdrawalUnknown Counter32, rpkiRtrCacheServerErrorsDuplicateAnnounce Counter32 Bush, et al. Expires September 27, 2012 [Page 13] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 } rpkiRtrCacheServerErrorsCorruptData OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Corrupt Data' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 1 } rpkiRtrCacheServerErrorsInternalError OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Internal Error' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 2 } rpkiRtrCacheServerErrorsNoData OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'No Data Available' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 3 } rpkiRtrCacheServerErrorsInvalidRequest OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Invalid Request' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." Bush, et al. Expires September 27, 2012 [Page 14] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 ::= { rpkiRtrCacheServerErrorsTableEntry 4 } rpkiRtrCacheServerErrorsUnsupportedVersion OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Unsupported Protocol Version' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 5 } rpkiRtrCacheServerErrorsUnsupportedPdu OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Unsupported PDU Type' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 6 } rpkiRtrCacheServerErrorsWithdrawalUnknown OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Withdrawal of Unknown Record' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." ::= { rpkiRtrCacheServerErrorsTableEntry 7 } rpkiRtrCacheServerErrorsDuplicateAnnounce OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'Duplicate Announcement Received' errors received from the RPKI cache server at the other end of this connection. Discontinuities are indicated by the value of rpkiRtrDiscontinuityTimer." Bush, et al. Expires September 27, 2012 [Page 15] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 ::= { rpkiRtrCacheServerErrorsTableEntry 8 } -- ============================================================== -- The rpkiRtrPrefixOriginTable (was refered to as ROATable in an -- earlier version of this table) -- ============================================================== rpkiRtrPrefixOriginTable OBJECT-TYPE SYNTAX SEQUENCE OF RpkiRtrPrefixOriginTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table lists the prefixes that were announced by RPKI cache servers to this system. That is the prefixes and their Origin ASN as recieved by announcements via the rpki-rtr protocol." ::= { rpkiRtrObjects 4 } rpkiRtrPrefixOriginTableEntry OBJECT-TYPE SYNTAX RpkiRtrPrefixOriginTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the rpkiRtrPrefixOriginTable. This represents one announced prefix." INDEX { rpkiRtrPrefixOriginAddressType, rpkiRtrPrefixOriginAddress, rpkiRtrPrefixOriginMinLength } ::= { rpkiRtrPrefixOriginTable 1 } RpkiRtrPrefixOriginTableEntry ::= SEQUENCE { rpkiRtrPrefixOriginAddressType InetAddressType, rpkiRtrPrefixOriginAddress InetAddress, rpkiRtrPrefixOriginMinLength InetAddressPrefixLength, rpkiRtrPrefixOriginMaxLength InetAddressPrefixLength, rpkiRtrPrefixOriginASN InetAutonomousSystemNumber, rpkiRtrPrefixOriginCacheServerId Unsigned32 } rpkiRtrPrefixOriginAddressType OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network Address Type for this prefix. Only IPv4 and IPv6 are supported." ::= { rpkiRtrPrefixOriginTableEntry 1 } Bush, et al. Expires September 27, 2012 [Page 16] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 rpkiRtrPrefixOriginAddress OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network Address for this prefix. The format of the address is defined by the value of the corresponding instance of rpkiRtrCacheServerAddressType." ::= { rpkiRtrPrefixOriginTableEntry 2 } rpkiRtrPrefixOriginMinLength OBJECT-TYPE SYNTAX InetAddressPrefixLength MAX-ACCESS not-accessible STATUS current DESCRIPTION "The minimum prefix length allowed for this prefix." ::= { rpkiRtrPrefixOriginTableEntry 3 } rpkiRtrPrefixOriginMaxLength OBJECT-TYPE SYNTAX InetAddressPrefixLength MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum prefix length allowed for this prefix. Note, this value must be greater or equal to the value of rpkiRtrPrefixOriginMinLength." ::= { rpkiRtrPrefixOriginTableEntry 4 } rpkiRtrPrefixOriginASN OBJECT-TYPE SYNTAX InetAutonomousSystemNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The ASN that is authorized to announce the prefix or sub-prefixes covered by this entry." ::= { rpkiRtrPrefixOriginTableEntry 5 } rpkiRtrPrefixOriginCacheServerId OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "The unique ID of the connection to the cache server from which this announcement was received. That connection is identified/found by a matching value in attribute rpkiRtrCacheServerId." ::= { rpkiRtrPrefixOriginTableEntry 6 } -- ============================================================== -- Notifications Bush, et al. Expires September 27, 2012 [Page 17] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 -- ============================================================== rpkiRtrCacheServerConnectionStateChange NOTIFICATION-TYPE OBJECTS { rpkiRtrCacheServerConnectionStatus, rpkiRtrCacheServerLatestSerial, rpkiRtrCacheServerNonce } STATUS current DESCRIPTION "This notification signals a change in the status of an rpkiRtrCacheServerConnection. The SNMP agent MUST throttle the generation of consecutive rpkiRtrCacheServerConnectionStateChange notifications such that there is at least a 5 second gap between them. " ::= { rpkiRtrNotifications 1 } rpkiRtrCacheServerConnectionToGoStale NOTIFICATION-TYPE OBJECTS { rpkiRtrCacheServerV4ActiveRecords, rpkiRtrCacheServerV6ActiveRecords, rpkiRtrCacheServerLatestSerial, rpkiRtrCacheServerNonce, rpkiRtrCacheServerRefreshTimer, rpkiRtrCacheServerTimeToRefresh } STATUS current DESCRIPTION "This notification signals that an RPKI cache server connection is about to go stale. It is suggested that this notifiation is generated when the value of the rpkiRtrCacheServerTimeToRefresh attribute goes below 60 seconds. The SNMP agent MUST throttle the generation of consecutive rpkiRtrCacheServerConnectionToGoStale notifications such that there is at least a 5 second gap between them. " ::= { rpkiRtrNotifications 2 } -- ============================================================== -- Module Compliance information -- ============================================================== rpkiRtrCompliances OBJECT IDENTIFIER ::= {rpkiRtrConformance 1} rpkiRtrGroups OBJECT IDENTIFIER ::= Bush, et al. Expires September 27, 2012 [Page 18] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 {rpkiRtrConformance 2} rpkiRtrReadOnlyCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The comliance statement for the rpkiRtrMIB module. There are only read-only objects in this MIB module, so the 'ReadOnly' in the name of this compliance statement is there only for clarity and truth in advertising. " MODULE -- This module MANDATORY-GROUPS { rpkiRtrCacheServerGroup, rpkiRtrPrefixOriginGroup, rpkiRtrNotificationsGroup } GROUP rpkiRtrCacheServerErrorsGroup DESCRIPTION "Implemntation of this group is optional and would be useful for debugging." ::= { rpkiRtrCompliances 1 } rpkiRtrCacheServerGroup OBJECT-GROUP OBJECTS { rpkiRtrDiscontinuityTimer, rpkiRtrCacheServerLocalAddress, rpkiRtrCacheServerLocalPort, rpkiRtrCacheServerPreference, rpkiRtrCacheServerConnectionType, rpkiRtrCacheServerConnectionStatus, rpkiRtrCacheServerDescription, rpkiRtrCacheServerMsgsReceived, rpkiRtrCacheServerMsgsSent, rpkiRtrCacheServerV4ActiveRecords, rpkiRtrCacheServerV4Announcements, rpkiRtrCacheServerV4Withdrawals, rpkiRtrCacheServerV6ActiveRecords, rpkiRtrCacheServerV6Announcements, rpkiRtrCacheServerV6Withdrawals, rpkiRtrCacheServerLatestSerial, rpkiRtrCacheServerNonce, rpkiRtrCacheServerRefreshTimer, rpkiRtrCacheServerTimeToRefresh, rpkiRtrCacheServerId } STATUS current DESCRIPTION "The collection of objects to monitor the RPKI peer connections." ::= { rpkiRtrGroups 1 } rpkiRtrCacheServerErrorsGroup OBJECT-GROUP Bush, et al. Expires September 27, 2012 [Page 19] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 OBJECTS { rpkiRtrCacheServerErrorsCorruptData, rpkiRtrCacheServerErrorsInternalError, rpkiRtrCacheServerErrorsNoData, rpkiRtrCacheServerErrorsInvalidRequest, rpkiRtrCacheServerErrorsUnsupportedVersion, rpkiRtrCacheServerErrorsUnsupportedPdu, rpkiRtrCacheServerErrorsWithdrawalUnknown, rpkiRtrCacheServerErrorsDuplicateAnnounce } STATUS current DESCRIPTION "The collection of objects that may help in debugging the communication between rpki clients and cache servers." ::= { rpkiRtrGroups 2 } rpkiRtrPrefixOriginGroup OBJECT-GROUP OBJECTS { rpkiRtrPrefixOriginMaxLength, rpkiRtrPrefixOriginASN, rpkiRtrPrefixOriginCacheServerId } STATUS current DESCRIPTION "The collection of objects that represent the prefix(es) and their validated origin ASes." ::= { rpkiRtrGroups 3 } rpkiRtrNotificationsGroup NOTIFICATION-GROUP NOTIFICATIONS { rpkiRtrCacheServerConnectionStateChange, rpkiRtrCacheServerConnectionToGoStale } STATUS current DESCRIPTION "The set of notifications to alert an NMS of change in connections to RPKI cache servers." ::= { rpkiRtrGroups 4 } END 5. IANA Considerations The MIB module in this document will required an IANA assigned OBJECT IDENTIFIER within the SMI Numbers registry. For example, replacing XXX below: Descriptor OBJECT IDENTIFIER value ---------- ----------------------- Bush, et al. Expires September 27, 2012 [Page 20] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 rpkiRouter { mib-2 XXX } 6. Security Considerations There are no management objects defined in this MIB module that have a MAX-ACCESS clause of read-write and/or read-create. So, if this MIB module is implemented correctly, then there is no risk that an intruder can alter or create any management objects of this MIB module via direct SNMP SET operations. Most of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. They are vulnerable in the sense that when an intruder sees the information in this MIB module, then it might help him/her to setup a an attack on the router or cache server. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 7. References 7.1. Normative References [I-D.ietf-sidr-rpki-rtr] Bush, R. and R. Austein, "The RPKI/Router Protocol", draft-ietf-sidr-rpki-rtr-26 (work in progress), February 2012. Bush, et al. Expires September 27, 2012 [Page 21] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC2287] Krupczak, C. and J. Saperia, "Definitions of System-Level Managed Objects for Applications", RFC 2287, February 1998. [RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual Conventions for Internet Network Addresses", RFC 4001, February 2005. 7.2. Informative References [RFC1982] Elz, R. and R. Bush, "Serial Number Arithmetic", RFC 1982, August 1996. [RFC2385] Heffernan, A., "Protection of BGP Sessions via the TCP MD5 Signature Option", RFC 2385, August 1998. [RFC4252] Ylonen, T. and C. Lonvick, "The Secure Shell (SSH) Authentication Protocol", RFC 4252, January 2006. [RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, August 2008. [RFC5925] Touch, J., Mankin, A., and R. Bonica, "The TCP Authentication Option", RFC 5925, June 2010. Bush, et al. Expires September 27, 2012 [Page 22] Internet-Draft MIB Module for the RPKI-Router Protocol March 2012 Authors' Addresses Randy Bush Internet Initiative Japan 5147 Crystal Springs Bainbridge Island, Washington 98110 US Phone: +1 206 780 0431 x1 Email: randy@psg.com Bert Wijnen RIPE NCC Schagen 33 3461 GL Linschoten Netherlands Email: bertietf@bwijnen.net Keyur Patel Cisco Systems 170 W. Tasman Drive San Jose, CA 95134 USA Email: keyupate@cisco.com Michael Baer SPARTA P.O. Box 72682 Davis, CA 95617 USA Email: michael.baer@sparta.com Bush, et al. Expires September 27, 2012 [Page 23]