BGP Flow Specification Version 2

Version 2 of BGP flow specification was original defined in (BGP FSv2). FSv2 is an update to BGP Flow specification version 1 (BGP FSv1). BGP FSv1 as defined in , , and specified 2 SAFIs (133, 134) to be used with IPv4 AFI (AFI = 1) and IPv6 AFI (AFI=2). The initial BGP FSv2 specification had the correct direction, but it contained more than the early implementers desired. The implmenters desired a progression of documents with smaller incremental changes: Basic FSv2 and support for user-ordered actions. This draft provides the basic FSv2 framework specification for transmitting user-ordered IP filters in the FSV2 NLRI and associating Flow Spec actions by transmitting Flow Spec Extended Communities (FS-EC) with the FSv2 NLRI. If a filter match links to a single FS-EC action, the single action succeeds or fails. If a filter match links to mutiple actions, there is a potential for interactions. discusses how to analyze the interaction by categories and solutions to issues with multiple FSv2-EC actions interacting. A complete solution requires the BGP Community Container Attribute see ) with FSv2 Container defined in the . This document defines one new AFI (FSv2, TBD1) and 2 new SAFIs for non-VPN (TBD2) and VPN (TBD3). FSv1 and FSv2 use different AFI/SAFIs to send their respective flow specification filters. This permits FSv1 and FSv2 to be coexist with each other in a "ships in the night" deployment. The remainder of provides background on why the FSv2 was necessary to fix problems with FSv1. contains a primer on FSv2. contains the BGP encoding rules for FSv2. describes how to validate and order FSv2 NLRI. The remaining sections discuss scalability, optional security additions, security considerations, and IANA considerations.

Modern IP routers have the capability to forward traffic and to classify, shape, rate limit, filter, or redirect packets based on administratively defined policies. These traffic policy mechanisms allow the operator to define match rules that operate on multiple fields within header of an IP data packet. The traffic policy allows actions to be taken upon a match to be associated with each match rule. These rules can be more widely defined as "event-condition-action" (ECA) rules where the event is always the reception of a packet. BGP () flow specification version 1 (FSv1) as defined by , , and specifies the distribution of traffic filter policy (traffic filters and actions) via BGP to BGP peers, both IBGP and EBGP. The traffic filter is applied when packets are received on a router with the flow specification function enabled. Multiple deployed applications currently use BGP FSv1 to distribute traffic filters. These applications include:

Mitigation of Denial of Service traffic (DoS).
Traffic filtering in BGP/MPLS VPNS.
Centralized traffic control for networks utilizing SDN control of router firewall functions.
Classifiers for insertion into a SFC.
Filters for SRv6 (segment routing v6).

During the deployment of FSv1, the following issues were noted:

FSv1 NLRI components did not use TLV encoding, which inhibited defining new component types. (The format was type-value, missing a length field.)
FSv1 rules did not have the ability to be ordered by the operator. Instead, only the protocol-defined rule ordering was permitted.
When conflicting outcomes for rule actions was present, the operator was unable to influence their ordering.
When multiple and conflicting rule actions were present, the operator couldn't define their order when some actions could not be implemented on the receiving router.

Networks currently address these issues by constraining deployments or using topology/deployment specific workarounds. FSv1 is a critical component of deployed applications. Therefore, this specification defines how FSv2 will interact with BGP peers that support combinations FSv1 and FSv2. It is expected that a transition to FSv2 will occur over time as new applications require features enabled by FSv2.

AFI:: Address Family Identifier
AS:: Autonomous System
BGP session ephemeral state:: State which does not survive the loss of BGP peer session.
BGP Commmunity Path Attribute:: BGP Community Path attribute with a FS TLV defined by
Configuration state:: State which persist across a reboot of software module within a routing system or a reboot of a hardware routing device.
CPA:: BGP Community Path Attribute.
DDoS:: Distributed Denial of Service.
Ephemeral state:: State which does not survive the reboot of a software module, or a hardware reboot. Ephemeral state can be ephemeral configuration state or operational state.
Extended Community:: BGP Path Attribute defined by .
FS:: Flow Specification (either v1 or v2).
FSv1:: Flow Specification version 1 .
FSv2:: Flow Specification version 2 (this document and its extensions).
FS-CPA:: Flow Specification Actions defined in Community Path Attribute.
FS-EC:: FS related Extended Community with FS actions.
FSv1-EC:: FSv1 Extended Community with FS Actions supported by FSv1.
FSv2-EC:: FSv2 Extended Community with FS Actions supported by FSv2.
NETCONF:: The Network Configuration Protocol .
NLRI:: Network Layer Reachability Information . The "destination" portion of a Flowspec route carried in a BGP UPDATE message.
RESTCONF:: The RESTCONF Protocol .
RIB:: Routing Information Base.
ROA:: Route Origin Authentication .
RR:: Route Reflector .
SAFI:: Subsequent Address Family Identifier .
SFC:: Service Function Chaining .

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 when, and only when, they appear in all capitals as shown here.

A BGP Flow Specification (v1 or v2) is an n-tuple containing one or more match criteria that can be applied to data-plane traffic. The exact traffic match depends on the FSv2 AFI/SAFI. Flows Specification routes carried in BGP UPDATEs may carry BGP Path Attributes that have additional match or action consequences. This includes, but is not limited to: Extended Communities and Community Container Path attributes . Flow Specification NLRI for a given AFI/SAFI is used as they key for Flow Specification routes in the BGP RIBs. Flow Specification routes that are selected for the Loc-RIB are then associated with a given set of semantics which are application dependent. Standard BGP policy mechanisms for BGP routes are applicable to Flow Specification routes, including AS_PATH and community filtering. This FSv2 for basic IP forwarding specification only requires the use of Extended Communities to associate FS actions with FSv2 filters found in FSv2 NLRI. FSv2 features implementing multiple actions with user ordering of actions or dependencies between actions requires the BGP Community Attribute with a FSv2 Component as defined in . Network operators can control the propagation of Flow Specification BGP routes by enabling or disabling the exchange of routes for a FSv2 (AFI/SAFI TBD1/TBD2) or FSv2 VPN (AFI/SAFI TBD1/TBD3)). BGP policy mechanisms, including scoping communities, can also be used. Thus, Flow Specification routes may be distributed to only a portion of a BGP deployment.

The FSv1 NLRI defined in and includes 13 match conditions encoded for the following AFI/SAFIs: IPv4 traffic: AFI:1, SAFI:133 IPv6 Traffic: AFI:2, SAFI:133 BGP/MPLS IPv4 VPN: AFI:1, SAFI: 134 BGP/MPLS IPv6 VPN: AFI:2, SAFI: 134 FSv1 match conditions are ordered by component type in ascending order. The ordering within a component type is defined by that component's definition. The Flow Specification actions standardized by and are:

accept packet (default),
traffic rate limiting by bps (0x6),
traffic-action: sample, or terminate rule (0x7),
redirect traffic to VPN by route target(0x8),
traffic marking (DSCP) (0x9), and
traffic rate limiting by pps (0xC)

A SFC action defines a redirection of a data flow to an entry point into a specific SFP (Service Function Path). Other Extended Community actions have been proposed in IDR, but have not completed the standardization process.

Filter families allow us to use a single FSv2 AFI (TBD1) and two SAFIS (normal (TBD2) and VPN (TBD3). One question asked by developers is what AFI/SAFI is required for FSv2 IP Basic compliance. BGP negotiates support for each AFI/SAFI, so FSv2 can support FSv2 normal (AFI/SAFI (TBD1/TBD2)) or FSv2 VPN (TBD1/TBD3)) or both (normal and VPN).

FSv2 allows the user to order the flow specification rules and the actions associated with a rule. Each FSv2 rule may have one or more match conditions and one or more associated actions. FSv2 operates in a ships-in-the night model with FSv1. This permits operators to manage the interaction of FSv2 and FSv1 via configuration. The basic principles regarding the ordering and installation of flow specification filter rules are:

