Network Working Group S. Perreault Internet-Draft Viagenie Intended status: Standards Track T. Tsou Expires:December 20, 2012January 17, 2013 Huawei Technologies (USA) S. Sivakumar Cisco SystemsJune 18,July 16, 2012 Additional Managed Objects for Network Address Translators (NAT)draft-ietf-behave-nat-mib-01draft-ietf-behave-nat-mib-02 Abstract This memo defines a portion of the Management Information Base (MIB) for devices implementing Network Address Translator (NAT) function. This MIB module may be used for monitoring of a device capable of NAT function. Status of this Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire onDecember 20, 2012.January 17, 2013. Copyright Notice Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.1. Deprecated Features . . . . . . . . . . . . . . . . . . . 3 2.2. New Features . . . . . . . . . . . . . . . . . . . . . . . 4 3. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Security Considerations . . . . . . . . . . . . . . . . . . .2669 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . .2669 6. References . . . . . . . . . . . . . . . . . . . . . . . . . .2669 6.1. Normative References . . . . . . . . . . . . . . . . . . .2669 6.2. Informative References . . . . . . . . . . . . . . . . . .2770 Appendix A. Change Log (to be removed by RFC Editor prior to publication) . . . . . . . . . . . . . . . . . . . .2770 A.1. Changed in -01 . . . . . . . . . . . . . . . . . . . . . .2770 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . .2770 1. Introduction [RFC4008] defines some objects for managing network address translators (NATs). Current operational practice often requires additional objects, in particular for enterprise and Internet service provider (ISP) deployments. This document defines those additional objects. This module is designed to be completely independent from [RFC4008]. A NAT implementation could be managed using this module, the one from [RFC4008], or both. 2. Overview 2.1. Deprecated Features All objects defined in [RFC4008] have been marked with "STATUS deprecated" for the following reasons: Writability: Experience with NAT has shown that implementations vary tremendously. The NAT algorithms and data structures have little in common across devices, and this results in wildly incompatible configuration parameters. Therefore, few implementations were ever able to claim full compliance. Lesson learned: the MIB should be read-only as much as possible. Exposing configuration parameters: Even in read-only mode, many configuration parameters were exposed by [RFC4008] (e.g. timeouts). Since implementations vary wildly in their sets of configuration parameters, few implementations could claim even basic compliance. Lesson learned: the NAT MIB's purpose is not to expose configuration parameters. Interfaces: Objects from [RFC4008] tie NAT state with interfaces (e.g. the interface table, the way map entries are grouped by interface). Many NAT implementations either never keep track of the interface or associate a mapping to a set of interfaces. Since interfaces are at the core of [RFC4008], many NAT devices were unable to have a proper implementation. Lesson learned: NAT is a logical function that may be independent of interfaces. Do not tie NAT state with interfaces. NAT service types: [RFC4008] used four categories of NAT service: basicNat, napt, bidirectionalNat, twiceNat. These are ill-defined and many implementations either use different categories or do not use categories at all. Lesson learned: do not try to categorize NAT types. Limited transport protocol set: The set of transport protocols was defined as: other, icmp, udp, tcp. Furthermore, the numeric values corresponding to those labels were arbitrary, without relation to the actual standard protocol numbers. This meant that NAT implementations were limited to those protocols and were unable to expose information about DCCP, SCTP, etc. Lesson learned: use standard transport protocol numbers. 2.2. New Features New features in this module are as follows: Counters: Many new counters are introduced. Most of them are available in two variants: global and per-transport protocol. Limits: A few limits on the quantity of state data stored by the NAT device. Some of them can trigger notifications. Address+Port Pools: Pools of external addresses and ports are often used in enterprise and ISP settings. Pools are listed in a table, each with its range of addresses and ports. It is possible to inspect each pool's usage, to set limits, and to receive notifications when thresholds are crossed. Address Mappings: NATs that have an "IP address pooling" behavior of "Paired" [RFC4787] maintain a mapping from internal address to external address. This module allows inspection of this mapping table. Mapping table indexed by external 3-tuple: It is often necessary to determine the internal address that is mapped to a given external address and port. This MIB provides this table with an index to accomplish this efficiently, without having to iterate over all mappings.Per-subscriber counters, limits, and notifications: Carrier-Grade NATs operate with a notion of "subscriber", to which are associated a set of counters, limits, and notifications. The subscriber identifier may not necessarily be an internal address, as in the case of DS-Lite, where the identifier is the IPv6 address of the tunnel endpoint and the internal addresses are the same for each subscriber.3. Definitions This MIB module IMPORTs objects from [RFC2578], [RFC2579], and [RFC4001].NEW-NAT-MIBNAT-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE,NOTIFICATION-TYPE, Counter64, Gauge32,Integer32, Unsigned32,mib-2Gauge32, Counter64, TimeTicks, mib-2, NOTIFICATION-TYPE FROM SNMPv2-SMIOBJECT-GROUP,TEXTUAL-CONVENTION, StorageType, RowStatus FROM SNMPv2-TC MODULE-COMPLIANCE, NOTIFICATION-GROUP,MODULE-COMPLIANCEOBJECT-GROUP FROM SNMPv2-CONFTEXTUAL-CONVENTIONifIndex, ifCounterDiscontinuityGroup FROMSNMPv2-TCIF-MIB SnmpAdminString FROM SNMP-FRAMEWORK-MIB InetAddressType, InetAddress,InetAddressPrefixLength,InetPortNumber FROM INET-ADDRESS-MIB;newNatMIBnatMIB MODULE-IDENTITY LAST-UPDATED "200001010000Z" ORGANIZATION "TBD" CONTACT-INFO "TBD" DESCRIPTION "This MIB module defines the generic managed objects for NAT." REVISION "200503210000Z" -- 21th March 2005 DESCRIPTION "Initial version, published as RFC 4008." REVISION "200001010000Z" DESCRIPTION "Dummy version. RFC Editor must replace this." ::= { mib-29999123 }-- table of contents newNatNotificationsnatMIBObjects OBJECT IDENTIFIER ::= {newNatMIB 0natMIB 1 }newNatObjects OBJECT IDENTIFIERNatProtocolType ::= TEXTUAL-CONVENTION STATUS deprecated DESCRIPTION "A list of protocols that support the network address translation. Inclusion of the values is not intended to imply that those protocols need to be supported. Any change in this TEXTUAL-CONVENTION should also be reflected in the definition of NatProtocolMap, which is a BITS representation of this." SYNTAX INTEGER {newNatMIB 1none (1), -- not specified other (2), -- none of the following icmp (3), udp (4), tcp (5) }newNatCounters OBJECT IDENTIFIERNatProtocolMap ::= TEXTUAL-CONVENTION STATUS deprecated DESCRIPTION "A bitmap of protocol identifiers that support the network address translation. Any change in this TEXTUAL-CONVENTION should also be reflected in the definition of NatProtocolType." SYNTAX BITS {newNatObjects 1other (0), icmp (1), udp (2), tcp (3) }newNatLimits OBJECT IDENTIFIERNatAddrMapId ::={ newNatObjects 2 } newNatPoolObjects OBJECT IDENTIFIERTEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS deprecated DESCRIPTION "A unique id that is assigned to each address map by a NAT enabled device." SYNTAX Unsigned32 (1..4294967295) NatBindIdOrZero ::={ newNatObjects 3 } newNatMapObjects OBJECT IDENTIFIERTEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS deprecated DESCRIPTION "A unique id that is assigned to each bind by a NAT enabled device. The bind id will be zero in the case of a Symmetric NAT." SYNTAX Unsigned32 (0..4294967295) NatBindId ::={ newNatObjects 4 } newNatSubscribers OBJECT IDENTIFIERTEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS deprecated DESCRIPTION "A unique id that is assigned to each bind by a NAT enabled device." SYNTAX Unsigned32 (1..4294967295) NatSessionId ::={ newNatObjects 5 } newNatConformance OBJECT IDENTIFIERTEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS deprecated DESCRIPTION "A unique id that is assigned to each session by a NAT enabled device." SYNTAX Unsigned32 (1..4294967295) NatBindMode ::= TEXTUAL-CONVENTION STATUS deprecated DESCRIPTION "An indication of whether the bind is an address bind or an address port bind." SYNTAX INTEGER {newNatMIB 2addressBind (1), addressPortBind (2) }newNatGroups OBJECT IDENTIFIERNatAssociationType ::= TEXTUAL-CONVENTION STATUS deprecated DESCRIPTION "An indication of whether the association is static or dynamic." SYNTAX INTEGER {newNatConformance 1static (1), dynamic (2) }newNatCompliance OBJECT IDENTIFIERNatTranslationEntity ::= TEXTUAL-CONVENTION STATUS deprecated DESCRIPTION "An indication of a) the direction of a session for which an address map entry, address bind or port bind is applicable, and b) the entity (source or destination) within the session that is subject to translation." SYNTAX BITS {newNatConformance 2inboundSrcEndPoint (0), outboundDstEndPoint(1), inboundDstEndPoint (2), outboundSrcEndPoint(3) }-- textual conventionsProtocolNumber ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "A transport protocol number, from the 'protocol-numbers' IANA registry." SYNTAX Unsigned32 (0..255)NatPoolIndexNatPoolId ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "A unique ID that is assigned to each pool." SYNTAX Unsigned32 (1..4294967295) --notifications newNatNotifPoolWatermarkLow NOTIFICATION-TYPE OBJECTS-- Default Values for the Bind and NAT Protocol Timers -- natDefTimeouts OBJECT IDENTIFIER ::= {newNatPoolIndexnatMIBObjects 1 }STATUS current DESCRIPTION "This notification is generated when the specified pool's number of free addresses becomes lower than or equal to the specified threshold. The threshold is specified by the newNatPoolWatermarkLow object"natNotifCtrl OBJECT IDENTIFIER ::= {newNatNotifications 1 } newNatNotifPoolWatermarkHigh NOTIFICATION-TYPE OBJECTS { newNatPoolIndexnatMIBObjects 2 } -- -- Address Bind and Port Bind related NAT configuration -- natBindDefIdleTimeout OBJECT-TYPE SYNTAX Unsigned32 (0..4294967295) UNITS "seconds" MAX-ACCESS read-write STATUScurrentdeprecated DESCRIPTION"This notification is generated when the specified pool's number of free addresses becomes greater than"The default Bind (Address Bind orequal toPort Bind) idle timeout parameter. If thespecified threshold. The thresholdagent isspecified bycapable of storing non-volatile configuration, then thenewNatPoolWatermarkHigh object" ::=value of this object must be restored after a re-initialization of the management system." DEFVAL {newNatNotifications 20 }newNatNotifMappings NOTIFICATION-TYPE OBJECTS::= {newNatCntMappingsnatDefTimeouts 1 } -- -- UDP related NAT configuration -- natUdpDefIdleTimeout OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) UNITS "seconds" MAX-ACCESS read-write STATUScurrentdeprecated DESCRIPTION"This notification"The default UDP idle timeout parameter. If the agent isgenerated when newNatCntMappings exceedscapable of storing non-volatile configuration, then the value ofnewNatMappingsNotifyThreshold." ::=this object must be restored after a re-initialization of the management system." DEFVAL {newNatNotifications 3300 }newNatNotifAddrMappings NOTIFICATION-TYPE OBJECTS::= {newNatCntAddressMappingsnatDefTimeouts 2 } -- -- ICMP related NAT configuration -- natIcmpDefIdleTimeout OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) UNITS "seconds" MAX-ACCESS read-write STATUScurrentdeprecated DESCRIPTION"This notification"The default ICMP idle timeout parameter. If the agent isgenerated when newNatCntAddressMappings exceedscapable of storing non-volatile configuration, then the value ofnewNatAddrMapNotifyThreshold." ::=this object must be restored after a re-initialization of the management system." DEFVAL {newNatNotifications 4300 }newNatNotifSubscriberMappings NOTIFICATION-TYPE OBJECTS::= {newNatSubscriberCntMappingsnatDefTimeouts 3 } -- -- Other protocol parameters -- natOtherDefIdleTimeout OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) UNITS "seconds" MAX-ACCESS read-write STATUScurrentdeprecated DESCRIPTION"This notification"The default idle timeout parameter for protocols represented by the value other (2) in NatProtocolType. If the agent isgenerated when newNatSubscriberCntMappings exceedscapable of storing non-volatile configuration, then the value ofnewNatSubscriberMapNotifyThresh, unless newNatSubscriberMapNotifyThresh is zero.."this object must be restored after a re-initialization of the management system." DEFVAL { 60 } ::= {newNatNotifications 5natDefTimeouts 4 } --counters newNatCntTranslates-- TCP related NAT Timers -- natTcpDefIdleTimeout OBJECT-TYPE SYNTAXCounter64Unsigned32 (1..4294967295) UNITS "seconds" MAX-ACCESSread-onlyread-write STATUScurrentdeprecated DESCRIPTION "Thenumber of packets to whichdefault time interval that a NAThas been applied."session for an established TCP connection is allowed to remain valid without any activity on the TCP connection. If the agent is capable of storing non-volatile configuration, then the value of this object must be restored after a re-initialization of the management system." DEFVAL { 86400 } ::= {newNatCounters 1natDefTimeouts 5 }newNatCntOOPnatTcpDefNegTimeout OBJECT-TYPE SYNTAXCounter64Unsigned32 (1..4294967295) UNITS "seconds" MAX-ACCESSread-onlyread-write STATUScurrentdeprecated DESCRIPTION "Thenumber of packets to whichdefault time interval that a NATcouldsession for a TCP connection that is notbe applied because no external port was available, excluding quota limitations." ::= { newNatCounters 2 } newNatCntResource OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packetsin the established state is allowed towhich NAT could notremain valid without any activity on the TCP connection. If the agent is capable of storing non-volatile configuration, then the value of this object must beapplied becauserestored after a re-initialization ofresource constraints (excluding out-of-ports condition)."the management system." DEFVAL { 60 } ::= {newNatCounters 3natDefTimeouts 6 }newNatCntStateMismatchnatNotifThrottlingInterval OBJECT-TYPE SYNTAXCounter64Integer32 (0 | 5..3600) UNITS "seconds" MAX-ACCESSread-onlyread-write STATUScurrentdeprecated DESCRIPTION"The number"This object controls the generation ofpackets to which NAT could not be applied becausethe natPacketDiscard notification. If this object has a value ofmapping state mismatch. For example,zero, then no natPacketDiscard notifications will be transmitted by the agent. If this object has aTCP packet that matches an existing mapping butnon-zero value, then the agent must not generate more than one natPacketDiscard 'notification-event' in the indicated period, where a 'notification-event' isdropped because its flagsthe generation of a single notification PDU type to a list of notification destinations. If additional NAT packets areincompatible withdiscarded within the throttling period, then notification-events for these changes must be suppressed by the agent until the currentstatethrottling period expires. If natNotifThrottlingInterval notification generation is enabled, the suggested default throttling period is 60 seconds, but generation of themapping would cause this counter tonatPacketDiscard notification should beincremented." ::= { newNatCounters 4 } newNatCntQuota OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The numberdisabled by default. If the agent is capable ofpackets to which NAT could notstoring non-volatile configuration, then the value of this object must beapplied becauserestored after a re-initialization ofquota limitations. Quotas include absolute limits as well as limits on ratethe management system. The actual transmission ofallocation."notifications is controlled via the MIB modules in RFC 3413." DEFVAL { 0 } ::= {newNatCounters 5natNotifCtrl 1 }newNatCntMappings-- -- The NAT Interface Table -- natInterfaceTable OBJECT-TYPE SYNTAXGauge32SEQUENCE OF NatInterfaceEntry MAX-ACCESSread-onlynot-accessible STATUScurrentdeprecated DESCRIPTION"Number of currently active mappings. Equal to newNatCntMapRemovals - newNatCntMapCreations.""This table specifies the attributes for interfaces on a device supporting NAT function." ::= {newNatCounters 6natMIBObjects 3 }newNatCntMapCreationsnatInterfaceEntry OBJECT-TYPE SYNTAXCounter64NatInterfaceEntry MAX-ACCESSread-onlynot-accessible STATUScurrentdeprecated DESCRIPTION"Number of mapping creations. This includes static mappings.""Each entry in the natInterfaceTable holds a set of parameters for an interface, instantiated by ifIndex. Therefore, the interface index must have been assigned, according to the applicable procedures, before it can be meaningfully used. Generally, this means that the interface must exist. When natStorageType is of type nonVolatile, however, this may reflect the configuration for an interface whose ifIndex has been assigned but for which the supporting implementation is not currently present." INDEX { ifIndex } ::= {newNatCounters 7natInterfaceTable 1 } NatInterfaceEntry ::= SEQUENCE { natInterfaceRealm INTEGER, natInterfaceServiceType BITS, natInterfaceInTranslates Counter64, natInterfaceOutTranslates Counter64, natInterfaceDiscards Counter64, natInterfaceStorageType StorageType, natInterfaceRowStatus RowStatus }newNatCntMapRemovalsnatInterfaceRealm OBJECT-TYPE SYNTAXCounter64INTEGER { private (1), public (2) } MAX-ACCESSread-onlyread-create STATUScurrentdeprecated DESCRIPTION"Number of mapping removals. This includes static mappings.""This object identifies whether this interface is connected to the private or the public realm." DEFVAL { public } ::= {newNatCounters 8natInterfaceEntry 1 }newNatCntAddressMappingsnatInterfaceServiceType OBJECT-TYPE SYNTAXGauge32BITS { basicNat (0), napt (1), bidirectionalNat (2), twiceNat (3) } MAX-ACCESSread-onlyread-create STATUScurrentdeprecated DESCRIPTION"Number"An indication ofactive address mappings. Equal to newNatCntAddrMapRemovals - newNatCntAddrMapCreations."the direction in which new sessions are permitted and the extent of translation done within the IP and transport headers." ::= {newNatCounters 9natInterfaceEntry 2 }newNatCntAddrMapCreationsnatInterfaceInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUScurrentdeprecated DESCRIPTION "Number ofaddress mapping creations. This includes static mappings."packets received on this interface that were translated. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= {newNatCounters 10natInterfaceEntry 3 }newNatCntAddrMapRemovalsnatInterfaceOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUScurrentdeprecated DESCRIPTION "Number ofaddress mapping removals. This includes static mappings."translated packets that were sent out this interface. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= {newNatCounters 11natInterfaceEntry 4 }newNatCntProtocolTablenatInterfaceDiscards OBJECT-TYPE SYNTAXSEQUENCE OF NewNatCntProtocolEntryCounter64 MAX-ACCESSnot-accessibleread-only STATUScurrentdeprecated DESCRIPTION"Table"Number ofprotocols with per-protocol counters."packets that had to be rejected/dropped due to a lack of resources for this interface. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= {newNatCounters 128natInterfaceEntry 5 }newNatCntProtocolEntrynatInterfaceStorageType OBJECT-TYPE SYNTAXNewNatCntProtocolEntryStorageType MAX-ACCESSnot-accessibleread-create STATUScurrentdeprecated DESCRIPTION"Per-protocol counters." INDEX"The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row." REFERENCE "Textual Conventions for SMIv2, Section 2." DEFVAL {newNatCntProtocolNumbernonVolatile } ::= {newNatCntProtocolTable 1natInterfaceEntry 6 }NewNatCntProtocolEntry ::= SEQUENCE { newNatCntProtocolNumber ProtocolNumber, newNatCntProtocolTranslates Counter64, newNatCntProtocolOOP Counter64, newNatCntProtocolResource Counter64, newNatCntProtocolStateMismatch Counter64, newNatCntProtocolQuota Counter64, newNatCntProtocolMappings Gauge32, newNatCntProtocolMapCreations Counter64, newNatCntProtocolMapRemovals Counter64 } newNatCntProtocolNumbernatInterfaceRowStatus OBJECT-TYPE SYNTAXProtocolNumberRowStatus MAX-ACCESSnot-accessibleread-create STATUScurrentdeprecated DESCRIPTION"Counters in"The status of this conceptual row. Until instances of all corresponding columns are appropriately configured, the value of the corresponding instance of the natInterfaceRowStatus column is 'notReady'. In particular, a newly created rowapply to packets usingcannot be made active until thetransport protocol identified bycorresponding instance of natInterfaceServiceType has been set. None of the objects in thisobject's value."row may be modified while the value of this object is active(1)." REFERENCE "Textual Conventions for SMIv2, Section 2." ::= {newNatCntProtocolEntry 1natInterfaceEntry 7 }newNatCntProtocolTranslates-- -- The Address Map Table -- natAddrMapTable OBJECT-TYPE SYNTAXCounter64SEQUENCE OF NatAddrMapEntry MAX-ACCESSread-onlynot-accessible STATUScurrentdeprecated DESCRIPTION"The number of packets to which NAT has been applied.""This table lists address map parameters for NAT." ::= {newNatCntProtocolEntry 2natMIBObjects 4 }newNatCntProtocolOOPnatAddrMapEntry OBJECT-TYPE SYNTAXCounter64NatAddrMapEntry MAX-ACCESSread-onlynot-accessible STATUScurrentdeprecated DESCRIPTION"The number of packets"This entry represents an address map towhich NAT could notbeapplied because no external port was available."used for NAT and contributes to the dynamic and/or static address mapping tables of the NAT device." INDEX { ifIndex, natAddrMapIndex } ::= {newNatCntProtocolEntry 3natAddrMapTable 1 }newNatCntProtocolResourceNatAddrMapEntry ::= SEQUENCE { natAddrMapIndex NatAddrMapId, natAddrMapName SnmpAdminString, natAddrMapEntryType NatAssociationType, natAddrMapTranslationEntity NatTranslationEntity, natAddrMapLocalAddrType InetAddressType, natAddrMapLocalAddrFrom InetAddress, natAddrMapLocalAddrTo InetAddress, natAddrMapLocalPortFrom InetPortNumber, natAddrMapLocalPortTo InetPortNumber, natAddrMapGlobalAddrType InetAddressType, natAddrMapGlobalAddrFrom InetAddress, natAddrMapGlobalAddrTo InetAddress, natAddrMapGlobalPortFrom InetPortNumber, natAddrMapGlobalPortTo InetPortNumber, natAddrMapProtocol NatProtocolMap, natAddrMapInTranslates Counter64, natAddrMapOutTranslates Counter64, natAddrMapDiscards Counter64, natAddrMapAddrUsed Gauge32, natAddrMapStorageType StorageType, natAddrMapRowStatus RowStatus } natAddrMapIndex OBJECT-TYPE SYNTAXCounter64NatAddrMapId MAX-ACCESSread-onlynot-accessible STATUScurrentdeprecated DESCRIPTION"The number of packets to which NAT could not be"Along with ifIndex, this object uniquely identifies an entry in the natAddrMapTable. Address map entries are appliedbecause of resource constraints (excluding out-of-ports condition)."in the order specified by natAddrMapIndex." ::= {newNatCntProtocolEntry 4natAddrMapEntry 1 }newNatCntProtocolStateMismatchnatAddrMapName OBJECT-TYPE SYNTAXCounter64SnmpAdminString (SIZE(1..32)) MAX-ACCESSread-onlyread-create STATUScurrentdeprecated DESCRIPTION"The number of packets to which NAT could not be applied because of state"Name identifying all map entries in the tablemismatch. For example, a TCP packet that matches an existing mapping but is dropped because its flags are incompatibleassociated with thecurrent state ofsame interface. All map entries with themapping would cause this counter to be incremented."same ifIndex MUST have the same map name." ::= {newNatCntProtocolEntry 5natAddrMapEntry 2 }newNatCntProtocolQuotanatAddrMapEntryType OBJECT-TYPE SYNTAXCounter64NatAssociationType MAX-ACCESSread-onlyread-create STATUScurrentdeprecated DESCRIPTION"The number of packets"This parameter can be used towhich NAT could not be applied because of exceeded quotas. Quotas include absolute limits as well as limits on rate of allocation."set up static or dynamic address maps." ::= {newNatCntProtocolEntry 6natAddrMapEntry 3 }newNatCntProtocolMappingsnatAddrMapTranslationEntity OBJECT-TYPE SYNTAXGauge32NatTranslationEntity MAX-ACCESSread-onlyread-create STATUScurrentdeprecated DESCRIPTION"Number"The end-point entity (source or destination) in inbound or outbound sessions (i.e., first packets) that may be translated by an address map entry. Session direction (inbound or outbound) is derived from the direction ofactive mappings. Equalthe first packet of a session traversing a NAT interface. NAT address (and Transport-ID) maps may be defined tonewNatCntMapRemovals - newNatCntMapCreations." ::= { newNatCntProtocolEntry 7 } newNatCntProtocolMapCreations OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Numbereffect inbound or outbound sessions. Traditionally, address maps for Basic NAT and NAPT are configured on a public interface for outbound sessions, effecting translation ofmapping creations. This includes static mappings." ::= { newNatCntProtocolEntry 8 } newNatCntProtocolMapRemovals OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Numbersource end-point. The value ofmapping removals. This includes statis mappings."this object must be set to outboundSrcEndPoint for those interfaces. Alternately, if address maps for Basic NAT and NAPT were to be configured on a private interface, the desired value for this object for the map entries would be inboundSrcEndPoint (i.e., effecting translation of source end-point for inbound sessions). If TwiceNAT were to be configured on a private interface, the desired value for this object for the map entries would be a bitmask of inboundSrcEndPoint and inboundDstEndPoint." ::= {newNatCntProtocolEntry 9natAddrMapEntry 4 }-- limits newNatLimitMappingsnatAddrMapLocalAddrType OBJECT-TYPE SYNTAXUnsigned32InetAddressType MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"Global limit on"This object specifies thetotal number of mappings. Zero means unlimited."address type used for natAddrMapLocalAddrFrom and natAddrMapLocalAddrTo." ::= {newNatLimits 1natAddrMapEntry 5 }-- TODO: How does that work with bulk port allocation? newNatMappingsNotifyThresholdnatAddrMapLocalAddrFrom OBJECT-TYPE SYNTAXUnsigned32InetAddress MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"See newNatNotifMappings.""This object specifies the first IP address of the range of IP addresses mapped by this translation entry. The value of this object must be less than or equal to the value of the natAddrMapLocalAddrTo object. The type of this address is determined by the value of the natAddrMapLocalAddrType object." ::= {newNatLimits 2natAddrMapEntry 6 }newNatLimitAddressMappingsnatAddrMapLocalAddrTo OBJECT-TYPE SYNTAXUnsigned32InetAddress MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"Global limit on"This object specifies thetotal number of internal-to-externallast IP addressmappings. Zero means unlimited. This limit isof the range of IP addresses mapped by this translation entry. If onlyapplicablea single address is being mapped, the value of this object is equal toNATs that have an 'IPthe value of natAddrMapLocalAddrFrom. For a static NAT, the number of addresses in the range defined by natAddrMapLocalAddrFrom and natAddrMapLocalAddrTo must be equal to the number of addresses in the range defined by natAddrMapGlobalAddrFrom and natAddrMapGlobalAddrTo. The value of this object must be greater than or equal to the value of the natAddrMapLocalAddrFrom object. The type of this addresspooling' behavioris determined by the value of'Paired' [RFC4787]."the natAddrMapLocalAddrType object." ::= {newNatLimits 3natAddrMapEntry 7 }newNatAddrMapNotifyThresholdnatAddrMapLocalPortFrom OBJECT-TYPE SYNTAXUnsigned32InetPortNumber MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"See newNatNotifAddrMappings.""If this conceptual row describes a Basic NAT address mapping, then the value of this object must be zero. If this conceptual row describes NAPT, then the value of this object specifies the first port number in the range of ports being mapped. The value of this object must be less than or equal to the value of the natAddrMapLocalPortTo object. If the translation specifies a single port, then the value of this object is equal to the value of natAddrMapLocalPortTo." DEFVAL { 0 } ::= {newNatLimits 4natAddrMapEntry 8 }newNatLimitFragmentsnatAddrMapLocalPortTo OBJECT-TYPE SYNTAXUnsigned32InetPortNumber MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"Global limit on"If this conceptual row describes a Basic NAT address mapping, then thetotalvalue of this object must be zero. If this conceptual row describes NAPT, then the value of this object specifies the last port number in the range offragments pending reassembly. Zero means unlimited. This limitports being mapped. The value of this object must be greater than or equal to the value of the natAddrMapLocalPortFrom object. If the translation specifies a single port, then the value of this object isonly applicableequal toNATs having 'Receive Fragments Outthe value ofOrder' behavior [RFC4787]."natAddrMapLocalPortFrom." DEFVAL { 0 } ::= {newNatLimits 5natAddrMapEntry 9 }newNatLimitSubscribersnatAddrMapGlobalAddrType OBJECT-TYPE SYNTAXUnsigned32InetAddressType MAX-ACCESSread-writeread-create STATUScurrentdeprecated DESCRIPTION"Global limit on"This object specifies thenumber of subscribers with active mappings. Zero means unlimited."address type used for natAddrMapGlobalAddrFrom and natAddrMapGlobalAddrTo." ::= {newNatLimits 6natAddrMapEntry 10 }-- pools newNatPoolTablenatAddrMapGlobalAddrFrom OBJECT-TYPE SYNTAXSEQUENCE OF NewNatPoolEntryInetAddress MAX-ACCESSnot-accessibleread-create STATUScurrentdeprecated DESCRIPTION"Table"This object specifies the first IP address ofpools."the range of IP addresses being mapped to. The value of this object must be less than or equal to the value of the natAddrMapGlobalAddrTo object. The type of this address is determined by the value of the natAddrMapGlobalAddrType object." ::= { natAddrMapEntry 11 } natAddrMapGlobalAddrTo OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS deprecated DESCRIPTION "This object specifies the last IP address of the range of IP addresses being mapped to. If only a single address is being mapped to, the value of this object is equal to the value of natAddrMapGlobalAddrFrom. For a static NAT, the number of addresses in the range defined by natAddrMapGlobalAddrFrom and natAddrMapGlobalAddrTo must be equal to the number of addresses in the range defined by natAddrMapLocalAddrFrom and natAddrMapLocalAddrTo. The value of this object must be greater than or equal to the value of the natAddrMapGlobalAddrFrom object. The type of this address is determined by the value of the natAddrMapGlobalAddrType object." ::= { natAddrMapEntry 12 } natAddrMapGlobalPortFrom OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS deprecated DESCRIPTION "If this conceptual row describes a Basic NAT address mapping, then the value of this object must be zero. If this conceptual row describes NAPT, then the value of this object specifies the first port number in the range of ports being mapped to. The value of this object must be less than or equal to the value of the natAddrMapGlobalPortTo object. If the translation specifies a single port, then the value of this object is equal to the value natAddrMapGlobalPortTo." DEFVAL { 0 } ::= { natAddrMapEntry 13 } natAddrMapGlobalPortTo OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS deprecated DESCRIPTION "If this conceptual row describes a Basic NAT address mapping, then the value of this object must be zero. If this conceptual row describes NAPT, then the value of this object specifies the last port number in the range of ports being mapped to. The value of this object must be greater than or equal to the value of the natAddrMapGlobalPortFrom object. If the translation specifies a single port, then the value of this object is equal to the value of natAddrMapGlobalPortFrom." DEFVAL { 0 } ::= { natAddrMapEntry 14 } natAddrMapProtocol OBJECT-TYPE SYNTAX NatProtocolMap MAX-ACCESS read-create STATUS deprecated DESCRIPTION "This object specifies a bitmap of protocol identifiers." ::= { natAddrMapEntry 15 } natAddrMapInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of inbound packets pertaining to this address map entry that were translated. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrMapEntry 16 } natAddrMapOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of outbound packets pertaining to this address map entry that were translated. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrMapEntry 17 } natAddrMapDiscards OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of packets pertaining to this address map entry that were dropped due to lack of addresses in the address pool identified by this address map. The value of this object must always be zero in case of static address map. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrMapEntry 18 } natAddrMapAddrUsed OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of addresses pertaining to this address map that are currently being used from the NAT pool. The value of this object must always be zero in the case of a static address map." ::= { natAddrMapEntry 19 } natAddrMapStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS deprecated DESCRIPTION "The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row." REFERENCE "Textual Conventions for SMIv2, Section 2." DEFVAL { nonVolatile } ::= { natAddrMapEntry 20 } natAddrMapRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS deprecated DESCRIPTION "The status of this conceptual row. Until instances of all corresponding columns are appropriately configured, the value of the corresponding instance of the natAddrMapRowStatus column is 'notReady'. None of the objects in this row may be modified while the value of this object is active(1)." REFERENCE "Textual Conventions for SMIv2, Section 2." ::= { natAddrMapEntry 21 } -- -- Address Bind section -- natAddrBindNumberOfEntries OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object maintains a count of the number of entries that currently exist in the natAddrBindTable." ::= { natMIBObjects 5 } -- -- The NAT Address BIND Table -- natAddrBindTable OBJECT-TYPE SYNTAX SEQUENCE OF NatAddrBindEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This table holds information about the currently active NAT BINDs." ::= { natMIBObjects 6 } natAddrBindEntry OBJECT-TYPE SYNTAX NatAddrBindEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "Each entry in this table holds information about an active address BIND. These entries are lost upon agent restart. This row has indexing which may create variables with more than 128 subidentifiers. Implementers of this table must be careful not to create entries that would result in OIDs which exceed the 128 subidentifier limit. Otherwise, the information cannot be accessed using SNMPv1, SNMPv2c or SNMPv3." INDEX { ifIndex, natAddrBindLocalAddrType, natAddrBindLocalAddr } ::= { natAddrBindTable 1 } NatAddrBindEntry ::= SEQUENCE { natAddrBindLocalAddrType InetAddressType, natAddrBindLocalAddr InetAddress, natAddrBindGlobalAddrType InetAddressType, natAddrBindGlobalAddr InetAddress, natAddrBindId NatBindId, natAddrBindTranslationEntity NatTranslationEntity, natAddrBindType NatAssociationType, natAddrBindMapIndex NatAddrMapId, natAddrBindSessions Gauge32, natAddrBindMaxIdleTime TimeTicks, natAddrBindCurrentIdleTime TimeTicks, natAddrBindInTranslates Counter64, natAddrBindOutTranslates Counter64 } natAddrBindLocalAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object specifies the address type used for natAddrBindLocalAddr." ::= { natAddrBindEntry 1 } natAddrBindLocalAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object represents the private-realm specific network layer address, which maps to the public-realm address represented by natAddrBindGlobalAddr. The type of this address is determined by the value of the natAddrBindLocalAddrType object." ::= { natAddrBindEntry 2 } natAddrBindGlobalAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object specifies the address type used for natAddrBindGlobalAddr." ::= { natAddrBindEntry 3 } natAddrBindGlobalAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents the public-realm network layer address that maps to the private-realm network layer address represented by natAddrBindLocalAddr. The type of this address is determined by the value of the natAddrBindGlobalAddrType object." ::= { natAddrBindEntry 4 } natAddrBindId OBJECT-TYPE SYNTAX NatBindId MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents a bind id that is dynamically assigned to each bind by a NAT enabled device. Each bind is represented by a bind id that is unique across both, the natAddrBindTable and the natAddrPortBindTable." ::= { natAddrBindEntry 5 } natAddrBindTranslationEntity OBJECT-TYPE SYNTAX NatTranslationEntity MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents the direction of sessions for which this bind is applicable and the endpoint entity (source or destination) within the sessions that is subject to translation using the BIND. Orientation of the bind can be a superset of translationEntity of the address map entry which forms the basis for this bind. For example, if the translationEntity of an address map entry is outboundSrcEndPoint, the translationEntity of a bind derived from this map entry may either be outboundSrcEndPoint or it may be bidirectional (a bitmask of outboundSrcEndPoint and inboundDstEndPoint)." ::= { natAddrBindEntry 6 } natAddrBindType OBJECT-TYPE SYNTAX NatAssociationType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates whether the bind is static or dynamic." ::= { natAddrBindEntry 7 } natAddrBindMapIndex OBJECT-TYPE SYNTAX NatAddrMapId MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object is a pointer to the natAddrMapTable entry (and the parameters of that entry) which was used in creating this BIND. This object, in conjunction with the ifIndex (which identifies a unique addrMapName) points to a unique entry in the natAddrMapTable." ::= { natAddrBindEntry 8 } natAddrBindSessions OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "Number of sessions currently using this BIND." ::= { natAddrBindEntry 9 } natAddrBindMaxIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates the maximum time for which this bind can be idle with no sessions attached to it. The value of this object is of relevance only for dynamic NAT." ::= { natAddrBindEntry 10 } natAddrBindCurrentIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "At any given instance, this object indicates the time that this bind has been idle without any sessions attached to it. The value of this object is of relevance only for dynamic NAT." ::= { natAddrBindEntry 11 } natAddrBindInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of inbound packets that were successfully translated by using this bind entry. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrBindEntry 12 } natAddrBindOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of outbound packets that were successfully translated using this bind entry. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrBindEntry 13 } -- -- Address Port Bind section -- natAddrPortBindNumberOfEntries OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object maintains a count of the number of entries that currently exist in the natAddrPortBindTable." ::= { natMIBObjects 7 } -- -- The NAT Address Port Bind Table -- natAddrPortBindTable OBJECT-TYPE SYNTAX SEQUENCE OF NatAddrPortBindEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This table holds information about the currently active NAPT BINDs." ::= { natMIBObjects 8 } natAddrPortBindEntry OBJECT-TYPE SYNTAX NatAddrPortBindEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "Each entry in the this table holds information about a NAPT bind that is currently active. These entries are lost upon agent restart. This row has indexing which may create variables with more than 128 subidentifiers. Implementers of this table must be careful not to create entries which would result in OIDs that exceed the 128 subidentifier limit. Otherwise, the information cannot be accessed using SNMPv1, SNMPv2c or SNMPv3." INDEX { ifIndex, natAddrPortBindLocalAddrType, natAddrPortBindLocalAddr, natAddrPortBindLocalPort, natAddrPortBindProtocol } ::= { natAddrPortBindTable 1 } NatAddrPortBindEntry ::= SEQUENCE { natAddrPortBindLocalAddrType InetAddressType, natAddrPortBindLocalAddr InetAddress, natAddrPortBindLocalPort InetPortNumber, natAddrPortBindProtocol NatProtocolType, natAddrPortBindGlobalAddrType InetAddressType, natAddrPortBindGlobalAddr InetAddress, natAddrPortBindGlobalPort InetPortNumber, natAddrPortBindId NatBindId, natAddrPortBindTranslationEntity NatTranslationEntity, natAddrPortBindType NatAssociationType, natAddrPortBindMapIndex NatAddrMapId, natAddrPortBindSessions Gauge32, natAddrPortBindMaxIdleTime TimeTicks, natAddrPortBindCurrentIdleTime TimeTicks, natAddrPortBindInTranslates Counter64, natAddrPortBindOutTranslates Counter64 } natAddrPortBindLocalAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object specifies the address type used for natAddrPortBindLocalAddr." ::= { natAddrPortBindEntry 1 } natAddrPortBindLocalAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object represents the private-realm specific network layer address which, in conjunction with natAddrPortBindLocalPort, maps to the public-realm network layer address and transport id represented by natAddrPortBindGlobalAddr and natAddrPortBindGlobalPort respectively. The type of this address is determined by the value of the natAddrPortBindLocalAddrType object." ::= { natAddrPortBindEntry 2 } natAddrPortBindLocalPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "For a protocol value TCP or UDP, this object represents the private-realm specific port number. On the other hand, for ICMP a bind is created only for query/response type ICMP messages such as ICMP echo, Timestamp, and Information request messages, and this object represents the private-realm specific identifier in the ICMP message, as defined in RFC 792 for ICMPv4 and in RFC 2463 for ICMPv6. This object, together with natAddrPortBindProtocol, natAddrPortBindLocalAddrType, and natAddrPortBindLocalAddr, constitutes a session endpoint in the private realm. A bind entry binds a private realm specific endpoint to a public realm specific endpoint, as represented by the tuple of (natAddrPortBindGlobalPort, natAddrPortBindProtocol, natAddrPortBindGlobalAddrType, and natAddrPortBindGlobalAddr)." ::= { natAddrPortBindEntry 3 } natAddrPortBindProtocol OBJECT-TYPE SYNTAX NatProtocolType MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object specifies a protocol identifier. If the value of this object is none(1), then this bind entry applies to all IP traffic. Any other value of this object specifies the class of IP traffic to which this BIND applies." ::= { natAddrPortBindEntry 4 } natAddrPortBindGlobalAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object specifies the address type used for natAddrPortBindGlobalAddr." ::= { natAddrPortBindEntry 5 } natAddrPortBindGlobalAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents the public-realm specific network layer address that, in conjunction with natAddrPortBindGlobalPort, maps to the private-realm network layer address and transport id represented by natAddrPortBindLocalAddr and natAddrPortBindLocalPort, respectively. The type of this address is determined by the value of the natAddrPortBindGlobalAddrType object." ::= { natAddrPortBindEntry 6 } natAddrPortBindGlobalPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS deprecated DESCRIPTION "For a protocol value TCP or UDP, this object represents the public-realm specific port number. On the other hand, for ICMP a bind is created only for query/response type ICMP messages such as ICMP echo, Timestamp, and Information request messages, and this object represents the public-realm specific identifier in the ICMP message, as defined in RFC 792 for ICMPv4 and in RFC 2463 for ICMPv6. This object, together with natAddrPortBindProtocol, natAddrPortBindGlobalAddrType, and natAddrPortBindGlobalAddr, constitutes a session endpoint in the public realm. A bind entry binds a public realm specific endpoint to a private realm specific endpoint, as represented by the tuple of (natAddrPortBindLocalPort, natAddrPortBindProtocol, natAddrPortBindLocalAddrType, and natAddrPortBindLocalAddr)." ::= { natAddrPortBindEntry 7 } natAddrPortBindId OBJECT-TYPE SYNTAX NatBindId MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents a bind id that is dynamically assigned to each bind by a NAT enabled device. Each bind is represented by a unique bind id across both the natAddrBindTable and the natAddrPortBindTable." ::= { natAddrPortBindEntry 8 } natAddrPortBindTranslationEntity OBJECT-TYPE SYNTAX NatTranslationEntity MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object represents the direction of sessions for which this bind is applicable and the entity (source or destination) within the sessions that is subject to translation with the BIND. Orientation of the bind can be a superset of the translationEntity of the address map entry that forms the basis for this bind. For example, if the translationEntity of an address map entry is outboundSrcEndPoint, the translationEntity of a bind derived from this map entry may either be outboundSrcEndPoint or may be bidirectional (a bitmask of outboundSrcEndPoint and inboundDstEndPoint)." ::= { natAddrPortBindEntry 9 } natAddrPortBindType OBJECT-TYPE SYNTAX NatAssociationType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates whether the bind is static or dynamic." ::= { natAddrPortBindEntry 10 } natAddrPortBindMapIndex OBJECT-TYPE SYNTAX NatAddrMapId MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object is a pointer to the natAddrMapTable entry (and the parameters of that entry) used in creating this BIND. This object, in conjunction with the ifIndex (which identifies a unique addrMapName), points to a unique entry in the natAddrMapTable." ::= { natAddrPortBindEntry 11 } natAddrPortBindSessions OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "Number of sessions currently using this BIND." ::= { natAddrPortBindEntry 12 } natAddrPortBindMaxIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates the maximum time for which this bind can be idle without any sessions attached to it. The value of this object is of relevance only for dynamic NAT." ::= { natAddrPortBindEntry 13 } natAddrPortBindCurrentIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "At any given instance, this object indicates the time that this bind has been idle without any sessions attached to it. The value of this object is of relevance only for dynamic NAT." ::= { natAddrPortBindEntry 14 } natAddrPortBindInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of inbound packets that were translated as per this bind entry. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrPortBindEntry 15 } natAddrPortBindOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of outbound packets that were translated as per this bind entry. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natAddrPortBindEntry 16 } -- -- The Session Table -- natSessionTable OBJECT-TYPE SYNTAX SEQUENCE OF NatSessionEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "The (conceptual) table containing one entry for each NAT session currently active on this NAT device." ::= { natMIBObjects 9 } natSessionEntry OBJECT-TYPE SYNTAX NatSessionEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "An entry (conceptual row) containing information about an active NAT session on this NAT device. These entries are lost upon agent restart." INDEX { ifIndex, natSessionIndex } ::= { natSessionTable 1 } NatSessionEntry ::= SEQUENCE { natSessionIndex NatSessionId, natSessionPrivateSrcEPBindId NatBindIdOrZero, natSessionPrivateSrcEPBindMode NatBindMode, natSessionPrivateDstEPBindId NatBindIdOrZero, natSessionPrivateDstEPBindMode NatBindMode, natSessionDirection INTEGER, natSessionUpTime TimeTicks, natSessionAddrMapIndex NatAddrMapId, natSessionProtocolType NatProtocolType, natSessionPrivateAddrType InetAddressType, natSessionPrivateSrcAddr InetAddress, natSessionPrivateSrcPort InetPortNumber, natSessionPrivateDstAddr InetAddress, natSessionPrivateDstPort InetPortNumber, natSessionPublicAddrType InetAddressType, natSessionPublicSrcAddr InetAddress, natSessionPublicSrcPort InetPortNumber, natSessionPublicDstAddr InetAddress, natSessionPublicDstPort InetPortNumber, natSessionMaxIdleTime TimeTicks, natSessionCurrentIdleTime TimeTicks, natSessionInTranslates Counter64, natSessionOutTranslates Counter64 } natSessionIndex OBJECT-TYPE SYNTAX NatSessionId MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "The session ID for this NAT session." ::= { natSessionEntry 1 } natSessionPrivateSrcEPBindId OBJECT-TYPE SYNTAX NatBindIdOrZero MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The bind id associated between private and public source end points. In the case of Symmetric-NAT, this should be set to zero." ::= { natSessionEntry 2 } natSessionPrivateSrcEPBindMode OBJECT-TYPE SYNTAX NatBindMode MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates whether the bind indicated by the object natSessionPrivateSrcEPBindId is an address bind or an address port bind." ::= { natSessionEntry 3 } natSessionPrivateDstEPBindId OBJECT-TYPE SYNTAX NatBindIdOrZero MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The bind id associated between private and public destination end points." ::= { natSessionEntry 4 } natSessionPrivateDstEPBindMode OBJECT-TYPE SYNTAX NatBindMode MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object indicates whether the bind indicated by the object natSessionPrivateDstEPBindId is an address bind or an address port bind." ::= { natSessionEntry 5 } natSessionDirection OBJECT-TYPE SYNTAX INTEGER { inbound (1), outbound (2) } MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The direction of this session with respect to the local network. 'inbound' indicates that this session was initiated from the public network into the private network. 'outbound' indicates that this session was initiated from the private network into the public network." ::= { natSessionEntry 6 } natSessionUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The up time of this session in one-hundredths of a second." ::= { natSessionEntry 7 } natSessionAddrMapIndex OBJECT-TYPE SYNTAX NatAddrMapId MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object is a pointer to the natAddrMapTable entry (and the parameters of that entry) used in creating this session. This object, in conjunction with the ifIndex (which identifies a unique addrMapName), points to a unique entry in the natAddrMapTable." ::= { natSessionEntry 8 } natSessionProtocolType OBJECT-TYPE SYNTAX NatProtocolType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The protocol type of this session." ::= { natSessionEntry 9 } natSessionPrivateAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object specifies the address type used for natSessionPrivateSrcAddr and natSessionPrivateDstAddr." ::= { natSessionEntry 10 } natSessionPrivateSrcAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The source IP address of the session endpoint that lies in the private network. The value of this object must be zero only when the natSessionPrivateSrcEPBindId object has a zero value. When the value of this object is zero, the NAT session lookup will match any IP address to this field. The type of this address is determined by the value of the natSessionPrivateAddrType object." ::= { natSessionEntry 11 } natSessionPrivateSrcPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS deprecated DESCRIPTION "When the value of protocol is TCP or UDP, this object represents the source port in the first packet of session while in private-realm. On the other hand, when the protocol is ICMP, a NAT session is created only for query/response type ICMP messages such as ICMP echo, Timestamp, and Information request messages, and this object represents the private-realm specific identifier in the ICMP message, as defined in RFC 792 for ICMPv4 and in RFC 2463 for ICMPv6. The value of this object must be zero when the natSessionPrivateSrcEPBindId object has zero value and value of natSessionPrivateSrcEPBindMode is addressPortBind(2). In such a case, the NAT session lookup will match any port number to this field. The value of this object must be zero when the object is not a representative field (SrcPort, DstPort, or ICMP identifier) of the session tuple in either the public realm or the private realm." ::= { natSessionEntry 12 } natSessionPrivateDstAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The destination IP address of the session endpoint that lies in the private network. The value of this object must be zero when the natSessionPrivateDstEPBindId object has a zero value. In such a scenario, the NAT session lookup will match any IP address to this field. The type of this address is determined by the value of the natSessionPrivateAddrType object." ::= { natSessionEntry 13 } natSessionPrivateDstPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS deprecated DESCRIPTION "When the value of protocol is TCP or UDP, this object represents the destination port in the first packet of session while in private-realm. On the other hand, when the protocol is ICMP, this object is not relevant and should be set to zero. The value of this object must be zero when the natSessionPrivateDstEPBindId object has a zero value and natSessionPrivateDstEPBindMode is set to addressPortBind(2). In such a case, the NAT session lookup will match any port number to this field. The value of this object must be zero when the object is not a representative field (SrcPort, DstPort, or ICMP identifier) of the session tuple in either the public realm or the private realm." ::= { natSessionEntry 14 } natSessionPublicAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS deprecated DESCRIPTION "This object specifies the address type used for natSessionPublicSrcAddr and natSessionPublicDstAddr." ::= { natSessionEntry 15 } natSessionPublicSrcAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The source IP address of the session endpoint that lies in the public network. The value of this object must be zero when the natSessionPrivateSrcEPBindId object has a zero value. In such a scenario, the NAT session lookup will match any IP address to this field. The type of this address is determined by the value of the natSessionPublicAddrType object." ::= { natSessionEntry 16 } natSessionPublicSrcPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS deprecated DESCRIPTION "When the value of protocol is TCP or UDP, this object represents the source port in the first packet of session while in public-realm. On the other hand, when protocol is ICMP, a NAT session is created only for query/response type ICMP messages such as ICMP echo, Timestamp, and Information request messages, and this object represents the public-realm specific identifier in the ICMP message, as defined in RFC 792 for ICMPv4 and in RFC 2463 for ICMPv6. The value of this object must be zero when the natSessionPrivateSrcEPBindId object has a zero value and natSessionPrivateSrcEPBindMode is set to addressPortBind(2). In such a scenario, the NAT session lookup will match any port number to this field. The value of this object must be zero when the object is not a representative field (SrcPort, DstPort or ICMP identifier) of the session tuple in either the public realm or the private realm." ::= { natSessionEntry 17 } natSessionPublicDstAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The destination IP address of the session endpoint that lies in the public network. The value of this object must be non-zero when the natSessionPrivateDstEPBindId object has a non-zero value. If the value of this object and the corresponding natSessionPrivateDstEPBindId object value is zero, then the NAT session lookup will match any IP address to this field. The type of this address is determined by the value of the natSessionPublicAddrType object." ::= { natSessionEntry 18 } natSessionPublicDstPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS deprecated DESCRIPTION "When the value of protocol is TCP or UDP, this object represents the destination port in the first packet of session while in public-realm. On the other hand, when the protocol is ICMP, this object is not relevant for translation and should be zero. The value of this object must be zero when the natSessionPrivateDstEPBindId object has a zero value and natSessionPrivateDstEPBindMode is addressPortBind(2). In such a scenario, the NAT session lookup will match any port number to this field. The value of this object must be zero when the object is not a representative field (SrcPort, DstPort, or ICMP identifier) of the session tuple in either the public realm or the private realm." ::= { natSessionEntry 19 } natSessionMaxIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The max time for which this session can be idle without detecting a packet." ::= { natSessionEntry 20 } natSessionCurrentIdleTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The time since a packet belonging to this session was last detected." ::= { natSessionEntry 21 } natSessionInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of inbound packets that were translated for this session. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natSessionEntry 22 } natSessionOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of outbound packets that were translated for this session. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natSessionEntry 23 } -- -- The Protocol table -- natProtocolTable OBJECT-TYPE SYNTAX SEQUENCE OF NatProtocolEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "The (conceptual) table containing per protocol NAT statistics." ::= { natMIBObjects 10 } natProtocolEntry OBJECT-TYPE SYNTAX NatProtocolEntry MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "An entry (conceptual row) containing NAT statistics pertaining to a particular protocol." INDEX { natProtocol } ::= { natProtocolTable 1 } NatProtocolEntry ::= SEQUENCE { natProtocol NatProtocolType, natProtocolInTranslates Counter64, natProtocolOutTranslates Counter64, natProtocolDiscards Counter64 } natProtocol OBJECT-TYPE SYNTAX NatProtocolType MAX-ACCESS not-accessible STATUS deprecated DESCRIPTION "This object represents the protocol pertaining to which parameters are reported." ::= { natProtocolEntry 1 } natProtocolInTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of inbound packets pertaining to the protocol identified by natProtocol that underwent NAT. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natProtocolEntry 2 } natProtocolOutTranslates OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of outbound packets pertaining to the protocol identified by natProtocol that underwent NAT. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natProtocolEntry 3 } natProtocolDiscards OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS deprecated DESCRIPTION "The number of packets pertaining to the protocol identified by natProtocol that had to be rejected/dropped due to lack of resources. These rejections could be due to session timeout, resource unavailability, lack of address space, etc. Discontinuities in the value of this counter can occur at reinitialization of the management system and at other times, as indicated by the value of ifCounterDiscontinuityTime on the relevant interface." ::= { natProtocolEntry 4 } -- -- Notifications section -- natMIBNotifications OBJECT IDENTIFIER ::= { natMIB 0 } -- -- Notifications -- natPacketDiscard NOTIFICATION-TYPE OBJECTS { ifIndex } STATUS deprecated DESCRIPTION "This notification is generated when IP packets are discarded by the NAT function; e.g., due to lack of mapping space when NAT is out of addresses or ports. Note that the generation of natPacketDiscard notifications is throttled by the agent, as specified by the 'natNotifThrottlingInterval' object." ::= { natMIBNotifications 1 } natNotifPoolWatermarkLow NOTIFICATION-TYPE OBJECTS { natPoolIndex } STATUS current DESCRIPTION "This notification is generated when the specified pool's number of free addresses becomes lower than or equal to the specified threshold. The threshold is specified by the natPoolWatermarkLow object" ::= { natMIBNotifications 2 } natNotifPoolWatermarkHigh NOTIFICATION-TYPE OBJECTS { natPoolIndex } STATUS current DESCRIPTION "This notification is generated when the specified pool's number of free addresses becomes greater than or equal to the specified threshold. The threshold is specified by the natPoolWatermarkHigh object" ::= { natMIBNotifications 3 } natNotifMappings NOTIFICATION-TYPE OBJECTS { natCntMappings } STATUS current DESCRIPTION "This notification is generated when natCntMappings exceeds the value of natMappingsNotifyThreshold." ::= { natMIBNotifications 4 } natNotifAddrMappings NOTIFICATION-TYPE OBJECTS { natCntAddressMappings } STATUS current DESCRIPTION "This notification is generated when natCntAddressMappings exceeds the value of natAddrMapNotifyThreshold." ::= { natMIBNotifications 5 } -- -- Conformance information. -- natMIBConformance OBJECT IDENTIFIER ::= { natMIB 2 } natMIBGroups OBJECT IDENTIFIER ::= { natMIBConformance 1 } natMIBCompliances OBJECT IDENTIFIER ::= { natMIBConformance 2 } -- -- Units of conformance -- natConfigGroup OBJECT-GROUP OBJECTS { natInterfaceRealm, natInterfaceServiceType, natInterfaceStorageType, natInterfaceRowStatus, natAddrMapName, natAddrMapEntryType, natAddrMapTranslationEntity, natAddrMapLocalAddrType, natAddrMapLocalAddrFrom, natAddrMapLocalAddrTo, natAddrMapLocalPortFrom, natAddrMapLocalPortTo, natAddrMapGlobalAddrType, natAddrMapGlobalAddrFrom, natAddrMapGlobalAddrTo, natAddrMapGlobalPortFrom, natAddrMapGlobalPortTo, natAddrMapProtocol, natAddrMapStorageType, natAddrMapRowStatus, natBindDefIdleTimeout, natUdpDefIdleTimeout, natIcmpDefIdleTimeout, natOtherDefIdleTimeout, natTcpDefIdleTimeout, natTcpDefNegTimeout, natNotifThrottlingInterval } STATUS deprecated DESCRIPTION "A collection of configuration-related information required to support management of devices supporting NAT." ::= { natMIBGroups 1 } natTranslationGroup OBJECT-GROUP OBJECTS { natAddrBindNumberOfEntries, natAddrBindGlobalAddrType, natAddrBindGlobalAddr, natAddrBindId, natAddrBindTranslationEntity, natAddrBindType, natAddrBindMapIndex, natAddrBindSessions, natAddrBindMaxIdleTime, natAddrBindCurrentIdleTime, natAddrBindInTranslates, natAddrBindOutTranslates, natAddrPortBindNumberOfEntries, natAddrPortBindGlobalAddrType, natAddrPortBindGlobalAddr, natAddrPortBindGlobalPort, natAddrPortBindId, natAddrPortBindTranslationEntity, natAddrPortBindType, natAddrPortBindMapIndex, natAddrPortBindSessions, natAddrPortBindMaxIdleTime, natAddrPortBindCurrentIdleTime, natAddrPortBindInTranslates, natAddrPortBindOutTranslates, natSessionPrivateSrcEPBindId, natSessionPrivateSrcEPBindMode, natSessionPrivateDstEPBindId, natSessionPrivateDstEPBindMode, natSessionDirection, natSessionUpTime, natSessionAddrMapIndex, natSessionProtocolType, natSessionPrivateAddrType, natSessionPrivateSrcAddr, natSessionPrivateSrcPort, natSessionPrivateDstAddr, natSessionPrivateDstPort, natSessionPublicAddrType, natSessionPublicSrcAddr, natSessionPublicSrcPort, natSessionPublicDstAddr, natSessionPublicDstPort, natSessionMaxIdleTime, natSessionCurrentIdleTime, natSessionInTranslates, natSessionOutTranslates } STATUS deprecated DESCRIPTION "A collection of BIND-related objects required to support management of devices supporting NAT." ::= { natMIBGroups 2 } natStatsInterfaceGroup OBJECT-GROUP OBJECTS { natInterfaceInTranslates, natInterfaceOutTranslates, natInterfaceDiscards } STATUS deprecated DESCRIPTION "A collection of NAT statistics associated with the interface on which NAT is configured, to aid troubleshooting/monitoring of the NAT operation." ::= { natMIBGroups 3 } natStatsProtocolGroup OBJECT-GROUP OBJECTS { natProtocolInTranslates, natProtocolOutTranslates, natProtocolDiscards } STATUS deprecated DESCRIPTION "A collection of protocol specific NAT statistics, to aid troubleshooting/monitoring of NAT operation." ::= { natMIBGroups 4 } natStatsAddrMapGroup OBJECT-GROUP OBJECTS { natAddrMapInTranslates, natAddrMapOutTranslates, natAddrMapDiscards, natAddrMapAddrUsed } STATUS deprecated DESCRIPTION "A collection of address map specific NAT statistics, to aid troubleshooting/monitoring of NAT operation." ::= { natMIBGroups 5 } natMIBNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { natPacketDiscard } STATUS deprecated DESCRIPTION "A collection of notifications generated by devices supporting this MIB." ::= { natMIBGroups 6 } natGroupBasicObjects OBJECT-GROUP OBJECTS { natCntTranslates, natCntOOP, natCntResource, natCntStateMismatch, natCntQuota, natCntMappings, natCntMapCreations, natCntMapRemovals, natCntProtocolTranslates, natCntProtocolOOP, natCntProtocolResource, natCntProtocolStateMismatch, natCntProtocolQuota, natCntProtocolMappings, natCntProtocolMapCreations, natCntProtocolMapRemovals, natLimitMappings, natMappingsNotifyThreshold, natPoolIndex, natPoolUsage, natPoolWatermarkLow, natPoolWatermarkHigh, natPoolPortMin, natPoolPortMax, natPoolRangePoolIndex, natPoolRangeEnd, natPoolRangeAllocatedPorts, natMappingIntAddressType, natMappingIntAddress, natMappingIntPort, natMappingPool } STATUS current DESCRIPTION "Basic counters, limits, and thresholds." ::= { natMIBGroups 7 } natGroupAddrMapObjects OBJECT-GROUP OBJECTS { natCntAddressMappings, natCntAddrMapCreations, natCntAddrMapRemovals, natLimitAddressMappings, natAddrMapNotifyThreshold, natMapIntAddrExt } STATUS current DESCRIPTION "Objects that require 'Paired IP address pooling' behavior [RFC4787]." ::= { natMIBGroups 8 } natGroupFragmentObjects OBJECT-GROUP OBJECTS { natLimitFragments } STATUS current DESCRIPTION "Objects that require 'Receive Fragments Out of Order' behavior [RFC4787]." ::= { natMIBGroups 9 } natGroupBasicNotifications NOTIFICATION-GROUP NOTIFICATIONS { natNotifPoolWatermarkLow, natNotifPoolWatermarkHigh, natNotifMappings } STATUS current DESCRIPTION "Basic notifications." ::= { natMIBGroups 11 } natGroupAddrMapNotifications NOTIFICATION-GROUP NOTIFICATIONS { natNotifAddrMappings } STATUS current DESCRIPTION "Notifications about address mappings." ::= { natMIBGroups 12 } -- -- Compliance statements -- natMIBFullCompliance MODULE-COMPLIANCE STATUS deprecated DESCRIPTION "When this MIB is implemented with support for read-create, then such an implementation can claim full compliance. Such devices can then be both monitored and configured with this MIB. The following index objects cannot be added as OBJECT clauses but nevertheless have the compliance requirements: " -- OBJECT natAddrBindLocalAddrType -- SYNTAX InetAddressType { ipv4(1), ipv6(2) } -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrBindLocalAddr -- SYNTAX InetAddress (SIZE(4|16)) -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrPortBindLocalAddrType -- SYNTAX InetAddressType { ipv4(1), ipv6(2) } -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrPortBindLocalAddr -- SYNTAX InetAddress (SIZE(4|16)) -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." MODULE IF-MIB -- The interfaces MIB, RFC2863 MANDATORY-GROUPS { ifCounterDiscontinuityGroup } MODULE -- this module MANDATORY-GROUPS { natConfigGroup, natTranslationGroup, natStatsInterfaceGroup } GROUP natStatsProtocolGroup DESCRIPTION "This group is optional." GROUP natStatsAddrMapGroup DESCRIPTION "This group is optional." GROUP natMIBNotificationGroup DESCRIPTION "This group is optional." OBJECT natAddrMapLocalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapLocalAddrFrom SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapLocalAddrTo SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrFrom SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrTo SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrBindGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrBindGlobalAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrPortBindGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrPortBindGlobalAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateSrcAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateDstAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicSrcAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicDstAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." ::= { natMIBCompliances 1 } natMIBReadOnlyCompliance MODULE-COMPLIANCE STATUS deprecated DESCRIPTION "When this MIB is implemented without support for read-create (i.e., in read-only mode), then such an implementation can claim read-only compliance. Such a device can then be monitored but cannot be configured with this MIB. The following index objects cannot be added as OBJECT clauses but nevertheless have the compliance requirements: " -- OBJECT natAddrBindLocalAddrType -- SYNTAX InetAddressType { ipv4(1), ipv6(2) } -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrBindLocalAddr -- SYNTAX InetAddress (SIZE(4|16)) -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrPortBindLocalAddrType -- SYNTAX InetAddressType { ipv4(1), ipv6(2) } -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." -- OBJECT natAddrPortBindLocalAddr -- SYNTAX InetAddress (SIZE(4|16)) -- DESCRIPTION -- "An implementation is required to support -- global IPv4 and/or IPv6 addresses, depending -- on its support for IPv4 and IPv6." MODULE IF-MIB -- The interfaces MIB, RFC2863 MANDATORY-GROUPS { ifCounterDiscontinuityGroup } MODULE -- this module MANDATORY-GROUPS { natConfigGroup, natTranslationGroup, natStatsInterfaceGroup } GROUP natStatsProtocolGroup DESCRIPTION "This group is optional." GROUP natStatsAddrMapGroup DESCRIPTION "This group is optional." GROUP natMIBNotificationGroup DESCRIPTION "This group is optional." OBJECT natInterfaceRowStatus SYNTAX RowStatus { active(1) } MIN-ACCESS read-only DESCRIPTION "Write access is not required, and active is the only status that needs to be supported." OBJECT natAddrMapLocalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapLocalAddrFrom SYNTAX InetAddress (SIZE(4|16)) MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapLocalAddrTo SYNTAX InetAddress (SIZE(4|16)) MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrFrom SYNTAX InetAddress (SIZE(4|16)) MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapGlobalAddrTo SYNTAX InetAddress (SIZE(4|16)) MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrMapRowStatus SYNTAX RowStatus { active(1) } MIN-ACCESS read-only DESCRIPTION "Write access is not required, and active is the only status that needs to be supported." OBJECT natAddrBindGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrBindGlobalAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrPortBindGlobalAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natAddrPortBindGlobalAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateSrcAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPrivateDstAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicAddrType SYNTAX InetAddressType { ipv4(1), ipv6(2) } DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicSrcAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." OBJECT natSessionPublicDstAddr SYNTAX InetAddress (SIZE(4|16)) DESCRIPTION "An implementation is required to support global IPv4 and/or IPv6 addresses, depending on its support for IPv4 and IPv6." ::= {newNatPoolObjects 1natMIBCompliances 2 }newNatPoolEntry OBJECT-TYPE SYNTAX NewNatPoolEntry MAX-ACCESS not-accessiblenatBasicCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION"Entry"Basic compliance with this MIB is attained when the objects contained in thetable of pools." INDEX { newNatPoolIndex } ::=mandatory groups are implemented." MODULE -- this module MANDATORY-GROUPS {newNatPoolTable 1natGroupBasicObjects, natGroupBasicNotifications }NewNatPoolEntry::=SEQUENCE{newNatPoolIndex NatPoolIndex, newNatPoolUsage Integer32, newNatPoolWatermarkLow Integer32, newNatPoolWatermarkHigh Integer32, newNatPoolPortMin InetPortNumber, newNatPoolPortMax InetPortNumber -- TODO: virtual router ID, status, ref count, etc.natMIBCompliances 3 }newNatPoolIndex OBJECT-TYPE SYNTAX NatPoolIndex MAX-ACCESS read-onlynatAddrMapCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION"Index of an"NATs that have 'Paired IP addresspool."pooling' behavior [RFC4787] and implement the objects in this group can claim this level of compliance." MODULE -- this module MANDATORY-GROUPS { natGroupBasicObjects, natGroupBasicNotifications, natGroupAddrMapObjects, natGroupAddrMapNotifications } ::= {newNatPoolEntry 1natMIBCompliances 4 }newNatPoolUsage OBJECT-TYPE SYNTAX Integer32 (0..100) MAX-ACCESS read-onlynatFragmentsCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION"Percentage"NATs that have 'Receive Fragments Out of Order' behavior [RFC4787] and implement thepool's total numberobjects in this group can claim this level ofexternal ports currently mapped."compliance." MODULE -- this module MANDATORY-GROUPS { natGroupBasicObjects, natGroupBasicNotifications, natGroupFragmentObjects } ::= {newNatPoolEntry 2natMIBCompliances 5 } -- counters natCounters OBJECT IDENTIFIER ::= { natMIBObjects 11 }newNatPoolWatermarkLownatCntTranslates OBJECT-TYPE SYNTAXInteger32 (-1|0..100)Counter64 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Low watermark on a pool's usage, in percentage of the total"The number ofports available. If set to -1, the watermark is disabled. Otherwise when newNatPoolUsage becomes lower than or equalpackets tonewNatPoolWatermarkLow, a notification is sent. Thewhich NATmay also start behaving in low usage mode (this is implementation-defined)."has been applied." ::= {newNatPoolEntry 3natCounters 1 }newNatPoolWatermarkHighnatCntOOP OBJECT-TYPE SYNTAXInteger32 (-1|0..100)Counter64 MAX-ACCESSread-createread-only STATUS currentDESCRIPTION "High watermark on a pool's usage, in percentage of the total number of ports available. If set to -1, the watermark is disabled. Otherwise, when newNatPoolUsage becomes higher than or equal to newNatPoolWatermarkHigh, a notification is sent. The NAT may also start behaving in high usage mode (this is implementation-defined)."DESCRIPTION "The number of packets to which NAT could not be applied because no external port was available, excluding quota limitations." ::= {newNatPoolEntry 4natCounters 2 }newNatPoolPortMinnatCntResource OBJECT-TYPE SYNTAXInetPortNumberCounter64 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Minimal port"The number of packets to which NAT could not beallocated in this pool."applied because of resource constraints (excluding out-of-ports condition)." ::= {newNatPoolEntry 5natCounters 3 }newNatPoolPortMaxnatCntStateMismatch OBJECT-TYPE SYNTAXInetPortNumberCounter64 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Maximal port"The number of packets to which NAT could not beallocated inapplied because of mapping state mismatch. For example, a TCP packet that matches an existing mapping but is dropped because its flags are incompatible with the current state of the mapping would cause thispool."counter to be incremented." ::= {newNatPoolEntry 6natCounters 4 }newNatPoolRangeTablenatCntQuota OBJECT-TYPE SYNTAXSEQUENCE OF NewNatPoolRangeEntryCounter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"This table contains address ranges used by pool entries.""The number of packets to which NAT could not be applied because of quota limitations. Quotas include absolute limits as well as limits on rate of allocation." ::= {newNatPoolObjects 2natCounters 5 }newNatPoolRangeEntrynatCntMappings OBJECT-TYPE SYNTAXNewNatPoolRangeEntryGauge32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"NAT pool address range." INDEX { newNatPoolRangeType, newNatPoolRangeBegin } ::= { newNatPoolRangeTable 1 } NewNatPoolRangeEntry"Number of currently active mappings. Equal to natCntMapRemovals - natCntMapCreations." ::=SEQUENCE{newNatPoolRangePoolIndex NatPoolIndex, newNatPoolRangeType InetAddressType, newNatPoolRangeBegin InetAddress, newNatPoolRangeEnd InetAddress, newNatPoolRangeAllocatedPorts Gauge32 -- TODO: the usual bookkeeping thingsnatCounters 6 }newNatPoolRangePoolIndexnatCntMapCreations OBJECT-TYPE SYNTAXNatPoolIndexCounter64 MAX-ACCESS read-only STATUS current DESCRIPTION"Index"Number ofthe address pool to which this address range belongs. See newNatPoolIndex."mapping creations. This includes static mappings." ::= {newNatPoolRangeEntry 1natCounters 7 }newNatPoolRangeTypenatCntMapRemovals OBJECT-TYPE SYNTAXInetAddressTypeCounter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"The address type"Number ofnewNatPoolRangeBegin and newNatPoolRangeEnd."mapping removals. This includes static mappings." ::= {newNatPoolRangeEntry 2natCounters 8 }newNatPoolRangeBeginnatCntAddressMappings OBJECT-TYPE SYNTAXInetAddress (SIZE (4|16))Gauge32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Lowest"Number of active addressincluded in this range."mappings. Equal to natCntAddrMapRemovals - natCntAddrMapCreations." ::= {newNatPoolRangeEntry 3natCounters 9 }newNatPoolRangeEndnatCntAddrMapCreations OBJECT-TYPE SYNTAXInetAddress (SIZE (4|16))Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION"Highest"Number of addressincluded in this range."mapping creations. This includes static mappings." ::= {newNatPoolRangeEntry 4natCounters 10 }newNatPoolRangeAllocatedPortsnatCntAddrMapRemovals OBJECT-TYPE SYNTAXGauge32Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Number ofports currently allocated on the addresses in this range."address mapping removals. This includes static mappings." ::= {newNatPoolRangeEntry 5natCounters 11 }-- indexed mapping tables newNatMapIntAddrTablenatCntProtocolTable OBJECT-TYPE SYNTAX SEQUENCE OFNewNatMapIntAddrEntryNatCntProtocolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table ofmappings from internal to external address. This table is only applicable to NATs that have an 'IP address pooling' behavior of 'Paired' [RFC4787]."protocols with per-protocol counters." ::= {newNatMapObjects 1natCounters 128 }newNatMapIntAddrEntrynatCntProtocolEntry OBJECT-TYPE SYNTAXNewNatMapIntAddrEntryNatCntProtocolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"Mapping from internal to external address.""Per-protocol counters." INDEX {newNatMapIntAddrType, newNatMapIntAddrIntnatCntProtocolNumber } ::= {newNatMapIntAddrTablenatCntProtocolTable 1 }NewNatMapIntAddrEntryNatCntProtocolEntry ::= SEQUENCE {newNatMapIntAddrType InetAddressType, newNatMapIntAddrInt InetAddress, newNatMapIntAddrExt InetAddressnatCntProtocolNumber ProtocolNumber, natCntProtocolTranslates Counter64, natCntProtocolOOP Counter64, natCntProtocolResource Counter64, natCntProtocolStateMismatch Counter64, natCntProtocolQuota Counter64, natCntProtocolMappings Gauge32, natCntProtocolMapCreations Counter64, natCntProtocolMapRemovals Counter64 }newNatMapIntAddrTypenatCntProtocolNumber OBJECT-TYPE SYNTAXInetAddressTypeProtocolNumber MAX-ACCESS not-accessible STATUS current DESCRIPTION"Address type for newNatMapIntAddrInt and newNatMapIntAddrExt.""Counters in this conceptual row apply to packets using the transport protocol identified by this object's value." ::= {newNatMapIntAddrEntrynatCntProtocolEntry 1 }newNatMapIntAddrIntnatCntProtocolTranslates OBJECT-TYPE SYNTAXInetAddress (SIZE (4|16))Counter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Internal address.""The number of packets to which NAT has been applied." ::= {newNatMapIntAddrEntrynatCntProtocolEntry 2 }newNatMapIntAddrExtnatCntProtocolOOP OBJECT-TYPE SYNTAXInetAddressCounter64 MAX-ACCESS read-only STATUS current DESCRIPTION"External address.""The number of packets to which NAT could not be applied because no external port was available." ::= {newNatMapIntAddrEntrynatCntProtocolEntry 3 }newNatMappingTablenatCntProtocolResource OBJECT-TYPE SYNTAXSEQUENCE OF NewNatMappingTableEntryCounter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Table"The number ofmappings indexed by external 3-tuple."packets to which NAT could not be applied because of resource constraints (excluding out-of-ports condition)." ::= {newNatMapObjects 2natCntProtocolEntry 4 }newNatMappingTableEntrynatCntProtocolStateMismatch OBJECT-TYPE SYNTAXNewNatMappingTableEntryCounter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"A single"The number of packets to which NATmapping." INDEX { newNatMappingProto, newNatMappingExtAddressType, newNatMappingExtAddress, newNatMappingExtPort }could not be applied because of state table mismatch. For example, a TCP packet that matches an existing mapping but is dropped because its flags are incompatible with the current state of the mapping would cause this counter to be incremented." ::= {newNatMappingTable 1natCntProtocolEntry 5 }NewNatMappingTableEntrynatCntProtocolQuota OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets to which NAT could not be applied because of exceeded quotas. Quotas include absolute limits as well as limits on rate of allocation." ::=SEQUENCE{newNatMappingProto ProtocolNumber, newNatMappingExtAddressType InetAddressType, newNatMappingExtAddress InetAddress, newNatMappingExtPort InetPortNumber, newNatMappingIntAddressType InetAddressType, newNatMappingIntAddress InetAddress, newNatMappingIntPort InetPortNumber, newNatMappingPool NatPoolIndexnatCntProtocolEntry 6 }newNatMappingProtonatCntProtocolMappings OBJECT-TYPE SYNTAXProtocolNumberGauge32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"The mapping's transport protocol number.""Number of active mappings. Equal to natCntMapRemovals - natCntMapCreations." ::= {newNatMappingTableEntry 1natCntProtocolEntry 7 }newNatMappingExtAddressTypenatCntProtocolMapCreations OBJECT-TYPE SYNTAXInetAddressTypeCounter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Type"Number ofthe mapping's external address."mapping creations. This includes static mappings." ::= {newNatMappingTableEntry 2natCntProtocolEntry 8 }newNatMappingExtAddressnatCntProtocolMapRemovals OBJECT-TYPE SYNTAXInetAddress (SIZE (4|16))Counter64 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"The mapping's external address. If this is the undefined address, all external addresses are mapped to the internal address.""Number of mapping removals. This includes statis mappings." ::= {newNatMappingTableEntry 3natCntProtocolEntry 9 } -- limits natLimits OBJECT IDENTIFIER ::= { natMIBObjects 12 }newNatMappingExtPortnatLimitMappings OBJECT-TYPE SYNTAXInetPortNumberUnsigned32 MAX-ACCESSnot-accessibleread-write STATUS current DESCRIPTION"The mapping's external port number. If this is zero, all external ports are mapped to"Global limit on theinternal port."total number of mappings. Zero means unlimited." ::= {newNatMappingTableEntry 4natLimits 1 }newNatMappingIntAddressType-- TODO: How does that work with bulk port allocation? natMappingsNotifyThreshold OBJECT-TYPE SYNTAXInetAddressTypeUnsigned32 MAX-ACCESSread-onlyread-write STATUS current DESCRIPTION"Type of the mapping's internal address.""See natNotifMappings." ::= {newNatMappingTableEntry 5natLimits 2 }newNatMappingIntAddressnatLimitAddressMappings OBJECT-TYPE SYNTAXInetAddressUnsigned32 MAX-ACCESSread-onlyread-write STATUS current DESCRIPTION"The mapping's internal address. If this is"Global limit on theundefined address, addresses are not translated."total number of internal-to-external address mappings. Zero means unlimited. This limit is only applicable to NATs that have an 'IP address pooling' behavior of 'Paired' [RFC4787]." ::= {newNatMappingTableEntry 6natLimits 3 }newNatMappingIntPortnatAddrMapNotifyThreshold OBJECT-TYPE SYNTAXInetPortNumberUnsigned32 MAX-ACCESSread-onlyread-write STATUS current DESCRIPTION"The mapping's internal port number. If this is zero, ports are not translated.""See natNotifAddrMappings." ::= {newNatMappingTableEntry 7natLimits 4 }newNatMappingPoolnatLimitFragments OBJECT-TYPE SYNTAXNatPoolIndex (0|1..4294967295)Unsigned32 MAX-ACCESSread-onlyread-write STATUS current DESCRIPTION"Index of"Global limit on thepool that contains this mapping's external address and port. If zero, no pooltotal number of fragments pending reassembly. Zero means unlimited. This limit isassociated with this mapping."only applicable to NATs having 'Receive Fragments Out of Order' behavior [RFC4787]." ::= {newNatMappingTableEntry 8natLimits 5 } --subscribers newNatSubscribersTablepools natPoolObjects OBJECT IDENTIFIER ::= { natMIBObjects 13 } natPoolTable OBJECT-TYPE SYNTAX SEQUENCE OFNewNatSubscribersTableEntryNatPoolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table ofCGN subscribers."pools." ::= {newNatSubscribersnatPoolObjects 1 }newNatSubscribersTableEntrynatPoolEntry OBJECT-TYPE SYNTAXNewNatSubscribersTableEntryNatPoolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"Each entry describes a single CGN subscriber.""Entry in the table of pools." INDEX {newNatSubscriberIdentifierType, newNatSubscriberIdentifiernatPoolIndex } ::= {newNatSubscribersTablenatPoolTable 1 }NewNatSubscribersTableEntryNatPoolEntry ::= SEQUENCE {newNatSubscriberIdentifierType InetAddressType, newNatSubscriberIdentifier InetAddress, newNatSubscriberIntPrefixType InetAddressType, newNatSubscriberIntPrefix InetAddress, newNatSubscriberIntPrefixLength InetAddressPrefixLength, newNatSubscriberPool NatPoolIndex, newNatSubscriberCntTranslates Counter64, newNatSubscriberCntOOP Counter64, newNatSubscriberCntResource Counter64, newNatSubscriberCntStateMismatch Counter64, newNatSubscriberCntQuota Counter64, newNatSubscriberCntMappings Gauge32, newNatSubscriberCntMapCreations Counter64, newNatSubscriberCntMapRemovals Counter64, newNatSubscriberLimitMappings Unsigned32, newNatSubscriberMapNotifyThresh Unsigned32natPoolIndex NatPoolId, natPoolUsage Integer32, natPoolWatermarkLow Integer32, natPoolWatermarkHigh Integer32, natPoolPortMin InetPortNumber, natPoolPortMax InetPortNumber -- TODO: virtual router ID, status, ref count, etc. }newNatSubscriberIdentifierTypenatPoolIndex OBJECT-TYPE SYNTAXInetAddressTypeNatPoolId MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Address type"Index ofthe subscriber identifier."an address pool." ::= {newNatSubscribersTableEntrynatPoolEntry 1 }newNatSubscriberIdentifiernatPoolUsage OBJECT-TYPE SYNTAXInetAddress (SIZE (4|16))Integer32 (0..100) MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"Address used for uniquely identifying"Percentage of thesubscriber. In traditional NAT, this ispool's total number of external ports currently mapped." ::= { natPoolEntry 2 } natPoolWatermarkLow OBJECT-TYPE SYNTAX Integer32 (-1|0..100) MAX-ACCESS read-create STATUS current DESCRIPTION "Low watermark on a pool's usage, in percentage of theinternal address assignedtotal number of ports available. If set to -1, theCPE. In case an address rangewatermark isassigneddisabled. Otherwise when natPoolUsage becomes lower than or equal to natPoolWatermarkLow, asubscriber, the first address in the range is used as identifier. For tunnelled connectivity (e.g., DS-Lite [RFC6333]), the outer addressnotification isused as identifier (i.e., the IPv6 addresssent. The NAT may also start behaving inthe case of DS-Lite)."low usage mode (this is implementation-defined)." ::= {newNatSubscribersTableEntry 2natPoolEntry 3 }newNatSubscriberIntPrefixTypenatPoolWatermarkHigh OBJECT-TYPE SYNTAXInetAddressTypeInteger32 (-1|0..100) MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Subscriber's internal prefix type.""High watermark on a pool's usage, in percentage of the total number of ports available. If set to -1, the watermark is disabled. Otherwise, when natPoolUsage becomes higher than or equal to natPoolWatermarkHigh, a notification is sent. The NAT may also start behaving in high usage mode (this is implementation-defined)." ::= {newNatSubscribersTableEntry 3natPoolEntry 4 }newNatSubscriberIntPrefixnatPoolPortMin OBJECT-TYPE SYNTAXInetAddressInetPortNumber MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Prefix assigned"Minimal port number toa subscriber's CPE."be allocated in this pool." ::= {newNatSubscribersTableEntry 4natPoolEntry 5 }newNatSubscriberIntPrefixLengthnatPoolPortMax OBJECT-TYPE SYNTAXInetAddressPrefixLengthInetPortNumber MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Length of the prefix assigned"Maximal port number toa subscriber's CPE,be allocated inbits. In case a single address is assigned,thiswill be 32 for IPv4 and 128 for IPv6."pool." ::= {newNatSubscribersTableEntry 5natPoolEntry 6 }newNatSubscriberPoolnatPoolRangeTable OBJECT-TYPE SYNTAXNatPoolIndexSEQUENCE OF NatPoolRangeEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"External"This table contains address ranges used by poolto which this subscriber belongs."entries." ::= {newNatSubscribersTableEntry 6natPoolObjects 2 }newNatSubscriberCntTranslatesnatPoolRangeEntry OBJECT-TYPE SYNTAXCounter64NatPoolRangeEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"The number of packets received from or sent to this subscriber and to which NAT has been applied.""NAT pool address range." INDEX { natPoolRangeType, natPoolRangeBegin } ::= {newNatSubscribersTableEntry 7natPoolRangeTable 1 } NatPoolRangeEntry ::= SEQUENCE { natPoolRangePoolIndex NatPoolId, natPoolRangeType InetAddressType, natPoolRangeBegin InetAddress, natPoolRangeEnd InetAddress, natPoolRangeAllocatedPorts Gauge32 -- TODO: the usual bookkeeping things }newNatSubscriberCntOOPnatPoolRangePoolIndex OBJECT-TYPE SYNTAXCounter64NatPoolId MAX-ACCESS read-only STATUS current DESCRIPTION"The number"Index ofpackets received from this subscriberthe address pool to whichNAT could not be applied because no external port was available, excluding quota limitations."this address range belongs. See natPoolIndex." ::= {newNatSubscribersTableEntry 8natPoolRangeEntry 1 }newNatSubscriberCntResourcenatPoolRangeType OBJECT-TYPE SYNTAXCounter64InetAddressType MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION "Thenumber of packets received from this subscriber to which NAT could not be applied becauseaddress type ofresource constraints (excluding out-of-ports condition)."natPoolRangeBegin and natPoolRangeEnd." ::= {newNatSubscribersTableEntry 9natPoolRangeEntry 2 }newNatSubscriberCntStateMismatchnatPoolRangeBegin OBJECT-TYPE SYNTAXCounter64InetAddress (SIZE (4|16)) MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"The number of packets received from or destined to this subscriber to which NAT could not be applied because of mapping state mismatch. For example, a TCP packet that matches an existing mapping but is dropped because its flags are incompatible with the current state of the mapping would cause"Lowest address included in thiscounter to be incremented."range." ::= {newNatSubscribersTableEntry 10natPoolRangeEntry 3 }newNatSubscriberCntQuotanatPoolRangeEnd OBJECT-TYPE SYNTAXCounter64InetAddress (SIZE (4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION"The number of packets received from or destined to"Highest address included in thissubscriber to which NAT could not be applied because of quota limitations. Quotas include absolute limits as well as limits on the rate of allocation."range." ::= {newNatSubscribersTableEntry 11natPoolRangeEntry 4 }newNatSubscriberCntMappingsnatPoolRangeAllocatedPorts OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of ports currentlyactive mappings created by or forallocated on the addresses in thissubscriber. Equal to newNatSubscriberCntMapRemovals - newNatSubscriberCntMapCreations."range." ::= {newNatSubscribersTableEntry 12natPoolRangeEntry 5 } -- indexed mapping tables natMapObjects OBJECT IDENTIFIER ::= { natMIBObjects 14 }newNatSubscriberCntMapCreationsnatMapIntAddrTable OBJECT-TYPE SYNTAXCounter64SEQUENCE OF NatMapIntAddrEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"Number"Table of mappingscreated by or for this subscriber."from internal to external address. This table is only applicable to NATs that have an 'IP address pooling' behavior of 'Paired' [RFC4787]." ::= {newNatSubscribersTableEntry 13natMapObjects 1 }newNatSubscriberCntMapRemovalsnatMapIntAddrEntry OBJECT-TYPE SYNTAXCounter64NatMapIntAddrEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"Number of mappings removed by or for this subscriber.""Mapping from internal to external address." INDEX { natMapIntAddrType, natMapIntAddrInt } ::= {newNatSubscribersTableEntry 14natMapIntAddrTable 1 } NatMapIntAddrEntry ::= SEQUENCE { natMapIntAddrType InetAddressType, natMapIntAddrInt InetAddress, natMapIntAddrExt InetAddress }newNatSubscriberLimitMappingsnatMapIntAddrType OBJECT-TYPE SYNTAXUnsigned32InetAddressType MAX-ACCESSread-writenot-accessible STATUS current DESCRIPTION"Limit on the number of active mappings created by or"Address type forthis subscriber. Zero means unlimited."natMapIntAddrInt and natMapIntAddrExt." ::= {newNatSubscribersTableEntry 15natMapIntAddrEntry 1 }newNatSubscriberMapNotifyThreshnatMapIntAddrInt OBJECT-TYPE SYNTAXUnsigned32InetAddress (SIZE (4|16)) MAX-ACCESSread-writenot-accessible STATUS current DESCRIPTION"See newNatNotifSubscriberMappings.""Internal address." ::= {newNatSubscribersTableEntry 16 } -- conformance groups newNatGroupBasicObjects OBJECT-GROUP OBJECTS { newNatCntTranslates, newNatCntOOP, newNatCntResource, newNatCntStateMismatch, newNatCntQuota, newNatCntMappings, newNatCntMapCreations, newNatCntMapRemovals, newNatCntProtocolTranslates, newNatCntProtocolOOP, newNatCntProtocolResource, newNatCntProtocolStateMismatch, newNatCntProtocolQuota, newNatCntProtocolMappings, newNatCntProtocolMapCreations, newNatCntProtocolMapRemovals, newNatLimitMappings, newNatMappingsNotifyThreshold, newNatPoolIndex, newNatPoolUsage, newNatPoolWatermarkLow, newNatPoolWatermarkHigh, newNatPoolPortMin, newNatPoolPortMax, newNatPoolRangePoolIndex, newNatPoolRangeEnd, newNatPoolRangeAllocatedPorts, newNatMappingIntAddressType, newNatMappingIntAddress, newNatMappingIntPort, newNatMappingPoolnatMapIntAddrEntry 2 } natMapIntAddrExt OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION"Basic counters, limits, and thresholds.""External address." ::= {newNatGroups 1 } newNatGroupAddrMapObjects OBJECT-GROUP OBJECTS { newNatCntAddressMappings, newNatCntAddrMapCreations, newNatCntAddrMapRemovals, newNatLimitAddressMappings, newNatAddrMapNotifyThreshold, newNatMapIntAddrExtnatMapIntAddrEntry 3 } natMappingTable OBJECT-TYPE SYNTAX SEQUENCE OF NatMappingTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"Objects that require 'Paired IP address pooling' behavior [RFC4787].""Table of mappings indexed by external 3-tuple." ::= {newNatGroupsnatMapObjects 2 }newNatGroupFragmentObjects OBJECT-GROUP OBJECTS { newNatLimitFragments }natMappingTableEntry OBJECT-TYPE SYNTAX NatMappingTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"Objects that require 'Receive Fragments Out of Order' behavior [RFC4787].""A single NAT mapping." INDEX { natMappingProto, natMappingExtAddressType, natMappingExtAddress, natMappingExtPort } ::= {newNatGroups 3natMappingTable 1 }newNatGroupSubscriberObjects OBJECT-GROUP OBJECTSNatMappingTableEntry ::= SEQUENCE {newNatSubscriberIntPrefixType, newNatSubscriberIntPrefix, newNatSubscriberIntPrefixLength, newNatSubscriberPool, newNatSubscriberCntTranslates, newNatSubscriberCntOOP, newNatSubscriberCntResource, newNatSubscriberCntStateMismatch, newNatSubscriberCntQuota, newNatSubscriberCntMappings, newNatSubscriberCntMapCreations, newNatSubscriberCntMapRemovals, newNatSubscriberLimitMappings, newNatSubscriberMapNotifyThresh, newNatLimitSubscribersnatMappingProto ProtocolNumber, natMappingExtAddressType InetAddressType, natMappingExtAddress InetAddress, natMappingExtPort InetPortNumber, natMappingIntAddressType InetAddressType, natMappingIntAddress InetAddress, natMappingIntPort InetPortNumber, natMappingPool NatPoolId } natMappingProto OBJECT-TYPE SYNTAX ProtocolNumber MAX-ACCESS not-accessible STATUS current DESCRIPTION"Per-subscriber counters, limits, and thresholds.""The mapping's transport protocol number." ::= {newNatGroups 4natMappingTableEntry 1 }newNatGroupBasicNotifications NOTIFICATION-GROUP NOTIFICATIONSnatMappingExtAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "Type of the mapping's external address." ::= {newNatNotifPoolWatermarkLow, newNatNotifPoolWatermarkHigh, newNatNotifMappingsnatMappingTableEntry 2 } natMappingExtAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (4|16)) MAX-ACCESS not-accessible STATUS current DESCRIPTION"Basic notifications.""The mapping's external address. If this is the undefined address, all external addresses are mapped to the internal address." ::= {newNatGroups 5 } newNatGroupAddrMapNotifications NOTIFICATION-GROUP NOTIFICATIONS { newNatNotifAddrMappingsnatMappingTableEntry 3 } natMappingExtPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS not-accessible STATUS current DESCRIPTION"Notifications about address mappings.""The mapping's external port number. If this is zero, all external ports are mapped to the internal port." ::= {newNatGroups 6 } newNatGroupSubscriberNotifs NOTIFICATION-GROUP NOTIFICATIONS { newNatNotifSubscriberMappingsnatMappingTableEntry 4 } natMappingIntAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION"Notifications about subscribers.""Type of the mapping's internal address." ::= {newNatGroups 7natMappingTableEntry 5 }-- compliance statements newNatBasicCompliance MODULE-COMPLIANCEnatMappingIntAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION"Basic compliance with"The mapping's internal address. If thisMIBisattained when the objects contained inthemandatory groupsundefined address, addresses areimplemented." MODULE -- this module MANDATORY-GROUPS { newNatGroupBasicObjects, newNatGroupBasicNotifications }not translated." ::= {newNatCompliance 1natMappingTableEntry 6 }newNatAddrMapCompliance MODULE-COMPLIANCEnatMappingIntPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION"NATs that have 'Paired IP address pooling' behavior [RFC4787] and implement the objects in this group can claim this level of compliance." MODULE --"The mapping's internal port number. If thismodule MANDATORY-GROUPS { newNatGroupBasicObjects, newNatGroupBasicNotifications, newNatGroupAddrMapObjects, newNatGroupAddrMapNotifications }is zero, ports are not translated." ::= {newNatCompliance 2natMappingTableEntry 7 }newNatFragmentsCompliance MODULE-COMPLIANCEnatMappingPool OBJECT-TYPE SYNTAX NatPoolId (0|1..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION"NATs that have 'Receive Fragments Out"Index ofOrder' behavior [RFC4787] and implementtheobjects in this group can claim this level of compliance." MODULE -- this module MANDATORY-GROUPS { newNatGroupBasicObjects, newNatGroupBasicNotifications, newNatGroupFragmentObjects } ::= { newNatCompliance 3 } newNatCGNCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "NATspool thathave 'Paired IPcontains this mapping's external addresspooling' and 'Receive Fragments Out of Order' behavior [RFC4787]andimplement the objects in this group can claim this level of compliance. This level of complianceport. If zero, no pool isto be expected of a CGN compliantassociated with[I-D.ietf-behave-lsn-requiremnents]." MODULE --thismodule MANDATORY-GROUPS { newNatGroupBasicObjects, newNatGroupBasicNotifications, newNatGroupAddrMapObjects, newNatGroupAddrMapNotifications, newNatGroupFragmentObjects, newNatGroupSubscriberObjects, newNatGroupSubscriberNotifs }mapping." ::= {newNatCompliance 4natMappingTableEntry 8 } END 4. Security Considerations TBD 5. IANA Considerations TBD 6. References 6.1. Normative References [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual Conventions for Internet Network Addresses", RFC 4001, February 2005. [RFC4787] Audet, F. and C. Jennings, "Network Address Translation (NAT) Behavioral Requirements for Unicast UDP", BCP 127, RFC 4787, January 2007. 6.2. Informative References [RFC4008] Rohit, R., Srisuresh, P., Raghunarayan, R., Pai, N., and C. Wang, "Definitions of Managed Objects for Network Address Translators (NAT)", RFC 4008, March 2005. Appendix A. Change Log (to be removed by RFC Editor prior to publication) A.1. Changed in -01 o Added CGN stuff (per-subscriber quotas, counters, notifications). o Added conformance groups and compliance statements. o Added mapping table indexed by external 3-tuple. Authors' Addresses Simon Perreault Viagenie 246 Aberdeen Quebec, QC G1R 2E1 Canada Phone: +1 418 656 9254 Email: simon.perreault@viagenie.ca URI: http://viagenie.ca Tina Tsou Huawei Technologies (USA) 2330 Central Expressway Santa Clara, CA 95050 USA Phone: +1 408 330 4424 Email: tina.tsou.zouting@huawei.com Senthil Sivakumar Cisco Systems 7100-8 Kit Creek Road Research Triangle Park, North Carolina 27709 USA Phone: +1 919 392 5158 Email: ssenthil@cisco.com