Skip to main content

Strong Assertions of IoT Network Access Requirements

Document Type Active Internet-Draft (suit WG)
Authors Brendan Moran , Hannes Tschofenig
Last updated 2022-10-24
Replaces draft-moran-suit-mud
Stream Internet Engineering Task Force (IETF)
Intended RFC status (None)
Stream WG state WG Document
Document shepherd (None)
IESG IESG state I-D Exists
Consensus boilerplate Unknown
Telechat date (None)
Responsible AD (None)
Send notices to (None)
SUIT                                                            B. Moran
Internet-Draft                                             H. Tschofenig
Intended status: Standards Track                             Arm Limited
Expires: 27 April 2023                                   24 October 2022

          Strong Assertions of IoT Network Access Requirements


   The Manufacturer Usage Description (MUD) specification describes the
   access and network functionality required a device to properly
   function.  The MUD description has to reflect the software running on
   the device and its configuration.  Because of this, the most
   appropriate entity for describing device network access requirements
   is the same as the entity developing the software and its

   A network presented with a MUD file by a device allows detection of
   misbehavior by the device software and configuration of access

   This document defines a way to link a SUIT manifest to a MUD file
   offering a stronger binding between the two.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on 27 April 2023.

Copyright Notice

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

Moran & Tschofenig        Expires 27 April 2023                 [Page 1]
Internet-Draft              SUIT MUD Linkage                October 2022

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents (
   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 Revised BSD License text as
   described in Section 4.e of the Trust Legal Provisions and are
   provided without warranty as described in the Revised 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  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   3
   3.  Architecture  . . . . . . . . . . . . . . . . . . . . . . . .   3
   4.  Extensions to SUIT  . . . . . . . . . . . . . . . . . . . . .   4
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .   5
   6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   5
   7.  Normative References  . . . . . . . . . . . . . . . . . . . .   5
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .   6

1.  Introduction

   Under [RFC8520], devices report a URL to a MUD manager in the
   network.  RFC 8520 envisions different approaches for conveying the
   information from the device to the network such as:

   *  DHCP,

   *  IEEE802.1AB Link Layer Discovery Protocol (LLDP), and

   *  IEEE 802.1X whereby the URL to the MUD file would be contained in
      the certificate used in an EAP method.

   The MUD manager then uses the the URL to fetch the MUD file, which
   contains access and network functionality required a device to
   properly function.

Moran & Tschofenig        Expires 27 April 2023                 [Page 2]
Internet-Draft              SUIT MUD Linkage                October 2022

   The MUD manager must trust the service from which the URL is fetched
   and to return an authentic copy of the MUD file.  This concern may be
   mitigated using the optional signature reference in the MUD file.
   The MUD manager must also trust the device to report a correct URL.
   In case of DHCP and LLDP the URL is unprotected.  When the URL to the
   MUD file is included in a certificate then it is authenticated and
   integrity protected.  A certificate created for use with network
   access authentication is typically not signed by the entity that
   wrote the software and configured the device, which leads to
   conflation of local network access rights with rights to assert all
   network access requirements.

   There is a need to bind the entity that creates the software and
   configuration to the MUD file because only that entity can attest the
   network access requirements of the device.  This specification
   defines an extension to the SUIT manifest to include a MUD file (per
   reference or by value).  When combining a manufacturer usage
   description with a manifest used for software/firmware updates
   (potentially augmented with attestation) then a network operator can
   get more confidence in the description of the access and network
   functionality required a device to properly function.

2.  Terminology

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "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.  Architecture

   The intended workflow is as follows:

   *  At the time of onboarding, devices report their manifest in use to
      the MUD manager.

   *  If the SUIT_MUD_container has been severed, the suit-reference-uri
      can be used to retrieve the complete manifest.

   *  The manifest authenticity is verified by the MUD manager, which
      enforces that the MUD file presented is also authentic and as
      intended by the device software vendor.

   *  Each time a device is updated, rebooted, or otherwise
      substantially changed, it will execute an attestation.

Moran & Tschofenig        Expires 27 April 2023                 [Page 3]
Internet-Draft              SUIT MUD Linkage                October 2022

      -  Among other claims in the Entity Attestation Token (EAT)
         [I-D.ietf-rats-eat], the device will report its software
         digest(s), configuration digest(s), primary manifest URI, and
         primary manifest digest to the MUD manager.

      -  The MUD manager can then validate these attestation reports in
         order to check that the device is operating with the expected
         version of software and configuration.

      -  Since the manifest digest is reported, the MUD manager can look
         up the corresponding manifest.

   *  If the MUD manager does not already have a full copy of the
      manifest, it can be acquired using the reference URI.

   *  Once a full copy of the manifest is provided, the MUD manager can
      verify the device attestation report and apply any appropriate
      policy as described by the MUD file.

4.  Extensions to SUIT

   To enable strong assertions about the network access requirements
   that a device should have for a particular software/configuration
   pair, we include the ability to add MUD files to the SUIT manifest.
   However, there are also circumstances in which a device should allow
   the MUD to be changed without a firmware update.  To enable this, we
   add a MUD url to SUIT along with a subject-key identifier, according
   to [RFC7093], mechanism 4 (the keyIdentifier is composed of the hash
   of the DER encoding of the SubjectPublicKeyInfo value).

   The following CDDL describes the extension to the SUIT_Manifest

   ? suit-manifest-mud => SUIT_Digest

   The SUIT_Envelope is also amended:

   ? suit-manifest-mud => bstr .cbor SUIT_MUD_container

   SUIT_MUD_container = {
       ? suit-mud-url => #6.32(tstr),
       ? suit-mud-ski => SUIT_Digest,
       ? suit-mud-file => bstr

   The MUD file is included verbatim within the bstr.  No limits are
   placed on the MUD file: it may be any RFC8520-compliant file.

Moran & Tschofenig        Expires 27 April 2023                 [Page 4]
Internet-Draft              SUIT MUD Linkage                October 2022

5.  Security Considerations

   This specification links MUD files to other IETF technologies,
   particularly to SUIT manifests, for improving security protection and
   ease of use.  By including MUD files (per reference or by value) in
   SUIT manifests an extra layer of protection has been created and
   synchronization risks can be minimized.  If the MUD file and the
   software/firmware loaded onto the device gets out-of-sync a device
   may be firewalled and, with firewalling by networks in place, the
   device may stop functioning.

6.  IANA Considerations

   suit-manifest-mud must be added as an extension point to the SUIT
   manifest registry.

7.  Normative References

              Lundblade, L., Mandyam, G., O'Donoghue, J., and C.
              Wallace, "The Entity Attestation Token (EAT)", Work in
              Progress, Internet-Draft, draft-ietf-rats-eat-17, 22
              October 2022, <

              Moran, B., Tschofenig, H., Birkholz, H., Zandberg, K., and
              O. Rønningstad, "A Concise Binary Object Representation
              (CBOR)-based Serialization Format for the Software Updates
              for Internet of Things (SUIT) Manifest", Work in Progress,
              Internet-Draft, draft-ietf-suit-manifest-20, 7 October
              2022, <

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,

   [RFC7093]  Turner, S., Kent, S., and J. Manger, "Additional Methods
              for Generating Key Identifiers Values", RFC 7093,
              DOI 10.17487/RFC7093, December 2013,

   [RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
              2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
              May 2017, <>.

Moran & Tschofenig        Expires 27 April 2023                 [Page 5]
Internet-Draft              SUIT MUD Linkage                October 2022

   [RFC8520]  Lear, E., Droms, R., and D. Romascanu, "Manufacturer Usage
              Description Specification", RFC 8520,
              DOI 10.17487/RFC8520, March 2019,

Authors' Addresses

   Brendan Moran
   Arm Limited

   Hannes Tschofenig
   Arm Limited

Moran & Tschofenig        Expires 27 April 2023                 [Page 6]