<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="3"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>

<rfc category='std' ipr='trust200902' docName='draft-ietf-bier-ospfv3-extensions-05'>

<front>
<title abbrev="OSPFv3 Extensions for BIER">OSPFv3 Extensions for BIER</title>

<author initials="P." surname="Psenak" fullname="Peter Psenak" role="editor">
	<organization>Cisco Systems, Inc.</organization>
	<address>
		<postal>
		<street>Apollo Business Center</street>
		<city>Mlynske nivy 43</city> <region>Bratislava</region> <code>821 09</code>
		<country>Slovakia</country>
		</postal>
	<email>ppsenak@cisco.com</email>
	</address>
</author>

<author initials="N." surname="Nainar" fullname="Nagendra Kumar Nainar" role="editor">
	<organization>Cisco Systems, Inc.</organization>
	<address>
		<postal>
		<street>7200 Kit Creek Road</street>
		<city>Research Triangle Park</city> <region>NC</region> <code>27709</code>
		<country>US</country>
		</postal>
	<email>naikumar@cisco.com</email>
	</address>
</author>

<author initials="IJ." surname="Wijnands" fullname="IJsbrand Wijnands">
	<organization>Individual Contributor</organization>
	<address>
		<postal>
		<street></street>
		<city>Diegem</city> <region></region> <code>1831</code>
		<country>Belgium</country>
		</postal>
	<email>ice@braindump.be</email>
	</address>
</author>
    
<date />
<area>Internet</area>
<workgroup>Network Work group</workgroup>

<keyword>bier</keyword>

<abstract><t>Bit Index Explicit Replication (BIER) is an architecture that
   provides multicast forwarding through a "BIER domain" without
   requiring intermediate routers to maintain multicast related per-flow 
   state.  Neither does BIER require an explicit tree-building
   protocol for its operation.  A multicast data packet enters a BIER
   domain at a "Bit-Forwarding Ingress Router" (BFIR), and leaves the
   BIER domain at one or more "Bit-Forwarding Egress Routers" (BFERs).
   The BFIR router adds a BIER header to the packet.  Such header
   contains a bit-string in which each bit represents exactly one BFER
   to forward the packet to.  The set of BFERs to which the multicast
   packet needs to be forwarded is expressed by the according set of bits 
   set in BIER packet header.
 </t>
<t>This document describes the OSPFv3 [RFC8362] protocol extensions required for 
BIER with MPLS encapsulation [RFC8296]. Support for other encapsulation types is
outside the scope of this document. The use of multiple encapsulation types is 
outside the scope of this document. </t>
</abstract>
</front>

<middle>
	
<section title="Introduction">
	<t>Bit Index Explicit Replication (BIER) is an architecture that provides 
	optimal multicast forwarding through a "BIER domain"
	without requiring intermediate routers to maintain any multicast related per-flow
	state. Neither does BIER explicitly require a tree-building protocol for its 
	operation.  A multicast data packet enters a BIER domain at a "Bit-Forwarding 
	Ingress Router" (BFIR), and leaves the BIER domain at one or more "Bit-Forwarding 
	Egress Routers" (BFERs). The BFIR router adds a BIER header to the packet.  The BIER
    header contains a bit-string in which each bit represents exactly one BFER to forward
    the packet to. The set of BFERs to which the multicast packet needs to be forwarded
    is expressed by setting the bits that correspond to those routers in the BIER header.
    </t>
    
    <t>BIER architecture requires routers participating in BIER to exchange
    BIER related information within a given domain. BIER architecture permits link-state 
    routing protocols to perform distribution of such information. 
    <xref target="RFC8444" /> proposes the OSPFv2 protocol
    extensions to distribute BIER specific information. This document describes extensions
    to OSPFv3 necessary to advertise BIER specific information in the case where BIER 
    uses MPLS encapsulation as described in <xref target="RFC8296" />.</t>
    
    <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 <xref target="RFC2119" />.
    </t>
					
	</section>