In the absence of a matching filter for the traffic, that traffic is permitted. That is, the default is permit. Implementations MAY implement a default reject behavior by configuration.
FSv2 filter rules are processed prior to FSv1 rules. FSv1 NLRI are processed according to the procedures defined in and . FSv2 filter rules thus have a better precedence vs. FSv1.
FSv2 filter rules are ordered based on user-specified order, carried in each FSv2 NLRI. Numerically smaller user-specified order values have better precedence than larger values.
For rules with the same user-specified order, the filter rules are then ordered by FSv2 component type and then rules for each component type.
FSv2 filter rules can carry actions. These actions can be encoded via one or more FSv2 Extended Communities, or within the FSv2 Action Community Container. Some FSv2 Extended Communities may not be understood by every FSv2 implementation. Since they are encoded as Extended Communities, they are propagated with the BGP routes regardless of whether they are understood based on the particular Extended Community's transitivity. When FSv2 Extended Communities are understood, they have precedence and interaction rules governing the actions they encode. (See section 4.9 (editor: XXX SKH TODO: add logical reference)). The FSv2 Action Community Container defines its own rules governing FSv2 actions. See draft-hares-idr-ip-more-actions for additional details (editor: XXX SKH TODO revise draft-hares-idr-ip-more-actions).
FSv2 filter match and action criteria may be considered "optional". For match, the FSv2 NLRI encoding carries a per-component flag set by the operator or implementation that marks that match component as optional or mandatory. For actions, FSv2 Extended Communities will document whether they are considered optional or mandatory as part of their definition. The optionality of FSv2 Action Community Containers is defined in its defining document. If a mandatory match component or action component cannot be locally implemented, the flowspec rule is marked as ineligible to be installed.
FSv2 filter rules carry a "Dependency" value in the FSv2 NLRI. When this value is non-zero, this value associates multiple received FSv2 filters with each other. If a FSv2 filter rule is ineligible to be installed due to an inability to implement a mandatory match or action component, all other filters carrying the same dendency value will be made ineligible for installation. See for more details.

BGP Flow Specifications are encoded in BGP NLRI as an ordered list of TLVs of "filter families", where each filter family consists of an ordered list of TLVs of "filter components" for that familiy. Filter families are groupings of related filtering functionality, typically at the same network layer. Filter components match specific network elements for a filter family. Each FSv2 NLRI has a default sort order determined by filter family, followed by components within a filter family. Operators MAY override this default ordering by causing the FSv2 User Order field to be set to a non-zero value. Sets of FSv2 NLRI might share fate with each other. In the event that a Flow Specification is unable to be installed by the BGP speaker, dependent Flow Specifications MUST NOT also be installed, even if they are otherwise valid. These dependencies are encoded in the Dependent Filters Chain field of a FSv2 Flow Specification. FSv2 is carried in BGP using standard multiprotocol extensions. FSv2 supports a single FSv2 AFI (TBD1) with two SAFIs:

TBD1 (Flow Spec Version 2) (TBD2)
TBD2 (Flow Spec Version 2 for VPNs) (TBD3)

FSv2 NLRI are encoded in BGP UPDATEs using the MP_REACH_NLRI and MP_UNREACH_NLRI attributes defined in . When advertising FSv2 NLRI, the length of the Next-Hop Network Address MUST be set to 0. Upon reception, the MP_REACH_NLRI "Network Address of NextHop" field MUST be ignored.

FSv2 Flow Specifications are encoded as an ordered list of TLVs of filter families. FSv2 filter families are typically associated with match criteria for a given networking layer; for example, 802.2 Layer 2, MPLS, IPv4/IPv6, Segment Routing, etc. The AFI/SAFI NLRI for BGP Flow Specification version 2 (FSv2) has the format:

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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | NLRI length | | (2 octets) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Dependent filter chain (4 octets) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | User order (4 bytes) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Where:

NLRI Length: Length of the NLRI field in octets excluding the NLRI Length field. The minimum NLRI Length is 8 (Dependent Filter Chain + User Order).
Dependent Filters Chain (DFC): A 32-bit unsigned integer in network byte order. When non-zero, the Dependent Filters Chain value is used to associate multiple NLRI together that share dependencies. See for further information on its use.
User Order: A 32-bit unsigned integer in network byte order. FSv2 rules with a lower User Order value have a better precedence for filter ordering.
FSv2 Filter Family TLVs: An ordered list of TLVs of FSv2 filter families. The encoding of these filter families is documented in the next section.

Each each FSv2 Filter Family TLV has the format:

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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | FSv2 Filter Family type | Fsv2 filter Family length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-++-+-+-+--+-+ | FSv2 Filter Component TLVs (variable) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Where:

FSv2 Filter Family Type: A 16-bit unsigned integer in network byte order defining the FSv2 filter that is carried in this TLV. For sorting purposes, lower value FSv2 Filter Types have a better precendence than higher values.
- This document defines the following filter family types. The definition of other filter family types may be added in other documents.
- 0 - Reserved
- 200 - Time
- 300 - Interface
- 400 - L2 traffic
- 500 - MPLS traffic
- 600 - SFC Traffic
- 700 - Queue Pair (QP)
- 800 - Tunneled trafffic
- 1000 - IPv4 Basic
- 1100 - IPv6 Basic
- 1200 - CATS Traffic
- 1400 - Routing
FSv2 Filter Family Length: Length of the FSv2 Filter Components TLVs in octets.

Each each FSv2 Filter Component TLV has the Format:

The FSv2 Filter Component Flags are defined as:
0 1 2 3 +---+---+---+---+ | O | R | R | R | +---+---+---+---+
The fields of the FSv2 Filter Component Flags are defined as:
- O - Optional: When 0, the FSv2 filter-type-specific filter component is mandatory and MUST be supported by the local implementation. Otherwise, when 1, the component is considered "optional". When the component is mandatory and is not supported, the FSv2 filter rule is considered "invalid" for validation purposes.
- R - Reserved: When not otherwise re-defined in a later document, this bit MUST be set to zero when sent and SHOULD be ignored on reception.
FSv2 Filter Component Type: A 12-bit unsigned integer in network byte order defining the match component for a given FSv2 filter type. For sorting purposes, lower value FSv2 Filter Component Types have a better precedence than higher values. This document defines some FSv2 Filter Component Types for IP Basic Filter in section 4. Other documents may define additional Component types.
FSv2 Filter Component Length: A 16-bit unsigned integer in network byte order containing the length of the FSv2 Filter Components Value field.
FSv2 Filter Component Value: Each FSv2 filter type will define one or more FSv2 filter-type-specific filter components. See each FSv2 filter-type's specification for a component's definition.

FSv2 implementations MUST pass valid filter TLVs even if the implementation does not support these installation of these a particular type of filter rules. This specification only defines operation of the IP Basic Filter Rules that all FSv2 must support.

Flow Specifications are implemented using ordered terms. The sorting rules for flow specification routes is intended to, by default, produce a reasonably ordered set of rules for common deployment scenarios. When the FSv2 rule ordering wouldn't accomplish the operator's intent when deploying FSv2, the User Order field can permit the operator to influence the Flow Specification installation order in a deployment. When set of Flow Specifications are required to implement an operator's intent and that set of rules has interdependencies, the failure to install a Flow Specification, or part of that specification's actions, may result in incorrect deployment. An example of such a dependency is two rules covering an IP destination, one with a more-specific and one with a less-specific prefix relaionship. As an example:

match dst=10.1.1.1/8 tcp port=25 then dscp=AF1 and permit
match dst=10.0.0.0/8 tcp port=25 then drop

If an implementation couldn't support the DSCP action and failed to install the first rule, SMTP traffic to the host 10.1.1.1 would fail to be delivered due to the second rule's drop action. In other words, these two entries have a dependency. When an implementation is unable to install a Flow Specification for some reason, that Flow Specification is locally "invalid". In many circumstances, Flow Specifications that do not have dependencies may be installed on a best-effort basis by an implementation. However, in the case of dependent rules, installing some rules selectively but not others can be problematic. FSv2 defines for each FSv2 NLRI a Dependent Filters Chain (DFC). When the value of DFC is zero (0), no special consideration is given for dependencies. When the value of DFC is non-zero, when a rule is locally considered invalid, all rules sharing the same DFC value are also considered invalid, and not installed.

