mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-11-21 19:15:51 +00:00
Minor editorial revisions. (#657)
* Checked trademark/branding Signed-off-by: DougTW <doug.martin@intel.com>
This commit is contained in:
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user