<?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.3.3 -->

<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
]>

<?rfc rfcedstyle="yes"?>
<?rfc toc="yes"?>
<?rfc tocindent="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>
<?rfc strict="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc text-list-symbols="-o*+"?>
<?rfc docmapping="yes"?>

<rfc ipr="pre5378Trust200902" docName="draft-ietf-suit-architecture-10" category="info">

  <front>
    <title abbrev="A Firmware Update Architecture for IoT">A Firmware Update Architecture for Internet of Things</title>

    <author initials="B." surname="Moran" fullname="Brendan Moran">
      <organization>Arm Limited</organization>
      <address>
        <email>Brendan.Moran@arm.com</email>
      </address>
    </author>
    <author initials="H." surname="Tschofenig" fullname="Hannes Tschofenig">
      <organization>Arm Limited</organization>
      <address>
        <email>hannes.tschofenig@arm.com</email>
      </address>
    </author>
    <author initials="D." surname="Brown" fullname="David Brown">
      <organization>Linaro</organization>
      <address>
        <email>david.brown@linaro.org</email>
      </address>
    </author>
    <author initials="M." surname="Meriac" fullname="Milosch Meriac">
      <organization>Consultant</organization>
      <address>
        <email>milosch@meriac.com</email>
      </address>
    </author>

    <date year="2020" month="May" day="27"/>

    <area>Security</area>
    <workgroup>SUIT</workgroup>
    <keyword>Internet-Draft</keyword>

    <abstract>


<t>Vulnerabilities with Internet of Things (IoT) devices have raised
the need for a solid and secure firmware update mechanism that is
also suitable for constrained devices. Incorporating such update
mechanism to fix vulnerabilities, to update configuration settings
as well as adding new functionality is recommended by security
experts.</t>

<t>This document lists requirements and describes an architecture for
a firmware update mechanism suitable for IoT devices. The
architecture is agnostic to the transport of the firmware images
and associated meta-data.</t>



    </abstract>


  </front>

  <middle>


<section anchor="introduction" title="Introduction">

<t>When developing Internet of Things (IoT) devices, one of the most difficult problems
to solve is how to update firmware on the device. Once the
device is deployed, firmware updates play a critical part in its
lifetime, particularly when devices have a long lifetime, are
deployed in remote or inaccessible areas where manual
intervention is cost prohibitive or otherwise difficult. Updates
to the firmware of an IoT device are done to fix bugs in software,
to add new functionality, and to re-configure the device to work
in new environments or to behave differently in an already
deployed context.</t>

<t>The firmware update process, among other goals, has to ensure that</t>

<t><list style="symbols">
  <t>The firmware image is authenticated and integrity protected.
Attempts to flash a modified firmware image or an image from
an unknown source are prevented.</t>
  <t>The firmware image can be confidentiality protected so that
attempts by an adversary to recover the plaintext binary can
be prevented. Obtaining the firmware is often one of
the first steps to mount an attack since it gives the adversary
valuable insights into used software libraries, configuration
settings and generic functionality (even though reverse
engineering the binary can be a tedious process).</t>
</list></t>

<t>This version of the document assumes asymmetric cryptography and
a public key infrastructure. Future versions may also describe
a symmetric key approach for very constrained devices.</t>

<t>While the standardization work has been informed by and optimised for firmware
update use cases of Class 1 (as defined in RFC 7228 <xref target="RFC7228"/>) devices, there is nothing in
the architecture that restricts its use to only these constrained IoT devices.
Software update and delivery of arbitrary data, such as configuration information
and keys, can equally be managed by manifests.</t>

<t>More details about the security goals are discussed in
<xref target="architecture"/> and requirements are described in <xref target="requirements"/>.</t>

</section>
<section anchor="terminology" title="Conventions and Terminology">

<t>This document uses the following terms:</t>

<t><list style="symbols">
  <t>Manifest: The manifest contains meta-data about the firmware
image. The manifest is protected against modification and
provides information about the author.</t>
  <t>Firmware Image: The firmware image, or image, is a binary
that may contain the complete software of a device or a subset of
it. The firmware image may consist of multiple images, if
the device contains more than one microcontroller. Often
it is also a compressed archive that contains code,
configuration data, and even the entire file system. The
image may consist of a differential update for performance
reasons. Firmware is the more universal term. The terms,
firmware image, firmware, and image, are used in this
document and are interchangeable.</t>
  <t>Software: The terms “software” and “firmware” are used
interchangeably.</t>
  <t>Bootloader: A bootloader is a piece of software that is
executed once a microcontroller has been reset. It is
responsible for deciding whether to boot a firmware image
that is present or whether to obtain and verify a new
firmware image. Since the bootloader is a security critical
component its functionality may be split into separate stages.
Such a multi-stage bootloader may offer very basic functionality
in the first stage and resides in ROM whereas the second stage
may implement more complex functionality and resides in flash
memory so that it can be updated in the future (in case bugs
have been found). The exact split of components into the
different stages, the number of firmware images stored by an
IoT device, and the detailed functionality varies throughout
different implementations. A more detailed discussion is
provided in <xref target="bootloader"/>.</t>
  <t>Microcontroller (MCU for microcontroller unit): An MCU is a
compact integrated circuit designed for use in embedded systems.
A typical microcontroller includes a processor, memory (RAM and
flash), input/output (I/O) ports and other features connected via
some bus on a single chip. The term ‘system on chip (SoC)’ is
often used for these types of devices.</t>
  <t>System on Chip (SoC): An SoC is an integrated circuit that
integrates all components of a computer, such as CPU, memory,
input/output ports, secondary storage, etc.</t>
  <t>Homogeneous Storage Architecture (HoSA): A device that stores
all firmware components in the same way, for example in a file
system or in flash memory.</t>
  <t>Heterogeneous Storage Architecture (HeSA): A device that
stores at least one firmware component differently from the rest,
for example a device with an external, updatable radio, or a
device with internal and external flash memory.</t>
  <t>Trusted Execution Environments (TEEs): An execution environment
that runs alongside of, but is isolated from, an REE.</t>
  <t>Rich Execution Environment (REE): An environment that is provided
and governed by a typical OS (e.g., Linux, Windows, Android, iOS),
potentially in conjunction with other supporting operating systems
and hypervisors; it is outside of the TEE.  This environment and
applications running on it are considered un-trusted.</t>
  <t>Trusted applications (TAs): An application component that runs in
a TEE.</t>
</list></t>

<t>For more information about TEEs see <xref target="I-D.ietf-teep-architecture"/>.</t>

<t>The following entities are used:</t>

<t><list style="symbols">
  <t>Author: The author is the entity that creates the firmware image.
There may be multiple authors in a system either when a device
consists of multiple micro-controllers or when the the final
firmware image consists of software components from multiple
companies.</t>
  <t>Firmware Consumer: The firmware consumer is the recipient of the
firmware image and the manifest. It is responsible for parsing
and verifying the received manifest and for storing the obtained
firmware image. The firmware consumer plays the role of the
update component on the IoT device typically running in the
application firmware. It interacts with the firmware server and
with the status tracker, if present.</t>
  <t>(IoT) Device: A device refers to the entire IoT product, which
