Minor editorial revisions. (#657)

* Checked trademark/branding

Signed-off-by: DougTW <doug.martin@intel.com>
This commit is contained in:
DougTW
2019-07-22 10:20:17 -07:00
committed by michael vincerra
parent 5ba7b9e356
commit 2cf769511e
@@ -3,6 +3,7 @@
Validate signatures
###################
This guide describes how to validate the contents of a |CL-ATTR| image.
.. contents::
@@ -13,7 +14,7 @@ Overview
********
Validating the contents of an image is a manual process and is the same process
:ref:`swupd-guide` performs internally.
that :ref:`swupd-guide` performs internally.
|CL| offers a way to validate the content of an image or an update. All
validation of content works by creating and signing a hash. A valid signature
@@ -26,8 +27,8 @@ signature, means the content is not valid.
Image content validation
************************
For the outlined steps, the installer image of the latest release of |CL| is
used for illustrative purposes. You may use any image of |CL| you choose.
In the steps below, we used the installer image of the latest release
of |CL|. You may use any image of |CL| you choose.
#. Download the image, the signature of the SHA512 sum of the image, and the
|CL| certificate used for signing the SHA512 sum.
@@ -61,7 +62,7 @@ used for illustrative purposes. You may use any image of |CL| you choose.
sha512sum clear-$(curl https://cdn.download.clearlinux.org/latest)-installer.img.xz > sha512sum.out
#. Ensure the signature of the SHA512 sum of the image was created using the
|CL| certificate. This validates the image is trusted and it has not
|CL| certificate. This confirms that the image is trusted and has not
been modified.
.. code-block:: console
@@ -71,7 +72,7 @@ used for illustrative purposes. You may use any image of |CL| you choose.
.. note::
The :command:`-purpose any` option is required when using OpenSSL 1.1.
If using an earlier version of OpenSSL, omit this option to perform
If you use an earlier version of OpenSSL, omit this option to perform
signature validation. The :command:`openssl version` command may be used
to determine the version of OpenSSL in use.
@@ -98,22 +99,22 @@ these steps manually when performing a :command:`swupd update`.
# Swupd certificate
curl -O https://cdn.download.clearlinux.org/releases/$(curl https://cdn.download.clearlinux.org/latest)/clear/Swupd_Root.pem
#. Generate the SHA256 sum of the Swupd certificate.
#. Generate the SHA256 sum of the swupd certificate.
.. code-block:: console
sha256sum Swupd_Root.pem
#. Ensure the generated SHA256 sum of the Swupd certificate matches following
SHA256 sum to verify the integrity of the certificate.
#. Confirm that the generated SHA256 sum of the swupd certificate matches the
SHA256 sum shown below to verify the integrity of the certificate.
.. code-block:: console
ff06fc76ec5148040acb4fcb2bc8105cc72f1963b55de0daf3a4ed664c6fe72c Swupd_Root.pem
#. Ensure the signature of the MoM was created using the Swupd certificate.
This signature validates the update content is trustworthy and has not been
modified.
#. Confirm that the signature of the MoM was created using the Swupd
certificate. This signature validates the update content is trustworthy and
has not been modified.
.. code-block:: console
@@ -122,7 +123,7 @@ these steps manually when performing a :command:`swupd update`.
.. note::
The :command:`-purpose any` option is required when using OpenSSL 1.1.
If using an earlier version of OpenSSL, omit this option to perform
If you use an earlier version of OpenSSL, omit this option to perform
signature validation. The :command:`openssl version` command may be used
to determine the version of OpenSSL in use.