michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: Create a sensor threat model doc

Browse source 
Add a doc to the security section enumerating a threat model for a
sensor-type device.  This will help the direction of work to meet these
security requirements for this particular application.

Signed-off-by: David Brown <david.brown@linaro.org>
This commit is contained in:
David Brown 2018-05-04 15:00:01 -06:00 • committed by Anas Nashif
commit a7ffc83bcc
3 changed files with 549 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

203
doc/security/media/sensor-model.svg Normal file
View file

@ -0,0 +1,203 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="102.5 208.496 959 475.26754" width="959" height="475.26754">
<defs>
<font-face font-family="Helvetica" font-size="16" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
<font-face-src>
<font-face-name name="Helvetica"/>
</font-face-src>
</font-face>
<marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
<g>
<path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
</g>
</marker>
<marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
<g>
<path d="M -8 0 L 0 3 L 0 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
</g>
</marker>
</defs>
<metadata> Produced by OmniGraffle 7.7.1
<dc:date>2018-03-06 22:20:46 +0000</dc:date>
</metadata>
<g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
<title>sensor</title>
<rect fill="white" x="102.5" y="208.496" width="959" height="464.504"/>
<g id="Canvas_1: sensor-drawing">
<title>sensor-drawing</title>
<g id="Graphic_40">
<rect x="307.5" y="208.996" width="146.5" height="63" fill="#c0c0ff"/>
<path d="M 307.5 208.996 L 454 208.996 M 454 271.996 L 307.5 271.996" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(312.5 230.996)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="50.015625" y="15">Apps</tspan>
</text>
</g>
<g id="Graphic_39">
<rect x="556" y="501" width="153" height="63" fill="#ffffc0"/>
<rect x="556" y="501" width="153" height="63" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(561 523)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="30.132812" y="15">Sensor App</tspan>
</text>
</g>
<g id="Graphic_38">
<path d="M 938.6 501 L 1061 501 L 1030.4 564 L 908 564 Z" fill="#c0ffc0"/>
<path d="M 938.6 501 L 1061 501 L 1030.4 564 L 908 564 Z" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(943.6 523)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="15.552344" y="15">Sensor</tspan>
</text>
</g>
<g id="Graphic_37">
<path d="M 881.9466 289.88373 C 857.2188 286.5 867.0796 258.01455 906.5261 262.875 C 910.1858 253.40043 956.0568 254.93826 955.7569 262.875 C 984.5193 252.7238 1021.276 272.96508 996.6216 283.11627 C 1026.2057 288.03783 996.2483 314.55453 971.9688 310.125 C 970.0256 317.50797 926.6211 320.0916 922.8114 310.125 C 898.2335 320.76885 846.9846 304.40334 881.9466 289.88373 Z" fill="#ffc0c0"/>
<path d="M 881.9466 289.88373 C 857.2188 286.5 867.0796 258.01455 906.5261 262.875 C 910.1858 253.40043 956.0568 254.93826 955.7569 262.875 C 984.5193 252.7238 1021.276 272.96508 996.6216 283.11627 C 1026.2057 288.03783 996.2483 314.55453 971.9688 310.125 C 970.0256 317.50797 926.6211 320.0916 922.8114 310.125 C 898.2335 320.76885 846.9846 304.40334 881.9466 289.88373 Z" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(889.95 267.5)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="27.647656" y="15">Cloud </tspan>
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="21.87422" y="34">Service</tspan>
</text>
</g>
<g id="Graphic_36">
<rect x="266.5" y="452.5" width="153" height="63" fill="#ffffc0"/>
<rect x="266.5" y="452.5" width="153" height="63" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(271.5 474.5)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="32.804688" y="15">Bootloader</tspan>
</text>
</g>
<g id="Graphic_35">
<rect x="549.5" y="319.5" width="153" height="63" fill="#ffffc0"/>
<rect x="549.5" y="319.5" width="153" height="63" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(554.5 332)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="11.910156" y="15">Software Update </tspan>
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="57.265625" y="34">App</tspan>
</text>
</g>
<g id="Line_34">
<line x1="379.0145" y1="281.74268" x2="350.3445" y2="442.7533" marker-end="url(#FilledArrow_Marker)" marker-start="url(#FilledArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_33">
<line x1="419.5" y1="496.81606" x2="546.2361" y2="518.0482" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_32">
<line x1="558.9737" y1="382.5" x2="418.98617" y2="448.2892" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_31">
<line x1="712.1956" y1="333.20922" x2="860.4261" y2="302.61445" marker-end="url(#FilledArrow_Marker)" marker-start="url(#FilledArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_30">
<line x1="679.39875" y1="494.7971" x2="897.1693" y2="319.72666" marker-end="url(#FilledArrow_Marker)" marker-start="url(#FilledArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_29">
<line x1="923.3" y1="532.5" x2="718.9" y2="532.5" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_28">
<line x1="549.5" y1="326.43168" x2="389.42584" y2="275.02314" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_27">
<rect x="310.3145" y="327.98968" width="109" height="67" fill="white"/>
<text transform="translate(315.3145 332.98968)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".1328125" y="15">Code execute</tspan>
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="4.589844" y="34">Verify app(s)</tspan>
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="23.703125" y="53">Update</tspan>
</text>
</g>
<g id="Graphic_26">
<rect x="422.9439" y="285.90015" width="91" height="29" fill="white"/>
<text transform="translate(427.9439 290.90015)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".48046875" y="15">Install slot2</tspan>
</text>
</g>
<g id="Graphic_25">
<rect x="427.22845" y="401.71773" width="120" height="29" fill="white"/>
<text transform="translate(432.22845 406.71773)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".2890625" y="15">Indicate update</tspan>
</text>
</g>
<g id="Graphic_24">
<rect x="453.76947" y="493.75326" width="68" height="29" fill="white"/>
<text transform="translate(458.76947 498.75326)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".09375" y="15">Execute</tspan>
</text>
</g>
<g id="Graphic_23">
<rect x="755.1544" y="383.21904" width="90" height="29" fill="white"/>
<text transform="translate(760.1544 388.21904)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".4453125" y="15">MQTT/TLS</tspan>
</text>
</g>
<g id="Graphic_22">
<rect x="761.8205" y="302.06824" width="62" height="29" fill="white"/>
<text transform="translate(766.8205 307.06824)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".203125" y="15">Update</tspan>
</text>
</g>
<g id="Graphic_21">
<rect x="777.45855" y="518" width="75" height="29" fill="white"/>
<text transform="translate(782.45855 523)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".484375" y="15">SPI Data</tspan>
</text>
</g>
<g id="Graphic_20">
<rect x="103" y="274.612" width="146.5" height="63" fill="#c0c0ff"/>
<path d="M 103 274.612 L 249.5 274.612 M 249.5 337.612 L 103 337.612" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(108 296.612)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="29.554688" y="15">Bootloader</tspan>
</text>
</g>
<g id="Graphic_19">
<rect x="556" y="608.5135" width="146.5" height="63" fill="#c0c0ff"/>
<path d="M 556 608.5135 L 702.5 608.5135 M 702.5 671.5135 L 556 671.5135" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
<text transform="translate(561 621.0135)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="2.4609375" y="15">MQTT/TLS private </tspan>
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="51.80078" y="34">keys</tspan>
</text>
</g>
<g id="Line_18">
<line x1="176.25" y1="337.612" x2="299.67862" y2="445.96864" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Line_17">
<line x1="630.5013" y1="598.61805" x2="631.2487" y2="573.8955" marker-end="url(#FilledArrow_Marker)" marker-start="url(#FilledArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_16">
<rect x="187.4919" y="381.704" width="111" height="29" fill="white"/>
<text transform="translate(192.4919 386.704)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x=".24609375" y="15">Code Execute</tspan>
</text>
</g>
<g id="Graphic_15">
<rect x="131.5" y="557" width="33.5" height="17" fill="#c0c0ff"/>
<path d="M 131.5 557 L 165 557 M 165 574 L 131.5 574" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_14">
<text transform="translate(178.5 556)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="0" y="15">Flash Data</tspan>
</text>
</g>
<g id="Graphic_13">
<rect x="131.5" y="586" width="33.5" height="17" fill="#ffffc0"/>
<rect x="131.5" y="586" width="33.5" height="17" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_12">
<text transform="translate(178.5 585)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="0" y="15">Software Component</tspan>
</text>
</g>
<g id="Graphic_11">
<path d="M 138.2 615 L 165 615 L 158.3 632 L 131.5 632 Z" fill="#c0ffc0"/>
<path d="M 138.2 615 L 165 615 L 158.3 632 L 131.5 632 Z" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_10">
<text transform="translate(178.5 614)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="0" y="15">Hardware</tspan>
</text>
</g>
<g id="Graphic_9">
<path d="M 135.8674 653.4131 C 130.45312 652.5 132.6122 644.81345 141.24917 646.125 C 142.05049 643.5684 152.09412 643.98334 152.02847 646.125 C 158.32613 643.3858 166.37417 648.8477 160.97598 651.5869 C 167.45354 652.915 160.89424 660.0703 155.57812 658.875 C 155.15267 660.8672 145.64906 661.5644 144.81491 658.875 C 139.43347 661.74715 128.21231 657.33106 135.8674 653.4131 Z" fill="#ffc0c0"/>
<path d="M 135.8674 653.4131 C 130.45312 652.5 132.6122 644.81345 141.24917 646.125 C 142.05049 643.5684 152.09412 643.98334 152.02847 646.125 C 158.32613 643.3858 166.37417 648.8477 160.97598 651.5869 C 167.45354 652.915 160.89424 660.0703 155.57812 658.875 C 155.15267 660.8672 145.64906 661.5644 144.81491 658.875 C 139.43347 661.74715 128.21231 657.33106 135.8674 653.4131 Z" stroke="gray" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
</g>
<g id="Graphic_8">
<text transform="translate(178.5 643)" fill="black">
<tspan font-family="Helvetica" font-size="16" font-weight="400" fill="black" x="0" y="15">The Cloud</tspan>
</text>
</g>
</g>
</g>
</svg>
Side by side

