<?xml version='1.0' encoding='UTF-8'?>
<?xml-model href="rfc7991bis.rnc"?>

<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>

<rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="exp" docName="draft-ietf-bfd-optimizing-authentication-36" number="9985" updates="" obsoletes="" ipr="trust200902" submissionType="IETF" consensus="true" tocInclude="true" tocDepth="3" symRefs="true" sortRefs="true" version="3" xml:lang="en">

  <front>
    <title abbrev="BFD Authentication Optimization">Optimizing Bidirectional Forwarding Detection (BFD)
    Authentication</title>
    <seriesInfo name="RFC" value="9985"/>
    <author fullname="Mahesh Jethanandani" initials="M." surname="Jethanandani">
      <organization>Arrcus</organization>
      <address>
        <postal>
          <country>United States of America</country>
        </postal>
        <email>mjethanandani@gmail.com</email>
      </address>
    </author>
    <author fullname="Ashesh Mishra" initials="A." surname="Mishra">
      <organization>Aalyria Technologies</organization>
      <address>
        <email>ashesh@aalyria.com</email>
      </address>
    </author>
    <author fullname="Jeffrey Haas" initials="J." surname="Haas">
      <organization>HPE</organization>
      <address>
        <email>jeffrey.haas@hpe.com</email>
      </address>
    </author>
    <author fullname="Ankur Saxena" initials="A." surname="Saxena">
      <organization>Ciena Corporation</organization>
      <address>
        <postal>
          <street>3939 N 1st Street</street>
          <city>San Jose</city>
          <region>CA</region>
          <code>95134</code>
          <country>United States of America</country>
        </postal>
        <email>ankurpsaxena@gmail.com</email>
      </address>
    </author>
    <author fullname="Manav Bhatia" initials="M." surname="Bhatia">
      <organization>Google</organization>
      <address>
        <postal>
          <street>Bagmane Capital Park</street>
          <city>Bengaluru</city>
	  <region>Karnataka</region>
          <code>560048</code>
          <country>India</country>
        </postal>
        <email>mnvbhatia@google.com</email>
      </address>
    </author>
    <date year="2026" month="June"/>
    <area>RTG</area>
    <workgroup>bfd</workgroup>

    <keyword>BFD</keyword>
    <keyword>authentication</keyword>

    <abstract>
      <t>
	This document describes an experimental optimization to Bidirectional Forwarding Detection (BFD) Authentication.
	This optimization enables BFD to scale better when there is a desire to
	use authentication where applying the same authentication mechanism to
	every BFD Control Packet may adversely impact performance.
	This optimization partitions BFD Authentication into a more
	computationally intensive (MCI) mechanism that is applied to BFD significant
	changes and a less computationally intensive (LCI) mechanism that is applied to the
	majority of BFD Control Packets.
      </t>
    </abstract>
  </front>
  <middle>
    <section anchor="introduction">
      <name>Introduction</name>
      <t><xref target="RFC5880">BFD</xref> authentication procedures, when enabled,
      authenticate each control packet using the same authentication mechanism.
      Devices implementing BFD are often resource-constrained and authentication
      may adversely impact the performance of BFD, thus discouraging the
      deployment of authentication.</t>
      <t>When implemented in software, BFD Authentication mechanisms compete
      with other necessary work done by the systems implementing the protocol.
      When implemented using hardware acceleration, these mechanisms may scale
      better situationally, but they still impose a cost on the implementation.
      BFD's value is tied to its ability to scale in terms of numbers of
      sessions and a Detection Time that relies on sending its control packets
      at a high rate.  Implementers and operators are forced to evaluate
      trade-offs of the benefits of authentication vs. its impact on BFD
      performance.</t>
      <t>The authentication mechanisms documented in <xref target="RFC5880"/>, 
      <xref target="RFC1321">MD5 Message-Digest Algorithm </xref>, and 
      <xref target="RFC3174">Secure Hash Algorithm (SHA-1)</xref> are not
      particularly strong in a cryptographic sense.  However, they may still not
      appropriately scale situationally in a given implementation.  In the
      future, there may be a desire to use stronger authentication mechanisms
      than those already specified, and those mechanisms are likely to use even
      more resources.</t>
      <t>The BFD protocol can broadly be described as the set of procedures
      that handle its state machine changes to reach the Up state, and once BFD
      is in the Up state, it will send those Up packets at the negotiated high rate.
      The number of BFD Control Packets needed to signal state changes (called
      significant changes) is very small, while the majority of the Control
      Packets validate that the session remains in the Up state.</t>
      <t>This document describes an experimental optimization to BFD
      Authentication.  This optimization partitions BFD Authentication into a
      more computationally intensive (MCI) mechanism used to authenticate
      significant changes, and a less computationally intensive (LCI) mechanism
      applied to the majority of the BFD Control Packets that don't signal such
      significant changes.</t>
      <t>The details of the motivation for experimental status are given in
      <xref target="experiment"/>.</t>
      <section>
        <name>Requirements Language</name>
        <t>
    The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
    NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
    "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
    described in BCP&nbsp;14 <xref target="RFC2119"/> <xref target="RFC8174"/> 
    when, and only when, they appear in all capitals, as shown here.
        </t>
      </section>
    </section>
    <section>
      <name>Terminology</name>
      <t>The following terms used in this document have been defined in
      <xref target="RFC5880">BFD</xref>.</t>
      <ul spacing="normal">
        <li>
          <t>Auth Type</t>
        </li>
        <li>
          <t>Detect Multiplier</t>
        </li>
        <li>
          <t>Detection Time</t>
        </li>
      </ul>
      <t>The following terms are introduced in this document.</t>