<section anchor="BIERINFO" title="Flooding of the BIER Information in OSPFv3">
	
	<t>All BIER specific information that a Bit-Forwarding Router (BFR) needs to 
    advertise to other BFRs is associated with a BFR-Prefix. A BFR prefix is a unique 
	(within a given BIER domain) routable IPv4 or IPv6 address that is assigned to each
	BFR as described in more detail in <xref target="RFC8279"/>.</t>
	
	<t><xref target="RFC8362" /> defines the encoding of OSPFv3 
	LSA in TLV format that allows to carry additional informations. This section defines
	the required Sub-TLVs to carry BIER information that is associated with the BFR-Prefix.
	The Sub-TLV defined in this section MAY be carried in the below OSPFv3 Extended LSA 
	TLVs <xref target="RFC8362"/>:
	<list>
		<t>Intra-Area-Prefix TLV</t> 
		<t>Inter-Area-Prefix TLV</t>
	</list>
	</t>

	<section anchor="BIERSUBTLV" title="BIER Sub-TLV">
	
	<t>A Sub-TLV of the above mentioned Prefix TLVs is defined for distributing BIER 
    information. The Sub-TLV is called the BIER Sub-TLV. Multiple BIER Sub-TLVs may be
    included in any of the above mentioned Prefix TLV.</t>
    
	<t>The BIER Sub-TLV has the following format:
		</t>
			<figure>
			<artwork><![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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |              Type             |             Length            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   | Sub-domain-ID |      MT-ID    |              BFR-id           |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |     BAR       |     IPA       |        Reserved               |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                      Sub-TLVs (variable)                      |
   +-                                                             -+
   |                                                               |

             ]]></artwork>
        	</figure>
    <t>
     <list style='hanging'>
     
    <t>Type: TBD1
    </t>
    
    <t>Length: Variable, dependent on sub-TLVs.
    </t>
    
    <t>Sub-domain-ID: Unique value identifying the BIER sub-domain within
      the BIER domain, as described in <xref target="RFC8279" />
    </t>
    
    <t>MT-ID: Multi-Topology ID (as defined in <xref target="RFC4915" /> that
    identifies the topology that is associated with the BIER sub-domain.
    </t>
    
    <t>BFR-id: A 2 octet field encoding the BFR-id, as documented in 
    	 section 2 of <xref target="RFC8279" />.  If the BFR is not
         locally configured with a valid BFR-id, the value of this field is
         set to 0, which is defined as illegal in <xref target="RFC8279" />.
    </t>
    
    <t>BAR: Single octet BIER specific algorithm used to calculate underlay paths to 
    reach other BFRs. Values are allocated from the "BIER Algorithm" registry which is 
    defined in <xref target="RFC8401" />.
    </t>
    
    <t>IPA: Single octet IGP algorithm to either modify, enhance or replace the 
    	calculation of underlay paths to reach other BFRs as defined by the BAR
    	value. Values are defined in the "IGP Algorithm Types" registry.
    </t>
    
    </list>
    </t>  
    
    <t>Each BFR sub-domain MUST be associated with one and only one OSPF topology that is 
    identified by the MT-ID. If the association between BIER
    sub-domain and OSPF topology advertised in the BIER sub-TLV by other BFRs is in conflict 
    with the association locally configured on the receiving router, the BIER Sub-TLV MUST
    be ignored.
    </t>
    
    <t>If the MT-ID value is outside of the values specified in <xref target="RFC4915" />, 
    the BIER Sub-TLV MUST be ignored.
    </t>
    
	<t>If a BFR advertises the same Sub-domain-ID in multiple BIER sub-TLVs, the BFR MUST 
	be treated as if it did not advertise a BIER sub-TLV for such sub-domain.</t>

	<t>All BFRs MUST detect advertisement of duplicate valid BFR-IDs for a given 
	MT-ID and Sub-domain-ID. When such duplication is detected by the BFR, it MUST 
	behave as described in section 5 of <xref target="RFC8279" />. </t>
	 
	<t>The supported BAR and IPA algorithms MUST be consistent for all routers 
	supporting a given  
	BFR sub-domain. A router receiving BIER Sub-TLV advertisement with a value in BAR
	or IPA fields which does 
	not match the locally configured value for a given BFR sub-domain, MUST report 
	a misconfiguration for such BIER sub-domain and MUST ignore such BIER sub-TLV.</t>
	
	<t>The use of non-zero values in either the BAR field or the IPA field is 
	outside the scope of this 
	document.
	</t>
	   
	</section>
	
	<section anchor="BIERMPLSSUBTLV" title="BIER MPLS Encapsulation Sub-TLV">
		<t>The BIER MPLS Encapsulation Sub-TLV is a Sub-TLV of the BIER Sub-TLV defined
		 in <xref target="BIERSUBTLV"/>. The BIER MPLS Encapsulation Sub-TLV is used 
		 in order to advertise MPLS specific information used for BIER. It MAY appear
		 multiple times in the BIER Sub-TLV.</t>
		
		<t>The BIER MPLS Encapsulation Sub-TLV has the following format:</t>
		
		<figure>
			<artwork><![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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |              Type             |             Length            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |     Max SI    |                    Label                      |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |BS Len |                     Reserved                          |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+


                        ]]></artwork>
            	</figure>
     <t>
     <list style='hanging'>
	
	  <t>Type: Set to TBD2.</t>

      <t>Length: 8 octets</t>

	  <t>Max SI: A 1 octet field encoding the maximum Set Identifier (section 1
	  of <xref target="RFC8279" />), used in the encapsulation for this BIER 
	  sub-domain for this bitstring length.</t>
	        
      <t>Label: A 3 octet field, where the 20 rightmost bits represent the first
      label in the label range. The 4 leftmost bits MUST be ignored.</t>
      
      <t>Bit String Length: A 4 bits field encoding the supported BitString length	
	  associated with this BFR-prefix. The values allowed in this field	
	  are specified in section 2 of <xref target="RFC8296"/>.</t>
	  
	  <t>Reserved: SHOULD be set to 0 on transmission and MUST be ignored on 
	  reception.
	  </t>
      	
	  <t>The "label range" is the set of labels beginning with the Label and 
	  ending with (Label + (Max SI)). A unique label range is  allocated
	  for each BitString length and Sub-domain-ID. These labels are used for BIER 
	  forwarding as described in <xref target="RFC8279"/> and 
	  <xref target="RFC8296"/>.</t>

      <t>The size of the label range is determined by the number of Set Identifiers (SI) 
      (section 1 of <xref target="RFC8279"/>) that are used in the 
      network. Each SI maps to a single label in the label range. The first label is for 
      SI=0, the second label is for SI=1, etc.</t>
    </list></t> 
    
    <t>If the label associated with the Maximum Set Identifier exceeds the 20 bit range, the 
    BIER MPLS Encapsulation Sub-TLV MUST be ignored.
    </t>
    
    <t>If the BS length is set to a value that does not match any of the allowed values
    specified in <xref target="RFC8296" />, the BIER MPLS Encapsulation Sub-TLV MUST be 
    ignored.
    </t>
    
    <t>If same BS length is repeated in multiple BIER MPLS Encapsulation Sub-TLV inside
    the same BIER Sub-TLV, the BIER sub-TLV MUST be ignored.</t>
    
    <t>Label ranges within all BIER MPLS Encapsulation Sub-TLVs advertised by the same BFR
    MUST NOT overlap. If the overlap is detected, the advertising router MUST be treated
    as if it did not advertise any BIER sub-TLVs.</t>
        
	</section>
	
	<section title="Flooding scope of BIER Information">
		
		<t>The flooding scope of the Extended LSAs <xref target="RFC8362" /> that is used
		 for advertising the BIER Sub-TLV is area-local. To allow BIER deployment 
		 in a multi-area environment,  OSPFv3 must propagate BIER information 
		 between areas.</t>
		
		<figure>
			<artwork><![CDATA[
                                
                 (  )         (  )         (  )	 		
               (      )     (      )     (      )	 		
            R1  Area 1   R2  Area 0   R3  Area 2  R4	 		
               (      )     (      )     (      )	 		
                 (  )         (  )         (  )	 		
                  
               Figure 1: BIER propagation between areas
             ]]></artwork>
        	</figure>
		
		<t>The following procedure is used in order to propagate BIER related information
		between areas:
		</t>
		<t><list>
			<t>
		When an OSPFv3 Area Border Router (ABR) advertises E-Inter-Area-Prefix-LSA from an
		intra-area or inter-area prefix to all its attached areas, it determines whether 
		a BIER Sub-TLV should be included in this LSA. When doing so, an OSPFv3 ABR will:
			<list style="symbols">
				<t>Examine its best path to the prefix in the source area and find the 
				advertising router associated with the best path to that prefix.
				</t>
				
				<t>Determine if such advertising router advertised a BIER Sub-TLV for the
				prefix. If yes, the ABR will copy the information from such BIER Sub-TLV
				 when advertising BIER Sub-TLV to each attached area.
				</t>
			</list>
		</t>
		    <t>In the Figure 1, R1 advertises a prefix 2001:db8:b1e6::1/128 in Area 1. It
		    also includes BIER Sub-TLV in E-Intra-Area-Prefix-LSA. ABR R2 calculates the 
		    reachability for prefix 2001:bdb8:b1e6::1/128 inside Area 1 and propagates 
		    it to Area 0 using E-Inter-Area-Prefix-LSA. When doing so, it copies the entire
		    BIER Sub-TLV (including all its Sub-TLVs) it received from R1 in Area 1 and
		    includes it in the E-Inter-Area-Prefix-LSA it generates for the prefix in 
		    Area 0. ABR R3 calculates the reachability for prefix 2001:bdb8:b1e6::1/128
		    inside Area 0 and propagates it to Area 2. When doing so, it copies the entire 
		    BIER Sub-TLV (including all its Sub-TLVs) it received from R2 in Area 0 and
		    includes it in E-Inter-Area-Prefix-LSA it generates for 2001:bdb8:b1e6::1/128
		    in Area 2.
		    </t>
			</list>
		</t>	
	</section>
	
