RFC 8253

PCEPS: Usage of TLS to Provide a Secure Transport for the Path Computation Element Communication Protocol (PCEP)

๐Ÿ“… published October 2017, from ietf

PCEPS: Usage of TLS to Provide a Secure Transport for the Path Computation Element Communication Protocol (PCEP) ๐ŸŽ€

The Title Block ๐Ÿ“‹

  • RFC number: 8253
  • Authors: D. Lopez and O. Gonzalez de Dios (both from Telefonica I+D), plus Q. Wu and D. Dhody (both from Huawei)
  • Category: Standards Track
  • ISSN: 2070-1721
  • Date: October 2017
  • Updates: RFC 5440 (only for the PCEP initialization phase, more on that in the Abstract)
  • Obsoletes: nothing is listed

Abstract โœจ

okay so PCEP (the Path Computation Element Communication Protocol) is the thing that lets a Path Computation Client (PCC) and a Path Computation Element (PCE) talk to each other, or lets PCEs talk to each other. this doc is all about PCEPS, which is just a fancy name for using Transport Layer Security (TLS) to make PCEP's transport secure ๐Ÿ”. the extra security comes from the transport protocol that PCEP runs over, so PCEP stays just as flexible and extensible as it was, no cap ๐Ÿ’….

this doc also updates RFC 5440 when it comes to the PCEP initialization phase procedures ๐Ÿฆ‹

Status of This Memo ๐ŸŒธ

This is an Internet Standards Track document.

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc8253.

Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.

Table of Contents ๐Ÿ“š

1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   4
2.  Requirements Language . . . . . . . . . . . . . . . . . . . .   5
3.  Applying PCEPS  . . . . . . . . . . . . . . . . . . . . . . .   5
  3.1.  Overview  . . . . . . . . . . . . . . . . . . . . . . . .   5
  3.2.  Initiating TLS Procedures . . . . . . . . . . . . . . . .   5
  3.3.  The StartTLS Message  . . . . . . . . . . . . . . . . . .   8
  3.4.  TLS Connection Establishment  . . . . . . . . . . . . . .  13
  3.5.  Peer Identity . . . . . . . . . . . . . . . . . . . . . .  15
  3.6.  Connection Establishment Failure  . . . . . . . . . . . .  16
4.  Discovery Mechanisms  . . . . . . . . . . . . . . . . . . . .  16
  4.1.  DANE Applicability  . . . . . . . . . . . . . . . . . . .  17
5.  Backward Compatibility  . . . . . . . . . . . . . . . . . . .  17
6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  18
  6.1.  New PCEP Message  . . . . . . . . . . . . . . . . . . . .  18
  6.2.  New Error-Values  . . . . . . . . . . . . . . . . . . . .  19
7.  Security Considerations . . . . . . . . . . . . . . . . . . .  19
8.  Manageability Considerations  . . . . . . . . . . . . . . . .  20
  8.1.  Control of Function and Policy  . . . . . . . . . . . . .  20
  8.2.  Information and Data Models . . . . . . . . . . . . . . .  21
  8.3.  Liveness Detection and Monitoring . . . . . . . . . . . .  21
  8.4.  Verifying Correct Operations  . . . . . . . . . . . . . .  21
  8.5.  Requirements on Other Protocols . . . . . . . . . . . . .  22
  8.6.  Impact on Network Operation . . . . . . . . . . . . . . .  22
9.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  22
  9.1.  Normative References  . . . . . . . . . . . . . . . . . .  22
  9.2.  Informative References  . . . . . . . . . . . . . . . . .  23
Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .  25
Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  26

1. Introduction ๐ŸŒธ

okay so PCEP ([RFC5440]) is the protocol that sets up the mechanisms for PCCs and PCEs to chat, or for two PCEs to chat with each other ๐Ÿ’ฌ. these conversations include requests and replies that can be super critical for keeping a network running smoothly and allocating resources properly, so security is a key piece of the PCE infrastructure ๐Ÿ”ฅ. as PCE apps grow and the service patterns get more complicated, having a secure mode of operation becomes way more relevant โœจ.

the Security Considerations section of [RFC5440] goes through the threats to PCEP and what they could cause ๐Ÿ˜ญ. it also talks about a bunch of ways to protect PCEP from attacks, but it doesn't pick one specific option or explain how to apply it in depth ๐Ÿ™ˆ. then [RFC6952] points out how important it is to keep PCEP communication confidential, especially when the endpoints aren't in the same Autonomous System (AS). why? because if someone intercepts PCEP messages, they could leak sensitive info about computed paths and resources ๐Ÿ‘€.

Transport Layer Security (TLS) [RFC5246] seems like the most solid option out of everything mentioned in those docs ๐Ÿ”. it supports peer authentication, message encryption, and integrity. TLS also comes with well-known ways to handle key configuration and exchange, plus ways to do security checks on the results of PCE Discovery (PCED) procedures done through the Interior Gateway Protocol (IGP) [RFC5088] [RFC5089] ๐Ÿงš.

this doc describes a security container for carrying PCEP messages, so again, it doesn't affect PCEP's flexibility and extensibility ๐Ÿฆ‹.

here's what this doc covers: how to apply TLS to secure interactions with a PCE, including starting the TLS procedures, the TLS handshake mechanism, the TLS methods for peer authentication, the TLS ciphersuites that are applicable for data exchange, and how errors in the security checks get handled ๐Ÿ’…. from here on out, we're calling this use of TLS to secure PCEP "PCEPS" ๐ŸŽ€.