<dl>
<dt>significant change:</dt><dd>A state change, demand mode change (to D bit), or poll sequence change (P or F bit). Changes to BFD Control Packets that do not require a poll sequence, such as bfd.DetectMult, are also considered a significant change.</dd>
<dt>More Computationally Intensive (MCI) authentication:</dt><dd>The authentication mechanism applied to BFD Control Packets that are significant changes.</dd>
<dt>Less Computationally Intensive (LCI) authentication:</dt><dd>The authentication mechanism applied to BFD Control Packets that are NOT significant changes.</dd>
<dt>configured MCI reauthentication interval:</dt><dd>Interval at which BFD Control Packets are retried using MCI authentication.</dd></dl>
      <t>
        The authentication mechanisms described in this optimization are paired
	as MCI and LCI.  While it will be generally
	the case that the relationship between these mechanisms will be
	"stronger" and "less strong", this document doesn't use the term
	"strong" to avoid conflation with either mechanism's relative
	cryptographic strength.  The relative criteria for each mechanism is the
	impact on the implementation.
      </t>
    </section>
    <section anchor="strong_authentication">
      <name>BFD Control Packets That Require MCI Authentication</name>
      <t>
	The intention of these optimized procedures is to permit more
	computationally intensive
	authentication for BFD state changes and utilize the less
	computationally intensive authentication mechanisms to provide
	protection for the session in the Up state while performing less
	work overall.  Such procedures are intended to aid BFD session scaling
	without compromising BFD session security.
      </t>
      <t>All BFD Control Packets with the state AdminDown, Down, and Init
      <bcp14>MUST</bcp14> use MCI authentication.</t>
      <t>Once the BFD state machine has reached the Up state, it will continue
      to send BFD Control Packets with MCI authentication in the Up state for a period as discussed in
      <xref target="operations"/>.  If optimized authentication mechanisms are
      in use, as defined in <xref target="optimized_modes"/>, the session <bcp14>MAY</bcp14>
      switch to the LCI mode.</t>
      <t>The contents of an Up packet must not change aside from the
      Authentication Section unless MCI authentication is in use.</t>
      <section anchor="significant_changes">
        <name>Protecting BFD Significant Changes with MCI Authentication</name>
        <t>
	  This document proposes that BFD Control Packets that signal a
	  state change, a change in demand mode (D bit), or a poll sequence
	  (P or F bit change) be categorized as a "significant
	  change". Control packets that do not require a poll sequence,
	  such as bfd.DetectMult, are also considered a
	  significant change.
        </t>
        <t>
	  Such significant changes are intended to be protected by more
	  computationally intensive authentication.
        </t>
      </section>
    </section>
    <section anchor="optimized_type">
      <name>Using LCI Auth Types</name>
      <t>
	The majority of packets exchanged in a BFD session in the Up state are
	not significant changes.  This document proposes a new optimized
	authentication mode where packets that are not significant changes may
	use an LCI authentication mechanism.
      </t>
      <t>
	Once the session has reached the Up state, the session can
	use an LCI Auth Type derived from
	the format in <xref target="signaling"/>.
	Currently, this includes:

      </t>
      <ul>
        <li>
	    Meticulous Keyed ISAAC Authentication as described in
	    <xref target="RFC9986"/>.
            This authentication type protects the BFD session when BFD Up
            packets do not change, because only the paired devices know the
            shared secret, key, and sequence number to select the ISAAC
            result.
	  </li>
      </ul>
      <t>
        Other mechanisms may be defined in the future.
      </t>
    </section>
    <section>
      <name>Periodic MCI Reauthentication</name>
      <t>
        When using the LCI authentication
        mechanism, BFD should periodically test the session using the MCI
        authentication mechanism.  MCI authentication is tested using a
        Poll sequence. To test MCI authentication, a Poll sequence <bcp14>SHOULD</bcp14>
        be initiated by the sender using the MCI authentication mode rather    