For NLRI canonicalization purposes, and also to ease processing, all TLVs within the FSv2 NLRI MUST be ordered in a strictly increasing fashion. FSv2 filter types and FSv2 filter-type-specific component types for a given component MUST NOT occur more than once. See for further details.

Partial deployments can occur for two reasons: Only a portion of the nodes in a network with FSv2 support installing new FSv2 Filter types with new FSv2 components. Other nodes (such as RRs), check the syntax, but do not handle the semantic meaning. During upgrades, a portion of the nodes know about a new Filter type with the components, but other nodes do not. Editor: Are there others?

FSv2 IP Basic filters provide the same functionality as those specified in FSv1 RFCs and . The format of those components has been preserved for ease of implementation. The FSv2 IP Basic filter has been assigned a FSv2 Filter Type value of TBD. FSv2 IP Basic Filter component types are numbered differently from those in FSv1. FSv2 components have been numbered with gaps to permit future FSv2 IP Basic filter components to be added in between currently specified IP Basic components. This permits a natural default sort order for those new components in implementations.

Most of the components described below make use of comparison operators. These operators were originally defined in . They are repeated here for document clarity. The operators are encoded as a single octet.

This operator is encoded as shown in Figure 3-3.

0 1 2 3 4 5 6 7 +---+---+---+---+---+---+---+---+ | e | a | len | 0 |lt |gt |eq | +---+---+---+---+---+---+---+---+

e (end-of-list bit):: Set in the last {op, value} pair in the list
a (AND bit):: If unset, the result of the previous {op, value} pair is logically ORed with the current one. If set, the operation is a logical AND. In the first operator octet of a sequence, it MUST be encoded as unset and MUST be treated as always unset on decoding. The AND operator has higher priority than OR for the purposes of evaluating logical expressions.
len (length):: The length of the value field for this operator given as (1 << len). This encodes 1 (len=00), 2 (len=01), 4 (len=10), and 8 (len=11) octets.
0: MUST be set to 0 on NLRI encoding and MUST be ignored during decoding
lt: less-than comparison between data and value
gt:: greater-than comparison between data and value
eq:: equality between data and value

The bits lt, gt, and eq can be combined to produce common relational operators, such as "less or equal", "greater or equal", and "not equal to", as shown in Table 3-1.

+====+====+====+==================================+ | lt | gt | eq | Resulting operation | +====+====+====+==================================+ | 0 | 0 | 0 | false (independent of the value) | +----+----+----+----------------------------------+ | 0 | 0 | 1 | == (equal) | +----+----+----+----------------------------------+ | 0 | 1 | 0 | > (greater than) | +----+----+----+----------------------------------+ | 0 | 1 | 1 | <= (greater than or equal) | +----+----+----+----------------------------------+ | 1 | 0 | 0 | < (less than) | +----+----+----+----------------------------------+ | 1 | 0 | 1 | <= (less than or equal) | +----+----+----+----------------------------------+ | 1 | 1 | 0 | != (not equal value) | +----+----+----+----------------------------------+ | 1 | 1 | 1 | true (independent of the value) | +----+----+----+----------------------------------+

This operator is encoded as shown in Figure 3-4.

0 1 2 3 4 5 6 7 +---+---+---+---+---+---+---+---+ | e | a | len | 0 | 0 |not| m | +---+---+---+---+---+---+---+---+ Where:

e, a, len (end-of-list bit, AND bit, and length field):: Most significant nibble; defined in the Numeric Operator format in section 3-x.
not (NOT bit):: If set, logical negation of operation.
m (Match bit):: If set, this is a bitwise match operation defined as "(data AND value) == value"; if unset, (data AND value) evaluates to TRUE if any of the bits in the value mask are set in the data.
0 (all 0 bits):: MUST be set to 0 on NLRI encoding and MUST be ignored during decoding

FSv2 QP Family Filter Components are encoded in FSv2 Filter Component TLVs as described in fsv2-filter-qp. QP Match Components

Type	Definition	Reference
0	Reserved	This document
100	Destination-QP	fsv2-filter-qp
4095	Reserved	[This document]

FSv2 IP Basic Filter Components are encoded in FSv2 Filter Component TLVs as described in . The list of valid Basic IP types, covering the functionality defined in and are documented below. Additional IP Filters types are temporarily assigned in this section (until initial IANA registry is created) but the definitions are defined in other documents (per the IANA section). FSv2 IP Basic Components

Type	Definition	Reference
0	Reserved	This document
800	Bitwise Destination IPv4 filter	draft-kao-idr-bitwise-ip-filters
1000	IPv4 Destination Prefix	This document
1100	Bitwise Source Filter IPv4 source	draft-kao-idr-bitwise-ip-filters
1200	IPv4 Source Prefix	This document
1300	IPv4 Protocol	This document
1400	Port	This document
1500	Destination Port	This document
1600	Source Port	This document
1700	ICMPv4 Type	This document
1800	ICMPv4 Code	This document
1900	TCP Flags	This document
2000	Packet Length	This document
2100	DSCP	This document
2200	Fragment	This document
3000	Packet Content filter	draft-cui-idr-content-filter-flowspec
4095	Reserved	[This document]

Type	Definition	Reference
0	Reserved	This document
300	Some parts of SRHv6 header
500	NRP ID SRv6 Next Hop header
810	Bitwise Destination IPv6 filter	draft-kao-idr-bitwise-ip-filters
1010	IP Destination Prefix	This document
1110	Bitwise Source Filter IPv6 source	draft-kao-idr-bitwise-ip-filters
1210	IP Source Prefix	This document
1310	IPv6 Upper Layer Protocol	This document
1400	Port	This document
1500	Destination Port	This document
1600	Source Port	This document
1710	ICMPv6 Type	This document
1810	ICMPv6 Code	This document
1910	TCP Flags	This document
2000	Packet Length	This document
2100	DSCP	This document
2200	Fragment	This document
2300	Flow Label	This document
3000	Packet Content filter	draft-cui-idr-content-filter-flowspec
4095	Reserved	[This document]

For Flow Specification ordering purposes, IP Basic Filter components are ordered similar the FSv1 comparison rules documented in . The relative order of two Flow Specificationss with IP Basic filter family components is determined by comparing their respective family-specific components. The algorithm starts by comparing the lowest component type value of the Flow Specifications. If the types differ, the Flow Specification with lowest numeric type value has higher precedence (and thus will match before) than the Flow Specification that doesn't contain that component type. If the component types are the same, then a type-specific comparison is performed (see below). If the types are equal, the algorithm continues with the next component. For IP prefix values (IP destination or source prefix), if one of the two prefixes to compare is a more specific prefix of the other, the more specific prefix has higher precedence. Otherwise, the one with the lowest IP value has higher precedence. For all other component types, unless otherwise specified, the comparison is performed by comparing the component data as a binary string using the memcmp() function as defined by [ISO_IEC_9899]. For strings with equal lengths, the lowest string (memcmp) has higher precedence. For strings of different lengths, the common prefix is compared. If the common prefix is not equal, the string with the lowest prefix has higher precedence. If the common prefix is equal, the longest string is considered to have higher precedence than the shorter one.

Encoding: <prefix length (1 octet), prefix (variable)> Defines the IPv4 destination prefix to match.

prefix length:: Length of the prefix in bits.
prefix:: IPv4 Prefix encoded using NLRI format.

Encoding: <length (1 octet), offset (1 octet), pattern (variable), padding (variable)> This defines the IPv6 destination prefix to match. The offset has been defined to allow for flexible matching to portions of an IPv6 address where one is required to skip over the first N bits of the address. (These bits skipped are often indicated as "don't care" bits.) This can be especially useful where part of the IPv6 address consists of an embedded IPv4 address, and matching needs to happen only on the embedded IPv4 address. The encoded pattern contains enough octets for the bits used in matching (length minus offset bits).