consists of one or many MCUs, sensors and/or actuators. Many IoT
devices sold today contain multiple MCUs and therefore a single
device may need to obtain more than one firmware image and
manifest to succesfully perform an update. The terms device and
firmware consumer are used interchangably since the firmware
consumer is one software component running on an MCU on the device.</t>
  <t>Status Tracker: The status tracker offers device management
functionality to retrieve information about the installed firmware
on a device and other device characteristics (including free memory
and hardware components), to obtain the state of the firmware update
cycle the device is currently in, and to trigger the update process.
The deployment of status trackers is flexible and they may be used
as cloud-based servers, on-premise servers, embedded in edge computing device
(such as Internet access gateways or protocol translation gateways),
or even in smart phones and tablets. While the IoT device itself
runs the client-side of the status tracker it will most likely not
run a status tracker itself unless it acts as a proxy for other
IoT devices in a protocol translation or edge computing device node.
How much functionality a status tracker includes depends on the selected
configuration of the device management functionality and the communication
environment it is used in. In a generic networking environment the protocol
used between the client and the server-side of the status tracker need to
deal with Internet communication challenges involving firewall and NAT traversal.
In other cases, the communication interaction may be rather simple. This
architecture document does not impose requirements on the status tracker.</t>
  <t>Firmware Server: The firmware server stores firmware images and manifests and
distributes them to IoT devices.
Some deployments may require a store-and-forward concept, which requires
storing the firmware images/manifests on more than one entity before<vspace />
they reach the device. There is typically some interaction between the
firmware server and the status tracker but those entities are often
physically separated on different devices for scalability reasons.</t>
  <t>Device Operator: The actor responsible for the day-to-day operation
of a fleet of IoT devices.</t>
  <t>Network Operator: The actor responsible for the operation of a
network to which IoT devices connect.</t>
</list></t>

<t>In addition to the entities in the list above there is an orthogonal
infrastructure with a Trust Provisioning Authority (TPA) distributing
trust anchors and authorization permissions to various entities in
the system. The TPA may also delegate rights to install, update,
enhance, or delete trust anchors and authorization permissions to
other parties in the system. This infrastructure overlaps the
communication architecture and different deployments may empower
certain entities while other deployments may not. For example,
in some cases, the Original Design Manufacturer (ODM), which is a
company that designs and manufactures a product, may act as a
TPA and may decide to remain in full control over the firmware
update process of their products.</t>

<t>The terms ‘trust anchor’ and ‘trust anchor store’ are defined in
<xref target="RFC6024"/>:</t>

<t><list style="symbols">
  <t>“A trust anchor represents an authoritative entity via a public
key and associated data.  The public key is used to verify digital
signatures, and the associated data is used to constrain the types
of information for which the trust anchor is authoritative.”</t>
  <t>“A trust anchor store is a set of one or more trust anchors stored
in a device.  A device may have more than one trust anchor store,
each of which may be used by one or more applications.”
A trust anchor store must resist modification against unauthorized
insertion, deletion, and modification.</t>
</list></t>

</section>
<section anchor="requirements" title="Requirements">

<t>The firmware update mechanism described in this specification
was designed with the following requirements in mind:</t>

<t><list style="symbols">
  <t>Agnostic to how firmware images are distributed</t>
  <t>Friendly to broadcast delivery</t>
  <t>Use state-of-the-art security mechanisms</t>
  <t>Rollback attacks must be prevented</t>
  <t>High reliability</t>
  <t>Operate with a small bootloader</t>
  <t>Small Parsers</t>
  <t>Minimal impact on existing firmware formats</t>
  <t>Robust permissions</t>
  <t>Diverse modes of operation</t>
  <t>Suitability to software and personalization data</t>
</list></t>

<section anchor="agnostic-to-how-firmware-images-are-distributed" title="Agnostic to how firmware images are distributed">

<t>Firmware images can be conveyed to devices in a variety of ways,
including USB, UART, WiFi, BLE, low-power WAN technologies, etc.
and use different protocols (e.g., CoAP, HTTP). The specified
mechanism needs to be agnostic to the distribution of the
firmware images and manifests.</t>

</section>
<section anchor="friendly-to-broadcast-delivery" title="Friendly to broadcast delivery">

<t>This architecture does not specify any specific broadcast protocol.
However, given that broadcast may be desirable for some networks,
updates must cause the least disruption possible both in metadata
and firmware transmission.</t>

<t>For an update to be broadcast friendly, it cannot rely on link
layer, network layer, or transport layer security. A solution has
to rely on security protection applied to the manifest and firmware image
instead. In addition,
the same manifest must be deliverable to many devices, both those
to which it applies and those to which it does not, without a
chance that the wrong device will accept the update. Considerations
that apply to network broadcasts apply equally to the use of
third-party content distribution networks for payload distribution.</t>

</section>
<section anchor="use-state-of-the-art-security-mechanisms" title="Use state-of-the-art security mechanisms">

<t>End-to-end security between the author and the device is shown in
<xref target="architecture"/>.</t>

<t>Authentication ensures that the device can cryptographically identify
the author(s) creating firmware images and manifests. Authenticated
identities may be used as input to the authorization process.</t>

<t>Integrity protection ensures that no third party can modify the manifest
or the firmware image.</t>

<t>For confidentiality protection of the firmware image, it must be done in such a
way that every intended recipient can decrypt it. The information
that is encrypted individually for each device must maintain
friendliness to Content Distribution Networks, bulk storage, and
broadcast protocols.</t>

<t>A manifest specification must support different cryptographic algorithms
and algorithm extensibility. Due of the nature of
unchangeable code in ROM for use with bootloaders the use of
post-quantum secure signature mechanisms, such as hash-based
signatures <xref target="I-D.ietf-cose-hash-sig"/>, are attractive. These
algorithms maintain security in presence of quantum computers.</t>

<t>A mandatory-to-implement set of algorithms will be specified in the
manifest specification <xref target="I-D.ietf-suit-manifest"/>}.</t>

</section>
<section anchor="rollback-attacks-must-be-prevented" title="Rollback attacks must be prevented">

<t>A device presented with an old, but valid manifest and firmware
must not be tricked into installing such firmware since a
vulnerability in the old firmware image may allow an attacker to
gain control of the device.</t>

</section>
<section anchor="high-reliability" title="High reliability">

<t>A power failure at any time must not cause a failure of the device.
A failure to validate any part of an update must not cause a
failure of the device. One way to achieve this functionality is
to provide a minimum of two storage locations for firmware and one
bootable location for firmware. An alternative approach is to use a
2nd stage bootloader with build-in full featured firmware update
functionality such that it is possible to return to the update
process after power down.</t>

<t>Note: This is an implementation requirement rather than a requirement
on the manifest format.</t>

</section>
<section anchor="operate-with-a-small-bootloader" title="Operate with a small bootloader">

<t>Throughout this document we assume that the bootloader itself is
distinct from the role of the firmware consumer and therefore does not
manage the firmware update process. This may give the impression
that the bootloader itself is a completely separate component,
which is mainly responsible for selecting a firmware image to boot.</t>

<t>The overlap between the firmware update process and the bootloader
functionality comes in two forms, namely</t>

<t><list style="symbols">
  <t>First, a bootloader must verify the firmware image it boots as
