All of lore.kernel.org
 help / color / mirror / Atom feed
From: Quirin Gylstorff <Quirin.Gylstorff@siemens.com>
To: cip-dev@lists.cip-project.org, felix.moessbauer@siemens.com,
	jan.kiszka@siemens.com
Subject: [cip-dev][isar-cip-core][PATCH v3 3/6] doc: Add section about SWUpdate signing to README.swupdate.md
Date: Tue,  5 Mar 2024 17:10:56 +0100	[thread overview]
Message-ID: <20240305161128.2777211-4-Quirin.Gylstorff@siemens.com> (raw)
In-Reply-To: <20240305161128.2777211-1-Quirin.Gylstorff@siemens.com>

From: Quirin Gylstorff <quirin.gylstorff@siemens.com>

Signed-off-by: Quirin Gylstorff <quirin.gylstorff@siemens.com>
---
 doc/README.swupdate.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/README.swupdate.md b/doc/README.swupdate.md
index 5877882..b7e13f7 100644
--- a/doc/README.swupdate.md
+++ b/doc/README.swupdate.md
@@ -110,6 +110,27 @@ The sw-description will contain the following section:
           sha256 = "<sha256 of luascript.lua>";
         }):
 ```
+## SWUpdate Signing
+
+The ISAR layer isar-cip-core provides templates to sign the swu binaries with
+a CMS certificate.
+
+By default the insecure [Debian snake-oil keys](./recipes-devtools/secure-boot-secrets/files/bookworm/) are used.
+To use other key and certificate the following variables must be set:
+```
+PREFERRED_PROVIDER_swupdate-certificates-key = "swupdate-certificates-key"
+PREFERRED_PROVIDER_swupdate-certificates = "swupdate-certificates"
+SWU_SIGN_CERT = "<sigining certificate file name>"
+SWU_SIGN_KEY  = "<siging key file name>"
+```
+
+The files `<sigining certificate file name>` and `<siging key file name>` need to be stored
+in `recipes-devtools/swupdate-certificates/files/` or in a path defined by an bbappend file, e.g.`swupdate-certificates-key_%.bbappend`
+
+### signing script
+
+The provided [cms signing script](./recipes-devtools/swupdate-certificates/files/sign-swu-cms)
+can be replaced by setting the variable `SWU_SIGN_SCRIPT`.
 
 ## SWUpdate Hardware compatibility
 
-- 
2.43.0



  parent reply	other threads:[~2024-03-05 16:11 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-03-05 16:10 [cip-dev][isar-cip-core][PATCH v3 0/6] Make swupdate signing more robust Quirin Gylstorff
2024-03-05 16:10 ` [cip-dev][isar-cip-core][PATCH v3 1/6] swupdate: check output of sign-swu Quirin Gylstorff
2024-03-05 16:10 ` [cip-dev][isar-cip-core][PATCH v3 2/6] sign-swu-cms: check if key and cert are valid Quirin Gylstorff
2024-03-05 16:10 ` Quirin Gylstorff [this message]
2024-03-05 16:10 ` [cip-dev][isar-cip-core][PATCH v3 4/6] fix do not add files to each image recipe Quirin Gylstorff
2024-03-05 16:10 ` [cip-dev][isar-cip-core][PATCH v3 5/6] format: classes/efibootguard fix spacing Quirin Gylstorff
2024-03-05 16:10 ` [cip-dev][isar-cip-core][PATCH v3 6/6] format: classes/swupdate fix parenthesis Quirin Gylstorff
2024-03-12  8:40 ` [cip-dev][isar-cip-core][PATCH v3 0/6] Make swupdate signing more robust Jan Kiszka
2024-03-12 18:12   ` Gylstorff Quirin
2024-03-12 18:50     ` Gylstorff Quirin
2024-03-12 19:21       ` Jan Kiszka
2024-03-13  7:57         ` Gylstorff Quirin

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240305161128.2777211-4-Quirin.Gylstorff@siemens.com \
    --to=quirin.gylstorff@siemens.com \
    --cc=cip-dev@lists.cip-project.org \
    --cc=felix.moessbauer@siemens.com \
    --cc=jan.kiszka@siemens.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.