length:: This indicates the N-th most significant bit in the address where bitwise pattern matching stops.
offset:: This indicates the number of most significant address bits to skip before bitwise pattern matching starts.
pattern:: This contains the matching pattern. The length of the pattern is defined by the number of bits needed for pattern matching (length minus offset).
padding:: This contains the minimum number of bits required to pad the component to an octet boundary. Padding bits MUST be 0 on encoding and MUST be ignored on decoding.

If length = 0 and offset = 0, this component matches every address; otherwise, length MUST be in the range offset < length < 129 or the component is malformed. Note: This Flow Specification component can be represented by the notation ipv6address/length if offset is 0 or ipv6address/offset-length. The ipv6address in this notation is the textual IPv6 representation of the pattern shifted to the right by the number of offset bits.

Encoding: <prefix length (1 octet), prefix (variable)> Defines the IPv4 source prefix to match.

prefix length:: Length of the prefix in bits.
prefix:: IPv4 Prefix encoded using NLRI format.

Encoding: <length (1 octet), offset (1 octet), pattern (variable), padding (variable)> This defines the source prefix to match. The length, offset, pattern, and padding are the same as in .

Encoding: <[numeric_op, value]+> Contains a list of {numeric_op, value} pairs that are used to match the IP protocol value octet in IPv4 packet header . This component uses the Numeric Operator (numeric_op) described in . Type 90 component values SHOULD be encoded as single octet (numeric_op len=00).