part of the secure boot process. Doing so requires meta-data to be
stored alongside the firmware image so that the bootloader can
cryptographically verify the firmware image before booting it to
ensure it has not been tampered with or replaced. This meta-data
used by the bootloader may well be the same manifest obtained with the
firmware image during the update process (with the severable
fields stripped off).</t>
  <t>Second, an IoT device needs a recovery strategy in case the firmware
update / boot process fails. The recovery strategy may include
storing two or more firmware images on the device or offering the
ability to have a second stage bootloader perform the firmware update
process again using firmware updates over serial, USB or even
wireless connectivity like a limited version of Bluetooth Smart.
In the latter case the firmware consumer functionality is contained in the
second stage bootloader and requires the necessary functionality for
executing the firmware update process, including manifest parsing.</t>
</list></t>

<t>In general, it is assumed that the bootloader itself, or a minimal part of it,
will not be updated since a failed update of the bootloader poses a risk
in reliability.</t>

<t>All information necessary for a device to make a decision about the
installation of a firmware update must fit into the available RAM of
a constrained IoT device. This prevents flash write exhaustion.
This is typically not a difficult requirement to accomplish because
there are not other task/processing running while the bootloader is
active (unlike it may be the case when running the application firmware).</t>

<t>Note: This is an implementation requirement.</t>

</section>
<section anchor="small-parsers" title="Small Parsers">

<t>Since parsers are known sources of bugs they must be minimal.
Additionally, it must be easy to parse only those fields that are
required to validate at least one signature or MAC with minimal
exposure.</t>

</section>
<section anchor="minimal-impact-on-existing-firmware-formats" title="Minimal impact on existing firmware formats">

<t>The design of the firmware update mechanism must not require
changes to existing firmware formats.</t>

</section>
<section anchor="robust-permissions" title="Robust permissions">

<t>When a device obtains a monolithic firmware image from a single author
without any additional approval steps then the authorization flow is
relatively simple. There are, however, other cases where more complex
policy decisions need to be made before updating a device.</t>

<t>In this architecture the authorization policy is separated from
the underlying communication architecture. This is accomplished
by separating the entities from their permissions. For example,
an author may not have the authority to install a firmware image
on a device in critical infrastructure without the authorization
of a device operator. In this case, the device may be programmed
to reject firmware updates unless they are signed both by the
firmware author and by the device operator.</t>

<t>Alternatively, a device may trust precisely one entity, which
does all permission management and coordination. This entity
allows the device to offload complex permissions
calculations for the device.</t>

</section>
<section anchor="operating-modes" title="Operating modes">

<t>There are three broad classifications of update operating modes.</t>

<t><list style="symbols">
  <t>Client-initiated Update</t>
  <t>Server-initiated Update</t>
  <t>Hybrid Update</t>
</list></t>

<t>Client-initiated updates take the form of a firmware consumer on
a device proactively checking (polling) for new firmware images.</t>

<t>Server-initiated updates are important to consider because
timing of updates may need to be tightly controlled in some high-
reliability environments. In this case the status tracker determines
what devices qualify for a firmware update. Once those devices have been
selected the firmware server distributes updates to the firmware consumers.</t>

<t>Note: This assumes that the status tracker is able to reach the
device, which may require devices to keep reachability  information at
the status tracker up-to-date. This may also require keeping state at
NATs and stateful packet filtering firewalls alive.</t>

<t>Hybrid updates are those that require an interaction between the
firmware consumer and the status tracker. The status tracker
pushes notifications of availability of an update to the firmware consumer,
and it then downloads the image from a firmware server
as soon as possible.</t>

<t>An alternative view to the operating modes is to consider the steps a
device has to go through in the course of an update:</t>

<t><list style="symbols">
  <t>Notification</t>
  <t>Pre-authorisation</t>
  <t>Dependency resolution</t>
  <t>Download</t>
  <t>Installation</t>
</list></t>

<t>The notification step consists of the status tracker informing the
firmware consumer that an update is available. This can be accomplished via
polling (client-initiated), push notifications (server-initiated),
or more complex mechanisms.</t>

<t>The pre-authorisation step involves verifying whether the entity
signing the manifest is indeed authorized to perform an update.
The firmware consumer must also determine whether it should fetch and
process a firmware image, which is referenced in a manifest.</t>

<t>A dependency resolution phase is needed when more than one
component can be updated or when a differential update is used.
The necessary dependencies must be available prior to installation.</t>

<t>The download step is the process of acquiring a local copy of the
firmware image.  When the download is client-initiated, this means
that the firmware consumer chooses when a download occurs and initiates
the download process.  When a download is server-initiated,
this means that the status tracker tells
the device when to download or that it initiates the transfer
directly to the firmware consumer. For example, a download from an
HTTP-based firmware server is client-initiated. Pushing a manifest
and firmware image to the transfer to the Package resource of the LwM2M
Firmware Update object <xref target="LwM2M"/> is server-initiated.</t>

<t>If the firmware consumer has downloaded a new firmware image and is ready to
install it, it may need to wait for a trigger from the status tracker to
initiate the installation, may trigger the update automatically, or
may go through a more complex decision making process to determine
the appropriate timing for an update (such as delaying the update
process to a later time when end users are less impacted by the
update process).</t>

<t>Installation is the act of processing the payload into a format that
the IoT device can recognise and the bootloader is responsible for
then booting from the newly installed firmware image.</t>

<t>Each of these steps may require different permissions.</t>

</section>
<section anchor="suitability-to-software-and-personalization-data" title="Suitability to software and personalization data">

<t>The work on a standardized manifest format initially focused on the
most constrained IoT devices and those devices contain code put together
by a single author (although that author may obtain code from other
developers, some of it only in binary form).</t>

<t>Later it turns out that other use cases may benefit from a standardized
manifest format also for conveying software and even personalization data
alongside software. Trusted Execution Environments (TEEs), for example,
greatly benefit from a protocol for managing the lifecycle of trusted
applications (TAs) running inside a TEE. TEEs may obtain TAs
from different authors and those TAs may require personalization data,
such as payment information, to be securely conveyed to the TEE.</t>

<t>To support this wider range of use cases the manifest format should
therefore be extensible to convey other forms of payloads as well.</t>

</section>
</section>
<section anchor="claims" title="Claims">

<t>Claims in the manifest offer a way to convey instructions to
a device that impact the firmware update process. To have any
value the manifest containing those claims must be authenticated
and integrity protected. The credential used must be directly
or indirectly related to the trust anchor installed at the device
by the Trust Provisioning Authority.</t>

<t>The baseline claims for all manifests are described in <xref target="I-D.ietf-suit-information-model"/>.
For example, there are:</t>

<t><list style="symbols">
  <t>Do not install firmware with earlier metadata than the current
metadata.</t>
  <t>Only install firmware with a matching vendor, model, hardware
revision, software version, etc.</t>
  <t>Only install firmware that is before its best-before timestamp.</t>
  <t>Only allow a firmware installation if dependencies have been met.</t>
  <t>Choose the mechanism to install the firmware, based on the type
of firmware it is.</t>
</list></t>

</section>
<section anchor="architecture" title="Communication Architecture">

