From b16660a9f051b0557bcaf1e2c8cc261a64403a14 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 26 Jun 2018 12:21:29 -0700 Subject: [PATCH 1/3] added a reference to validate-signatures.rst to download-verify-uncompress-linux.rst for uniformity (issue 163). made a couple wording changes to validate-signatures.rst and added a label to help with navigation --- .../maintenance/download-verify-uncompress-linux.rst | 3 +++ .../guides/maintenance/validate-signatures.rst | 8 +++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst index f497148c..95cb27bd 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -42,6 +42,9 @@ checksum, a warning is displayed with a message indicating the computed checksum does **not** match. Otherwise, the name of the image is printed on the screen followed by `OK`. +For a more in-depth discussion of image verification including checking the +certificate see :ref:`image-content-validation`. + Uncompress the Clear Linux image ******************************** diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 190e4f59..94a7763e 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: -Validate signatures -################### +Validating signatures +##################### |CLOSIA| 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 @@ -9,9 +9,11 @@ creates a chain of trust. A broken chain of trust, seen as an invalid signature, means the content is not valid. This guide covers how to validate the contents of an image, which is a manual -process, and describes the automatic process ``swupd`` performs internally to +process and is the same process ``swupd`` performs internally to validate an update. +.. _image-content-validation: + Image content validation ======================== From aa9baaad2a109eab84c9e5265dc3ed0f63c82036 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:17:16 -0700 Subject: [PATCH 2/3] fixed title to align with project standards --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 94a7763e..73b131e0 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,6 +1,6 @@ .. _validate-signatures: -Validating signatures +Validate signatures ##################### |CLOSIA| offers a way to validate the content of an image or an update. All From 48fda098504b35c60df56c35c00fbb8348980bcc Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:26:23 -0700 Subject: [PATCH 3/3] trimmed header underline to match header --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 73b131e0..1001369a 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: Validate signatures -##################### +################### |CLOSIA| 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