This contains a list of {numeric_op, value} pairs that are used to match the first Next Header value octet in IPv6 packets that is not an extension header and thus indicates that the next item in the packet is the corresponding upper-layer header (see Section 4). This component uses the Numeric Operator (numeric_op) described in . Type 90 component values SHOULD be encoded as a single octet (numeric_op len=00). Note: While IPv6 allows for more than one Next Header field in the packet, the main goal of the Type 80 Flow Specification component is to match on the first upper-layer IP protocol value. Therefore, the definition is limited to match only on this specific Next Header field in the packet.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs that match source OR destination TCP/UDP ports (see and the "Format" section of ). This component matches if either the destination port OR the source port of an IP packet matches the value. This component uses the Numeric Operator (numeric_op) described in . Type 100 component values SHOULD be encoded as 1- or 2-octet quantities (numeric_op len=00 or len=01). In case of the presence of the port (destination-port (), source-port () component, only TCP or UDP packets can match the entire Flow Specification. The port component, if present, never matches when the packet's IP protocol value is not 6 (TCP) or 17 (UDP), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header in the presence of IP options or Encapsulating Security Payload (ESP) NULL encryption. Note: This component only matches the first upper layer protocol value in IPv6.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match the destination port of a TCP or UDP packet (see also and the "Format" section of . This component uses the Numeric Operator (numeric_op) described in . Type 110 component values SHOULD be encoded as 1- or 2-octet quantities (numeric_op len=00 or len=01). The last paragraph of also applies to this component.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match the source port of a TCP or UDP packet (see also and the "Format" section of . This component uses the Numeric Operator (numeric_op) described in . Type 120 component values SHOULD be encoded as 1- or 2-octet quantities (numeric_op len=00 or len=01). The last paragraph of also applies to this component.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match the type field of an ICMP packet (see also the "Message Formats" section of ). This component uses the Numeric Operator (numeric_op) described in . Type 130 component values SHOULD be encoded as single octet (numeric_op len=00). In case of the presence of the ICMPv4 type component, only ICMPv4 packets can match the entire Flow Specification. The ICMP type component, if present, never matches when the packet's IP protocol value is not 1 (ICMP), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header in the presence of IP options or Encapsulating Security Payload (ESP) NULL encryption.

In case of the presence of the ICMPv6 type component, only ICMPv6 packets can match the entire Flow Specification. The ICMPv6 type component, if present, never matches when the packet's upper-layer IP protocol value is not 58 (ICMPv6), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match the code field of an ICMP packet (see also the "Message Formats" section of ). This component uses the Numeric Operator (numeric_op) described in . Type 140 component values SHOULD be encoded as single octet (numeric_op len=00). In case of the presence of the ICMP code component, only ICMP packets can match the entire Flow Specification. The ICMP code component, if present, never matches when the packet's IP protocol value is not 1 (ICMP), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header in the presence of IP options or Encapsulating Security Payload (ESP) NULL encryption.

This defines a list of {numeric_op, value} pairs used to match the code field of an ICMPv6 packet (see also ). This component uses the Numeric Operator (numeric_op) described in . Type 140 component values SHOULD be encoded as a single octet (numeric_op len=00). In case of the presence of the ICMPv6 code component, only ICMPv6 packets can match the entire Flow Specification. The ICMPv6 code component, if present, never matches when the packet's upper-layer IP protocol value is not 58 (ICMPv6), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header.

Encoding: <[bitmask_op, bitmask]+> Defines a list of {bitmask_op, bitmask} pairs used to match TCP control bits (see also ). This component uses the Bitmask Operator (bitmask_op) described in . Type 150 component bitmasks MUST be encoded as 1- or 2-octet bitmask (bitmask_op len=00 or len=01). When a single octet (bitmask_op len=00) is specified, it matches octet 14 of the TCP header (see also ), which contains the TCP control bits. When a 2-octet (bitmask_op len=01) encoding is used, it matches octets 13 and 14 of the TCP header with the data offset (leftmost 4 bits) always treated as 0. In case of the presence of the TCP flags component, only TCP packets can match the entire Flow Specification. The TCP flags component, if present, never matches when the packet's IP protocol value is not 6 (TCP), if the packet is fragmented and this is not the first fragment, or if the system is unable to locate the transport header. Different implementations may or may not be able to decode the transport header in the presence of IP options or Encapsulating Security Payload (ESP) NULL encryption.

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match on the total IP packet length (excluding Layer 2 but including IP header). This component uses the Numeric Operator (numeric_op) described in . Type 160 component values SHOULD be encoded as 1- or 2-octet quantities (numeric_op len=00 or len=01).

Encoding: <[numeric_op, value]+> Defines a list of {numeric_op, value} pairs used to match the 6-bit DSCP field (see also ). This component uses the Numeric Operator (numeric_op) described in . Type 170 component values MUST be encoded as single octet (numeric_op len=00). The six least significant bits contain the DSCP value. All other bits SHOULD be treated as 0.

Encoding: <[bitmask_op, bitmask]+> Defines a list of {bitmask_op, bitmask} pairs used to match specific IP fragments. This component uses the Bitmask Operator (bitmask_op) described in . Type 180 component bitmask MUST be encoded as single octet bitmask (bitmask_op len=00).

0 1 2 3 4 5 6 7 +---+---+---+---+---+---+---+---+ | 0 | 0 | 0 | 0 |LF |FF |IsF|DF | +---+---+---+---+---+---+---+---+ Bitmask values:

DF (Don't Fragment):: match if IP Header Flags Bit-1 (DF) is 1
IsF (Is a fragment other than the first):: match if the IP Header Fragment Offset is not 0
FF (First Fragment):: match if the IP Header Fragment Offset is 0 AND Flags Bit-2 (MF) is 1
LF (Last Fragment):: match if the IP Header Fragment Offset is not 0 AND Flags Bit-2 (MF) is 0
0:: MUST be set to 0 on NLRI encoding and MUST be ignored during decoding

0 1 2 3 4 5 6 7 +---+---+---+---+---+---+---+---+ | 0 | 0 | 0 | 0 |LF |FF |IsF| 0 | +---+---+---+---+---+---+---+---+ Bitmask values:

IsF:: Is a fragment other than the first -- match if IPv6 Fragment Header ( ) Fragment Offset is not 0
FF:: First fragment -- match if IPv6 Fragment Header ( ) Fragment Offset is 0 AND M flag is 1
LF:: Last fragment -- match if IPv6 Fragment Header ( ) Fragment Offset is not 0 AND M flag is 0
0:: MUST be set to 0 on NLRI encoding and MUST be ignored during decoding

Encoding: <[numeric_op, value]+> This contains a list of {numeric_op, value} pairs that are used to match the 20-bit Flow Label IPv6 header field (). This component uses the Numeric Operator (numeric_op) described in . Type 190 component values SHOULD be encoded as 4-octet quantities (numeric_op len=10).

CAT Filter Components are encoded in FSv2 CAT Filter Component TLVs as described below. CATS Match Components

Type	Definition	Reference
0	Reserved	This document
100	Class ID	song-classid-filter
4095	Reserved	[This document]

Routing Augment Components are encoded in FSv2 Filter Component TLVs as described in below. Auxiliary Informatino Match Components

Type	Definition	Reference
0	Reserved	This document
100	DIP-AS	draft-wang-idr-flowspec-dip-origin-as-filter
200	SIP-AS	draft-wang-idr-flowspec-sip-origin-as-filter
300	DIP-Com	draft-wang-idr-flowspec-dip-community-filter
400	SIP-com	draft-wang-idr-flowspec-sip-community-filter
4095	Reserved	[This document]

Traffic matching a flow specification filter may have selected traffic actions applied to it that have various impacts on the matched traffic. FSv2 IP Basic allows flow specification actions to be attached to flow specification routes using BGP Extended Communities (FSv2-EC) encoded using the Extended Community formats or in the IPv6 Address Specific Extended Community format . describes the interaction between FS-EC action, and categories of actions. describes the existing FS-EC action formats.

FSv2-EC actions fall into the following categories:

Further constraint of the match criteria for the traffic in addition to that which is encoded in the NLRI. Examples of this include match criteria based on groups of interfaces, and where filter rules are installed.
Apply traffic shaping mechanisms, such as bps/pps rate limiters.
Change IP packet properties, such as DSCP or SR
Redirect (change the forwarding) of the traffic. Examples include redirecting to VPN VRFs, or forwarding to tunneled destinations.
Flag the traffic for sampling.
Terminate the evaluation of further flow specification matches in the forwarding plane.
Request logging of flowspec filter installation by other protocols

When multiple actions from a given FSv2-EC category are present in a FSv2 route, these actions may conflict. Conflicting actions result in ambiguity as to what traffic action behavior is applied to traffic matching the flow specification. FSv2 actions passed in a BGP Community Container Attribute can provide ordering of actions, dependencies, or signal which actions are valid within a category. However, these features are beyond the Basic FSv2 for IP forwarding and are out of scope for this specification.

FSv2 IP Basic uses FSv1 actions and these are referenced in and . FSv2 supports the FSv1 actions for the SFC network service header (NSH) specified in as referenced in . FSv2 IP Basic reassigns All FSv2 Extended Community actions to two FSv2 Extended Community types: one transitive and one non-transitive. These are defined in and .

FSv2 Transitive Actions

Function	Type/Sub-Type	Description	Sub-Registry
Grouping	0x07/0x02	Group by interface set	none
Redirect	0x07/TBD-3	Redirect to IP (R-ID)	none
Redirect	0x07/TBD-4	Redirect to Indirection ID (R-IID)	FS-ST-Reg1:Redirect IDs
Mark, Merge, Traffic shape	0x07/0x06	Traffic rate limit by bytes (TR-BPS)	none
Mark, Merge, Traffic shape	0x07/0x0C	Traffic rate limit by packets (TR-PPS)	none
Mark, Merge, Traffic shape	0x07/0x07	Traffic Action (sample, terminal) [TA]	none
Mark, Merge, Traffic shape	0x07/0x09	Mark DSCP	none

Fsv2-ST-reg1:RedirectIDs denotes a registry of FlowSpec Redirect to indirection-id Extended Community Sub-Types. This registry will be created when the the approved for early registry allocation.

FSv2 Non-Transitive Actions

Function	Type/Sub-Type	Description	Sub-Registry
Grouping	0x47/0x02	Group by interface set	none
Redirect	0x47/TBD-3	Redirect to IP	none
Redirect	0x47/TBD-4	Redirect to Indirection ID	FS-ST-Reg1:Redirect IDs
Mark, Merge, Traffic shape	0x47/0x06	Traffic rate limit by bytes (TR-BPS)	none
Mark, Merge, Traffic shape	0x47/0x0C	Traffic rate limit by packets (TR-PPS)	none
Mark, Merge, Traffic shape	0x47/0x07	Traffic Action (sample, terminal)(TA)	none
Mark, Merge, Traffic shape	0x47/0x09	Mark DSCP	none

FS-ST-Reg1:Redirect IDs denotes a registry of FlowSpec Redirect to indirection-id Extended Community Sub-Types. This registry will be created when the the approved for early registry allocation.

FSv2 supports the FSv1 actions defined for SFC NSH Classifiers list below. FSv2 Transitive Actions for SFC NSH Classifiers

Function	Type/Sub-Type	Description	Sub-Registry
Redirect to SFC NSH	0x0b/0x00	NSH Based SFC Reserved	NSH-SFC-R
Redirect to SFC NSH	0x0b/0x01	SFVC SFIR POOL Identifier	SFIR-PI
Redirect to SFC NSH	0x0b/0x02	SFC MPLS label stack Swapping or stacking labels	SFC-MPLS

FSv1 defines a set of encoded extended communities implementing actions also applicable to FSv2 IP Basic match types. They are: FSv1 Extended Communities Used by FSv2

Function	Type/Sub-Type	Description	Short-ID	registry
Group	0x07/0x02	Match Interface set	TA-IS	none
Redirect	0x01/0x0c	Redirect to IP	RD-IP	none
Redirect	0x09/0xxx	Redirect to Indirection ID	RD-IID	FS-ST-Reg1: Indirect IDs
Redirect	0x80/0x08	Redirection to VRF (2-octet AS form)	RD-VRF-AS2	none
Redirect	0x81/0x08	Redirect to VPN (IPv4 form)	RD-VRF-IPv4	none
Mark/Merge/Shape	0x80/0x06	Traffic rate limit by bytes	TR-BPS	none
Mark/Merge/Shape	0x80/0x07	Traffic Action (sample, terminal)	TA	none
Mark/Merge/Shape	0x80/0x09	Traffic mark DSCP	TM-DSCP	none
Mark/Merge/Shape	0x80/0x0C	Traffic rate limit by packets	TR-PPS	none

Note the Short ID is simply a quick way for this document to reference a particular action.

FSv1 defines a set of encoded extended communities implementing actions also applicable to FSv2 IP Basic match types. They are: FSv1 IPv6 Address Specific Extended Communities Used by FSv2

Function	Type	Description	Short-ID	registry	Reference
Redirect	0x000C	FS Redirect to IPv6	RD-IP6	none
Redirect	0x000D	FS Redirect to VPN by IPv6 route target	RD-VRF-IPv6	none

Devices implementing flow specification matching and traffic actions may be unable, for whatever reason, to carry out the signaled actions for the matched traffic. Some examples of this inability include:

The action is not implemented in the forwarding plane.
Combinations of non-conflicting actions may not be able to be simultaneously executed due to limitation in the implementation's forwarding plane.

When FS-EC actions known to the implementation are attached to a flow specification route and an action cannot be executed, there are three potential options:

Stop processing additional filters and (optionally) signal failure to the management process.
Continue on processing in "best effort" for the next filters.
Decide between 1 and 2 based on dependencies between filters and actions.

Option 1 and 2 can be signaled by configuration within a Flow Specification implementation. Option 3 requires the encoding dependency lists in ordered filters and ordered actions. The FSv2 NLRI format has a field to carry filter dependency information, but these functions are beyond the FSv2 Basic IP functions and out of scope for this specification. Consider an example where three FSv2-EC actions are present on the route: Set the DSCP value, request sampling of the traffic, redirect to a VRF. If the implementation is unable to set the DSCP value:

would be to stop processing and not do the other two actions.
would be to continue prcoessing and do the other two actions.

Currently, for FSv1, local configuration or implementation behavior determines what happens if one of the actions fails within a set of multiple actions attached to a filter rule. One option for FSv2 is to pass another FS-EC indicating what the originator expects will happen upon failure of an action.

A flow specification implementation that understands extended communities for a traffic action may not necessarily be able to implement them. Another problematic case for consistent deployment of flow specification within a network is understanding that an implementation may be ignorant of some FSv2-ECs. FSv2-ECs are carried in the general purpose BGP Extended Community features. The expected behavior for an implementation receiving unknown Extended Communities, depending on configuration and policy, will be to ignore the contents of these communities and propagate them according to the transitivity rules in . Newly defined FSv2-ECs may be unknown to the implementation, typically as a result of incremental deployment newer flow specification traffic actions. When a network with older implementations receive such newly defined FSv2-ECs, the older implementations are unable to determine that an action has been requested at all. The default behavior thus becomes "best effort" for executing the known FSv2-ECs. When specifying new FSv2-ECs, operational consideration MUST be given to what the behavior of such ignorant implementations may do to the desired traffic forwarding throughout the FS deployment.

The validation of FSv2 routes adheres to the combination of rules for general BGP FSv1 routes found in , , and . These FSv1 rules are sufficient for FSv2 for IP traffic. Specific additions have been defined for IP Filters used for guiding IP traffic into Service Function Service Function Pathways SFC NLRI in , or validation of L2VPN FS NLRI (see ). These additions are not required for the FSv2 for IP Basic functions. Validating FSv2 routes procedes through the following steps:

Syntactic and semantic validitation for FSv2 NLRI ().
Validating FSv2 route properties ().
Validating FSv2 route actions ().

The full validation process for FSv2 routes for all AFI/SAFIs is described below in rather than simply referring to the relevant portions of the previously referenced RFCs.

All FSv2 NLRI MUST be well-formed. Failure of the following NLRI validation conditions MUST use "session reset" for purposes since recovery from NLRI malformation cannot is not possible:

NLRI Length (
) MUST be at least 20 octets:
- Dependent Filters Chain (4 octets) + User Order (4 octets) +
- One non-empty FSv2 Filter Family TLV (FSv2 Filter Family Type (2 octets) + FSv2 Filter Family Length (2 octets)) +
- One possibly-empty FSv2 Filter Component (FSv2 Filter Component Flags + Type (2 octets)+ FSv2 Filter Component Length (2 octets))
All TLVs and sub-TLVs MUST be well-formed and exactly contained in their parent TLVs: The total length of all sub-TLVs must be identical to the length field of the parent TLV.

Failure of the following NLRI validation conditions MUST use "treat-as-withdraw" for the NLRI for purposes. In these cases, it is possible to parse the boundaries of individual NLRI in a BGP UPDATE message and thus the BGP speaker can continue to parse the next NLRI in the UPDATE. Implementations also MUST notify the operator of this behavior: In circumstances where routes have been announced by a previously valid NLRI but failed to be properly withdrawn due to an implicit or explicit withdraw of a malformed NLRI, "stuck" routes may result in the network.

TLVs of a given class (FSv2 Filter Family, FSv2 Filter Component for a FSv2 Filter Family) MUST be present no more than once in an NLRI. (No duplicates TLVs.)
TLVs of a given class MUST be ordered from lowest to highest. (TLVs need to be sorted.)
When a TLV's value field is understood by the implementation, the value MUST have a length appropriate for that TLV type.
When a TLV's value field is understood by the implementation, the value field MUST be well-formed according the definition of that TLV type.

Implementations MAY, depending on configuration, restrict propagation of FSv2 routes with NLRI containing Filter Families or Filter Components that they are ignorant of the encodings for. This is permitted only when the NLRI are otherwise not considered malformed by the implementation. This behavior is useful for BGP speakers, such as route reflectors, to generically disseminate FSv2 routes that they themselves might not utilize for traffic filtering. The above rules permit FSv2 implementations that are ignorant of a given Filter Family, or Filter Family's Component encoding to propagate the FSv2 route to other BGP speakers in the deployment. However, since semantic checks for a given Filter Family's components can only be effected by implementations aware of that component, ignorant upstream BGP speakers may propagate semantically-incorrect NLRI until it reaches a BGP speaker that understands the encoding.

By definition, a BGP route is a pairing of its destination (NLRI) and Path Attributes. The prior section discussed the validation of the NLRI. This section discusses validation of the pairing of the NLRIs in an UPDATE along with their Path Attributes as BGP routes. Flow specifications received from a BGP peer that are accepted in the respective Adj-RIB-In are used as input to the route selection process. Although the forwarding attributes of the two routes for the same prefix may be the same, BGP is still required to perform its path selection algorithm in order to select the correct set of attributes to advertise. The first step of the BGP Route selection procedure () is to exclude from the selection procedure routes that are considered unfeasible. In the context of IP routing information, this is used to validate that the next hop of a given route is resolvable. This concept can be extended in the case of the Flow Specification NLRI to allow other validation procedures.

The FSv2 validation process validates the FSv2 NLRI with following unicast routes received over the same AFI (1 or 2) but different SAFIs: FSv2 Flowspec BGP Route AFI/SAFI Validation

Received AFI/SAFI	Validate Route Using AFI/SAFI
1/TBD1	1/1 (IPv4-Unicast)
1/TBD2	1/128 (IPv4-Labeled Unicast)
2/TBD1	2/1 (IPv6-Unicast)
2/TBD2	2/128 (IPv6-Labeled Unicast)
31/TBD1	1/1 (IPv4-Unicast)
31/TBD2	1/128 (IPv4-Labeled Unicast)
6/TBD1	1/1 (IPv4-Unicast)
256/TBD2	1/128 (IPv4-Labeled Unicast)

In the absence of explicit configuration, a Flow specification NLRI (FSv1 or FSv2) MUST be validated such that it is considered feasible if and only if all of the conditions are true:

A destination prefix component is embedded in the Flow Specification.
One of the following conditions holds true:
1. The originator of the Flow Specification matches the originator of the best-match unicast route for the destination prefix embedded in the flow specification (this is the unicast route with the longest possible prefix length covering the destination prefix embedded in the flow specification).
2. The AS_PATH attribute of the flow specification is empty or contains only an AS_CONFED_SEQUENCE segment.
  .
  1. This condition SHOULD be enabled by default.
  2. This condition MAY be disabled by explicit configuration on a BGP Speaker.
  3. As an extension to this rule, a given non-empty AS_PATH (besides AS_CONFED_SEQUENCE segments) MAY be permitted by policy.
There are no "more-specific" unicast routes when compared with the flow destination prefix that have been received from a different neighbor AS than the best-match unicast route, which has been determined in rule b.

However, part of rule a may be relaxed by explicit configuration, permitting Flow Specifications that include no destination prefix component. If such is the case, rules b and c are moot and MUST be disregarded. By "originator" of a BGP route, we mean either the address of the originator in the ORIGINATOR_ID Attribute or the source address of the BGP peer, if this path attribute is not present. A BGP implementation MUST enforce that the AS in the left-most position of the AS_PATH attribute of a Flow Specification Route (FSv1 or FSv2) received via the Exterior Border Gateway Protocol (eBGP) matches the AS in the left-most position of the AS_PATH attribute of the best-match unicast route for the destination prefix embedded in the Flow Specification (FSv1 or FSv2) NLRI. The best-match unicast route may change over time independently of the Flow Specification NLRI (FSv1 or FSv2). Therefore, a revalidation of the Flow Specification MUST be performed whenever unicast routes change. Revalidation is defined as retesting rules a to c as described above.

FSv2 routes can carry one or more filtering action extended communities (FS-EC) that are executed when the flow specification filter matches traffic. These extended communities are syntactically validated using the procedures in and . discusses the procedures for utilizing FSv2-EC actions as part of traffic filtering.

discusses the general behavior of using flow specification for traffic filtering. FSv2 provides the additional ability to apply traffic filtering at different portions of a forwarding path. The code points assigned to the Filter Family Types and Filter Component Types for a given Filter Family are arranged to support a reasonable default traffic filtering (match, and actions) behavior. For example, the Component orders for FSv1 and FSv2 IP Basic can match traffic as part of monitoring, or mitigating, distributed denial of service (DDoS) attacks. However, that default ordering may be unsuitable for all filtering situations. FSv1 provided no mechanism to deviate from the ordering rules in . The User Order field of the NLRI () permits an operator to override the default sort ordering of FSv2 rules to effect their desired traffic filtering behavior when it deviates from the default order. Note that the procedures in have ensured that TLVs are distinctly numbered and sorted. This assists with the procedures in the following section.

More than one Flow Specification may match a particular traffic flow. Thus, it is necessary to define the order in which Flow Specifications get matched and actions being applied to a particular traffic flow. This ordering function is such that it does not depend on the arrival order of the Flow Specification via BGP and thus is consistent in the network. FSv2 routes consist of a series of Filter Families containing Filter Components for those Filter Families. Filter Families are generally ordered where their match criteria match lower network layers based on lower-numbered Filter Family Types. However, they may also be ordered based on where the default match order for that Filter Family vs. other Filter Families should occur. Similarly, within a Filter Family, Filter Components are ordered based to permit the default match order for that Filter Family to be naturally ordered as part of sorting FSv2 routes. Thus, for FSv2, the choice of code point for Filter Family, or Filter Component is chosen to represent the default sort order for traffic filtering. The relative order of two FSv2 flow specifications is determined in the following fashion:

A route with a lower User Order value () comes before a route with a higher User Order value.
Each route's Filter Family TLVs are then compared in a pair-wise fashion. A route with a lower FSv2 Filter Family Type value () comes before a route with a higher Filter Family Type value.
When both routes have the same Filter Family Type, each Filter Component TLV for that Filter Family are compared in a pair-wise fashion. A route with a lower FSv2 Filter Component Type value () comes before a route with a higher Filter Component Type value.
When Filter Component Types are identical, Filter Component Values are compared:
- For IP prefix values (IP destination or source prefix), if one of the two prefixes to compare is a more specific prefix of the other, the route with the more-specific prefix comes before the route with the less-specific prefix. Otherwise, the route with the lowest IP value comes before the route with the higher IP value.
- For all other Filter Component Types, unless otherwise specified, the comparison is performed by comparing the Filter Component data as a binary string using the memcmp() function as defined by [ISO_IEC_9899]. For strings with equal lengths, the lowest string (memcmp) has higher precedence. For strings of different lengths, the common prefix is compared. If the common prefix is not equal, the string with the lowest prefix has higher precedence. If the common prefix is equal, the longest string is considered to have higher precedence than the shorter one.

Warning: Specifications for FSv2 Filter Components are permitted to define their sort comparison criteria for that component. However, when implementations are ignorant of that Filter Component, it can only sort the components based on the general memcmp mechanism described above. In the case where a deployment contains implementations that are ignorant of a given filtering behavior, one of the two things SHOULD be done by the operator to avoid inappropriate traffic filtering or forwarding:

The User Order field should be utilized to prevent inappropriate ordering of FSv2 routes that ignorant implementations may misorder.
The Filter Component Type should be marked as "mandatory" () and dependent FSv2 filters placed in an appropriate, non-zero, Dependent Filter Chain ().

Once FSv2 flow specifications have been ordered according to the rules of the prior section, they are eligible to be installed for traffic filtering purposes. However, it is possible that a given device is incapable of implementing all match components, or actions. FSv2 flow specifications are evaluated to see if their match and action elements are able to be executed on the device. When the evaluation is "valid", the flow specification (match and actions) are eligible to be installed in the relative sort order determined in the prior section. When FSv2 flow specifications are determined to be "invalid", it impacts not only the individual flow specification that has been deemed invalid, but also all FSv2 entries sharing the same non-zero Dependent Filter Chain value (). For filtering components, defines the FSv2 Filter Component Flags field. When a device is unable to implement the match criteria contained in that Filter Component - for whatever reason - the "Optional" bit is checked. If the Optional bit is unset (zero), the Filter Component is "mandatory" and the flow specification filter is considered "invalid". If the filter bit is set (one), the Filter Component is "optional", and the device is free to install the flow specification in the sorted order minus the Filter Component in question as a "valid" entry. Similarly, if a flow specification's traffic filtering actions are unable to be installed by the device, the implementation may determine whether or not the flow specification is valid or invalid based on implementation defaults, or configuration. Features governing ordered FSv2 action and validity evaluation may be considered in the future. Once validation of all FSv2 flow specification is complete, eligible FSv2 flow specifications are installed as traffic filters.

FSv2 allows the user to order flow specification rules and the actions associated with a rule. Each FSv2 rule has one or more match conditions and one or more actions associated with each rule. FSv1 and FSv2 filters are sent as different AFI/SAFI pairs so FSv1 and FSv2 operate as ships-in-the-night. Some BGP peers in an AS may support both FSv1 and FSv2. Other BGP peers may support FSv1 or FSv2. Some BGP will not support FSv1 or FSV2. A coherent flow specification technology must have consistent best practices for ordering the FSv1 and FSv2 filter rules. One simple rule captures the best practice: Order the FSv1 filters after the FSv2 filter by placing the FSv1 filters after the FSv2 filters. To operationally make this work, all flow specification filters should be included the same data base with the FSv1 filters being assigned a user- defined order beyond the normal size of FSv2 user-ordered values. A few examples, may help to illustrate this best practice. Example 1: User ordered numbering - Suppose you might have 1,000 rules for the FSv2 filters. Assign all the FSv1 user defined rules to 1,001 (or better yet 2,000). The FSv1 rules will be ordered by the components and component values. Example 2: Storage of actions - All FSv1 actions are defined ordered actions in FSv2. Translate your FSv1 actions into FSv2 ordered actions for storing in a common FSv1-FSv2 flow specification data base.

Operational issues drive the deployment of BGP flow specification as a quick and scalable way to distribute filters. The early operations accepted the fact validation of the distribution of filter needed to be done outside of the BGP distribution mechanism. Other mechanisms (NETCONF/RESTCONF or PCEP) have reply-request protocols. These features within BGP have not changed. BGP still does not have an action-reply feature. NETCONF/RESTCONF latest enhancements provide action/response features which scale. The combination of a quick distribution of filters via BGP and a long-term action in NETCONF/RESTCONF that ask for reporting of the installation of FSv2 filters may provide the best scalability. The combination of NETCONF/RESTCONF network management protocols and BGP focuses each protocol on the strengths of scalability. FSv2 will be deployed in webs of BGP peers which have some BGP peers passing FSv1, some BGP peers passing FSv2, some BGP peers passing FSv1 and FSv2, and some BGP peers not passing any routes. The TLV encoding and deterministic behaviors of FSv2 will not deprecate the need for careful design of the distribution of flow specification filters in this mixed environment. The needs of networks for flow specification are different depending on the network topology and the deployment technology for BGP peers sending flow specification. Suppose we have a centralized RR connected to DDoS processing sending out flow specification to a second tier of RR who distribute the information to targeted nodes. This type of distribution has one set of needs for FSv2 and the transition from FSv1 to FSv2. Suppose we have Data Center with a 3-tier backbone trying to distribute DDoS or other filters from the spine to combinational nodes, to the leaf BGP nodes. The BGP peers may use RR or normal BGP distribution. This deployment has another set of needs for FSv2 and the transition from FSv1 to FSV2. Suppose we have a corporate network with a few AS sending DDoS filters using basic BGP from a variety of sites. Perhaps the corporate network will be satisfied with FSv1 for a long time. These examples are given to indicate that BGP FSv2, like so many BGP protocols, needs to be carefully tuned to aid the mitigation services within the network. This protocol suite starts the migration toward better tools using FSv2, but it does not end it. With FSv2 TLVs and deterministic actions, new operational mechanisms can start to be understood and utilized. This FSv2 specification is merely the start of a revolution of work – not the end.

This section discusses the optional BGP Security additions for BGP-FS v2 relating ROA .

BGP FSv2 can utilize ROAs in the validation. If BGP FSv2 is used with BGPSEC and ROA, the first thing is to validate the route within BGPSEC and second to utilize BGP ROA to validate the route origin. The BGP-FS peers using both ROA and BGP-FS validation determine that a BGP Flow specification is valid if and only if one of the following cases: If the BGP Flow Specification NLRI has a IPv4 or IPv6 address in destination address match filter and the following is true: A BGP ROA has been received to validate the originator, and The route is the best-match unicast route for the destination prefix embedded in the match filter; or If a BGP ROA has not been received that matches the IPv4 or IPv6 destination address in the destination filter, the match filter must abide by the and validation rules as follows: The originator match of the flow specification matches the originator of the best-match unicast route for the destination prefix filter embedded in the flow specification", and No more specific unicast routes exist when compared with the flow destination prefix that have been received from a different neighboring AS than the best-match unicast route, which has been determined in step A. The best match is defined to be the longest-match NLRI with the highest preference.

This section complies with .

IANA is requested to assign one AFI Values in the registry at https://www.iana.org/assignments/address-family-numbers from the Standard Action Range as follows:

Table 7-1 AFI Value Description Reference ----- ------------- --------------- TBD1 BGP FSv2 [this document]

IANA is requested to assign two SAFI Values in the registry at https://www.iana.org/assignments/safi-namespace from the Standard Action Range as follows:

Table 7-1 SAFIs Value Description Reference ----- ------------- --------------- TBD1 BGP FSv2 [this document] TBD2 BGP FSv2 VPN [this document]

IANA is requested to create the a new registry for "Flow Specification v2 Filter Family Types". Registration Procedures: 0x01-0x3FFF Standards Action. Flow Specification v2 Filter Component Types

Type	Description	Reference
0	Reserved	[this document]
1-119	Unassigned	[this document]
200	Time	[this document]
201-299	Unassigned	[this document]
300	Interface	[this document]
301-399	Unassigned	[this document]
400	L2 Traffic Rules	[this document]
401-499	Unassigned	[this document]
500	MPLS traffic rules	[this document]
501-599	Unassigned	[this document]
600	SFC Traffic rules	[this document]
601-699	Unassigned	[this document]
700	Queue Pair	[this document]
701-799	Unassigned	[this document]
800	Tunneled traffic	[this document]
801-899	Unassigned	[this document]
1000	IPv4 Basic	[this document]
1001-1099	Unassigned	[this document]
1100	IPv6 Basic	[this document]
1100-1199	Unassigned	[this document]
1200	CATS Traffic Rules	[this document]
1200-1399	Unassigned	[this document]
1400	Routing	[this document]
1401-24575	Unassigned	[this document]
24576-32767	Vendor specific	[this document]
32768-65535	Reserved	[this document]

IANA is requested to create a new "BGP FSv2 QP Component Types" registry and indicate [this draft] as a reference. The following assignments in the FSv2 QP Component Types Registry shold be made.

Registry Name:: BGP FSv2 QP Component Types
Reference:: [this document]
Registration Procedures:: 0x01-0x3FFF Standards Action, 0x4000-0xFFFF FCFS.

BGP FSv2 QP Component Types

Type	Definition	Reference
0	Reserved	This document
1-99	Unassigned	This document
100	Destination QP (editor: verify)	This document
101-4094	Unassigned	This document
4095	reserved	This document

IANA is requested to create a new "BGP FSv2 IP Basic Component Types" registry and indicate [this draft] as a reference. The following assignments in the FSv2 IP Basic Filters Component Types Registry shold be made.

Registry Name:: BGP FSv2 Component Types
Reference:: [this document]
Registration Procedures:: 0x01-0x3FFF Standards Action, 0x4000-0xFFFF FCFS.

BGP FSv2 IP Basic Component Types

Type	Definition	Reference
0	Reserved	This document
1-99	Unassigned	This document
100	Destination QP (editor: verify)	This document
101-199	Unassigned	This document
300	Parts of SRHv6	This document
301-499	Unassigned	This document
500	NRP ID in NextHop SRv6	This document
501-799	Unassigned	This document
800	Bitwise Destination IPv4	This document
801-809	Unassigned	This document
810	Bitwise Destination IPv6	This document
811-999	Unassigned	This document
1000	IPv4 Destination Prefix	This document
1001-1009	Unassigned	This document
1010	IPv6 Destination Prefix	This document
1010-1099	Unassigned	This document
1100	Bitwise Source IPv4	This document
1101-1109	Unassigned	This document
1110	Bitwise Source IPv6	This docume
1111-1199	Unassigned	This document
1200	IPv4 Source Prefix	This document
1201-1209	Unassigned	This document
1210	IPv6 Source Prefix	This document
1211-1299	Unassigned	This document
1300	IPv4 Protocol	This document
1301-1309	Unassigned	This document
1310	IPv6 Upper Layer Protocol	This document
1311-1399	Unassigned	This document
1400	Port	This document
1401-1499	Unassigned	This document
1500	Destination Port	This document
1501-1509	Unassigned	This document
1600	Source Port	This document
1600-1609	Unassigned	This document
1700	ICMPv4 Type	This document
1701-1709	Unassigned	This document
1710	ICMPv6 Type	This document
1711-1799	Unassigned	This document
1800	ICMPv4 Code	This document
1800-1801	Unassigned	This document
1810	ICPv6 Code	This document
1811-1899	Unassigned	This document
1900	TCP (v4) Flags	This document
1901-1909	Unassigned	This document
1910	TCP (v4) Flags	This document
1911-1999	Unassigned	This document
2000	Packet Length	This document
2000-2099	Unassigned	This document
2100	DSCP	This document
2100-2199	Unassigned	This document
2200	Fragment	This document
2201-2299	Unassigned	This document
2300	Flow Label	This document
2301-2999	Unassigned	This document
3000	Packet Content Filter	This document
3001-3999	Unassigned	This document

IANA is requested to create a new "BGP FSv2 CAT Component Types" registry and indicate [this draft] as a reference. The following assignments in the FSv2 QP Component Types Registry shold be made.

Registry Name:: BGP FSv2 CAT Component Types
Reference:: [this document]
Registration Procedures:: 0x01-0x3FFF Standards Action, 0x4000-0xFFFF FCFS.

BGP FSv2 CAT Component Types

Type	Definition	Reference
0	Reserved	This document
1-199	Unassigned	This document
200	Class-ID (editor: verify)	This document
201-4094	Unassigned	This document
4095	reserved	This document

IANA is requested to create a new "BGP FSv2 Routing Component Types" registry and indicate [this draft] as a reference. The following assignments in the FSv2 Routing Augment Component Types Registry shold be made.

Registry Name:: BGP FSv2 Routing Augment Component Types
Reference:: [this document]
Registration Procedures:: 0x01-0x3FFF Standards Action, 0x4000-0xFFFF FCFS.

BGP FSv2 Routing Augment Component Types

Type	Definition	Reference
0	Reserved	This document
1-99	Unassigned	This document
100	DIP-AS (editor: verify)	This document
101-199	Unassigned	This document
200	SIP-AS (editor: verify)	This document
201-299	Unassigned	This document
300	DIP-comm (editor: verify)	This document
301-399	Unassigned	This document
400	SIP-com (editor: verify)	This document
401-4094	Unassigned	This document
4095	reserved	This document

The use of ROA improves on by checking to see of the route origination. This check can improve the validation sequence for a multiple-AS environment. >The use of BGPSEC to secure the packet can increase security of BGP flow specification information sent in the packet. The use of the reduced validation within an AS can provide adequate validation for distribution of flow specification within a single autonomous system for prevention of DDoS. Distribution of flow filters may provide insight into traffic being sent within an AS, but this information should be composite information that does not reveal the traffic patterns of individuals.