</section>
		
    <section title="Security Considerations">
		<t>This document introduces new sub-TLVs for OSPFv3 Extended-LSAs. It does not
		introduce any new security risks to OSPFv3. Existing security concerns 
		documented in <xref target="RFC8362" /> is applicable for 
		the Sub-TLVs defined in this document.
		</t>
		
		<t>
		It is assumed that both BIER and OSPF layer is under a single	 		
   administrative domain.  There can be deployments where potential	 		
   attackers have access to one or more networks in the OSPFv3 routing	 		
   domain.  In these deployments, stronger authentication mechanisms	 		
   such as those specified in <xref target="RFC4552" /> SHOULD be used.
		</t>
		
		<t>
The Security Considerations section of [RFC8279] discusses the 
possibility of performing a Denial of Service (DoS) attack by setting 
too many bits in the BitString of a BIER-encapsulated packet. 
However, this sort of DoS attack cannot be initiated by modifying the 
OSPF BIER advertisements specified in this document.  A BFIR decides 
which systems are to receive a BIER-encapsulated packet.  In making 
this decision, it is not influenced by the OSPF control messages. 
When creating the encapsulation, the BFIR sets one bit in the 
encapsulation for each destination system.  The information in the 
OSPF BIER advertisements is used to construct the forwarding tables 
that map each bit in the encapsulation into a set of next hops for 
the host that is identified by that bit, but is not used by the BFIR 
to decide which bits to set.  Hence an attack on the OSPF control 
plane cannot be used to cause this sort of DoS attack.
</t>