than the LCI mechanism. If a control packet
        with the Final (F) bit is not received using MCI authentication
	within twice the Detect Interval as would be calculated by the
	receiving system, the session has been compromised, and it <bcp14>MUST</bcp14> be brought
	down.
      </t>
      <t>
        The value "twice the Detect interval as would be calculated by the
        receiving system" is, roughly, twice the number of packets the local
        system would transmit to the receiving system within its own Detect
        Interval.  This accommodates for possible packet loss from the sending
        system during the Poll sequence to the receiving system, plus time for
        the receiving system to transmit a control packet with the Final (F) bit
        set to the local system.
      </t>
      <t>
	This "MCI reauthentication interval" for
	performing such periodic tests using the MCI
	authentication mechanism can be configured depending on the capability
	of the system.
      </t>
      <t>
        Most packets transmitted in a BFD session are BFD Up packets.
        MCI authenticating a limited subset of these packets with a Poll
        sequence as described above, e.g., every one minute,
        significantly reduces the computational demand for the system
        while maintaining security of the session across the
        configured MCI reauthentication interval.
      </t>
    </section>
    <section anchor="optimized_modes">
      <name>Optimized Authentication Modes</name>
      <t>The cryptographic authentication mechanisms specified in <xref
      target="RFC5880" section="6.7">BFD</xref> describe enabling and
      disabling of authentication as a one-time operation. The following is stated in <xref target="RFC5880" section="6.7.1"/>:</t>

      <blockquote>... implementations using this method <bcp14>SHOULD</bcp14> only allow the
      authentication state to be changed at most once without some form of
      intervention (so that authentication cannot be turned on and off
      repeatedly simply based on the receipt of BFD Control Packets from remote
      systems).</blockquote>
      <t>Once enabled, every packet must have the Authentication Present (A) bit set and the
      associated Authentication Type appended (<xref target="RFC5880" section="4.1"/>).
      In addition, <xref target="RFC5880" section="6.7.1"/> states that an
      implementation <bcp14>SHOULD NOT</bcp14> allow the authentication state to be changed
      based on the receipt of a BFD Control Packet.</t>
      <t>
        This document proposes that an "optimized" authentication mode that
	permits both an MCI authentication mode and an LCI mode be used within the same BFD
	session.  This pairing of an MCI and an LCI mode of authentication is
	carried in new BFD Authentication types representing a given optimized
	authentication type pairing.
      </t>
      <t>
	This document defines which BFD Control Packets require MCI authentication in <xref target="significant_changes"/>.
	A BFD Control Packet that fails
	authentication, or a BFD Control Packet that was
	supposed to be MCI-authenticated but was not (e.g., a significant
	change packet), is discarded. However, there is no change to
	the state machine for BFD, as the decision of a significant
	change is still decided by how many valid consecutive packets
	were received.
      </t>
      <t>
	In this specification, the contents of an Up packet <bcp14>MUST NOT</bcp14> change
	aside from the Authentication Section without MCI
	authentication. The full procedure is documented in the following
	sections.
      </t>
    </section>
    <section anchor="signaling">
      <name>Signaling Optimized Authentication</name>
      <t>
        When the
	Authentication Present (A) bit is set and the Auth Type
	(<xref target="RFC5880" section="4.1" sectionFormat="comma"/>)
	is a type supporting Optimized BFD Authentication, the Auth Type signals a
	pairing of an MCI authentication type and an LCI authentication type.  This pairing is
	advertised in a single Auth Type value in order to permit
	implementations to be aware that:

      </t>
      <ul>
        <li>Optimized BFD procedures will be in use.</li>
        <li>The pairing of the MCI and LCI
              authentication mechanisms will be used for that session.</li>
	<li>There is a requirement to carry a Sequence Number.</li>
        <li>The current MCI or LCI mode will be carried as described below.</li>
      </ul>
      <figure>
        <name>Common Optimized BFD Authentication Section</name>
        <artwork align="center"><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|   Auth Type   |   Auth Len    |  Auth Key ID  |   Opt. Mode   |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Sequence Number                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                   Authentication Specific Data                ~
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+]]></artwork>
      </figure>
      <t>
        The values of Auth Type and Auth Len are defined in their respective
	Optimized BFD Authentication procedural documents.
      </t>
      <t>
        The values of the Optimized Authentication Mode field are:
      </t>
      <ol>
	  <li>The MCI authentication type for Optimized BFD Auth Types.</li>
        <li>The LCI authentication type for Optimized BFD Auth Types.</li>
      </ol>
      <t>
	Authentication Specific Data: When using the more computationally
	intensive authentication type, the remainder of the Authentication
	Section carries that type's data.
      </t>
      <section>
        <name>Transmitting and Receiving Using Optimized Authentication</name>
        <t>
	  The procedures for authenticating BFD Control Packets using Optimized
	  Authentication are similar to the existing procedures covered in 
	  <xref target="RFC5880" section="6.7"/>. 
          Optimized Authentication modes have common procedural requirements for 
	  authentication regardless of which more or less computationally
	  intensive authentication modes are used.
        </t>
        <t>
	  The required value of the Auth Len field for a given Optimized
	  Authentication mode is defined in the respective specifications for
	  their respective MCI and LCI modes.
        </t>
        <t>
          The following common procedures apply to authenticating BFD Control
          packets utilizing Optimized Authentication:
        </t>
