<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="3"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<rfc category="std" docName="draft-ietf-opsawg-mud-tls-18" ipr="trust200902">
  <front>
    <title abbrev="MUD (D)TLS Profile for IoT devices">Manufacturer Usage
    Description (MUD) (D)TLS Profiles for IoT Devices</title>

    <author fullname="Tirumaleswar Reddy" initials="T." surname="Reddy">
      <organization>Nokia</organization>

      <address>
        <postal>
          <street></street>

          <country>India</country>
        </postal>

        <email>kondtir@gmail.com</email>
      </address>
    </author>

    <author fullname="Dan Wing" initials="D." surname="Wing">
      <organization abbrev="Citrix">Citrix Systems, Inc.</organization>

      <address>
        <postal>
          <street>4988 Great America Pkwy</street>

          <city>Santa Clara</city>

          <region>CA</region>

          <code>95054</code>

          <country>USA</country>
        </postal>

        <email>danwing@gmail.com</email>
      </address>
    </author>

    <author fullname="Blake Anderson" initials="B." surname="Anderson">
      <organization abbrev="Cisco">Cisco Systems, Inc.</organization>

      <address>
        <postal>
          <street>170 West Tasman Dr</street>

          <city>San Jose</city>

          <region>CA</region>

          <code>95134</code>

          <country>USA</country>
        </postal>

        <email>blake.anderson@cisco.com</email>
      </address>
    </author>

    <date />

    <workgroup>OPSAWG WG</workgroup>

    <abstract>
      <t>This memo extends the Manufacturer Usage Description (MUD)
      specification to allow manufacturers to define (D)TLS profile
      parameters. This allows a network security service to identify
      unexpected (D)TLS usage, which can indicate the presence of unauthorized
      software, malware, or security policy-violating traffic on an
      endpoint.</t>
    </abstract>
  </front>

  <middle>
    <section anchor="intro" title="Introduction">
      <t>Encryption is necessary to enhance the privacy of end users using IoT
      devices. TLS <xref target="RFC8446"></xref> and DTLS <xref
      target="RFC9147"></xref> are the dominant protocols (counting all (D)TLS
      versions) providing encryption for IoT device traffic. Unfortunately, in
      conjunction with IoT applications' rise of encryption, malware authors
      are also using encryption which thwarts network-based analysis such as
      deep packet inspection (DPI). Other mechanisms are thus needed to help
      detect malware running on an IoT device.</t>

      <t>Malware often reuses certain libraries, and there are notable
      differences in how malware uses encryption compared to non-malware.
      Several common patterns in the use of (D)TLS by malware include: <list
          style="symbols">
          <t>Use of older and weaker cryptographic parameters.</t>

          <t>TLS server name indication (SNI) extension <xref
          target="RFC6066"></xref> and server certificates are composed of
          subjects with characteristics of a domain generation algorithm (DGA)
          (e.g., 'www.33mhwt2j.net').</t>

          <t>Higher use of self-signed certificates compared with typical
          legitimate software using certificates from a CA trusted by the
          device.</t>

          <t>Discrepancies in the SNI TLS extension and the DNS names in the
          SubjectAltName (SAN) X.509 extension in the server certificate
          message.</t>

          <t>Discrepancies in the key exchange algorithm and the client public
          key length in comparison with legitimate flows. As a reminder, the
          Client Key Exchange message has been removed from TLS 1.3.</t>

          <t>Lower diversity in TLS client advertised extensions compared to
          legitimate clients.</t>

          <t>Using privacy enhancing technologies like Tor, Psiphon, Ultrasurf
          (see <xref target="malware-tls"></xref>), and evasion techniques
          such as ClientHello randomization.</t>

          <t>Using an alternative DNS server (via encrypted transport) to
          avoid detection by malware DNS filtering services <xref
          target="malware-doh"></xref>. Specifically, malware may not use the
          Do53 or encrypted DNS server provided by the local network (DHCP,
          DNR <xref target="RFC9462"></xref> or DDR <xref
          target="RFC9462"></xref>).</t>
        </list></t>

      <t>If (D)TLS profile parameters are defined, the following functions are
      possible which have a positive impact on the local network security:</t>

      <t><list style="symbols">
          <t>Permit intended DTLS or TLS use and block malicious DTLS or TLS
          use. This is superior to the layers 3 and 4 Access Control Lists
          (ACLs) of Manufacturer Usage Description Specification (MUD) <xref
          target="RFC8520"></xref> which are not suitable for broad
          communication patterns. The goal of this document is to enhance and
          complement the existing MUD specifications, rather than to undermine
          them.</t>

          <t>Ensure TLS certificates are valid. Several TLS deployments have
          been vulnerable to active Man-In-The-Middle (MITM) attacks because
          of the lack of certificate validation or vulnerability in the
          certificate validation function (see <xref
          target="cryto-vulnerability"></xref>). By observing (D)TLS profile
          parameters, a network element can detect when the TLS SNI mismatches
          the SubjectAltName and when the server's certificate is invalid. In
          (D)TLS 1.2 <xref target="RFC5246"></xref><xref
          target="RFC6347"></xref>, the ClientHello, ServerHello and
          Certificate messages are all sent in clear-text. This check is not
          possible with (D)TLS 1.3, which encrypts the Certificate message
          thereby hiding the server identity from any intermediary. In (D)TLS
          1.3, the server certificate validation functions should be executed
          within an on-path (D)TLS proxy, if such a proxy exists.</t>

          <t>Support new communication patterns. An IoT device can learn a new
          capability, and the new capability can change the way the IoT device
          communicates with other devices located in the local network and
          Internet. There would be an inaccurate policy if an IoT device
          rapidly changes the IP addresses and domain names it communicates
          with while the MUD ACLs were slower to update (see <xref
          target="clear-as-mud"></xref>). In such a case, observable (D)TLS
          profile parameters can be used to permit intended use and to block
          malicious behavior from the IoT device.</t>
        </list></t>

      <t>The YANG module specified in <xref target="YANG2"></xref> of this
      document is an extension of YANG Data Model for Network Access Control
      Lists (ACLs) <xref target="RFC8519"></xref> to enhance MUD <xref
      target="RFC8520"></xref> to model observable (D)TLS profile parameters.
      Using these (D)TLS profile parameters, an active MUD-enforcing network
      security service (e.g., firewall) can identify MUD non-compliant (D)TLS
      behavior indicating outdated cryptography or malware. This detection can
      prevent malware downloads, block access to malicious domains, enforce
      use of strong ciphers, stop data exfiltration, etc. In addition,
      organizations may have policies around acceptable ciphers and
      certificates for the websites the IoT devices connect to. Examples
      include no use of old and less secure versions of TLS, no use of
      self-signed certificates, deny-list or accept-list of Certificate
      Authorities, valid certificate expiration time, etc. These policies can
      be enforced by observing the (D)TLS profile parameters. Network security
      services can use the IoT device's (D)TLS profile parameters to identify
      legitimate flows by observing (D)TLS sessions, and can make inferences
      to permit legitimate flows and to block malicious or insecure flows.
      Additionally, it supports network communications adherence to security
      policies by ensuring that TLS certificates are valid and deprecated
      cipher suites are avoided. The proposed technique is also suitable in
      deployments where decryption techniques are not ideal due to privacy
      concerns, non-cooperating end-points, and expense.</t>
    </section>

    <section anchor="notation" title="Terminology">
      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
      "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
      "OPTIONAL" in this document are to be interpreted as described in BCP 14
      <xref target="RFC2119"></xref><xref target="RFC8174"></xref> when, and
      only when, they appear in all capitals, as shown here.</t>

      <t>"(D)TLS" is used for statements that apply to both Transport Layer
      Security <xref target="RFC8446"></xref> and Datagram Transport Layer
      Security <xref target="RFC6347"></xref>. Specific terms "TLS" and "DTLS"
      are used for any statement that applies to either protocol alone.</t>

      <t>'DoH/DoT' refers to DNS-over-HTTPS and/or DNS-over-TLS <xref
      target="RFC7858"></xref>.</t>

      <t>Middlebox: A middlebox that interacts with TLS traffic can either act
      as a TLS proxy, intercepting and decrypting the traffic for inspection,
      or inspect the traffic between TLS peers without terminating the TLS
      session.</t>

      <t>Endpoint Security Agent: An Endpoint Security Agent is a software
      installed on endpoint devices that protects them from security threats.
      It provides features such as malware protection, firewall, and intrusion
      prevention to ensure the device's security and integrity.</t>

      <t>Network Security Service: A Network Security Service refers to a set
      of mechanisms designed to protect network communications and resources
      from attacks.</t>
    </section>

    <section title="Overview of MUD (D)TLS profiles for IoT devices">
      <t>In Enterprise networks, protection and detection are typically done
      both on end hosts and in the network. Endpoint security agents have deep
      visibility on the devices where they are installed, whereas the network
      has broader visibility. Installing endpoint security agents may not be a
      viable option on IoT devices, and network security service is an
      efficient means to protect such IoT devices. If the IoT device supports
      a MUD (D)TLS profile, the (D)TLS profile parameters of the IoT device
      can be used by a middlebox to detect and block malware communication,
      while at the same time preserving the privacy of legitimate uses of
      encryption. In addition, it enforces organizational security policies,
      ensuring that devices comply. By monitoring (D)TLS parameters, network
      administrators can identify and mitigate the use of outdated TLS
      versions, cryptographic algorithms and non-compliant certificates. The
      middlebox need not proxy (D)TLS but can passively observe the parameters
      of (D)TLS handshakes from IoT devices and gain visibility into TLS 1.2
      parameters and partial visibility into TLS 1.3 parameters.</t>

      <t>Malicious agents can try to use the (D)TLS profile parameters of
      legitimate agents to evade detection, but it becomes a challenge to
      mimic the behavior of various IoT device types and IoT device models
      from several manufacturers. In other words, malware developers will have
      to develop malicious agents per IoT device type, manufacturer and model,
      infect the device with the tailored malware agent and will have keep up
      with updates to the device's (D)TLS profile parameters over time.
      Furthermore, the malware's command and control server certificates need
      to be signed by the same certifying authorities trusted by the IoT
      devices. Typically, IoT devices have an infrastructure that supports a
      rapid deployment of updates, and malware agents will have a
      near-impossible task of similarly deploying updates and continuing to
      mimic the TLS behavior of the IoT device it has infected.</t>

      <t>However, if the IoT device has reached end-of-life and the IoT
      manufacturer will not issue a firmware or software update to the IoT
      device or will not update the MUD file, the "is-supported" attribute
      defined in Section 3.6 of <xref target="RFC8520"></xref> can be used by
      the MUD manager to identify the IoT manufacturer no longer supports the
      device. The end-of-life (EOL) of a device, where the IoT manufacturer no
      longer supports it, does not necessarily mean the device is defective.
      Instead, it signifies that the device is no longer receiving updates,
      support, or security patches, which necessitates replacement and
      upgrading to next-generation devices to ensure continued functionality,
      security, and compatibility with modern networks. The network security
      service will have to rely on other techniques discussed in <xref
      target="Security"></xref> to identify malicious connections until the
      device is replaced.</t>

      <t>Compromised IoT devices are typically used for launching DDoS attacks
      (Section 3 of <xref target="RFC8576"></xref>). For example, DDoS attacks
      like Slowloris <xref target="slowloris"></xref> and Transport Layer
      Security (TLS) re-negotiation can be blocked if the victim's server
      certificate is not be signed by the same certifying authorities trusted
      by the IoT device.</t>
    </section>

    <section title="(D)TLS 1.3 Handshake">
      <t>In (D)TLS 1.3, full (D)TLS handshake inspection is not possible since
      all (D)TLS handshake messages excluding the ClientHello message are
      encrypted. (D)TLS 1.3 has introduced new extensions in the handshake
      record layers called Encrypted Extensions. Using these extensions
      handshake messages will be encrypted and network security services (such
      as a firewall) are incapable of deciphering the handshake, and thus
      cannot view the server certificate. However, the ClientHello and
      ServerHello still have some fields visible, such as the list of
      supported versions, named groups, cipher suites, signature algorithms
      and extensions in ClientHello, and chosen cipher in the ServerHello. For
      instance, if the malware uses evasion techniques like ClientHello
      randomization, the observable list of cipher suites and extensions
      offered by the malware agent in the ClientHello message will not match
      the list of cipher suites and extensions offered by the legitimate
      client in the ClientHello message, and the middlebox can block malicious
      flows without acting as a (D)TLS 1.3 proxy.</t>

      <section anchor="full" title="Full (D)TLS 1.3 Handshake Inspection">
        <t>To obtain more visibility into negotiated TLS 1.3 parameters, a
        middlebox can act as a (D)TLS 1.3 proxy. A middlebox can act as a
        (D)TLS proxy for the IoT devices owned and managed by the IT team in
        the Enterprise network and the (D)TLS proxy must meet the security and
        privacy requirements of the organization. In other words, the scope of
        middlebox acting as a (D)TLS proxy is restricted to Enterprise network
        owning and managing the IoT devices. The middlebox would have to
        follow the behaviour detailed in Section 9.3 of <xref
        target="RFC8446"></xref> to act as a compliant (D)TLS 1.3 proxy.</t>

        <t>To further increase privacy, Encrypted Client Hello (ECH) extension
        <xref target="I-D.ietf-tls-esni"></xref> prevents passive observation
        of the TLS Server Name Indication extension and other potentially
        sensitive fields, such as the ALPN <xref target="RFC7301"></xref>. To
        effectively provide that privacy protection, ECH extension needs to be
        used in conjunction with DNS encryption (e.g., DoH). A middlebox
        (e.g., firewall) passively inspecting ECH extension cannot observe the
        encrypted SNI nor observe the encrypted DNS traffic. The middlebox
        acting as a (D)TLS 1.3 proxy that does not support ECH extension will
        act as if connecting to the public name and it follows the behaviour
        discussed in Section 6.1.6 of <xref target="I-D.ietf-tls-esni"></xref>
        to securely signal the client to disable ECH.</t>
      </section>

      <section title="Encrypted DNS">
        <t>A common usage pattern for certain type of IoT devices (e.g., light
        bulb) is for it to "call home" to a service that resides on the public
        Internet, where that service is referenced through a domain name (A or
        AAAA record). As discussed in Manufacturer Usage Description
        Specification <xref target="RFC8520"></xref>, because these devices
        tend to require access to very few sites, all other access should be
        considered suspect. This technique complements MUD policy enforcement
        at the TLS level by ensuring that DNS queries are monitored and
        filtered, thereby enhancing overall security. If an IoT device is
        pre-configured to use a DNS resolver not signaled by the network, the
        MUD policy enforcement point is moved to that resolver, which cannot
        enforce the MUD policy based on domain names (Section 8 of <xref
        target="RFC8520"></xref>). If the DNS query is not accessible for
        inspection, it becomes quite difficult for the infrastructure to
        detect any issues. Therefore, the use of a DNS resolver that is not
        signaled by the network is generally incompatible with MUD. A
        network-designated DoH/DoT server is necessary to allow MUD policy
        enforcement on the local network, for example, using the techniques
        specified in DNR<xref target="RFC9463"> </xref> and DDR <xref
        target="RFC9462"></xref>.</t>
      </section>
    </section>

    <section anchor="YANG" title="(D)TLS Profile of a IoT device">
      <t>This document specifies a YANG module for representing (D)TLS
      profile. This YANG module provides a means to characterize the (D)TLS
      traffic profile of a device. Network security services can use these
      profiles to permit conformant traffic or to deny traffic from devices
      that deviates from it. This module uses the cryptographic types defined
      in <xref target="I-D.ietf-netconf-crypto-types"></xref>. See <xref
      target="RFC7925"></xref> for (D)TLS 1.2 and <xref
      target="I-D.ietf-uta-tls13-iot-profile"></xref> for DTLS 1.3
      recommendations related to IoT devices, and <xref
      target="RFC9325"></xref> for additional (D)TLS 1.2 recommendations.</t>

      <t>A companion YANG module is defined to include a collection of (D)TLS
      parameters and (D)TLS versions maintained by IANA: "iana-tls-profile"
      (<xref target="yang-iana"></xref>).</t>

      <t>The (D)TLS parameters in each (D)TLS profile include the
      following:<list style="symbols">
          <t>Profile name</t>

          <t>(D)TLS versions supported by the IoT device.</t>

          <t>List of supported cipher suites (Section 11 of <xref
          target="RFC8446"></xref>). For (D)TLS1.2, <xref
          target="RFC7925"></xref> recommends AEAD ciphers for IoT
          devices.</t>

          <t>List of supported extension types</t>

          <t>List of trust anchor certificates used by the IoT device. If the
          server certificate is signed by one of the trust anchors, the
          middlebox continues with the connection as normal. Otherwise, the
          middlebox will react as if the server certificate validation has
          failed and takes appropriate action (e.g, block the (D)TLS session).
          An IoT device can use a private trust anchor to validate a server's
          certificate (e.g., the private trust anchor can be preloaded at
          manufacturing time on the IoT device and the IoT device fetches the
          firmware image from the Firmware server whose certificate is signed
          by the private CA). This empowers the middlebox to reject TLS
          sessions to servers that the IoT device does not trust.</t>

          <t>List of pre-shared key exchange modes</t>

          <t>List of named groups (DHE or ECDHE) supported by the client</t>

          <t>List of signature algorithms the client can validate in X.509
          server certificates</t>

          <t>List of signature algorithms the client is willing to accept for
          CertificateVerify message (Section 4.2.3 of <xref
          target="RFC8446"></xref>). For example, a TLS client implementation
          can support different sets of algorithms for certificates and in TLS
          to signal the capabilities in "signature_algorithms_cert" and
          "signature_algorithms" extensions.</t>

          <t>List of supported application protocols (e.g., h3, h2, http/1.1
          etc.)</t>

          <t>List of certificate compression algorithms (defined in <xref
          target="RFC8879"></xref>)</t>

          <t>List of the distinguished names <xref target="X501"></xref> of
          acceptable certificate authorities, represented in DER-encoded
          format <xref target="X690"> </xref> (defined in Section 4.2.4 of
          <xref target="RFC8446"></xref>)</t>
        </list></t>

      <t><xref target="RFC8701">GREASE</xref> defines a mechanism for TLS
      peers to send random values on TLS parameters to ensure future
      extensibility of TLS extensions. Similar random values might be extended
      to other TLS parameters. Thus, the (D)TLS profile parameters defined in
      the YANG module by this document MUST NOT include the GREASE values for
      extension types, named groups, signature algorithms, (D)TLS versions,
      pre-shared key exchange modes, cipher suites and for any other TLS
      parameters defined in future RFCs.</t>

      <t>The (D)TLS profile does not include parameters like compression
      methods for data compression, <xref target="RFC9325"></xref> recommends
      disabling TLS-level compression to prevent compression-related attacks.
      In TLS 1.3, only the "null" compression method is allowed (Section 4.1.2
      of <xref target="RFC8446"></xref>).</t>

      <section title="Tree Structure of the (D)TLS profile Extension to the ACL YANG Model">
        <t>This document augments the "ietf-acl" ACL YANG module defined in
        <xref target="RFC8519"></xref> for signaling the IoT device (D)TLS
        profile. This document defines the YANG module "ietf-acl-tls". The
        meaning of the symbols in the YANG tree diagram are defined in <xref
        target="RFC8340"></xref> and it has the following tree structure:</t>

        <t><figure>
            <artwork><![CDATA[module: ietf-acl-tls
  augment /acl:acls/acl:acl/acl:aces/acl:ace/acl:matches:
    +--rw client-profiles {match-on-tls-dtls}?
       +--rw tls-dtls-profile* [name]
          +--rw name                           string
          +--rw supported-tls-version*        ianatp:tls-version
          +--rw supported-dtls-version*       ianatp:dtls-version
          +--rw cipher-suite*                 ianatp:cipher-algorithm
          +--rw extension-type*
          |       ianatp:extension-type
          +--rw accept-list-ta-cert*
          |       ct:trust-anchor-cert-cms
          +--rw psk-key-exchange-mode*
          |       ianatp:psk-key-exchange-mode
          |       {tls13 or dtls13}?
          +--rw supported-groups*
          |       ianatp:supported-group
          +--rw signature-algorithm-cert*
          |       ianatp:signature-algorithm
          |       {tls13 or dtls13}?
          +--rw signature-algorithm*
          |       ianatp:signature-algorithm
          +--rw application-protocol*
          |       ianatp:application-protocol
          +--rw cert-compression-algorithm*
          |       ianatp:cert-compression-algorithm
          |       {tls13 or dtls13}?
          +--rw certificate-authorities*
                  certificate-authority
                  {tls13 or dtls13}?

]]></artwork>
          </figure></t>
      </section>

      <section anchor="YANG2"
               title="The (D)TLS profile Extension to the ACL YANG Model">
        <t><figure>
            <artwork><![CDATA[<CODE BEGINS> file "ietf-acl-tls@2024-01-23.yang"
module ietf-acl-tls {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-acl-tls";
  prefix acl-tls;

  import iana-tls-profile {
    prefix ianatp;
    reference
      "RFC XXXX: Manufacturer Usage Description (MUD) (D)TLS
                 Profiles for IoT Devices";
  }
  import ietf-crypto-types {
    prefix ct;
    reference
      "draft-ietf-netconf-crypto-types: YANG Data Types and Groupings 
            for Cryptography";
  }
  import ietf-access-control-list {
    prefix acl;
    reference
      "RFC 8519: YANG Data Model for Network Access
                 Control Lists (ACLs)";
  }

  organization
    "IETF OPSAWG (Operations and Management Area Working Group)";
  contact
    "WG Web: <https://datatracker.ietf.org/wg/opsawg/>
     WG List: opsawg@ietf.org

      Author: Konda, Tirumaleswar Reddy
                   kondtir@gmail.com
    ";
  description
    "This YANG module defines a component that augments the
      IETF description of an access list to allow (D)TLS profile
      as matching criteria.

     Copyright (c) 2024 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
     (http://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

  revision 2022-10-10 {
    description
      "Initial revision";
    reference
      "RFC XXXX: Manufacturer Usage Description (MUD) (D)TLS
                 Profiles for IoT Devices";
  }

  feature tls12 {
    description
      "TLS Protocol Version 1.2 is supported.";
    reference
      "RFC 5246: The Transport Layer Security (TLS) Protocol
                 Version 1.2";
  }

  feature tls13 {
    description
      "TLS Protocol Version 1.3 is supported.";
    reference
      "RFC 8446: The Transport Layer Security (TLS) Protocol
                 Version 1.3";
  }

  feature dtls12 {
    description
      "DTLS Protocol Version 1.2 is supported.";
    reference
      "RFC 6347: Datagram Transport Layer Security 
                 Version 1.2";
  }

  feature dtls13 {
    description
      "DTLS Protocol Version 1.3 is supported.";
    reference
      "RFC 9147: Datagram Transport Layer 
                Security 1.3";
  }

  feature match-on-tls-dtls {
    description
      "The networking device can support matching on 
       (D)TLS parameters.";
  }

  typedef spki-pin-set {
    type binary;
    description
      "Subject Public Key Info pin set as discussed in 
       Section 2.4 of RFC7469.";
  }

  typedef certificate-authority {
    type string;
    description
      "Distinguished Name of Certificate authority as discussed 
       in Section 4.2.4 of RFC8446.";
  }

  augment "/acl:acls/acl:acl/acl:aces/acl:ace/acl:matches" {
    if-feature "match-on-tls-dtls"; 
    description
      "(D)TLS specific matches.";
    container client-profiles {
      description
        "A grouping for (D)TLS profiles.";
      list tls-dtls-profile {
        key "name";
        description
          "A list of (D)TLS version profiles supported by 
           the client.";
        leaf name {
          type string {
          length "1..64";
        }
        description
           "The name of (D)TLS profile; space and special 
            characters are not allowed.";
        }
       leaf-list supported-tls-version {
         type ianatp:tls-version;
         description
         "TLS versions supported by the client.";
       }
       leaf-list supported-dtls-version {
          type ianatp:dtls-version;
          description
            "DTLS versions supported by the client.";
       }
       leaf-list cipher-suite {
         type ianatp:cipher-algorithm;
         description
           "A list of Cipher Suites supported by the client.";
       }
       leaf-list extension-type {
          type ianatp:extension-type;
          description
            "A list of Extension Types supported by the client.";
       }
       leaf-list accept-list-ta-cert {
          type ct:trust-anchor-cert-cms;
          description
            "A list of trust anchor certificates used by the client.";
       }
       leaf-list psk-key-exchange-mode {
         if-feature "tls13 or dtls13";
         type ianatp:psk-key-exchange-mode;
            description
            "pre-shared key exchange modes.";
         }
       leaf-list supported-group {
         type ianatp:supported-group;
         description
           "A list of named groups supported by the client.";
       }
       leaf-list signature-algorithm-cert {
         if-feature "tls13 or dtls13";
         type ianatp:signature-algorithm;
         description
           "A list signature algorithms the client can validate
           in X.509 certificates.";
       }
       leaf-list signature-algorithm {
         type ianatp:signature-algorithm;
         description
           "A list signature algorithms the client can validate
            in the CertificateVerify message.";
       }
       leaf-list application-protocol {
         type ianatp:application-protocol;
         description
           "A list application protocols supported by the client.";
       }
       leaf-list cert-compression-algorithm {
         if-feature "tls13 or dtls13";
         type ianatp:cert-compression-algorithm;
         description
           "A list certificate compression algorithms
           supported by the client.";
       }
       leaf-list certificate-authorities {
         if-feature "tls13 or dtls13";
         type certificate-authority;
         description
           "A list of the distinguished names of certificate authorities
            acceptable to the client.";
       }
      }
    }
  }
}
<CODE ENDS>
]]></artwork>
          </figure></t>
      </section>

      <section anchor="yang-iana" title="IANA (D)TLS profile YANG Module">
        <t>The TLS and DTLS IANA registries are available from <eref
        target="https://www.iana.org/assignments/tls-parameters/tls-parameters.txt"></eref>
        and <eref
        target="https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.txt"></eref>.
        Changes to TLS and DTLS related IANA registries are discussed in <xref
        target="RFC8447"></xref>.</t>

        <t>The values for all the parameters in the "iana-tls-profile" YANG
        module are defined in the TLS and DTLS IANA registries excluding the
        tls-version, dtls-version, spki-pin-set, and certificate-authority
        parameters. The values of spki-pin-set and certificate-authority
        parameters will be specific to the IoT device.</t>

        <t>The TLS and DTLS IANA registries do not maintain (D)TLS version
        numbers. In (D)TLS 1.2 and below, "legacy_version" field in the
        ClientHello message is used for version negotiation. However, in
        (D)TLS 1.3, the "supported_versions" extension is used by the client
        to indicate which versions of (D)TLS it supports. TLS 1.3 ClientHello
        messages are identified as having a "legacy_version" of 0x0303 and a
        "supported_versions" extension present with 0x0304 as the highest
        version. DTLS 1.3 ClientHello messages are identified as having a
        "legacy_version" of 0xfefd and a "supported_versions" extension
        present with 0x0304 as the highest version.</t>

        <t>In order to ease updating the "iana-tls-profile" YANG module with
        future (D)TLS versions, new (D)TLS version registries are defined in
        <xref target="tls-registry"></xref> and <xref
        target="dtls-registry"></xref>. Whenever a new (D)TLS protocol version
        is defined, the registry will be updated using expert review; the
        "iana-tls-profile" YANG module will be automatically updated by
        IANA.</t>

        <t>Implementers or users of this specification must refer to the
        IANA-maintained "iana-tls-profile" YANG module available at XXXX [Note
        to RFC Editor to replace "XXXX" with the URL link of the
        IANA-maintained "iana-tls-profile" YANG module].</t>

        <t>The initial version of the "iana-tls-profile" YANG module is
        defined as follows:</t>

        <t><figure>
            <artwork><![CDATA[<CODE BEGINS> file "iana-tls-profile@2024-01-23.yang"

module iana-tls-profile {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:iana-tls-profile";
  prefix ianatp;

  organization
    "IANA";
  contact
    "        Internet Assigned Numbers Authority

     Postal: ICANN
             12025 Waterfront Drive, Suite 300
             Los Angeles, CA  90094-2536
             United States

     Tel:    +1 310 301 5800
     E-Mail: iana@iana.org>";
  description
    "This module contains YANG definition for the (D)TLS profile.

     Copyright (c) 2024 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
     (http://trustee.ietf.org/license-info).

     All revisions of IETF and IANA published modules can be found
     at the YANG Parameters registry
     (https://www.iana.org/assignments/yang-parameters).

     The initial version of this YANG module is part of RFC XXXX;
     see the RFC itself for full legal notices.

     // RFC Ed.: replace the IANA_TLS-PROFILE_URL and remove this note
     The latest version of this YANG module is available at
     <IANA_TLS-PROFILE_URL>.";

  revision 2024-01-23 {
    description
      "Initial revision";
    reference
      "RFC XXXX: Manufacturer Usage Description (MUD) (D)TLS Profiles
                 for IoT Devices";
  }

  typedef extension-type {
    type uint16;
    description
      "Extension type in the TLS ExtensionType Values registry as 
       defined in Section 7 of RFC8447.";
  }

  typedef supported-group {
    type uint16;
    description
      "Supported Group in the TLS Supported Groups registry as 
       defined in Section 9 of RFC8447.";
  }

  typedef signature-algorithm {
    type uint16;
    description
      "Signature algorithm in the TLS SignatureScheme registry as 
       defined in Section 11 of RFC8446.";
  }

  typedef psk-key-exchange-mode {
    type uint8;
    description
      "Pre-shared key exchange mode in the TLS PskKeyExchangeMode 
       registry as defined in Section 11 of RFC8446.";
  }

  typedef application-protocol {
    type string;
    description
      "Application-Layer Protocol Negotiation (ALPN) Protocol ID 
       registry as defined in Section 6 of RFC7301.";
  }

  typedef cert-compression-algorithm {
    type uint16;
    description
      "Certificate compression algorithm in TLS Certificate 
       Compression Algorithm IDs registry as defined in 
       Section 7.3 of RFC8879.";
  }

  typedef cipher-algorithm {
    type uint16;
    description
      "Cipher suite in TLS Cipher Suites registry 
       as discussed in Section 11 of RFC8446.";
  }

  typedef tls-version {
    type enumeration {
      enum tls12 {
        value 1;
        description
          "TLS Protocol Version 1.2. 

           TLS 1.2 ClientHello contains
           0x0303 in 'legacy_version'.";
        reference
          "RFC 5246: The Transport Layer Security (TLS) Protocol
                     Version 1.2";
      }
      enum tls13 {
        value 2;
        description
          "TLS Protocol Version 1.3. 

           TLS 1.3 ClientHello contains a 
           supported_versions extension with 0x0304 
           contained in its body and the ClientHello contains
           0x0303 in 'legacy_version'.";
        reference
          "RFC 8446: The Transport Layer Security (TLS) Protocol
                     Version 1.3";
      }
    }
    description
      "Indicates the TLS version.";
  }

  typedef dtls-version {
    type enumeration {
      enum dtls12 {
        value 1;
        description
          "DTLS Protocol Version 1.2.

           DTLS 1.2 ClientHello contains
           0xfefd in 'legacy_version'.";
        reference
          "RFC 6347: Datagram Transport Layer Security 1.2";
      }
      enum dtls13 {
        value 2;
        description
          "DTLS Protocol Version 1.3. 

           DTLS 1.3 ClientHello contains a 
           supported_versions extension with 0x0304 
           contained in its body and the ClientHello contains
           0xfefd in 'legacy_version'.";
        reference
          "RFC 9147: Datagram Transport Layer Security 1.3";
      }
    }
    description
      "Indicates the DTLS version.";
  }
}
<CODE ENDS>
]]></artwork>
          </figure></t>
      </section>

      <section anchor="mud-dtls-extension"
               title="MUD (D)TLS Profile Extension">
        <t>This document augments the "ietf-mud" MUD YANG module to indicate
        whether the device supports (D)TLS profile. If the "ietf-mud-tls"
        extension is supported by the device, MUD file is assumed to implement
        the "match-on-tls-dtls" ACL model feature defined in this
        specification. Furthermore, only "accept" or "drop" actions SHOULD be
        included with the (D)TLS profile similar to the actions allowed in
        Section 2 of <xref target="RFC8520"></xref>.</t>

        <t>This document defines the YANG module "ietf-mud-tls", which has the
        following tree structure:</t>

        <t><figure>
            <artwork><![CDATA[module: ietf-mud-tls
  augment /ietf-mud:mud:
    +--rw is-tls-dtls-profile-supported?   boolean
]]></artwork>
          </figure></t>

        <t>The model is defined as follows:</t>

        <t><figure>
            <artwork><![CDATA[<CODE BEGINS> file "ietf-mud-tls@2020-10-20.yang"

module ietf-mud-tls {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-mud-tls";
  prefix ietf-mud-tls;

  import ietf-mud {
    prefix ietf-mud;
    reference
      "RFC 8520: Manufacturer Usage Description Specification";
  }

  organization
    "IETF OPSAWG (Operations and Management Area Working Group)";
  contact
    "WG Web: <https://datatracker.ietf.org/wg/opsawg/>
     WG List: opsawg@ietf.org

     Author: Konda, Tirumaleswar Reddy
             kondtir@gmail.com

    ";
   description
     "Extension to a MUD module to indicate (D)TLS 
      profile support.

     Copyright (c) 2024 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
     (http://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

   revision 2022-10-10 {
     description
       "Initial revision.";
       reference
         "RFC XXXX: Manufacturer Usage Description (MUD) (D)TLS
          Profiles for IoT Devices";
   }

   augment "/ietf-mud:mud" {
     description
       "This adds an extension for a manufacturer
        to indicate whether the (D)TLS profile is
        supported by a device.";
     leaf is-tls-dtls-profile-supported {
       type boolean;
       default false;
         description
           "This value will equal 'true' if a device supports
            (D)TLS profile.";
     }
   } 
}
<CODE ENDS>
]]></artwork>
          </figure></t>
      </section>
    </section>

    <section anchor="processing" title="Processing of the MUD (D)TLS Profile">
      <t>The following text outlines the rules for a network security service
      (e.g., firewall) to follow to process the MUD (D)TLS Profile so as to
      avoid ossification:</t>

      <t><list style="symbols">
          <t>If the (D)TLS parameter observed in a (D)TLS session is not
          specified in the MUD (D)TLS profile and the parameter is recognized
          by the firewall, it can identify unexpected (D)TLS usage, which can
          indicate the presence of unauthorized software or malware on an
          endpoint. The firewall can take several actions like block the
          (D)TLS session or raise an alert to quarantine and remediate the
          compromised device. For example, if the cipher suite
          TLS_RSA_WITH_AES_128_CBC_SHA in the ClientHello message is not
          specified in the MUD (D)TLS profile and the cipher suite is
          recognized by the firewall, it can identify unexpected TLS
          usage.</t>

          <t>If the (D)TLS parameter observed in a (D)TLS session is not
          specified in the MUD (D)TLS profile and the (D)TLS parameter is not
          recognized by the firewall, it can ignore the unrecognized parameter
          and the correct behavior is not to block the (D)TLS session. The
          behaviour is functionally equivalent to the compliant TLS middlebox
          description in Section 9.3 of <xref target="RFC8446"></xref> to
          ignore all unrecognized cipher suites, extensions, and other
          parameters. For example, if the cipher suite
          TLS_CHACHA20_POLY1305_SHA256 in the ClientHello message is not
          specified in the MUD (D)TLS profile and the cipher suite is not
          recognized by the firewall, it can ignore the unrecognized cipher
          suite. This rule also ensures that the network security service will
          ignore the GREASE values advertised by TLS peers and interoperate
          with the implementations advertising GREASE values.</t>

          <t>Deployments update at different rates, so an updated MUD (D)TLS
          profile may support newer parameters. If the firewall does not
          recognize the newer parameters, an alert should be triggered to the
          firewall vendor and the IoT device owner or administrator. A
          firewall must be readily updatable, so that when new parameters in
          the MUD (D)TLS profile are discovered that are not recognized by the
          firewall, it can be updated quickly. Most importantly, if the
          firewall is not readily updatable, its protection efficacy to
          identify emerging malware will decrease with time. For example, if
          the cipher suite TLS_AES_128_CCM_8_SHA256 specified in the MUD
          (D)TLS profile is not recognized by the firewall, an alert will be
          triggered. Similarly, if the (D)TLS version specified in the MUD
          file is not recognized by the firewall, an alert will be
          triggered.</t>

          <t>If the MUD (D)TLS profile includes any parameters that are
          susceptible to attacks (e.g., weaker cryptographic parameters), an
          alert MUST be triggered to the firewall vendor and the IoT device
          owner or administrator.</t>
        </list></t>
    </section>

    <section anchor="Example" title="MUD File Example">
      <t>The example below contains (D)TLS profile parameters for a IoT device
      used to reach servers listening on port 443 using TCP transport. JSON
      encoding of YANG modelled data <xref target="RFC7951"></xref> is used to
      illustrate the example.</t>

      <t><figure>
          <artwork><![CDATA[{
   "ietf-mud:mud": {
     "mud-version": 1,
      "mud-url": "https://example.com/IoTDevice",
      "last-update": "2024-08-05T03:56:40.105+10:00",
      "cache-validity": 100,
      "extensions": [
           "ietf-mud-tls"
       ],
      "ietf-mud-tls:is-tls-dtls-profile-supported": "true",
      "is-supported": true,
      "systeminfo": "IoT device name",
      "from-device-policy": {
         "access-lists": {
           "access-list": [
             {
               "name": "mud-7500-profile"
             }
           ]
         }
      },
     "ietf-access-control-list:acls": {
       "acl": [
         {
           "name": "mud-7500-profile",
           "type": "ipv6-acl-type",
           "aces": {
             "ace": [
               {
                 "name": "cl0-frdev",
                 "matches": {
                   "ipv6": {
                     "protocol": 6
                   },
                   "tcp": {
                     "ietf-mud:direction-initiated": "from-device",
                     "destination-port": {
                       "operator": "eq",
                       "port": 443
                     }
                   },
                   "ietf-acl-tls:client-profile" : {
                     "tls-dtls-profiles" : [
                        {
                           "name" : "profile1",  
                           "supported-tls-versions" : ["tls13"],
                           "cipher-suite" : [4865, 4866],  
                           "extension-types" : [10,11,13,16,24],  
                           "supported-groups" : [29]
                        } 
                      ]
                   },
                   "actions": {
                      "forwarding": "accept"
                   }
               }
            }
          ]
         }
        }
       ]
     }
   }
}
]]></artwork>
        </figure></t>

      <t>The following illustrates the example scenarios for processing the
      above profile:<list style="symbols">
          <t>If the extension type "encrypt_then_mac" (code point 22) <xref
          target="RFC7366"></xref> in the ClientHello message is recognized by
          the firewall, it can identify unexpected TLS usage.</t>

          <t>If the extension type "token_binding" (code point 24) <xref
          target="RFC8472"></xref> in the MUD (D)TLS profile is not recognized
          by the firewall, it can ignore the unrecognized extension. Because
          the extension type "token_binding" is specified in the profile, an
          alert will be triggered to the firewall vendor and the IoT device
          owner or administrator to notify the firewall is not up-to-date.</t>

          <t>The two-byte values assigned by IANA for the cipher suites
          TLS_AES_128_GCM_SHA256 and TLS_AES_256_GCM_SHA384 are represented in
          decimal format.</t>
        </list></t>
    </section>

    <section anchor="ACL"
             title="Software-Based ACLs and ACLs within a (D)TLS 1.3 Proxy">
      <t>While ACL technology is traditionally associated with fixed-length
      bit matching in hardware implementations, such as those found in TCAMs,
      the use of ACLs in software, like with iptables, allows for more
      flexible matching criteria, including string matching. In the context of
      MUD (D)TLS profiles, the ability to match binary data and strings is a
      deliberate choice, made to leverage the capabilities of software-based
      ACLs. This enables more dynamic and context-sensitive access control,
      which is essential for the intended application of MUD. The DNS
      extension added to ACL in MUD specification <xref
      target="RFC8520"></xref> also require software-based ACLs.</t>

      <t>Regarding the use of MUD (D)TLS ACL in a (D)TLS 1.3 proxy, the goal
      is for the proxy to intercept the (D)TLS handshake before applying any
      ACL rules. This implies that MUD (D)TLS ACL matching would need to occur
      after decrypting the encrypted TLS handshake messages within the proxy.
      The proxy would inspect the handshake fields according to the MUD
      profile. ACL matching would be performed in two stages: first, by
      filtering clear-text TLS handshake message and second, by filtering
      after decrypting the TLS handshake messages.</t>
    </section>

    <section anchor="Security" title="Security Considerations">
      <t>Security considerations in <xref target="RFC8520"></xref> need to be
      taken into consideration. The middlebox MUST adhere to the invariants
      discussed in Section 9.3 of <xref target="RFC8446"></xref> to act as a
      compliant proxy.</t>

      <t>Although it is challenging for malware to mimic the TLS behavior of
      various IoT device types and models from different manufacturers, there
      is still a potential for malicious agents to use similar (D)TLS profile
      parameters as legitimate devices to evade detection. This difficulty
      arises because IoT devices often have distinct (D)TLS profiles between
      models and especially between manufacturers. While malware may find it
      hard to perfectly replicate the TLS behavior across such diverse
      devices, it is not impossible. Malicious agents might manage to use
      (D)TLS profile parameters that resemble those of legitimate devices. The
      feasibility of this depends on the nature of the profile parameters; for
      instance, parameters like certificate authorities are complex to mimic,
      while others, such as signature algorithms, may be easier to replicate.
      The difficulty in mimicking these profiles correlates with the
      specificity of the profiles and the variability in parameters used by
      different devices.</t>

      <t>Network security services should also rely on contextual network data
      (e.g., domain name, IP address etc) to detect false negatives. For
      example, network security services filter malcious domain names and
      destination IP addresses with bad reputation score. Further, In order to
      detect such malicious flows, anomaly detection (deep learning techniques
      on network data) can be used to detect malicious agents using the same
      (D)TLS profile parameters as legitimate agent on the IoT device. In
      anomaly detection, the main idea is to maintain rigorous learning of
      "normal" behavior and where an "anomaly" (or an attack) is identified
      and categorized based on the knowledge about the normal behavior and a
      deviation from this normal behavior. Network security vendors leverage
      TLS parameters and contextual network data to identify malware (for
      example, see <xref target="eve"></xref>).</t>

      <t>The efficacy of identifying malware in (D)TLS 1.3 flows will be
      significantly reduced without leveraging contextual network data or
      acting as a proxy, as the encryption in (D)TLS 1.3 obscures many of the
      handshake details that could otherwise be used for detection.</t>

      <section title="Challenges in Mimicking (D)TLS 1.2 Handshakes for IoT Devices">
        <t>(D)TLS 1.2 generally does not require a proxy, as all fields in the
        (D)TLS profile are transmitted in clear text during the handshake.
        While it is technically possible for an attacker to observe and mimic
        the handshake, an attacker would need to use a domain name and
        destination IP address with a good reputation, obtain certificates
        from the same CAs used by the IoT devices, and evade traffic analysis
        tecniques (e.g., <xref target="eve"></xref>, which detects malicious
        patterns in encrypted traffic without decryption). This task is
        particularly challenging because IoT devices often have distinct
        (D)TLS profiles, varying between models and manufacturers. Unlike the
        developers of legitimate applications, malware authors are under
        additional constraints such as avoiding any noticeable differences on
        the infected devices and the potential for take-down requests
        impacting their server infrastructure (e.g., certificate revocation by
        a CA upon reporting).</t>
      </section>

      <section title="Considerations for the &quot;iana-tls-profile&quot; Module">
        <t>This section follows the template defined in Section 3.7.1 of <xref
        target="I-D.ietf-netmod-rfc8407bis"></xref>.</t>

        <t>The YANG module specified in this document defines a schema for
        data can possibly be accessed via network management protocols such as
        NETCONF <xref target="RFC6241"></xref> or RESTCONF <xref
        target="RFC8040"></xref>. These network management protocols are
        required to use a secure transport layer and mutual authentication,
        e.g., SSH <xref target="RFC6242"></xref> without the "none"
        authentication option, Transport Layer Security (TLS) <xref
        target="RFC8446"></xref> with mutual X.509 authentication, and HTTPS
        with HTTP authentication (Section 11 of <xref
        target="RFC9110"></xref>).</t>

        <t>The Network Access Control Model (NACM) <xref
        target="RFC8341"></xref> provides the means to restrict access for
        particular users to a pre-configured subset of all available protocol
        operations and content.</t>

        <t>This YANG module defines YANG enumerations, for a public IANA-
        maintained registry.</t>

        <t>YANG enumerations are not security-sensitive, as they are
        statically defined in the publicly-accessible YANG module. IANA MAY
        deprecate and/or obsolete enumerations over time as needed to address
        security issues.</t>

        <t>This module does not define any writable-nodes, RPCs, actions, or
        notifications, and thus the security consideration for such is not
        provided here.</t>
      </section>

      <section title="Considerations for the &quot;ietf-acl-tls&quot; Module">
        <t>This section follows the template defined in Section 3.7.1 of <xref
        target="I-D.ietf-netmod-rfc8407bis"></xref>.</t>

        <t>The YANG module specified in this document defines a schema for
        data that is designed to be accessed via network management protocols
        such as NETCONF <xref target="RFC6241"> </xref> or RESTCONF <xref
        target="RFC8040"></xref>. These network management protocols are
        required to use a secure transport layer and mutual authentication,
        e.g., SSH <xref target="RFC6242"></xref> without the "none"
        authentication option, Transport Layer Security (TLS) <xref
        target="RFC8446"></xref> with mutual X.509 authentication, and HTTPS
        with HTTP authentication (Section 11 of <xref
        target="RFC9110"></xref>).</t>

        <t>The Network Access Control Model (NACM) <xref
        target="RFC8341"></xref> provides the means to restrict access for
        particular users to a pre-configured subset of all available protocol
        operations and content.</t>

        <t>Please be aware that this YANG module uses groupings from other
        YANG modules that define nodes that may be considered sensitive or
        vulnerable in network environments. Please review the Security
        Considerations for dependent YANG modules for information as to which
        nodes may be considered sensitive or vulnerable in network
        environments.</t>

        <t>All the writable data nodes defined by this module may be
        considered sensitive or vulnerable in some network environments. For
        instance, the addition or removal of references to trusted anchors,
        (D)TLS versions, cipher suites etc., can dramatically alter the
        implemented security policy. For this reason, the NACM extension
        "default-deny-write" has been set for all data nodes defined in this
        module.</t>

        <t>Some of the readable data nodes defined in this YANG module may be
        considered sensitive or vulnerable in some network environments. It is
        thus important to control read access (e.g., via get, get-config, or
        notification) to these data nodes. The YANG module will provide
        insights into (D)TLS profiles of the IoT devices, the privacy
        considerations discussed in <xref target="Privacy"></xref> needs to be
        taken into account.</t>

        <t>This module does not define any RPCs, actions, or notifications,
        and thus the security consideration for such is not provided here.</t>
      </section>

      <section title="Considerations for the &quot;ietf-mud-tls&quot; Module">
        <t>This section follows the template defined in Section 3.7.1 of <xref
        target="I-D.ietf-netmod-rfc8407bis"></xref>.</t>

        <t>The YANG module specified in this document defines a schema for
        data can possibly be accessed via network management protocols such as
        NETCONF <xref target="RFC6241"></xref> or RESTCONF <xref
        target="RFC8040"></xref>. These network management protocols are
        required to use a secure transport layer and mutual authentication,
        e.g., SSH <xref target="RFC6242"></xref> without the "none"
        authentication option, Transport Layer Security (TLS) <xref
        target="RFC8446"></xref> with mutual X.509 authentication, and HTTPS
        with HTTP authentication (Section 11 of <xref
        target="RFC9110"></xref>). Note that the YANG module is not intended
        to be accessed via NETCONF and RESTCONF. This has already been
        discussed in <xref target="RFC8520"></xref>, and we are reiterating it
        here for the sake of completeness.</t>

        <t>The Network Access Control Model (NACM) <xref
        target="RFC8341"></xref> provides the means to restrict access for
        particular users to a pre-configured subset of all available protocol
        operations and content.</t>

        <t>Please be aware that this YANG module uses groupings from other
        YANG modules that define nodes that may be considered sensitive or
        vulnerable in network environments. Please review the Security
        Considerations for dependent YANG modules for information as to which
        nodes may be considered sensitive or vulnerable in network
        environments.</t>

        <t>All the writable data nodes defined by this module may be
        considered sensitive or vulnerable in some network environments. For
        instance, update that the device does not support (D)TLS profile can
        dramatically alter the implemented security policy. For this reason,
        the NACM extension "default-deny-write" has been set for all data
        nodes defined in this module.</t>

        <t>This module does not define any RPCs, actions, or notifications,
        and thus the security consideration for such is not provided here.</t>
      </section>
    </section>

    <section anchor="Privacy" title="Privacy Considerations">
      <t>Privacy considerations discussed in Section 16 of <xref
      target="RFC8520"></xref> to not reveal the MUD URL to an attacker need
      to be taken into consideration. The MUD URL can be stored in Trusted
      Execution Environment (TEE) for secure operation, enhanced data
      security, and prevent exposure to unauthorized software. The MUD URL
      MUST be encrypted and shared only with the authorized components in the
      network (see Section 1.5 and Section 1.8 of [RFC8520]) so that an
      on-path attacker cannot read the MUD URL and identify the IoT device.
      Otherwise, it provides the attacker with guidance on what
      vulnerabilities may be present on the IoT device. Note that while
      protecting the MUD URL is valuable as described above, a compromised IoT
      device may be susceptible to malware performing vulnerability analysis
      (and version mapping) of the legitimate software located in memory or on
      non-volatile storage (e.g., disk, NVRAM). However, the malware on the
      IoT device is intended to be blocked from establishing a (D)TLS
      connection with the C&amp;C server to reveal this information because
      the connection would be blocked by the network security service
      supporting this specification.</t>

      <t>Full handshake inspection (<xref target="full"></xref>) requires a
      (D)TLS proxy device which needs to decrypt traffic between the IoT
      device and its server(s). There is a tradeoff between privacy of the
      data carried inside (D)TLS (especially e.g., personally identifiable
      information and protected health information) and efficacy of endpoint
      security. The use of (D)TLS proxies is NOT RECOMMENDED whenever
      possible. For example, an enterprise firewall administrator can
      configure the middlebox to bypass (D)TLS proxy functionality or payload
      inspection for connections destined to specific well-known services.
      Alternatively, a IoT device could be configured to reject all sessions
      that involve proxy servers to specific well-known services. In addition,
      mechanisms based on object security can be used by IoT devices to enable
      end-to-end security and the middlebox will not have any access to the
      packet data. For example, Object Security for Constrained RESTful
      Environments (OSCORE) <xref target="RFC8613"></xref> is a proposal that
      protects CoAP messages by wrapping them in the COSE format <xref
      target="RFC9052"></xref>.</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <section title="(D)TLS Profile YANG Modules">
        <t>This document requests IANA to register the following URIs in the
        "ns" subregistry within the "IETF XML Registry" <xref
        target="RFC3688"></xref>: <figure>
            <artwork><![CDATA[      URI: urn:ietf:params:xml:ns:yang:iana-tls-profile
      Registrant Contact: IANA.
      XML: N/A; the requested URI is an XML namespace.
]]></artwork>
          </figure><figure>
            <artwork><![CDATA[      URI: urn:ietf:params:xml:ns:yang:ietf-acl-tls
      Registrant Contact: IESG.
      XML: N/A; the requested URI is an XML namespace.
]]></artwork>
          </figure><figure>
            <artwork><![CDATA[      URI: urn:ietf:params:xml:ns:yang:ietf-mud-tls
      Registrant Contact: IESG.
      XML: N/A; the requested URI is an XML namespace.
]]></artwork>
          </figure></t>

        <t>IANA is requested to create an IANA-maintained YANG Module called
        "iana-tls-profile", based on the contents of <xref
        target="yang-iana"></xref>, which will allow for new (D)TLS parameters
        and (D)TLS versions to be added to "client-profile".</t>

        <t>This document requests IANA to register the following YANG modules
        in the "YANG Module Names" subregistry <xref target="RFC6020"></xref>
        within the "YANG Parameters" registry.</t>

        <t><figure>
            <artwork><![CDATA[      name: iana-tls-profile
      namespace: urn:ietf:params:xml:ns:yang:iana-tls-profile
      maintained by IANA: Y
      prefix: ianatp
      reference: RFC XXXX
]]></artwork>
          </figure><figure>
            <artwork><![CDATA[      name: ietf-acl-tls
      namespace: urn:ietf:params:xml:ns:yang:ietf-acl-tls
      maintained by IANA: N
      prefix: ietf-acl-tls
      reference: RFC XXXX]]></artwork>
          </figure><figure>
            <artwork><![CDATA[      name: ietf-mud-tls
      namespace: urn:ietf:params:xml:ns:yang:ietf-mud-tls
      maintained by IANA: N
      prefix: ietf-mud-tls
      reference: RFC XXXX]]></artwork>
          </figure></t>
      </section>

      <section anchor="iana-tls"
               title="Considerations for the iana-tls-profile Module">
        <t>IANA is requested to create the initial version of the
        IANA-maintained YANG Module called "iana-tls-profile", based on the
        contents of <xref target="yang-iana"></xref>, which will allow for new
        (D)TLS parameters and (D)TLS versions to be added. IANA is requested
        to add this note:</t>

        <t><list style="symbols">
            <t>tls-version and dtls-version values must not be directly added
            to the iana-tls-profile YANG module. They must instead be
            respectively added to the "ACL TLS Version Codes", and "ACL DTLS
            Version Codes" registries provided the new (D)TLS version has been
            standardized by the IETF. It allows new (D)TLS version to be added
            to the "iana-tls-profile" YANG Module.</t>

            <t>(D)TLS parameters must not be directly added to the
            iana-tls-profile YANG module. They must instead be added to the
            "ACL (D)TLS Parameters" registry if the new (D)TLS parameters can
            be used by a middlebox to identify a MUD non-compliant (D)TLS
            behavior. It allows new (D)TLS parameters to be added to the
            "iana-tls-profile" YANG Module,</t>
          </list></t>

        <t>When a 'tls-version' or 'dtls-version' value is respectively added
        to the "ACL TLS Version Codes" or "ACL DTLS Version Codes" registry, a
        new "enum" statement must be added to the iana-tls-profile YANG
        module. The following "enum" statement, and substatements thereof,
        should be defined:<list hangIndent="15" style="hanging">
            <t hangText="&quot;enum&quot;:">Replicates the label from the
            registry.</t>

            <t hangText="&quot;value&quot;:">Contains the IANA-assigned value
            corresponding to the 'tls-version' or 'dtls-version'.</t>

            <t hangText="&quot;description&quot;:">Replicates the description
            from the registry.</t>

            <t hangText="&quot;reference&quot;:">RFC YYYY: &lt;Title of the
            RFC &gt;, where YYYY is the RFC that added the
            &rsquo;tls-version&rsquo; or &lsquo;dtls-version&rsquo;</t>
          </list></t>

        <t>When a (D)TLS parameter is added to "ACL (D)TLS Parameters"
        registry, a new "type" statement must be added to the iana-tls-profile
        YANG module. The following "type" statement, and substatements
        thereof, should be defined:<list hangIndent="15" style="hanging">
            <t hangText="&quot;derived type&quot;:">Replicates the parameter
            name from the registry.</t>

            <t hangText="&quot;built-in type&quot;:">Contains the built-in
            YANG type.</t>

            <t hangText="&quot;description&quot;:">Replicates the description
            from the registry.</t>
          </list></t>

        <t>When the iana-tls-profile YANG module is updated, a new "revision"
        statement must be added in front of the existing revision
        statements.</t>

        <t>IANA is requested to add this note to "ACL TLS Version Codes", "ACL
        DTLS Version Codes", and "ACL (D)TLS Parameters" registries:</t>

        <t><list style="empty">
            <t>When this registry is modified, the YANG module
            iana-tls-profile must be updated as defined in [RFCXXXX].</t>
          </list></t>
      </section>

      <section anchor="tls-registry" title="ACL TLS Version registry">
        <t>IANA is requested to create a new registry titled "ACL TLS Version
        Codes". Codes in this registry are used as valid values of
        'tls-version' parameter. Further assignments are to be made through
        Expert Review <xref target="RFC8126"></xref>. Experts must ensure that
        the TLS protocol version in a new registration is one that has been
        standardized by the IETF. It is expected that the registry will be
        updated infrequently, primarily when a new TLS version is standardized
        by the IETF.</t>

        <t><figure>
            <artwork><![CDATA[   +-------+---------+-----------------+-----------+
   | Value | Label   | Description     | Reference | 
   |       |         |                 |           |   
   |       |         |                 |           |
   +-------+---------+-----------------+-----------+
   | 1     | tls12   | TLS Version 1.2 | [RFC5246] |
   +-------+---------+-----------------+-----------+
   | 2     | tls13   | TLS Version 1.3 | [RFC8446] |
   +-------+---------+-----------------+-----------+      
]]></artwork>
          </figure></t>
      </section>

      <section anchor="dtls-registry" title="ACL DTLS version registry">
        <t>IANA is requested to create a new registry titled "ACL DTLS Version
        Codes". Codes in this registry are used as valid values of
        'dtls-version' parameter. Further assignments are to be made through
        Expert Review <xref target="RFC8126"></xref>. Experts must ensure that
        the DTLS protocol version in a new registration is one that has been
        standardized by the IETF. It is expected that the registry will be
        updated infrequently, primarily when a new DTLS version is
        standardized by the IETF.</t>

        <t><figure>
            <artwork><![CDATA[
   +-------+---------+----------------+-----------------------+
   | Value | Label   | Description    | Reference             | 
   |       |         |                |                       |   
   |       |         |                |                       |
   +-------+---------+----------------+-----------------------+
   | 1     |dtls12   |DTLS Version 1.2| [RFC6347]             |
   +-------+---------+----------------+-----------------------+
   | 2     |dtls13   |DTLS Version 1.3| [RFC9147|             |
   +-------+---------+----------------+-----------------------+          

]]></artwork>
          </figure></t>
      </section>

      <section title="ACL (D)TLS Parameters registry">
        <t>IANA is requested to create a new registry titled "ACL (D)TLS
        parameters".</t>

        <t>The values for all the (D)TLS parameters in the registry are
        defined in the TLS and DTLS IANA registries (<eref
        target="https://www.iana.org/assignments/tls-parameters/tls-parameters.txt"></eref>
        and <eref
        target="https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.txt"></eref>)
        excluding the tls-version and dtls-version parameters. Further
        assignments are to be made through Expert Review <xref
        target="RFC8126"></xref>. Experts must ensure that the (D)TLS
        parameter in a new registration is one that has been standardized by
        the IETF. The registry is expected to be updated periodically,
        primarily when a new (D)TLS parameter is standardized by the IETF. The
        registry is initially populated with the following parameters:</t>

        <t><figure>
            <artwork><![CDATA[   +----------------------------+-------------+--------+---------------------------------------------+
   | Parameter Name             | YANG        | JSON   |                                             | 
   |                            | Type        | Type   | Description                                 |
   |                            |             |        |                                             |
   +----------------------------+-------------+--------+---------------------------------------------+
   | extension-type             | uint16      | Number | Extension type                              |
   +----------------------------+-------------+--------+---------------------------------------------+
   | supported-group            | uint16      | Number | Supported group                             |
   +----------------------------+-------------+--------+---------------------------------------------+
   | signature-algorithm        | uint16      | Number | Signature algorithm                         |  
   +----------------------------+-------------+--------+---------------------------------------------+
   | psk-key-exchange-mode      | uint8       | Number | pre-shared key exchange mode                | 
   +----------------------------+-------------+--------+---------------------------------------------+
   | application-protocol       | string      | String | Application protocol                        |
   +----------------------------+-------------+--------+---------------------------------------------+
   | cert-compression-algorithm | uint16      | Number | Certificate compression algorithm           |   
   +----------------------------+-------------+--------+---------------------------------------------+
   | cipher-algorithm           | uint16      | Number | Cipher Suite                                |
   +----------------------------+-------------+--------+---------------------------------------------+
   | tls-version                | enumeration | String | TLS version                                 |
   +----------------------------+-------------+--------+---------------------------------------------+
   | dtls-version               | enumeration | String | DTLS version                                |
   +----------------------------+-------------+--------+---------------------------------------------+

]]></artwork>
          </figure></t>
      </section>

      <section title="MUD Extensions registry">
        <t>IANA is requested to create a new MUD Extension Name "ietf-mud-tls"
        in the MUD Extensions IANA registry <eref
        target="https://www.iana.org/assignments/mud/mud.xhtml"></eref>.</t>
      </section>
    </section>

    <section anchor="acknowledgments" title="Acknowledgments">
      <t>Thanks to Flemming Andreasen, Shashank Jain, Michael Richardson,
      Piyush Joshi, Eliot Lear, Harsha Joshi, Qin Wu, Mohamed Boucadair, Ben
      Schwartz, Eric Rescorla, Panwei William, Nick Lamb, Tom Petch, Paul
      Wouters, Thomas Fossati and Nick Harper for the discussion and
      comments.</t>

      <t>Thanks to Xufeng Liu for YANGDOCTOR review. Thanks to Linda Dunbar
      for SECDIR review. Thanks to Qin Wu for OPSDIR review. Thanks to R.
      Gieben for DNSDIR review.</t>

      <t>Thanks to Roman Danyliw, Orie Steele, &Eacute;ric Vyncke, Mahesh
      Jethanandani, Murray Kucherawy, Zaheduzzaman Sarker and Deb Cooley for
      the IESG review.</t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include="reference.RFC.2119"?>

      <?rfc include='reference.RFC.8174'?>

      <?rfc include="reference.RFC.8446"?>

      <?rfc include="reference.RFC.8519"?>

      <?rfc include='reference.RFC.3688'?>

      <?rfc include='reference.RFC.8701'?>

      <?rfc include='reference.RFC.5246'?>

      <?rfc include='reference.RFC.6347'?>

      <?rfc include='reference.RFC.9147'?>

      <?rfc include='reference.RFC.8520'?>

      <?rfc include="reference.I-D.ietf-netconf-crypto-types"  ?>

      <?rfc include='reference.RFC.8879'?>

      <?rfc include='reference.RFC.6241'?>

      <?rfc include='reference.RFC.8040'?>

      <?rfc include='reference.RFC.6242'?>

      <?rfc include='reference.RFC.9110'?>

      <?rfc include='reference.RFC.8341'?>

      <reference anchor="X690">
        <front>
          <title>Information technology - ASN.1 encoding Rules: Specification
          of Basic Encoding Rules (BER), Canonical Encoding Rules (CER) and
          Distinguished Encoding Rules (DER)</title>

          <author>
            <organization>ITU-T</organization>
          </author>

          <date year="2002" />
        </front>

        <seriesInfo name="ISO/IEC" value="8825-1:2002" />
      </reference>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.7951'?>

      <?rfc include="reference.RFC.8576"?>

      <?rfc include="reference.RFC.8484"?>

      <?rfc include="reference.RFC.6020"?>

      <?rfc include='reference.RFC.8126'?>

      <?rfc include='reference.RFC.7925'?>

      <?rfc include='reference.RFC.7366'?>

      <?rfc include='reference.RFC.6066'?>

      <?rfc include='reference.RFC.8472'?>

      <?rfc include='reference.RFC.9325'?>

      <?rfc include='reference.RFC.7301'?>

      <?rfc include="reference.RFC.9052"?>

      <?rfc include='reference.RFC.8613'?>

      <?rfc include='reference.RFC.8447'?>

      <?rfc include='reference.RFC.8340'?>

      <?rfc include="reference.I-D.ietf-tls-esni" ?>

      <?rfc include='reference.RFC.9462'?>

      <?rfc include='reference.RFC.9463'?>

      <?rfc include='reference.RFC.7858'?>

      <?rfc include="reference.I-D.ietf-uta-tls13-iot-profile"  ?>

      <?rfc include="reference.I-D.ietf-netmod-rfc8407bis"?>

      <reference anchor="X501">
        <front>
          <title>Information Technology - Open Systems Interconnection - The
          Directory: Models</title>

          <author>
            <organization></organization>
          </author>

          <date year="1993" />
        </front>

        <seriesInfo name="ITU-T" value="X.501" />
      </reference>

      <reference anchor="clear-as-mud"
                 target="https://arxiv.org/pdf/1804.04358.pdf">
        <front>
          <title>Clear as MUD: Generating, Validating and Applying IoT
          Behaviorial Profiles</title>

          <author>
            <organization></organization>
          </author>

          <date month="October" year="2019" />
        </front>
      </reference>

      <reference anchor="malware-tls"
                 target="https://dl.acm.org/citation.cfm?id=3355601">
        <front>
          <title>TLS Beyond the Browser: Combining End Host and Network Data
          to Understand Application Behavior</title>

          <author fullname="Blake Anderson" initials="B." surname="Anderson">
            <organization>Cisco</organization>
          </author>

          <author fullname="David McGrew" initials="D." surname="McGrew">
            <organization>Cisco</organization>
          </author>

          <date month="October" year="2019" />
        </front>
      </reference>

      <reference anchor="cryto-vulnerability"
                 target="https://media.defense.gov/2020/Jan/14/2002234275/-1/-1/0/CSA-WINDOWS-10-CRYPT-LIB-20190114.PDF">
        <front>
          <title>Exploiting the Windows CryptoAPI Vulnerability</title>

          <author fullname="Ben Perez" initials="B." surname="Perez">
            <organization>Cisco</organization>
          </author>

          <date month="January" year="2020" />
        </front>
      </reference>

      <reference anchor="malware-doh"
                 target="https://www.zdnet.com/article/first-ever-malware-strain-spotted-abusing-new-doh-dns-over-https-protocol/">
        <front>
          <title>First-ever malware strain spotted abusing new DoH (DNS over
          HTTPS) protocol</title>

          <author fullname="Catalin Cimpanu" initials="C." surname="Cimpanu">
            <organization>Cisco</organization>
          </author>

          <date month="July" year="2019" />
        </front>
      </reference>

      <reference anchor="slowloris"
                 target="https://web.archive.org/web/20150315054838/http://ha.ckers.org/slowloris/">
        <front>
          <title>Slowloris HTTP DoS</title>

          <author fullname="" initials="" surname="">
            <organization>Cisco</organization>
          </author>

          <date month="" year="" />
        </front>
      </reference>

      <reference anchor="eve"
                 target="https://secure.cisco.com/secure-firewall/docs/encrypted-visibility-engine">
        <front>
          <title>Encrypted Visibility Engine</title>

          <author fullname="" initials="" surname="">
            <organization>Cisco</organization>
          </author>

          <date month="" year="" />
        </front>
      </reference>
    </references>
  </back>
</rfc>
