<?xml version="1.0" encoding="US-ASCII"?>
<!-- This template is for creating an Internet Draft using xml2rfc,
     which is available here: http://xml.resource.org. -->
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<!-- used by XSLT processors -->
<!-- For a complete list and description of processing instructions (PIs), 
     please see http://xml.resource.org/authoring/README.html. -->
<?rfc strict="yes" ?>
<!-- give errors regarding ID-nits and DTD validation -->
<!-- control the table of contents (ToC) -->
<?rfc toc="yes"?>
<!-- generate a ToC -->
<?rfc tocdepth="3"?>
<!-- the number of levels of subsections in ToC. default: 3 -->
<!-- control references -->
<?rfc symrefs="yes"?>
<!-- use symbolic references tags, i.e, [RFC2119] instead of [1] -->
<?rfc sortrefs="yes" ?>
<!-- sort the reference entries alphabetically -->
<!-- control vertical white space 
     (using these PIs as follows is recommended by the RFC Editor) -->
<?rfc compact="yes" ?>
<!-- do not start each main section on a new page -->
<?rfc subcompact="no" ?>
<!-- keep one blank line between list items -->
<!-- end of list of popular I-D processing instructions -->
<rfc category="std" docName="draft-wu-idr-flowspec-sip-community-filter-01"
     ipr="trust200902" submissionType="IETF">
  <front>
    <title abbrev="Source-IP-Community Filter">Source-IP-Community Filter for
    BGP Flow Specification</title>

    <author fullname="Tianhao Wu" initials="T." surname="Wu">
      <organization>Huawei</organization>

      <address>
        <email>wutianhao10@huawei.com</email>
      </address>
    </author>

    <author fullname="Haibo Wang" initials="H." surname="Wang">
      <organization>Huawei</organization>

      <address>
        <email>rainsword.wang@huawei.com</email>
      </address>
    </author>

    <author fullname="Shunwan Zhuang" initials="S." surname="Zhuang">
      <organization>Huawei</organization>

      <address>
        <email>zhuangshunwan@huawei.com</email>
      </address>
    </author>

    <author fullname="Jie Dong" initials="J." surname="Dong">
      <organization>Huawei</organization>

      <address>
        <postal>
          <street>156 Beiqing Road</street>

          <city>Beijing</city>

          <code>100095</code>

          <country>P.R. China</country>
        </postal>

        <email>jie.dong@huawei.com</email>
      </address>
    </author>

    <author fullname="Yang Huang" initials="Y." surname="Huang">
      <organization>Huawei</organization>

      <address>
        <postal>
          <street>156 Beiqing Road</street>

          <city>Beijing</city>

          <code>100095</code>

          <country>P.R. China</country>
        </postal>

        <email>yang.huang@huawei.com</email>
      </address>
    </author>

    <date day="20" month="March" year="2026"/>

    <area>Routing</area>

    <workgroup>IDR Working Group</workgroup>

    <!---->

    <abstract>
      <t>BGP Flowspec mechanism (BGP-FS) propagates both traffic Flow
      Specifications and Traffic Filtering Actions by making use of the BGP
      NLRI and the BGP Extended Community encoding formats. This document
      specifies a new BGP-FS component type to support community-level
      filtering. The match field is the community of the source IP address
      that is encoded in the Flowspec NLRI. This function is applied in a
      single administrative domain.</t>
    </abstract>

    <note title="Requirements Language">
      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
      "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
      document are to be interpreted as described in BCP 14 <xref
      target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
      appear in all capitals, as shown here.</t>

      <t/>
    </note>
  </front>

  <middle>
    <section title="Introduction">
      <t>BGP Flow Specification (BGP-FS) <xref target="RFC8955"/> <xref
      target="RFC8956"/> defines a new BGP NLRI to distribute traffic flow
      specification rules via BGP (<xref target="RFC4271"/>). BGP-FS policies
      have a match condition that may be n-tuple match in a policy, and an
      action that modifies the packet and forwards/drops the packet. Via BGP,
      new filter rules can be sent to all BGP peers simultaneously without
      changing router configuration, and the BGP peer can install these routes
      in the forwarding table. BGP-FS defines Network Layer Reachability
      Information (NLRI) format used to distribute traffic flow specification
      rules. NLRI (AFI=1, SAFI=133) is for IPv4 unicast filtering. NLRI
      (AFI=1, SAFI=134) is for BGP/MPLS VPN filtering.<xref
      target="I-D.ietf-idr-flowspec-l2vpn"/> extends the flow-spec rules for
      layer 2 Ethernet packets.</t>

      <t>This document specifies a new BGP-FS component type to support
      community-level filtering. The match field is the community of the
      source IP address that is encoded in the Flowspec NLRI. This function is
      applied in a single administrative domain.</t>

      <t/>
    </section>

    <section title="Definitions and Acronyms">
      <t><list style="symbols">
          <t>FS: Flow Specification</t>

          <t>Source-IP-Community: The community of the source IP address</t>
        </list></t>
    </section>

    <section title="The Flow Specification Encoding for Source-IP-Community Filter">
      <t>This document proposes a new flow specification component type that
      is encoded in the BGP Flowspec NLRI. The following new component type is
      defined.</t>

      <t><list style="symbols">
          <t>Source-IP-Community</t>
        </list></t>

      <t>Type TBD1 - Source-IP-Community</t>

      <t>Encoding: &lt;type (1 octet), [op, value]+&gt;</t>

      <t>Contains a set of {operator, value} pairs that are used to match the
      Source-IP-Community (i.e. the community of the source IP address).</t>

      <t>The operator byte is encoded as:</t>

      <t><figure anchor="numeric_op" title="Numeric Operator (numeric_op)">
          <artwork align="center"><![CDATA[
    0   1   2   3   4   5   6   7
  +---+---+---+---+---+---+---+---+ 
  | e | a |  len  | 0 |lt |gt |eq | 
  +---+---+---+---+---+---+---+---+
]]></artwork>
        </figure></t>

      <t>Where:</t>

      <t>e - end-of-list bit. Set in the last {op, value} pair in the
      list.</t>

      <t>a - AND bit. If unset, the previous term is logically ORed with the
      current one. If set, the operation is a logical AND. It MUST be unset in
      the Source-IP-Community filter.</t>

      <t>len - The length of the value field for this operator given as (1
      &lt;&lt; len). This encodes 1 (len=00), 2 (len=01), 4 (len=10), and 8
      (len=11) octets.</t>

      <t>lt - less than comparison between data and value.</t>

      <t>gt - greater than comparison between data and value.</t>

      <t>eq - equality between data and value.</t>

      <t>The bits lt, gt, and eq can be combined to produce match the
      Source-IP-Community filter or a range of Source-IP-Community filter(e.g.
      less than community 1 and greater than community 2).</t>

      <t>The value field is encoded as:</t>

      <t><figure anchor="Source-IP-Origin-Community"
          title="Source-IP-Community">
          <artwork align="center"><![CDATA[
   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
  +---------------------------------------------------------------+
  ~          Source-IP-Community  (4 octets)                      ~
  +---------------------------------------------------------------+

]]></artwork>
        </figure></t>

      <t>Per section 10 of <xref target="RFC8955"/> , If a receiving BGP
      speaker cannot support this new Flow Specification component type, it
      MUST discard the NLRI value field that contains such unknown components.
      Since the NLRI field encoding (Section 4 of <xref target="RFC8955"/>) is
      defined in the form of a 2-tuple &lt;length, NLRI value&gt;, message
      decoding can skip over the unknown NLRI value and continue with
      subsequent remaining NLRI.</t>

      <t/>
    </section>

    <section title="Use Cases">
      <t>This section describes how to use this function in a simple scenario.
      Considering the topology shown in Figure 3 ("Comm" is short for
      "Community"). In AS64597's R2, if the ISP AS64597 wants to redirect all
      packets originating from AS64598 to IP Prefix 61:</t>

      <t>"first go to R3, then forward them to IP Prefix 61", the ISP AS64597
      can use the traditional method or the method defining in this draft.</t>

      <t><figure anchor="Redirect_the_traffic_using_Flowspec"
          title="Redirect the traffic using Flowspec">
          <artwork align="center"><![CDATA[
                         +---------+
                         | BGP FS  |
                         | Server  |
                         +----|----+
                              |
                              |
                              +
                               \
                ****************\********  IP Prefix 81 with Comm 1:1
                *                \      *  IP Prefix 82 with Comm 1:1
  IP Prefix 61  *        AS64597  \     *  IP Prefix 83 with Comm 1:1
                *                  \    *  IP Prefix 84 with Comm 1:1
   +-------+    *  +---+         +--\+  *   +-------+
   +AS64596+-------+ R1+---------+ R2|------+AS64598+
   +-------+    *  +-+-+\        +---+  */  +-------+
                *        \         |\   /
                *         \        | \ /*  IP Prefix 91 with Comm 1:2
                *          \       |  /\*  IP Prefix 92 with Comm 1:2
                *           \      | /  \  IP Prefix 93 with Comm 1:2
                *            \     |/   *\ IP Prefix 94 with Comm 1:2
                *             \  +-+-+  * \ +-------+
                *              \-+ R3+------+AS64599+
                *                +---+  *   +-------+
                *                       *
                *************************

]]></artwork>
        </figure></t>

      <t>Using the traditional method, the ISP AS64597 needs to setup multiple
      "Destination Prefix + Source Prefix" rules in Router R2 as
      following:</t>

      <t><figure anchor="Using_the_traditional_method"
          title="Using the traditional method to redirect the traffic">
          <artwork align="center"><![CDATA[
    +--------------+--------------+-------------------------+
    | source       | Destination  | Redirect to IP Nexthop  |
    | Prefix       | Prefix       |                         |
    +--------------+--------------+-------------------------+
    | IP Prefix 81 | IP Prefix 61 |           R3            |
    +--------------+--------------+-------------------------+
    | IP Prefix 82 | IP Prefix 61 |           R3            |
    +--------------+--------------+-------------------------+
    | IP Prefix 83 | IP Prefix 61 |           R3            |
    +--------------+--------------+-------------------------+
    | IP Prefix 84 | IP Prefix 61 |           R3            |
    +--------------+--------------+-------------------------+
    |                  More ...                             |
    +--------------+--------------+-------------------------+

]]></artwork>
        </figure></t>

      <t>Using the method defining in this draft, the ISP AS64597 needs to
      setup only one "Source Community + Destination Prefix" rule in Router R2
      as following:</t>

      <t><figure anchor="Using_the_Community-level_filtering_method"
          title="Using the community-level filtering method to redirect the traffic">
          <artwork align="center"><![CDATA[
  +--------------+--------------+-------------------------+
  | Source       | Destination  | Redirect to IP Nexthop  |
  | Community    | Prefix       |                         |
  +--------------+--------------+-------------------------+
  |     1::1     | IP Prefix 61 |           R3            |
  +--------------+--------------+-------------------------+

]]></artwork>
        </figure></t>

      <t>Obviously, the new method defining in this draft saves a lot of entry
      spaces on the control plane and forwarding plane, and it would greatly
      simplify the operation of the control plane, and the more source
      prefixes with the same community has, the more obvious the benefit.</t>

      <t/>
    </section>

    <section title="IANA Considerations">
      <t>IANA is requested to a new entry in "Flow Spec component types
      registry" with the following values:</t>

      <t><figure align="center">
          <artwork><![CDATA[   +---------+--------------+---------------------------------+
   |   Type  | RFC or Draft |    Description                  |
   +---------+--------------+---------------------------------+
   |   TBD1  |  This Draft  |    Source-IP-Community          |
   +---------+--------------+---------------------------------+
  
]]></artwork>
        </figure></t>
    </section>

    <section anchor="Security Considerations" title="Security Considerations">
      <t>No new security issues are introduced to the BGP protocol by this
      specification.</t>

      <t/>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include='reference.RFC.2119'?>

      <?rfc include='reference.RFC.8174'?>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.4271'?>

      <?rfc include='reference.RFC.8955'?>

      <?rfc include='reference.RFC.8956'?>

      <?rfc include='reference.I-D.ietf-idr-flowspec-l2vpn'?>
    </references>
  </back>
</rfc>
