From: Ahmad Fatoum <a.fatoum@pengutronix.de>
To: barebox@lists.infradead.org
Cc: Ahmad Fatoum <a.fatoum@barebox.org>
Subject: [PATCH 09/11] Documentation: security: add anchors for the different sections
Date: Mon, 28 Sep 2026 13:27:04 +0200 [thread overview]
Message-ID: <20260928112731.1271094-10-a.fatoum@pengutronix.de> (raw)
In-Reply-To: <20260928112731.1271094-1-a.fatoum@pengutronix.de>
From: Ahmad Fatoum <a.fatoum@barebox.org>
So they can be referred to from the threat model chapter.
Signed-off-by: Ahmad Fatoum <a.fatoum@barebox.org>
---
Documentation/user/security.rst | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/Documentation/user/security.rst b/Documentation/user/security.rst
index 185adac2d51c..1ad4fa905d54 100644
--- a/Documentation/user/security.rst
+++ b/Documentation/user/security.rst
@@ -84,6 +84,8 @@ devicetree from the previous stage. It's thus only suitable for verified
boot if that stage verified the devicetree as well, e.g. because both are
part of the same signed FIP image.
+.. _loading_firmware:
+
Loading firmware
----------------
@@ -97,6 +99,8 @@ Firmware) should happen as early as possible, i.e., within the barebox
barebox will run with elevated permission, which greatly increases the attack
surface.
+.. _pinning_fit_config:
+
Pinning the FIT configuration
-----------------------------
@@ -138,6 +142,8 @@ development keys into the barebox binary.
The private keys for these keys can be found
`[here] <https://github.com/pengutronix/ptx-code-signing-dev>`__.
+.. _disabling_shell:
+
Disabling the shell
^^^^^^^^^^^^^^^^^^^
@@ -157,6 +163,8 @@ that. Whoever reaches the shell is as trusted as the boot chain, so any
remaining way of reaching it is part of the boot chain. A console kept for
diagnostics should be output-only.
+.. _disabling_env:
+
Disabling the non-builtin environment
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -185,6 +193,8 @@ way to arbitrarily set global variables, be it a writable environment,
a script on media or a shell, defeats verified boot regardless of how well
the images are signed.
+.. _avoiding_filesystems:
+
Avoiding use of file systems
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -203,6 +213,8 @@ If file system use is desired anyway, its integrity should be ensured by
other means, e.g. by being mounted from a dm-verity block device that was
setup with a correctly signed root hash.
+.. _verity_root_param:
+
Prevent the kernel from booting the rootfs in verity boots
----------------------------------------------------------
@@ -248,6 +260,8 @@ an attacker. It's thus strongly advisable to keep a separate secure
configuration that disables all features that are used for development and
are not absolutely necessary for booting in the field.
+.. _runtime_configuration:
+
Run-time configuration
^^^^^^^^^^^^^^^^^^^^^^
--
2.47.3
next prev parent reply other threads:[~2026-09-28 11:33 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-28 11:26 [PATCH 00/11] Documentation: define a barebox threat model Ahmad Fatoum
2026-09-28 11:26 ` [PATCH 02/11] Documentation: security: clarify development key insecurity Ahmad Fatoum
2026-09-28 11:26 ` [PATCH 03/11] Documentation: security: require signature verification to be pinned Ahmad Fatoum
2026-09-28 11:26 ` [PATCH 04/11] Documentation: security: document trust for builtin devicetree Ahmad Fatoum
2026-09-28 11:27 ` [PATCH 05/11] Documentation: security: clarify the environment section Ahmad Fatoum
2026-09-28 11:27 ` [PATCH 06/11] Documentation: security: describe shell and environment as trust boundary Ahmad Fatoum
2026-09-28 11:27 ` [PATCH 07/11] Documentation: security: document the barebox update attack surface Ahmad Fatoum
2026-09-28 11:27 ` [PATCH 08/11] Documentation: security: update for barebox dm-verity support Ahmad Fatoum
2026-09-28 11:27 ` Ahmad Fatoum [this message]
2026-09-28 11:27 ` [PATCH 10/11] Documentation: define a barebox threat model Ahmad Fatoum
2026-09-28 11:27 ` [PATCH 11/11] README, SECURITY.md: link the threat model and security considerations Ahmad Fatoum
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=20260928112731.1271094-10-a.fatoum@pengutronix.de \
--to=a.fatoum@pengutronix.de \
--cc=a.fatoum@barebox.org \
--cc=barebox@lists.infradead.org \
/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