<t><xref target="arch-figure"/> shows the communication architecture where a
firmware image is created by an author, and uploaded to a firmware
server. The firmware image/manifest is distributed to the device
either in a push or pull manner using the firmware consumer residing on
the device. The device operator keeps track of the process using
the status tracker. This allows the device operator to know and
control what devices have received an update and which of them are
still pending an update.</t>

<figure title="Architecture." anchor="arch-figure"><artwork><![CDATA[
              Firmware +  +----------+       Firmware + +-----------+
              Manifest    |          |-+     Manifest   |           |-+
               +--------->| Firmware | |<---------------|           | |
               |          | Server   | |                |  Author   | |
               |          |          | |                |           | |
               |          +----------+ |                +-----------+ |
               |            +----------+                  +-----------+
               |
               |
               |
              -+--                                  ------
         ----  |  ----                          ----      ----
       //      |      \\                      //              \\
      /        |        \                    /                  \
     /         |         \                  /                    \
    /          |          \                /                      \
   /           |           \              /                        \
  |            v            |            |                          |
  |     +------------+                                              |
  |     |  Firmware  |      |            |                          |
 |      |  Consumer  |       | Device    |       +--------+          |
 |      +------------+       | Management|       |        |          |
 |      |            |<------------------------->| Status |          |
 |      |   Device   |       |          |        | Tracker|          |
 |      +------------+       |          ||       |        |         |
  |                         |           ||       +--------+         |
  |                         |            |                          |
  |                         |             \                        /
   \                       /               \                      /
    \                     /                 \      Device        /
     \     Network       /                   \     Operator     /
      \   Operator      /                     \\              //
       \\             //                        ----      ----
         ----     ----                              ------
             -----

]]></artwork></figure>

<t>End-to-end security mechanisms are used to protect the firmware
image and the manifest although <xref target="e2e-figure"/> does not show the
manifest itself since it may be distributed independently.</t>

<figure title="End-to-End Security." anchor="e2e-figure"><artwork><![CDATA[
                            +-----------+
+--------+                  |           |                   +--------+
|        |  Firmware Image  | Firmware  |   Firmware Image  |        |
| Device |<-----------------| Server    |<------------------| Author |
|        |                  |           |                   |        |
+--------+                  +-----------+                   +--------+
     ^                                                          *
     *                                                          *
     ************************************************************
                        End-to-End Security
]]></artwork></figure>

<t>Whether the firmware image and the manifest is pushed to the device or
fetched by the device is a deployment specific decision.</t>

<t>The following assumptions are made to allow the firmware consumer to verify the
received firmware image and manifest before updating software:</t>

<t><list style="symbols">
  <t>To accept an update, a device needs to verify the signature covering
the manifest. There may be one or multiple manifests that need to be
validated, potentially signed by different parties. The device needs
to be in possession of the trust anchors to verify those signatures.
Installing trust anchors to devices via the Trust Provisioning Authority
happens in an out-of-band fashion prior to the firmware update process.</t>
  <t>Not all entities creating and signing manifests have the same
permissions. A device needs to determine whether the requested action
is indeed covered by the permission of the party that signed the manifest.
Informing the device about the permissions of the different parties
also happens in an out-of-band fashion and is also a duty of the
Trust Provisioning Authority.</t>
  <t>For confidentiality protection of firmware images the author needs
to be in possession of the certificate/public key or a pre-shared key
of a device. The use of confidentiality protection of firmware images
is deployment specific.</t>
</list></t>

<t>There are different types of delivery modes, which are illustrated
based on examples below.</t>

<t>There is an option for embedding a firmware image into a manifest.
This is a useful approach for deployments where devices are not connected
to the Internet and cannot contact a dedicated firmware server for the firmware
download. It is also applicable when the firmware update happens via a
USB stick or via Bluetooth Smart. <xref target="attached-firmware-figure"/> shows this
delivery mode graphically.</t>

<figure title="Manifest with attached firmware." anchor="attached-firmware-figure"><artwork><![CDATA[
              /------------\                 /------------\
             /Manifest with \               /Manifest with \
             |attached      |               |attached      |
             \firmware image/               \firmware image/
              \------------/  +-----------+  \------------/
  +--------+                  |           |                 +--------+
  |        |<.................| Firmware  |<................|        |
  | Device |                  | Server    |                 | Author |
  |        |                  |           |                 |        |
  +--------+                  +-----------+                 +--------+
]]></artwork></figure>

<t><xref target="online-firmware-figure"/> shows an option for remotely updating a device
where the device fetches the firmware image from some file server. The
manifest itself is delivered independently and provides information about
the firmware image(s) to download.</t>

<figure title="Independent retrieval of the firmware image." anchor="online-firmware-figure"><artwork><![CDATA[
             /--------\                     /--------\
            /          \                   /          \
            | Manifest |                   | Manifest |
            \          /                   \          /
             \--------/                     \--------/
                            +-----------+
+--------+                  |           |                 +--------+
|        |<.................| Status    |................>|        |
| Device |                  | Tracker   |              -- | Author |
|        |<-                |           |            ---  |        |
+--------+  --              +-----------+          ---    +--------+
              --                                 ---
                ---                            ---
                   --       +-----------+    --
                     --     |           |  --
      /------------\   --   | Firmware  |<-    /------------\
     /              \    -- | Server    |     /              \
     |   Firmware   |       |           |     |   Firmware   |
     \              /       +-----------+     \              /
      \------------/                           \------------/
]]></artwork></figure>

<t>This architecture does not mandate a specific delivery mode but a solution
must support both types.</t>

</section>
<section anchor="manifest" title="Manifest">

<t>In order for a device to apply an update, it has to make several decisions
about the update:</t>

<t><list style="symbols">
  <t>Does it trust the author of the update?</t>
  <t>Has the firmware been corrupted?</t>
  <t>Does the firmware update apply to this device?</t>
  <t>Is the update older than the active firmware?</t>
  <t>When should the device apply the update?</t>
  <t>How should the device apply the update?</t>
  <t>What kind of firmware binary is it?</t>
  <t>Where should the update be obtained?</t>
  <t>Where should the firmware be stored?</t>
</list></t>

<t>The manifest encodes the information that devices need in order to
make these decisions. It is a data structure that contains the
following information:</t>

<t><list style="symbols">
  <t>information about the device(s) the firmware image is intended to
be applied to,</t>
  <t>information about when the firmware update has to be applied,</t>
  <t>information about when the manifest was created,</t>
  <t>dependencies on other manifests,</t>
  <t>pointers to the firmware image and information about the format,</t>
  <t>information about where to store the firmware image,</t>
  <t>cryptographic information, such as digital signatures or message
authentication codes (MACs).</t>
</list></t>

<t>The manifest information model is described in <xref target="I-D.ietf-suit-information-model"/>.</t>

</section>
<section anchor="device-firmware-update-examples" title="Device Firmware Update Examples">

<t>Although these documents attempt to define a firmware update
architecture that is applicable to both existing systems, as well
as yet-to-be-conceived systems; it is still helpful to consider
existing architectures.</t>

<section anchor="single-cpu-soc" title="Single CPU SoC">

