Go to file
Peter Jones c682b514bf Move embedded certificates to their own section.
With this change, the embedded certificate and dbx lists (vendor_cert,
vendor_cert_size, vendor_dbx, and vendor_dbx_size) wind up being in a
section named .vendor_cert, and so will look something like:
------
fenchurch:~/devel/github.com/shim$ objdump -h shim.efi

shim.efi:     file format pei-x86-64

Sections:
Idx Name          Size      VMA               LMA               File off  Algn
  0 .eh_frame     000174a8  0000000000005000  0000000000005000  00000400  2**3
                  CONTENTS, ALLOC, LOAD, READONLY, DATA
  1 .text         000aa7e1  000000000001d000  000000000001d000  00017a00  2**4
                  CONTENTS, ALLOC, LOAD, READONLY, CODE
  2 .reloc        0000000a  00000000000c8000  00000000000c8000  000c2200  2**0
                  CONTENTS, ALLOC, LOAD, READONLY, DATA
  3 .data         00031228  00000000000c9000  00000000000c9000  000c2400  2**5
                  CONTENTS, ALLOC, LOAD, DATA
  4 .vendor_cert  00000375  00000000000fb000  00000000000fb000  000f3800  2**0
                  CONTENTS, READONLY
  5 .dynamic      000000f0  00000000000fc000  00000000000fc000  000f3c00  2**3
                  CONTENTS, ALLOC, LOAD, DATA
  6 .rela         0002afa8  00000000000fd000  00000000000fd000  000f3e00  2**3
                  CONTENTS, ALLOC, LOAD, READONLY, DATA
  7 .dynsym       0000f1f8  0000000000128000  0000000000128000  0011ee00  2**3
                  CONTENTS, ALLOC, LOAD, READONLY, DATA
------

This simplifies a security audit, because it means that different
versions of shim with substantially the same code with different keys
will be more easily comperable, and therefore logic differences may be
more easily identified.

This also means that if there's a trusted build you want to use, you can
remove the certificates, implant new ones, and have it signed, and the
code sections won't change.

Signed-off-by: Peter Jones <pjones@redhat.com>
2013-06-10 17:35:33 -04:00
Cryptlib Make sure all the Makefiles use the same arguments for mmx/sse/ms_abi. 2013-06-10 16:38:05 -04:00
cert.S Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
COPYRIGHT Add copyright file 2012-07-09 11:03:12 -04:00
dbx.S Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
elf_ia32_efi.lds Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
elf_ia64_efi.lds Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
elf_x86_64_efi.lds Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
fallback.c Fix some minor type errors. 2013-05-15 13:37:15 -04:00
make-certs Sign MokManager with a locally-generated key 2012-11-26 13:43:50 -05:00
Makefile Move embedded certificates to their own section. 2013-06-10 17:35:33 -04:00
MokManager.c Make sure the menu shows when the callback fails 2013-01-03 12:20:30 +08:00
MokVars.txt Add documentation of the Mok variables 2012-10-30 16:14:02 -04:00
netboot.c EFI_PXE_BASE_CODE_DHCPV6_PACKET is in gnu-efi-3.0t 2013-05-31 15:34:11 -04:00
netboot.h Add draft version of Neil's netboot code 2012-10-12 20:14:14 -04:00
PeImage.h dos2unix PeImage.h 2012-09-06 12:01:43 -04:00
README Add basic documentation 2012-07-28 00:42:43 -04:00
shim.c Use the correct define on Open. 2013-05-15 13:38:44 -04:00
shim.h Switch to using db format for MokList and MokNew 2012-10-12 19:55:20 -04:00
signature.h Switch to using db format for MokList and MokNew 2012-10-12 19:55:20 -04:00
TODO Update TODO 2012-07-09 10:39:14 -04:00
ucs2.h Add StrCSpn() 2013-04-30 09:46:22 -04:00

shim is a trivial EFI application that, when run, attempts to open and
execute another application. It will initially attempt to do this via the
standard EFI LoadImage() and StartImage() calls. If these fail (because secure
boot is enabled and the binary is not signed with an appropriate key, for
instance) it will then validate the binary against a built-in certificate. If
this succeeds and if the binary or signing key are not blacklisted then shim
will relocate and execute the binary.

shim will also install a protocol which permits the second-stage bootloader
to perform similar binary validation. This protocol has a GUID as described
in the shim.h header file and provides a single entry point. On 64-bit systems
this entry point expects to be called with SysV ABI rather than MSABI, and
so calls to it should not be wrapped.

To use shim, simply place a hex dump of the public certificate in cert.h
and build it with make.