<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!ENTITY RFC2234 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2234.xml">
<!ENTITY RFC2629 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2629.xml">
<!ENTITY RFC4234 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4234.xml">
<!ENTITY nbsp    "&#160;">
]>

<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>

<?rfc strict="yes" ?>
<?rfc comments="no" ?>
<?rfc inline="no" ?>
<?rfc editing="no" ?>
<?rfc toc="yes" ?>
<?rfc tocompact="yes" ?>
<?rfc tocdepth="3" ?>
<?rfc symrefs="yes" ?>
<?rfc sortrefs="yes" ?>
<?rfc compact="yes" ?>
<?rfc subcompact="no" ?>

<rfc category="std"
    ipr="trust200902"
    docName="draft-sas-idr-maxprefix-inbound-02"
    updates="4271"
    submissionType="IETF">

    <front>

        <title abbrev="BGP Maximum Prefix Limits Inbound">
            BGP Maximum Prefix Limits Inbound
        </title>

				<author fullname="Melchior Aelmans" initials="M." surname="Aelmans">
					<organization>Juniper Networks</organization>

					<address>
						<postal>
							<street>Boeing Avenue 240</street>
							<code>1119 PZ</code>
							<city>Schiphol-Rijk</city>
							<country>The Netherlands</country>
						</postal>

						<email>maelmans@juniper.net</email>
					</address>
				</author>

				<author fullname="Massimiliano Stucchi" initials="M." surname="Stucchi">
					<organization>Independent</organization>
					<address>
						<email>max@stucchi.ch</email>
					</address>
				</author>

				<author fullname="Job Snijders" initials="J." surname="Snijders">
					<organization abbrev="Fastly">Fastly</organization>

					<address>
						<postal>
							<street>Theodorus Majofskistraat 100</street>
							<code>1065 SZ</code>
							<city>Amsterdam</city>
							<country>The Netherlands</country>
						</postal>
						<email>job@fastly.com</email>
					</address>
				</author>
        <date />
        <area>Routing</area>
        <workgroup>Inter-Domain Routing</workgroup>

        <keyword>BGP</keyword>
        <keyword>Prefix</keyword>

        <abstract>
            <t>
                This document describes mechanisms to limit the negative impact of <xref target="RFC7908">route leaks</xref> and/or resource exhaustion in BGP <xref target="RFC4271" /> implementations.
            </t>
        </abstract>
        <note title="Requirements Language">
            <t>
                The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they appear in all capitals, as shown here.
            </t>
        </note>
    </front>
    <middle>
        <section title="Introduction">
            <t>
		This document updates <xref target="RFC4271" /> by revising control mechanism which limit the negative impact of <xref target="RFC7908">route leaks</xref> and/or resource exhaustion in Border Gateway Protocol (BGP) implementations.
		While <xref target="RFC4271" /> described methods to tear down BGP sessions or discard UPDATES after certain thresholds are exceeded, some nuances in this specification were missing resulting in inconsistencies between BGP implementations.
            </t>
        </section>

<!--
        <section title="Application of Control Theory to BGP Operations">
            <t>
            </t>
        </section>
