diff --git a/draft-wirtgen-bgp-tls.md b/draft-wirtgen-bgp-tls.md index d6c7ee4..3bcf2f3 100644 --- a/draft-wirtgen-bgp-tls.md +++ b/draft-wirtgen-bgp-tls.md @@ -53,6 +53,7 @@ normative: informative: I-D.retana-idr-bgp-quic: + I-D.ietf-idr-bgp-model: RFC4272: RFC5082: RFC9000: @@ -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 diff --git a/ietf-bgp-tls@2026-11-02.yang b/ietf-bgp-tls@2026-11-02.yang new file mode 100644 index 0000000..de1f438 --- /dev/null +++ b/ietf-bgp-tls@2026-11-02.yang @@ -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; + } + } +}