<t>The simplest, and currently most common, architecture consists of
a single MCU along with its own peripherals.  These SoCs generally
contain some amount of flash memory for code and fixed data, as
well as RAM for working storage.  These systems either have a single
firmware image, or an immutable bootloader that runs a single image.
A notable characteristic of these SoCs is that the primary code is
generally execute in place (XIP).  Combined with the non-relocatable
nature of the code, firmware updates need to be done in place.</t>

</section>
<section anchor="single-cpu-with-secure-normal-mode-partitioning" title="Single CPU with Secure - Normal Mode Partitioning">

<t>Another configuration consists of a similar architecture to the
previous, with a single CPU.  However, this CPU supports a security
partitioning scheme that allows memory (in addition to other things)
to be divided into secure and normal mode.  There will generally be
two images, one for secure mode, and one for normal mode.  In this
configuration, firmware upgrades will generally be done by the CPU
in secure mode, which is able to write to both areas of the flash
device. In addition, there are requirements to be able to update
either image independently, as well as to update them together
atomically, as specified in the associated manifests.</t>

</section>
<section anchor="dual-cpu-shared-memory" title="Dual CPU, shared memory">

<t>This configuration has two or more CPUs in a single SoC that share
memory (flash and RAM).  Generally, they will be a protection mechanism
to prevent one CPU from accessing the other’s memory. Upgrades in this
case will typically be done by one of the CPUs, and is similar to the
single CPU with secure mode.</t>

</section>
<section anchor="dual-cpu-other-bus" title="Dual CPU, other bus">

<t>This configuration has two or more CPUs, each having their own memory.
There will be a communication channel between them, but it will be
used as a peripheral, not via shared memory.  In this case, each CPU
will have to be responsible for its own firmware upgrade.  It is
likely that one of the CPUs will be considered a master, and will
direct the other CPU to do the upgrade.  This configuration is
commonly used to offload specific work to other CPUs.  Firmware
dependencies are similar to the other solutions above, sometimes
allowing only one image to be upgraded, other times requiring several
to be upgraded atomically.  Because the updates are happening on
multiple CPUs, upgrading the two images atomically is challenging.</t>

</section>
</section>
<section anchor="bootloader" title="Bootloader">

<t>More devices today than ever before are being connected to the Internet,
which drives the need for firmware updates to be provided over the
Internet rather than through traditional interfaces, such as USB or
RS232. Updating a device over the Internet requires the device to fetch
not only the firmware image but also the manifest. Hence, the following
building blocks are necessary for a firmware update solution:</t>

<t><list style="symbols">
  <t>the Internet protocol stack for firmware downloads (*),</t>
  <t>the capability to write the received firmware image to
persistent storage (most likely flash memory) prior to performing
the update,</t>
  <t>the ability to unpack, decompress or otherwise process the received
firmware image,</t>
  <t>the features to verify an image and a manifest, including digital
signature verification or checking a message authentication code,</t>
  <t>a manifest parsing library, and</t>
  <t>integration of the device into a device management server to
perform automatic firmware updates and to track their progress.</t>
</list></t>

<t>(*) Because firmware images are often multiple kilobytes, sometimes
exceeding one hundred kilobytes, in size for low end IoT devices and even
several megabytes large for IoT devices running full-fledged operating systems
like Linux, the protocol mechanism for retrieving these images needs
to offer features like congestion control, flow control, fragmentation
and reassembly, and mechanisms to resume interrupted or corrupted transfers.</t>

<t>All these features are most likely offered by the application, i.e.
firmware consumer, running
on the device (except for basic security algorithms that may run
either on a trusted execution environment or on a separate hardware
security MCU/module) rather than by the bootloader itself.</t>

<t>Once manifests have been processed and firmware images successfully
downloaded and verified the device needs to hand control over to the
bootloader.  In most cases this requires the MCU to restart. Once the
MCU has initiated a restart, the bootloader takes over control and
determines whether the newly downloaded firmware
image should be executed.</t>

<t>The boot process is security sensitive
because the firmware images may, for example, be stored in off-chip
flash memory giving attackers easy access to the image for reverse
engineering and potentially also for modifying the binary.  The
bootloader will therefore have to perform security checks on the
firmware image before it can be booted. These security checks by the
bootloader happen in addition to the security checks that happened
when the firmware image and the manifest were downloaded.</t>

<t>The manifest may have been stored alongside the firmware image to
allow re-verification of the firmware image during every boot
attempt.  Alternatively, secure boot-specific meta-data may have been
created by the application after a successful firmware download
and verification process.  Whether to re-use the standardized
manifest format that was used during the initial firmware retrieval
process or whether it is better to use a different format for the
secure boot-specific meta-data depends on the system design.  The
manifest format does, however, have the capability to serve also as a
building block for secure boot with its severable elements that allow
shrinking the size of the manifest by stripping elements that are no
longer needed.</t>

<t>If the application image contains the firmware consumer
functionality, as described above, then it is necessary that a
working image is left on the device. This allows the bootloader to
roll back to a working firmware image to execute a firmware download
if the bootloader itself does not have enough functionality to
fetch a firmware image plus manifest from a firmware server over the
Internet.  A multi-stage bootloader may soften this requirement at
the expense of a more sophisticated boot process.</t>

<t>For a bootloader to offer a secure boot mechanism it needs to provide
the following features:</t>

<t><list style="symbols">
  <t>ability to access security algorithms, such as SHA-256 to compute
a fingerprint over the firmware image and a digital signature
algorithm.</t>
  <t>access keying material directly or indirectly to utilize the
digital signature.  The device needs to have a trust anchor store.</t>
  <t>ability to expose boot process-related data to the application
firmware (such as to the device management software).  This allows
a device management server to determine whether the firmware
update has been successful and, if not, what errors occurred.</t>
  <t>to (optionally) offer attestation information (such as
measurements).</t>
</list></t>

<t>While the software architecture of the bootloader and its
security mechanisms are implementation-specific, the manifest can
be used to control the firmware download from the Internet in
addition to augmenting secure boot process. These building blocks
are highly relevant for the design of the manifest.</t>

</section>
<section anchor="example" title="Example">

<t><xref target="firmware-update"/> illustrates an example message flow
for distributing a firmware image to a device
starting with an author uploading the new firmware to
firmware server and creating a manifest. The firmware
and manifest are stored on the same firmware server. This
setup does not use a status tracker and the firmware consumer
component is therefore responsible for periodically checking
whether a new firmware image is available for download.</t>