<ul><li>
          If the received BFD Control Packet does not contain an 
	  Authentication Section (<xref target="RFC5880" sectionFormat="comma" section="4.1"/>), or
	  the Auth Type is not a supported Optimized Authentication Auth Type,
	  then the received packet <bcp14>MUST</bcp14> be discarded.
        </li>
        <li>
	  If the received BFD Control Packet contains an optimized
	  authentication type using these procedures and the Optimized
          Authentication Mode field is not 1 or 2, then the received packet
          <bcp14>MUST</bcp14> be discarded.
        </li>
        <li>
	  If bfd.SessionState is AdminDown, Down, or Init and the Optimized
	  Authentication Mode field is not 1, then the received packet <bcp14>MUST</bcp14> be
	  discarded.
        </li>
        <li>
	  If bfd.SessionState is Up and there is a significant change as defined
	  in <xref target="significant_changes"/>, and the Optimized Authentication
	  Mode field is not 1, then the received packet <bcp14>MUST</bcp14> be discarded.
        </li>
        <li>
          If the Auth Len field is not equal to a value appropriate for the
          Optimized Authentication Mode field, the packet <bcp14>MUST</bcp14> be discarded.
        </li>
        <li>
          If bfd.AuthSeqKnown is 1, examine the Sequence Number field. If the sequence number lies outside of the inclusive range of bfd.RcvAuthSeq+1 to bfd.RcvAuthSeq+(3*Detect Mult) when treated as an unsigned 32-bit circular number space, the received packet <bcp14>MUST</bcp14> be discarded.
        </li></ul>
        <t>
          Otherwise (bfd.AuthSeqKnown is 0), bfd.AuthSeqKnown <bcp14>MUST</bcp14> be set to 1,
          bfd.RcvAuthSeq <bcp14>MUST</bcp14> be set to the value of the received Sequence
          Number field, and the received packet <bcp14>MUST</bcp14> be accepted.
        </t>
        <t>
          For the specified Auth Type and Optimized Authentication Mode, perform
          the appropriate authentication procedures.  If authentication
          succeeds, the received packet <bcp14>MUST</bcp14> be accepted.  Otherwise, the
          received packet <bcp14>MUST</bcp14> be discarded.
        </t>
      </section>
      <section anchor="operations">
        <name>Optimized Authentication Operations</name>
        <t>
	  As noted in <xref target="significant_changes"/>,
	  when using Optimized BFD procedures, MCI
	  authentication is used in the BFD state machine to bring a BFD session
	  to the Up state or to make any change of the BFD parameters as carried
	  in the BFD Control Packet when in the Up state.
        </t>
        <t>
	  Once the BFD session has reached the Up state, the BFD Up state <bcp14>MUST</bcp14>
	  be signaled to the remote BFD system using the MCI authentication mode for
	  an interval that is at least the Detection Time before switching to
	  the LCI authentication mode.  This is to permit mechanisms such as 
	  <xref target="RFC9986">
	  Meticulous Keyed ISAAC for BFD Optimized Authentication</xref>
	  or other approved, less intensive authentication mechanisms to be
	  bootstrapped before switching to the LCI mode.
        </t>
        <t>
	  It is <bcp14>RECOMMENDED</bcp14> that when using optimized authentication that
	  implementations switch from MCI authentication to LCI
	  authentication mode after an interval that
	  is at least the Detection Time. In the circumstances where a BFD
	  session successfully reaches the Up state with MCI authentication,
	  but there are problems with the LCI authentication, this will
	  permit the remote system to tear down the session as quickly as
	  possible.
        </t>
        <t>
	  BFD sessions using optimized authentication that succeed in reaching the
	  Up state using MCI authentication and fail using LCI authentication
	  <bcp14>SHOULD</bcp14> bring the issue to the attention of the operator.  Furthermore,
	  implementations <bcp14>MAY</bcp14> wish to throttle session restarts.
        </t>
        <t>
	  It is further <bcp14>RECOMMENDED</bcp14> that BFD implementations using optimized
	  authentication defer notifying their client that the session has reached
	  the Up state until it has transitioned to using the LCI
	  authentication mode.  In the event where LCI authentication is
	  failing in the protocol, this avoids propagating the failed transitions
	  to the LCI mode to their clients.
        </t>
      </section>
    </section>
    <section anchor="opt-auth-yang-model">
      <name>Optimizing Authentication YANG Data Model</name>
      <section anchor="data-model-overview">
        <name>Data Model Overview</name>
        <t>
	  The <xref target="RFC7950">YANG 1.1</xref> data model defined in
	  this document augments the "ietf-bfd" module to add
	  data nodes relevant to the management of the feature defined in this
	  document. It adds an interval value that specifies how often the BFD
	  session should be reauthenticated using more computationally
	  intensive authentication once it is in the Up state.
        </t>
      </section>
      <section anchor="tree-diagram">
        <name>Tree Diagram</name>
        <t>
	  The tree diagram for the YANG modules defined in this
	  document uses annotations defined in <xref target="RFC8340">YANG Tree Diagrams</xref>.
        </t>
        <sourcecode type="yangtree">