PCEP communications are described here through a PCC-PCE relationship. the PCE architecture also supports PCE-PCE communication, and that works by asking the PCE to take on the PCC role, as usual. so in this doc, "PCC" refers to a PCC or a PCE that starts the PCEP session and acts as the client ๐Ÿซถ.

2. Requirements Language ๐Ÿ’œ

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 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

3. Applying PCEPS ๐Ÿ“

3.1. Overview ๐Ÿงš

the steps for setting up a PCEPS session go like this ๐Ÿ‘‘:

  1. Establishment of a TCP connection.
  2. Initiation of the TLS procedures by the StartTLS message from PCE to PCC and from PCC to PCE.
  3. Negotiation and establishment of a TLS connection.
  4. Start exchange of PCEP messages as per [RFC5440].

this doc uses the standard StartTLS procedure in PCEP instead of a different port for the secured session ๐Ÿ’–. the reason is that this avoids asking for another port number just for PCEPS. StartTLS uses scarce port numbers more efficiently and makes PCEP simpler to configure ๐ŸŒˆ.

Implementations SHOULD follow the best practices and recommendations for using TLS, as per [RFC7525] โœจ.

it should be noted that this procedure updates what is defined in Sections 4.2.1 and 6.7 of [RFC5440] regarding the initialization phase and the processing of messages prior to the Open message. the details of processing, including backward compatibility, are discussed in the following sections ๐Ÿ™ˆ

next up: Section 3.2, "Initiating TLS Procedures," where the StartTLS handshake starts getting real ๐Ÿ‘€๐Ÿ”ฅ

3.2. Initiating TLS Procedures โœจ

okay so PCEP can run with TLS or without it, which means a PCEP speaker has to say whether it wants a TLS connection ๐Ÿ” bestie, this is where the StartTLS message comes in. This document defines it as a brand new PCEP message, so the PCEP session is secured via TLS from the very start ๐Ÿ’– that happens before any other PCEP message gets exchanged, including the Open message ๐Ÿ˜ญ this document also updates [RFC5440], which said the Open message had to be the first PCEP message ever, so it's a big plot twist ๐ŸŽ€ when TLS is in use, the StartTLS message goes first ๐ŸŒธ and a PCEP speaker that supports PCEPS MUST NOT start the OpenWait timer after TCP establishment. Instead it starts a StartTLSWait timer, as described in Section 3.3 ๐Ÿงš

the PCEP speaker MAY find out that its peer supports PCEPS, or it can be preconfigured to use PCEPS for a given peer (see Section 4 for more details) ๐Ÿ‘‘ but an existing PCEP session can't be upgraded to TLS midway through ๐Ÿ™ˆ so the session MUST be closed and re-established with TLS, following the procedure in this document. no shortcuts, periodt ๐Ÿ’…

the StartTLS message is a PCEP message that a PCC sends to a PCE, and a PCE sends to a PCC, to kick off the TLS procedure for PCEP โœจ the PCC starts using TLS by sending a StartTLS message ๐Ÿฆ‹ and the PCE says "yes, let's do TLS" by replying with its own StartTLS message ๐Ÿซถ if the PCE is set up to only do TLS, it MAY send its StartTLS message right away once TCP is up. otherwise it MUST wait and see whether the PCC's first message is an Open or a StartTLS message ๐Ÿ‘€ the TLS negotiation and establishment steps kick off once the PCEP speaker has both sent and received the StartTLS message. the Message-Type field in the PCEP common header for StartTLS is set to 13 ๐Ÿ“

once TCP is successfully established, the very first message from the PCC to the PCE, and from the PCE to the PCC, MUST be a StartTLS message for PCEPS ๐Ÿ’œ this is a major glow-up from [RFC5440], where the first PCEP message was the Open message ๐Ÿ˜ค

a PCEP speaker that gets a StartTLS message after some other PCEP exchange has already happened (sending or receiving any messages from either side) MUST treat it as an unexpected message ๐Ÿšซ it replies with a PCEP Error (PCErr) message with Error-Type set to 25 (PCEP StartTLS failure) and Error-value set to 1 (Reception of StartTLS after any PCEP exchange), and then it MUST close the TCP connection. yikes, main character drama ๐Ÿ’€

any message that shows up before the StartTLS or Open message MUST trigger a protocol error condition ๐Ÿšจ which causes a PCErr message with Error-Type set to 25 (PCEP StartTLS failure) and Error-value set to 2 (Reception of any other message apart from StartTLS, Open, or PCErr). then the speaker MUST close the TCP connection ๐Ÿฅฒ

if a PCEP speaker that doesn't support PCEPS gets a StartTLS message, it just follows the existing error mechanism in Section 6.2 of [RFC5440] (if the message shows up before an Open message) or Section 6.9 of [RFC5440] (if it's an unknown message) ๐Ÿงธ see Section 5 for more details โœจ

