idr Z. Zhang Internet-Draft S. Sangli Intended status: Standards Track J. Haas Expires: 23 October 2021 Juniper Networks 21 April 2021 Bitmask Route Target draft-zzhang-idr-bitmask-route-target-01 Abstract This document specifies a new type of Route Target called Bitmask Route Target as a BGP Community Container. The key element of a Bitmask Route Target is a Bitmask. Two Bitmask Route Targets are considered equivalent for the purpose of controlling route propagation (via Route Target Constraints) and importation if the result of logical "AND" operation of the Bitmask of the two is non- zero. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 23 October 2021. Zhang, et al. Expires 23 October 2021 [Page 1] Internet-Draft bitmask-route-target April 2021 Copyright Notice Copyright (c) 2021 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Specification . . . . . . . . . . . . . . . . . . . . . . . . 3 2.1. Matching Semantics . . . . . . . . . . . . . . . . . . . 3 3. Error Handling . . . . . . . . . . . . . . . . . . . . . . . 4 4. Security Considerations . . . . . . . . . . . . . . . . . . . 4 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 6 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 6 7.1. Normative References . . . . . . . . . . . . . . . . . . 6 7.2. Informative References . . . . . . . . . . . . . . . . . 7 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 7 1. Introduction The importation and propagation of BGP routes can be controlled using Route Targets [RFC4364] and Constrained Route Target Distribution (RT-C) [RFC4684]. RT-C relies on matching a Route Target prefix. The typical matching use case is the full 8-octet encoding of the Route Target Extended Community. For some applications, it's desirable to have a Route Target with the semantic of a bit-string. For such situations and it may be desirable to match such bit-string Route Targets that have specific bits set. This document defines a new type of Route Target for that purpose. An example use case of this Bitmask Route Target is documented in [I-D.zzhang-teas-network-slicing-with-flex-te]. The use of Bitmask Route Target with Constrained Route Target Distribution is specified separately in [I-D.zzhang-idr-bgp-rt-constrains-extension]. Zhang, et al. Expires 23 October 2021 [Page 2] Internet-Draft bitmask-route-target April 2021 2. Specification The Bitmask Route Target is a Transitive BGP Community Container of type TBD1 [I-D.ietf-idr-wide-bgp-communities]. The semantics of Global Administrator and Local Administor are identical to those in [RFC4360]. The container's contents is a series of Bitmask Route Targets. Each Bitmask Route Target includes a 1-octet Global Administrator (GA) Type, a 1-octet GA Sub-Type, 1-octet GA Length, a variable length GA, a 4-octet Local Administrator (LA), a 1-octet Bitmask Length in number of octets, and a variable length Bitmask. 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | GA Type | GA Sub-Type | GA Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Global Administrator (variable length) ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Local Administrator | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Bitmask Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ~ Bitmask (variable length) ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The following GA Types and corresponding lengths are defined in this document: 1: AS Number, 4-octets 2: IPv4 Address, 4-octets 3: IPv6 Address, 16-octets The follow GA Sub-Types are defined in this document: 2: Route-Target 2.1. Matching Semantics A Bitmask Route Target, A, is considered to match Bitmask Route Target, B, for the purpose of controlling propagation and importation of a route with an attached Bitmask Route Target B if the following conditions are met: Zhang, et al. Expires 23 October 2021 [Page 3] Internet-Draft bitmask-route-target April 2021 * The GA Type, GA Sub-Type, GA Length, GA, and LA fields in A and B match. * Either: - The Bitmask Length of A is 0. In other words, "match all". - The result of the logical "AND" operation of the Bitmask field in A and B is not 0. When A and B have different Bitmask Lengths, the shorter Route Target's Bitmask is considered to be padded with zeroes for match purposes vs. the longer one. 3. Error Handling A Bitmask Route Target MUST NOT be originated with a RESERVED GA Type. Implementations receiving BGP Routes with a RESERVED Bitmask Route Target MUST check its syntactic correctness and MAY silently discard it. A Bitmask Route Target SHOULD NOT be originated with a Bitmask Length of 0. A Bitmask Route Target is considered malformed if: * The length of the Bitmask Route Target is less than the minimum length of 8: 1-octet GA Type, 1-octet GA Sub-Type, 1-octet GA Length, 0-length GA, 4-octet LA, 0-octet Bitmask. * The Bitmask Route Target GA Type is known by the implementation and the GA Length is incorrect vs. the registered GA Type. * The total computed length of the Bitmask Route Targets in a BGP Community Container is not identical to the BGP Community Container Length. Each Bitmask Route Target's computed length is: 1-octet GA Type, 1-octet GA Length field, N-octet GA Length value, 4-octet LA field, 1-octet Bitmask Length, N-octet Bitmask Length value. BGP Updates containing malformed Bitmask Route Targets should use the Treat-as-withdraw behavior for the routes in the Update according to [RFC7606]. 4. Security Considerations This document does not change security aspects as discussed in [RFC4364] and [I-D.ietf-idr-wide-bgp-communities]. Zhang, et al. Expires 23 October 2021 [Page 4] Internet-Draft bitmask-route-target April 2021 5. IANA Considerations This document requests IANA to assign a BGP Community Container Type for the Bitmask Route Target from the "BGP Community Container Types" registry for TBD1. This document requests IANA to setup a "Bitmask Route Target Global Administrator Type Registry". The initial allocation and policy for this registry is: +==========+========================+================+===========+ | GA Type | GA Type Name | GA Type Length | Reference | | | | (octets) | | +==========+========================+================+===========+ | 0 | RESERVED | UNSPECIFIED | This | | | | | document | +----------+------------------------+----------------+-----------+ | 1 | AS Number | 4 | This | | | | | document | +----------+------------------------+----------------+-----------+ | 2 | IPv4 Address | 4 | This | | | | | document | +----------+------------------------+----------------+-----------+ | 3 | IPv6 Address | 16 | This | | | | | document | +----------+------------------------+----------------+-----------+ | 4..127 | Available, | TBD | - | | | Specification Required | | | +----------+------------------------+----------------+-----------+ | 128..254 | Available, First Come, | TBD | - | | | First Served | | | +----------+------------------------+----------------+-----------+ | 255 | RESERVED | UNSPECIFIED | This | | | | | document | +----------+------------------------+----------------+-----------+ Table 1: Bitmask Route Target GA-Type Registry This document requests IANA to setup a "Bitmask Route Target Global Administrator Sub-Type Registry". The initial allocation and policy for this registry is: Zhang, et al. Expires 23 October 2021 [Page 5] Internet-Draft bitmask-route-target April 2021 +=============+=====================================+===============+ | GA Sub-Type | GA Sub-Type Name | Reference | +=============+=====================================+===============+ | 0 | RESERVED | This document | +-------------+-------------------------------------+---------------+ | 1 | Available, Specification Required | - | +-------------+-------------------------------------+---------------+ | 2 | Route-Target | This document | +-------------+-------------------------------------+---------------+ | 3..127 | Available, Specification Required | - | +-------------+-------------------------------------+---------------+ | 128..254 | Available, First Come, First | - | | | Served | | +-------------+-------------------------------------+---------------+ | 255 | RESERVED | This document | +-------------+-------------------------------------+---------------+ Table 2: Bitmask Route Target GA-Sub-Type Registry 6. Acknowledgements The authors thank John Scudder for his comments and suggestions. 7. References 7.1. Normative References [I-D.ietf-idr-wide-bgp-communities] Raszuk, R., Haas, J., Lange, A., Decraene, B., Amante, S., and P. Jakma, "BGP Community Container Attribute", Work in Progress, Internet-Draft, draft-ietf-idr-wide-bgp- communities-05, 2 July 2018, . [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC7606] Chen, E., Ed., Scudder, J., Ed., Mohapatra, P., and K. Patel, "Revised Error Handling for BGP UPDATE Messages", RFC 7606, DOI 10.17487/RFC7606, August 2015, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . Zhang, et al. Expires 23 October 2021 [Page 6] Internet-Draft bitmask-route-target April 2021 7.2. Informative References [I-D.zzhang-idr-bgp-rt-constrains-extension] Zhang, Z. and J. Haas, "Generic Route Constraint Distribution Mechanism for BGP", Work in Progress, Internet-Draft, draft-zzhang-idr-bgp-rt-constrains- extension-01, 11 January 2021, . [I-D.zzhang-teas-network-slicing-with-flex-te] Zhang, Z., Hegde, S., and A. Gulko, "Network Slicing with Flexible Traffic Engineering", Work in Progress, Internet- Draft, draft-zzhang-teas-network-slicing-with-flex-te-00, 13 July 2020, . [RFC4360] Sangli, S., Tappan, D., and Y. Rekhter, "BGP Extended Communities Attribute", RFC 4360, DOI 10.17487/RFC4360, February 2006, . [RFC4364] Rosen, E. and Y. Rekhter, "BGP/MPLS IP Virtual Private Networks (VPNs)", RFC 4364, DOI 10.17487/RFC4364, February 2006, . [RFC4684] Marques, P., Bonica, R., Fang, L., Martini, L., Raszuk, R., Patel, K., and J. Guichard, "Constrained Route Distribution for Border Gateway Protocol/MultiProtocol Label Switching (BGP/MPLS) Internet Protocol (IP) Virtual Private Networks (VPNs)", RFC 4684, DOI 10.17487/RFC4684, November 2006, . Authors' Addresses Zhaohui Zhang Juniper Networks Email: zzhang@juniper.net Srihari Sangli Juniper Networks Email: ssangli@juniper.net Zhang, et al. Expires 23 October 2021 [Page 7] Internet-Draft bitmask-route-target April 2021 Jeffrey Haas Juniper Networks Email: jhaas@juniper.net Zhang, et al. Expires 23 October 2021 [Page 8]