After

Width:  |  Height:  |  Size: 14 KiB

1
doc/security/security.rst
View file

@ -12,3 +12,4 @@ for ensuring security is addressed within the Zephyr project.
security-overview.rst security-overview.rst
secure-coding.rst secure-coding.rst
sensor-threat.rst

345
doc/security/sensor-threat.rst Normal file
View file

@ -0,0 +1,345 @@
.. _sensor-threat:
Sensor Device Threat Model
##########################
This document describes a threat model for an IoT sensor device.
Spelling out a threat model helps direct development effort, and can
be used to help prioritize these efforts as well.
This device contains a sensor of some type (for example temperature, or a
pressure in a pipe), which sends this data to an SoC running a
microcontroller. This microcontroller connects to a cloud service, and
relays this sensor data to this service. The cloud service is also able
to send configuration data to the device, as well as software update
images. A general diagram can be seen in Figure 1:
.. figure:: media/sensor-model.svg
Figure 1. Sensor General Diagram
In this sensor device, the sensor connects with the SoC via an SPI bus,
and the SoC has a network interface that it uses to communicate with the
cloud service. The particulars of these interfaces can impact the threat
model in unexpected ways, and variants on this will need to be
considered (for example, using a separate network interface SoC
connected via some type of bus).
This model also focuses on communicating via the MQTT-over-TLS protocol,
as this seems to be in wide use [1]_.
Assets
======
One aspect of the threat model to consider are assets involved in the
operation of the device. The following list enumerates the assets
included in this model:
1. **The bootloader**. This is a small code/data image contained in
on-device flash that is the first code to run. In order to establish
a root of trust, this image must be immutable. This model assumes
that the SoC provides a mechanism to protect a region of the flash
from future writes, and that this will be done after this image is
programmed into the device, early in production.
2. **The application firmware image**. This asset consists of the
remainder of the firmware run by the microcontroller. The distinction
is made because this part of the image will need to be updated
periodically as security vulnerabilities are discovered. Requirements
for updates to this image are:
a. The image shall only be replaced with an authorized image.
b. When an authorized replacement image is available, the update
shall be done in a timely manner.
c. The image update shall be seen as atomic, meaning that when the
image is run, the flash shall contain either the update image in
its entirety, or the old image in its entirety.
3. **Root certificate list**. In order to authenticate the cloud service
(server), the IoT device must have a list of root certificates that
are allowed to sign the certificate on the server. For cloud-provider
based services, this list will generally be provided by the service
provider. Because the root certificates can expire, and possibly be
revoked, this list will need to be periodically updated.
4. **Client secrets**. To authenticate the client to the service, the
client must possess some kind of secret. This is generally a private
key, usually either an RSA key or an EC private key. When
establishing communication with the server, the device will use
this secret either as part of the TLS establishment, or to sign a
message used in the communication.
This secret is generally generated by the service provider, or by
software running elsewhere, and must be securely installed on the
device. Policy may dictate that this secret be replaced
periodically, which will require a way to update the client secret.
Typically, the service will allow two or three active keys to allow
this update to proceed while the old key is used.
These secrets must be protected from read, and the smallest amount
of code necessary shall have access to them.
5. **Current date/time**. TLS certificate verification requires
knowledge of the current date and time in order to determine if the
current time falls within the certificate’s current validity time.
Also, token based client authentication will generally require the
client to sign a message containing a time window that the token is
valid. Certificate validation requires the device's notion of date and
time to be accurate within a day or so. Token generation generally
requires the time to be accurate within 5-10 minutes.
It may be possible to approximate secure time by querying an
external time server. Secure NTP is possibly beyond the
capabilities of an IoT device. The main risks of having incorrect
time are denial of service (the device rejects valid certificates),
and the generation of tokens with invalid times. It could be
possible to trick the device into generating tokens that are valid in
the future, but the attacker would also have to spoof the server's
certificate to be able to intercept this.
6. **Sensor data**. The data received from the sensor itself, and
delivered to the service shall be delivered without modification or
tampering.
7. **Device configuration**. Various configuration data, such as the
hostname of the service to connect to, the address of a time server,
frequency and parameters of when sensor data is sent to the service,
and other need to be kept by the device. This configuration data will
need to be updated periodically as the configuration changes. Updates
should be allowed only from authorized parties.
8. **Logs**. In order to assist with analysis of security issues, the
device shall log information about security-pertinent events. IoT
devices generally have limited storage, and as such, these logs need
to be carefully selected. It may also be possible to send these log
events to the cloud service where they can be stored in a more
resource-available environment. Types of events that should be logged
include:
a. **Firmware image updates**. The system should log the download of
new images, and when an image is successfully updated.
b. **Client secret changes**. Changes and new client secrets should be
logged.
c. **Changes to the device configuration**.
Communication
=============
In addition to assets, the threat model also considers the locations
where data or assets are communicated between entities of the system.
1. **Flash contents**. The flash device contains several regions. The
contents of flash can be modified programmatically by the SoC’s CPU.
a. **The bootloader**. As described in the Assets section, the
bootloader is a small section of the flash device containing the
code initially run. This section shall be written early in the
lifecycle of the device, and the flash device then configured to
permanently disallow modification of this section. This
configuration should also prevent modification via external
interfaces, such as JTAG or SWD debuggers.
The bootloader is responsible for verifying the signature of the
application image as well as updating the application image from
the update image when an update is needed.
The bootloader shall verify the signature of the update image
before installing it.
The bootloader shall only accept an update image with a newer
version number than the current image.
b. **The application image**. The application image contains the code
executed during normal operation of the device. Before running
this image, the bootloader shall verify a digital signature of the
image, to avoid running an image that has been tampered with. The
flash/system shall be configured such that after the bootloader
has completed, the CPU will be unable to write to the application
image.
c. **The update image**. This is an area of flash that holds a new
version of the application image. This image will be downloaded
and stored by the application during normal operation. When this
has completed, the application can trigger a reboot, and the
bootloader can install the new image.
d. **Secret storage**. An area of the flash will be used to store
client secrets. This area is written and read by a subset of the
application image. The application shall be configured to
protect this area from both reads and writes by code that does
not need to have access to it, giving consideration to possible
exploits found within a majority of the application code.
Revealing the contents of the secrets would allow the attacker
to spoof this device.
Initial secrets shall be placed in the device during a
provisioning activity, distinct from normal operation of the
device. Later updates can be made under the direction of
communication received over a secured channel to the service.
e. **Configuration storage**. There shall be an area to store other
configuration information. On resource-constrained devices, it is
allowed for this to be stored in the same region as the secret
storage, however, this adds additional code that has access to the
secret storage area, and as such, more code that must be
scrutinized.
f. **Log storage**. The device may have an area of flash where log
events can be written.
2. **Sensor/Actuator interface**. In this design, the sensor or actuator
communicates with the SoC via a bus, such as SPI. The hardware design
shall be made to make intercepting this bus difficult for an attack.
Required techniques depend on the sensitivity and use of the sensor
data, and can range from having the sensor mounted on the same PCB as
the MCU to epoxy potting the entire device.
3. **Communication with cloud service**. Communication between the
device, and the cloud service will be done over the general
internet. As such, it shall be assumed that an attacker can
arbitrarily intercept this channel and, for example, return spoofed
DNS results or attempt man-in-the-middle attacks
against communication with cloud services.
The device shall use TLS for all communication with the cloud
service. The TLS stack shall be configured to use only cipher suites
that are generally considered secure [2]_, including forward
secrecy. The communication shall be secured by the following:
a. **Cipher suite selection**. The device shall only allow
communication with generally agreed secure cipher suites.
b. **Server certificate verification**. The server presented by the
server shall be verified.
i. **Naming**. The certificate shall name the host and service
the cloud service server is providing.
`RFC6125 <https://tools.ietf.org/html/rfc6125>`__ describes
best practices for this. It is permissible for the device to
require the certificate to be more restrictive than as
described in this RFC, provided the service can use a
certificate that can comply.
ii. **Path validation**. The device shall verify that the
certificate chain has a valid signature path from a root
certificate contained within the device, to the certificate
presented by the service.
`RFC4158 <https://tools.ietf.org/html/rfc4158>`__ describes
this is general. The device is permitted to require a more
restricted path, provided the server certificate used
complies with this restriction.
iii. **Validity period**. The validity period of all presented
certificates shall be checked against the device’s best
notion of the current time.
c. **Client authentication**. The client shall authenticate itself to
the service using a secret known only to that particular device.
There are several options, and the technique used is generally
mandated by the particular service provider being used.
i. **TLS client certificates**. The TLS protocol allows the
client to present a certificate, and assert its knowledge of
the secret described by that certificate. Generally, these
certificates will be stored within the service provider. These
certificates can be self-signed, or signed by a CA. Since the
service provider maintains a list of valid certificates
(mapping them to a device identity), having these certificates
signed by a CA does not add any additional security, but may
be useful in the management of these certificates.
ii. **Token-based authentication**. It is also possible for the
client to authenticate itself using the *password* field of
the MQTT CONNECT packet. However, the secret itself must not
be transmitted in this packet. Instead, a token-based
protocol, such as
`RFC7519 <https://tools.ietf.org/html/rfc7519>`__\ ’s JSON Web
Token (JWT) can be used. These tokens will generally have a
small validity period (e.g. 1 hour), to prevent them from
being reused if they are intercepted. The token shall not be
sent until the device has verified the identity of the server.
d. **Random/Entropy source**. Cryptograph communication requires the
generation of secure pseudorandom numbers. The device shall use a
modern, accepted cryptographic random-bit generator to generate
these random numbers. It shall use either a Non-Deterministic
Random Bit Generator (True RBG) implemented in hardware within the
SoC, or a Deterministic Random Bit Generator (Pseudo RBG) seeded
by an entropy source within the SoC. Please see NIST SP 800-90A
for information on approved RBGs and NIST SP 800-90B for
information on testing a device's entropy source.
4. **Communication with the time service**. Ideally, the device shall
contain hardware that maintains a secure time. However, most SoCs in
use do not have support for this, and it will be necessary to consult
an external time service.
`RFC4330 <https://tools.ietf.org/html/rfc4330>`__ and referenced RFCs
describe the Simple Network Time Protocol that can be used to query
the current time from a network time server.
5. **Device lifecycle**. An IoT device will have a lifecycle from
production to destruction and disposal of the device. Aspects of this
lifecycle that impact security include initial provisioning, normal
operation, re-provisioning, and destruction.
a. **Initial provisioning**. During the initial provisioning stage,
it is necessary to program the bootloader, an initial application
image, a device secret, and initial configuration data. In
addition, the bootloader flash protection shall be installed. Of
this information, only the device secret needs to differ per
device. This secret shall be securely maintained, and destroyed in
all locations outside of the device once it has been programmed.
b. **Normal operation**. Normal operation includes the behavior
described by the rest of this document.
c. **Re-provisioning**. Sometimes it is necessary to re-provision a
device, such as for a different application. One way to do this is
to keep the same device secret, and replace the configuration
data, as well as the cloud service data associated with the
device. It is also possible to program a new device secret, but if
this is done it shall be done securely, and the new secret
destroyed externally once programmed into the device.
d. **Destruction**. To prevent the device secret from being used to
spoof the device, upon decommissioning, the secret for a
particular device shall be rendered ineffective. Possibilities
include:
i. Hardware destruction of the device.
ii. Securely wiping the flash area containing the
secret [3]_.
iii. Removing the device identity and certificate from the
service.
Other Considerations
====================
In addition to the above, network connected devices generally will need
a way to configure them to connect to the network environment they are
placed in. There are numerous ways of doing this, and it is important
for these configuration methods to not circumvent the security
requirements described above.
.. [1]
See https://www.slideshare.net/kartben/iot-developer-survey-2018. As
of this writing, the three major cloud IoT service providers, AWS
IoT, Google Cloud IoT, and Microsoft Azure IoT all provide MQTT over
TLS. Some feedback has suggested that some find difficulty with UDP
protocols and routing issues on various networks.
.. [2]
As new exploits are discovered, what is considered secure can
change.
Organizations such as https://www.ssllabs.com/ provide information on
current ideas of how TLS must be configured to be secure.
.. [3]
Note that merely erasing this flash area is unlikely to be
sufficient.