Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions draft-wirtgen-bgp-tls.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ normative:

informative:
I-D.retana-idr-bgp-quic:
I-D.ietf-idr-bgp-model:
RFC4272:
RFC5082:
RFC9000:
Expand Down Expand Up @@ -403,6 +404,27 @@ Implementations supporting the "tls-preferred" mode SHOULD provide
configurable timeout behavior for TLS establishment prior to fallback
to TCP-AO-protected BGP transport.

# YANG Module for BGP over TLS

This document defines a YANG module for BGP transport sessions over TLS.
It is an augmentation of the BGP base model {{I-D.ietf-idr-bgp-model}}.

## BGP over TLS Model Tree

module: ietf-bgp-tls

augment /rt:routing/rt:control-plane-protocols/rt:control-plane-protocol
/bgp:bgp/bgp:neighbors/bgp:neighbor/bgp:transport:
+--rw tls!
+---u tls-params

## BGP over TLS YANG Module

~~~~ yang
{::include ietf-bgp-tls@2026-11-02.yang}
~~~~
{: sourcecode-markers="true" sourcecode-name="ietf-bgp-tls@2026-11-02.yang"}

# Security Considerations

This document improves the security of BGP sessions, as the information
Expand Down
82 changes: 82 additions & 0 deletions ietf-bgp-tls@2026-11-02.yang
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
module ietf-bgp-tls {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-bgp-tls";

prefix holo-bgp-tls;

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

import ietf-bgp {
prefix bgp;
}

organization
"IETF IDR Working Group";

contact
"Author: Nicolas Rybowski (nicolas.rybowski at uclouvain.be)";

description
"This module describes a YANG model for BGP over TLS session configuration.";

revision 2026-11-02 {
description
"Initial revision.";
reference
"I-D.wirtgen-bgp-tls-05";
}

grouping tls-params {
description
"Parameters to configure a single TLS session.";

leaf cert {
type string;
description
"The TLS certificate to use when establishing a BGP over TLS session.";
mandatory true;
}
leaf pkey {
type string;
description
"The private key associated with the TLS certificate used for the
the BGP over TLS session establishment.";
mandatory true;
}
leaf ca-chain {
type string;
description
"The Certificate Authority (CA) chain to use when validating the peer
TLS certificate.";
mandatory true;
}
leaf sni {
type string;
description
"The Server Name Indication (SNI) of the remote BGP over TLS peer.";
mandatory true;
}
}

augment "/rt:routing/rt:control-plane-protocols/rt:control-plane-protocol/" +
"bgp:bgp/bgp:neighbors/bgp:neighbor/bgp:transport" {
when "derived-from-or-self(../../../../rt:type, 'bgp:bgp')" {
description
"Only valid if routing protocol instance type is 'bgp'.";
}
container tls {
description
"TLS session parameters for the BGP neighbor.";

presence
"The BGP transport session MUST use TLS.";

uses tls-params;
}
}
}
Loading