module: ietf-bfd-opt-auth

  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bfd:bfd/bfd-ip-sh:ip-sh
            /bfd-ip-sh:sessions/bfd-ip-sh:session
            /bfd-ip-sh:authentication:
    +--rw reauth-interval?   uint32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bfd:bfd/bfd-ip-mh:ip-mh
            /bfd-ip-mh:session-groups/bfd-ip-mh:session-group
            /bfd-ip-mh:authentication:
    +--rw reauth-interval?   uint32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bfd:bfd/bfd-lag:lag
            /bfd-lag:sessions/bfd-lag:session/bfd-lag:authentication:
    +--rw reauth-interval?   uint32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bfd:bfd/bfd-mpls:mpls
            /bfd-mpls:session-groups/bfd-mpls:session-group
            /bfd-mpls:authentication:
    +--rw reauth-interval?   uint32</sourcecode>
      </section>
      <section anchor="the-yang-model">
        <name>The YANG Data Model</name>
        <t>
	  This YANG module imports modules defined in "<xref format="title" target="RFC8349"/>" <xref target="RFC8349"/> and "<xref format="title" target="RFC9314"/>" <xref target="RFC9314"/>.
        </t>
        <t>Implementations supporting the optimization procedures defined in this document enable optimization by using one of the newly defined key-chain crypto-algorithms in the ietf-bfd-met-keyed-isaac YANG module in <xref target="RFC9986"/>.</t>

        <sourcecode markers="true" name="ietf-bfd-opt-auth@2026-06-19.yang" type="yang"><![CDATA[
module ietf-bfd-opt-auth {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-bfd-opt-auth";
  prefix bfd-oa;

  import ietf-routing {
    prefix rt;
    reference
      "RFC 8349: A YANG Data Model for Routing Management
       (NMDA version).";
  }

  import ietf-bfd {
    prefix bfd;
    reference
      "RFC 9314: YANG Data Model for Bidirectional
       Forwarding Detection (BFD).";
  }

  import ietf-bfd-ip-sh {
    prefix bfd-ip-sh;
    reference
      "RFC 9314: YANG Data Model for Bidirectional
       Forwarding Detection (BFD).";
  }

  import ietf-bfd-ip-mh {
    prefix bfd-ip-mh;
    reference
      "RFC 9314: YANG Data Model for Bidirectional
       Forwarding Detection (BFD).";
  }

  import ietf-bfd-lag {
    prefix bfd-lag;
    reference
      "RFC 9314: YANG Data Model for Bidirectional
       Forwarding Detection (BFD).";
  }

  import ietf-bfd-mpls {
    prefix bfd-mpls;
    reference
      "RFC 9314: YANG Data Model for Bidirectional
       Forwarding Detection (BFD).";
  }

  organization
    "IETF Bidirectional Forwarding Detection (BFD) Working Group";

  contact
    "WG Web:   <http://tools.ietf.org/wg/bfd>
     WG List:  <rtg-bfd@ietf.org>

     Authors: Mahesh Jethanandani (mjethanandani@gmail.com)
              Ashesh Mishra (ashesh@aalyria.com)
              Ankur Saxena (ankurpsaxena@gmail.com)
              Manav Bhatia (mnvbhatia@google.com)
              Jeffrey Haas (jeffrey.haas@hpe.com).";
              
  description
    "This YANG module augments the base BFD YANG module to add
     attributes related to the experimental BFD Optimized
     Authentication.

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

     Copyright (c) 2026 IETF Trust and the persons identified as
     authors of the code.  All rights reserved.

     Redistribution and use in source and binary forms, with or
     without modification, is permitted pursuant to, and subject to
     the license terms contained in, the Revised BSD License set
     forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC 9985
     (https://www.rfc-editor.org/info/rfc9985); see the RFC itself
     for full legal notices.";

  revision "2026-06-19" {
    description
      "Initial Version.";
    reference
      "RFC 9985: Optimizing BFD Authentication.";
  }

  feature optimized-auth {
    description
      "Indicates that the implementation supports optimized
       authentication.";
    reference
      "RFC 9985: Optimizing BFD Authentication.";
  }

  grouping bfd-opt-auth-config {
    description
      "Grouping for BFD Optimized Authentication Parameters.";
    leaf reauth-interval {
      type uint32;
      units "seconds";
      default "60";
      description
        "Interval of time after which more computationally intensive
         authentication should be utilized to prevent an
         on-path-attacker attack.

         A value of zero means that we do not do periodic
         reauthentication using the more computationally intensive
         authentication method.

         This value SHOULD have jitter applied to it to avoid
         self-synchronization during expensive authentication
         operations.";
    }
  }

  augment "/rt:routing/rt:control-plane-protocols" 
        + "/rt:control-plane-protocol/bfd:bfd/bfd-ip-sh:ip-sh" 
        + "/bfd-ip-sh:sessions/bfd-ip-sh:session" 
        + "/bfd-ip-sh:authentication" {
    uses bfd-opt-auth-config;

    description
      "Augment the 'authentication' container for single-hop BFD
       module to add attributes related to BFD Optimized
       Authentication.";
  }

  augment "/rt:routing/rt:control-plane-protocols" 
        + "/rt:control-plane-protocol/bfd:bfd/bfd-ip-mh:ip-mh" 
        + "/bfd-ip-mh:session-groups/bfd-ip-mh:session-group" 
        + "/bfd-ip-mh:authentication" {
    uses bfd-opt-auth-config;

    description
      "Augment the 'authentication' container for multi-hop BFD
       module to add attributes related to BFD Optimized
       Authentication.";
  }

  augment "/rt:routing/rt:control-plane-protocols" 
        + "/rt:control-plane-protocol/bfd:bfd/bfd-lag:lag" 
        + "/bfd-lag:sessions/bfd-lag:session" 
        + "/bfd-lag:authentication" {
    uses bfd-opt-auth-config;

    description
      "Augment the 'authentication' container for BFD over LAG
       module to add attributes related to BFD Optimized
       Authentication.";
  }

  augment "/rt:routing/rt:control-plane-protocols" 
        + "/rt:control-plane-protocol/bfd:bfd/bfd-mpls:mpls" 
        + "/bfd-mpls:session-groups/bfd-mpls:session-group" 
        + "/bfd-mpls:authentication" {
    uses bfd-opt-auth-config;

    description
      "Augment the 'authentication' container for BFD over MPLS
       module to add attributes related to BFD Optimized
       Authentication.";
  }
}]]></sourcecode>
      </section>
    </section>
    <section anchor="IANA">
      <name>IANA Considerations</name>
      <t>
	IANA has assigned one URI and one YANG module as described in this section.
      </t>
      <section anchor="ietf-xml-registry">
        <name>IETF XML Registry</name>
        <t>
	  IANA has registered the following URI in the "ns"
	  registry within the "IETF XML Registry" group <xref target="RFC3688"/>:
        </t>

	<dl spacing="compact" newline="false">
	  <dt>URI:</dt><dd>urn:ietf:params:xml:ns:yang:ietf-bfd-opt-auth</dd>
	  <dt>Registrant Contact:</dt><dd>The IESG</dd>
	  <dt>XML:</dt><dd>N/A; the requested URI is an XML namespace.</dd>
	</dl>

      </section>
      <section anchor="yang-module-names">
        <name>The YANG Module Names Registry</name>
        <t>
	  IANA has registered the following YANG module in the "YANG Module
	  Names" registry <xref target="RFC6020"/> within the "YANG Parameters" registry group:
        </t>

	<dl spacing="compact" newline="false">
	  <dt>Name:</dt><dd>ietf-bfd-opt-auth</dd>
	  <dt>Maintained by IANA:</dt><dd>N</dd>
	  <dt>Namespace:</dt><dd>urn:ietf:params:xml:ns:yang:ietf-bfd-opt-auth</dd>
	  <dt>Prefix:</dt><dd>bfd-oa</dd>
	  <dt>Reference:</dt><dd>RFC 9985</dd>
	</dl>

      </section>
    </section>
    <section anchor="Security">
      <name>Security Considerations</name>
      <section anchor="Protocol_Security">
        <name>Protocol Security Considerations</name>
        <t>
	  Devices implementing BFD are often resource-constrained, whether in a
	  single session or a multidimensional set of scaled sessions.
	  Desired detection intervals for the BFD sessions, and their number,
	  are common scaling considerations for BFD implementations.  Security
	  mechanisms also impact the performance of implementations, whether in
	  software or hardware, due to the use of additional computational
	  resources these mechanisms use.
        </t>
        <t>
	  The optimized procedures in this document provide a different level of
	  resistance to attack than methods using a single authentication
	  mechanism:
        </t>
        <ul>
          <li>
	      The MCI authentication mechanisms used
	      for optimized authentication are expected to have similar
	      cryptographic strength acceptable for BFD for authenticating the
	      entire session, as described in <xref target="RFC5880"/>.
	    </li>
          <li>
	      When the BFD state machine is attempting to move from the Down
	      state to the Up state, the MCI
	      authentication mechanism is intended to protect vs. attempt to
	      inappropriately start BFD sessions.
	    </li>
          <li>
	      When the BFD state machine is in the Up state, the MCI authentication mechanism is intended to
	      protect vs. attempt to change BFD session parameters or to reset
	      the BFD session.
	    </li>
          <li>
When the BFD state machine is in the Up state, the LCI authentication mechanism is intended to provide resistance to keeping a BFD session in the Up state inappropriately. Since the procedures for changing BFD state require utilizing the MCI mechanism, and the LCI mechanism requires that the contents of the Control Packet in the Up state remain unchanged, the only thing that successfully spoofing such packets can do is keep the session Up.
	    </li>
          <li>
	      The periodic, MCI reauthentication
	      procedure provides protection against long-term successful
	      spoofing of the LCI authentication
	      mechanism.
	    </li>
        </ul>
        <t>
	  In other words, the intention of Optimized BFD procedures is to make
	  it difficult to reset or inappropriately start BFD sessions.  However,
	  protecting against keeping the session Up is seen as a less
	  interesting attack and can receive less protection.
        </t>
        <t>The recent escalating series of attacks on MD5
	and SHA-1 described in <xref target="SHA-1-attack1">Finding Collisions
	in the Full SHA-1 </xref> and <xref target="SHA-1-attack2">New Collision
	Search for SHA-1 </xref> raise concerns about their remaining useful
	lifetime as outlined in <xref target="RFC6151">Updated Security
	Considerations for the MD5 Message-Digest and the HMAC-MD5 Algorithm
          </xref> and <xref target="RFC6194">Security Considerations for the SHA-0
	and SHA-1 Message-Digest Algorithm </xref>. If replaced by stronger
	algorithms, the computational overhead will make the task of
	authenticating every packet even more difficult to achieve.</t>
        <t>The procedures described in this document provide a mechanism that
	could enable implementations to leverage stronger security to address
	the concerns above when strong authentication is required.  
  However,
	this requires operators to evaluate the trade-offs of the less
	computationally intensive mechanisms to adequately address their desired
	security stance.</t>
        <t>Keys generated and distributed out of band for the purposes described
	in this specification are generally limited in the security they can
	provide. It is essential that these keys are selected well and
	protected when stored.</t>
      </section>
      <section anchor="YANG_Security">
        <name>YANG Security Considerations</name>
        <t>
	  This section is modeled after the template described in <xref section="3.7.1" target="RFC9907"/>.
        </t>
        <t>
	  The "ietf-bfd-opt-auth" YANG module defines a data model that
	  is designed to be accessed via YANG-based management protocols, such
	  as the Network Configuration Protocol (NETCONF) <xref target="RFC6241"/> and RESTCONF <xref target="RFC8040"/>.
	  These YANG-based management protocols (1) have to use a secure
	  transport layer (e.g., Secure Shell (SSH) <xref target="RFC4252"/>,
          TLS <xref target="RFC8446"/>, and QUIC <xref target="RFC9000"/>)
	  and (2) have to use mutual authentication.
        </t>
        <t>
	  The Network Configuration Access Control Model (NACM)
	  <xref target="RFC8341"/> provides the means to restrict
	  access for particular NETCONF or RESTCONF users to a preconfigured
	  subset of all available NETCONF or RESTCONF protocol operations and
	  content.
        </t>
        <t>
	  There are a number of data nodes defined in this YANG module that are
	  writable/creatable/deletable (i.e., "config true", which is the
	  default).  All writable data nodes are likely to be sensitive or
	  vulnerable in some network environments.  Write operations (e.g.,
	  edit-config) and delete operations to these data nodes without proper
	  protection or authentication can have a negative effect on network
	  operations.  The following subtrees and data nodes have particular
	  sensitivities/vulnerabilities:
        </t>
        <ul>
          <li>
	    'reauth-interval' specifies the interval in Up state, after
	    which MCI authentication <bcp14>SHOULD</bcp14> be
	    performed to prevent a Person-in-the-Middle (PITM) attack. If this
	    interval is set very low, the utility of these optimization
	    procedures is lessened. If this interval is set very high, attacks
	    detected by the MCI authentication
	    mechanisms may happen overly late.
	  </li>
        </ul>
        <t>
	  There are no particularly sensitive readable data nodes.
        </t>
        <t>
	  There are no RPC operations defined in this model.
        </t>
      </section>
    </section>

  </middle>
  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3688.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5880.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6020.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7950.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8349.xml"/>
	<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8341.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9314.xml"/>
      </references>
      <references>
        <name>Informative References</name>
        <reference anchor="SHA-1-attack1">
          <front>
            <title>Finding Collisions in the Full SHA-1</title>
            <author initials="X." surname="Wang">
              <organization/>
            </author>
            <author initials="Y." surname="Yin">
              <organization/>
	    </author>
            <author initials="H." surname="Yu">
              <organization/>
	    </author>
            <date year="2005"/>
          </front>
          <refcontent>Advances in Cryptology - CRYPTO 2005, Lecture Notes in Computer Science, vol. 3621, pp. 17-36</refcontent>
          <seriesInfo name="DOI" value="10.1007/11535218_2"/>
        </reference>

        <reference anchor="SHA-1-attack2" target="https://csrc.nist.gov/csrc/media/events/first-cryptographic-hash-workshop/documents/wang_sha1-new-result.pdf">
          <front>
            <title>Cryptanalysis on SHA-1</title>
            <author initials="X." surname="Wang">
              <organization/>
            </author>
            <author initials="A." surname="Yao">
              <organization/>
	    </author>
            <author initials="F." surname="Yao">
              <organization/>
            </author>
            <date year="2005"/>
          </front>
        </reference>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.1321.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2026.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3174.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6151.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6194.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8340.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4252.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6241.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8040.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8446.xml"/>
	<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8792.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9000.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9907.xml"/>


<reference anchor="RFC9986" target="https://www.rfc-editor.org/info/rfc9986">
<front>
<title>
Meticulous Keyed ISAAC for Bidirectional Forwarding Detection (BFD) Optimized Authentication
</title>
<author fullname="Alan DeKok" initials="A." surname="DeKok">
<organization>InkBridge Networks</organization>
</author>
<author fullname="Mahesh Jethanandani" initials="M." surname="Jethanandani">
<organization>Kloud Services</organization>
</author>
<author fullname="Sonal Agarwal" initials="S." surname="Agarwal">
<organization>Cisco Systems, Inc</organization>
</author>
<author fullname="Ashesh Mishra" initials="A." surname="Mishra">
<organization>Aalyria Technologies</organization>
</author>
<author fullname="Jeffrey Haas" initials="J." surname="Haas">
<organization>HPE</organization>
</author>
<date month="June" year="2026"/>
</front>
<seriesInfo name="RFC" value="9986"/>
</reference>
      </references>
    </references>
    <section anchor="examples">
      <name>Examples</name>
      <t>
	This section tries to show some examples in how the model can
	be configured.
      </t>
      <section anchor="example-a.1.1">
        <name>Single-Hop BFD Configuration</name>
        <t>
          This example demonstrates how a single-hop BFD session can
          be configured for optimized authentication. Note that line wrapping is used per <xref target="RFC8792"/>.
        </t>
        <sourcecode type="xml"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ===============

<?xml version="1.0" encoding="UTF-8"?>
<key-chains
    xmlns="urn:ietf:params:xml:ns:yang:ietf-key-chain"
    xmlns:opt-auth="urn:ietf:params:xml:ns:yang:ietf-bfd-opt-auth"
    xmlns:bfd-mki="urn:ietf:params:xml:ns:yang:ietf-bfd-met-keyed-i\
saac">
  <key-chain>
    <name>bfd-auth-config</name>
    <description>"An example for BFD Optimized Auth configuration."\
</description>
    <key>
      <key-id>55</key-id>
      <lifetime>
        <send-lifetime>
          <start-date-time>2017-01-01T00:00:00Z</start-date-time>
          <end-date-time>2017-02-01T00:00:00Z</end-date-time>
        </send-lifetime>
        <accept-lifetime>
          <start-date-time>2016-12-31T23:59:55Z</start-date-time>
          <end-date-time>2017-02-01T00:00:05Z</end-date-time>
        </accept-lifetime>
      </lifetime>
      <crypto-algorithm>bfd-mki:optimized-sha1-meticulous-keyed-isa\
ac</crypto-algorithm>
      <key-string>
        <keystring>testvector</keystring>
      </key-string>
    </key>
  </key-chain>
</key-chains>
<interfaces
    xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces"
    xmlns:if-type="urn:ietf:params:xml:ns:yang:iana-if-type">
  <interface>
    <name>eth0</name>
    <type>if-type:ethernetCsmacd</type>
  </interface>
</interfaces>
<routing
    xmlns="urn:ietf:params:xml:ns:yang:ietf-routing"
    xmlns:bfd-types="urn:ietf:params:xml:ns:yang:ietf-bfd-types"
    xmlns:iana-bfd-types="urn:ietf:params:xml:ns:yang:iana-bfd-type\
s"
    xmlns:opt-auth="urn:ietf:params:xml:ns:yang:ietf-bfd-opt-auth"
    xmlns:bfd-mki="urn:ietf:params:xml:ns:yang:ietf-bfd-met-keyed-i\
saac">
  <control-plane-protocols>
    <control-plane-protocol>
      <type>bfd-types:bfdv1</type>
      <name>name:BFD</name>
      <bfd xmlns="urn:ietf:params:xml:ns:yang:ietf-bfd">
        <ip-sh xmlns="urn:ietf:params:xml:ns:yang:ietf-bfd-ip-sh">
          <sessions>
            <session>
              <interface>eth0</interface>
              <dest-addr>2001:db8:0:113::101</dest-addr>
              <desired-min-tx-interval>10000</desired-min-tx-interv\
al>
              <required-min-rx-interval>
                10000
              </required-min-rx-interval>
              <authentication>
                <key-chain>bfd-auth-config</key-chain>
                <opt-auth:reauth-interval>30</opt-auth:reauth-inter\
val>
              </authentication>
            </session>
          </sessions>
        </ip-sh>
      </bfd>
    </control-plane-protocol>
  </control-plane-protocols>
</routing>]]></sourcecode>
      </section>
    </section>
    <section anchor="experiment">
      <name>Experimental Status</name>
      <t>
	This document describes an experiment that presents a candidate
	solution to update BFD Authentication that is currently specified in
	<xref target="RFC5880"/>.  This experiment is intended to
	provide additional insights into what happens when the
	optimized authentication mechanism defined in this document is
	used. Here are the reasons why this document is on the Experimental track:
      </t>
      <ul spacing="normal">
        <li>
          <t>
	  In the initial stages of the document, there were significant
	  participation and reviews from the working group.  
   Since then, there have been considerable changes to the document,
   such as the use of ISAAC, the allowance for ISAAC bootstrapping
   when a BFD session comes up, and the use of a single Auth Type to
   indicate optimized authentication. These changes did not get significant review from the working
	  group and therefore do not meet the bar set in 
	  <xref target="RFC2026" section="4.1.1"/>.
          </t>
        </li>
        <li>
          <t>
	  There are no known implementations at this time.
          </t>
        </li>
        <li>
          <t>
	  The work in this document could become very valuable in the future,
	  especially if the need for deploying BFD Authentication at scale
	  becomes a reality.
          </t>
        </li>
      </ul>
      <t>
	This document is classified as Experimental and is not part of
	the IETF Standards Track. Implementations based on this
	document should not be considered as compliant with <xref target="RFC5880">BFD</xref>.
      </t>
    </section>


    <section numbered="false">
      <name>Acknowledgments</name>
      <t>The authors would like to thank <contact fullname="Qiufang Ma"/>,
      <contact fullname="Stephen Farrell"/>, and <contact fullname="Acee
      Lindem"/> for providing directorate reviews of this document.</t>
    </section>

    <section anchor="contributors" numbered="false">
      <name>Contributors</name>
      <t>
	The authors of this document would like to acknowledge <contact
	fullname="Reshad Rahman"/> as a contributor to this document.
      </t>
    </section>
  </back>
</rfc>
