1 # SPDX-License-Identifier: GPL-2.0-only 1 # SPDX-License-Identifier: GPL-2.0-only
2 # 2 #
3 config INTEGRITY 3 config INTEGRITY
4 bool "Integrity subsystem" 4 bool "Integrity subsystem"
5 depends on SECURITY 5 depends on SECURITY
6 default y 6 default y
7 help 7 help
8 This option enables the integrity su 8 This option enables the integrity subsystem, which is comprised
9 of a number of different components 9 of a number of different components including the Integrity
10 Measurement Architecture (IMA), Exte 10 Measurement Architecture (IMA), Extended Verification Module
11 (EVM), IMA-appraisal extension, digi 11 (EVM), IMA-appraisal extension, digital signature verification
12 extension and audit measurement log 12 extension and audit measurement log support.
13 13
14 Each of these components can be enab 14 Each of these components can be enabled/disabled separately.
15 Refer to the individual components f 15 Refer to the individual components for additional details.
16 16
17 if INTEGRITY 17 if INTEGRITY
18 18
19 config INTEGRITY_SIGNATURE 19 config INTEGRITY_SIGNATURE
20 bool "Digital signature verification u 20 bool "Digital signature verification using multiple keyrings"
21 default n 21 default n
22 select KEYS 22 select KEYS
23 select SIGNATURE 23 select SIGNATURE
24 help 24 help
25 This option enables digital signatur 25 This option enables digital signature verification support
26 using multiple keyrings. It defines 26 using multiple keyrings. It defines separate keyrings for each
27 of the different use cases - evm, im 27 of the different use cases - evm, ima, and modules.
28 Different keyrings improves search p 28 Different keyrings improves search performance, but also allow
29 to "lock" certain keyring to prevent 29 to "lock" certain keyring to prevent adding new keys.
30 This is useful for evm and module ke 30 This is useful for evm and module keyrings, when keys are
31 usually only added from initramfs. 31 usually only added from initramfs.
32 32
33 config INTEGRITY_ASYMMETRIC_KEYS 33 config INTEGRITY_ASYMMETRIC_KEYS
34 bool "Enable asymmetric keys support" 34 bool "Enable asymmetric keys support"
35 depends on INTEGRITY_SIGNATURE 35 depends on INTEGRITY_SIGNATURE
36 default n 36 default n
37 select ASYMMETRIC_KEY_TYPE !! 37 select ASYMMETRIC_KEY_TYPE
38 select ASYMMETRIC_PUBLIC_KEY_SUBTYPE !! 38 select ASYMMETRIC_PUBLIC_KEY_SUBTYPE
39 select CRYPTO_RSA !! 39 select CRYPTO_RSA
40 select X509_CERTIFICATE_PARSER !! 40 select X509_CERTIFICATE_PARSER
41 help 41 help
42 This option enables digital signatur 42 This option enables digital signature verification using
43 asymmetric keys. 43 asymmetric keys.
44 44
45 config INTEGRITY_TRUSTED_KEYRING 45 config INTEGRITY_TRUSTED_KEYRING
46 bool "Require all keys on the integrit 46 bool "Require all keys on the integrity keyrings be signed"
47 depends on SYSTEM_TRUSTED_KEYRING 47 depends on SYSTEM_TRUSTED_KEYRING
48 depends on INTEGRITY_ASYMMETRIC_KEYS 48 depends on INTEGRITY_ASYMMETRIC_KEYS
49 default y 49 default y
50 help 50 help
51 This option requires that all keys 51 This option requires that all keys added to the .ima and
52 .evm keyrings be signed by a key on 52 .evm keyrings be signed by a key on the system trusted
53 keyring. 53 keyring.
54 54
55 config INTEGRITY_PLATFORM_KEYRING 55 config INTEGRITY_PLATFORM_KEYRING
56 bool "Provide keyring for platform/fir !! 56 bool "Provide keyring for platform/firmware trusted keys"
57 depends on INTEGRITY_ASYMMETRIC_KEYS !! 57 depends on INTEGRITY_ASYMMETRIC_KEYS
58 depends on SYSTEM_BLACKLIST_KEYRING !! 58 depends on SYSTEM_BLACKLIST_KEYRING
59 help !! 59 help
60 Provide a separate, distinct keyring !! 60 Provide a separate, distinct keyring for platform trusted keys, which
61 the kernel automatically populates d !! 61 the kernel automatically populates during initialization from values
62 provided by the platform for verifyi !! 62 provided by the platform for verifying the kexec'ed kerned image
63 and, possibly, the initramfs signatu !! 63 and, possibly, the initramfs signature.
64 64
65 config INTEGRITY_MACHINE_KEYRING 65 config INTEGRITY_MACHINE_KEYRING
66 bool "Provide a keyring to which Machi 66 bool "Provide a keyring to which Machine Owner Keys may be added"
67 depends on SECONDARY_TRUSTED_KEYRING 67 depends on SECONDARY_TRUSTED_KEYRING
68 depends on INTEGRITY_ASYMMETRIC_KEYS 68 depends on INTEGRITY_ASYMMETRIC_KEYS
69 depends on SYSTEM_BLACKLIST_KEYRING 69 depends on SYSTEM_BLACKLIST_KEYRING
70 depends on LOAD_UEFI_KEYS || LOAD_PPC_ !! 70 depends on LOAD_UEFI_KEYS
71 help !! 71 depends on !IMA_KEYRINGS_PERMIT_SIGNED_BY_BUILTIN_OR_SECONDARY
72 If set, provide a keyring to which M <<
73 be added. This keyring shall contain <<
74 in the platform keyring, keys contai <<
75 be trusted within the kernel. <<
76 <<
77 config INTEGRITY_CA_MACHINE_KEYRING <<
78 bool "Enforce Machine Keyring CA Restr <<
79 depends on INTEGRITY_MACHINE_KEYRING <<
80 default n <<
81 help <<
82 The .machine keyring can be configur <<
83 on any key added to it. By default <<
84 and all Machine Owner Keys (MOK) are <<
85 If enabled only CA keys are added to <<
86 other MOK keys load into the platfor <<
87 <<
88 config INTEGRITY_CA_MACHINE_KEYRING_MAX <<
89 bool "Only CA keys without DigitialSig <<
90 depends on INTEGRITY_CA_MACHINE_KEYRIN <<
91 default n <<
92 help 72 help
93 When selected, only load CA keys are !! 73 If set, provide a keyring to which Machine Owner Keys (MOK) may
94 keyring that contain the CA bit set !! 74 be added. This keyring shall contain just MOK keys. Unlike keys
95 Usage field. Keys containing the di !! 75 in the platform keyring, keys contained in the .machine keyring will
96 will not be loaded. The remaining MO !! 76 be trusted within the kernel.
97 .platform keyring. <<
98 77
99 config LOAD_UEFI_KEYS 78 config LOAD_UEFI_KEYS
100 depends on INTEGRITY_PLATFORM_KEYRING !! 79 depends on INTEGRITY_PLATFORM_KEYRING
101 depends on EFI !! 80 depends on EFI
102 def_bool y !! 81 def_bool y
103 82
104 config LOAD_IPL_KEYS 83 config LOAD_IPL_KEYS
105 depends on INTEGRITY_PLATFORM_KEYRING !! 84 depends on INTEGRITY_PLATFORM_KEYRING
106 depends on S390 !! 85 depends on S390
107 def_bool y !! 86 def_bool y
108 87
109 config LOAD_PPC_KEYS 88 config LOAD_PPC_KEYS
110 bool "Enable loading of platform and b 89 bool "Enable loading of platform and blacklisted keys for POWER"
111 depends on INTEGRITY_PLATFORM_KEYRING 90 depends on INTEGRITY_PLATFORM_KEYRING
112 depends on PPC_SECURE_BOOT 91 depends on PPC_SECURE_BOOT
113 default y 92 default y
114 help 93 help
115 Enable loading of keys to the .platf 94 Enable loading of keys to the .platform keyring and blacklisted
116 hashes to the .blacklist keyring for 95 hashes to the .blacklist keyring for powerpc based platforms.
117 96
118 config INTEGRITY_AUDIT 97 config INTEGRITY_AUDIT
119 bool "Enables integrity auditing suppo 98 bool "Enables integrity auditing support "
120 depends on AUDIT 99 depends on AUDIT
121 default y 100 default y
122 help 101 help
123 In addition to enabling integrity au 102 In addition to enabling integrity auditing support, this
124 option adds a kernel parameter 'inte 103 option adds a kernel parameter 'integrity_audit', which
125 controls the level of integrity audi 104 controls the level of integrity auditing messages.
126 0 - basic integrity auditing message 105 0 - basic integrity auditing messages (default)
127 1 - additional integrity auditing me 106 1 - additional integrity auditing messages
128 107
129 Additional informational integrity a 108 Additional informational integrity auditing messages would
130 be enabled by specifying 'integrity_ 109 be enabled by specifying 'integrity_audit=1' on the kernel
131 command line. 110 command line.
132 111
133 source "security/integrity/ima/Kconfig" 112 source "security/integrity/ima/Kconfig"
134 source "security/integrity/evm/Kconfig" 113 source "security/integrity/evm/Kconfig"
135 114
136 endif # if INTEGRITY 115 endif # if INTEGRITY
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.