if a PCEP speaker that only supports PCEPS connections (that's a local policy thing ๐Ÿ”’) gets an Open message, it MUST treat it as an unexpected message ๐Ÿ™…โ€โ™€๏ธ it replies with a PCErr message with Error-Type set to 1 (PCEP session establishment failure) and Error-value set to 1 (reception of an invalid Open message or a non Open message), and then it MUST close the TCP connection. not it ๐Ÿ’…

if a PCC supports PCEPS and also allows non-PCEPS connections (local policy again ๐Ÿ’ญ), it MUST try PCEPS first by sending a StartTLS message. if it gets a PCErr message back from the PCE, it MAY retry without PCEPS by sending an Open message ๐ŸŒˆ if a PCE supports PCEPS and allows non-PCEPS connections (local policy, iykyk), it MUST wait to respond after TCP establishment, depending on what message it gets from the PCC ๐Ÿซง if that's a StartTLS message, the PCE MUST respond with its own StartTLS message and move on to the TLS establishment procedures described in this document ๐Ÿ” if it's an Open message, the PCE MUST respond with an Open message and move on to the PCEP session establishment procedure from [RFC5440] ๐Ÿฆ‹ and if a PCE only supports PCEPS connections (local policy), it MAY send a StartTLS message to the PCC without waiting for a StartTLS message from the PCC first ๐Ÿš€

โš ๏ธ if a PCEP speaker is unwilling or unable to negotiate TLS and gets a StartTLS message, it MUST return a PCErr message (in the clear) with Error-Type set to 25 (PCEP StartTLS failure) and Error-value set to one of the two options below. no vibes-based guessing here ๐Ÿ˜ค
  • 3 (Failure, connection without TLS is not possible) if it's not willing to exchange PCEP messages without the solicited TLS connection. In this case it MUST close the TCP session ๐Ÿšช
  • 4 (Failure, connection without TLS is possible) if it is willing to exchange PCEP messages without the solicited TLS connection. In this case it MUST also close the TCP session. The receiver MAY choose to try re-establishing the PCEP session without TLS next, and re-establishing the PCEP session without TLS SHOULD be limited to only one attempt ๐Ÿ”

if the PCEP speaker supports PCEPS and can establish a TLS connection, it MUST start the TLS connection negotiation and establishment steps described in Section 3.4 before the PCEP initialization procedure (see Section 4.2.1 of [RFC5440]) ๐ŸŽ€

after the StartTLS messages have been exchanged, if the TLS negotiation fails for some reason (for example, the mechanisms needed for certificate revocation checking aren't available), both peers MUST immediately close the connection ๐Ÿ›‘ no awkward lingering, bye bye ๐Ÿ‘‹

a PCEP speaker that doesn't support PCEPS just sends the Open message directly, as per [RFC5440] ๐Ÿง a PCEP speaker that does support PCEPS, but learned in the last exchange that its peer is willing to re-establish the session without TLS, MAY send the Open message directly too, as per [RFC5440] ๐ŸŒท and again, re-establishing the PCEP session without TLS SHOULD be limited to only one attempt โœจ

since TLS is asymmetric when it comes to connection establishment, it's important to know which PCEP peer plays which role ๐ŸŽญ the PCC SHALL act as the TLS client, and the PCE SHALL act as the TLS server, as per [RFC5246] ๐Ÿซถ

as recommended in [RFC7525] to avoid downgrade attacks ๐Ÿฅท, PCEP peers that support PCEPS SHOULD default to strict TLS configuration, which means not allowing non-TLS PCEP sessions to be established ๐Ÿ”’ PCEPS implementations MAY provide an option that lets the operator manually override strict TLS configuration and allow unsecured connections. if someone uses that override, it SHOULD trigger a warning about the security implications of permitting unsecured connections โš ๏ธ๐ŸŒธ

3.3. The StartTLS Message โœจ

okay so the StartTLS message is the thing that kicks off the TLS procedure for a PCEPS session between the PCEP peers ๐Ÿ’…. A PCEP speaker sends it to ask for TLS to be negotiated and set up for PCEP ๐Ÿ”. When a PCEP speaker has both sent and received a StartTLS message, it's ready to start negotiating and establishing TLS, and then it moves on to the steps in Section 3.4 ๐Ÿฆ‹.

The collision resolution procedures in [RFC5440] for exchanging Open messages MUST be applied by the PCEP peers during the exchange of StartTLS messages ๐Ÿ’œ. No skipping this one, bestie ๐Ÿ™ˆ.

Here's the format of a StartTLS message ๐ŸŽ€:

<StartTLS Message>::= <Common Header>

A StartTLS message MUST contain only the PCEP common header, with the Message-Type field set to 13 ๐Ÿ“. That's the whole message, no extras, no cap ๐Ÿงš.

Once the TCP connection is successfully established, the PCEP speaker MUST start a timer called the "StartTLSWait timer" โฐ. If that timer expires and the speaker has received neither a StartTLS message nor a PCErr/Open message (the PCErr/Open is for when something failed, or when the peer doesn't support PCEPS) ๐Ÿ˜ญ, then the PCEP speaker MUST send a PCErr message with Error-Type set to 25 (PCEP StartTLS failure) and Error-value set to 5 (No StartTLS message (nor PCErr/Open) before StartTLSWait timer expiry) ๐Ÿ’€. It MUST also release the TCP connection, and that's the end of that ๐Ÿฅ€. A RECOMMENDED value for the StartTLSWait timer is 60 seconds โญ. The value of the StartTLSWait timer MUST NOT be less than that of the OpenWait timer ๐Ÿ‘‘, so don't go lower than that, periodt.

The figures below show the different ways a PCC and a PCE can interact during PCEP session initialization, depending on whether they support the PCEPS capability ๐ŸŒˆ. Lowkey the best part of this whole section ๐Ÿซถ.

                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |
                    | StartTLS            |
                    | msg                 |
                    |-------              |
                    |       \   StartTLS  |
                    |        \  msg       |
                    |         \  ---------|
                    |          \/         |
                    |          /\         |
                    |         /  -------->|
                    |        /            |
                    |<------              |
                    |:::::::::TLS:::::::::|
                    |:::::Establishment:::|
                    |                     |
                    |                     |
                    |:::::::PCEP::::::::::|
                    |                     |

            Figure 1: Both PCEP speakers support PCEPS (strict)
                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |
                    | StartTLS            |
                    | msg                 |
                    |-------              |
                    |       \   StartTLS  |
                    |        \  msg       |
                    |         \  ---------|
                    |          \/         |
                    |          /\         |
                    |         /  -------->|
                    |        /            |
                    |<------              |
                    |:::::::::TLS:::::::::| TLS Establishment
                    |:::::Establishment:::| Failure; both
                    |                     | peers close
                                            the session

      Figure 2: Both PCEP speakers support PCEPS (strict) but cannot
                               establish TLS
                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |  Does not support
                    | StartTLS            |  PCEPS and thus
                    | msg                 |  sends Open
                    |-------              |
                    |       \   Open      |
                    |        \  msg       |
                    |         \  ---------|
                    |          \/         |
                    |          /\         |
                    |         /  -------->|
                    |        /            |
                    |<------              |
                    |                     |
                    |<--------------------| Send Error
                    |       PCErr         | Type=1,Value=1
                    |                     | (non-Open message
                    |<--------------------|  received)
                    |       Close         |
                    ///////// TCP /////////
                    //////re-establish/////
          Send Open | Open                |
          this time | msg                 |
                    |-------              |
                    |       \   Open      |
                    |        \  msg       |
                    |         \  ---------|
                    |          \/         |
                    |          /\         |
                    |         /  -------->|
                    |        /            |
                    |<------              |

     Figure 3: PCE does not support connection with PCEPS, whereas PCC
                 supports connection with or without PCEPS
                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |
                    | StartTLS            |
                    | msg                 | PCE waits
                    |-------------------->| for PCC and
                    |            StartTLS | responds with
                    |<--------------------| Start TLS
                    |                     |
                    |:::::::::TLS:::::::::|
                    |:::::Establishment:::|
                    |                     |
                    |                     |
                    |:::::::PCEP::::::::::|
                    |                     |

   Figure 4: Both PCEP speakers support connection with or without PCEPS
                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |
                    | StartTLS            |
                    | msg                 | PCE waits
                    |-------------------->| for PCC
                    |               PCErr |
                    |<--------------------| Send Error
                    |                     | Type=25,Value=3
                    |                     | (Failure, connection
                    |<--------------------|  without TLS is not
                    |       Close         |  possible)

      Figure 5: Both PCEP speakers support connection with or without
                PCEPS, but PCE cannot start TLS negotiation
                  +-+-+                 +-+-+
                  |PCC|                 |PCE|
                  +-+-+                 +-+-+
                    |                     |
                    | Open                |
                    | msg                 | PCE waits
                    |-------------------->| for PCC and
                    |                Open | responds with
                    |<--------------------| Open
                    |                     |
                    |:::::::PCEP::::::::::|
                    |                     |

   Figure 6: PCE supports connection with or without PCEPS, whereas PCC
                  does not support connection with PCEPS

3.4. TLS Connection Establishment โœจ

Okay so once the PCEP peers have agreed to do TLS, the connection setup SHALL go through these steps ๐Ÿ’…

  1. Immediately negotiate a TLS session according to [RFC5246]. These are the restrictions, bestie ๐ŸŽ€
    • Support for TLS v1.2 [RFC5246] or later is REQUIRED. No cap, this is the baseline ๐Ÿ‘‘
    • Support for certificate-based mutual authentication is REQUIRED. Both sides prove who they are ๐Ÿซถ
    • Negotiation of a ciphersuite providing for integrity protection is REQUIRED. Your data can't be secretly messed with ๐Ÿ”’
    • Negotiation of a ciphersuite providing for confidentiality is RECOMMENDED. Keeping things private is highkey the move ๐Ÿคซ
    • Support for and negotiation of compression is OPTIONAL. Totally your call ๐Ÿฆ‹
    • PCEPS implementations MUST, at a minimum, support negotiation of the TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 [RFC6460] and SHOULD support TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 as well. Implementations SHOULD support the NIST P-256 (secp256r1) curve [RFC4492]. On top of that, PCEPS implementations MUST support negotiation of the mandatory-to-implement ciphersuites required by the versions of TLS that they support from TLS 1.3 onwards. The ciphersuite lineup is giving main character energy ๐ŸŒˆ
  2. Peer authentication can be performed in any of the following two REQUIRED operation models. Two options, both essential ๐Ÿ’œ
    • TLS with X.509 certificates using Public-Key Infrastructure Exchange (PKIX) trust models:
      • Implementations MUST allow the configuration of a list of trusted Certification Authorities (CAs) for incoming connections. Make a guest list of who you trust ๐Ÿ“
      • Certificate validation MUST include the verification rules as per [RFC5280]. Check everything, periodt ๐Ÿ”
      • PCEPS implementations SHOULD incorporate revocation methods (Certificate Revocation List (CRL) downloading, Online Certificate Status Protocol (OCSP), etc.) according to the trusted CA policies. Revocation is the plot twist you want to be ready for ๐Ÿ˜ญ
      • Implementations SHOULD indicate their trusted CAs. For TLS 1.2, this is done using certificate_authorities on the server side (see Section 7.4.4 of [RFC5246]) and the TrustedAuthorities extension on the client side (see Section 6 of [RFC6066]). Say who you trust out loud ๐Ÿ“ฃ
      • Implementations MUST follow the rules and guidelines for peer validation as defined in [RFC6125]. If an expected DNS name or IP address for the peer is configured, then the implementations MUST check them against the values in the presented certificate. The DNS names and the IP addresses can be contained in the Common Name Identifier (CN-ID) [RFC6125] or the subjectAltName entries. For verification, only one of these entries is considered. The following precedence applies: for DNS name validation, DNS-ID [RFC6125] has precedence over CN-ID, and for IP address validation, subjectAltName:iPAddr has precedence over CN-ID. Precedence rules are a whole vibe ๐Ÿ’…
      • Implementations MAY allow the configuration of a set of additional properties of the certificate to check for a peer's authorization to communicate (e.g., a set of allowed values in URI-ID [RFC6125] or a set of allowed X.509 v3 Certificate Policies). The definitions of these properties are out of scope of this document. Extra checks are optional, and that's a whole different story ๐Ÿงš
    • TLS with X.509 certificates using certificate fingerprints: Implementations MUST allow the configuration of a list of certificates that are trusted to identify peers, identified via the fingerprint of certificate octets encoded by the Distinguished Encoding Rules (DER). Implementations MUST support SHA-256 as defined by [SHS] as the hash algorithm for the fingerprint, but a later revision may demand support for a stronger hash function. Fingerprints are the lowkey simple option, and SHA-256 is the baseline ๐Ÿ“
  3. Start exchanging PCEP messages. Time to chat ๐Ÿ’ฌ
    • Once the TLS connection has been successfully established, the PCEP speaker MUST start the OpenWait timer [RFC5440]; after the expiration of this timer, if no Open message has been received, the PCEP speaker sends a PCErr message and releases the TCP/TLS connection. If the Open message doesn't show up in time, it's a PCErr and a goodbye ๐Ÿ‘‹

3.5. Peer Identity ๐Ÿชช

Depending on the peer authentication method in use, PCEPS supports different operation modes to establish a peer's identity and whether it is entitled to perform requests or can be considered authoritative in its replies. PCEPS implementations SHOULD provide mechanisms for associating peer identities with different levels of access and/or authoritativeness, and they MUST provide a mechanism for establishing a default level for properly identified peers. Any connection established with a peer that cannot be properly identified SHALL be terminated before any PCEP exchange takes place. No mystery peers allowed, bestie ๐Ÿšซ

In TLS X.509 mode using fingerprints, a peer is uniquely identified by the fingerprint of the presented certificate. The fingerprint is basically the peer's ID card ๐Ÿชช

There are numerous trust models in PKIX environments, and it is beyond the scope of this document to define how a particular deployment determines whether a peer is trustworthy. Implementations that want to support a wide variety of trust models should expose as many details of the presented certificate to the administrator as possible so that the trust model can be implemented by the administrator. At least the following parameters of the X.509 certificate SHOULD be exposed:

  • Peer's IP Address
  • Peer's Fully Qualified Domain Name (FQDN)
  • Certificate Fingerprint
  • Issuer
  • Subject
  • All X.509 v3 Extended Key Usage
  • All X.509 v3 Subject Alternative Name
  • All X.509 v3 Certificate Policies

Note that the remote IP address used for the TCP session establishment is also exposed. Even the IP address spills the tea ๐Ÿซฃ

[RFC8232] specifies a Speaker Entity Identifier TLV (SPEAKER-ENTITY-ID) as an optional TLV that is included in the OPEN object. It contains a unique identifier for the node that does not change during the lifetime of the PCEP speaker. An implementation would thus expose the speaker entity identifier as part of the X.509 v3 certificate's subjectAltName:otherName, so that an implementation could use this identifier for the peer identification trust model. A permanent name tag, iconic ๐ŸŒธ

In addition, a PCC MAY apply the procedures described in "DNS-Based Authentication of Named Entities (DANE)" [RFC6698] to verify its peer identity when using DNS discovery. See Section 4.1 for further details. DANE is an optional extra layer, and it's giving extra verified ๐Ÿง


3.6. Connection Establishment Failure ๐Ÿ’€

In case the initial TLS negotiation or the peer identity check fails, according to the procedures listed in this document, both peers MUST immediately close the connection. If the handshake or the identity check flops, it's an instant ghost ๐Ÿ‘ป

The initiator SHOULD follow the procedure listed in [RFC5440] to retry session setup as per the exponential back-off session establishment retry procedure. Try again, but give it some space ๐ŸŒ™


4. Discovery Mechanisms ๐Ÿงญ

This document does not specify any discovery mechanism for support of PCEPS. [PCE-DISCOVERY-PCEPS-SUPPORT] and [PCE-DISCOVERY-DNS] make the following proposals:

  • A PCE can advertise its capability to support PCEPS using the IGP's advertisement mechanism of the PCED information. The PCE-CAP-FLAGS sub-TLV is an optional sub-TLV used to advertise PCE capabilities. It is present within the PCED sub-TLV carried by OSPF or IS-IS. [RFC5088] and [RFC5089] provide the description and processing rules for this sub-TLV when carried within OSPF and IS-IS, respectively. PCE capability bits are defined in [RFC5088]. A new capability flag bit for the PCE-CAP-FLAGS sub-TLV that can be announced as an attribute to distribute PCEP security support information is proposed in [PCE-DISCOVERY-PCEPS-SUPPORT]. IGP ads, but make it secure ๐Ÿ“ก
  • A PCE can advertise its capability to support PCEPS using DNS [PCE-DISCOVERY-DNS] by identifying the support of TLS. Put it in DNS and let the internet gossip ๐Ÿ—ฃ๏ธ

4.1. DANE Applicability ๐Ÿ”

DANE [RFC6698] defines a secure method to associate the certificate that is obtained from a TLS server with a domain name using DNS, i.e., using the TLSA DNS resource record (RR) to associate a TLS server certificate or public key with the domain name where the record is found, thus forming a "TLSA certificate association". The DNS information needs to be protected by DNS Security (DNSSEC). A PCC willing to apply DANE to verify server identity MUST conform to the rules defined in Section 4 of [RFC6698]. The implementation MUST support service certificate constraint (TLSA certificate usages type 1) with Matching type 1 (SHA2-256) as described in [RFC6698] and [RFC7671]. The server's domain name must be authorized separately, as TLSA does not provide any useful authorization guarantees. DANE only goes so far, so the name needs its own check ๐Ÿซ 

5. Backward Compatibility โœจ

Okay so this section is all about how PCEPS plays nice with older PCEP speakers ๐Ÿฆ‹ The big idea: the security container is built so it doesn't mess with implementations that don't speak PCEPS at all. Honestly, that's so iconic of them ๐Ÿ’…

A PCC that does not support PCEPS will send an Open message as the first message on TCP establishment. ๐ŸŒธ A PCE that only supports PCEPS will send a StartTLS message on TCP establishment. ๐Ÿซถ The PCC would consider the received StartTLS message as an error and behave according to the existing error mechanism of [RFC5440], i.e., it would send a PCErr message with Error-Type 1 (PCEP session establishment failure) and Error-value 1 (reception of an invalid Open message or a non Open message) and close the session. ๐Ÿ˜ญ

A PCC that support PCEPS will send a StartTLS message as the first message on TCP establishment. ๐ŸŽ€ A PCE that does not support PCEPS would consider receiving a StartTLS message as an error, respond with a PCErr message with Error-Type 1 (PCEP session establishment failure) and Error-value 1 (reception of an invalid Open message or a non Open message), and close the session. ๐Ÿ’€

If a StartTLS message is received at any other time by a PCEP speaker that does not implement PCEPS, it would consider it as an unknown message and would behave according to the existing error mechanism of [RFC5440], i.e., it would send a PCErr message with Error-Type 2 (Capability not supported) and close the session. ๐Ÿ™ˆ

An existing PCEP session cannot be upgraded to PCEPS; the session needs to be terminated and re-established as per the procedure described in this document. ๐Ÿงš During the incremental upgrade, the PCEP speaker SHOULD allow session establishment with and without TLS. Once both PCEP speakers are upgraded to support PCEPS, the PCEP session is re-established with TLS; otherwise, a PCEP session without TLS is set up. A redundant PCE MAY also be used during the incremental deployment to take over the PCE undergoing upgrade. Once the upgrade is completed, support for the unsecured version SHOULD be removed. ๐Ÿ‘‘

A PCE that accepts connections with or without PCEPS would respond based on the message received from the PCC. A PCC that supports connection with or without PCEPS would first attempt to connect with PCEPS, and in case of error, it MAY retry to establish connection without PCEPS. For successful TLS operations with PCEP, both PCEP peers in the network would need to be upgraded to support this document. ๐Ÿ“

Note that a PCEP implementation that supports PCEPS would respond with a PCErr message with Error-Type set to 25 (PCEP StartTLS failure) and Error-value set to 2 (Reception of any other message apart from StartTLS, Open, or PCErr) if any other message is sent before a StartTLS or Open message. If the sender of the invalid message is a PCEP implementation that does not support PCEPS, it will not be able to understand this error. A PCEPS implementation could also send the PCErr message as per [RFC5440] with Error-Type 1 (PCEP session establishment failure) and Error-value 1 (reception of an invalid Open message or a non Open message) before closing the session. ๐ŸŒˆ


6. IANA Considerations ๐ŸŽ€

6.1. New PCEP Message ๐Ÿฆ‹

The following new message type has been allocated within the "PCEP Messages" sub-registry of the "Path Computation Element Protocol (PCEP) Numbers" registry:

   Value      Description                    Reference
   -------------------------------------------------------
   13         StartTLS                       This document

6.2. New Error-Values ๐Ÿ’…

The following new error types and error values have been allocated within the "PCEP-ERROR Object Error Types and Values" sub-registry of the "Path Computation Element Protocol (PCEP) Numbers" registry:

   Error-Type   Meaning           Error-value             Reference
   ---------------------------------------------------------------------
    25          PCEP StartTLS     0: Unassigned            This document
                failure
                                  1: Reception of          This document
                                  StartTLS after
                                  any PCEP exchange

                                  2: Reception of          This document
                                  any other message
                                  apart from StartTLS,
                                  Open, or PCErr

                                  3: Failure, connection   This document
                                  without TLS is not
                                  possible

                                  4: Failure, connection   This document
                                  without TLS is
                                  possible

                                  5: No StartTLS message   This document
                                  (nor PCErr/Open)
                                  before StartTLSWait
                                  timer expiry

7. Security Considerations ๐Ÿ”ฅ

Okay bestie, this part is SERIOUS, so read it carefully ๐Ÿ™ˆ

While the application of TLS satisfies the requirement on confidentiality as well as fine-grained, policy-based peer authentication, there are security threats that it cannot address. It may be advisable to apply additional protection measures, in particular in what relates to attacks specifically addressed to forging the TCP connection underpinning TLS, especially in the case of long-lived connections. One of these measures is the application of the TCP Authentication Option (TCP-AO) [RFC5925], which is fully compatible with and deemed as complementary to TLS. The mechanisms to configure the requirements to use TCP-AO and other lower-layer protection measures with a particular peer are outside the scope of this document. โœจ

Since computational resources required by the TLS handshake and ciphersuite are higher than unencrypted TCP, clients connecting to a PCEPS server can more easily create high-load conditions, and a malicious client might create a denial-of-service attack more easily. ๐Ÿ˜ญ

Some TLS ciphersuites only provide integrity validation of their payload and provide no encryption; such ciphersuites SHOULD NOT be used by default. Administrators MAY allow the usage of these ciphersuites after careful weighting of the risk of relevant internal data leakage that can occur in such a case, as explicitly stated by [RFC6952]. ๐Ÿซถ

When using certificate fingerprints to identify PCEPS peers, any two certificates that produce the same hash value will be considered the same peer. Therefore, it is important to make sure that the hash function used is cryptographically uncompromised, so that attackers are very unlikely to be able to produce a hash collision with a certificate of their choice. This document mandates support for SHA-256 as defined by [SHS], but a later revision may demand support for stronger functions if suitable attacks on it are known. ๐Ÿ”

PCEPS implementations that continue to accept connections without TLS are susceptible to downgrade attacks as described in [RFC7457]. An attacker could attempt to remove the use of StartTLS messages that request the use of TLS as it pass on the wire in clear and could also attempt to inject a PCErr message that suggests attempting PCEP connection without TLS. ๐Ÿ’€

The guidance given in [RFC7525] SHOULD be followed to avoid attacks on TLS. ๐ŸŒธ


8. Manageability Considerations ๐Ÿงš

All manageability requirements and considerations listed in [RFC5440] apply to PCEP protocol extensions defined in this document. In addition, requirements and considerations listed in this section apply. ๐Ÿ“

8.1. Control of Function and Policy ๐Ÿ‘‘

A PCE or PCC implementation SHOULD allow configuring the PCEP security via TLS capabilities as described in this document.

A PCE or PCC implementation supporting PCEP security via TLS MUST support general TLS configuration as per [RFC5246]. At least the configuration of one of the trust models and its corresponding parameters, as described in Sections 3.4 and 3.5, MUST be supported by the implementation. ๐ŸŽ€

A PCEPS implementation SHOULD allow configuring the StartTLSWait timer value.

PCEPS implementations MAY provide an option to allow the operator to manually override strict TLS configuration and allow unsecure connections. Execution of this override SHOULD trigger a warning about the security implications of permitting unsecure connections. โš ๏ธ

Further, the operator needs to develop suitable security policies around PCEP within his network. The PCEP peers SHOULD provide ways for the operator to complete the following tasks in regards to a PCEP session:

  • Determine if a session is protected via PCEPS.
  • Determine the version of TLS, the mechanism used for authentication, and the ciphersuite in use.
  • Determine if the certificate could not be verified and the reason for this circumstance.
  • Inspect the certificate offered by the PCEP peer.
  • Be warned if the StartTLS procedure fails for the PCEP peers that are known to support PCEPS via configurations or capability advertisements. ๐Ÿฆ‹

8.2. Information and Data Models ๐ŸŒˆ

The PCEP MIB module is defined in [RFC7420]. The MIB module could be extended to include the ability to view the PCEPS capability, TLS-related information, and the TLS status for each PCEP peer.

Further, to allow the operator to configure the PCEPS capability and various TLS-related parameters as well as to view the current TLS status for a PCEP session, the PCEP YANG module [PCEP-YANG] is extended to include TLS-related information. ๐Ÿ’œ

8.3. Liveness Detection and Monitoring ๐Ÿ’–

Mechanisms defined in this document do not imply any new liveness detection and monitoring requirements in addition to those already listed in [RFC5440] and [RFC5246].

8.4. Verifying Correct Operations โญ

A PCEPS implementation SHOULD log error events and provide PCEPS failure statistics with reasons.

8.5. Requirements on Other Protocols ๐Ÿงš

Mechanisms defined in this document do not imply any new requirements on other protocols. Note that Section 4 lists possible discovery mechanisms for support of PCEPS. ๐Ÿซถ

8.6. Impact on Network Operation ๐Ÿ“

Mechanisms defined in this document do not have any significant impact on network operations in addition to those already listed in [RFC5440] and on the policy and management implications discussed above. ๐ŸŒธ


9. References ๐Ÿ“š

9.1. Normative References ๐Ÿ“š

Okay bestie, the references are the receipts ๐Ÿงพโœจ Here are the normative ones, the stuff you need to read before this spec makes sense:


9.2. Informative References ๐Ÿ’ก

These ones are the extra reading, the "ooh, tell me more" pile ๐Ÿ“–:

  • [PCE-DISCOVERY-DNS] Wu, Q., Dhody, D., King, D., Lopez, D., and J. Tantsura, "Path Computation Element (PCE) Discovery using Domain Name System(DNS)", Work in Progress, draft-wu-pce-dns-pce-discovery-10, March 2017. ๐Ÿ”ญ
  • [PCE-DISCOVERY-PCEPS-SUPPORT] Lopez, D., Wu, Q., Dhody, D., Wang, Z., and D. King, "IGP extension for PCEP security capability support in the PCE discovery", Work in Progress, draft-wu-pce-discovery-pceps-support-07, March 2017. ๐Ÿ›ฐ๏ธ
  • [PCEP-YANG] Dhody, D., Hardwick, J., Beeram, V., and J. Tantsura, "A YANG Data Model for Path Computation Element Communications Protocol (PCEP)", Work in Progress, draft-ietf-pce-pcep-yang-05, July 2017. ๐Ÿ—‚๏ธ
  • [RFC4492] Blake-Wilson, S., Bolyard, N., Gupta, V., Hawk, C., and B. Moeller, "Elliptic Curve Cryptography (ECC) Cipher Suites for Transport Layer Security (TLS)", RFC 4492, DOI 10.17487/RFC4492, May 2006, https://www.rfc-editor.org/info/rfc4492. โœจ
  • [RFC4513] Harrison, R., Ed., "Lightweight Directory Access Protocol (LDAP): Authentication Methods and Security Mechanisms", RFC 4513, DOI 10.17487/RFC4513, June 2006, https://www.rfc-editor.org/info/rfc4513. ๐Ÿ—๏ธ
  • [RFC5088] Le Roux, JL., Ed., Vasseur, JP., Ed., Ikejiri, Y., and R. Zhang, "OSPF Protocol Extensions for Path Computation Element (PCE) Discovery", RFC 5088, DOI 10.17487/RFC5088, January 2008, https://www.rfc-editor.org/info/rfc5088. ๐Ÿฃ
  • [RFC5089] Le Roux, JL., Ed., Vasseur, JP., Ed., Ikejiri, Y., and R. Zhang, "IS-IS Protocol Extensions for Path Computation Element (PCE) Discovery", RFC 5089, DOI 10.17487/RFC5089, January 2008, https://www.rfc-editor.org/info/rfc5089. ๐Ÿงฉ
  • [RFC5925] Touch, J., Mankin, A., and R. Bonica, "The TCP Authentication Option", RFC 5925, DOI 10.17487/RFC5925, June 2010, https://www.rfc-editor.org/info/rfc5925. ๐Ÿ›ก๏ธ
  • [RFC6460] Salter, M. and R. Housley, "Suite B Profile for Transport Layer Security (TLS)", RFC 6460, DOI 10.17487/RFC6460, January 2012, https://www.rfc-editor.org/info/rfc6460. ๐Ÿ’Ž
  • [RFC6614] Winter, S., McCauley, M., Venaas, S., and K. Wierenga, "Transport Layer Security (TLS) Encryption for RADIUS", RFC 6614, DOI 10.17487/RFC6614, May 2012, https://www.rfc-editor.org/info/rfc6614. ๐Ÿ”’
  • [RFC6952] Jethanandani, M., Patel, K., and L. Zheng, "Analysis of BGP, LDP, PCEP, and MSDP Issues According to the Keying and Authentication for Routing Protocols (KARP) Design Guide", RFC 6952, DOI 10.17487/RFC6952, May 2013, https://www.rfc-editor.org/info/rfc6952. ๐Ÿ”
  • [RFC7420] Koushik, A., Stephan, E., Zhao, Q., King, D., and J. Hardwick, "Path Computation Element Communication Protocol (PCEP) Management Information Base (MIB) Module", RFC 7420, DOI 10.17487/RFC7420, December 2014, https://www.rfc-editor.org/info/rfc7420. ๐Ÿ“Š
  • [RFC7457] Sheffer, Y., Holz, R., and P. Saint-Andre, "Summarizing Known Attacks on Transport Layer Security (TLS) and Datagram TLS (DTLS)", RFC 7457, DOI 10.17487/RFC7457, February 2015, https://www.rfc-editor.org/info/rfc7457. ๐Ÿ’€ (the attack roundup, so scary but so useful)
  • [RFC8232] Crabbe, E., Minei, I., Medved, J., Varga, R., Zhang, X., and D. Dhody, "Optimizations of Label Switched Path State Synchronization Procedures for a Stateful PCE", RFC 8232, DOI 10.17487/RFC8232, September 2017, https://www.rfc-editor.org/info/rfc8232. ๐ŸŽฏ

Acknowledgements ๐Ÿซถ

Okay the shoutouts are my favourite part, so let's go ๐Ÿ’–

This spec leans on the analysis and profiling of TLS in [RFC6614], plus the StartTLS procedures described in [RFC4513]. Huge thanks to Joe Touch for the suggestions and support on the StartTLS stuff ๐Ÿ™Œ

Thanks to Daniel King for nudging the authors about manageability considerations โœจ

Thanks to Cyril Margaria for shepherding this document ๐ŸŽ€

Thanks to David Mandelberg for the early SECDIR review comments, and for sticking around for more review during IETF last call ๐Ÿ”

Thanks to Dan Frost for the RTGDIR review and comments ๐Ÿ›ค๏ธ

Thanks to Dale Worley for the Gen-ART review and comments ๐Ÿงต

Thanks to Tianran Zhou for the OPSDIR review ๐ŸŒท

Thanks to Deborah Brungard for being the responsible AD and guiding the authors as needed ๐Ÿ‘‘

And also, thanks to Mirja Kuhlewind, Eric Rescorla, Warren Kumari, Kathleen Moriarty, Suresh Krishnan, Ben Campbell, and Alexey Melnikov for the IESG review and comments. The whole squad showed up ๐Ÿฅน๐Ÿ’…


Authors' Addresses ๐Ÿ“ฎ

Here's how to reach the authors, bestie:

Diego R. Lopez
Telefonica I+D
Don Ramon de la Cruz, 82
Madrid  28006
Spain

Phone: +34 913 129 041
Email: diego.r.lopez@telefonica.com
Oscar Gonzalez de Dios
Telefonica I+D
Don Ramon de la Cruz, 82
Madrid  28006
Spain

Phone: +34 913 129 041
Email: oscar.gonzalezdedios@telefonica.com
Qin Wu
Huawei
101 Software Avenue, Yuhua District
Nanjing, Jiangsu  210012
China

Email: sunseawq@huawei.com
Dhruv Dhody
Huawei
Divyashree Techno Park, Whitefield
Bangalore, KA  560066
India

Email: dhruv.ietf@gmail.com

That's the whole RFC, periodt ๐ŸŒˆ๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from