-->

        <section title="Changes to RFC4271 Section 6">
            <t>
                This section updates <xref target="RFC4271" /> to specify what events can result in AutomaticStop (Event 8) in the BGP FSM.
            </t>
            <t>
                The following paragraph replaces the second paragraph of Section 6.7 (Cease), which starts with "A BGP speaker MAY support" and ends with "The speaker MAY also log this locally.":
            </t>
            <t>
                <list style="empty">
                    <t>
                        A BGP speaker MAY support the ability to impose a locally-configured, upper bound on the number of address prefixes the speaker is willing to accept from a neighbor (inbound maximum prefix limit).
                        The limit on the prefixes accepted from a neighbor can be applied before policy processing (Pre-Policy) or after policy processing (Post-Policy).
                        When the upper bound is reached, the speaker, under control of local configuration, either:
                        <list style="letters">
                            <t><!-- option a -->
                                Discards new address prefixes from the neighbor, while maintaining the BGP connection.  As these prefixes are discared, their reachability information is not stored on the local router, which might lead to inconsistent routing behaviour;
														</t>
														<t> <!-- Option B -->
															Receives all the new prefixes exceeding the threshold, accepts them and generates a log of the event;
														</t>
                            <t> <!-- option c -->
                                Terminates the BGP connection with the neighbor.
                            </t>
                        </list>
                    </t>
                </list>
            </t>
            <t>
                <list style="empty">
                    <t>
                        If the BGP speaker decides to terminate its BGP connection with a neighbor because the number of address prefixes received from the neighbor exceeds the locally-configured, upper bound, then the speaker MUST send the neighbor a NOTIFICATION message with the Error Code Cease.
                    </t>
                </list>
            </t>
            <texttable>
                <ttcol>Subcode</ttcol><ttcol>Symbolic Name</ttcol>
                <c>1</c><c>Threshold exceeded: Maximum Number of Prefixes Received</c>
            </texttable>
            <t>
                <list style="empty">
                    <t>
                        The speaker MAY also log this locally.
                    </t>
                </list>
            </t>
        </section>

        <section title="Changes to RFC4271 Section 8">
            <t>
                This section updates <xref target="RFC4271">Section 8</xref>, the paragraph that starts with "One reason for an AutomaticStop event is" and ends with "The local system automatically disconnects the peer." is replaced with:
            </t>
            <t>
                <list style="empty">
                    <t>
                        Possible reasons for an AutomaticStop event are: A BGP speaker receives an UPDATE messages with a number of prefixes for a given peer such that the total prefixes received exceeds the maximum number of prefixes configured (either "Pre-Policy" or "Post-Policy").
                        The local system automatically disconnects the peer.
                    </t>
                </list>
            </t>
        </section>

        <section title="Changes to RFC4271 Section 9">
            <t>
                This section updates <xref target="RFC4271" /> by adding a subsection after Section 9.4 (Originating BGP routes) to specify various events that can lead up to AutomaticStop (Event 8) in the BGP FSM.
            </t>
            <t>
                <list style="empty">
                    <t>
                        9.5 Maximum Prefix Limits
                    </t>
                    <t>
                        9.5.1 Pre-Policy Inbound Maximum Prefix Limits
                    </t>
                    <t>
                        <list style="empty">
                            <t>
                                The Adj-RIBs-In stores routing information learned from inbound UPDATE messages that were received from another BGP speaker <xref target="RFC4271">Section 3.2</xref>.
                                The pre-policy limit uses the number of NLRIs per Address Family Identifier (AFI) per Subsequent Address Family Identifier (SAFI) as input into its threshold comparisons.
                                For example, when an operator configures the pre-policy limit for IPv4 Unicast to be 50 on a given EBGP session, and the other BGP speaker announces its 51st IPv4 Unicast NLRI, the session MUST be terminated. 
                            </t>
                            <t>
                                Pre-policy limits are particularly useful to help dampen the effects of full table route leaks and memory exhaustion when the implementation stores rejected routes.
                            </t>
                        </list>
                    </t>
                    <t>
                        9.5.2 Post-Policy Inbound Maximum Prefix Limits
                    </t>
                    <t>
                        <list style="empty">
                            <t>
                                RFC4271 describes a Policy Information Base (PIB) that contains local policies that can be applied to the information in the Routing Information Base (RIB).
                                The post-policy limit uses the number of NLRIs per Address Family Identifier (AFI) per Subsequent Address Family Identifier (SAFI), after application of the Import Policy as input into its threshold comparisons.
                                For example, when an operator configures the post-policy limit for IPv4 Unicast to be 50 on a given EBGP session, and the other BGP speaker announces a hundred IPv4 Unicast routes of which none are accepted as a result of the local import policy (and thus not considered for the Loc-RIB by the local BGP speaker), the session is not terminated.
                            </t>
                            <t>
                                Post-policy limits are useful to help prevent FIB exhaustion and prevent accidental BGP session teardown due to prefixes not accepted by policy anyway.
                            </t>
                        </list>
                    </t>
                </list>
            </t>
        </section>

       <section title="Security Considerations">
           <t>
               Maximum Prefix Limits are an essential tool for routing operations and SHOULD be used to increase stability for the global routing ecosystem.
            </t>
        </section>
        <section title="IANA Considerations">
            <t>
                <!-- improve the names to make it clear which side does what -->
                This memo requests that IANA updates the name of subcode "Maximum Number of Prefixes Reached" to "Threshold exceeded: Maximum Number of Prefixes Received" in the "Cease NOTIFICATION message subcodes" registry under the "Border Gateway Protocol (BGP) Parameters" group.
            </t>
        </section>
        <section title="Acknowledgments">
            <t>
                The authors would like to thank Saku Ytti and John Heasley (NTT Ltd.), Jeff Haas, Colby Barth and John Scudder (Juniper Networks), Martijn Schmidt (i3D.net), Teun Vink (BIT), Sabri Berisha (eBay), Martin Pels (Quanza), Steven Bakker (AMS-IX), Aftab Siddiqui (ISOC), Yu Tianpeng, Ruediger Volk (Deutsche Telekom), Robert Raszuk (Bloomberg), Jakob Heitz (Cisco), Warren Kumari (Google), Ben Maddison (Workonline), Randy Bush, Brian Dickson and Gyan Mishra (Verizon) for their support, insightful reviews, and comments.
            </t>
        </section>
        <section title="Implementation status - RFC EDITOR: REMOVE BEFORE PUBLICATION">
            <t>
                This section records the status of known implementations of the
                protocol defined by this specification at the time of posting of
                this Internet-Draft, and is based on a proposal described in
                RFC7942. The description of implementations in this
                section is intended to assist the IETF in its decision processes in
                progressing drafts to RFCs.  Please note that the listing of any
                individual implementation here does not imply endorsement by the
                IETF. Furthermore, no effort has been spent to verify the
                information presented here that was supplied by IETF contributors.
                This is not intended as, and must not be construed to be, a catalog
                of available implementations or their features. Readers are advised
                to note that other implementations may exist.
            </t>
            <t>
                The below table provides an overview (as of the moment of writing) of which vendors have produced implementation of inbound prefix limits.
                Each table cell shows the applicable configuration keywords if the vendor implemented the feature.
            </t>
                <texttable anchor="table_ex" title="Maximum prefix limits capabilities per implementation" style="all">
                    <ttcol align="center" width="20%">Vendor</ttcol>
                    <ttcol align="center">Type A Pre-Policy</ttcol>
                    <ttcol align="center">Type B Post-Policy</ttcol>
                    <c>Cisco IOS XR</c><c></c><c>maximum-prefix</c>
                    <c>Cisco IOS XE</c><c></c><c>maximum-prefix</c>
                    <c>Juniper Junos OS</c><c>prefix-limit</c><c>accepted-prefix-limit, or prefix-limit combined with 'keep none'</c>
                    <c>Nokia SR OS</c><c>prefix-limit</c><c></c>
                    <c>NIC.CZ BIRD</c><c>'import keep filtered' combined with 'receive limit'</c><c>'import limit' or 'receive limit'</c>
                    <c>OpenBSD OpenBGPD</c><c>max-prefix</c><c></c>
                    <c>Arista EOS</c><c>maximum-routes</c><c>maximum-accepted-routes</c>
                    <c>Huawei VRPv5</c><c>peer route-limit</c><c></c>
                    <c>Huawei VRPv8</c><c>peer route-limit</c><c>peer route-limit accept-prefix</c>
                    <postamble>First presented by Snijders at <xref target="RIPE77"/></postamble>
                </texttable>
            </section>

            <section title="Appendix: Implementation Guidance">
            <t>
                    TBD
            </t>
        </section>


    </middle>
    <back>
        <references title="Normative References">
            <?rfc include="reference.RFC.2119.xml"?>
            <?rfc include="reference.RFC.8174.xml"?>
            <?rfc include="reference.RFC.4271.xml"?>
        </references>
        <references title="Informative References">
            <?rfc include="reference.I-D.ietf-idr-bgp-model.xml"?>
            <?rfc include="reference.RFC.7908.xml"?>
            <reference anchor="RIPE77" target="https://ripe77.ripe.net/wp-content/uploads/presentations/59-RIPE77_Snijders_Routing_Policy_Architecture.pdf">
                <front>
                    <title>Robust Routing Policy Architecture</title>
                    <author surname="Snijders" fullname="Job Snijders">
                        <organization>NTT Ltd.</organization>
                    </author>
                    <date month="May" year="2018"/>
                </front>
            </reference>
        </references>
    </back>
</rfc>