<t>
 While a BIER-encapsulated packet is traversing the network, a BFR 
 that receives a BIER-encapsulated packet with n bits set in its 
 BitString may have to replicate the packet and forward multiple 
 copies.  However, a given bit will only be set in one copy of the 
 packet.  That means that each transmitted replica of a received 
 packet has fewer bits set (i.e., is targeted to fewer destinations) 
 than the received packet.  This is an essential property of the BIER 
 forwarding process as defined in [RFC8279].  While a failure of this 
 process might cause a DoS attack (as discussed in the Security 
 Considerations of [RFC8279]), such a failure cannot be caused by an 
 attack on the OSPF control plane.
 </t>
		<t>Implementations MUST assure that malformed TLV and Sub-TLV defined in 
		this document are detected and do not provide a vulnerability for attackers
		to crash the OSPFv3 router or routing process. Reception of malformed TLV or 
		Sub-TLV SHOULD be counted and/or logged for further analysis. Logging of malformed
		TLVs and Sub-TLVs SHOULD be rate-limited to prevent a Denial of Service (DoS)
		attack (distributed or otherwise) from overloading the OSPFv3 control plane.
		</t>
		
		</section>
	
	<section title="IANA Considerations">
    <t>
      The document requests two new allocations from the OSPFv3 Extended-LSA 
		sub-TLV registry as defined in <xref target="RFC8362"/>.
      <list style='hanging'>
	  <t>BIER Sub-TLV: TBD1</t>
	  
	  <t>BIER MPLS Encapsulation Sub-TLV: TBD2</t>
	  
	  </list>
    </t>
    
  </section>
  
  		<section title="Acknowledgements">
					<t>TBD</t>
		</section>


    </middle>
	
<back>

    <references title="Normative References">
	
	<?rfc include="reference.RFC.2119"?>

	<?rfc include="reference.RFC.4915"?>
	
	<?rfc include="reference.RFC.5340"?>
	
	<?rfc include="reference.RFC.8296"?>

	<?rfc include="reference.RFC.8362"?>
	
	<?rfc include="reference.RFC.8279"?>

	<?rfc include="reference.RFC.4552"?>

	<?rfc include="reference.RFC.8401"?>
	
	<?rfc include="reference.RFC.8444"?>

	  
    </references>
    

		</back>

</rfc>
