|Line 151:||Line 151:|
== Documentation ==
== Documentation ==
== Release Notes ==
== Release Notes ==
Revision as of 22:54, 20 January 2021
Signed RPM Contents
We want to add signatures to individual files that are part of shipped RPMs. These signatures will use the Linux IMA (Integrity Measurement Architecture) scheme, which means they can be used to enforce runtime policies to ensure execution of only trusted files.
- Name: Patrick Uiterwijk
- Email: email@example.com
- Name: Peter Robinson
- Email: firstname.lastname@example.org
- Targeted release: Fedora 34
- Last updated: 2021-01-20
- FESCo issue: #2547
- Tracker bug: <will be assigned by the Wrangler>
- Release notes tracker: <will be assigned by the Wrangler>
During signing builds, the files in it will be signed with IMA signatures. These signatures will be made with a key that’s kept by the Fedora Infrastructure team, and installed on the sign vaults.
These signature can then be used with the Linux Integrity Measurement Architecture (IMA) kernel subsystem to verify files on execution based on a policy.
The IMA subsystem is described on the project page.
IMA allows users to extend the trust of their system to the OS and processes.
This means that they can configure a policy based on which the kernel will determine whether to verify (or measure) files before opening them.
You could for example make a policy that appraises (verifies) all files that are executed by root:
appraise uid=1000 appraise_type=imasig.
Note explicitly that we do not intend to install a default policy as part of this change, and users will need to deploy their own policy before anything is measured or appraised. This means that after this is done, users will have the option to enable a policy and have that be enforced, but there will be nothing automatic. We will, however, document various example policies people can adapt to their needs.
One of the main concerns that have been voiced is the RPM size, both on disk (mirrors) and on an installed system. For this comparison, I have cached all the RPMs installed in a Fedora Rawhide 20210118.n.1 default Server install (server netinstall disk, and then no changed to the group selection). After creating two copies of that data, one with just resigned (to exclude rpm size difference resulting from different key lengths), and one resigned with IMA file signatures inserted, I then installed two blank VMs by using the standard virt-manager settings, changing only the name and the system type to "EFI".
This is using a prime256v1 file signing key. This is the same key format supported by the Fedora signing system.
Binary RPMs on disk
Resigned: 462524 (452M)
Resigned+IMA: 467812 (457M)
This comes down to a 1.1% increase on size of the binary RPMs.
On installation of two different VMs, one with the resigned RPMs, and one with the resigned+ima RPMs, the
/usr directory size does not change at all (both are exactly 1417064 bytes).
The size of the rpmdb increases from 22952 to 28416 bytes, a 20% increase. This is on an install size of 1.7GB in total, so this 5MB increase is a 0.3% size increase on the final installed system.
Note that both of those VMs did not have rpm-plugins-ima installed, which means the file signatures are not put in place.
When I install the rpm-plugin-ima, and run "dnf reinstall *", the
/usr directory increases by 0.002% to 1417104.
Tie-in to Secure Boot
While using the IMA subsystem in combination with Secure Boot enables users to extend trust on the system out into the binaries executed, there is no requirement at all to use secure boot. This means that if you have Secure Boot enabled, that enables you to extend the trust, but if you don't want to use secure boot, that has no impact on the IMA subsystem.
Why in the RPM header, instead of a side-package like -debuginfo?
These signatures would need to get deployed as a filesystem extended attribute in order to be used by the IMA subsystem.
While it is possible to generate the signatures as separate files in a side package, that means that RPM would then need to add code to install extended attributes based on contents of another RPM package.
This would mean that the contents of an e.g.
-file-signature subpackage won't be deployed to the file systems as normal files, but instead as xattr's on existing files.
That, together with the minimal size increases of the actual RPMs, made us decide to go with the signature header approach and not implement the side-package method.
Benefit to Fedora
Having all files signed with a verifiable key means that system owners can use the kernel Integrity and Measurement Architecture (IMA) to enforce only verified files can be executed, or define other policies.
Having all files signed with Fedora keys would enable integration with for example , which is a CNCF project that implements remote system attestation, based on which a system may or may not get access to secrets and other consequences.
This feature is wanted by the IoT Edition, for enabling both attestation and local policy verification.
- Proposal owners:
The proposal owners will write the code for sigul to pass the required arguments, generate the keys in Infrastructure and get them deployed to the sign vaults.
- Other developers:
Nothing needed from other developers
- Release engineering:
A mass rebuild would be nice (as it ensures all packages are signed), but is not required to implement the change itself.
- Policies and guidelines:
- Trademark approval:
- Alignment with Objectives:
This aligns with the Internet of Things objective.
For standard Fedora users there will be no impact. If an advanced user was already signing their own files (for the Fedora shipped RPMs) for IMA functionality, they will just overwrite the existing signature.
How To Test
The signatures can be tested “in vitro” by running
evmctl ima_verify --sigfile --key publiccert.der -v myfile.txt.
This should result in the system reporting “<filename>: verification is OK”.
The full system could be tested by enrolling the Fedora IMA key to the kernel
_ima keyring, and adding a policy that verifies (some) files to be verified against the key. (instructions to follow).
If the user deploys an IMA policy to verify all or some files, they should be able to trust the signatures made by the Fedora build system.
No external package dependencies.
- Contingency mechanism: If the change is not finished in time, we have probably not yet started signing new files. Signing can easily be disabled by updating the config file should issues arise.
If we did start signing, but haven’t signed everything, that is okay, since then packages will get signed as they’re bumped by developers, and they’ll be all signed in the next major release.
- Contingency deadline: We could ship with this feature in an unfinished state.
- Blocks release? No
- Blocks product? N/A
We intend to write documentation on how to use the IMA subsystem for docs.fedoraproject.org, but that is parallel to this feature itself.