diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index acd88bcc..f9d2fd21 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -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.