On Tue, 5 Jul 2022 at 21:22, Daniel P. Smith <dpsmith@xxxxxxxxxxxxxxxxxxxx> wrote: > > On 6/10/22 12:40, Ard Biesheuvel wrote: ... > > The EFI stub to core kernel handover ABI is private to Linux, > > architecture specific, and subject to change. This is basically the > > point I made before: if you want to boot Linux in EFI mode, you have > > to go via the EFI stub, and the EFI stub is in charge of booting the > > kernel proper. This is why I (we?) suggested some kind of callback > > mechanism, where the EFI stub makes a D-RTM specific call after EBS(), > > but does regain control over the boot flow. > > Literally, this is not how the hardware works nor in line with the > architecture developed by TrenchBoot. By doing the Dynamic Launch Event > (DLE) the system, meaning the CPU, has effectively been reset. The > CPU/Dynamic Configuration Environment (DCE) is expecting to be provided > a kernel to measures, an entrypoint within that kernel to jump to, and > that kernel understands the reset state of the system. As agreed, the > callback approach is the most satisfactory approach to allow the > efi-stub to do its private protocol. Once the flow has switched to a > dynamic launch, the system is now starting the kernel via a dynamic > launch sequence. The dynamic launch entrypoint, sl-stub, is and will be > used as the entrypoint regardless of the firmware, > UEFI/coreboot/oreboot/slimboot/etc., or CPU vendor, Intel/AMD, in use. > Once efi-stub finishes and invokes the callback, its job is complete and > the new dl-handler along with sl-stub from the current patch set will > handle the system and security setup needed before entering into the > kernel proper. > > To help provide clarity, consider the following flows for comparison, > > Normal/existing efi-stub: > EFI -> efi-stub -> head_64.S > > Proposed secure launch: > EFI -> efi-stub -> dl-handler -> [cpu] -> sl_stub ->head_64.S > > Effectively, all this is doing is after efi-stub is done, instead of > jumping into head_64.S, it will call the dynamic launch handler to do > the dynamic launch, let sl_stub bring the system back into an expected > state, and then enter head_64.S just as efi-stub would have done. > OK, understood. > > If we add another entry point into the kernel proper for the Secure > > Launch Entry component to use, we are again exposing an internal ABI > > in a way that limits our future ability to make changes to the EFI <-> > > kernel handover. > > I am not sure how you make that jump, but as I stated above, when > incorporating dynamic launch it is no longer a straight pass from EFI to > kernel proper. The sl-stub is there to provide a common entry point from > the CPU as the result of a dynamic launch, regardless of firmware or > vendor. Once sl-stub is done with its start-of-day setup, it will jump > to the same location efi-stub would have jumped. This means, efi-stub > does everything it always has and is free to change what it does. The > only addition is that it will now enable a call-out to allow secure > launch to do what it needs to do, and then execution returns back to > head_64.S. To be concise, it specifically returns where efi-stub would > have jumped to without removing or circumventing anything from the > existing flow. > Excellent, that answers another question I had regarding the above. > It should also be noted that sl-stub will not be looking to reconfigure > the kernel. It will use the kernel as it was set up by efi-stub. The > only job of sl-stub is to make the world right, measure what efi-stub > provided for measurement, and then enter the kernel proper. The design > of the SLRT structure below is specifically not to bind to anything from > the efi-stub ABI/API. The only information needed to take the > measurements is the location of any config items, their size, and an > identifier for each item. The efi-stub is free to add to and/or remove > from the list of items, along with changing where it is stored, or even > change the format of existing items. The one recommendation, not > requirement, is that the identifiers should not freely be changed. While > it has no impact on sl-stub, it will likely be unpopular with anyone > attempting to keep a manifest of valid efi-stub config items for > attestation verification. It will result in having to maintain a > volatile two-parameter map of (kernel version, identifier) to config > item, at a minimum. > OK, noted. Can we add these recommendations to the header files please? And let's make it a requirement - it's easier to relax it later than the other way around. > <snip/> > > >> First, a short review of what the Secure Launch Resource Table is and > >> its purpose. The SLRT is to provide a platform and kernel agnostic > >> configuration table of the meta-data pertinent to the Secure Launch > >> entry points for the variety of kernels the TrenchBoot project will be > >> seeking to support. The specification for the table is in progress, but > >> the consensus is that it will consist of a header structure followed by > >> a packed series of TLV records. The specification will describe the > >> various types of records, but the ones of interests in this discussion > >> are those that efi-stub would use to record how it configured the > >> environment. > >> > >> The initially proposed TLV record, see below, for EFI configuration > >> information was devised around allowing an EFI bootloader to save > >> multiple config events under a single TLV record. In discussions on the > >> specification thus far, there are questions if it would be better to > >> have a TLV record for each config event or the proposed multiple events > >> per TLV record. It is worth noting that an assumption is being made in > >> the proposed record. The assumption is that a config event will either > >> be setting a configuration value between 1 and 8 bytes, or it will be a > >> data blob for which the address and size will be recorded. The question > >> is whether that covers all actions the efi-stub does or expects that it > >> will have to do in the near future. > >> > >> struct slrt_entry_efi_config_event { > >> struct slrt_entry_hdr hdr; > >> uint32_t identifier; /* EFI bootloader ID */ > >> uint16_t reserved; > >> uint16_t nr_entries; /* Num cfg records */ > >> struct efi_cfg_value values[0]; /* Array of cfg values */ Nit: use [] for flex arrays please - we will become more pedantic about this when using newer compilers. > >> }; > >> > >> struct efi_cfg_value { > >> uint64_t data; /* cfg data (address or value) */ > >> uint32_t size; /* data size if data is an addr */ > >> uint32_t flags; /* 1L<0 IS_ADDR: data is an addr */ > >> char evt_info[8]; /* event info str for TPM event log */ > >> }; > >> > >> Hopefully the general approach here is agreeable, as IMHO it does > >> provide a fairly elegant approach to resolving the issues at hand. > >> Details can always be negotiated to address various implementation > >> concerns. Provided this is acceptable, then everyone here is welcome to > >> provide input on the Secure Launch specification, link forthcoming. > >> > > > > Given that this is EFI, I would expect all these implementation > > details to be exposed via a protocol that the stub can invoke, in a > > way that will likely be similar (or the same?) as the TCG protocol > > used for recording PCR measurements. > > The intent here was not to devise a new EFI protocol. This table is an > agnostic structure that all TrenchBoot Secure Launch implementations > will be using for all firmware environments, and will provide platform > relevant sections like the EFI section outlined above. The table will > inform the dl-handler so that it may take appropriate setup actions for > the dynamic launch. The larger user of the table will be the sl-stub, > which it will use to have an understanding of the world it inherited > from whomever invoked the dynamic launch. > OK. We'll need some useful abstraction for this internally in the stub code, but that is not too relevant for this discussion. (We recently added some code that measures the initrd into the TPM, and having calls to two different kinds of measurement APIs all over the stub is something I'd like to avoid) > > So could you elaborate on the types of actions? Is this simply things > > like the command line, initrd contents, initrd load address, kernel > > load address etc etc? There isn't generally that much going on in the > > stub beyond that. > > Actually, those items are already in well-defined locations for which we > are already taking measurements. The items of concern are the items > being passed or configured that are stored outside the boot params. You mean the x86 specific struct bootparams, right? Not relevant, but just out of interest: I take it you are also measuring the setup_data linked list? This is currently being augmented to carry a RNG seed, which may cause problems for you in the future. > For > instance, ROM files passed to the kernel or EFI environment variables > that efi-stub may have set and/or will be used by the kernel. > Hmm, ok. I'd really like to get a peek at the impact on the code - if we will have hooks all over the place, it is a strong indication that you are intercepting this at the wrong level. Perhaps you'll need to do something along the lines of interposing the boot and runtime services, and measuring the invocations that are relevant to you.