view Side-By-Side changes
Network Working Group S. Kent Internet Draft K. Seo draft-ietf-ipsec-rfc2401bis-02.txt BBN Technologies Obsoletes: RFC 2401JanuaryApril 2004 ExpiresJulyOctober 2004 Security Architecture for the Internet Protocol Status of this Memo This document is an Internet Draft and is subject to all provisions of Section 10 of RFC2026. Internet Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet Drafts Internet Drafts are draft documents valid for a maximum of 6 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 a "work in progress". The list of current Internet Drafts can be accessed at http://www.ietf.org/1id-abstracts.html The list of Internet Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html Copyright (C) The Internet Society (2004). All Rights Reserved. Kent & Seo [Page 1] Internet Draft Security Architecture for IPJanuaryApril 2004 Table of Contents 1.Introduction.........................................................3Introduction.........................................................4 1.1 Summary of Contents ofDocument.................................3Document.................................4 1.2Audience........................................................3Audience........................................................4 1.3 RelatedDocuments...............................................4Documents...............................................5 2. DesignObjectives....................................................4Objectives....................................................5 2.1 Goals/Objectives/Requirements/ProblemDescription...............4Description...............5 2.2 Caveats andAssumptions.........................................5Assumptions.........................................6 3. System Overview.....................................................6.....................................................7 3.1 What IPsecDoes.................................................6Does.................................................7 3.2 How IPsecWorks.................................................8Works.................................................9 3.3 Where IPsec May BeImplemented..................................9Implemented.................................10 4. SecurityAssociations...............................................10Associations...............................................11 4.1 Definition andScope...........................................10Scope...........................................11 4.2 Security AssociationFunctionality.............................13Functionality.............................15 4.3 Combining SecurityAssociations................................14Associations................................16 4.4 Major IPsecDatabases..........................................14Databases..........................................16 4.4.1 The Security Policy Database(SPD)........................15(SPD)........................19 4.4.1.1 Selectors............................................24 4.4.1.2 Structure of an SPD entry............................27 4.4.2Selectors.................................................19 4.4.3Security Association Database(SAD).......................22(SAD).......................29 4.5 SA and KeyManagement..........................................24Management..........................................35 4.5.1 ManualTechniques.........................................25Techniques.........................................35 4.5.2 Automated SA and KeyManagement...........................25Management...........................36 4.5.3 Locating a SecurityGateway...............................26Gateway...............................37 4.6 Security Associations andMulticast............................27Multicast............................38 5. IP TrafficProcessing...............................................27Processing...............................................38 5.1 Outbound IP Traffic Processing(protected-to-unprotected)......28(protected-to-unprotected)......39 5.1.1 Handling an Outbound Packet That Must BeDropped..........30Discarded........41 5.1.2 Header Construction for TunnelMode.......................31Mode.......................42 5.1.2.1 IPv4 -- Header Construction for TunnelMode..........33Mode..........43 5.1.2.2 IPv6 -- Header Construction for TunnelMode..........34Mode..........45 5.2 Processing Inbound IP Traffic(unprotected-to-protected).......35(unprotected-to-protected).......45 6. ICMP Processing(to be filled in when IPsec issue #91 is resolved)..38....................................................49 7.Auditing............................................................38Handling Fragments (on the protected side of the IPsec boundary)....49 8.Conformance Requirements............................................38Auditing............................................................51 9.Security Considerations.............................................38Conformance Requirements............................................52 10. Security Considerations............................................52 11. Differences from RFC2401..........................................38 Acknowledgements.......................................................382401..........................................52 Acknowledgements.......................................................57 Appendix A --Glossary.................................................40Glossary.................................................58 Appendix B --Decorrelation............................................43Decorrelation............................................61 Appendix C -- Categorization of ICMP messages [May bedeleted].........46 References.............................................................49deleted].........64 Appendix D -- ASN.1 for an SPD entry...................................67 Appendix E -- Fragment Handling Rationale..............................72 References.............................................................73 AuthorInformation.....................................................51 Notices................................................................52Information.....................................................74 Kent & Seo [Page 2] Internet Draft Security Architecture for IPJanuaryApril 2004 Notices................................................................77 Kent & Seo [Page 3] Internet Draft Security Architecture for IP April 2004 1. Introduction 1.1 Summary of Contents of Document This document specifies the base architecture for IPsec compliant systems. It describes how to provide a set of security services for traffic at the IP layer, in both the IPv4 and IPv6 environments. This document describes the requirements for systems that implement IPsec, the fundamental elements of such systems, and how the elements fit together and fit into the IP environment. It also describes the security services offered by the IPsec protocols, and how these services can be employed in the IP environment. This document does not address all aspects of the IPsec architecture. Other documents address additional architectural details in specialized environments, e.g., use of IPsec in NAT environments and more comprehensive support for IP multicast. The fundamental components of the IPsec security architecture are discussed in terms of their underlying, required functionality. Additional RFCs (see Section 1.3 for pointers to other documents) define the protocols in (a), (c), and (d). a. Security Protocols -- Authentication Header (AH) and Encapsulating Security Payload (ESP) b. Security Associations -- what they are and how they work, how they are managed, associated processing c. Key Management -- manual and automated (The Internet Key Exchange (IKE)) d. Cryptographic algorithms for authentication and encryption This document is not a Security Architecture for the Internet; it addresses security only at the IP layer, provided through the use of a combination of cryptographic and protocol security mechanisms. The spelling "IPsec" is preferred and used throughout this and all related IPsec standards. All other capitalizations of IPsec (e.g., IPSEC, IPSec, ipsec) are deprecated. However, any capitalization of the sequence of letters "IPsec" should be understood to refer to the IPsec protocols. The keywords MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL, when they appear in this document, are to be interpreted as described in RFC 2119 [Bra97]. 1.2 Audience The target audience for this document is primarily individuals who implement this IP security technology or who architect systems that will use this technology. Technically adept users of this technology (end users or system administrators) also are part of the target Kent & Seo [Page3]4] Internet Draft Security Architecture for IPJanuaryApril 2004 audience. A glossary is providedas an appendixin Appendix A to help fill in gaps in background/vocabulary. This document assumes that the reader is familiar with the Internet Protocol (IP), related networking technology, and general information system security terms and concepts. 1.3 Related Documents As mentioned above, other documents provide detailed definitions of some of the components of IPsec and of their inter-relationship. They include RFCs on the following topics: a. security protocols -- RFCs describing the Authentication Header (AH) [Ken04b] and Encapsulating Security Payload (ESP) [Ken04a] protocols. b. cryptographic algorithms for integrity and encryption -- one RFC that defines the mandatory, default algorithms for use with AH and ESP [Eas03], a similar RFC that defines the mandatory algorithms for use with IKEv2 [Sch03] plus a separate RFC for each cryptographic algorithm. c. automatic key management -- RFCs on "The Internet Key Exchange (IKEv2) Protocol" [Kau03] and "Cryptographic Algorithms for use in the Internet Key Exchange Version 2" [Sch03] 2. Design Objectives 2.1 Goals/Objectives/Requirements/Problem Description IPsec is designed to provide interoperable, high quality, cryptographically-based security for IPv4 and IPv6. The set of security services offered includes access control, connectionless integrity, data origin authentication, detection and rejection of replays (a form of partial sequence integrity), confidentiality (via encryption), and limited traffic flow confidentiality. These services are provided at the IP layer, offering protection for all protocols that may be carried over IP in a standard fashion (including IP itself). IPsec includes a specification for minimal firewall functionality, since that is an essential aspect of access control at the IP layer. Implementations are free to provide more sophisticated firewall mechanisms, and to implement theIPsec- mandatedIPsec-mandated functionality using those more sophisticated mechanisms. (Note that interoperability may suffer if additional firewall constraints on traffic flows are imposed by an IPsec implementation but cannot be negotiated based on the traffic selector features defined in this document and negotiated via IKEv2.) The IPsec firewall function makes use of the Kent & Seo [Page4]5] Internet Draft Security Architecture for IPJanuaryApril 2004 cryptographically-enforced authentication and integrity provided for all IPsec traffic to offer better access control than could be obtained through use ofan independenta firewall (one not privy to IPsec internalparameters).parameters) plus separate cryptographic protection. Most of the security services are provided through use of two traffic security protocols, the Authentication Header (AH) and the Encapsulating Security Payload (ESP), and through the use of cryptographic key management procedures and protocols. The set of IPsec protocols employed in a context, and the ways in which they are employed, will be determined by the users/administrators in that context. It is the goal of the IPsec architecture to ensure that compliant implementations include the services and management interfaces needed to meet the security requirements of a broad user population. When IPsec is correctly implemented and deployed, it ought not adversely affect users, hosts, and other Internet components that do not employ IPsec for traffic protection. IPsec security protocols (AH & ESP, and to a lesser extent, IKE) are designed to be cryptographic algorithm-independent. This modularity permits selection of different sets of cryptographic algorithms as appropriate, without affecting the other parts of the implementation. For example, different user communities may select different sets of cryptographic algorithms (creating cryptographically-enforced cliques) if required. A set of default cryptographic algorithms for use with AH and ESP is specified [Eas03] to facilitate interoperability in the global Internet. The use of these cryptographic algorithms, in conjunction with IPsec traffic protection and key management protocols, is intended to permit system and application developers to deploy high quality, Internet layer, cryptographic security technology. 2.2 Caveats and Assumptions The suite of IPsec protocols and associated default cryptographic algorithms are designed to provide high quality security for Internet traffic. However, the security offered by use of these protocols ultimately depends on the quality of the their implementation, which is outside the scope of this set of standards. Moreover, the security of a computer system or network is a function of many factors, including personnel, physical, procedural, compromising emanations, and computer security practices. Thus IPsec is only one part of an overall system security architecture. Finally, the security afforded by the use of IPsec is critically dependent on many aspects of the operating environment in which the Kent & Seo [Page5]6] Internet Draft Security Architecture for IPJanuaryApril 2004 IPsec implementation executes. For example, defects in OS security, poor quality of random number sources, sloppy system management protocols and practices, etc. can all degrade the security provided by IPsec. As above, none of these environmental attributes are within the scope of this or other IPsec standards. 3. System Overview This section provides a high level description of how IPsec works, the components of the system, and how they fit together to provide the security services noted above. The goal of this description is to enable the reader to "picture" the overall process/system, see how it fits into the IP environment, and to provide context for later sections of this document, which describe each of the components in more detail. An IPsec implementation operates in a host, as a security gateway, or as an independent device, affording protection to IP traffic. (A security gateway is an intermediate system implementing IPsec, e.g., a firewall or router that has been IPsec-enabled.) More detail on these classes of implementations is provided later, in Section 3.3. The protection offered by IPsec is based on requirements defined by a Security Policy Database (SPD) established and maintained by a user or system administrator, or by an application operating within constraints established by either of the above. In general, packets are selected for one of three processing actions based on IP and next layer header information (Selectors, Section4.4.2)4.4.1.1) matched against entries in the database (SPD). Each packet is eitheraffordedPROTECTed using IPsec security services,discarded,DISCARDed, or allowed tobypassBYPASS IPsec protection, based on the applicable SPD policies identified by the Selectors. 3.1 What IPsec Does IPsec creates a boundary between unprotected and protected interfaces, for a host or a network(See(see Figure 1 below). Traffic traversing the boundary is subject to the access controls specified by the user or administrator responsible for the IPsec configuration. These controls indicate whether packets cross the boundary unimpeded, are afforded security services via AH or ESP, or are discarded. IPsec security services are offered at the IP layer through selection of appropriate security protocols, cryptographic algorithms, and cryptographic keys. IPsec can be used to protect one or more "paths" (a) between a pair of hosts, (b) between a pair of security gateways, or (c) between a security gateway and a host.Compliant implementationsA compliant host implementation MUST support (a) and (c) and a compliant security gateway must support all three of these forms ofconnectivity noted here.connectivity, since Kent & Seo [Page6]7] Internet Draft Security Architecture for IPJanuaryApril 2004 under certain circumstances a security gateway acts as a host. Unprotected ^ ^ | | +-------------|-------|-------+ | +-------+ | | | | |Discard|<--| V | | +-------+ |B +--------+ | ................|y..| AH/ESP |..... IPsec Boundary | +---+ |p +--------+ | | |IKE|<----|a ^ | | +---+ |s | | | +-------+ |s | | | |Discard|<--| | | | +-------+ | | | +-------------|-------|-------+ | | V V Protected Figure 1. Top Level IPsec Processing Model In this diagram, "unprotected" refers to an interface that might also be described as "black" or "ciphertext." Here, "protected" refers to an interface that might also be described as "red" or "plaintext." The protected interface noted above may be internal, e.g., in a host implementation ofIPsec;IPsec, the protected interface may link to a socket layer interface presented by the OS. In this document, the term "inbound" refers to traffic entering an IPsec implementation via the unprotected interface. The term "outbound" refers to traffic entering the implementation via the protected interface, or emitted by the implementation on the protected side of the boundary and directed toward the unprotected interface. An IPsec implementation may support more than one interface on either or both sides of the boundary. Note the facilities for discarding traffic on either side of the IPsec boundary, thebypassBYPASS facility that allows traffic to transit the boundary without cryptographic protection, and the reference to IKE as a protected-side key and security management function. IPsec optionally supports negotiation of IP compression [SMPT98], motivated in part by the observation that when encryption is employed within IPsec, it prevents effective compression by lower protocol layers. Kent & Seo [Page7]8] Internet Draft Security Architecture for IPJanuaryApril 2004 3.2 How IPsec Works IPsec uses two protocols to provide traffic security services -- Authentication Header (AH) and Encapsulating Security Payload (ESP). Both protocols are described in detail in their respective RFCs[KA98a, KA98b].[Ken04b, Ken04a]. IPsec implementations MUST support ESP and MAY support AH. (Support for AH has been downgraded to MAY because experience has shown that there are very few contexts in which ESP cannot provide the requisite security services. Note that ESP can be used to provide only integrity, without confidentiality, making it comparable to AH in most contexts.) o The IP Authentication Header (AH) [Ken04b] offers integrity and data origin authentication, with optional (at the discretion of the receiver) anti-replay features. o The Encapsulating Security Payload (ESP) protocol [Ken04a] offers the same set of services, and also offers confidentially. Use of ESP in a confidentiality-only mode is discouraged. When ESP is used with confidentiality enabled, there are provisions for limited traffic flow confidentiality, i.e., provisions for concealing packet length, and to facilitate efficient generation and discard of dummy packets. This capability is likely to be effective primarily in VPN and overlay network contexts. o Both AH and ESP offer access control, enforced through the distribution of cryptographic keys and the management of traffic flows as dictated by the Security Policy Database (SPD, Section4.4).4.4.1). These protocols may be applied individually or in combination with each other to provide security services in IPv4 and IPv6. However, most security requirements can be met through the use of ESP by itself. Each protocol supports two modes of use: transport mode and tunnel mode. In transport mode, AH and ESP provide protection primarily for next layer protocols; in tunnel mode, AH and ESP are applied to tunneled IP packets. The differences between the two modes are discussed in Section4.4.1. IPsec allows the user (or system administrator) to control the granularity at which a security service is offered. For example, one can create a single encrypted tunnel to carry all the traffic between two security gateways or a separate encrypted tunnel can be created for each TCP connection between each pair of hosts communicating across these gateways. IPsec, through the SPD management paradigm, incorporates facilities for specifying: o which securityservicesprotocols (AH, ESP) touse and in what combinationsemploy, their mode Kent & Seo [Page8]9] Internet Draft Security Architecture for IPJanuaryApril 2004 (transport or tunnel), security service options, what cryptographic algorithms to use, and in what combinations to use the specified protocols and services, o the granularity at which protection should beapplied o the cryptographic algorithms used to effect cryptographic-based securityapplied. Because most of the security services provided by IPsec require the use of cryptographic keys, IPsec relies on a separate set of mechanisms for putting these keys in place. This document requires support for both manual and automated distribution of keys. It specifies a specific public-key based approach (IKEv2 [KAU04]) for automated key management, but other automated key distribution techniques MAY be used. Note: This document mandates support for several features for which support is available in IKEv2 but not in IKEv1, e.g., negotiation of an SA representing ranges ofsourcelocal anddestinationremote ports or negotiation of multiple SAs with the same selectors. Therefore this document assumes use of IKEv2 or a key and security association management system with comparable features. 3.3 Where IPsec Can Be Implemented There are many ways in which IPsec may be implemented in a host, or in conjunction with a router or firewall to create a security gateway, or as an independent security device. a. IPsec may be integrated into the native IP stack. This requires access to the IP source code and is applicable to both hosts and security gateways, although native host implementations benefit the most from this strategy, as explained later (Section 4.4.1, paragraph4;6; Section4.4.2,4.4.1.1, lastparagraph)paragraph). b. In a "bump-in-the-stack" (BITS) implementation, IPsec is implemented "underneath" an existing implementation of an IP protocol stack, between the native IP and the local network drivers. Source code access for the IP stack is not required in this context, making this implementation approach appropriate for use with legacy systems. This approach, when it is adopted, is usually employed in hosts. c. The use ofana dedicated, inline security protocol processor is a common design feature of systems used by the military, and of some commercial systems as well. It is sometimes referred to as a "bump-in-the-wire" (BITW) implementation. Such implementations may be designed to serve either a host or a gateway. Usually the BITW device is itself IP addressable. When supporting a single host, it may be quite analogous to a BITS implementation, but in supporting a router or firewall, it must operate like a securitygateway.Kent & Seo [Page9]10] Internet Draft Security Architecture for IPJanuaryApril 2004 gateway. This document often talks in terms of host or security gateway use of IPsec, without regard to whether the implementation is native, BITS or BITW. When the distinctions among these implementation options are significant, the document makes reference to specific implementation approaches. 4. Security Associations This section defines Security Association management requirements for all IPv6 implementations and for those IPv4 implementations that implement AH, ESP, orboth.both AH and ESP. The concept of a "Security Association" (SA) is fundamental to IPsec. Both AH and ESP make use of SAs and a major function of IKE is the establishment and maintenance of Security Associations. All implementations of AH or ESP MUST support the concept of a Security Association as described below. The remainder of this section describes various aspects of Security Association management, defining required characteristics for SA policymanagement, traffic processing,management and SA management techniques. 4.1 Definition and ScopeA Security Association (SA) is a simplex "connection" thataffords security services to the traffic carried by it. Security services are afforded to an SA by the use of AH, or ESP, but not both. If both AH and ESP protection are applied to a traffic stream, then two SAs must be created and coordinated to effect protection through iterated application of the security protocols. To secure typical, bi-directional communication between two IPsec-enabled systems, a pair of Security Associations (one in each direction) are required. IKE explicitly creates SA pairs in recognition of this common usage requirement. For an SA used to carry unicast (or anycast) traffic, the SPI (Security Parameters Index - see Appendix A and AH [Ken04b] and ESP [Ken04a] specifications) by itself suffices to specify an SA. However, as a local matter, an implementation may choose to use the SPI in conjunction with the IPsec protocol type (AH or ESP) for SA identification. If an IPsec implementation supports multicast, then it MUST support multicast SAs using the algorithmdescribed in AH and ESPbelow for mapping inbound IPsecprotecteddatagrams to SAs.(ImplementationsImplementations that support only unicast traffic need not implementthatthis demultiplexingalgorithm.) Note: If different classes of traffic (distinguished by DSCP bits [NiBlBaBL98], [Gro02]) are sent onalgorithm. In many secure multicast architectures, e.g., [RFC3740], a central Group Controller/Key Server unilaterally assigns thesame SA, this could resultgroup security association's SPI. This SPI assignment is not negotiated or coordinated with the key management (e.g., IKE) subsystems that reside ininappropriate discarding of lower priority packets due tothewindowing mechanism used by receivers to reject replays. Therefore a sender SHOULD put traffic of different classes, but withindividual end systems that comprise thesamegroup. Kent & Seo [Page10]11] Internet Draft Security Architecture for IPJanuaryApril 2004selector values, on different SAs to appropriately support QoS. To permit this,Consequently, it is possible that a group security association and a unicast security association can simultaneously use the same SPI. A multicast-capable IPsec implementation MUSTpermit establishment and maintenancecorrectly de-multiplex inbound traffic even in the context ofmultiple SAs between a given sender and receiver, withSPI collisions. Each entry in thesame selectors. DistributionSecurity Association Database (SAD) [Section 4.4.2] must indicate whether the SA lookup makes use oftraffic among these parallel SAs to support QoS is locally determined bythesenderdestination, or destination and source, IP addresses, in addition to the SPI. For multicast SAs, the protocol field is notnegotiated by IKE. The receiver MUST processemployed for SA lookups. For each inbound, IPsec-protected packet, an implementation must conduct its search of thepackets fromSAD such that it finds thedifferent SAs without prejudice. DISCUSSION: Whileentry that matches theDSCP [NiBlBaBL98, Gro02] and ECN [RaFlBL01] fields are not "selectors", as"longest" SA identifier. In this context, if two or more SAD entries match based on the SPI value, then the entry thatterm in usedalso matches based on destination, or destination and source, address comparison (as indicated inthis architecture,thesender will need a mechanism to direct packets with a given (set of) DSCP values toSAD entry) is theappropriate SA."longest" match. Thismechanism might be termedimplies a"classifier". As noted above, two types of SAs are defined: transport mode and tunnel mode. IKE creates pairs of SAs, so for simplicity, we choose to require that both SAs in a pair belogical ordering of thesame mode, transport or tunnel. A transport mode SA isSAD search as follows: 1. Search the SAD for asecurity association typically employed betweenmatch on {SPI, destination address, source address}. If apair of hostsSAD entry matches then process the inbound ESP packet with that matching SAD entry. Otherwise, proceed toprovide end-to-end security services. When link (vs. end-to-end) security is desired between two intermediate systems along a path, transport mode MAY be used between security gateways or betweenstep 2. 2. Search the SAD for asecurity gateway andmatch on {SPI, destination address}. If the SAD entry matches then process the inbound ESP packet with that matching SAD entry. Otherwise, proceed to step 3. 3. Search the SAD for ahost. Inmatch on only {SPI} if thelatter case, transport mode may be usedreceiver has chosen tosupport IP-in-IP [Per96] or GRE tunneling [FaLiHaMeTr00] over transport mode SAs. The access control functionsmaintain a single SPI space for AH and ESP, and on {SPI, protocol} otherwise. If an SAD entry matches then process the inbound ESP packet with thatarematching SAD entry. Otherwise, discard the packet and log animportant part of IPsec are significantly limited inauditable event. In practice, an implementation MAY choose any method to accelerate thiscontext, as they cannotsearch, although its externally visible behavior MUST beappliedfunctionally equivalent to having searched theend-to-end headers ofSAD in thepackets that traverseabove order. For example, atransport modesoftware-based implementation could index into a hash table by the SPI. The SAD entries in each hash table bucket's linked list are kept sorted to have those SAD entries with the longest SAusedidentifiers first inthis fashion. Thus this way of using transport mode should be evaluated carefully before being employed in a specific context. In IPv4, a transport mode security protocol header appears immediately after the IP header and any options, and before any next layer protocols (e.g., TCP or UDP). In IPv6, the security protocol header appears after the base IP header and selected extension headers, but may appear before or after destination options; it MUST appear before next layer protocols. Inthat linked list. Those SAD entries having thecase of ESP, a transport modeshortest SAprovides security services only for these next layer protocols, not for the IP header or any extension headers preceding the ESP header. Inidentifiers are sorted so that they are thecase of AH,last entries in theprotection is also extendedlinked list. A hardware-based implementation may be able toselected portions ofeffect theIP header preceding it, selected portionslongest match search intrinsically, using commonly available TCAM features. The indication ofextension headers,whether source andselected options (contained in the IPv4 header, IPv6 Hop-by-Hop extension header, or IPv6 Destination extension headers). For more details on the coverage afforded by AH, see the AH specification [Ken04b]. A tunnel mode SAdestination address matching isessentially an SA appliedrequired toan IP tunnel, withmap inbound IPsec traffic to SAs MUST be set either as a Kent & Seo [Page11]12] Internet Draft Security Architecture for IPJanuaryApril 2004the access controls applied to the headers of the traffic inside the tunnel. In general, whenever either endside effect ofa security association is a security gateway, themanual SAMUST be tunnel mode. Thusconfiguration or via negotiation using an SAbetween two security gateways is typicallymanagement protocol, e.g., IKE or GDOI [RFC3547]. Typically, Source- Specific Multicast (SSM) [HC03] groups use atunnel mode SA, as is an3-tuple SAbetweenidentifier composed of an SPI, ahostdestination multicast address, and source address. An Any-Source Multicast group SA requires only an SPI and asecurity gateway. Note that for the case wheredestination multicast address as an identifier. If different classes of trafficis destined for a security gateway, e.g., SNMP commands,(distinguished by DSCP bits [NiBlBaBL98], [Gro02]) are sent on thesecurity gateway is acting as a hostsame SA, andtransport modeif the receiver isallowed. In this case,employing theSA terminates at a host (management) function within a security gatewayoptional anti-replay feature available in both AH andthus merits different treatment. Also, as noted above, security gateways MAY support a transport mode SAESP, this could result in inappropriate discarding of lower priority packets due toprovide link security for IP traffic. Two hosts MAY establish a tunnel mode SA between themselves. Several concerns motivatetheuse of tunnel mode for an SA involvingwindowing mechanism used by this feature. Therefore asecurity gateway. For example, if there are multiple paths (e.g., viasender SHOULD put traffic of differentsecurity gateways) toclasses, but with the samedestination behind security gateways, it is important that an IPsec packet be sentselector values, on different SAs to appropriately support QoS. To permit this, thesecurity gateway with which the SA was negotiated. Similarly,IPsec implementation MUST permit establishment and maintenance of multiple SAs between apacket that might be fragmented en route must have all the fragments delivered togiven sender and receiver, with the sameIPsec instance for reassembly. Also, when a fragmentselectors. Distribution of traffic among these parallel SAs to support QoS isprocessedlocally determined byIPsecthe sender andtransmitted, then fragmented en route, itiscritical that there be inner and outer headers to retainnot negotiated by IKE. The receiver MUST process thefragmentation state data forpackets from thepre-different SAs without prejudice. DISCUSSION: While the DSCP [NiBlBaBL98, Gro02] andpost-IPsec packet formats. Hence thereECN [RaFlBL01] fields areseveral reasons for employing tunnel mode when either end of an SA isnot "selectors", as that term in used in this architecture, the sender will need asecurity gateway. Note: AH and ESP cannotmechanism to direct packets with a given (set of) DSCP values to the appropriate SA. This mechanism might beapplied usingtermed a "classifier". As noted above, two types of SAs are defined: transport mode and tunnel mode. IKE creates pairs of SAs, so for simplicity, we choose toIPv4 packetsrequire thatare fragments. Only tunnel mode can be employedboth SAs insuch cases. Foratunnelpair be of the same mode, transport or tunnel. A transport modeSA, thereSA isan "outer" IP header that specifies the IPsec processing source and destination, plus an "inner" IP header that specifies the (apparently) ultimate source and destination for the packet. Thea securityprotocol header appears after the outer IP header, and before the inner IP header. If AH isassociation typically employedin tunnel mode, portions of the outer IP header are afforded protection (as above), as well as all of the tunneled IP packet (i.e., allbetween a pair ofthe inner IP header is protected, as well as next layer protocols). If ESP is employed, the protection is afforded only to the tunneled packet, nothosts tothe outer header. In summary, a) A host implementationprovide end-to-end security services. When security is desired between two intermediate systems along a path (vs. end-to-end use ofIPsec MUST support bothIPsec), transportand tunnel mode. This is true for native, BITS, and BITW implementations for hosts. b) Amode MAY be used between security gateways or between a security gatewayMUST support tunnel modeandMAY support transport mode. If it supportsa host. In the latter case, transportmode, that shouldmode may be usedonly whento support in-IP tunneling (e.g., IP-in-IP [Per96] or GRE tunneling [FaLiHaMeTr00]) over transport mode SAs. To further clarify, the use of transport mode by an intermediate system (e.g., a securitygatewaygateway) isactingpermitted only when applied to packets whose source address (for outbound packets) or destination address (for inbound packets) is an address belonging to the intermediate system itself. The access control functions that are an important part of IPsec are significantly limited in this context, as they cannot be applied to the end-to-end headers of the packets that traverse ahost, e.g., fortransport mode SA used in this fashion. Thus this way of using transport mode should be evaluated carefully before Kent & Seo [Page12]13] Internet Draft Security Architecture for IPJanuaryApril 2004network management, or to provide link security. 4.2 Security Association Functionality The set of security services offered by an SA depends on thebeing employed in a specific context. In IPv4, a transport mode security protocolselected, the SA mode,header appears immediately after theendpoints of the SA, and on the election of optional services within the protocol. For example, both AHIP header andESP offer integrityany options, andauthentication services, butbefore any next layer protocols (e.g., TCP or UDP). In IPv6, thecoverage differs for eachsecurity protocoland differs for transport vs. tunnel mode. Ifheader appears after theintegrity of an IPv4 option or IPv6 extensionbase IP headermust be protected en route between senderandreceiver, AH can provide this service, except forselected extension headers, but may appear before or after destination options; it MUST appear before next layer protocols (e.g., TCP, UDP, SCTP). In themutable (non- predictable) partscase of ESP, a transport mode SA provides security services only for these next layer protocols, not for the IP header or any extensionheaders. However,headers preceding thesame security may be achieved in some contexts by applyingESPto a tunnel carrying a packet. The granularityheader. In the case ofaccess control providedAH, the protection isdetermined byalso extended to selected portions of thechoiceIP header preceding it, selected portions of extension headers, and selected options (contained in theselectors that define each security association. Moreover,IPv4 header, IPv6 Hop-by-Hop extension header, or IPv6 Destination extension headers). For more details on theauthentication means employedcoverage afforded byIPsec peers, e.g., during creation ofAH, see the AH specification [Ken04b]. A tunnel mode SA is essentially anIKE (vs. child)SAalso effectsapplied to an IP tunnel, with thegranularityaccess controls applied to the headers of theaccess control afforded. If confidentiality is selected, then an ESP (tunnel mode) SA between two security gateways can offer partialtrafficflow confidentiality. The use ofinside the tunnel. Two hosts MAY establish a tunnel modeallows the inner IP headers to be encrypted, concealingSA between themselves. Aside from theidentitiestwo exceptions below, whenever either end of a security association is a security gateway, the(ultimate) traffic source and destination. Moreover, ESP payload padding also canSA MUST beinvoked to hide the size of the packets, further concealing the external characteristics of the traffic. Similartunnel mode. Thus an SA between two security gateways is typically a tunnel mode SA, as is an SA between a host and a security gateway. The two exceptions are as follows. o Where trafficflow confidentiality services may be offered whenis destined for amobile usersecurity gateway, e.g., SNMP commands, the security gateway isassignedacting as adynamic IP address inhost and transport mode is allowed. In this case, the SA terminates at adialup context,host (management) function within a security gateway andestablishesthus merits different treatment. o As noted above, security gateways MAY support a(tunnel mode) ESPtransport mode SA to provide security for IP traffic between two systems along acorporate firewall (acting aspath, e.g., between a host and a securitygateway). Note that fine granularity SAs generally are more vulnerable to traffic analysis than coarse granularity ones that are carrying traffic from many subscribers. NOTE: A compliant implementation MUST NOT allow instantiationgateway or between two security gateways. Several concerns motivate the use ofan ESP SA that employs both NULL encryption and no integrity algorithm. An attempt to negotiate suchtunnel mode for an SAis an auditable eventinvolving a security gateway. For example, if there are multiple paths (e.g., via different security gateways) to the same destination behind multiple security gateways, it is important that an IPsec packet be sent to the security gateway with which the SA was negotiated. Similarly, a packet that might be fragmented en-route must have all the fragments delivered to the same IPsec instance for reassembly prior to cryptographic processing. Also, when a fragment is processed byboth initiatorIPsec andresponder. The audit log entrytransmitted, then fragmented en-route, it is critical that there be inner and outer headers to retain the fragmentation state data forthis event SHOULD includethecurrent date/time, local IKE IP address,pre- andremote IKE IP address. The initiator SHOULD record the relevant SPD entry.post-IPsec packet formats. Hence there Kent & Seo [Page13]14] Internet Draft Security Architecture for IPJanuaryApril 20044.3 Combining Security Associations This document does not require supportare several reasons fornestedemploying tunnel mode when either end of an SA is a securityassociations or for what RFC 2401 called "SA bundles." These features stillgateway. Note: AH and ESP cannot be applied using transport mode to IPv4 packets that are fragments. Only tunnel mode can beeffected by appropriate configuration of both the SPD and the local forwarding functions (for inbound and outbound traffic), butemployed in such cases. For IPv6, it would be feasible to carry a plaintext fragment on a transport mode SA; however, for simplicity, thisfunction is outsiderestriction also applies to IPv6 packets. See Section 7 for more details on handling plaintext fragments on the protected side of the IPsecmodule and thus the scope of this specification. Asbarrier. For aresult, management of nested/bundled SAstunnel mode SA, there ispotentially more complex and less assured than under the model implied by RFC 2401. An implementationan "outer" IP header thatprovides support for nested SAs SHOULD provide a management interfacespecifies the IPsec processing source and destination, plus an "inner" IP header thatenables a user or administrator to expressspecifies thenesting requirement,(apparently) ultimate source andthen createdestination for theappropriate SPD entriespacket. The security protocol header appears after the outer IP header, andforwarding table entries to effectbefore therequisite processing. 4.4 Major IPsec Databases Manyinner IP header. If AH is employed in tunnel mode, portions of thedetails associated with processingouter IPtraffic in an IPsec implementationheader arelargely a local matter, not subject to standardization. However, some external aspectsafforded protection (as above), as well as all of theprocessing must be standardized, to ensure interoperability and to provide a minimum management capability that is essential for productive use of IPsec. This section describes a general model for processingtunneled IPtraffic relative to IPsec functionality, in supportpacket (i.e., all ofthese interoperability and functionality goals. The model described belowthe inner IP header isnominal; implementations need not match details of this modelprotected, aspresented, butwell as next layer protocols). If ESP is employed, theexternal behavior of implementations MUST correspondprotection is afforded only to theexternally observable characteristics of this model in ordertunneled packet, not tobe deemed compliant. There are two nominal databases in this model:theSecurity Policy Database and the Security Association Database. The first specifies the policies that determine the disposition of all IP traffic inbound or outbound from aouter header. In summary, a) A hostorimplementation of IPsec MUST support both transport and tunnel mode. This is true for native, BITS, and BITW implementations for hosts. b) A securitygateway. The second database contains parametersgateway MUST support tunnel mode and MAY support transport mode. If it supports transport mode, thatare associated with each established (keyed) security association. A third database,should be used only when thePeer Authorization Database (PAD)security gateway isalso required. The PAD providesacting as alinkhost, e.g., for network management, or to provide security between two intermediate systems along a path. 4.2 Security Association Functionality The set of security services offered by an SAmanagementdepends on the security protocollike IKE andselected, theSPD. The PAD indicatesSA mode, therangeendpoints ofidentities that a peer is authorized to represent when (child) SAs are negotiated withthepeer. The identities may be a list of IP address ranges or symbolic names. The fundamental requirement associated withSA, and on thePAD is thatelection of optional services within thetraffic selectors passed byprotocol. For example, both AH and ESP offer integrity and authentication services, but theSA managementcoverage differs for each protocol and differs forcomparison againsttransport vs. tunnel mode. If theSPD MUSTintegrity of an IPv4 option or IPv6 extension header must beverified as authorized relative toprotected en-route between sender and receiver, AH can provide this service, except for theauthenticated peermutable (non- predictable) parts of theSA management protocol. (See also Section 4.5.3, which levies requirements onIP or extension headers. However, thePADsame security may be achieved in some contexts by applying ESP to a tunnel carrying a packet. Kent & Seo [Page14]15] Internet Draft Security Architecture for IPJanuaryApril 2004support of locating security gateways.)ThePAD also specifies how to authenticate each peer, e.g., via shared secret or usegranularity ofa certificate. If a shared secretaccess control provided isused,determined by thesecret is stored here. If a certificate is used,choice of thetrust anchor forselectors that define each security association. Moreover, thecertificate is partauthentication means employed by IPsec peers, e.g., during creation of an IKE (vs. child) SA also effects thePAD. Because the PAD might be incorporated intogranularity of theSA management protocol implementation, it is not discussed extensively in this document.access control afforded. If confidentiality is selected, then anIPsec implementation acts as aESP (tunnel mode) SA between two securitygateway for multiple subscribers, it MAY implement multiple separate IPsec contexts. Each context MAY have andgateways can offer partial traffic flow confidentiality. The usecompletely independent identities, policies, key management SAs, and/or IPsec SAs. This is forof tunnel mode allows themost part a local implementation matter. However, a means for associating inbound (SA) proposals with local contexts is required. To this end, if supported byinner IP headers to be encrypted, concealing thekey management protocol in use, context identifiers MAYidentities of the (ultimate) traffic source and destination. Moreover, ESP payload padding also can beconveyed from initiatorinvoked toresponder inhide thesignaling messages, withsize of theresult that IPsec SAs are created with a binding to a particular context. The IPsec model described here embodies a clear separation between forwarding (routing) and security decisions, to accommodate a wide rangepackets, further concealing the external characteristics ofcontexts where IPsec may be employed. Forwarding may be trivial, inthecase where there are only two interfaces, or ittraffic. Similar traffic flow confidentiality services may becomplex, e.g., if there are multiple protected or unprotected interfaces or if the context in which IPsec is implemented employsoffered when asophisticated forwarding function. IPsec assumes only that outbound and inbound traffic that has passed through IPsec processingmobile user isforwarded inassigned afashion consistent with the contextdynamic IP address inwhich IPsec is implemented. Support for nested SAs is optional; if required, it requires coordination between forwarding tablesa dialup context, andSPD entries to causeestablishes apacket(tunnel mode) ESP SA totraverse the IPsec boundarya corporate firewall (acting as a security gateway). Note that fine granularity SAs generally are more vulnerable to traffic analysis thanonce. 4.4.1 The Security Policy Database (SPD)coarse granularity ones that are carrying traffic from many subscribers. NOTE: Asecurity association is a management construct usedcompliant implementation MUST NOT allow instantiation of an ESP SA that employs both NULL encryption and no integrity algorithm. An attempt toenforce security policy for traffic crossing the IPsec boundary. Thusnegotiate such anessential element ofSAprocessingis anunderlying Security Policy Database (SPD) that specifies what services are to be offered to IP datagramsauditable event by both initiator andin what fashion.responder. Theform of the databaseaudit log entry for this event SHOULD include the current date/time, local IKE IP address, andits interface areremote IKE IP address. The initiator SHOULD record the relevant SPD entry. 4.3 Combining Security Associations This document does not require support for nested security associations or for what RFC 2401 called "SA bundles." These features still can be effected by appropriate configuration of both the SPD and the local forwarding functions (for inbound and outbound traffic), but this capability is outside of the IPsec module and thus the scope of this specification.However, this section specifies minimumAs a result, managementfunctionalityof nested/bundled SAs is potentially more complex and less assured than under the model implied by RFC 2401. An implementation thatmust be provided, to allowprovides support for nested SAs SHOULD provide a management interface that enables a user orsystemadministrator tocontrol whetherexpress the nesting requirement, andhow IPsec is appliedthen create the appropriate SPD entries and forwarding table entries totraffic transmitted or received by a host or transiting a security gateway. The SPD, or relevant caches, must be consulted duringeffect theprocessingrequisite processing. 4.4 Major IPsec Databases Many ofALL traffic (inbound and outbound), including non-IPsec traffic, that traversesthe details associated with processing IP traffic in an IPsec implementation are largely a local matter, not subject to Kent & Seo [Page15]16] Internet Draft Security Architecture for IPJanuaryApril 2004boundary. This includes IPsecstandardization. However, some external aspects of the processing must be standardized, to ensure interoperability and to provide a minimum management capability that is essential for productive use of IPsec. This section describes a general model for processing IP trafficsuch as IKE. Anrelative to IPsecimplementation MUST have at least one SPD, and it MAY support multiple SPDs, if appropriate for the contextfunctionality, inwhich the IPsec implementation operates. Theresupport of these interoperability and functionality goals. The model described below isno requirement to maintain SPDs on a per interface basis,nominal; implementations need not match details of this model aswas specified in RFC 2401. However, if an implementation supports multiple SPDs, then itpresented, but the external behavior of implementations MUSTinclude an explicit SPD selection function, that is invokedcorrespond toselecttheappropriate SPD for outbound traffic processing. The inputs toexternally observable characteristics of thisfunctionmodel in order to be deemed compliant. There are three nominal databases in this model: theoutbound packetSecurity Policy Database (SPD), the Security Association Database (SAD), andany local metadata (e.g.,theinterface via whichPeer Authorization Database (PAD). The first specifies thepacket arrived) required to effectpolicies that determine theSPD selection function. The outputdisposition ofthe function is an SPD ID. Each SPD entry is either implicitly or explicitly directional. Forall IP trafficprotected by IPsec, the source and destination address and ports are swapped to represent directionality, consistent with IKE conventions. For bypassed or discarded traffic, separateinboundandor outboundentriesfrom a host or security gateway (Section 4.4.1). The second database contains parameters that aresupported, e.g., to permit unidirectional flows if required.associated with each established (keyed) security association (Section 4.4.2). Peer Authorization Database (PAD) TheSPD is an orderedthird database,consistent withtheuse of ACLs or packet filters in firewalls, routers, etc. The ordering requirement arises because entries often will overlap due toPeer Authorization Database (PAD) provides a link between an SA management protocol like IKE and thepresenceSPD. The PAD indicates the range of(non-trivial) ranges as values for selectors. Thus a useridentities that an IPv4 oradministrator MUST be able to order the entries to express a desired access control policy. ThereIPv6 peer isno wayauthorized toimposerepresent when (child) SAs are negotiated with the peer. The identities may be ageneral, canonical order on SPD entries, becauselist of IPv4 or IPv6 address ranges or symbolic names. The IP version of theallowed useidentities does not have to be the same as that ofwildcards for selector values and becausethedifferent typesIP version ofselectors are not hierarchically related.the peer representing them. Theprocessing model described in this document assumesfundamental requirement associated with the PAD is that the traffic selectors passed by the SA management protocol for comparison against theability to decorrelate overlappingSPDentriesMUST be verified as authorized relative topermit caching, which enables more efficient processingthe authenticated peer ofoutbound trafficthe SA management protocol. (See also Section 4.5.3, which levies requirements on the PAD insecurity gateways and BITS/BITW implementations. (Native host implementations have an implicit formsupport ofcaching available, duelocating security gateways.) The PAD also specifies how totheauthenticate each peer, e.g., via shared secret or useof, for example, socket interfaces for applications, and thus thereof a certificate. If a shared secret isno requirement to be able to decorrelate SPD entries in these implementations.) Decorrelationused, the secret is stored here. If ameans of improving performance and simplifying the processing description; itcertificate isnot a requirementused, the trust anchor fora compliant implementation. Appendix B provides an algorithm that can be used to decorrelate SPD entries, but any algorithm that produces equivalent output may be used. Note that when an SPD entry is decorrelated alltheresulting entries MUST be grouped together, so that all memberscertificate is part of thegroup derived from an individual, SPD entry (prior to decorrelation) can allPAD. Because the PAD might beplaced into caches andincorporated into theSAD at the same time. The intentSA management protocol implementation, it isthat use of a decorrelated SPD oughtnotcreate more SAs than woulddiscussed extensively in this document. Multiple Separate IPsec Contexts If an IPsec implementation acts as a security gateway for multiple subscribers, it MAY implement multiple separate IPsec contexts. Each context MAY haveresulted fromand useof a not-decorrelated SPD.completely independent identities, policies, key management SAs, and/or IPsec SAs. This is for the Kent & Seo [Page16]17] Internet Draft Security Architecture for IPJanuaryApril 2004An SPD must discriminate among traffic that is afforded IPsec protection and traffic thatmost part a local implementation matter. However, a means for associating inbound (SA) proposals with local contexts isallowed to bypass IPsec. This applies torequired. To this end, if supported by theIPsec protection tokey management protocol in use, context identifiers MAY beapplied by a sender andconveyed from initiator to responder in theIPsec protection that must be present atsignaling messages, with thereceiver. For any outbound or inbound datagram, three processing choicesresult that IPsec SAs arepossible: discard, bypass IPsec, or apply IPsec. The first choice referscreated with a binding totraffica particular context. For example, a security gateway thatis not allowedprovides VPN service totraverse the IPsec boundary (in the specified direction). The second choice refersmultiple customers will be able to associate each customer~Os trafficthat is allowed to pass without additional IPsec protection.with the correct VPN. Forwarding vs Security Decisions Thethird choice refers to traffic that is affordedIPsecprotection,model described here embodies a clear separation between forwarding (routing) andfor such traffic the SPD must specify the security protocols to be employed, their mode,securityservice options, and the cryptographic algorithmsdecisions, tobe used. An SPD is logically divided into three pieces, allaccommodate a wide range ofwhich should be decorrelated (with the exception noted above for native host implementations) to facilitate caching. The SPD-S (secure traffic) contains entries for all traffic subject tocontexts where IPsecprotection. SPD-O (outbound) contains entries for all outbound traffic that is tomay bebypassed or discarded. SPD-I (inbound) is applied to inbound traffic that willemployed. Forwarding may bebypassed or discarded. If an IPsec implementation supports only one SPD, thentrivial, in theSPD consists of all three parts. If multiple SPDscase where there aresupported, some of themonly two interfaces, or it may bepartial,complex, e.g.,some SPDs might containif there are multiple protected or unprotected interfaces or if the context in which IPsec is implemented employs a sophisticated forwarding function. IPsec assumes onlySPD-I entries, to controlthat outbound and inboundbypassedtrafficonthat has passed through IPsec processing is forwarded in aper-interface basis. The split allows SPD-I to be consulted without having to consult SPD-S, for such traffic. Sincefashion consistent with theSPD-Icontext in which IPsec isjust a part of the SPD, the same rule applies here, i.e.,implemented. Support for nested SAs is optional; if required, it requires coordination between forwarding tables and SPD entries to cause a packetthat is looked up into traverse theSPD-I cannot be matchedIPsec boundary more than once. Local" vs "Remote" In this document, with respect toan entry there, thenIP addresses and ports, thepacket MUST be discarded. Note thatterms "Local" and "Remote" are used foroutbound traffic, if a match is not found in SPD-S, then SPD-O must be checkedpolicy rules. "Local" refers tosee ifthetraffic should be bypassed. Similarly, if SPD-O is checked first and no match is found, then SPD- S must be checked. For everyentity being protected by an IPsec implementation,there MUST be a management interface that allows a user or system administrator to managei.e., theSPD. The interface must allow"source" address/port of outbound packets or theuser (or administrator)"destination" address/port of inbound packets. "Remote" refers tospecifya peer entity or peer entities. The terms "source" and "destination" are used for packet header fields. "Non-initial" vs "Initial" Fragments Throughout this document, thesecurity processing to be appliedphrase "non-initial" fragments is used toevery packetmean fragments thattraverses the IPsec boundary. (In a native host IPsec implementation making usedo not contain all ofa socket interface,theSPDselector values that maynot need tobeconsulted on a per packet basis, as noted above.) The management interfaceneeded forthe SPD MUST allow creation of entries consistent with the selectors defined in Section 4.4.2,access control (e.g., they might not contain Next Layer Protocol, source andMUST support (total) ordering of these entries, as seen via this interface. The SPD entries' selectors are analogous todestination ports, ICMP message type/code, Mobility Header type). And theACL or packet filters commonly found inphrase "initial" fragment is used to mean astateless firewall or packet filtering router and which are currently managed this way. In host systems, applications MAYfragment that contains all the selector values needed for access control. However, it should beallowed to create SPD entries. (The means of signaling such requests tonoted that for IPv6, which fragment contains theIPsec implementation are outsideNext Layer Protocol and ports (or ICMP message type/code or Mobility Header type) will depend on thescopekind and number ofthis standard.) However, the systemextension headers present. The Kent & Seo [Page17]18] Internet Draft Security Architecture for IPJanuaryApril 2004administrator MUST be able to specify whether or"initial" fragment might not be the first fragment. 4.4.1 The Security Policy Database (SPD) A security association is auser or application can override (default) system policies.management construct used to enforce security policy for traffic crossing the IPsec boundary. Thus an essential element of SA processing is an underlying Security Policy Database (SPD) that specifies what services are to be offered to IP datagrams and in what fashion. The form of themanagement interface is not specified by this document and may differ for hosts vs. security gateways,database andwithin hosts theits interfacemay differ for socket-based vs. BITS implementations.are outside the scope of this specification. However, thisdocument does specify a standard set of SPD elements that all IPsec implementations MUST support. Each SPD entrysection specifiespacket disposition as BYPASS, DISCARD, or IPsec. The entry is keyed by a list of one or more selectors. The SPD contains an ordered list of these entries. The required selector types are defined in Section 4.4.2. These selectors are used to define the granularity of the SAsminimum management functionality thatare created in response to an outbound packet or in responsemust be provided, toa proposal from a peer. The SPD MUST permitallow a user or system administrator tospecify policy entries as follows: - SPD-I: For inbound traffic thatcontrol whether and how IPsec is applied tobe bypassed or discarded, the entry consists of the values of the selectors that apply to thetrafficto be bypassedtransmitted ordiscarded. - SPD-O: For outbound traffic that is to be bypassedreceived by a host ordiscarded, the entry consists oftransiting a security gateway. The SPD, or relevant caches, must be consulted during thevaluesprocessing ofthe selectors that apply to theALL trafficto be bypassed or discarded. - SPD-S: For(inbound and outbound), including trafficthat is to benot protectedusingby IPsec,the entry consists of the values of the selectorsthatapply totraverses the IPsec boundary. This includes IPsec management trafficthat the initiator will send or receivesuch as IKE. An IPsec implementation MUST have at least one SPD, and it MAY support multiple SPDs, if appropriate for thevalues that apply to the traffic that the responder will receive or send. - The selector types are defined in Section 4.2.2 below. For each selector in an SPD entry,context inaddition towhich theliteral values that define a match, there are two special values: ANY and OPAQUE. The former value is a wildcard that matches any value in the corresponding field of the packet, whereas the latter value indicates that the corresponding selector fieldIPsec implementation operates. There isnot examined, e.g., because it may be obscured by encryption already appliedno requirement tothe packet or may not be present inmaintain SPDs on afragment. For each selectorper interface basis, as was specified in RFC 2401. However, if an implementation supports multiple SPDs, then it MUST include an explicit SPDentry, the policy entry specifies howselection function, that is invoked toderiveselect thecorresponding valuesappropriate SPD fora new Security Association Database (SAD, see Section 4.4.3) entry from those inoutbound traffic processing. The inputs to this function are theSPDoutbound packet and any local metadata (e.g., thepacket.interface via which the packet arrived) required to effect the SPD selection function. Thegoaloutput of the function isto allow an SAD entry andan SPDcache entry to be created based on specific selector values from the packet, or from the matchingID. The SPDentry. If IPsec processingisspecified foranentry, a "populate from packet" (PFP) flag may be asserted for one or more of the selector types in the SPD entry. If present,ordered database, consistent with theflag applies to all selectorsuse ofthe indicated typeACLs or packet filters in firewalls, routers, etc. The ordering requirement arises because entries often will overlap due to theoutbound elementpresence ofthe pair. (PFP does not apply to inbound traffic.) Kent & Seo [Page 18] Internet Draft Security Architecture(non-trivial) ranges as values forIP January 2004 Note that this text describes the representation in the SPD that maps into IKE payloads, i.e., one should not create SPD entries that cannotselectors. Thus a user or administrator MUST bemapped into what IKE can negotiate. The management GUI can offerable to order theuser other formsentries to express a desired access control policy. There is no way to impose a general, canonical order on SPD entries, because ofdata entry and display, e.g.,theoptionallowed use ofusing address prefixes as well as ranges, and symbolic nameswildcards forprotocols, ports, etc. (Do not confuseselector values and because theusedifferent types ofsymbolic names in a management interface with theselectors are not hierarchically related. Processing Choices --> DISCARD, BYPASS, PROTECT An SPDselector "name".) If the reserved, symbolic selector value OPAQUE or ANYmust discriminate among traffic that isemployed forafforded IPsec protection and traffic that is allowed to bypass IPsec. This applies to the IPsec protection to be applied by agiven selector type, only it may appear insender and to thelist forIPsec protection thattype, and itmustappear only once inbe present at thelistreceiver. For any outbound or inbound datagram, three processing choices are possible: DISCARD, BYPASS IPsec, or PROTECT using IPsec. The Kent & Seo [Page 19] Internet Draft Security Architecture for IP April 2004 first choice refers to traffic thattype. Note that "ANY"isa local syntax convention - IKE handles this concept via ranges. The following example illustrates the use ofnot allowed to traverse thePFP flag inIPsec boundary (in thecontext of a security gateway or a BITS/BITW implementation. Consider an SPD entry where the allowed value for destination address is a range of IPv4 addresses: 192.168.2.1specified direction). The second choice refers to192.168.2.10. Suppose an outbound packet arrives with a destination address of 192.168.2.3, and theretraffic that isno extant SAallowed tocarry this packet. The value used forcross theSA createdIPsec boundary without IPsec protection. The third choice refers totransmit this packet could be either of the two values shown below, depending on what the SPD entry for this selector saystraffic that isthe source of the selector value: sourceafforded IPsec protection, and for such traffic theexample of new valueSPD must specify the security protocols to beSAD destination address used inemployed, their mode, security service options, and theSA selector value --------------- ------------ a. PFP TRUE 192.168.2.3 (one host) b. PFP FALSE 192.168.2.1cryptographic algorithms to192.168.2.10 (range of hosts) Note that if thebe used. SPD-S, SPD-I, SPD-O An SPDentry had a value of ANYis logically divided into three pieces. The SPD-S (secure traffic) contains entries forthe destination address, then the SAD selector value would haveall traffic subject tobe ANY for case (b), but would still be as illustratedIPsec protection. SPD-O (outbound) contains entries forcase (a). Thus the PFP flag canall outbound traffic that is to beusedbypassed or discarded. SPD-I (inbound) is applied toprohibit sharing of an SA, even among packetsinbound traffic thatmatch the same SPD entry. 4.4.2 Selectors An SA maywill befine-grainedbypassed orcoarse-grained, depending on the selectors used to define the setdiscarded. All three oftrafficthese can be decorrelated (with the exception noted above for native host implementations) to facilitate caching. If an IPsec implementation supports only one SPD, then theSA. For example,SPD consists of alltraffic between two hoststhree parts. If multiple SPDs are supported, some of them may becarried via a single SA, and afforded a uniform set of security services. Alternatively,partial, e.g., some SPDs might contain only SPD-I entries, to control inbound bypassed trafficbetweenon apair of hosts mightper-interface basis. The split allows SPD-I to bespread over multiple SAs, depending on the applications being used (as defined byconsulted without having to consult SPD- S, for such traffic. Since theNext Protocol and Port fields), with different security services offered by different SAs. Similarly, all traffic betweenSPD-I is just apairpart ofsecurity gateways could be carried onthe SPD, the same rule applies here, i.e., if asingle SA, or one SA couldpacket that is looked up in the SPD-I cannot beassigned for each Kent & Seo [Page 19] Internet Draft Security Architecture for IP January 2004 communicating host pair. The following selector parametersmatched to an entry there, then the packet MUST besupported by all IPsec implementations to facilitate control of SA granularity.discarded. Note thatboth Source and Destination addresses should either be IPv4 or IPv6, but notfor outbound traffic, if amix of address types. Also, note that the source/destination port selectors maymatch is not found in SPD-S, then SPD-O must belabeled as "OPAQUE" to accommodate situations where these fields are inaccessible because of prior encryption or duechecked to see if the traffic should be bypassed. Similarly, if SPD-O is checked first and no match is found, then SPD-S must be checked. SPD entries Each SPD entry specifies packetfragmentation. - Destination IP Address (IPv4disposition as BYPASS, DISCARD, orIPv6): thisPROTECT. The entry is keyed by a list ofranges of IP addresses (unicast, anycast, broadcast (IPv4 only), or multicast group). This structure allows expression of a single IP address (via a trivial range), or a list of addresses (each a trivial ranges),one ora range of addresses (high and low values, inclusive), as well as the most generic form of amore selectors. The SPD contains an ordered list ofranges. Address rangesthese entries. The required selector types are defined in Section 4.4.1.1. These selectors are used tosupport more than one destination system sharingdefine thesame SA, e.g., behind a security gateway. - Source IP Address(es) (IPv4 or IPv6): this is a list of rangesgranularity ofIP addresses (unicast, anycast, broadcast (IPv4 only),the SAs that are created in response to an outbound packet ormulticast group). This structure allows expression of a single IP address (viain response to atrivial range), orproposal from alistpeer. The detailed structure ofaddresses (each a trivial ranges), oran SPD entry is described in Section 4.4.1.2. Every SPD SHOULD have arange of addresses (highnominal, final entry that matches anything that is otherwise unmatched, andlow values, inclusive), as well as the most generic form ofdiscards it. The SPD MUST permit alist of ranges. Address ranges are useduser or administrator tosupport more than one source system sharing the same SA, e.g., behind a security gateway.specify policy entries as follows: -Next Layer Protocol: Obtained from the IPv4 "Protocol" or the IPv6 "Next Header" fields. This is an individual protocol number, or ANY. The Next Layer Protocol is whatever comes after any IP extension headersSPD-I: For inbound traffic thatare present. To simplify locating the Next Layer Protocol in the IPv6 context, there SHOULD be a mechanism for configuring which IP extension headers to skip, e.g., Destination Options, Routing Header, Fragmentation Header, Mobility Header, Hop-by-hop options, etc. Several additional selectors depend on the Next Layer Protocol value: * If the Next Layer Protocol uses ports (e.g., TCP, UDP, SCTP, ...), then there are selectors for Source and Destination Ports: Each of these selectorsisa list of ranges of values. Note that the source and destination ports may notto beavailable inbypassed or discarded, thecase of receipt of a fragmented packet, thus a valueentry consists of"OPAQUE" also MUST be supported. Note: In a non-initial fragment, portthe valueswill not be available. Ifof theSA requires a non-OPAQUE port value, an arriving fragment MUST be discarded.selectors that apply to Kent & Seo [Page 20] Internet Draft Security Architecture for IPJanuaryApril 2004* IftheNext Layer Protocol is a Mobility Header, then there is a selector for IPv6 Mobility Header Message Type (MH type) [Mobip]. This is an 8-bit valuetraffic to be bypassed or discarded. - SPD-O: For outbound traffic thatidentifies a particular mobility message. * If the Next Layer Protocol valueisICMP then there are selectors forto be bypassed or discarded, theICMP message type and code. The message type is a single 8-bit value, which definesentry consists of thetypevalues ofan ICMP message, or ANY. The ICMP code is single 8-bit valuethe selectors thatdefines a specific subtype for an ICMP message. This selector canapply to the traffic to bea single value,bypassed orANY.discarded. -Name: A nameSPD-S: For traffic that isused as a symbolic identifier for an IPsec source or destination address. Thus an SPDto be protected using IPsec, the entry consists of the values of the selectors thathas a non- null Name selector MUST set eitherapply to thesourcetraffic to be protected via AH ordestination IP address selectorESP, controls on how toNULL in the corresponding, directional SPD entry. a. an RFC 822 address, e.g., mozart@foo.example.com b. X.500 distinguished name c. a fully qualified DNS name, e.g., foo.example.com Use of this selector is different from allcreate SAs based on these selectors, and theother selectors described above. Names do not appear in packets, so it is not possibleparameters needed tomatch a packet againsteffect this protection (e.g., algorithms, modes, etc.). Note that anSPDSPD-S entrybasedalso contains information such as "populate from packet" (PFP) flag (see paragraphs below ona Name selector. Name selectors are used to trigger creation"How To Derive the Values for an SAD entry") and bits indicating whether the SA lookup makes use ofSPD cache (SPD-Sthe local andSPD-O) (and SAD) entries, which are then populated with specificremote IPsource or destinationaddressesprovided by the SA management protocol. For a native host implementation, a Name may be usedinan SPD entryaddition toprovide finer granularity access control that would be otherwise be available on multi-user systems. In this case,the SPI (see AH [Ken04b] or ESP [Ken04a] specifications). Representing directionality in an SPD entrymay be consulted when SA creation is initiatedFor traffic protected by IPsec, thehost, or when the host is a responder. The Name refers toLocal and Remote address and ports in anentity atSPD entry are swapped to represent directionality, consistent with IKE conventions. In general, thehost in question, andprotocols that IPsec deals with have theimplementation relies on its integration intoproperty of requiring symmetric SAs with flipped Local/Remote IP addresses. However, for ICMP, there is often no such bi-directional authorization requirement. Nonetheless, for thehost OS to ensure appropriate linking tosake of uniformity and simplicity, SPD entries for ICMP are specified in thenamed entity's process. Thesame way as for otheruseprotocols. Note also that for ICMP, Mobility Header, and non- initial fragments, there are no port fields in these packets. ICMP has message type and code and Mobility Header has mobility header type. Thus SPD entries have provisions for expressing access controls appropriate for these protocols, in lieu of theName selector occurs when any IPsec implementation (native host, BITW, BITS,normal port field controls. For bypassed orsecurity gateway) is contacted by a peer whose address cannot be known a priori,discarded traffic, separate inbound and outbound entries are supported, e.g.,a road warrior. In this context,to permit unidirectional flows if required. OPAQUE and ANY For each selector in an SPD entry, in addition to theNameliteral values that define a match, there are two special values: ANY and OPAQUE. ANY isuseda wildcard that matches any value inlieu oftheIP addresscorresponding field of thepeer, who must be an initiator ofpacket, or that matches packets where that field is not present or is obscured. OPAQUE indicates that theSA creation. [Thiscorresponding selectordescriptionfield is not available for examination because it maychange based on discussion of some name/identity issues that haven't yet been posted to the list.] The IPsec implementation context determines how selectors are used. For example, a native host implementation typically makes use of a socket interface. Whennot be present in anew connection is establishedfragment or does not exist for theSPD can be consulted and an SA bound togiven Next Layer Protocol. ANY includes OPAQUE. How To Derive thesocket. Thus traffic sent viaValues for an SAD entry Kent & Seo [Page 21] Internet Draft Security Architecture for IPJanuaryApril 2004that socket need not resultFor each selector inadditional lookupsan SPD entry, the entry specifies how to derive the corresponding values for a new Security Association Database (SAD, see Section 4.4.2) entry from those in the SPD(SPD-OandSPD-S) cache. In contrast, a BITS, BITW, or security gateway implementation needsthe packet. The goal is tolook at each packetallow an SAD entry andperformanSPD/SPD-SSPD cachelookupentry to be created based on specific selector values from theselectors. 4.4.3 Security Association Database (SAD) In eachpacket, or from the matching SPD entry. If IPsecimplementation thereprocessing is specified for an entry, anominal Security Association Database, in which each entry defines the parameters associated with"populate from packet" (PFP) flag may be asserted for oneSA. Each SA has an entry inor more of theSAD. For outbound processing, entries are pointed to by entriesselectors in theSPD-S part of theSPDcache. For inbound processing, eachentryin the SAD is indexed by an SPI (from the AH(Local IP address, Remote IP address, Next Layer Protocol, and depending on Next Layer Protocol -- Local port, ICMP type/code orESP protocol header), plus source and/or destination addressMobility Header type; Remote port). If asserted formulticast SAs, as noted earlier. The following parameters are associated with each entry ina given selector, theSAD. They should all be present except where otherwise noted, e.g., AH Authentication algorithm. This description does not purportflag indicates that the SA to bea MIB, only a specification ofcreated should take its value for that selector from theminimal data items required to support an SAvalue inan IPsec implementation. For each oftheselectors defined in Section 4.4.2,packet. Otherwise, theentry for an inboundSA should take its value(s) for that selector from the value(s) in theSAD MUST containSPD entry. Note: In thevalue ornon-PFP case, the selector values negotiatedat the timeby the SAwas created. Formanagement protocol (e.g., IKEv2) may be areceiver, these values are used to check that the header fieldssubset ofan inbound packet match the selector values negotiated for the SA. Forthose in thereceiver, this is part of verifying that a packet arrivingSPD entry, depending onan SA is consistent withthe SPD policyforof theSA. (See Section 6 for rules forpeer. Also, whether a single flag is used for, e.g., source port, ICMPmessages.) These fields can have the form of specific values, ranges, ANY,type/code, and MH type, or"OPAQUE" as described in section 4.4.2, "Selectors."a separate flag is used for each, is a local matter. The followingdata items MUST beexample illustrates the use of the PFP flag in theSAD: o Security Parameter Index (SPI): a 32-bit value selected by the receiving endcontext of a security gateway or a BITS/BITW implementation. Consider anSA to uniquely identify the SA. In an SADSPD entry where the allowed value for Remote address is a range of IPv4 addresses: 192.168.2.1 to 192.168.2.10. Suppose an outboundSA, the SPIpacket arrives with a destination address of 192.168.2.3, and there isusedno extant SA toconstruct the packet's AH or ESP header. In an SAD entrycarry this packet. The value used foran inbound SA,theSPI is used to map trafficSA created to transmit this packet could be either of theappropriate SA (see texttwo values shown below, depending onunicast/multicast in Section 4.1). o Sequence Number Counter: a 64-bit or 32-bit value used to generatewhat theSequence Number field in AH or ESP headers. 64-bit sequence numbers areSPD entry for this selector says is thedefault, but 32-bit sequence numbers are also supported if negotiated. o Sequence Counter Overflow: asource of the selector value: PFP flagindicating whether overflowvalue example of new for theSequence Number Counter should generate an auditable event and prevent transmissionRemote SAD dest. address addr. selector selector value --------------- ------------ a. PFP TRUE 192.168.2.3 (one host) b. PFP FALSE 192.168.2.1 to 192.168.2.10 (range ofadditional packets onhosts) Note that if theSA, or whether Kent & Seo [Page 22] Internet Draft Security Architecture for IP January 2004 rollover is permitted. The audit logSPD entry above had a value of ANY forthis event SHOULD include the SPI value, current date/time, Source Address, Destination Address, andtheselectors fromRemote address, then therelevantSADentry. o Anti-Replay Window: a 64-bit counter and a bit-map (or equivalent) usedselector value would have todetermine whether an inbound AH or ESP packet is a replay. NOTE: If anti-replay has been disabled by the receiverbe ANY for case (b), but would still be as illustrated for case (a). Thus the PFP flag can be used to prohibit sharing of an SA,e.g., ineven among packets that match thecase ofsame SPD entry. Management Interface For every IPsec implementation, there MUST be amanually keyed SA, thenmanagement interface that allows a user or system administrator to manage theAnti-Replay Window is ignoredKent & Seo [Page 22] Internet Draft Security Architecture for IP April 2004 SPD. The interface must allow theSA in question. 64-bit sequence numbers are the default, but this counter size accommodates 32-bit sequence numbers. o AH Authentication algorithm, key, etc. This is required only if AH is supported. o ESP Encryption algorithm, key, mode, IV, etc. o ESP integrity algorithm, keys, etc. Ifuser (or administrator) to specify theintegrity service is not selected, these fields willsecurity processing to benull. o ESP combined mode algorithms, key(s), etc. This data is used whenapplied to every packet that traverses the IPsec boundary. (In acombined mode (encryption and integrity) algorithm is used with ESP. o Lifetimenative host IPsec implementation making use ofthis Security Association: a time interval after which an SA must be replaced withanew SA (and new SPI) or terminated, plus an indication of which of these actions should occur. Thissocket interface, the SPD may not need to beexpressed as a time or byte count, or a simultaneous use of both with the first lifetime to expire taking precedence. A compliant implementation MUST support both types of lifetimes, and must supportconsulted on asimultaneous use of both. If time is employed, and if IKE employs X.509 certificatesper packet basis, as noted above.) The management interface forSA establishment, the SA lifetime must be constrained bythevalidity intervalsSPD MUST allow creation of entries consistent with thecertificates,selectors defined in Section 4.4.1.1, andthe NextIssueDateMUST support (total) ordering of these entries, as seen via this interface. The SPD entries' selectors are analogous to theCRLs usedACL or packet filters commonly found inthe IKE exchange for the SA. Both initiatora stateless firewall or packet filtering router andresponderwhich areresponsible for constraining SA lifetime incurrently managed thisfashion. NOTE: The details of howway. In host systems, applications MAY be allowed tohandle the refreshingcreate SPD entries. (The means ofkeys when SAs expire is a local matter. However, one reasonable approach is: (a) If byte count is used, thensignaling such requests to the IPsec implementationSHOULD countare outside thenumberscope ofbytesthis standard.) However, the system administrator MUST be able towhichspecify whether or not a user or application can override (default) system policies. The form of theIPsec cryptographic algorithmmanagement interface isapplied. For ESP,not specified by thisis the encryption algorithm (including Null encryption)document and may differ forAH, this ishosts vs. security gateways, and within hosts theauthentication algorithm. This includes pad bytes, etc. Note that implementations SHOULDinterface may differ for socket-based vs. BITS implementations. However, this document does specify a standard set of SPD elements that all IPsec implementations MUST support. Decorrelation The processing model described in this document assumes the ability to decorrelate overlapping SPD entries to permit caching, which enables more efficient processing of outbound traffic in security gateways and BITS/BITW implementations. (Native host implementations have an implicit form of caching available, due to the use of, for example, socket interfaces for applications, and thus there is no requirement to be able tohandle havingdecorrelate SPD entries in these implementations.) Note: Decorrelation is a means of improving performance and simplifying thecounters atprocessing description; it is not a requirement for a compliant implementation. In this section, unless otherwise noted, theendsuse ofan SA get out"SPD" refers to the body ofsynch, e.g., becausepolicy information in both ordered or decorrelated (unordered) state. Appendix B provides an algorithm that can be used to decorrelate SPD entries, but any algorithm that produces equivalent output may be used. Note that when an SPD entry is decorrelated all the resulting entries MUST be linked together, so that all members ofpacketthe group derived from an individual, SPD entry (prior to decorrelation) can all be placed into caches and into the SAD at the same time. For example, suppose one starts with an entry A (from an ordered SPD) that when decorrelated, yields entries A1, Kent & Seo [Page 23] Internet Draft Security Architecture for IPJanuaryApril 2004loss or becauseA2 and A3. When a packet comes along that matches, say A2, and triggers theimplementations at each endcreation of an SA, the SAaren't doing things the same way. (b) There SHOULD be two kinds of lifetime -- a soft lifetime that warns the implementation to initiate action such as setting up a replacement SA;management protocol, e.g., IKEv2, negotiates A. And all 3 decorrelated entries, A1, A2, anda hard lifetime whenA3 are placed in thecurrent SA endsappropriate SPD-S cache andis destroyed. (c) Iflinked to theentire packet doesSA. The intent is that use of a decorrelated SPD ought notget delivered during thecreate more SAslifetime, the packet SHOULD be discarded. o IPsec protocol mode: tunnel or transport. Indicates which modethan would have resulted from use ofAH or ESPa not-decorrelated SPD. Note also that if a decorrelated SPD isapplied to traffic on this SA. o Path MTU: any observed path MTU and aging variables. See Section 6.1.2.4 o Tunnel header IP source and destination address - both addresses mustemployed, the original entry from the (correlated) SPD should beeither IPv4 or IPv6 addresses. The version impliesretained and passed to thetype of IP headerSA management protocol, e.g., IKE. Passing the correlated SPD entry tobe used. Only used whentheIPsecSA management protocolmode is tunnel. The following table summarizeskeeps thekindsuse ofentries that one needs to be ablea decorrelated SPD a local matter, not visible toexpress inpeers. When acting as a responder, the peer uses a correlated SPD entry for matching, andSAD. It also shows how they relatefor issuing a "narrowed" response. Then the decorrelated entries are used to populate thefields in data traffic being subjectedSPD-S cache. Handling Changes toIPsec screening. [Tablethe SPD while the System is Running If a change is made tobe added inthe SPD while the system is running, afuture draft.] 4.5 SA and Key Management IPsec mandates support for both manual and automated SA and cryptographic key management. The IPsec protocols, AH and ESP, are largely independentcheck SHOULD be made of theassociated SA management techniques, although the techniques involved doaffectsomeof this change on extant SAs. This document does not impose a requirement to do this, but an implementation MAY choose to check thesecurity services offered by the protocols. For example, the optional anti- replay service available for AHimpact of an SPD change on extant SAs andESP requires automatedto provide a user/administrator with a mechanism for configuring what actions to take, e.g., delete an affected SA, allow an affected SAmanagement. Moreover,to continue unchanged, etc. 4.4.1.1 Selectors An SA may be fine-grained or coarse-grained, depending on thegranularity of key distribution employed with IPsec determinesselectors used to define thegranularityset ofauthentication provided. In general, data origin authentication in AHtraffic for the SA. For example, all traffic between two hosts may be carried via a single SA, andESP is limited byafforded a uniform set of security services. Alternatively, traffic between a pair of hosts might be spread over multiple SAs, depending on theextent to which secretsapplications being usedwith(as defined by theintegrity algorithm (orNext Layer Protocol and related fields, e.g., ports), with different security services offered by different SAs. Similarly, all traffic between akey management protocol that creates such secrets) are shared among multiple possible sources. The following text describes the minimum requirements for both typespair of security gateways could be carried on a single SA, or one SAmanagement. Kent & Seo [Page 24] Internet Draft Security Architecturecould be assigned forIP January 2004 4.5.1 Manual Techniqueseach communicating host pair. Thesimplest formfollowing selector parameters MUST be supported by all IPsec implementations to facilitate control ofmanagement is manual management, in which a person manually configures each system with keying materialSA granularity. Note that both Local andsecurity association management data relevant to secure communication with other systems. Manual techniques are practical in small, static environmentsRemote addresses should either be IPv4 or IPv6, butthey donotscale well. For example, a company could createaVirtual Private Network (VPN) using IPsec in security gateways at several sites. If the number of sites is small, and since all the sites come under the purviewmix ofa single administrative domain, this might be a feasible context for manual management techniques. In this case,address types. Also, note that thesecurity gateway might selectively protect traffic toLocal/Remote port selectors (and ICMP message type andfrom other sites within the organization using a manually configured key, while not protecting traffic for other destinations. It also mightcode, and Mobility Header type) may beappropriate when only selected communications needlabeled as OPAQUE tobe secured. A similar argument might applyaccommodate situations where these fields are inaccessible due tousepacket fragmentation. - Remote IP Address(es) (IPv4 or IPv6): this is a list ofIPsec entirely within an organizationranges of IP addresses (unicast, anycast, broadcast (IPv4 only), or Kent & Seo [Page 24] Internet Draft Security Architecture for IP April 2004 multicast group). This structure allows expression of asmall numbersingle IP address (via a trivial range), or a list ofhosts and/or gateways. Manual management techniques often employ statically configured, symmetric keys, though other options also exist. 4.5.2 Automated SA and Key Management Widespread deployment and use of IPsec requires an Internet-standard, scalable, automated, SA management protocol. Such support is required to facilitate useaddresses (each a trivial ranges), or a range of addresses (low and high values, inclusive), as well as theanti-replay featuresmost generic form ofAH and ESP, and to accommodate on-demand creationa list ofSAs, e.g., for user- and session- oriented keying. (Note thatranges. Address ranges are used to support more than one destination system sharing thenotionsame SA, e.g., behind a security gateway. - Local IP Address(es) (IPv4 or IPv6): this is a list of"rekeying" an SA actually implies creationranges of IP addresses (unicast, anycast, broadcast (IPv4 only), or multicast group). This structure allows expression of anew SA withsingle IP address (via anew SPI,trivial range), or aprocess that generally implies uselist ofan automated SA/key management protocol.) The default automated key management protocol selected for use with IPsec is IKEv2 [Kau04]. Other automated SA management protocols MAY be employed. When an automated SA/key management protocol is employed, the output from this protocol is used to generate multiple keys foraddresses (each asingle SA. This also occurs because distinct keys are used for eachtrivial ranges), or a range ofthe two SAs created by IKE. If both integrityaddresses (low andconfidentiality are employed, thenhigh values, inclusive), as well as the most generic form of aminimumlist offour keysranges. Address ranges arerequired. Additionally, some cryptographic algorithms may require multiple keys, e.g., 3DES. The Key Management System may provide a separate string of bits for each key or it may generateused to support more than onestring of bits from which all keys are extracted. Ifsource system sharing the same SA, e.g., behind asingle string of bits is provided, care needs to be takensecurity gateway. Local refers toensure that the parts ofthesystem that mapaddress(es) being protected by this implementation (or policy entry). - Next Layer Protocol: Obtained from thestring of bits toIPv4 "Protocol" or therequired keys do so inIPv6 "Next Header" fields. This is an individual protocol number, or ANY. The Next Layer Protocol is whatever comes after any IP extension headers that are present. To simplify locating thesame fashion at both ends Kent & Seo [Page 25] Internet Draft Security ArchitectureNext Layer Protocol, there SHOULD be a mechanism for configuring which IPJanuary 2004 of the SA. To ensure thatextension headers to skip. The default configuration for which protocols to skip SHOULD include theIPsec implementations at each endfollowing protocols: 0 (Hop-by-hop options), 43 (Routing Header), 44 (Fragmentation Header), and 60 (Destination Options). Note: The default list does NOT include 51 (AH), or 50 (ESP). From a selector lookup point of view, IPsec treats AH and ESP as Next Layer Protocols. Several additional selectors depend on theSA use the same bits forNext Layer Protocol value: * If thesame keys, and irrespectiveNext Layer Protocol uses two ports (e.g., TCP, UDP, SCTP, these selectors is a list ofwhich partranges of values. Note that thesystem dividesLocal and Remote ports may not be available in thestringcase ofbits into individual keys, the encryption keysreceipt of a fragmented packet, thus a value of OPAQUE also MUST betaken from the first (left-most, high- order) bits andsupported. Note: In a non-initial fragment, port values will not be available. If a port selector specifies a value other than ANY or OPAQUE, it cannot match packets that are non-initial fragments. If theintegrity keysSA requires a port value other than ANY or OPAQUE, an arriving fragment without ports MUST betaken fromdiscarded. * If theremaining bits. The number of bitsNext Layer Protocol is a Mobility Header, then there is a selector foreach keyIPv6 Mobility Header Message Type (MH type) [Mobip]. This isdefined inan 8-bit value that identifies a particular mobility Kent & Seo [Page 25] Internet Draft Security Architecture for IP April 2004 message. Note that therelevant cryptographic algorithm specification RFC. InMH type may not be available in the case ofmultiple encryption keys or multiple integrity keys,receipt of a fragmented packet, thus a value of OPAQUE MUST be supported. * If thespecificationNext Layer Protocol value is ICMP then there is a 16-bit selector for thecryptographic algorithm must specify the order in which they are to be selected fromICMP message type and code. The message type is a singlestring of bits provided to8-bit value, which defines thecryptographic algorithm. 4.5.3 Locatingtype of an ICMP message, or ANY. The ICMP code is aSecurity Gateway This section discusses issues relating to howsingle 8-bit value that defines ahost learns aboutspecific subtype for an ICMP message. The message type is placed in theexistencemost significant 8 bits ofrelevant security gateways and once a host has contacted these security gateways, how it knows that these arethecorrect security gateways. The details of where16-bit selector and therequired information is storedcode isa local matter, but the Peer Authorization database describedplaced inSection 4.4 isthemost likely candidate. Considerleast significant 8 bits. This 16-bit selector can contain asituation in whichsingle type and aremote host (H1) is using the Internet to gain access torange of codes, aserver or other machine (H2)single type andthere isANY code, ANY type and ANY code. Given asecurity gateway (SG2), e.g.,policy entry with afirewall, through which H1's traffic must pass. An examplerange ofthis situation would be a mobile host (road warrior) crossing the InternetTypes (T-start tohis home organization's firewall (SG2). This situation raises several issues: 1. How does H1 know/learn about the existence of the security gateway SG2? 2. How does it authenticate SG2,T-end) andonce it has authenticated SG2, how does it confirm that SG2 has been authorizeda range of Codes (C- start torepresent H2? 3. How does SG2 authenticate H1C-end), andverify that H1 is authorized to contact H2? 4. How does H1 know/learn about any additional gateways that provide alternate paths to H2? To address these problems, a host or security gateway MUST haveanadministrative interfaceICMP packet with Type t and Code c, an implementation MUST test for a match using (T-start*256) + C-start <= (t*256) + c <= (T-end*256) + C-end Note thatallowstheuser/administrator to configureICMP message type and code may not be available in theaddresscase ofone or more security gateways for rangesreceipt ofdestination addresses that require its use. This includesa fragmented packet, thus a value of OPAQUE MUST be supported. - Name: A name may be used as a symbolic identifier for an IPsec Local or Remote address. Named SPD entries are used in two ways: 1. A named SPD entry is used by a responder (not an initiator) in support of access control when an IP address would not be appropriate for theabilityRemote IP address selector, e.g., for "road warriors." The name used toconfigure informationmatch this field is communicated during the IKE negotiation in the ID payload. In this context, the initiator's Source IP address (inner IP header in tunnel mode) is bound to the Remote IP address in the SAD entry created by the IKE negotiation. This address overrides the Remote IP address value in the SPD, when the SPD entry is selected in this fashion. All IPsec implementations MUST support this use of names. 2. A named SPD entry may be used by an initiator to identify a user forlocating and authenticating one or more security gatewayswhom an IPsec SA will be created (or for whom traffic may be bypassed). Support for this use is optional for multi-user, native host implementations andverifyingnot applicable to other implementations. Note that this name is used only locally; it is not communicated by theauthorizationkey management protocol. An SPD entry can contain both a name (or a list ofthese gateways to representnames) and also values for thedestination host. (The authorizationLocal or Remote IP address. If a name is used in the IKE exchange, that name is matched against the SPD, Kent & Seo [Page 26] Internet Draft Security Architecture for IPJanuaryApril 2004function is implied inrather than matching thePAD.) This document does notcorresponding address in theissue of how to automate the discovery/verification of security gateways. 4.6 Security AssociationsSPD, andMulticast The receiver-orientation oftheSecurity Association implies that,IP address in thecasecorresponding SAD entry is derived from that ofunicast traffic,thedestination system will selectnamed entity (Use initiator's source address as theSPI value. By having"Remote" address for case 1, and use thedestination selectuser's source address as theSPI value, there is no potential"Local" address formanually configured Security Associations to conflict with automatically configured (e.g., viacase 2). The identifiers employed in named SPD entries are one of the following four types: a. akey management protocol) Security Associations or for Security Associations from multiple sourcesfully qualified user name string (email), e.g., mozart@foo.example.com (this corresponds toconflict with each other. For multicast traffic, there are multiple destination systems associated withID_RFC822_ADDR in IKEv2) b. asingle SA. So some system or person will needfully qualified DNS name, e.g., foo.example.com (this corresponds tocoordinate among all multicast groupsID_FQDN in IKEv2) c. X.500 distinguished name, e.g., C = US, SP = MA, O = BBN Technologies, CN = Stephen T. Kent (this corresponds toselect an SPI or SPIs on behalfID_DER_ASN1_DN in IKEv2, after decoding) d. a byte string (this corresponds to Key_ID in IKEv2) The IPsec implementation context determines how selectors are used. For example, a native host implementation typically makes use ofeach multicast group and then communicatea socket interface. When a new connection is established thegroup's IPsec informationSPD can be consulted and an SA bound toall ofthelegitimate members of that multicast groupsocket. Thus traffic sent viamechanismsthat socket need notdefined here. Multiple sendersresult in additional lookups to the SPD (SPD-O and SPD-S) cache. In contrast, amulticast group SHOULD use a single Security Association (and hence Security Parameter Index) for all trafficBITS, BITW, or security gateway implementation needs tothat group whenlook at each packet and perform an SPD-O/SPD- S cache lookup based on the selectors. 4.4.1.2 Structure of an SPD entry This section contains asymmetric key encryption or integrity algorithmprose description of an SPD entry. Also, an ASN.1 definition of an SPD entry isemployed. In such circumstances, the receiver knows only thatprovided in Appendix D. This text describes themessage came fromSPD in asystem possessing the key forfashion thatmulticast group. In such circumstances, a receiver generally willmaps directly into IKE payloads. One should not create SPD entries that cannot beable to authenticate which system sentmapped into something that IKE can negotiate. The management GUI can offer themulticast traffic. Specificationsuser other forms of data entry and display, e.g., the option of using address prefixes as well as ranges, and symbolic names forother, more general multicast approaches are deferred toprotocols, ports, etc. (Do not confuse theIETF's Multicast Security Working Group. 5. IP Traffic Processing As mentioneduse of symbolic names inSection 4.4.1 "Thea Kent & Seo [Page 27] Internet Draft SecurityPolicy Database (SPD)",Architecture for IP April 2004 management interface with the SPD(or associated caches) must be be consulted during the processing of all traffic that crosses the IPsec boundary, including IPsec management traffic.selector "Name".) Ifno policythe reserved, symbolic selector value OPAQUE or ANY isfoundemployed for a given selector type, only it may appear in theSPDlist for thatmatches a packet (for either inbound or outbound traffic), the packet MUST be discarded. To simplify processing,selector, andto allow for very fast SA lookups (for SG/BITS/BITW), this document introducesit must appear only once in thenotion of an SPD cachelist forall outbound traffic (SPD-O plus SPD-S),that selector. Note that ANY anda cache for inbound, non-IPsec traffic (SPD-I). There is nominally one cache per SPD. Since SPD entries may overlap, one cannot safely cacheOPAQUE are local syntax conventions -D IKEv2 negotiates theseentries in general. Simple caching might result in a match against a cache entry whereasvalues via ranges. Also, Remote/Local only applies to ports, not to ICMP message type/code or Mobility Header type. ANY: start = 0 end = <max> OPAQUE: start = <max> end = 0 An SPD is an orderedsearchlist of entries each of which contains theSPD would have resulted infollowing fields. o Name -- aKent & Seo [Page 27] Internet Draft Security Architecturelist of IDs. This selector is optional. o PFP flags -- one per traffic selector. A given flag, e.g., forIP January 2004 match against a different entry. But, ifNext Layer Protocol, applies to the relevant selector across all "selector sets" (see below) contained in an SPDentries are first decorrelated, then the resulting entries can safely be cached, andentry. When creating an SA, eachcached entry will mapflag specifies for the corresponding traffic selector whether toan SA (or multiple SAs if "populateinstantiate the selector frompacket" (PFP) is specified), or indicatethe corresponding field in the packet thatmatching traffic should be bypassedtriggered the creation of the SA ordiscarded, appropriately. Note: In a host IPsec implementation based on sockets,from the value(s) in the corresponding SPDwill be consulted whenever a new socket is created, to determine what, if any, IPsec processing will be applied toentry (see Section 4.4.1, "How To Derive thetraffic that will flow on that socket. This providesValues for animplicit caching mechanism and the portions of the preceding discussion that address caching can be ignored in such implementations. Note: It is assumed that one starts withSAD entry"). Whether acorrelated SPD, because thatsingle flag ishow usersused for, e.g., source port, ICMP type/code, andadministrators are accustomed to managing these sorts of access control listsMH type, orfirewall filter rules. Then the decorrelation algorithma separate flag isapplied, to allow caching of SPD entries. The decorrelationused for each, isinvisible at the management interface. For inbound IPsec traffic,a local matter. - Local Address - Remote Address - Next Layer Protocol - Local Port, or ICMP message type/code or Mobility Header type (depending on theSAD entry selected bynext layer protocol) - Remote Port, or ICMP message type/code or Mobility Header type (depending on theSPI serves asnext layer protocol) o One to N selector sets that correspond to thecache"condition" forthe selectors to be matched against arrivingapplying a particular IPsecpackets, after AHaction. Each selector set contains: - Local Address - Remote Address - Next Layer Protocol - Local Port, orESP processing has been performed. 5.1 Outbound IP Traffic Processing (protected-to-unprotected) First considerICMP message type/code or Mobility Header type (depending on thepath for traffic enteringnext layer protocol) - Remote Port, or ICMP message type/code or Mobility Header type (depending on theimplementation vianext layer protocol) o processing info -- which action is required -- PROTECT, BYPASS, or DISCARD. There is just one action that goes with all the selector sets, not aprotected interface and exiting via an unprotected interface.separate action for each set. Kent & Seo [Page 28] Internet Draft Security Architecture for IPJanuaryApril 2004Unprotected Interface ^ | +----------+ ...................|Forwarding|<-----+ : +----------+ | : ^ | : | Bypass | : +-----+ | +-------+ +-------+ | SPD | +--------+ | SPD-I | |Discard|<---|Cache|---->| AH/ESP | +-------+ +-------+ +-----+ +--------+ : ^ : | : +-------------+ :................>|SPD Selection| +-------------+ ^ | Protected Interface Figure 2. Processing Model for Outbound Traffic IPsec MUST performIf thefollowing steps whenrequired processingoutbound packets: 1. when a packet arrives from the subscriber (protected) interface, invoke the SPD lookup function to select the appropriate SPD. (If the implementation uses only one SPD, this stepisa no-op.) 2. Match the packet headers against the cache for the SPD specified byPROTECT, theSPD-ID from step 1. Note that this cacheentry containsentries from SPD-O and SPD-S. 3a. If there is a match, then process the packet as specified bythematching cache entry, i.e., bypass, discard, or apply AHfollowing information. - IPsec mode -- tunnel or transport - extended sequence number -- Is this SA using extended sequence numbers? - stateful fragment checking -- Is this SA using stateful fragment checking (see Section 7 for more details) - IPsec protocol(s) -- AH, ESPin the specified mode. If- algorithms -- which ones to use for AH, which ones to use for ESP, ordered by decreasing priority 4.4.2 Security Association Database (SAD) In each IPsecprocessing is applied,implementation there is alink fromnominal Security Association Database, in which each entry defines theSPD cacheparameters associated with one SA. Each SA has an entrytoin therelevantSAD. For outbound processing, each SAD entry(specifying the cryptographic algorithms, keys, SPI, etc.). IPsec processing is as previously defined, for tunnel or transport modes and for AH or ESP, as specified in their respective RFCs [Ken04b and Ken04a]. 3b. If no matchisfoundpointed to by entries in thecache, search the SPD (SPD-S and SPD- O parts) specified by SPD-ID. IfSPD-S part of the SPDentry calls for bypass or discard, create new outbound andcache. For inboundSPD cache entries. If the Kent & Seo [Page 29] Internet Draft Security Architecture for IP January 2004 SPD entry callsprocessing, forcreation of an SA,unicast SAs, thekey management mechanism (e.g., IKEv2)SPI isinvokedused either alone tocreate the SA. If SA creation succeeds, a new outbound (SPD-S) cache entry is created, along with an SAD entry, otherwise the packet is discarded. (A packet that triggerslook up anSPD lookup MAY be discarded by the implementation,SA, oritthe SPI may beprocessed against the newly created cache entry, if one is created.) Since SAs are createdused inpairs,conjunction with the IPsec protocol type. If anSAD entry forIPsec implementation supports multicast, thecorresponding inbound SA also is created,SPI plus destination address, or SPI plus destination andit contains the selector values derived from the SPD entrysource addresses are used tocreatelook up theinbound SA, for useSA. (See Section 4.1.) The following parameters are associated with each entry inchecking inbound traffic delivered viatheSA . 4. The packet is passedSAD. They should all be present except where otherwise noted, e.g., AH Authentication algorithm. This description does not purport tothe outbound forwarding function (operating outside of the IPsec implementation), to select the interface to which the packet willbedirected. This function may causea MIB, only a specification of thepacketminimal data items required tobe passed back across the IPsec boundary, for additional IPsec processing, e.g., insupportof nested SAs. If so, there MUST beanentrySA inSPD-I database that permits bypass of the packet. 5.1.1 Handling an Outbound Packet That Must Be Dropped Ifan IPsecsystem receives an outbound packet which it finds it must drop, it SHOULD be capableimplementation. For each ofgenerating and sendingthe selectors defined in Section 4.4.1.1, the entry for anICMP message to indicate toinbound SA in thesender ofSAD MUST contain theoutbound packet thatvalue or values negotiated at thepackettime the SA wasdropped. The type and codecreated. For a receiver, these values are used to check that the header fields of an inbound packet match theICMP message will dependselector values negotiated for the SA. For the receiver, this is part of verifying that a packet arriving on an SA is consistent with thereasonpolicy fordroppingthepacket,SA. (See Section 6 for rules for ICMP messages.) These fields can have the form of specific values, ranges, ANY, or OPAQUE, asspecified below.described in section 4.4.1.1, "Selectors." Thereason SHOULDfollowing data items MUST berecordedin theaudit log. The audit log entry for this event SHOULD include the reason, current date/time, and the selector values of the packet. a.SAD: o Security Parameter Index (SPI): a 32-bit value selected by theselectorsreceiving end ofthe packet matchedanSPD entry requiring the packet to be dropped --> IPv4 Type = 3 (destination unreachable) Code = 13 (Communication Administratively Prohibited) IPv6 Type = 1 (destination unreachable) Code = 1 (Communication with destination administratively prohibited) b1. the IPsec system was unable to set up theSArequired byto uniquely identify theSPDSA. In an SAD entrymatching the packet becausefor an outbound SA, theIPsec peer atSPI is used to construct theother end ofpacket's AH or ESP header. In an SAD entry for an inbound SA, theexchangeSPI isadministratively prohibited from communicating with the initiator and rejectsused to map traffic to thenegotiation. IPv4 Type = 3 (destination unreachable) Code = 13 (Communication Administratively Prohibited)appropriate SA (see text on unicast/multicast in Section 4.1). Kent & Seo [Page30]29] Internet Draft Security Architecture for IPJanuaryApril 2004IPv6 Type = 1 (destination unreachable) Code = 1 (Communication with destination administratively prohibited) b2. the IPsec system was unableo Sequence Number Counter: a 64-bit used toset up the SA required by the SPD entry matching the packet becausegenerate theIPsec peer atSequence Number field in AH or ESP headers. 64-bit sequence numbers are theother enddefault, but 32-bit sequence numbers are also supported if negotiated. o Sequence Counter Overflow: a flag indicating whether overflow of theexchange could not be contacted. IPv4 Type = 3 (destination unreachable) Code = 1 (host unreachable) IPv6 Type = 1 (destination unreachable) Code = 3 (address unreachable) Note thatSequence Number Counter should generate anattacker behind a security gateway could sendauditable event and prevent transmission of additional packetswith a spoofed source address, W.X.Y.Z, to an IPsec entity causing it to send ICMP messages to W.X.Y.Z. This creates an opportunityon the SA, or whether rollover is permitted. The audit log entry fora DoS attack among hosts behind a security gateway. To address this, a security gatewaythis event SHOULD include the SPI value, current date/time, Local Address, Remote Address, and the selectors from the relevant SAD entry. o Anti-Replay Window: amanagement control to allow an administrator64-bit counter and a bit-map (or equivalent) used toconfiguredetermine whether anIPsec implementation to sendinbound AH ornot send the ICMP messages under these circumstances, and if this facilityESP packet isselected, to rate limita replay. NOTE: If anti-replay has been disabled by thetransmission of such ICMP responses. 5.1.2 Header Constructionreceiver forTunnel Mode This section describesan SA, e.g., in thehandlingcase of a manually keyed SA, then theinner and outer IP headers, extension headers, and optionsAnti-Replay Window is ignored for the SA in question. 64-bit sequence numbers are the default, but this counter size accommodates 32-bit sequence numbers. o AHand ESP tunnels, with regard to outbound traffic processing.Authentication algorithm, key, etc. Thisincludes how to construct the encapsulating (outer) IP header, how to processis required only if AH is supported. o ESP Encryption algorithm, key, mode, IV, etc. If a combined mode algorithm is used, these fieldsinwill not be applicable. o ESP integrity algorithm, keys, etc. If theinner IP header, and what other actions shouldintegrity service is not selected, these fields will not betaken for outbound, tunnelapplicable. If a combined modetraffic. The general processing described herealgorithm ismodeled after RFC 2003, "IP Encapsulation with IP" [Per96]:used, these fields will not be applicable. oThe outer IP header Source AddressESP combined mode algorithms, key(s), etc. This data is used when a combined mode (encryption andDestination Address identify the "endpoints"integrity) algorithm is used with ESP. If a combined mode algorithm is not used, these fields are not applicable. o Lifetime of this Security Association: a time interval after which an SA must be replaced with a new SA (and new SPI) or terminated, plus an indication of which of these actions should occur. This may be expressed as a time or byte count, or a simultaneous use of both with thetunnel (the encapsulator and decapsulator). The inner IP header Source Address and Destination Addresses identify the original senderfirst lifetime to expire taking precedence. A compliant implementation MUST support both types of lifetimes, andrecipientmust support a simultaneous use of both. If time is employed, and if IKE employs X.509 certificates for SA establishment, thedatagram, (fromSA lifetime must be constrained by theperspectivevalidity intervals ofthis tunnel), respectively. (see footnote 3 after the table in 5.1.2.1 for more details ontheencapsulating source IP address.) o The inner IP header is not changed except as noted below for TTL (or Hop Limit)certificates, and theECN Field. The inner IP header otherwise remains unchanged during its delivery toNextIssueDate of thetunnel exit point. o No change to IP options or extension headersCRLs used in theinner headerIKE Kent & Seo [Page31]30] Internet Draft Security Architecture for IPJanuaryApril 2004occurs during delivery of the encapsulated datagram throughexchange for thetunnel. Note: IPsec tunnel mode is different from IP-in-IP tunneling (RFC 2003) in several ways: o IPsec offers certain controls to a security administrator to manage covert channels (which would not normally be a concern for tunneling)SA. Both initiator andto ensure that the receiver examinesresponder are responsible for constraining theright portionsSA lifetime in this fashion. NOTE: The details of how to handle thereceived packet re: applicationrefreshing ofaccess controls. An IPseckeys when SAs expire is a local matter. However, one reasonable approach is: (a) If byte count is used, then the implementationMAY be configurable with regardSHOULD count the number of bytes tohow it processeswhich theDSCP field for tunnel mode for transmitted packets.IPsec cryptographic algorithm is applied. Foroutbound traffic, one configuration setting for DSCP will operate as described inESP, this is thefollowing sections on IPv4encryption algorithm (including Null encryption) andIPv6 header processingforIPsec tunnels. Another will allowAH, this is theDSCPfield to be mapped to a fixed value, which MAY be configured on a per SA basis. (The value might really be fixed for all traffic outbound from a device, but per SA granularity allows that as well.)authentication algorithm. Thisconfiguration option allows a local administratorincludes pad bytes, etc. Note that implementations MUST be able todecide whetherhandle having thecovert channel provided by copying these bits outweighscounters at thebenefitsends ofcopying. o IPsec describes how to handle ECNan SA get out of synch, e.g., because of packet loss orDSCP. o IPsec allowsbecause theIP versionimplementations at each end of theencapsulating header toSA aren't doing things the same way. (b) There SHOULD bedifferent from thattwo kinds of lifetime -- a soft lifetime that warns theinner header.implementation to initiate action such as setting up a replacement SA; and a hard lifetime when the current SA ends and is destroyed. (c) If the entire packet does not get delivered during the SAs lifetime, the packet SHOULD be discarded. o IPsec protocol mode: tunnel or transport. Indicates which mode of AH or ESP is applied to traffic on this SA. o Stateful fragment checking flag. Indicates whether or not stateful fragment checking applies to this SA. o Path MTU: any observed path MTU and aging variables. o Tunnel header IP source and destination address - both addresses must be either IPv4 or IPv6 addresses. Thetables inversion implies the type of IP header to be used. Only used when the IPsec protocol mode is tunnel. For each selector, the followingsub-sectionstables show thehandling forrelationship between thedifferent header/option fields ("constructed" means thatvalue in the SPD, the PFP flag, the value in theouter field is constructed independently oftriggering packet and the resulting value in theinner).SAD. Note that the administrative interface for IPsec can use various syntactic options to make it easier for the administrator to enter rules. For example, although a list of ranges is what IKEv2 sends, it might be clearer and less error prone for the user to enter a single IP address or IP address prefix. Kent & Seo [Page32]31] Internet Draft Security Architecture for IPJanuaryApril 20045.1.2.1 IPv4 -- Header Construction for Tunnel Mode <-- How Outer Hdr Relates to Inner Hdr --> Outer Hdr at Inner Hdr at IPv4 Encapsulator Decapsulator Header fields: --------------------Value in Triggering Resulting SAD Selector SPD Entry PFP Packet Entry -------- ---------------- --- ------------version 4 (1) no change header length constructed no change DS Field copied from inner hdr (5) no change ECN Field copied from inner hdr constructed (6) total length constructed no change ID constructed no change flags (DF,MF) constructed, DF (4) no change fragment offset constructed no change TTL constructed (2) decrement (2)-------------- loc addr list of ranges 0 IP addr "S" list of ranges or ANY or ANY list of ranges 1 IP addr "S" "S" or ANY rem addr list of ranges 0 IP addr "D" list of ranges or ANY or ANY list of ranges 1 IP addr "D" "D" or ANY protocolAH, ESP no change checksum constructed constructed (2)(6)list of prot's* 0 prot. "P" list of prot's* or ANY** or ANY list of prot's* 1 prot. "P" "P" or ANY** OPAQUE 0 not avail. "undefined" OPAQUE 1 not avail. *** Kent & Seo [Page 32] Internet Draft Security Architecture for IP April 2004 If the protocol is one that has two ports then there will be selectors for both Local and Remote ports. Value in Triggering Resulting SAD Selector SPD Entry PFP Packet Entry -------- ---------------- --- ------------ -------------- loc port list of ranges 0 srcaddress constructed (3)port "s" list of ranges or ANY or ANY list of ranges 0 nochange dest address constructed (3)src port discard packet or ANY OPAQUE 0 not avail. OPAQUE OPAQUE 1 not avail. *** list of ranges 1 src port "s" "s" or ANY list of ranges 1 nochange Options never copiedsrc port discard packet or ANY rem port list of ranges 0 dst port "d" list of ranges or ANY or ANY list of ranges 0 nochange 1. The IP version in the encapsulating header candst port discard packet or ANY OPAQUE 0 not avail. OPAQUE OPAQUE 1 not avail. *** list of ranges 1 dst port "d" "d" or ANY list of ranges 1 no dst port discard packet or ANY If the protocol is mobility header then there will be a selector for mh type. Value in Triggering Resulting SAD Selector SPD Entry PFP Packet Entry -------- ---------------- --- ------------ -------------- mh type list of ranges 0 mh type "T" list of ranges or ANY or ANY list of ranges 0 no mh type discard packet or ANY OPAQUE 0 not avail. OPAQUE OPAQUE 1 not avail. *** list of ranges 1 mh type "T" "T" or ANY list of ranges 1 no mh type discard packet or ANY Kent & Seo [Page 33] Internet Draft Security Architecture for IP April 2004 If the protocol is ICMP, then there will be a 16-bit selector for ICMP type and ICMP code. Note that the type and code are bound to each other, i.e., the codes apply to the particular type. This 16-bit selector can contain a single type and a range of codes, a single type and ANY code, ANY type and ANY code. Value in Triggering Resulting SAD Selector SPD Entry PFP Packet Entry --------- ---------------- --- ------------ -------------- ICMP type a single type 0 type "t" list of ranges or ANY or ANY a single type 0 no type discard packet or ANY OPAQUE 0 not avail. OPAQUE OPAQUE 1 not avail. *** a single type 1 type "t" "t" or ANY a single type 1 no type discard packet or ANY ICMP code list of ranges 0 type "c" list of ranges or ANY or ANY list of ranges 0 no code discard packet or ANY OPAQUE 0 not avail. OPAQUE OPAQUE 1 not avail. *** list of ranges 1 type "c" "c" or ANY list of ranges 1 no code discard packet or ANY Kent & Seo [Page 34] Internet Draft Security Architecture for IP April 2004 If the name selector is used... Value in Triggering Resulting SAD Selector SPD Entry PFP Packet Entry --------- ---------------- --- ------------ -------------- name list of system- N/A packet from N/A dependent user or user or sys. system names * "List of protocols" is the information, not the way that the SPD or SAD or IKv2 have to represent this information. ** 0 (zero) is used by IKE to indicate ANY for protocol. *** Use of PFP=1 with an OPAQUE value is an error and SHOULD be prohibited by an IPsec implementation. 4.5 SA and Key Management IPsec mandates support for both manual and automated SA and cryptographic key management. The IPsec protocols, AH and ESP, are largely independent of the associated SA management techniques, although the techniques involved do affect some of the security services offered by the protocols. For example, the optional anti- replay service available for AH and ESP requires automated SA management. Moreover, the granularity of key distribution employed with IPsec determines the granularity of authentication provided. In general, data origin authentication in AH and ESP is limited by the extent to which secrets used with the integrity algorithm (or with a key management protocol that creates such secrets) are shared among multiple possible sources. The following text describes the minimum requirements for both types of SA management. 4.5.1 Manual Techniques The simplest form of management is manual management, in which a person manually configures each system with keying material and security association management data relevant to secure communication with other systems. Manual techniques are practical in small, static environments but they do not scale well. For example, a company could create a Virtual Private Network (VPN) using IPsec in security gateways at several sites. If the number of sites is small, and since all the sites come under the purview of a single administrative Kent & Seo [Page 35] Internet Draft Security Architecture for IP April 2004 domain, this might be a feasible context for manual management techniques. In this case, the security gateway might selectively protect traffic to and from other sites within the organization using a manually configured key, while not protecting traffic for other destinations. It also might be appropriate when only selected communications need to be secured. A similar argument might apply to use of IPsec entirely within an organization for a small number of hosts and/or gateways. Manual management techniques often employ statically configured, symmetric keys, though other options also exist. 4.5.2 Automated SA and Key Management Widespread deployment and use of IPsec requires an Internet-standard, scalable, automated, SA management protocol. Such support is required to facilitate use of the anti-replay features of AH and ESP, and to accommodate on-demand creation of SAs, e.g., for user- and session- oriented keying. (Note that the notion of "rekeying" an SA actually implies creation of a new SA with a new SPI, a process that generally implies use of an automated SA/key management protocol.) The default automated key management protocol selected for use with IPsec is IKEv2 [Kau04]. Other automated SA management protocols MAY be employed. When an automated SA/key management protocol is employed, the output from this protocol is used to generate multiple keys for a single SA. This also occurs because distinct keys are used for each of the two SAs created by IKE. If both integrity and confidentiality are employed, then a minimum of four keys are required. Additionally, some cryptographic algorithms may require multiple keys, e.g., 3DES. The Key Management System may provide a separate string of bits for each key or it may generate one string of bits from which all keys are extracted. If a single string of bits is provided, care needs to be taken to ensure that the parts of the system that map the string of bits to the required keys do so in the same fashion at both ends of the SA. To ensure that the IPsec implementations at each end of the SA use the same bits for the same keys, and irrespective of which part of the system divides the string of bits into individual keys, the encryption keys MUST be taken from the first (left-most, high- order) bits and the integrity keys MUST be taken from the remaining bits. The number of bits for each key is defined in the relevant cryptographic algorithm specification RFC. In the case of multiple encryption keys or multiple integrity keys, the specification for the cryptographic algorithm must specify the order in which they are to be selected from a single string of bits provided to the Kent & Seo [Page 36] Internet Draft Security Architecture for IP April 2004 cryptographic algorithm. 4.5.3 Locating a Security Gateway This section discusses issues relating to how a host learns about the existence of relevant security gateways and once a host has contacted these security gateways, how it knows that these are the correct security gateways. The details of where the required information is stored is a local matter, but the Peer Authorization Database described in Section 4.4 is the most likely candidate. Consider a situation in which a remote host (H1) is using the Internet to gain access to a server or other machine (H2) and there is a security gateway (SG2), e.g., a firewall, through which H1's traffic must pass. An example of this situation would be a mobile host (road warrior) crossing the Internet to his home organization's firewall (SG2). This situation raises several issues: 1. How does H1 know/learn about the existence of the security gateway SG2? 2. How does it authenticate SG2, and once it has authenticated SG2, how does it confirm that SG2 has been authorized to represent H2? 3. How does SG2 authenticate H1 and verify that H1 is authorized to contact H2? 4. How does H1 know/learn about any additional gateways that provide alternate paths to H2? To address these problems, a host or security gateway MUST have an administrative interface that allows the user/administrator to configure the address of one or more security gateways for ranges of destination addresses that require its use. This includes the ability to configure information for locating and authenticating one or more security gateways and verifying the authorization of these gateways to represent the destination host. (The authorization function is implied in the PAD.) This document does not address the issue of how to automate the discovery/verification of security gateways. The IP Security Policy (IPSP) Working Group is a possible future source of guidance. One of its goals is to produce an Internet Draft on a "Security Gateway Discovery, Policy Exchange and Negotiation Protocol". Kent & Seo [Page 37] Internet Draft Security Architecture for IP April 2004 4.6 Security Associations and Multicast The receiver-orientation of the Security Association implies that, in the case of unicast traffic, the destination system will select the SPI value. By having the destination select the SPI value, there is no potential for manually configured Security Associations to conflict with automatically configured (e.g., via a key management protocol) Security Associations or for Security Associations from multiple sources to conflict with each other. For multicast traffic, there are multiple destination systems associated with a single SA. So some system or person will need to coordinate among all multicast groups to select an SPI or SPIs on behalf of each multicast group and then communicate the group's IPsec information to all of the legitimate members of that multicast group via mechanisms not defined here. Multiple senders to a multicast group SHOULD use a single Security Association (and hence Security Parameter Index) for all traffic to that group when a symmetric key encryption or integrity algorithm is employed. In such circumstances, the receiver knows only that the message came from a system possessing the key for that multicast group. In such circumstances, a receiver generally will not be able to authenticate which system sent the multicast traffic. Specifications for other, more general multicast approaches are deferred to the IETF's Multicast Security Working Group. 5. IP Traffic Processing As mentioned in Section 4.4.1 "The Security Policy Database (SPD)", the SPD (or associated caches) must be consulted during the processing of all traffic that crosses the IPsec protection boundary, including IPsec management traffic. If no policy is found in the SPD that matches a packet (for either inbound or outbound traffic), the packet MUST be discarded. To simplify processing, and to allow for very fast SA lookups (for SG/BITS/BITW), this document introduces the notion of an SPD cache for all outbound traffic (SPD-O plus SPD-S), and a cache for inbound, non-IPsec-protected traffic (SPD-I). There is nominally one cache per SPD. Since SPD entries may overlap, one cannot safely cache these entries in general. Simple caching might result in a match against a cache entry whereas an ordered search of the SPD would have resulted in a match against a different entry. But, if the SPD entries are first decorrelated, then the resulting entries can safely be cached, and each cached entry will map to exactly one SA, or indicate that matching traffic should be bypassed or discarded, appropriately. (Note: The original SPD entry might result in multiple SAs, e.g., because of PFP.) Unless otherwise noted, all references below to the "SPD" or "SPD cache" or "cache" Kent & Seo [Page 38] Internet Draft Security Architecture for IP April 2004 are to a decorrelated SPD (SPD-I, SPD-O, SPD-S) or the SPD cache containing entries from the decorrelated SPD. Note: In a host IPsec implementation based on sockets, the SPD will be consulted whenever a new socket is created, to determine what, if any, IPsec processing will be applied to the traffic that will flow on that socket. This provides an implicit caching mechanism and the portions of the preceding discussion that address caching can be ignored in such implementations. Note: It is assumed that one starts with a correlated SPD because that is how users and administrators are accustomed to managing these sorts of access control lists or firewall filter rules. Then the decorrelation algorithm is applied, to build a list of cache-able SPD entries. The decorrelation is invisible at the management interface. For inbound IPsec traffic, the SAD entry selected by the SPI serves as the cache for the selectors to be matched against arriving IPsec packets, after AH or ESP processing has been performed. 5.1 Outbound IP Traffic Processing (protected-to-unprotected) First consider the path for traffic entering the implementation via a protected interface and exiting via an unprotected interface. Unprotected Interface ^ | (nested SAs) +----------+ ...................|Forwarding|<-----+ : +----------+ | : ^ | : | BYPASS | V +-----+ +--------+ +-------+ +-------+ | SPD | |PROTECT | | SPD-I | |DISCARD|<---|Cache|---->|(AH/ESP)| +-------+ +-------+ +-----+ +--------+ : ^ : | : +-------------+ :................>|SPD Selection| +-------------+ ^ | Protected Interface Kent & Seo [Page 39] Internet Draft Security Architecture for IP April 2004 Figure 2. Processing Model for Outbound Traffic IPsec MUST perform the following steps when processing outbound packets: 1. When a packet arrives from the subscriber (protected) interface, invoke the SPD selection function to obtain the SPD-ID needed to choose the appropriate SPD. (If the implementation uses only one SPD, this step is a no-op.) 2. Match the packet headers against the cache for the SPD specified by the SPD-ID from step 1. Note that this cache contains entries from SPD-O and SPD-S. 3a. If there is a match, then process the packet as specified by the matching cache entry, i.e., BYPASS, DISCARD, or PROTECT using AH or ESP. If IPsec processing is applied, there is a link from the SPD cache entry to the relevant SAD entry (specifying the mode, cryptographic algorithms, keys, SPI, etc.). IPsec processing is as previously defined, for tunnel or transport modes and for AH or ESP, as specified in their respective RFCs [Ken04b and Ken04a]. 3b. If no match is found in the cache, search the SPD (SPD-S and SPD- O parts) specified by SPD-ID. If the SPD entry calls for BYPASS or DISCARD, create new outbound SPD cache entries and if BYPASS, create new inbound SPD cache entries. If the SPD entry calls for PROTECT, i.e., creation of an SA, the key management mechanism (e.g., IKEv2) is invoked to create the SA. If SA creation succeeds, a new outbound (SPD-S) cache entry is created, along with outbound and inbound SAD entries, otherwise the packet is discarded. (A packet that triggers an SPD lookup MAY be discarded by the implementation, or it may be processed against the newly created cache entry, if one is created.) Since SAs are created in pairs, an SAD entry for the corresponding inbound SA also is created, and it contains the selector values derived from the SPD entry (and packet, if any PFP flags were "true") used to create the inbound SA, for use in checking inbound traffic delivered via the SA. 4. The packet is passed to the outbound forwarding function (operating outside of the IPsec implementation), to select the interface to which the packet will be directed. This function may cause the packet to be passed back across the IPsec boundary, for additional IPsec processing, e.g., in support of nested SAs. If so, there MUST be an entry in SPD-I database that permits inbound bypassing of the packet. Kent & Seo [Page 40] Internet Draft Security Architecture for IP April 2004 NOTE: With the exception of IPv4 and IPv6 transport mode, an SG, BITS, or BITW implementation MAY fragment packets before applying IPsec. The device SHOULD have a configuration setting to disable this. The resulting fragments are evaluated against the SPD in the normal manner. Thus, fragments not containing port numbers (or ICMP message type and code, or Mobility Header type) will only match rules having port (or ICMP message type and code, or MH type) selectors of OPAQUE or ANY. (See section 7 for more details.) 5.1.1 Handling an Outbound Packet That Must Be Discarded If an IPsec system receives an outbound packet which it finds it must discard, it SHOULD be capable of generating and sending an ICMP message to indicate to the sender of the outbound packet that the packet was discarded. The type and code of the ICMP message will depend on the reason for discarding the packet, as specified below. The reason SHOULD be recorded in the audit log. The audit log entry for this event SHOULD include the reason, current date/time, and the selector values from the packet. a. The selectors of the packet matched an SPD entry requiring the packet to be discarded. IPv4 Type = 3 (destination unreachable) Code = 13 (Communication Administratively Prohibited) IPv6 Type = 1 (destination unreachable) Code = 1 (Communication with destination administratively prohibited) b1. The IPsec system was unable to set up the SA required by the SPD entry matching the packet because the IPsec peer at the other end of the exchange is administratively prohibited from communicating with the initiator. IPv4 Type = 3 (destination unreachable) Code = 13 (Communication Administratively Prohibited) IPv6 Type = 1 (destination unreachable) Code = 1 (Communication with destination administratively prohibited) b2. The IPsec system was unable to set up the SA required by the SPD entry matching the packet because the IPsec peer at the other end of the exchange could not be contacted. IPv4 Type = 3 (destination unreachable) Code = 1 (host unreachable) Kent & Seo [Page 41] Internet Draft Security Architecture for IP April 2004 IPv6 Type = 1 (destination unreachable) Code = 3 (address unreachable) Note that an attacker behind a security gateway could send packets with a spoofed source address, W.X.Y.Z, to an IPsec entity causing it to send ICMP messages to W.X.Y.Z. This creates an opportunity for a DoS attack among hosts behind a security gateway. To address this, a security gateway SHOULD include a management control to allow an administrator to configure an IPsec implementation to send or not send the ICMP messages under these circumstances, and if this facility is selected, to rate limit the transmission of such ICMP responses. 5.1.2 Header Construction for Tunnel Mode This section describes the handling of the inner and outer IP headers, extension headers, and options for AH and ESP tunnels, with regard to outbound traffic processing. This includes how to construct the encapsulating (outer) IP header, how to process fields in the inner IP header, and what other actions should be taken for outbound, tunnel mode traffic. The general processing described here is modeled after RFC 2003, "IP Encapsulation with IP" [Per96]: o The outer IP header Source Address and Destination Address identify the "endpoints" of the tunnel (the encapsulator and decapsulator). The inner IP header Source Address and Destination Addresses identify the original sender and recipient of the datagram, (from the perspective of this tunnel), respectively. (See footnote 3 after the table in 5.1.2.1 for more details on the encapsulating source IP address.) o The inner IP header is not changed except as noted below for TTL (or Hop Limit) and the DS/ECN Fields. The inner IP header otherwise remains unchanged during its delivery to the tunnel exit point. o No change to IP options or extension headers in the inner header occurs during delivery of the encapsulated datagram through the tunnel. Note: IPsec tunnel mode is different from IP-in-IP tunneling (RFC 2003) in several ways: o IPsec offers certain controls to a security administrator to manage covert channels (which would not normally be a concern for tunneling) and to ensure that the receiver examines the right Kent & Seo [Page 42] Internet Draft Security Architecture for IP April 2004 portions of the received packet re: application of access controls. An IPsec implementation MAY be configurable with regard to how it processes the DS field for tunnel mode for transmitted packets. For outbound traffic, one configuration setting for DSCP will operate as described in the following sections on IPv4 and IPv6 header processing for IPsec tunnels. Another will allow the DS field to be mapped to a fixed value, which MAY be configured on a per SA basis. (The value might really be fixed for all traffic outbound from a device, but per SA granularity allows that as well.) This configuration option allows a local administrator to decide whether the covert channel provided by copying these bits outweighs the benefits of copying. o IPsec describes how to handle ECN or DS. o IPsec allows the IP version of the encapsulating header to be different from that of the inner header. The tables in the following sub-sections show the handling for the different header/option fields ("constructed" means that the value in the outer field is constructed independently of the value in the inner). 5.1.2.1 IPv4 -- Header Construction for Tunnel Mode <-- How Outer Hdr Relates to Inner Hdr --> Outer Hdr at Inner Hdr at IPv4 Encapsulator Decapsulator Header fields: -------------------- ------------ version 4 (1) no change header length constructed no change DS Field copied from inner hdr (5) no change ECN Field copied from inner hdr constructed (6) total length constructed no change ID constructed no change flags (DF,MF) constructed, DF (4) no change fragment offset constructed no change TTL constructed (2) decrement (2) protocol AH, ESP no change checksum constructed constructed (2)(6) src address constructed (3) no change dest address constructed (3) no change Options never copied no change 1. The IP version in the encapsulating header can be different from the value in the inner header. Kent & Seo [Page 43] Internet Draft Security Architecture for IP April 2004 2. The TTL in the inner header is decremented by the encapsulator prior to forwarding and by the decapsulator if it forwards the packet. (The IPv4 checksum changes when the TTL changes.) Note: Decrementing the TTL value is a normal part of forwarding a packet. Thus, a packet originating from the same node as the encapsulator does not have its TTL decremented, since the sending node is originating the packet rather than forwarding it. 3. Local and Remote addresses depend on the SA, which is used to determine the Remote address which in turn determines which Local address (net interface) is used to forward the packet. Note: For multicast traffic, the destination address, or source and destination addresses, may be required for demuxing. In that case, it is important to ensure consistency over the lifetime of the SA by ensuring that the source address that appears in the encapsulating tunnel header is the same as the one that was negotiated during the SA establishment process. There is an exception to this general rule, i.e., a mobile IPsec implementation will update its source address as it moves. 4. configuration determines whether to copy from the inner header (IPv4 only), clear or set the DF. 5. If the packet will immediately enter a domain for which the DSCP value in the outer header is not appropriate, that value MUST be mapped to an appropriate value for the domain [RFC 2474]. See [RFC 2475] for further information. 6. If the ECN field in the inner header is set to ECT(0) or ECT(1) and the ECN field in the outer header is set to CE, then set the ECN field in the inner header to CE, otherwise make no change to the ECN field in the inner header. (The IPv4 checksum changes when the ECN changes.) Note: IPsec does not copy the options from the inner header into the outer header, nor does IPsec construct the options in the outer header. However, post-IPsec code MAY insert/construct options for the outer header. Kent & Seo [Page 44] Internet Draft Security Architecture for IP April 2004 5.1.2.2 IPv6 -- Header Construction for Tunnel Mode See previous section 5.1.2.1 for notes 1-6 indicated by (footnote number). <-- How Outer Hdr Relates Inner Hdr ---> Outer Hdr at Inner Hdr at IPv6 Encapsulator Decapsulator Header fields: -------------------- ------------ version 6 (1) no change DS Field copied from inner hdr (5) no change ECN Field copied from inner hdr constructed (6) flow label copied or configured no change payload length constructed no change next header AH,ESP,routing hdr no change hop limit constructed (2) decrement (2) src address constructed (3) no change dest address constructed (3) no change Extension headers never copied (7) no change 7. IPsec does not copy the extension headers from the inner packet into the outer header, nor does IPsec construct extension headers in the outer header. However, post- IPsec code MAY insert/construct extension headers for the outer header. 5.2 Processing Inbound IP Traffic (unprotected-to-protected) Inbound processing is somewhat different from outbound processing, because of the use of SPIs to map IPsec protected traffic to SAs. The inbound SPD cache (SPD-I) is applied only to bypassed or discarded traffic. If an arriving packet appears to be an IPsec fragment from an unprotected interface, reassembly is performed prior to the IPsec processing. The intent for any SPD cache is that a packet that fails to match any entry is then referred to the corresponding SPD. Every SPD SHOULD have a nominal, final entry that catches anything that is otherwise unmatched, and discards it. This ensures that non-IPsec protected traffic that arrives and does not match any SPD-I entry will be discarded. Kent & Seo [Page 45] Internet Draft Security Architecture for IP April 2004 Unprotected Interface | V +-----+ IPsec protected ------------------->|Demux|-------------------+ | +-----+ | | | | | Not IPsec | | | | | | V | | +-------+ +-------+ +------+ | | |DISCARD|<---| SPD-I |-->| ICMP | | | +-------+ +-------+ +------+ | | | V +-----+ | +--------+ ....|SPD-O|................|....................|PROTECT |...IPsec +-----+ | |(AH/ESP)| Boundary ^ | +--------+ | | +---+ | | BYPASS | +-->|IKE| | | | | +---+ | | V | V | +----------+ +---------+ |--------<------|Forwarding|<------------|SAD Check| +----------+ +---------+ | V Protected Interface Figure 3. Inbound Traffic Processing Model Prior to performing AH or ESP processing, any IP fragments that arrive via the unprotected interface are reassembled (by IP). Each inbound IP datagram to which IPsec processing will be applied is identified by the appearance of the AH or ESP values in the IP Next Protocol field (or of AH or ESP as a next layer protocol in the IPv6 context). IPsec MUST perform the following steps: 1. When a packet arrives, it may be tagged with the ID of the interface (physical or virtual) via which it arrived, if necessary to support multiple SPDs with different SPD-I entries. (The interface ID is mapped to a corresponding SPD-ID.) Kent & Seo [Page 46] Internet Draft Security Architecture for IP April 2004 2. The packet is examined and demuxed into one of three categories: - If the packet appears to be IPsec protected and it is addressed to this device, an attempt is made to map it to an active SA via the SAD. - Traffic not addressed to this device, or addressed to this device and not AH, ESP, or ICMP, is directed to BYPASS/DISCARD lookup. (IKE traffic MUST have an explicit BYPASS entry in the SPD.) If multiple SPDs are employed, the tag assigned to the packet in step 1 is used to select the appropriate SPD-I (and cache) to search. - ICMP traffic directed to this device is directed to "unprotected" ICMP processing (see Section 6). 3a. If the packet is addressed to the IPsec device and AH or ESP is specified as the protocol, the packet is looked up in the SAD identified by the SPD-ID from step 1. For unicast traffic, use only the SPI (or SPI plus protocol). For multicast traffic, use the SPI plus the destination and/or source addresses, as specified in the SAD. If there is no match, discard the traffic. This is an auditable event. The audit log entry for this event SHOULD include the current date/time, SPI, source and destination of the packet, IPsec protocol, and any other selector values of the packet that are available. If the packet is found in the SAD, process it accordingly (see step 4). 3b. If the packet is not addressed to the device or is addressed to this device and is not AH, ESP, or ICMP, look up the packet header in the (appropriate) SPD-I cache. If there is a match and the packet is to be discarded or bypassed, do so. If there is no cache match, look up the packet in the corresponding SPD-I and create a cache entry as appropriate. (No SAs are created in response to receipt of a packet that requires IPsec protection; only BYPASS or DISCARD entries can be created this way.) If there is no match, discard the traffic. This is an auditable event. The audit log entry for this event SHOULD include the current date/time, SPI if available, IPsec protocol if available, source and destination of the packet, and any other selector values of the packet that are available. 3c. Unprotected ICMP processing is assumed to take place on the unprotected side of the IPsec boundary. Unprotected ICMP messages are examined and local policy is applied to determine whether to accept or reject these messages and, if accepted, what action to take as a result. For example, if an ICMP unreachable message is received, the implementation must decide whether to act on it, reject it, or act on it with constraints. [See Section 6.] 4. Apply AH or ESP processing as specified, using the SAD entry Kent & Seo [Page 47] Internet Draft Security Architecture for IP April 2004 selected in step 3a above. Then match the packet against the inbound selectors identified by the SAD entry to verify that the received packet is appropriate for the SA via which it was received. If an IPsec system receives an inbound packet on an SA and the packet's header fields are not consistent with the selectors for the SA, it MUST discard the packet. This is an auditable event. The audit log entry for this event SHOULD include the current date/time, SPI, IPsec protocol(s), source and destination of the packet, and any other selector values of the packet that are available, and the selector values from the relevant SAD entry. The system SHOULD also be capable of generating and sending an IKE notification to the sender (IPsec peer), indicating that the received packet was discarded because of failure to pass selector checks. IKEv2 NOTIFY MESSAGES - ERROR TYPES Value ----------------------------------- ----- INVALID_SELECTORS iana-tbd This error indication MAY be sent in an IKE INFORMATIONAL exchange when a node receives an ESP or AH packet whose selectors do not match those of the SA on which it was delivered (and which caused the packet to be discarded). The Notification Data contains the start of the offending packet (as in ICMP messages) and the SPI field of the notification is set to match the SPI of the IPsec SA. To minimize the impact of a DoS attack or a mis-configured peer, the IPsec system SHOULD include a management control to allow an administrator to configure the IPsec implementation to send or not send this IKE notification, and if this facility is selected, to rate limit the transmission of such notifications. After traffic is bypassed or processed through IPsec, it is handed to the inbound forwarding function for disposition. This function may cause the packet to be sent (outbound) across the IPsec boundary for additional inbound IPsec processing, e.g., in support of nested SAs. If so, then as with ALL outbound traffic that is to be bypassed, the packet MUST be matched against an SPD-O entry. Ultimately, the packet should be forwarded to the destination host or process for disposition. Kent & Seo [Page 48] Internet Draft Security Architecture for IP April 2004 6. ICMP Processing [This section will be filled in when IPsec issue # 91 is resolved.] 7. Handling Fragments (on the protected side of the IPsec boundary) Earlier sections of this document describe mechanisms for (a) fragmenting an outbound packet after IPsec processing has been applied and reassembling it at the receiver before IPsec processing and (b) handling inbound fragments received from the unprotected side of the IPsec boundary. This section describes how an implementation should handle the processing of outbound plaintext fragments on the protected side of the IPsec boundary. (See Appendix E for discussion of Fragment Handling Rationale.) In particular, it addresses: o mapping an outbound non-initial fragment to the right SA (or finding the right SPD entry) o verifying that a received non-initial fragment is authorized for the SA via which it was received o mapping outbound and inbound non-initial fragments to the right SPD-O/SPD-I entry or the relevant cache entry, for BYPASS/DISCARD traffic Note: In Section 4.1, transport mode SAs have been defined to not carry fragments (IPv4 or IPv6). Note also that in Section 4.4.1, two special values, ANY and OPAQUE, were defined for selectors and that ANY includes OPAQUE. Note: The term "non-initial fragment" is used here to indicate a fragment that does not contain all the selector values that may be needed for access control. As observed in Section 4.4.1, depending on the Next Layer Protocol, in addition to Ports, the ICMP message type/code or Mobility Header type could be missing from non-initial fragments. Also, for IPv6, even an initial fragment might NOT contain the Next Layer Protocol or Ports (or ICMP message type/code, or Mobility Header type) depending on the kind and number of extension headers present. If a non-initial fragment contains the Port (or ICMP type and code or Mobility header type) but not the Next Layer Protocol, then unless there is an SPD entry for the relevant Local/Remote addresses with ANY for Next Layer Protocol and Port (or ICMP type and code or Mobility header type), the fragment would not contain all the selector information needed for access control. To address the above requirements, three approaches have been defined: Kent & Seo [Page 49] Internet Draft Security Architecture for IP April 2004 1. All implementations MUST support tunnel mode SAs that are configured to pass traffic without regard to port field (or ICMP type/code or Mobility Header type) values. If the SA will carry traffic for specified protocols, the selector set for the SA MUST specify the port fields (or ICMP type/code or Mobility Header type) as ANY. An SA defined in this fashion will carry all traffic including initial and non-initial fragments for the indicated Local/Remote addresses and specified Next Layer protocol(s). If the SA will carry traffic without regard to a specific protocol value (i.e., ANY is specified as the (Next Layer) protocol selector value), then the port field values are undefined and MUST be set to ANY as well. (As noted in 4.4.1, ANY includes OPAQUE as well as all specific values.) 2. All implementations MAY/SHOULD support tunnel mode SAs that will carry only non-initial fragments, separate from non-fragmented packets and initial fragments. The OPAQUE value will be used to specify port (or ICMP type/code or Mobility Header type) field selectors for an SA to carry such fragments. Receivers MUST perform a minimum offset check on IPv4 (non-initial) fragments to protect against overlapping fragment attacks when SAs of this type are employed. Because such checks cannot be performed on IPv6 non-initial fragments, users and administrators are advised that carriage of such fragments may be dangerous, and implementers may choose to NOT support such SAs for IPv6 traffic. Also, because an SA of this sort will carry ALL non-initial fragments that match a specified Local/Remote address pair and protocol value, users and administrators are advised to protect such traffic using ESP (with integrity) and the "strongest" integrity and encryption algorithms available at both peers. (Determination of the "strongest" algorithms requires imposing an ordering of the available algorithms, a local determination at the discretion of the initiator of the SA.) Specific port (or ICMP type/code or Mobility header type) selector values will be used to define SAs to carry initial fragments and non- fragmented packets. This approach can be used if a user or administrator wants to create one or more tunnel mode SAs between the same Local/Remote addresses that discriminate based on port (or ICMP type/code or Mobility header type) fields. These SAs MUST have non- trivial protocol selector values, otherwise approach #1 above MUST be used. Note: In general, for approach 2, one needs only a single SA between two implementations to carry all non-initial fragments. However, if one chooses to have multiple SAs between the two implementations for QoS differentiation, then one might also want multiple SAs to carry fragments-without-ports, one for each supported QoS class. Since support for QoS via distinct SAs is a local matter, not mandated by Kent & Seo [Page 50] Internet Draft Security Architecture for IP April 2004 2401bis, the choice to have multiple SAs to carry non-initial fragments should also be local. 3. An implementation MAY/SHOULD support some form of stateful fragment checking for a tunnel mode SA with non-trivial port (or ICMP type/code or MH type) field values (not ANY or OPAQUE). Implementations that will transmit non-initial fragments on a tunnel mode SA that makes use of non-trivial port (or ICMP type/code or MH type) selectors MUST notify a peer via the IKE NOTIFY payload: IKEv2 NOTIFY MESSAGES - ERROR TYPES Value ----------------------------------- ----- NON FIRST FRAGMENTS ALSO iana-tbd The peer MUST reject this proposal if it will not accept non-initial fragments in this context. If an implementation does not successfully negotiate transmission of non-initial fragments for such an SA, it MUST NOT send such fragments over the SA. This standard does not specify how peers will deal with such fragments, e.g., via reassembly or other means, at either sender or receiver. However, a receiver MUST discard non-initial fragments that arrive on an SA with non- trivial port (or ICMP type/code or MH type) selector values unless this feature has been negotiated. Also, the receiver MUST discard non-initial fragments that do not comply with the security policy applied to the overall packet. Discarding such packets is an auditable event. Note that in network configurations where fragments of a packet might be sent or received via different security gateways or BITW implementations, stateful strategies for tracking fragments may fail. Also note that stateful fragment checking may create DoS opportunities that may be exploitable by hosts on a protected network behind a security gateway. An implementation MAY/SHOULD choose to support stateful fragment checking for BYPASS/DISCARD traffic for a tunnel mode SA with non- trivial port field values (not ANY or OPAQUE) (Approach 3 above). An implementation also MUST permit a user or administrator to accept or reject BYPASS/DISCARD traffic using the SPD conventions described in approaches 1 and 2 above. 8. Auditing Not all systems that implement IPsec will implement auditing. For the most part, the granularity of auditing is a local matter. However, several auditable events are identified in this document and for each of these events a minimum set of information that SHOULD be Kent & Seo [Page 51] Internet Draft Security Architecture for IP April 2004 included in an audit log is defined. Additional information also MAY bedifferent from the valueincluded in theinner header. 2. The TTLaudit log for each of these events, and additional events, not explicitly called out inthe inner headerthis specification, also MAY result in audit log entries. There isdecremented byno requirement for theencapsulator priorreceiver to transmit any message toforwarding and by the decapsulator if it forwardsthepacket. (The checksum changes whenpurported transmitter in response to theTTL changes.) Note: Decrementingdetection of an auditable event, because of theTTL value is a normal partpotential to induce denial offorwarding a packet. Thus, a packet originatingservice via such action. 9. Conformance Requirements All IPv4 systems that claim to implement IPsec MUST comply with all requirements of this document. All IPv6 systems that claim to implement IPsec MUST comply with all requirements of this document. 10. Security Considerations The focus of this document is security; hence security considerations permeate this specification. 11. Differences fromthe same node as the encapsulator does notRFC 2401 [This section will be further updated when things haveits TTL decremented, since the sending node is originating the packet rather than forwarding it. 3. srcsettled down. Issue numbers, status, rejected items, anddest addresses depend on"proposed changes", etc. will be removed in final version. Only theSA, which is used to determinetext describing thedest address whichdifferences from 2401 will remain.] This architecture document differs substantially from RFC 2401 inturn determines which src address (net interface) is useddetail and in organization, but the fundamental notions are unchanged. o [Issues 40,44,45] - 40 [closed] "Interface SPD selector vs. per-interface SPD" - 44 [pending] "Proposed change: forwarding table lookup toforward the packet. Note:select virtual interface ID" - 45 [pending] "Proposed change: use of cache with decorrelated SPD" Thesourceprocessing model has been revised to addressthat appears in the encapsulating tunnel header MUST be the one that was negotiated during the SA establishment process. In principle,new IPsec scenarios, improve performance and simplify implementation. This includes a separation between forwarding (routing) and SPD selection, several SPD changes, and theencapsulating IP source address can be anyaddition ofthe encapsulator's interface addresses or evenanaddress different from any of the encapsulator's IP addresses, (e.g., if it's acting as a NAT box) so long as the addressoutbound SPD cache and an inbound SPD cache for bypassed or discarded traffic. o [Issue #46] [closed] "Proposed change: no need for iterated processing" -- There isreachable through the encapsulatorno longer a requirement to support nested SAs Kent & Seo [Page33]52] Internet Draft Security Architecture for IPJanuaryApril 2004from the environment into which the packet is sent. 4. configuration determines whether to copy from the inner header (IPv4 only), clearor "SA bundles." Instead this functionality can be achieved through SPD and forwarding table configuration. o [Issue #47] [closed] "Proposed change: all selectors can be a list of ranges, per IKEv2 spec" SPD entries were redefined to provide more flexibility. Each SPD entry now consists of a setthe DF. 5. If the packet will immediately enterof selectors, where each selector set contains one protocol and adomain for which the DSCP value in the outer header is not appropriate, that value MUST"list of ranges" can now bemapped to an appropriate value for the domain [RFC 2474]. See [RFC 2475]specified forfurther information. 6. If the ECN field intheinner headerLocal IP address, Remote IP address, Local Port, Remote Port, and ICMP message type and code. An individual value for a selector isset to ECT(0) or ECT(1)represented via a trivial range andthe ECN field in the outer headerANY isset to CE, then set the ECN field in the inner header to CE, otherwise make no change to the ECN field in the inner header. The checksum changes when the ECN changes.) Note: IPsec does not copy the options from the inner header into the outer header, nor does IPsec construct the options in the outer header. However, post-IPsec code MAY insert/construct optionsrepresented via a range than spans all values for theouter header. 5.1.2.2 IPv6selector. An ASN.1 description is included in Appendix D. o [Issue #48] [closed] "Proposed change: add ToS traffic selector option" --Header Construction for Tunnel Mode See previous section 5.1.2.1 for notes 1-6 indicatedTOS (IPv4) and Traffic Class (IPv6) have been replaced by(footnote number). <-- How Outer Hdr Relates Inner Hdr ---> Outer Hdr at Inner Hdr at IPv6 Encapsulator Decapsulator Header fields: -------------------- ------------ version 6 (1) no change DS Field copied from inner hdr (5) no change ECN Field copied from inner hdr constructed (6) flow label copied or configured no change payload length constructed no change next header AH,ESP,routing hdr no change hop limit constructed (2) decrement (2) src address constructed (3) no change dest address constructed (3) no change Extension headers never copied no change Note: IPsec does not copyDSCP and ECN. o [Issues #49 and #88] - 49 [closed] "Proposed change: red-side fragmentation option" - 88 [accepted] "Lift theextension headers fromprohibition on red-side fragmentation by SG, BITS, BITW" For tunnel mode SAs, an SG, BITS, or BITW implementation is now allowed to fragment packets before applying IPsec. This applies only to IPv4. For IPv6 packets, only theinner header intooriginator is allowed to fragment it. o [Issue #50 and #87] - 50 [closed] "Proposed change: tunnel vs. transport mode" - 87 [closed] "Permit Security Gateways to use transport mode when they are theouter header, nor does IPsec construct extension headers inendpoints of theouter header. However, post-IPsec code MAY insert/construct extension headerscommunication" When security is desired between two intermediate systems along a path or between an intermediate system and an end system, transport mode may now be used between security gateways and between a security gateway and a host. o [Issue #57] [closed] "ECN support" The tunnel section has been updated to explain how to handle DSCP and ECN bits. o [Issue #67] [closed] "IPsec management traffic" 2401bis clarifies that for all traffic that crosses theouter header.IPsec boundary, including IPsec management traffic, the SPD or associated caches must be consulted. Kent & Seo [Page34]53] Internet Draft Security Architecture for IPJanuaryApril 20045.2 Processing Inboundo [Issue #68] [closed] "VPNs with overlapping IPTraffic (unprotected-to-protected) Inbound processing is somewhat different from outbound processing, because of the use of SPIs to map IPsec protected traffic to SAs. The inbound SPD cache (SPD-I) is applied only to bypassed or discarded traffic. If an arriving packet appears to be an IPsec fragment from an unprotected interface, reassembly is performed prior to the IPsec processing. The intent for any SPD cache is that a packet that fails to match any entry is then referredaddress ranges" 2401bis now defines how to handle thecorresponding SPD. Every SPD SHOULD havesituation of anominal, final entry that catches anything that is otherwise unmatched, and discards it. This ensures that non-IPsec protected traffic that arrivessecurity gateway with multiple subscribers requiring separate IPsec contexts. o [Issue #69] [closed] "Multiple protocols per SPD entry" -- Covered by resolution of Issue #47 o [Issue #70] [closed] "Add diffserv (IPv4) anddoes not match any SPD-I entry willclass (IPv6) as selectors -- Covered by Issues #48 and #57 o [Issue #71] [closed] "Add definition of reserved SPIs" A definition of reserved SPIs has been added. o [Issue #72] [closed] "Explain why ALL IP packets must bediscarded. Unprotected Interface | V +-----+ IPsec protected ...................>|Demux|-------------------+ : +-----+ | : | | : | Notchecked" Text has been added explaining why ALL IP packets must be checked -- IPsec| : |-----------+ | : V | | : +-------+ V V +-----+ +-------+ |Bypass/| +------+ +------+ |SPD-O| |Discard|<---|Discard| | ICMP | |AH/ESP| +-----+ +-------+ +-------+ +------+ +------+ ^ | | : | +---+ | : Bypass | +-->|IKE| | : | | +---+ | : V | V : +----------+ +---------+ :...............|Forwarding|<------------|SAD Check| +----------+ +---------+ | V Protected Interface Figure 3. Inbound Traffic Processing Model Priorincludes minimal firewall functionality toperforming AH or ESP processing, anysupport access control at the IPfragments that arrive vialayer. o [Issue #73] [closed] "IP Option & Ext Hdr handling in Tunnel Mode" The tunnel section has been updated to clarify how to handle theunprotected interface are reassembled (by IP). Each inboundIPdatagramoptions field and IPv6 extension headers when constructing the outer header. o [Issue #74] [closed] "Inbound SA lookup -- multicast & unicast" SA mapping for inbound traffic has been updated towhich IPsec processing willbeapplied is identified by the appearance ofconsistent with the changes made in AHorand ESPvaluesfor support of unicast, anycast, and multicast SAs. o [Issue #75] [closed] "TOS (now ECN) copying in tunnel mode" Guidance has been added re: how to handle the covert channel created in tunnel mode by copying theIP Next Protocol field (orDSCP value to outer header. o [Issue #76] [accepted] "More explanation re: ESPv3 TFC padding & dummy packets" Modified ESP -- added more explanation re: ESPv3 TFC padding. IKEv2 to be modified to support negotiation of use of TFC padding. o [Issue #77] [closed] "Should AH be mandatory?" Support for AHor ESP as an extension headerintheboth IPv4 and IPv6 is now a MAY. Kent & Seo [Page35]54] Internet Draft Security Architecture for IPJanuaryApril 2004context). IPsec MUST perform the following steps: 1. When a packet arrives, it mayo [Issue #78] [closed] "PMTU issues" -- Ongoing discussion: PMTU discovery (Ravi Kumar (9/30/03), Michael Richardson (11/14/03 and 11/17/03) Will betagged with the IDupdated based on conclusion ofthe interface (physical or virtual) via which it arrived, if necessary to support multiple SPDs with different SPD-I entries. 2. The packet is examined and demuxed into onediscussion on ICMP handling. o [Issue #79] [closed] "Detection ofthree categories: - If the packet appears to be IPsec protecteddead peers andit is addressed to this device, an attempt is made to map itdead SAs -- No change required; IKEv2 handles dead peer/SA detection o [Issue #80] [closed] "Security gateway discovery" -- The IPSP working group was supposed to produce anactive SA via the SAD. - Traffic not addressed to this device is directed to BYPASS/DISCARD lookup. If multiple SPDs are employed, the tag assigned to the packet in step 1 is used to select the appropriate SPD-I (and cache) to search. - ICMP traffic directed to this device is directed to "unprotected" ICMP processing (see Section 6). 3a. If the packet is addressed to the IPsec deviceID on "SG discovery, Policy Exchange andAH or ESP is specified as the protocol, the packet is looked up in the SAD identified by the SPD-ID from step 1. For unicast traffic, use only the SPI. For multicast traffic, use the SPI plus the source and/or destination addresses, as specifiedNegotiation Protocol" inthe SAD. If thereJune 2003, but has not yet posted this draft. Added text saying "The IP Security Policy (IPSP) Working Group isno match, discard the traffic. Thisa possible future source of guidance. One of their goals isan auditable event.to produce a Internet Draft on a "Security Gateway Discovery, Policy Exchange and Negotiation Protocol." o [Issue #81] [closed] "Handling outbound red fragments (e.g., on separate SA)" Theaudit log entry forIssues Tracking Database lists thisevent SHOULD includeas Closed (rejected). The working group rejected creation of a separate SA for fragments. Based on a subsequent discussion on thecurrent date/time, SPI, source and destinationmailing list, 2401bis was amended with 3 approaches. Three approaches have been added for handling plaintext fragments on the protected side of thepacket,IPsecprotocol, and any otherboundary. An appendix has been added documenting the rationale behind them. o [Issue #82] [closed] "Creation of SAs" Current 2401bis draft has revised text re: how to derive selector valuesof the packet that are available. If the packet is found in the SAD, process it accordingly (see step 4). 3b. Iffor SAs (from thepacket is not addressed toSPD entry or from thedevice, look uppacket, etc.). A new table describing thepacket headerrelationship between selector values in an SPD entry, the(appropriate) SPD-I cache. If there is a matchPFP flag, andthe packet is to be discarded or bypassed, do so. If there is no cache match, look up the packetresulting selector values in the correspondingSPD-I and create a cache entry as appropriate. (No SAs are created in response to receipt of a packet that requires IPsec protection; only bypass or discard entries can be created this way.) If there is no match, discard the traffic. This isSAD entry. Also, anauditable event. The audit log entry for this event SHOULD include the current date/time, SPI if available,appendix on decorrelation has been added. o [Issue #83] [rejected] "DROP'd inbound packet -- missing required IPsecprotocol if available, source and destinationprotection" o [Issue #84] [closed] "DROP'd outbound packet" If an IPsec system receives an outbound packet which it finds it must discard, it SHOULD be capable ofthe packet,generating andany other selector values of the packet that are available. 3c. Unprotectedsending an ICMPprocessing is assumedmessage to indicate totake place ontheunprotected sidesender of theIPsec boundary. Unprotected ICMP messages are examined and local policy is applied to determine whether to accept or reject these messages and, if accepted, what action tooutbound packet that the packet was discarded. o [Issue #85] [closed] "DROP'd inbound packet -- does not match SA" Kent & Seo [Page36]55] Internet Draft Security Architecture for IPJanuaryApril 2004take as a result. For example, if an ICMP unreachable message is received, the implementation must decide whether to act on it, reject it, or act on it with constraints. [See Section 6.] 4. Apply AH or ESP processing as specified, using the SAD entry selected in step 2a above. Then match the packet against the inbound selectors identified by the SAD entry to verify that the received packet is appropriate for the SA via which it was received.If an IPsec system receives an inbound packet on an SA and the packet's header fields are not consistent with the selectors for the SA, itMUST dropSHOULD be able to send an IKE notification to the sender of the packet. o [Issue #86] [closed] "Add IPv6 mobility header message type as selector" IPv6 mobility header has been added as a possible Next Layer Protocol. IPv6 mobility header message type has been added as a selector. o [Issue #87] [closed] "Permit Security Gateways to use transport mode when they are the endpoints of the communication" -- See Issue 50. o [Issue #88] [accepted] "Lift the prohibition on red-side fragmentation by SG, BITS, BITW" -- See Issue 49. o [Issue #89] [closed] " Remove the selector "name"" -- Rejected. See issue 93. o [Issue #90] [closed] "Remove the selector "data sensitivity level" -- The selector "data sensitivity level" has been removed to simplify things. o [Issue #91] [pending] "Handling ICMP error messages" -- Ongoing discussion o [Issue #93] [pending] "Clarification re: thepacket. This is an auditable event.selector "name"" Theaudit log entrytext forthis event SHOULD includethecurrent date/time, SPI, IPsec protocol(s), sourceselector name has been updated anddestination of the packet,clarified. o [ na ] "Next Layer Protocol" has been further explained andany other selector valuesa default list of protocols to skip when looking for thepacketNext Layer Protocol has been added. o [ na ] The text has been amended to say thatare available, and2401bis assumes use of IKEv2 or an SA management protocol with comparable features. o [ na ] Text has been added clarifying theselector values fromalgorithm for mapping inbound IPsec datagrams to SAs in therelevant SAD entry. The system SHOULD also be capablepresence ofgeneratingmulticast SAs o [ na ] Text andsendinganIKE notificationASN.1 description have been added to clarify thesender (IPsec peer), indicating that the received packet was dropped becausestructure offailure to pass selector checks. NOTIFY MESSAGES - ERROR TYPES Value ----------------------------- ----- INVALID_SELECTORS iana-tbd MAY be sent in an IKE INFORMATIONAL Exchange when a node receivesanESP or AH packet whose selectors do not match those of the SA on which it was delivered (and which caused the packet toSPD entry and its alignment with what can bedropped).negotiated in IKE. Kent & Seo [Page 56] Internet Draft Security Architecture for IP April 2004 Acknowledgements TheNotification Data containsauthors would like to acknowledge thestartcontributions of Ran Atkinson, who played a critical role in initial IPsec activities, and who authored theoffending packet (asfirst series of IPsec standards: RFCs 1825-1827. Also a contributor who wishes to remain nameless, deserves special thanks for providing extensive help inICMP messages) andtheSPI fieldediting ofthe notification is setthis specification. The authors also would like tomatchthank theSPImembers of the IPsecSA. To minimizeand MSEC working groups who have contributed to theimpactdevelopment of this protocol specification. Kent & Seo [Page 57] Internet Draft Security Architecture for IP April 2004 Appendix A -- Glossary This section provides definitions for several key terms that are employed in this document. Other documents provide additional definitions and background information relevant to this technology, e.g., [Shi00, VK83, HA94]. Included in this glossary are generic security service and security mechanism terms, plus IPsec-specific terms. Access Control Access control is aDoS attack orsecurity service that prevents unauthorized use of amis-configured peer,resource, including theIPsec system SHOULD includeprevention of use of amanagement control to allowresource in anadministrator to configureunauthorized manner. In the IPsecimplementationcontext, the resource tosend or not send this IKE notification, and if this facilitywhich access isselected, to rate limit the transmission of such notifications. After trafficbeing controlled isbypassedoften: o for a host, computing cycles orprocessed through IPsec, itdata o for a security gateway, a network behind the gateway or bandwidth on that network. Anti-replay [See "Integrity" below] Authentication This term ishandedused informally to refer to theinbound forwarding functioncombination of two nominally distinct security services, data origin authentication and connectionless integrity. See the definitions below fordisposition. This function may causeeach of these services. Availability Availability, when viewed as a security service, addresses thepacket to be sent acrosssecurity concerns engendered by attacks against networks that deny or degrade service. For example, in the IPsecboundary for additional inbound IPsec processing, e.g.,context, the use of anti-replay mechanisms in AH and ESP supportof nested SAs. If so, then as with ALL outbound traffic thatavailability. Confidentiality Confidentiality isto be bypassed,thepacket MUST be matched against an SPD-O entry. Ultimately,security service that protects data from unauthorized disclosure. The primary confidentiality concern in most instances is unauthorized disclosure of application level data, but disclosure of thepacket shouldexternal characteristics of communication also can beforwarded toa concern in some circumstances. Traffic flow confidentiality is the service that addresses this latter concern by concealing source and destinationhostaddresses, message length, orprocess for disposition.frequency of communication. In the IPsec context, using ESP in tunnel mode, especially at a security gateway, can provide some level of traffic flow confidentiality. (See also traffic analysis, below.) Kent & Seo [Page37]58] Internet Draft Security Architecture for IPJanuaryApril 20046. ICMP Processing [This section will be filled in when IPsec issue # 91Data Origin Authentication Data origin authentication isresolved. The following text needs to be inserted somewhere, possibly this section.] NOTE: Witha security service that verifies theexceptionidentity ofIPv4 transport mode,the claimed source of data. This service is usually bundled with connectionless integrity service. Encryption Encryption is a security mechanism used to transform data from anSG, BITS, or BITW implementation MAY fragment packets before applying IPsec.intelligible form (plaintext) into an unintelligible form (ciphertext), to provide confidentiality. Thedevice SHOULD haveinverse transformation process is designated "decryption". Oftimes the term "encryption" is used to generically refer to both processes. Integrity Integrity is aconfiguration settingsecurity service that ensures that modifications todisable this. The resulting fragmentsdata areevaluated against the SPDdetectable. Integrity comes inthe normal manner. Thus, fragments not containing port numbers may onlyvarious flavors to matchrules having port selectorsapplication requirements. IPsec supports two forms ofOPAQUE or "ANY". 7. Auditing Not all systemsintegrity: connectionless and a form of partial sequence integrity. Connectionless integrity is a service thatimplement IPsec will implement auditing. For the most part,detects modification of an individual IP datagram, without regard to thegranularityordering ofauditing isthe datagram in alocal matter. However, several auditable events are identifiedstream of traffic. The form of partial sequence integrity offered inthis documentIPsec is referred to as anti-replay integrity, andfor eachit detects arrival ofthese eventsduplicate IP datagrams (within aminimum set of information that SHOULD be included in an audit logconstrained window). This isdefined. Additional information also MAY be includedinthe audit log for each of these events,contrast to connection- oriented integrity, which imposes more stringent sequencing requirements on traffic, e.g., to be able to detect lost or re- ordered messages. Although authentication andadditional events, not explicitly called outintegrity services often are cited separately, inthis specification, also MAY resultpractice they are intimately connected and almost always offered inaudit log entries.tandem. Protected vs Unprotected "Protected" refers to the systems or interfaces that are inside the IPsec protection boundary and "unprotected" refers to the systems or interfaces that are outside the IPsec protection boundary. IPsec provides a boundary through which traffic passes. There isno requirement for the receiver to transmit any messagean asymmetry tothe purported transmitterthis barrier, which is reflected inresponse tothedetection of an auditable event, becauseprocessing model. Outbound data, if not discarded or bypassed, is protected via the application of AH or ESP and thepotential to induce denialaddition ofservicethe corresponding headers. Inbound data, if not discarded or bypassed, is processed viasuch action. 8. Conformance Requirements All IPv4 systems that claim to implement IPsec MUST comply with all requirementsthe removal of AH or ESP headers. In thisdocument. All IPv6 systems that claim to implementdocument, inbound traffic enters an IPsecMUST comply with all requirements of this document. 9. Security Considerations The focus of this document is security; hence security considerations permeate this specification. 10. Differences from RFC 2401 [Will be updated when things have settled down.] This architecture document differs substantiallyimplementation fromRFC 2401 in detail and in organization, butthefundamental notions are unchanged. Kent & Seo [Page 38] Internet Draft Security Architecture for IP January 2004 Acknowledgements The authors would like to acknowledge"unprotected" interface. Outbound traffic enters thecontributionsimplementation via the "protected" interface, or is internally generated by the implementation on the "protected" side ofRan Atkinson, who played a critical role in initial IPsec activities,the boundary andwho authoreddirected toward thefirst series of"unprotected" interface. An IPsecstandards: RFCs 1825-1827. Also a contributor who wishes to remain nameless, deserves special thanks for providing extensive helpimplementation may support more than one interface on either or both sides of the boundary. The protected interface may be internal, e.g., inthe editinga host implementation ofthis specification.IPsec. Theauthors also would like to thank the members of the IPsec and MSEC working groups who have contributedprotected interface may link to a socket layer interface presented by thedevelopment of this protocol specification.Kent & Seo [Page39]59] Internet Draft Security Architecture for IPJanuaryApril 2004AppendixOS. Security Association (SA) A-- Glossary This section provides definitionssimplex (uni-directional) logical connection, created forseveral key terms that are employed in this document. Other documents provide additional definitions and background information relevant to this technology, e.g., [Shi00, VK83, HA94]. Included in this glossary are genericsecurityservice and security mechanism terms, plus IPsec-specific terms. Access Control Access controlpurposes. All traffic traversing an SA isaprovided the same securityservice that prevents unauthorized use of a resource, includingprocessing. In IPsec, an SA is an internet layer abstraction implemented through theprevention ofuse ofa resourceAH or ESP. State data associated with an SA is represented in the Security Association Database (SAD). Security Gateway A security gateway is anunauthorized manner. Inintermediate system that acts as theIPsec context,communications interface between two networks. The set of hosts (and networks) on theresource to which access is being controlledexternal side of the security gateway isoften: o fortermed unprotected (they are generally at least less protected than those "behind" the SG), while the networks and hosts on the internal side are viewed as protected. The internal subnets and hosts served by ahost, computing cycles or data o forsecurity gateway are presumed to be trusted by virtue of sharing a common, local, security administration. (See "Trusted Subnetwork" below.) In the IPsec context, a securitygateway, a network behind thegatewayor bandwidth on that network. Anti-replay [See "Integrity" below] Authentication This termisused informally to refera point at which AH and/or ESP is implemented in order tothe combinationserve a set oftwo nominally distinctinternal hosts, providing securityservices, data origin authentication and connectionless integrity. See the definitions belowservices foreach oftheseservices. Availability Availability,hosts whenviewed as athey communicate with external hosts also employing IPsec (either directly or via another securityservice, addressesgateway). SPI Acronym for "Security Parameters Index" (SPI). The SPI is an arbitrary 32-bit value that is used by a receiver to identify thesecurity concerns engenderedSA to which an incoming packet should be bound. For a unicast SA, the SPI can be used byattacks against networks that denyitself to specify an SA, ordegrade service. For example,it may be used in conjunction with the IPseccontext, the use of anti-replay mechanismsprotocol type. Additional IP address information is used to identify multicast SAs. The SPI is carried in AH and ESPsupport availability. Confidentiality Confidentiality isprotocols to enable thesecurity service that protects data from unauthorized disclosure. The primary confidentiality concern in most instances is unauthorized disclosurereceiving system to select the SA under which a received packet will be processed. An SPI has only local significance, as defined by the creator ofapplication level data, but disclosurethe SA (usually the receiver of the packet carrying the SPI); thus an SPI is generally viewed as an opaque bit string. However, the creator of an SA may choose to interpret theexternal characteristics of communication also can be a concernbits insome circumstances.an SPI to facilitate local processing. Traffic Analysis The analysis of network traffic flowconfidentiality isfor theservicepurpose of deducing information thataddresses this latter concern by concealing source and destination addresses, message length, oris useful to an adversary. Examples of such information are frequency ofcommunication. Intransmission, theIPsec context, using ESP in tunnel mode, especially at a security gateway, can provide some levelidentities oftraffic flow confidentiality. (See also traffic analysis, below.) Data Origin Authentication Data origin authentication is a security service that verifiesthe conversing parties, sizes of packets, flow identifiers, etc. [Sch94] Kent & Seo [Page40]60] Internet Draft Security Architecture for IPJanuaryApril 2004identity of the claimed source of data.Appendix B - Decorrelation Thisservice is usually bundled with connectionless integrity service. Encryption Encryption is a security mechanism used to transform data from an intelligible form (plaintext) into an unintelligible form (ciphertext), to provide confidentiality. The inverse transformation process is designated "decryption". Oftimes the term "encryption" is used to generically refer to both processes. Integrity Integrity is a security service that ensures that modifications to data are detectable. Integrity comes in various flavors to match application requirements. IPsec supports two forms of integrity: connectionless and a form of partial sequence integrity. Connectionless integritysection isa service that detects modification of an individual IP datagram, without regard to the ordering of the datagram in a stream of traffic. The formbased on work done for caching ofpartial sequence integrity offeredpolicies inIPsec is referred to as anti-replay integrity, and it detects arrival of duplicatethe IPdatagrams (within a constrained window). ThisSecurity Policy Working Group by Luis Sanchez, Matt Condell, and John Zao. Two SPD entries are correlated if there is a non-null intersection between the values of corresponding selectors incontrast to connection- oriented integrity, which imposes more stringent sequencing requirements on traffic, e.g.,each entry. Caching correlated SPD entries can lead tobe ableincorrect policy enforcement. A solution todetect lost or re- ordered messages. Although authentication and integrity services often are cited separately, in practice they are intimately connected and almost always offered in tandem. Protected vs Unprotected "Protected" refersthis problem, that still allows for caching, is to remove thesystems or interfaces that are insideambiguities by decorrelating theIPsec protection boundary and "unprotected" refers toentries. That is, thesystems or interfacesSPD entries must be rewritten so thatare outside the IPsec protection boundary. IPsec providesfor every pair of entries there exists abarrier through which traffic passes. There is an asymmetry to this barrier,selector for which there isreflecteda null intersection between the values in both of theprocessing model. Outbound data, if not discarded or bypassed, is protected viaentries. Once theapplication of AH or ESPentries are decorrelated, there is no longer any ordering requirement on them, since only one entry will match any lookup. The next section describes decorrelation in more detail and presents an algorithm that may be used to implement decorrelation. B.1 Decorrelation Algorithm The basic decorrelation algorithm takes each entry in a correlated SPD and divides it up into a set of entries using a tree structure. The resulting entries that are decorrelated with theadditiondecorrelated set ofthe corresponding headers. Inbound data, ifentries are then added to that decorrelated set. The basic algorithm does notdiscarded or bypassed, is processed via the removal of AH or ESP headers. In this document, inbound traffic entersguarantee anIPsec implementation from the "unprotected" interface. Outbound traffic enters the implementation viaoptimal set of decorrelated entries. That is, the"protected" interface, orentries may be broken up into smaller sets than isemitted by the implementation onnecessary, though they will still provide all the"protected" side ofnecessary policy information. Some extensions to theboundarybasic algorithm are described later to improve this anddirected towardimprove the"unprotected" interface. An IPsec implementation may support more than one interface on either or both sidesperformance of theboundary.algorithm. C A set of ordered, correlated entries (a correlated SPD) Ci Theprotected interface may be internal, e.g.,ith entry ina host implementationC. U The set ofIPsec.decorrelated entries being built from C Ui Theprotected interface may link to a socket layer interface presented by the OS. Kent & Seo [Page 41] Internet Draft Security Architectureith entry in U. Sik The kth selection forIP January 2004 Security Association (SA) A simplex (uni-directional) logical connection, createdpolicy Ci Ai The action forsecurity purposes. All traffic traversing an SA is provided the same security processing. In IPsec, an SA is an internet layer abstraction implemented through the use of AH or ESP. State data associated with an SA is represented in the Security Association Database (SAD). Security Gatewaypolicy Ci Asecurity gateway is an intermediate system that actspolicy (SPD entry) P may be expressed asthe communications interface between two networks. The set of hosts (and networks) on the external sidea sequence ofthe security gateway is termed unprotected (they are at generally at least less protected than those "behind the SG), while the networks and hostsselector values andon the internal side are viewedan action (BYPASS, DISCARD, or PROTECT): Ci = Si1 x Si2 x ... x Sik -> Ai 1) Put C1 in set U asprotected. The internal subnets and hosts served by a security gateway are presumedU1 For each policy Cj (j > 1) in C Kent & Seo [Page 61] Internet Draft Security Architecture for IP April 2004 2) If Cj is decorrelated with every entry in U, then add it tobe trusted by virtue of sharing a common, local, security administration. (See "Trusted Subnetwork" below.) In the IPsec context, a security gatewayU. 3) If Cj is correlated with one or more entries in U, create apointtree rooted atwhich AH and/or ESP is implemented in order to servethe policy Cj that partitions Cj into a set ofinternal hosts, providing security services for these hosts when they communicate with external hosts also employing IPsec (either directly or via another security gateway). SPI Acronym for "Security Parameters Index" (SPI).decorrelated entries. Thecombination of a destination address,algorithm starts with asecurity protocol, and an SPI uniquely identifiesroot node where no selectors have yet been chosen. A) Choose asecurity association (SA, see above)selector in Cj, Sjn, that has not yet been chosen when traversing thecontext of unicast or anycast traffic. Additional IP address informationtree from the root to this node. If there are no selectors not yet used, continue to the next unfinished branch until all branches have been completed. When the tree isusedcompleted, go toidentify multicast SAs. The SPIstep D. T iscarriedthe set of entries inAH and ESP protocols to enableU that are correlated with thereceiving system to selectentry at this node. The entry at this node is theSA under which a received packet will be processed. An SPI has only local significance, as definedentry formed by thecreatorselector values ofthe SA (usually the receivereach of thepacket carryingbranches between theSPI); thus an SPI is generally viewed as an opaque bit string. However,root and this node. Any selector values that are not yet represented by branches assume thecreator of an SA may choose to interpretcorresponding selector value in Cj, since thebitsvalues inan SPI to facilitate local processing. Traffic Analysis The analysis of network traffic flow forCj represent thepurpose of deducing information that is usefulmaximum value for each selector. B) Add a branch toan adversary. Examples of such information are frequency of transmission,theidentities of the conversing parties, sizes of packets, flow identifiers, etc. [Sch94] Kent & Seo [Page 42] Internet Draft Security Architecturetree forIP January 2004 Appendix B - Decorrelation This section is based on work done in the IP Security Policy Working Group by Luis Sanchez, Matt Condell, and John Zao. Two SPDeach value of the selector Sjn that appears in any of the entriesare correlated if therein T. (If the value is anon-null intersection betweensuperset of thevaluesvalue ofcorresponding selectorsSjn ineach entry. Caching correlated SPD entries can lead to incorrect policy enforcement. A solution to this problem,Cj, then use the value in Cj, since thatstill allowsvalue represents the universal set.) Also add a branch forcaching, is to removetheambiguities by decorrelatingcomplement of theentries. That is,union of all theSPD entries must be rewritten so that for every pairvalues ofentries there exists athe selectorfor which thereSjn in T. When taking the complement, remember that the universal set isa null intersection betweenthevalues in bothvalue of Sjn in Cj. A branch need not be created for theentries. Oncenull set. C) Repeat A and B until theentries are decorrelated, theretree isno longer any ordering requirement on them, since only one entry will match any lookup.completed. D) Thenext section describes decorrelation in more detail and presents an algorithm that may be usedentry toimplement decorrelation. B.1 Decorrelation Algorithm The basic decorrelation algorithm takeseach leaf now represents an entryin a correlated SPD and divides it up intothat is asetsubset of Cj. The entriesusingat the leaves completely partition Cj in such atree structure. Thoseway that each entry is either completely overridden by an entry in U, or is decorrelated with the entries in U. Add all the decorrelated entries at the leaves of theresultingtree to U. 4) Get next Cj and go to 2. 5) When all entriesthat are decorrelated with thein C have been processed, then U will contain an decorrelatedsetversion ofentriesC. There arethen addedseveral optimizations that can be made to this algorithm. A few of them are presented here. Kent & Seo [Page 62] Internet Draft Security Architecture for IP April 2004 It is possible to optimize, or at least improve, the amount of branching thatdecorrelated set. The basic algorithm does not guarantee an optimal setoccurs by carefully choosing the order ofdecorrelated entries. That is,theentries mayselectors used for the next branch. For example, if a selector Sjn can bebroken up into smaller sets than is necessary, though they will still providechosen so that all thenecessary policy information. Some extensions to the basic algorithmvalues for that selector in T aredescribed laterequal toimprove this and improve the performanceor a superset of thealgorithm. C A set of ordered, correlated entries (a correlated SPD) Ci The ith entry in C. U The setvalue ofdecorrelated entries being built from C Ui The ith entrySjn inU. A policy (SPD entry) P may be expressed asCj, then only asequencesingle branch needs to be created (since the complement will be null). Branches ofselector values and an action (Bypass, Discard, or apply IPsec): Pi = Si1 x Si2 x ... x Sik -> Ai 1) Put C1 in set U as U1the tree do not have to proceed with the entire decorrelation algorithm. Foreach policy Cj (j > 1) in C 2) If Cjexample, if a node represents an entry that is decorrelated withevery entryall the entries in U, thenadd itthere is no reason toU. Kent & Seo [Page 43] Internet Draft Security Architecture for IP January 2004 3) If Cjcontinue decorrelating that branch. Also, if a branch iscorrelated with one or more entriescompletely overridden by an entry in U,create a tree rooted atthen there is no reason to continue decorrelating thepolicy Cj that partitions Cj intobranch. An additional optimization is to check to see if asetbranch is overridden by one ofdecorrelated entries. The algorithm starts with a root node where no selectors have yet been chosen. A) Choose a selectorthe CORRELATED entries inCj, Scjn,set C that hasnot yetalready beenchosen when traversing the tree from the root to this node. If there are no selectors not yet used, continue todecorrelated. That is, if thenext unfinishedbranchuntil all branches have been completed. When the treeiscompleted, gopart of decorrelating Cj, then check tostep D. Tsee if it was overridden by an entry Cm, m < j. This is a valid check, since all theset ofentriesin U thatCm arecorrelatedalready expressed in U. Along withthe entry at this node. Thechecking if an entryat this nodeisthe entry formedalready decorrelated in step 2, check if Cj is overridden bythe selector values of each of the branches between the root and this node. Any selector values that areany entry in U. If it is, skip it since it is notyet represented by branches assume the correspondingrelevant. An entry x is overridden by another entry y if every selectorvalue in Cj, since the valuesinCj represent the maximum value for each selector. B) Add a branchx is equal tothe tree for each valueor a subset of the corresponding selectorScjn that appearsinanyentry y. Kent & Seo [Page 63] Internet Draft Security Architecture for IP April 2004 Appendix C -- Categorization ofthe entries in T. (If the value is a supersetICMP messages [May be deleted] The tables below characterize ICMP messages as being either host generated, router generated, both, unassigned/unknown. The first set ofthe valuemessages are for IPv4. The second set ofScjn in Cj, then usemessages are for IPv6. IPv4 Type Name/Codes Reference ======================================================================== HOST GENERATED: 3 Destination Unreachable 2 Protocol Unreachable [RFC792] 3 Port Unreachable [RFC792] 8 Source Host Isolated [RFC792] 14 Host Precedence Violation [RFC1812] 10 Router Selection [RFC1256] Type Name/Codes Reference ======================================================================== ROUTER GENERATED: 3 Destination Unreachable 0 Net Unreachable [RFC792] 4 Fragmentation Needed, Don't Fragment was Set [RFC792] 5 Source Route Failed [RFC792] 6 Destination Network Unknown [RFC792] 7 Destination Host Unknown [RFC792] 9 Comm. w/Dest. Net. is Administratively Prohibited [RFC792] 11 Destination Network Unreachable for Type of Service[RFC792] 5 Redirect 0 Redirect Datagram for thevalue in Cj, since that value representsNetwork (or subnet) [RFC792] 2 Redirect Datagram for theuniversal set.) Also add a branchType of Service & Network[RFC792] 9 Router Advertisement [RFC1256] 18 Address Mask Reply [RFC950] Kent & Seo [Page 64] Internet Draft Security Architecture for IP April 2004 IPv4 Type Name/Codes Reference ======================================================================== BOTH ROUTER AND HOST GENERATED: 0 Echo Reply [RFC792] 3 Destination Unreachable 1 Host Unreachable [RFC792] 10 Comm. w/Dest. Host is Administratively Prohibited [RFC792] 12 Destination Host Unreachable forthe complement of the union of all the valuesType ofthe selector ScjnService [RFC792] 13 Communication Administratively Prohibited [RFC1812] 15 Precedence cutoff inT. When taking the complement, remember that the universal set iseffect [RFC1812] 4 Source Quench [RFC792] 5 Redirect 1 Redirect Datagram for thevalue of Scjn in Cj. A branch need not be createdHost [RFC792] 3 Redirect Datagram for thenull set. C) Repeat AType of Service andB until the tree is completed. D) The entryHost [RFC792] 6 Alternate Host Address [JBP] 8 Echo [RFC792] 11 Time Exceeded [RFC792] 12 Parameter Problem [RFC792,RFC1108] 13 Timestamp [RFC792] 14 Timestamp Reply [RFC792] 15 Information Request [RFC792] 16 Information Reply [RFC792] 17 Address Mask Request [RFC950] 30 Traceroute [RFC1393] 31 Datagram Conversion Error [RFC1475] 32 Mobile Host Redirect [Johnson] 39 SKIP [Markson] 40 Photuris [Simpson] Type Name/Codes Reference ======================================================================== UNASSIGNED TYPE OR UNKNOWN GENERATOR: 1 Unassigned [JBP] 2 Unassigned [JBP] 7 Unassigned [JBP] 19 Reserved (for Security) [Solo] 20-29 Reserved (for Robustness Experiment) [ZSu] 33 IPv6 Where-Are-You [Simpson] 34 IPv6 I-Am-Here [Simpson] 35 Mobile Registration Request [Simpson] 36 Mobile Registration Reply [Simpson] 37 Domain Name Request [Simpson] 38 Domain Name Reply [Simpson] 41-255 Reserved [JBP] Kent & Seo [Page 65] Internet Draft Security Architecture for IP April 2004 IPv6 Type Name/Codes Reference ======================================================================== HOST GENERATED: 1 Destination Unreachable [RFC 1885] 4 Port Unreachable Type Name/Codes Reference ======================================================================== ROUTER GENERATED: 1 Destination Unreachable [RFC1885] 0 No Route toeach leaf now represents an entry thatDestination 1 Comm. w/Destination is Administratively Prohibited 2 Not asubset of Cj. The entries at the leaves completely partition Cj in such a way that each entry is either completely overridden by an entry in U, or is decorrelated with the entries in U. Add all the decorrelated entries at the leaves of the tree to U. 4) Get next Cj and go to 2. 5) When all entriesNeighbor 3 Address Unreachable 2 Packet Too Big [RFC1885] 0 3 Time Exceeded [RFC1885] 0 Hop Limit Exceeded inC have been processed, then U will contain an decorrelated version of C. There are several optimizations that can be made to this algorithm. A few of them are presented here. It is possible to optimize, or at least improve, the amount of branching that occurs by carefully choosing the order of theTransit 1 Fragment reassembly time exceeded Type Name/Codes Reference ======================================================================== BOTH ROUTER AND HOST GENERATED: 4 Parameter Problem [RFC1885] 0 Erroneous Header Field Encountered 1 Unrecognized Next Header Type Encountered 2 Unrecognized IPv6 Option Encountered Kent & Seo [Page44]66] Internet Draft Security Architecture for IPJanuaryApril 2004selectors used for the next branch. For example, if a selector Scjn can be chosen so that all the values for that selector in T are equal to or a superset of the value of Scjn in Cj, then only a single branch needs to be created (since the complement will be null). Branches of the tree do not have to proceed with the entire decorrelation algorithm. For example, if a node representsAppendix D -- ASN.1 for an SPD entrythat is decorrelated with all the entries(work inU, then there is no reasonprogress) This appendix uses ASN.1 syntax tocontinue decorrelatingdescribe the information thatbranch. Also, if a branchiscompletely overridden by an entrycontained inU, then there is no reasonan SPD. Since it describes encodings that are tocontinue decorrelatingbe used with thebranch.key management protocol, e.g., IKEv2, using ASN.1 constraints, it will not compile as shown due to "duplicate" tags. -- Anadditional optimizationSPD isto check to see ifabranch is overridden by onelist ofthe CORRELATED entriespolicies inset Cdecreasing order of preference SPD ::= SEQUENCE OF SPDEntry -- An entry describes either traffic to be afforded IPsec protection -- or traffic thathas already been decorrelated. That is, if the branchispart of decorrelating Cj, then checktosee if it was overridden by anbe bypassed or discarded SPDEntry ::= CHOICE { iPsecEntry IPsecEntry, -- PROTECT traffic bypassOrDiscard BypassOrDiscardEntry } -- DISCARD/BYPASS -- traffic -- A "selector set" IPsecEntry ::= SEQUENCE { -- Each entryCm, m < j. This is a valid check, since allconsist of: name SEQUENCE { passed SET OF Names, -- Matched to IKE ID local SET OF Names }, -- Used internally -- Populate from packet flags pFPs BIT STRING { -- applies to ALL of theentries Cm are already expressed in U. Along with checking if an entry is already decorrelated in step 2, check if Cj is overridden by any entry in U. If it is, skip it since it iscorrespond- pfpLocalAddr (0), -- ing traffic selectors; pfpRemoteAddr (1), -- one does notrelevant. An entry x is overridden bywant to pfpProtocol (2), -- allow some SelectorSet pfpLocalNext (3), -- items to use one value pfpRemoteNext (4)}, -- and some to use anotherentry y if every selector in x is equal-- Policy "condition" condition SET OF SelectorList, -- Policy "action" processing SEQUENCE { mode BOOLEAN, -- TRUE: transport, FALSE: tunnel extSeqNum BOOLEAN, -- TRUE: 64 bit, FALSE: 32 bit fragCheck BOOLEAN, -- TRUE: stateful fragment checking, -- FALSE: no stateful fragment -- checking [need toor a subset ofadd fields/etc. for thecorresponding selector in entry y.following SEQ counter overflow SA lifetime manual SPI Kent & Seo [Page45]67] Internet Draft Security Architecture for IPJanuaryApril 2004Appendix CDS ECN DF Flow Label] CHOICE { aH IntegrityAlgs, eSP SEQUENCE { IntegrityAlgs, ConfidentialityAlgs } } } } Names ::= CHOICE { -- IKEv2 IDs: DistinguishedName, -- ID_DER_ASN1_DN FQDN, -- ID_FQDN RFC822Name } OPTIONAL, -- ID_RFC822_ADDR BypassOrDiscardEntry ::= SEQUENCE { action BOOLEAN, -- TRUE: BYPASS, FALSE: DISCARD outbound SET OF SelectorList OPTIONAL, -- one or both may inbound SET OF SelectorList OPTIONAL } --Categorization of ICMP messages [Maybedeleted] The tables below characterize ICMP messages as being either host generated, router generated, both, unassigned/unknown. The first set of messages are for IPv4. The second set of messages arepresent -- A "selector set" SelectorList ::= SEQUENCE { localAddr AddrList, remoteAddr AddrList, protocol CHOICE { -- Representation forIPv6. IPv4 Type Name/Codes Reference ======================================================================== HOST GENERATED: 3 Destination Unreachable 2 Protocol Unreachable [RFC792] 3 Port Unreachable [RFC792] 8 Source Host Isolated [RFC792] 14 Host Precedence Violation [RFC1812] 10 Router Selection [RFC1256] Type Name/Codes Reference ======================================================================== ROUTER GENERATED: 3 Destination Unreachable 0 Net Unreachable [RFC792] 4 Fragmentation Needed, Don'tANY protocol anyProt SEQUENCE { INTEGER (0), -- ANY protocol SEQUENCE { -- with either ANY, -- ANY next layer selector ANY }, -- ANY next layer selector -- Protocols that have no next layer items noNext SEQUENCE { INTEGER (2..254), SEQUENCE { -- if protocol has no next OPAQUE, OPAQUE } }, -- Fragments that have no next layer information frag SEQUENCE { INTEGER (44), -- Fragmentwas Set [RFC792] 5 Source Route Failed [RFC792] 6 Destination Network Unknown [RFC792] 7 Destination Host Unknown [RFC792] 9 Comm. w/Dest. Net. is Administratively Prohibited [RFC792] 11 Destination Network Unreachableidentifier SEQUENCE { OPAQUE, OPAQUE } }, Kent & Seo [Page 68] Internet Draft Security Architecture forTypeIP April 2004 -- Protocols that have one next layer item oneNext SEQUENCE { INTEGER (1..254), -- ICMP, MH, ICMPv6 SEQUENCE { -- ICMP Type*256+Code type NextChoice, -- MH Type*256 OPAQUE } }, -- Protocols that have two next layer items twoNext SEQUENCE { INTEGER (2..254), -- Protocol SEQUENCE { local NextChoice, -- Local and remote NextChoice }}} -- Remote ports } NextChoice ::= CHOICE { aNY ANY, oPAQUE OPAQUE, range Next } -- Representation ofService[RFC792] 5 Redirect 0 Redirect Datagram for the Network (or subnet) [RFC792] 2 Redirect DatagramANY in next layer field ANY ::= SEQUENCE { start INTEGER (0), end INTEGER (65535) } -- Representation of OPAQUE in next layer field OPAQUE ::= SEQUENCE { start INTEGER (65535), end INTEGER (0) } -- Range forthe Typea next layer field Next ::= SEQUENCE { start INTEGER (0..65535), end INTEGER (0..65535) } -- List ofService & Network[RFC792] 9 Router Advertisement [RFC1256] 18 Address Mask Reply [RFC950]IP addresses AddrList ::= SEQUENCE { IPv4List OPTIONAL, IPv6List OPTIONAL } Kent & Seo [Page46]69] Internet Draft Security Architecture for IPJanuary 2004 IPv4 Type Name/Codes Reference ======================================================================== BOTH ROUTER AND HOST GENERATED: 0 Echo Reply [RFC792] 3 Destination Unreachable 1 Host Unreachable [RFC792] 10 Comm. w/Dest. Host is Administratively Prohibited [RFC792] 12 Destination Host Unreachable for Type of Service [RFC792] 13 Communication Administratively Prohibited [RFC1812] 15 Precedence cutoff in effect [RFC1812] 4 Source Quench [RFC792] 5 Redirect 1 Redirect Datagram for the Host [RFC792] 3 Redirect Datagram for the Type of Service and Host [RFC792] 6 Alternate Host Address [JBP] 8 Echo [RFC792] 11 Time Exceeded [RFC792] 12 Parameter Problem [RFC792,RFC1108] 13 Timestamp [RFC792] 14 Timestamp Reply [RFC792] 15 Information Request [RFC792] 16 Information Reply [RFC792] 17 Address Mask Request [RFC950] 30 Traceroute [RFC1393] 31 Datagram Conversion Error [RFC1475] 32 Mobile Host Redirect [Johnson] 39 SKIP [Markson] 40 Photuris [Simpson] Type Name/Codes Reference ======================================================================== UNASSIGNED TYPE OR UNKNOWN GENERATOR: 1 Unassigned [JBP] 2 Unassigned [JBP] 7 Unassigned [JBP] 19 Reserved (for Security) [Solo] 20-29 Reserved (for Robustness Experiment) [ZSu] 33 IPv6 Where-Are-You [Simpson] 34 IPv6 I-Am-Here [Simpson] 35 Mobile Registration Request [Simpson] 36 Mobile Registration Reply [Simpson] 37 Domain Name Request [Simpson] 38 Domain Name Reply [Simpson] 41-255 Reserved [JBP]April 2004 -- IPv4 address representations IPv4List ::= CHOICE { anyIPv4 SEQUENCE { OCTET STRING ('00000000'H) (SIZE (4)), OCTET STRING ('FFFFFFFF'H) (SIZE (4)) }, ipv4List SET OF CHOICE { ipv4Addr OCTET STRING (SIZE (4)), ipv4Range SEQUENCE { -- close, but not quite right ... ipv4Start OCTET STRING ('00000001'H..'FFFFFFFE'H) (SIZE (4)), ipv4End OCTET STRING ('00000001'H..'FFFFFFFE'H) (SIZE (4)) } } } -- IPv6 address representations IPv6List ::= CHOICE { anyIPv6 SEQUENCE { OCTET STRING ('00000000000000000000000000000000'H) (SIZE (16)), OCTET STRING ('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF'H) (SIZE (16)) }, ipv6List SET OF CHOICE { ipv6Addr OCTET STRING (SIZE (16)), ipv6Range SEQUENCE { -- close, but not quite right ... ipv6Start OCTET STRING ('00000000000000000000000000000001'H ..'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE'H) (SIZE (16)), ipv6End OCTET STRING ('00000000000000000000000000000001'H ..'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE'H) (SIZE (16)) } } } -- Integrity Algorithms, ordered by decreasing preference IntegrityAlgs ::= SEQUENCE OF IntegAlg -- Confidentiality Algorithms, ordered by decreasing preference ConfidentialityAlgs ::= SEQUENCE OF ConfAlg Kent & Seo [Page47]70] Internet Draft Security Architecture for IPJanuaryApril 2004IPv6 Type Name/Codes Reference ======================================================================== HOST GENERATED: 1 Destination Unreachable [RFC 1885] 4 Port Unreachable Type Name/Codes Reference ======================================================================== ROUTER GENERATED: 1 Destination Unreachable [RFC1885] 0 No Route to Destination 1 Comm. w/Destination is Administratively Prohibited 2 Not a Neighbor 3 Address Unreachable 2 Packet Too Big [RFC1885] 0 3 Time Exceeded [RFC1885] 0 Hop Limit Exceeded in Transit 1-- Integrity Algorithms IntegAlg ::= SEQUENCE { algorithm ENUMERATED { NONE (0), AUTH_HMAC_MD5_96 (1), AUTH_HMAC_SHA1_96 (2), AUTH_DES_MAC (3), AUTH_KPDK_MD5(4), AUTH_AES_XCBC_96 (5), TBD (6..65535) }, parameters ANY DEFINED BY algorithm OPTIONAL } -- Confidentiality Algorithms ConfAlg ::= SEQUENCE { algorithm ENUMERATED { ENCR_DES_IV64 (1), ENCR_DES (2), ENCR_3DES (3), ENCR_RC5 (4), ENCR_IDEA (5), ENCR_CAST (6), ENCR_BLOWFISH (7), ENCR_3IDEA (8), ENCR_DES_IV32 (9), ENCR_RC4 (10), ENCR_NULL (11), ENCR_AES_CBC (12), ENCR_AES_CTR (13), TBD (14..65535) }, parameters ANY DEFINED BY algorithm OPTIONAL } Kent & Seo [Page 71] Internet Draft Security Architecture for IP April 2004 Appendix E -- Fragmentreassembly time exceeded Type Name/Codes Reference ======================================================================== BOTH ROUTER AND HOST GENERATED: 4 Parameter Problem [RFC1885] 0 Erroneous Header Field Encountered 1 Unrecognized Next Header Type Encountered 2 Unrecognized IPv6 Option EncounteredHandling Rationale [Will be added in next draft -- based on write up Steve distributed on the list plus subsequent discussion.] Kent & Seo [Page48]72] Internet Draft Security Architecture for IPJanuaryApril 2004 References [Will be updated after the text settles down] Normative [Bra97] Bradner, S., "Key words for use in RFCs to Indicate Requirement Level", BCP 14, RFC 2119, March 1997. [DH98] Deering, S., and R. Hinden, "Internet Protocol, Version 6 (IPv6) Specification", RFC 2460, December 1998. [Eas03] Eastlake, D., "Cryptographic Algorithm Implementation Requirements For ESP And AH", draft-ietf-ipsec-esp-ah- algorithms-00.txt, December 2003. [HC03] Holbrook, H., and Cain, B., "Source Specific Multicast for IP", Internet Draft, draft-ietf-ssm-arch-01.txt, November 3, 2002. [Kau03] Kaufman, C., "The Internet Key Exchange (IKEv2) Protocol", draft-ietf- ipsec-ikev2-11.txt, October 2003 [Ken04a] Kent, S., "IP Encapsulating Security Payload (ESP)", RFC ???, ???? 2004. [Ken04b] Kent, S., "IP Authentication Header", RFC ???, ??? 2004. [Mobip] Johnson, D., Perkins, C., Arkko, J., "Mobility Support in IPv6", Internet Draft, draft-ietf-mobileip-ipv6-24.txt, June 2003 [Pos81] Postel, J., "Internet Protocol", STD 5, RFC 791, September 1981 [Sch03] Schiller, J., "Cryptographic Algorithms for use in the Internet Key Exchange Version 2", draft-ietf-ipsec- ikev2-algorithms-04.txt, September 2003 Informative [BL73] Bell, D.E. & LaPadula, L.J., "Secure Computer Systems: Mathematical Foundations and Model", Technical Report M74-244, The MITRE Corporation, Bedford, MA, May 1973. [DoD85] US National Computer Security Center, "Department of Defense Trusted Computer System Evaluation Criteria", DoD5200.28-STD, US Department of Defense, Ft. Meade, MD., December 1985.Kent & Seo [Page49]73] Internet Draft Security Architecture for IPJanuaryApril 2004 5200.28-STD, US Department of Defense, Ft. Meade, MD., December 1985. [DoD87] US National Computer Security Center, "Trusted Network Interpretation of the Trusted Computer System Evaluation Criteria", NCSC-TG-005, Version 1, US Department of Defense, Ft. Meade, MD., 31 July 1987. [FaLiHaMeTr00]Farinacci, D., Li, T., Hanks, S., Meyer, D., Traina, P., "Generic Routing Encapsulation (GRE), RFC 2784, March 2000. [Gro02] Grossman, D., "New Terminology and Clarifications for Diffserv", RFC 3260, April 2002. [HA94] Haller, N., and Atkinson, R., "On Internet Authentication", RFC 1704, October 1994 [ISO] ISO/IEC JTC1/SC6, Network Layer Security Protocol, ISO-IEC DIS 11577, International Standards Organisation, Geneva, Switzerland, 29 November 1992. [IB93] Ioannidis, J. and Blaze, M., "Architecture and Implementation of Network-layer Security Under Unix", Proceedings of USENIX Security Symposium, Santa Clara, CA, October 1993. [IBK93] Ioannidis, J., Blaze, M., and Karn, P., "swIPe: Network- Layer Security for IP", presentation at the Spring 1993 IETF Meeting, Columbus, Ohio [Ken91] Kent, S., "US DoD Security Options for the Internet Protocol", RFC 1108, November 1991. [MSST97] Maughan, D., Schertler, M., Schneider, M., and J. Turner, "Internet Security Association and Key Management Protocol (ISAKMP)", RFC 2408, November 1998. [NiBlBaBL98]Nichols, K., Blake, S., Baker, F., Black, D., "Definition of the Differentiated Services Field (DS Field) in the IPv4 and IPv6 Headers", RFC2474, December 1998. [Orm97] Orman, H., "The OAKLEY Key Determination Protocol", RFC 2412, November 1998. [Per96] Perkins, C., "IP Encapsulation within IP", RFC 2003, October 1996. Kent & Seo [Page 74] Internet Draft Security Architecture for IP April 2004 [Pip98] Piper, D., "The Internet IP Security Domain of Interpretation for ISAKMP", RFC 2407, November 1998.Kent & Seo [Page 50] Internet Draft Security Architecture for IP January 2004[RaFlBL01]Ramakrishnan, K., Floyd, S., Black, D., "The Addition of Explicit Congestion Notification (ECN) to IP", RFC 3168, September 2001. [RFC3547] Baugher, M., Weis, B., Hardjono, T., Harney, H., "The Group Domain of Interpretation", RFC 3547, July 2003. [RFC3740] Hardjono, T., Weis, B., "The Multicast Group Security Architecture", RFC 3740, March 2004. [Sch94] Schneier, B., Applied Cryptography, Section 8.6, John Wiley & Sons, New York, NY, 1994. [Shi00] Shirey, R., "Internet Security Glossary", RFC 2828, May 2000. [SDNS] SDNS Secure Data Network System, Security Protocol 3, SP3, Document SDN.301, Revision 1.5, 15 May 1989, published in NIST Publication NIST-IR-90-4250, February 1990. [SMPT98] Shacham, A., Monsour, R., Pereira, R., and M. Thomas, "IP Payload Compression Protocol (IPComp)", RFC 2393, August 1998. [VK83] V.L. Voydock & S.T. Kent, "Security Mechanisms in High- level Networks", ACM Computing Surveys, Vol. 15, No. 2, June 1983. Author Information Stephen Kent BBN Technologies 10 Moulton Street Cambridge, MA 02138 USA Phone: +1 (617) 873-3988 EMail: kent@bbn.com Kent & Seo [Page 75] Internet Draft Security Architecture for IP April 2004 Karen Seo BBN Technologies 10 Moulton Street Cambridge, MA 02138 USA Phone: +1 (617) 873-3152 EMail: kseo@bbn.com Kent & Seo [Page51]76] Internet Draft Security Architecture for IPJanuaryApril 2004 Notices The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards- related documentation can be found in BCP-11. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. Copyright (C) The Internet Society (2004). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF Kent & Seo [Page52]77] Internet Draft Security Architecture for IPJanuaryApril 2004 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ExpiresJulyOctober 2004 Kent & Seo [Page53]78] ----