<figure title="First Example Flow for a Firmware Upate." anchor="firmware-update"><artwork><![CDATA[
+--------+    +-----------------+      +------------+ +----------+
|        |    |                 |      |  Firmware  | |          |
| Author |    | Firmware Server |      |  Consumer  | |Bootloader|
+--------+    +-----------------+      +------------+ +----------+
  |                   |                     |                +
  | Create Firmware   |                     |                |
  |--------------+    |                     |                |
  |              |    |                     |                |
  |<-------------+    |                     |                |
  |                   |                     |                |
  | Upload Firmware   |                     |                |
  |------------------>|                     |                |
  |                   |                     |                |
  | Create Manifest   |                     |                |
  |---------------+   |                     |                |
  |               |   |                     |                |
  |<--------------+   |                     |                |
  |                   |                     |                |
  | Sign Manifest     |                     |                |
  |-------------+     |                     |                |
  |             |     |                     |                |
  |<------------+     |                     |                |
  |                   |                     |                |
  | Upload Manifest   |                     |                |
  |------------------>|                     |                |
  |                   |                     |                |
  |                   |   Query Manifest    |                |
  |                   |<--------------------|                |
  |                   |                     |                |
  |                   |   Send Manifest     |                |
  |                   |-------------------->|                |
  |                   |                     | Validate       |
  |                   |                     | Manifest       |
  |                   |                     |---------+      |
  |                   |                     |         |      |
  |                   |                     |<--------+      |
  |                   |                     |                |
  |                   |  Request Firmware   |                |
  |                   |<--------------------|                |
  |                   |                     |                |
  |                   | Send Firmware       |                |
  |                   |-------------------->|                |
  |                   |                     | Verify         |
  |                   |                     | Firmware       |
  |                   |                     |--------------+ |
  |                   |                     |              | |
  |                   |                     |<-------------+ |
  |                   |                     |                |
  |                   |                     | Store          |
  |                   |                     | Firmware       |
  |                   |                     |-------------+  |
  |                   |                     |             |  |
  |                   |                     |<------------+  |
  |                   |                     |                |
  |                   |                     |                |
  |                   |                     | Trigger Reboot |
  |                   |                     |--------------->|
  |                   |                     |                |
  |                   |                     |                |
  |                   |                 +---+----------------+--+
  |                   |                S|   |                |  |
  |                   |                E|   | Verify         |  |
  |                   |                C|   | Firmware       |  |
  |                   |                U|   | +--------------|  |
  |                   |                R|   | |              |  |
  |                   |                E|   | +------------->|  |
  |                   |                 |   |                |  |
  |                   |                B|   | Activate new   |  |
  |                   |                O|   | Firmware       |  |
  |                   |                O|   | +--------------|  |
  |                   |                T|   | |              |  |
  |                   |                 |   | +------------->|  |
  |                   |                P|   |                |  |
  |                   |                R|   | Boot new       |  |
  |                   |                O|   | Firmware       |  |
  |                   |                C|   | +--------------|  |
  |                   |                E|   | |              |  |
  |                   |                S|   | +------------->|  |
  |                   |                S|   |                |  |
  |                   |                 +---+----------------+--+
  |                   |                     |                |
]]></artwork></figure>

<t><xref target="firmware-update2"/> shows an example follow with the device using
a status tracker. For editorial reasons the author publishing the
manifest at the status tracker and the firmware image at the firmware
server is not shown. Also omitted is the secure boot process
following the successful firmware update process.</t>

<t>The exchange starts with the device interacting with the status
tracker; the details of such exchange will vary with the different
device management systems being used. In any case, the status
tracker learns about the firmware version of the devices it
manages. In our example, the device under management is using
firmware version A.B.C. At a later point in time the author uploads
a new firmware along with the manifest to the firmware server and the
status tracker, respectively. While there is no need to store the
manifest and the firmware on different servers this example shows
a common pattern used in the industry. The status tracker may then
automatically, based on human intervention or based on a more
complex policy decide to inform the device about the newly available
firmware image. In our example, it does so by pushing the manifest
to the firmware consumer. The firmware consumer downloads the firmware
image with the newer version X.Y.Z after successful validation
of the manifest. Subsequently, a reboot is initiated and the secure
boot process starts.</t>

<figure title="Second Example Flow for a Firmware Upate." anchor="firmware-update2"><artwork><![CDATA[
 +---------+   +-----------------+    +-----------------------------+
 | Status  |   |                 |    | +------------+ +----------+ |
 | Tracker |   | Firmware Server |    | |  Firmware  | |Bootloader| |
 |         |   |                 |    | |  Consumer  | |          | |
 +---------+   +-----------------+    | +------------+ +----------+ |
      |                |              |      |  IoT Device    |     |
      |                |               `''''''''''''''''''''''''''''
      |                |                     |                |
      |        Query Firmware Version        |                |
      |------------------------------------->|                |
      |        Firmware Version A.B.C        |                |
      |<-------------------------------------|                |
      |                |                     |                |
      |         <<some time later>>          |                |
      |                |                     |                |
    _,...._         _,...._                  |                |
  ,'       `.     ,'       `.                |                |
 |   New     |   |   New     |               |                |
 \ Manifest  /   \ Firmware  /               |                |
  `.._   _,,'     `.._   _,,'                |                |
      `''             `''                    |                |
      |            Push manifest             |                |
      |----------------+-------------------->|                |
      |                |                     |                |
      |                '                     |                '
      |                |                     | Validate       |
      |                |                     | Manifest       |
      |                |                     |---------+      |
      |                |                     |         |      |
      |                |                     |<--------+      |
      |                | Request firmware    |                |
      |                | X.Y.Z               |                |
      |                |<--------------------|                |
      |                |                     |                |
      |                | Firmware X.Y.Z      |                |
      |                |-------------------->|                |
      |                |                     |                |
      |                |                     | Verify         |
      |                |                     | Firmware       |
      |                |                     |--------------+ |
      |                |                     |              | |
      |                |                     |<-------------+ |
      |                |                     |                |
      |                |                     | Store          |
      |                |                     | Firmware       |
      |                |                     |-------------+  |
      |                |                     |             |  |
      |                |                     |<------------+  |
      |                |                     |                |
      |                |                     |                |
      |                |                     | Trigger Reboot |
      |                |                     |--------------->|
      |                |                     |                |
      |                |                     |                |
      |                |                     | __..-------..._'
      |                |                    ,-'               `-.
      |                |                   |      Secure Boot    |
      |                |                   `-.                 _/
      |                |                     |`--..._____,,.,-'
      |                |                     |                |
]]></artwork></figure>

</section>
<section anchor="iana-considerations" title="IANA Considerations">

<t>This document does not require any actions by IANA.</t>

</section>
<section anchor="security-considerations" title="Security Considerations">

<t>Firmware updates fix security vulnerabilities and are considered to be
an important building block in securing IoT devices. Due to the
importance of firmware updates for IoT devices the Internet
Architecture Board (IAB) organized a ‘Workshop on Internet of Things
(IoT) Software Update (IOTSU)’, which took place at Trinity College
Dublin, Ireland on the 13th and 14th of June, 2016 to take a look at
the big picture. A report about this workshop can be found at
<xref target="RFC8240"/>. A standardized firmware manifest format providing
end-to-end security from the author to the device will be specified
in a separate document.</t>

<t>There are, however, many other considerations raised during the
workshop. Many of them are outside the scope of standardization
organizations since they fall into the realm of product engineering,
regulatory frameworks, and business models. The following
considerations are outside the scope of this document, namely</t>

<t><list style="symbols">
  <t>installing firmware updates in a robust fashion so that the
update does not break the device functionality of the environment
this device operates in.</t>
  <t>installing firmware updates in a timely fashion considering the
complexity of the decision making process of updating devices,
potential re-certification requirements, and the need for user
consent to install updates.</t>
  <t>the distribution of the actual firmware update, potentially in
an efficient manner to a large number of devices without human
involvement.</t>
  <t>energy efficiency and battery lifetime considerations.</t>
  <t>key management required for verifying the digital signature
protecting the manifest.</t>
  <t>incentives for manufacturers to offer a firmware update mechanism
