2
* Copyright (C) 2007 Michael Brown <mbrown@fensystems.co.uk>.
4
* This program is free software; you can redistribute it and/or
5
* modify it under the terms of the GNU General Public License as
6
* published by the Free Software Foundation; either version 2 of the
7
* License, or any later version.
9
* This program is distributed in the hope that it will be useful, but
10
* WITHOUT ANY WARRANTY; without even the implied warranty of
11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12
* General Public License for more details.
14
* You should have received a copy of the GNU General Public License
15
* along with this program; if not, write to the Free Software
16
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19
* You can also choose to distribute this program under the terms of
20
* the Unmodified Binary Distribution Licence (as given in the file
21
* COPYING.UBDL), provided that you have satisfied its requirements.
24
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
27
#include <ipxe/crypto.h>
28
#include <ipxe/sha256.h>
29
#include <ipxe/x509.h>
30
#include <ipxe/settings.h>
31
#include <ipxe/dhcp.h>
32
#include <ipxe/init.h>
33
#include <ipxe/rootcert.h>
37
* Root certificate store
41
/** Length of a root certificate fingerprint */
42
#define FINGERPRINT_LEN SHA256_DIGEST_SIZE
44
/* Allow trusted certificates to be overridden if not explicitly specified */
46
#define ALLOW_TRUST_OVERRIDE 0
48
#define ALLOW_TRUST_OVERRIDE 1
51
/* Use iPXE root CA if no trusted certificates are explicitly specified */
55
0x9f, 0xaf, 0x71, 0x7b, 0x7f, 0x8c, 0xa2, 0xf9, 0x3c, 0x25, \
56
0x6c, 0x79, 0xf8, 0xac, 0x55, 0x91, 0x89, 0x5d, 0x66, 0xd1, \
57
0xff, 0x3b, 0xee, 0x63, 0x97, 0xa7, 0x0d, 0x29, 0xc6, 0x5e, \
61
/** Root certificate fingerprints */
62
static const uint8_t fingerprints[] = { TRUSTED };
64
/** Root certificate fingerprint setting */
65
static struct setting trust_setting __setting ( SETTING_CRYPTO, trust ) = {
67
.description = "Trusted root certificate fingerprints",
69
.type = &setting_type_hex,
72
/** Root certificates */
73
struct x509_root root_certificates = {
74
.digest = &sha256_algorithm,
75
.count = ( sizeof ( fingerprints ) / FINGERPRINT_LEN ),
76
.fingerprints = fingerprints,
80
* Initialise root certificate
82
* The list of trusted root certificates can be specified at build
83
* time using the TRUST= build parameter. If no certificates are
84
* specified, then the default iPXE root CA certificate is trusted.
86
* If no certificates were explicitly specified, then we allow the
87
* list of trusted root certificate fingerprints to be overridden
88
* using the "trust" setting, but only at the point of iPXE
89
* initialisation. This prevents untrusted sources of settings
90
* (e.g. DHCP) from subverting the chain of trust, while allowing
91
* trustworthy sources (e.g. VMware GuestInfo or non-volatile stored
92
* options) to specify the trusted root certificate without requiring
95
static void rootcert_init ( void ) {
96
static int initialised;
97
void *external = NULL;
100
/* Allow trusted root certificates to be overridden only if
101
* not explicitly specified at build time.
103
if ( ALLOW_TRUST_OVERRIDE && ( ! initialised ) ) {
105
/* Fetch copy of "trust" setting, if it exists. This
106
* memory will never be freed.
108
if ( ( len = fetch_raw_setting_copy ( NULL, &trust_setting,
109
&external ) ) >= 0 ) {
110
root_certificates.fingerprints = external;
111
root_certificates.count = ( len / FINGERPRINT_LEN );
114
/* Prevent subsequent modifications */
118
DBGC ( &root_certificates, "ROOTCERT using %d %s certificate(s):\n",
119
root_certificates.count, ( external ? "external" : "built-in" ));
120
DBGC_HDA ( &root_certificates, 0, root_certificates.fingerprints,
121
( root_certificates.count * FINGERPRINT_LEN ) );
124
/** Root certificate initialiser */
125
struct startup_fn rootcert_startup_fn __startup_fn ( STARTUP_LATE ) = {
126
.startup = rootcert_init,