blob: 998c5146545bb8c0619d955852fe7cba8083f541 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
---
edit_link: ''
title: Image
origin_url: >-
https://raw.githubusercontent.com/automotive-grade-linux/docs-sources/master/docs/security-blueprint/part-2/1-Image.md
---
<!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/architecture/master/security_blueprint-security-blueprint-book.yml -->
# Image
## Image selection
The boot process shall be uninterruptible and shall irrevocably boot the image
as specified in the boot environment.
In U-Boot set the "_bootdelay_" environment variable and/or define
`CONFIG_BOOTDELAY` to _-2_.
<!-- section-config -->
Domain | _Variable_ / `Config` name | `Value`
---------------------- | -------------------------- | -------
Boot-Image-Selection-1 | `CONFIG_BOOTDELAY` | `-2`
Boot-Image-Selection-2 | _bootdelay_ | `-2`
<!-- end-section-config -->
--------------------------------------------------------------------------------
## Image authenticity
It shall not be possible to boot from an unverified image. The secure boot
feature in U-Boot shall be enabled. The secure boot feature is available from
U-Boot 2013.07 version. To enable the secure boot feature, enable the following
features:
```
CONFIG_FIT: Enables support for Flat Image Tree (FIT) uImage format.
CONFIG_FIT_SIGNATURE: Enables signature verification of FIT images.
CONFIG_RSA: Enables RSA algorithm used for FIT image verification.
CONFIG_OF_CONTROL: Enables Flattened Device Tree (FDT) configuration.
CONFIG_OF_SEPARATE: Enables separate build of u-Boot from the device tree.
CONFIG_DEFAULT_DEVICE_TREE: Specifies the default Device Tree used for the run-time configuration of U-Boot.
```
Generate the U-Boot image with public keys to validate and load the image. It
shall use RSA2048 and SHA256 for authentication.
<!-- section-config -->
Domain | `Config` name | _State_
------------------------- | ---------------------------- | --------
Boot-Image-Authenticity-1 | `CONFIG_FIT` | _Enable_
Boot-Image-Authenticity-2 | `CONFIG_FIT_SIGNATURE` | _Enable_
Boot-Image-Authenticity-3 | `CONFIG_RSA` | _Enable_
Boot-Image-Authenticity-4 | `CONFIG_OF_CONTROL` | _Enable_
Boot-Image-Authenticity-5 | `CONFIG_OF_SEPARATE` | _Enable_
Boot-Image-Authenticity-6 | `CONFIG_DEFAULT_DEVICE_TREE` | _Enable_
<!-- end-section-config -->
|