as part of their IoT products.</t>
</list></t>

</section>
<section anchor="mailing-list-information" title="Mailing List Information">

<t>The discussion list for this document is located at the e-mail
address <eref target="mailto:suit@ietf.org">suit@ietf.org</eref>. Information on the group and information on how to
subscribe to the list is at <eref target="https://www1.ietf.org/mailman/listinfo/suit">https://www1.ietf.org/mailman/listinfo/suit</eref></t>

<t>Archives of the list can be found at:
<eref target="https://www.ietf.org/mail-archive/web/suit/current/index.html">https://www.ietf.org/mail-archive/web/suit/current/index.html</eref></t>

</section>
<section anchor="acknowledgements" title="Acknowledgements">

<t>We would like to thank the following persons for their feedback:</t>

<t><list style="symbols">
  <t>Geraint Luff</t>
  <t>Amyas Phillips</t>
  <t>Dan Ros</t>
  <t>Thomas Eichinger</t>
  <t>Michael Richardson</t>
  <t>Emmanuel Baccelli</t>
  <t>Ned Smith</t>
  <t>Jim Schaad</t>
  <t>Carsten Bormann</t>
  <t>Cullen Jennings</t>
  <t>Olaf Bergmann</t>
  <t>Suhas Nandakumar</t>
  <t>Phillip Hallam-Baker</t>
  <t>Marti Bolivar</t>
  <t>Andrzej Puzdrowski</t>
  <t>Markus Gueller</t>
  <t>Henk Birkholz</t>
  <t>Jintao Zhu</t>
  <t>Takeshi Takahashi</t>
  <t>Jacob Beningo</t>
  <t>Kathleen Moriarty</t>
</list></t>

<t>We would also like to thank the WG chairs, Russ Housley, David Waltermire,
Dave Thaler for their support and their reviews.</t>

</section>


  </middle>

  <back>

    <references title='Normative References'>





<reference  anchor="RFC7925" target='https://www.rfc-editor.org/info/rfc7925'>
<front>
<title>Transport Layer Security (TLS) / Datagram Transport Layer Security (DTLS) Profiles for the Internet of Things</title>
<author initials='H.' surname='Tschofenig' fullname='H. Tschofenig' role='editor'><organization /></author>
<author initials='T.' surname='Fossati' fullname='T. Fossati'><organization /></author>
<date year='2016' month='July' />
<abstract><t>A common design pattern in Internet of Things (IoT) deployments is the use of a constrained device that collects data via sensors or controls actuators for use in home automation, industrial control systems, smart cities, and other IoT deployments.</t><t>This document defines a Transport Layer Security (TLS) and Datagram Transport Layer Security (DTLS) 1.2 profile that offers communications security for this data exchange thereby preventing eavesdropping, tampering, and message forgery.  The lack of communication security is a common vulnerability in IoT products that can easily be solved by using these well-researched and widely deployed Internet security protocols.</t></abstract>
</front>
<seriesInfo name='RFC' value='7925'/>
<seriesInfo name='DOI' value='10.17487/RFC7925'/>
</reference>




    </references>

    <references title='Informative References'>





<reference  anchor="RFC8240" target='https://www.rfc-editor.org/info/rfc8240'>
<front>
<title>Report from the Internet of Things Software Update (IoTSU) Workshop 2016</title>
<author initials='H.' surname='Tschofenig' fullname='H. Tschofenig'><organization /></author>
<author initials='S.' surname='Farrell' fullname='S. Farrell'><organization /></author>
<date year='2017' month='September' />
<abstract><t>This document provides a summary of the Internet of Things Software Update (IoTSU) Workshop that took place at Trinity College Dublin, Ireland on the 13th and 14th of June, 2016.  The main goal of the workshop was to foster a discussion on requirements, challenges, and solutions for bringing software and firmware updates to IoT devices. This report summarizes the discussions and lists recommendations to the standards community.</t><t>Note that this document is a report on the proceedings of the workshop.  The views and positions documented in this report are those of the workshop participants and do not necessarily reflect IAB views and positions.</t></abstract>
</front>
<seriesInfo name='RFC' value='8240'/>
<seriesInfo name='DOI' value='10.17487/RFC8240'/>
</reference>



<reference  anchor="RFC6024" target='https://www.rfc-editor.org/info/rfc6024'>
<front>
<title>Trust Anchor Management Requirements</title>
<author initials='R.' surname='Reddy' fullname='R. Reddy'><organization /></author>
<author initials='C.' surname='Wallace' fullname='C. Wallace'><organization /></author>
<date year='2010' month='October' />
<abstract><t>A trust anchor represents an authoritative entity via a public key and associated data.  The public key is used to verify digital signatures, and the associated data is used to constrain the types of information for which the trust anchor is authoritative.  A relying party uses trust anchors to determine if a digitally signed object is valid by verifying a digital signature using the trust anchor's public key, and by enforcing the constraints expressed in the associated data for the trust anchor.  This document describes some of the problems associated with the lack of a standard trust anchor management mechanism and defines requirements for data formats and push-based protocols designed to address these problems.  This  document is not an Internet Standards Track specification; it is published for informational purposes.</t></abstract>
</front>
<seriesInfo name='RFC' value='6024'/>
<seriesInfo name='DOI' value='10.17487/RFC6024'/>
</reference>



<reference  anchor="RFC5649" target='https://www.rfc-editor.org/info/rfc5649'>
<front>
<title>Advanced Encryption Standard (AES) Key Wrap with Padding Algorithm</title>
<author initials='R.' surname='Housley' fullname='R. Housley'><organization /></author>
<author initials='M.' surname='Dworkin' fullname='M. Dworkin'><organization /></author>
<date year='2009' month='September' />
<abstract><t>This document specifies a padding convention for use with the AES Key Wrap algorithm specified in RFC 3394.  This convention eliminates the requirement that the length of the key to be wrapped be a multiple of 64 bits, allowing a key of any practical length to be wrapped.  This  memo provides information for the Internet community.</t></abstract>
</front>
<seriesInfo name='RFC' value='5649'/>
<seriesInfo name='DOI' value='10.17487/RFC5649'/>
</reference>



<reference  anchor="RFC7228" target='https://www.rfc-editor.org/info/rfc7228'>
<front>
<title>Terminology for Constrained-Node Networks</title>
<author initials='C.' surname='Bormann' fullname='C. Bormann'><organization /></author>
<author initials='M.' surname='Ersue' fullname='M. Ersue'><organization /></author>
<author initials='A.' surname='Keranen' fullname='A. Keranen'><organization /></author>
<date year='2014' month='May' />
<abstract><t>The Internet Protocol Suite is increasingly used on small devices with severe constraints on power, memory, and processing resources, creating constrained-node networks.  This document provides a number of basic terms that have been useful in the standardization work for constrained-node networks.</t></abstract>
</front>
<seriesInfo name='RFC' value='7228'/>
<seriesInfo name='DOI' value='10.17487/RFC7228'/>
</reference>



<reference anchor="I-D.ietf-suit-information-model">
<front>
<title>An Information Model for Firmware Updates in IoT Devices</title>

<author initials='B' surname='Moran' fullname='Brendan Moran'>
    <organization />
</author>

