From: Jonas Rebmann <jre@pengutronix.de>
To: Sascha Hauer <s.hauer@pengutronix.de>,
BAREBOX <barebox@lists.infradead.org>
Cc: Jonas Rebmann <jre@pengutronix.de>
Subject: [PATCH 00/15] TLV-Signature and keyrings
Date: Tue, 14 Oct 2025 13:02:51 +0200 [thread overview]
Message-ID: <20251014-tlv-signature-v1-0-7a8aaf95081c@pengutronix.de> (raw)
This series introduces everything needed for the use of signed TLVs in
barebox. This allows for signed TLVs to be part of a secure boot chain,
if CONFIG_TLV_SIGNATURE is enabled, keys are configured and the decoder
is configured to require signature.
As TLV signature verification uses the public_keys list, propagated by
keytoc.c with the public keys selected in CONFIG_CRYPTO_PUBLIC_KEYS, the
keyring feature was introduced to allow separate keys for separate
concerns.
The existing fitimage verification now only verifies against keys in the
"fit" keyring. To require a valid signature of TLVs, specify a
tlv_decoder::signature_keyring in the decoder. No signature verification
is performed if signature_keyring is NULL for a decoder matched to the
TLV magic.
A new builtin decoder was added to common/tlv/barebox.c with the magic
0x61bb95f3 and .signature_keyring = "tlv". Consequently
CONFIG_CRYPTO_BUILTIN_DEVELOPMENT_KEYS now adds the insecure development
keys to both the "tlv" and the "fit" keyring. This allows for quick
testing and debugging of decoders requiring signature.
For the creation of signed TLVs, bareboxtlv-generator.py was updated
with --sign and --verify options for TLV binary encoding and decoding
respectively.
Changes to the TLV format and -tool usage as well as the breaking
changes to the keyspec syntax are documented in Documentation/.
Signed-off-by: Jonas Rebmann <jre@pengutronix.de>
---
Jonas Rebmann (15):
common: clean up TLV code
crypto: Add support for keyrings
fit: only accept keys from "fit"-keyring
crypto: keytoc: Rename "hint" to "fit-hint" and do not use it in identifiers
commands: keys: update output format to include keyring
commands: tlv: Error out on invalid TLVs
scripts: bareboxtlv-generator: Implement signature
scripts: bareboxtlv-generator: Increase max_size in example schema
common: tlv: Add TLV-Signature support
common: tlv: default decoder for signed TLV
crypto: Use "development" keys for "fit" and "tlv" keyring
test: py: add signature to TLV integration tests
ci: pytest: Add kconfig fragment for TLV signature integration tests
doc/barebox-tlv: Update documentation regarding TLV-Signature
Documentation: migration-2025.11.0: List changes to CONFIG_CRYPTO_PUBLIC_KEYS
.github/workflows/test-labgrid-pytest.yml | 1 +
.../devicetree/bindings/nvmem/barebox,tlv.yaml | 1 +
.../migration-guides/migration-2025.11.0.rst | 17 ++
Documentation/user/barebox-tlv.rst | 49 +++-
commands/keys.c | 8 +-
commands/tlv.c | 2 +-
common/Kconfig | 4 +
.../boards/configs/enable_tlv_sig_testing.config | 13 +
common/image-fit.c | 13 +-
common/tlv/barebox.c | 25 +-
common/tlv/parser.c | 102 ++++++-
crypto/Makefile | 6 +-
crypto/fit-4096-development.key | 51 ++++
crypto/fit-ecdsa-development.key | 5 +
crypto/public-keys.c | 15 +-
crypto/rsa.c | 1 +
include/crypto/public_key.h | 22 +-
include/tlv/format.h | 29 +-
include/tlv/tlv.h | 1 +
.../bareboxtlv-generator/bareboxtlv-generator.py | 242 ++++++++++++++--
scripts/bareboxtlv-generator/requirements.txt | 1 +
scripts/bareboxtlv-generator/schema-example.yaml | 2 +-
scripts/include/linux/overflow.h | 312 +++++++++++++++++++++
scripts/keytoc.c | 259 +++++++++++------
test/py/test_tlv.py | 205 +++++++++++---
25 files changed, 1202 insertions(+), 184 deletions(-)
---
base-commit: 39309dcb356714fc3f345f52ff30b0281d65e27b
change-id: 20251014-tlv-signature-2673b1a24445
Best regards,
--
Jonas Rebmann <jre@pengutronix.de>
next reply other threads:[~2025-10-14 11:03 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-10-14 11:02 Jonas Rebmann [this message]
2025-10-14 11:02 ` [PATCH 01/15] common: clean up TLV code Jonas Rebmann
2025-10-14 11:02 ` [PATCH 02/15] crypto: Add support for keyrings Jonas Rebmann
2025-10-14 11:02 ` [PATCH 03/15] fit: only accept keys from "fit"-keyring Jonas Rebmann
2025-10-14 11:02 ` [PATCH 04/15] crypto: keytoc: Rename "hint" to "fit-hint" and do not use it in identifiers Jonas Rebmann
2025-10-15 10:15 ` Jonas Rebmann
2025-10-14 11:02 ` [PATCH 05/15] commands: keys: update output format to include keyring Jonas Rebmann
2025-10-14 11:02 ` [PATCH 06/15] commands: tlv: Error out on invalid TLVs Jonas Rebmann
2025-10-14 11:02 ` [PATCH 07/15] scripts: bareboxtlv-generator: Implement signature Jonas Rebmann
2025-10-14 11:02 ` [PATCH 08/15] scripts: bareboxtlv-generator: Increase max_size in example schema Jonas Rebmann
2025-10-14 11:03 ` [PATCH 09/15] common: tlv: Add TLV-Signature support Jonas Rebmann
2025-10-17 9:08 ` Jonas Rebmann
2025-10-14 11:03 ` [PATCH 10/15] common: tlv: default decoder for signed TLV Jonas Rebmann
2025-10-14 11:03 ` [PATCH 11/15] crypto: Use "development" keys for "fit" and "tlv" keyring Jonas Rebmann
2025-10-14 11:03 ` [PATCH 12/15] test: py: add signature to TLV integration tests Jonas Rebmann
2025-10-14 11:03 ` [PATCH 13/15] ci: pytest: Add kconfig fragment for TLV signature " Jonas Rebmann
2025-10-14 11:03 ` [PATCH 14/15] doc/barebox-tlv: Update documentation regarding TLV-Signature Jonas Rebmann
2025-10-15 10:20 ` Jonas Rebmann
2025-10-14 11:03 ` [PATCH 15/15] Documentation: migration-2025.11.0: List changes to CONFIG_CRYPTO_PUBLIC_KEYS Jonas Rebmann
2025-10-15 14:34 ` Jonas Rebmann
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=20251014-tlv-signature-v1-0-7a8aaf95081c@pengutronix.de \
--to=jre@pengutronix.de \
--cc=barebox@lists.infradead.org \
--cc=s.hauer@pengutronix.de \
/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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox