[PATCH RFC 00/17] Add security policy support

Ahmad Fatoum a.fatoum at pengutronix.de
Thu Aug 14 06:06:45 PDT 2025


Security policies are a mechanism for barebox to prevent, when so
desired, security relevant code from being executed.

Security policies are controlled via a second Kconfig menu structure
(called Sconfig) which collects security relevant options.

While the normal Kconfig menu structure is about feature support
enabled at compile time, a security policy determines whether a
feature is allowed or prohibited at runtime with an explicit focus
on security.

Except for a security policy's name, all security options are
boolean and control whether a built-in feature is allowed:

  config FASTBOOT_CMD_BASE
  	bool
  	prompt "Allow fastboot flash/erase commands"
  	depends on $(kconfig-enabled,FASTBOOT_BASE)
  	help
  	  This option enables the fastboot "flash" and "erase" commands.

The depends directive ensures the option is hidden when Fastboot support
isn't compiled in anyway. Otherwise, enabling the option should permit
normal operation as if the security policy support was disabled.

Disabling the option, will have the relevant functions return early,
often with a permission denied error.

Checking the state of a security config option is done with the
IS_ALLOWED macro. The macro evaluates to true if the option is
defined and enabled in the active security policy and false otherwise.

A partial manipulation of the active security policy is not desirable
as it makes security posture at runtime harder to reason about.

It's expected that boards will define a fixed set of policies,
e.g. devel, factory, lockdown and then consult eFuses or JSON web tokens
to determine which policy is to be applied.

Some precautions have been made to make sure the security policies have
been reviewed and changes to the security options do not go through
unnoticed during barebox updates: Automatic config updates are
prohibited, so if new options are not present or the other way round,
the build will just fail. The user is expected to run e.g.
make security_olddefconfig to explicitly sync the configuration and
commit the changes.

Ahmad Fatoum (16):
  kconfig: allow setting CONFIG_ from the outside
  scripts: include scripts/include for all host tools
  kbuild: implement loopable loop_cmd
  Add security policy support
  kbuild: allow security config use without source tree modification
  defaultenv: update PS1 according to security policy
  security: policy: support externally provided configs
  docs: security-policies: add documentation
  commands: go: add security config option
  console: ratp: add security config option
  bootm: support calling bootm_optional_signed_images at any time
  bootm: make unsigned image support runtime configurable
  ARM: configs: add virt32_secure_defconfig
  boards: qemu-virt: add security policies
  boards: qemu-virt: allow setting policy from command line
  test: py: add basic security policy test

Sascha Hauer (1):
  commands: implement sconfig command

 .gitignore                                    |   4 +
 Documentation/devel/devel.rst                 |   1 +
 Documentation/devel/security-policies.rst     |  89 +++
 Documentation/user/defaultenv-2.rst           |   2 +
 Documentation/user/security-policies.rst      | 110 ++++
 Documentation/user/user-manual.rst            |   1 +
 Makefile                                      |  81 ++-
 Sconfig                                       |   9 +
 arch/arm/configs/virt32_secure_defconfig      | 302 ++++++++++
 commands/Kconfig                              |  23 +
 commands/Makefile                             |   1 +
 commands/Sconfig                              |  12 +
 commands/go.c                                 |   4 +
 commands/sconfig.c                            | 219 +++++++
 common/Kconfig                                |   5 +
 common/Sconfig                                |  24 +
 common/boards/qemu-virt/Makefile              |   5 +-
 common/boards/qemu-virt/board.c               |  11 +
 common/boards/qemu-virt/commandline.c         |  74 +++
 common/boards/qemu-virt/commandline.h         |   9 +
 .../qemu-virt/qemu-virt-factory.sconfig       |  24 +
 .../qemu-virt/qemu-virt-lockdown.sconfig      |  24 +
 common/bootm.c                                |  58 +-
 common/console.c                              |   4 +-
 common/ratp/ratp.c                            |  17 +
 defaultenv/Makefile                           |   1 +
 .../bin/ps1-policy                            |  20 +
 .../init/ps1-policy                           |   1 +
 .../init/source-colors                        |   1 +
 defaultenv/defaultenv.c                       |   2 +
 include/security/config.h                     |  76 +++
 include/security/defs.h                       |  22 +
 include/security/policy.h                     |  54 ++
 scripts/Kbuild.include                        |  41 ++
 scripts/Makefile                              |   1 -
 scripts/Makefile.build                        |  18 +-
 scripts/Makefile.lib                          |  47 ++
 scripts/Makefile.policy                       |  43 ++
 scripts/Sconfig.include                       |   6 +
 scripts/basic/.gitignore                      |   1 +
 scripts/basic/Makefile                        |   4 +-
 scripts/basic/sconfigpost.c                   | 540 ++++++++++++++++++
 scripts/include/list.h                        |   7 +
 scripts/kconfig/Makefile                      |   3 +
 scripts/kconfig/list.h                        | 132 -----
 security/Kconfig                              |   2 +
 security/Kconfig.policy                       | 101 ++++
 security/Makefile                             |  38 ++
 security/Sconfig                              |  42 ++
 security/policy.c                             | 246 ++++++++
 security/qemu-virt-devel.sconfig              |  24 +
 security/qemu-virt-tamper.sconfig             |  24 +
 security/sconfig_names.c                      |  18 +
 test/arm/virt32_secure_defconfig.yaml         |  22 +
 test/py/test_policies.py                      |  49 ++
 55 files changed, 2543 insertions(+), 156 deletions(-)
 create mode 100644 Documentation/devel/security-policies.rst
 create mode 100644 Documentation/user/security-policies.rst
 create mode 100644 Sconfig
 create mode 100644 arch/arm/configs/virt32_secure_defconfig
 create mode 100644 commands/Sconfig
 create mode 100644 commands/sconfig.c
 create mode 100644 common/Sconfig
 create mode 100644 common/boards/qemu-virt/commandline.c
 create mode 100644 common/boards/qemu-virt/commandline.h
 create mode 100644 common/boards/qemu-virt/qemu-virt-factory.sconfig
 create mode 100644 common/boards/qemu-virt/qemu-virt-lockdown.sconfig
 create mode 100755 defaultenv/defaultenv-2-security-policy/bin/ps1-policy
 create mode 100644 defaultenv/defaultenv-2-security-policy/init/ps1-policy
 create mode 100644 defaultenv/defaultenv-2-security-policy/init/source-colors
 create mode 100644 include/security/config.h
 create mode 100644 include/security/defs.h
 create mode 100644 include/security/policy.h
 create mode 100644 scripts/Makefile.policy
 create mode 100644 scripts/Sconfig.include
 create mode 100644 scripts/basic/sconfigpost.c
 create mode 100644 scripts/include/list.h
 delete mode 100644 scripts/kconfig/list.h
 create mode 100644 security/Kconfig.policy
 create mode 100644 security/Sconfig
 create mode 100644 security/policy.c
 create mode 100644 security/qemu-virt-devel.sconfig
 create mode 100644 security/qemu-virt-tamper.sconfig
 create mode 100644 security/sconfig_names.c
 create mode 100644 test/arm/virt32_secure_defconfig.yaml
 create mode 100644 test/py/test_policies.py

-- 
2.39.5




More information about the barebox mailing list