<author initials='H' surname='Tschofenig' fullname='Hannes Tschofenig'>
    <organization />
</author>

<author initials='H' surname='Birkholz' fullname='Henk Birkholz'>
    <organization />
</author>

<date month='January' day='20' year='2020' />

<abstract><t>Vulnerabilities with Internet of Things (IoT) devices have raised the need for a solid and secure firmware update mechanism that is also suitable for constrained devices.  Ensuring that devices function and remain secure over their service life requires such an update mechanism to fix vulnerabilities, to update configuration settings, as well as adding new functionality  One component of such a firmware update is a concise and machine- processable meta-data document, or manifest, that describes the firmware image(s) and offers appropriate protection.  This document describes the information that must be present in the manifest.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-suit-information-model-05' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-suit-information-model-05.txt' />
</reference>



<reference anchor="I-D.ietf-teep-architecture">
<front>
<title>Trusted Execution Environment Provisioning (TEEP) Architecture</title>

<author initials='M' surname='Pei' fullname='Mingliang Pei'>
    <organization />
</author>

<author initials='H' surname='Tschofenig' fullname='Hannes Tschofenig'>
    <organization />
</author>

<author initials='D' surname='Thaler' fullname='Dave Thaler'>
    <organization />
</author>

<author initials='D' surname='Wheeler' fullname='David Wheeler'>
    <organization />
</author>

<date month='April' day='4' year='2020' />

<abstract><t>A Trusted Execution Environment (TEE) is an environment that enforces that any code within that environment cannot be tampered with, and that any data used by such code cannot be read or tampered with by any code outside that environment.  This architecture document motivates the design and standardization of a protocol for managing the lifecycle of trusted applications running inside such a TEE.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-teep-architecture-08' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-teep-architecture-08.txt' />
</reference>



<reference anchor="I-D.ietf-cose-hash-sig">
<front>
<title>Use of the HSS/LMS Hash-based Signature Algorithm with CBOR Object Signing and Encryption (COSE)</title>

<author initials='R' surname='Housley' fullname='Russ Housley'>
    <organization />
</author>

<date month='December' day='11' year='2019' />

<abstract><t>This document specifies the conventions for using the Hierarchical Signature System (HSS) / Leighton-Micali Signature (LMS) hash-based signature algorithm with the CBOR Object Signing and Encryption (COSE) syntax.  The HSS/LMS algorithm is one form of hash-based digital signature; it is described in RFC 8554.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-cose-hash-sig-09' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-cose-hash-sig-09.txt' />
</reference>



<reference anchor="I-D.ietf-suit-manifest">
<front>
<title>A Concise Binary Object Representation (CBOR)-based Serialization Format for the Software Updates for Internet of Things (SUIT) Manifest</title>

<author initials='B' surname='Moran' fullname='Brendan Moran'>
    <organization />
</author>

<author initials='H' surname='Tschofenig' fullname='Hannes Tschofenig'>
    <organization />
</author>

<author initials='H' surname='Birkholz' fullname='Henk Birkholz'>
    <organization />
</author>

<author initials='K' surname='Zandberg' fullname='Koen Zandberg'>
    <organization />
</author>

<date month='March' day='9' year='2020' />

<abstract><t>This specification describes the format of a manifest.  A manifest is a bundle of metadata about the firmware for an IoT device, where to find the firmware, the devices to which it applies, and cryptographic information protecting the manifest.  Firmware updates and trusted boot both tend to use sequences of common operations, so the manifest encodes those sequences of operations, rather than declaring the metadata.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-suit-manifest-04' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-suit-manifest-04.txt' />
</reference>


<reference anchor="LwM2M" target="http://www.openmobilealliance.org/release/LightweightM2M/V1_0_2-20180209-A/OMA-TS-LightweightM2M-V1_0_2-20180209-A.pdf">
  <front>
    <title>Lightweight Machine to Machine Technical Specification, Version 1.0.2</title>
    <author initials="." surname="OMA" fullname="Open Mobile Alliance">
      <organization></organization>
    </author>
    <date year="2018" month="February" day="09"/>
  </front>
  <format type="PDF" target="http://www.openmobilealliance.org/release/LightweightM2M/V1_0_2-20180209-A/OMA-TS-LightweightM2M-V1_0_2-20180209-A.pdf"/>
</reference>


    </references>




  </back>

<!-- ##markdown-source:
H4sIAOx8zl4AA9V9aXfbVprmd52j/4CTfIickJTjrqqucmfSJS+puCaOPZZS
6emTMymQAEW0QYCDRTJje377vM+73AUAZcv2dE3rQ2ICuPu7b3c+nx8fdUVX
5veTs+S7otlep02e/LTL0i5PzprVpujyVdfTs3XdJE+qLm+qvEvqdXKxKarL
9vgoXS6b/Or9mtcXx0dZvarSLY2XNem6mxd5t563fdHN0+Dz+dd3j49W1Mll
3ezvJ0W1ro+Pjo+KXXM/2TX57//pn/940fRtd+/u3T/dvUeTaPL0fnKer/qm
6PbHR9d18/KyqfsdPfzpCY36Mt/Ts+y+W8L8EYZHp22XVtmvaVlXNKl9Tkva
FfePj5KkWa/yrO32pT1Pkq5ehf8uqiyvOvekrZuuydetf7Dfxr+7plj571f1
dkvt/fuiKosqGC1/1c3Lou3m1NGyLunDef3lV3hFu7hNdzs6Av067btN3WDe
c7znv6KiFg8WydO6SSv3VHb/QZNXWVoN3tXNZVoVv6VdUVd0pM02+aHY0qFk
7ot8mxala77g5n9Om+2CFoPdHA7//SK5aFebep1XxeVgDt+nVZW3U+/fex4b
7mLRuS5umsujBc27vh5uxaP0qsgGb+IJ/FBUaVMPx87QbrFEuz+X/MWCmk0N
/JTOIG+KdDUY+WlR1jTz4ct48Id11fYlAWk3nMBWmv95y81t1VXdbKnpVc5A
/OK7h//8p3u/p38DiQZv/njvd3ft33+4e+939u/f/+F3f3Kt7937I//7yfzR
wmOr662u5ts6y8v4my7PdxFGx69XdZvPN2m7mbfF5UTvW1r/Om87fvXD9dN7
T+/L4ru0ucwJgzZdt7t/enp9fb2od3m1rZdFmadlWaTVKscxnDY5PWjz0x+K
y013neO/1M3p377+9e6v9+b37n79x7v37v5pfnb67OnZ/OJ8Hn83H3232GVr
nYPQy8+CFsnTlJZa5UQU3D8v8tWmKlZpmZzv8lWxpn9it2bJ3/KmpX8kXy/u
Lu59Jn169PVQQxOz3wIuz2ilhLBYanKma5UvQG/vJ5js/O69+d0/yVM5Idfp
80ff/eM27vhoPp8n6ZJIYLpiuvu3vqzyJqXxi64gMnBddJsJDpOcENu4k2T5
VbGirzbpVZ40adGCFnSbPKnyPGPukhL9LQmRiZonLTgBMR3jSL1wpC0dCUFW
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
KYYivxZ8JoWGc5GPj/4vD6J6slPbAAA=

-->

</rfc>

