blob: 7b65b698a35c74ab6ea05a35409c13407230237d [file] [log] [blame]
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001/*
Manuel Pégourié-Gonnard1c082f32014-06-12 22:34:55 +02002 * X.509 certificate parsing and verification
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003 *
Bence Szépkúti1e148272020-08-07 13:07:28 +02004 * Copyright The Mbed TLS Contributors
Dave Rodgman16799db2023-11-02 19:47:20 +00005 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
Paul Bakker7c6b2c32013-09-16 13:49:26 +02006 */
7/*
8 * The ITU-T X.509 standard defines a certificate format for PKI.
9 *
Manuel Pégourié-Gonnard1c082f32014-06-12 22:34:55 +020010 * http://www.ietf.org/rfc/rfc5280.txt (Certificates and CRLs)
11 * http://www.ietf.org/rfc/rfc3279.txt (Alg IDs for CRLs)
12 * http://www.ietf.org/rfc/rfc2986.txt (CSRs, aka PKCS#10)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020013 *
14 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.680-0207.pdf
15 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +020016 *
17 * [SIRO] https://cabforum.org/wp-content/uploads/Chunghwatelecom201503cabforumV4.pdf
Paul Bakker7c6b2c32013-09-16 13:49:26 +020018 */
19
Harry Ramsey0f6bc412024-10-04 10:36:54 +010020#include "x509_internal.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020021
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020022#if defined(MBEDTLS_X509_CRT_PARSE_C)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020023
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000024#include "mbedtls/x509_crt.h"
Janos Follath73c616b2019-12-18 15:07:04 +000025#include "mbedtls/error.h"
Gilles Peskinecd4c0d72025-05-07 23:45:12 +020026#include "mbedtls/oid.h"
Gilles Peskine86a47f82025-05-07 20:20:12 +020027#include "x509_oid.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050028#include "mbedtls/platform_util.h"
Rich Evans00ab4702015-02-06 13:43:58 +000029
Gilles Peskine1819a912025-07-22 21:54:50 +020030#include <limits.h>
Rich Evans00ab4702015-02-06 13:43:58 +000031#include <string.h>
32
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020033#if defined(MBEDTLS_PEM_PARSE_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000034#include "mbedtls/pem.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020035#endif
36
Andrzej Kurekd4a65532018-10-31 06:18:39 -040037#include "psa/crypto.h"
Manuel Pégourié-Gonnard2be8c632023-06-07 13:07:21 +020038#include "psa_util_internal.h"
Valerio Setti384fbde2024-01-02 13:26:40 +010039#include "mbedtls/psa_util.h"
Valerio Setti3f00b842023-05-15 12:57:06 +020040#include "pk_internal.h"
Andrzej Kurekd4a65532018-10-31 06:18:39 -040041
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000042#include "mbedtls/platform.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020043
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020044#if defined(MBEDTLS_THREADING_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000045#include "mbedtls/threading.h"
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +010046#endif
47
Daniel Axtensf0710242020-05-28 11:43:41 +100048#if defined(MBEDTLS_HAVE_TIME)
Paul Bakkerfa6a6202013-10-28 18:48:30 +010049#if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
Sergey Markelov4ed0fde2024-08-14 15:06:03 -070050#ifndef WIN32_LEAN_AND_MEAN
Glenn Straussc26bd762022-10-23 19:48:18 -040051#define WIN32_LEAN_AND_MEAN
Sergey Markelov4ed0fde2024-08-14 15:06:03 -070052#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +020053#include <windows.h>
54#else
55#include <time.h>
56#endif
Daniel Axtensf0710242020-05-28 11:43:41 +100057#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +020058
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020059#if defined(MBEDTLS_FS_IO)
Rich Evans00ab4702015-02-06 13:43:58 +000060#include <stdio.h>
Paul Bakker5ff3f912014-04-04 15:08:20 +020061#if !defined(_WIN32) || defined(EFIX64) || defined(EFI32)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020062#include <sys/types.h>
63#include <sys/stat.h>
Martino Facchin0ec05ec2021-05-04 11:47:36 +020064#if defined(__MBED__)
65#include <platform/mbed_retarget.h>
66#else
Paul Bakker7c6b2c32013-09-16 13:49:26 +020067#include <dirent.h>
Martino Facchin0ec05ec2021-05-04 11:47:36 +020068#endif /* __MBED__ */
Eduardo Silvae1bfffc2019-04-25 10:43:26 -060069#include <errno.h>
Rich Evans00ab4702015-02-06 13:43:58 +000070#endif /* !_WIN32 || EFIX64 || EFI32 */
Paul Bakker7c6b2c32013-09-16 13:49:26 +020071#endif
72
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +020073/*
74 * Item in a verification chain: cert and flags for it
75 */
76typedef struct {
77 mbedtls_x509_crt *crt;
78 uint32_t flags;
79} x509_crt_verify_chain_item;
80
81/*
82 * Max size of verification chain: end-entity + intermediates + trusted root
83 */
Gilles Peskine449bd832023-01-11 14:50:10 +010084#define X509_MAX_VERIFY_CHAIN_SIZE (MBEDTLS_X509_MAX_INTERMEDIATE_CA + 2)
Paul Bakker34617722014-06-13 17:20:13 +020085
Gilles Peskineffb92da2021-06-02 00:03:26 +020086/* Default profile. Do not remove items unless there are serious security
87 * concerns. */
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +020088const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_default =
89{
Gilles Peskineae270bf2021-06-02 00:05:29 +020090 /* Hashes from SHA-256 and above. Note that this selection
91 * should be aligned with ssl_preset_default_hashes in ssl_tls.c. */
Gilles Peskine449bd832023-01-11 14:50:10 +010092 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
93 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384) |
94 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA512),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +020095 0xFFFFFFF, /* Any PK alg */
Elena Uziunaite8dde3b32024-07-05 12:10:21 +010096#if defined(PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY)
Gilles Peskineae270bf2021-06-02 00:05:29 +020097 /* Curves at or above 128-bit security level. Note that this selection
98 * should be aligned with ssl_preset_default_curves in ssl_tls.c. */
Gilles Peskine449bd832023-01-11 14:50:10 +010099 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
100 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1) |
101 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP521R1) |
102 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP256R1) |
103 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP384R1) |
104 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP512R1) |
Gilles Peskine39957502021-06-17 23:17:52 +0200105 0,
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100106#else /* PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY */
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200107 0,
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100108#endif /* PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY */
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200109 2048,
110};
111
Gilles Peskineffb92da2021-06-02 00:03:26 +0200112/* Next-generation profile. Currently identical to the default, but may
113 * be tightened at any time. */
114const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_next =
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200115{
116 /* Hashes from SHA-256 and above. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100117 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
118 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384) |
119 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA512),
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200120 0xFFFFFFF, /* Any PK alg */
121#if defined(MBEDTLS_ECP_C)
122 /* Curves at or above 128-bit security level. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100123 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
124 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1) |
125 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP521R1) |
126 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP256R1) |
127 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP384R1) |
128 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP512R1) |
129 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256K1),
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200130#else
131 0,
132#endif
133 2048,
134};
Gilles Peskineffb92da2021-06-02 00:03:26 +0200135
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200136/*
137 * NSA Suite B Profile
138 */
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200139const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_suiteb =
140{
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200141 /* Only SHA-256 and 384 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100142 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
143 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200144 /* Only ECDSA */
Gilles Peskine449bd832023-01-11 14:50:10 +0100145 MBEDTLS_X509_ID_FLAG(MBEDTLS_PK_ECDSA) |
146 MBEDTLS_X509_ID_FLAG(MBEDTLS_PK_ECKEY),
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100147#if defined(PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY)
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200148 /* Only NIST P-256 and P-384 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100149 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
150 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1),
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100151#else /* PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY */
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200152 0,
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100153#endif /* PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY */
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200154 0,
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200155};
156
157/*
Manuel Pégourié-Gonnard9d4c2c42021-06-18 09:48:27 +0200158 * Empty / all-forbidden profile
159 */
160const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_none =
161{
162 0,
163 0,
164 0,
165 (uint32_t) -1,
166};
167
168/*
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200169 * Check md_alg against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200170 * Return 0 if md_alg is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200171 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100172static int x509_profile_check_md_alg(const mbedtls_x509_crt_profile *profile,
173 mbedtls_md_type_t md_alg)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200174{
Gilles Peskine449bd832023-01-11 14:50:10 +0100175 if (md_alg == MBEDTLS_MD_NONE) {
176 return -1;
177 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200178
Gilles Peskine449bd832023-01-11 14:50:10 +0100179 if ((profile->allowed_mds & MBEDTLS_X509_ID_FLAG(md_alg)) != 0) {
180 return 0;
181 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200182
Gilles Peskine449bd832023-01-11 14:50:10 +0100183 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200184}
185
186/*
187 * Check pk_alg against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200188 * Return 0 if pk_alg is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200189 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100190static int x509_profile_check_pk_alg(const mbedtls_x509_crt_profile *profile,
191 mbedtls_pk_type_t pk_alg)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200192{
Gilles Peskine449bd832023-01-11 14:50:10 +0100193 if (pk_alg == MBEDTLS_PK_NONE) {
194 return -1;
195 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200196
Gilles Peskine449bd832023-01-11 14:50:10 +0100197 if ((profile->allowed_pks & MBEDTLS_X509_ID_FLAG(pk_alg)) != 0) {
198 return 0;
199 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200200
Gilles Peskine449bd832023-01-11 14:50:10 +0100201 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200202}
203
204/*
205 * Check key against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200206 * Return 0 if pk is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200207 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100208static int x509_profile_check_key(const mbedtls_x509_crt_profile *profile,
209 const mbedtls_pk_context *pk)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200210{
Gilles Peskine449bd832023-01-11 14:50:10 +0100211 const mbedtls_pk_type_t pk_alg = mbedtls_pk_get_type(pk);
Manuel Pégourié-Gonnard19773ff2017-10-24 10:51:26 +0200212
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200213#if defined(MBEDTLS_RSA_C)
Gilles Peskine449bd832023-01-11 14:50:10 +0100214 if (pk_alg == MBEDTLS_PK_RSA || pk_alg == MBEDTLS_PK_RSASSA_PSS) {
215 if (mbedtls_pk_get_bitlen(pk) >= profile->rsa_min_bitlen) {
216 return 0;
217 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200218
Gilles Peskine449bd832023-01-11 14:50:10 +0100219 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200220 }
Valerio Settid4a5d462023-04-05 18:19:01 +0200221#endif /* MBEDTLS_RSA_C */
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200222
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100223#if defined(PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY)
Gilles Peskine449bd832023-01-11 14:50:10 +0100224 if (pk_alg == MBEDTLS_PK_ECDSA ||
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +0200225 pk_alg == MBEDTLS_PK_ECKEY ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100226 pk_alg == MBEDTLS_PK_ECKEY_DH) {
Valerio Settif9362b72023-11-29 08:42:27 +0100227 const mbedtls_ecp_group_id gid = mbedtls_pk_get_ec_group_id(pk);
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200228
Gilles Peskine449bd832023-01-11 14:50:10 +0100229 if (gid == MBEDTLS_ECP_DP_NONE) {
230 return -1;
231 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200232
Gilles Peskine449bd832023-01-11 14:50:10 +0100233 if ((profile->allowed_curves & MBEDTLS_X509_ID_FLAG(gid)) != 0) {
234 return 0;
235 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200236
Gilles Peskine449bd832023-01-11 14:50:10 +0100237 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200238 }
Elena Uziunaite8dde3b32024-07-05 12:10:21 +0100239#endif /* PSA_WANT_KEY_TYPE_ECC_PUBLIC_KEY */
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200240
Gilles Peskine449bd832023-01-11 14:50:10 +0100241 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200242}
243
244/*
Hanno Becker1f8527f2018-11-02 09:19:16 +0000245 * Like memcmp, but case-insensitive and always returns -1 if different
246 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100247static int x509_memcasecmp(const void *s1, const void *s2, size_t len)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000248{
249 size_t i;
250 unsigned char diff;
251 const unsigned char *n1 = s1, *n2 = s2;
252
Gilles Peskine449bd832023-01-11 14:50:10 +0100253 for (i = 0; i < len; i++) {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000254 diff = n1[i] ^ n2[i];
255
Gilles Peskine449bd832023-01-11 14:50:10 +0100256 if (diff == 0) {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000257 continue;
258 }
259
Gilles Peskine449bd832023-01-11 14:50:10 +0100260 if (diff == 32 &&
261 ((n1[i] >= 'a' && n1[i] <= 'z') ||
262 (n1[i] >= 'A' && n1[i] <= 'Z'))) {
263 continue;
264 }
265
266 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000267 }
268
Gilles Peskine449bd832023-01-11 14:50:10 +0100269 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000270}
271
272/*
273 * Return 0 if name matches wildcard, -1 otherwise
274 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100275static int x509_check_wildcard(const char *cn, const mbedtls_x509_buf *name)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000276{
277 size_t i;
Gilles Peskine449bd832023-01-11 14:50:10 +0100278 size_t cn_idx = 0, cn_len = strlen(cn);
Hanno Becker1f8527f2018-11-02 09:19:16 +0000279
280 /* We can't have a match if there is no wildcard to match */
Gilles Peskine449bd832023-01-11 14:50:10 +0100281 if (name->len < 3 || name->p[0] != '*' || name->p[1] != '.') {
282 return -1;
283 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000284
Gilles Peskine449bd832023-01-11 14:50:10 +0100285 for (i = 0; i < cn_len; ++i) {
286 if (cn[i] == '.') {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000287 cn_idx = i;
288 break;
289 }
290 }
291
Gilles Peskine449bd832023-01-11 14:50:10 +0100292 if (cn_idx == 0) {
293 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000294 }
295
Gilles Peskine449bd832023-01-11 14:50:10 +0100296 if (cn_len - cn_idx == name->len - 1 &&
297 x509_memcasecmp(name->p + 1, cn + cn_idx, name->len - 1) == 0) {
298 return 0;
299 }
300
301 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000302}
303
304/*
305 * Compare two X.509 strings, case-insensitive, and allowing for some encoding
306 * variations (but not all).
307 *
308 * Return 0 if equal, -1 otherwise.
309 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100310static int x509_string_cmp(const mbedtls_x509_buf *a, const mbedtls_x509_buf *b)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000311{
Gilles Peskine449bd832023-01-11 14:50:10 +0100312 if (a->tag == b->tag &&
Hanno Becker1f8527f2018-11-02 09:19:16 +0000313 a->len == b->len &&
Gilles Peskine449bd832023-01-11 14:50:10 +0100314 memcmp(a->p, b->p, b->len) == 0) {
315 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000316 }
317
Gilles Peskine449bd832023-01-11 14:50:10 +0100318 if ((a->tag == MBEDTLS_ASN1_UTF8_STRING || a->tag == MBEDTLS_ASN1_PRINTABLE_STRING) &&
319 (b->tag == MBEDTLS_ASN1_UTF8_STRING || b->tag == MBEDTLS_ASN1_PRINTABLE_STRING) &&
Hanno Becker1f8527f2018-11-02 09:19:16 +0000320 a->len == b->len &&
Gilles Peskine449bd832023-01-11 14:50:10 +0100321 x509_memcasecmp(a->p, b->p, b->len) == 0) {
322 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000323 }
324
Gilles Peskine449bd832023-01-11 14:50:10 +0100325 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000326}
327
328/*
329 * Compare two X.509 Names (aka rdnSequence).
330 *
331 * See RFC 5280 section 7.1, though we don't implement the whole algorithm:
332 * we sometimes return unequal when the full algorithm would return equal,
333 * but never the other way. (In particular, we don't do Unicode normalisation
334 * or space folding.)
335 *
336 * Return 0 if equal, -1 otherwise.
337 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100338static int x509_name_cmp(const mbedtls_x509_name *a, const mbedtls_x509_name *b)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000339{
340 /* Avoid recursion, it might not be optimised by the compiler */
Gilles Peskine449bd832023-01-11 14:50:10 +0100341 while (a != NULL || b != NULL) {
342 if (a == NULL || b == NULL) {
343 return -1;
344 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000345
346 /* type */
Gilles Peskine449bd832023-01-11 14:50:10 +0100347 if (a->oid.tag != b->oid.tag ||
Hanno Becker1f8527f2018-11-02 09:19:16 +0000348 a->oid.len != b->oid.len ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100349 memcmp(a->oid.p, b->oid.p, b->oid.len) != 0) {
350 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000351 }
352
353 /* value */
Gilles Peskine449bd832023-01-11 14:50:10 +0100354 if (x509_string_cmp(&a->val, &b->val) != 0) {
355 return -1;
356 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000357
358 /* structure of the list of sets */
Gilles Peskine449bd832023-01-11 14:50:10 +0100359 if (a->next_merged != b->next_merged) {
360 return -1;
361 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000362
363 a = a->next;
364 b = b->next;
365 }
366
367 /* a == NULL == b */
Gilles Peskine449bd832023-01-11 14:50:10 +0100368 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000369}
370
371/*
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200372 * Reset (init or clear) a verify_chain
373 */
374static void x509_crt_verify_chain_reset(
Gilles Peskine449bd832023-01-11 14:50:10 +0100375 mbedtls_x509_crt_verify_chain *ver_chain)
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200376{
377 size_t i;
378
Gilles Peskine449bd832023-01-11 14:50:10 +0100379 for (i = 0; i < MBEDTLS_X509_MAX_VERIFY_CHAIN_SIZE; i++) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200380 ver_chain->items[i].crt = NULL;
Hanno Beckera9375b32019-01-10 09:19:26 +0000381 ver_chain->items[i].flags = (uint32_t) -1;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200382 }
383
384 ver_chain->len = 0;
Hanno Beckerf53893b2019-03-28 13:45:55 +0000385
386#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
387 ver_chain->trust_ca_cb_result = NULL;
388#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200389}
390
391/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200392 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
393 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100394static int x509_get_version(unsigned char **p,
395 const unsigned char *end,
396 int *ver)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200397{
Janos Follath865b3eb2019-12-16 11:46:15 +0000398 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200399 size_t len;
400
Gilles Peskine449bd832023-01-11 14:50:10 +0100401 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
402 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
403 0)) != 0) {
404 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200405 *ver = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +0100406 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200407 }
408
Gilles Peskine449bd832023-01-11 14:50:10 +0100409 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200410 }
411
412 end = *p + len;
413
Gilles Peskine449bd832023-01-11 14:50:10 +0100414 if ((ret = mbedtls_asn1_get_int(p, end, ver)) != 0) {
415 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_VERSION, ret);
416 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200417
Gilles Peskine449bd832023-01-11 14:50:10 +0100418 if (*p != end) {
419 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_VERSION,
420 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
421 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200422
Gilles Peskine449bd832023-01-11 14:50:10 +0100423 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200424}
425
426/*
427 * Validity ::= SEQUENCE {
428 * notBefore Time,
429 * notAfter Time }
430 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100431static int x509_get_dates(unsigned char **p,
432 const unsigned char *end,
433 mbedtls_x509_time *from,
434 mbedtls_x509_time *to)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200435{
Janos Follath865b3eb2019-12-16 11:46:15 +0000436 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200437 size_t len;
438
Gilles Peskine449bd832023-01-11 14:50:10 +0100439 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
440 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
441 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_DATE, ret);
442 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200443
444 end = *p + len;
445
Gilles Peskine449bd832023-01-11 14:50:10 +0100446 if ((ret = mbedtls_x509_get_time(p, end, from)) != 0) {
447 return ret;
448 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200449
Gilles Peskine449bd832023-01-11 14:50:10 +0100450 if ((ret = mbedtls_x509_get_time(p, end, to)) != 0) {
451 return ret;
452 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200453
Gilles Peskine449bd832023-01-11 14:50:10 +0100454 if (*p != end) {
455 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_DATE,
456 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
457 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200458
Gilles Peskine449bd832023-01-11 14:50:10 +0100459 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200460}
461
462/*
463 * X.509 v2/v3 unique identifier (not parsed)
464 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100465static int x509_get_uid(unsigned char **p,
466 const unsigned char *end,
467 mbedtls_x509_buf *uid, int n)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200468{
Janos Follath865b3eb2019-12-16 11:46:15 +0000469 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200470
Gilles Peskine449bd832023-01-11 14:50:10 +0100471 if (*p == end) {
472 return 0;
473 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200474
475 uid->tag = **p;
476
Gilles Peskine449bd832023-01-11 14:50:10 +0100477 if ((ret = mbedtls_asn1_get_tag(p, end, &uid->len,
478 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
479 n)) != 0) {
480 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
481 return 0;
482 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200483
Gilles Peskine449bd832023-01-11 14:50:10 +0100484 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200485 }
486
487 uid->p = *p;
488 *p += uid->len;
489
Gilles Peskine449bd832023-01-11 14:50:10 +0100490 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200491}
492
Gilles Peskine449bd832023-01-11 14:50:10 +0100493static int x509_get_basic_constraints(unsigned char **p,
494 const unsigned char *end,
495 int *ca_istrue,
496 int *max_pathlen)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200497{
Janos Follath865b3eb2019-12-16 11:46:15 +0000498 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200499 size_t len;
500
501 /*
502 * BasicConstraints ::= SEQUENCE {
503 * cA BOOLEAN DEFAULT FALSE,
504 * pathLenConstraint INTEGER (0..MAX) OPTIONAL }
505 */
506 *ca_istrue = 0; /* DEFAULT FALSE */
507 *max_pathlen = 0; /* endless */
508
Gilles Peskine449bd832023-01-11 14:50:10 +0100509 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
510 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
511 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200512 }
513
Gilles Peskine449bd832023-01-11 14:50:10 +0100514 if (*p == end) {
515 return 0;
516 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200517
Gilles Peskine449bd832023-01-11 14:50:10 +0100518 if ((ret = mbedtls_asn1_get_bool(p, end, ca_istrue)) != 0) {
519 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
520 ret = mbedtls_asn1_get_int(p, end, ca_istrue);
521 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200522
Gilles Peskine449bd832023-01-11 14:50:10 +0100523 if (ret != 0) {
524 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
525 }
526
527 if (*ca_istrue != 0) {
528 *ca_istrue = 1;
529 }
530 }
531
532 if (*p == end) {
533 return 0;
534 }
535
536 if ((ret = mbedtls_asn1_get_int(p, end, max_pathlen)) != 0) {
537 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
538 }
539
540 if (*p != end) {
541 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
542 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
543 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200544
Andrzej Kurek16050742020-04-14 09:49:52 -0400545 /* Do not accept max_pathlen equal to INT_MAX to avoid a signed integer
546 * overflow, which is an undefined behavior. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100547 if (*max_pathlen == INT_MAX) {
548 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
549 MBEDTLS_ERR_ASN1_INVALID_LENGTH);
550 }
Andrzej Kurek16050742020-04-14 09:49:52 -0400551
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200552 (*max_pathlen)++;
553
Gilles Peskine449bd832023-01-11 14:50:10 +0100554 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200555}
556
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200557/*
558 * ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
559 *
560 * KeyPurposeId ::= OBJECT IDENTIFIER
561 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100562static int x509_get_ext_key_usage(unsigned char **p,
563 const unsigned char *end,
564 mbedtls_x509_sequence *ext_key_usage)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200565{
Janos Follath865b3eb2019-12-16 11:46:15 +0000566 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200567
Gilles Peskine449bd832023-01-11 14:50:10 +0100568 if ((ret = mbedtls_asn1_get_sequence_of(p, end, ext_key_usage, MBEDTLS_ASN1_OID)) != 0) {
569 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
570 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200571
572 /* Sequence length must be >= 1 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100573 if (ext_key_usage->buf.p == NULL) {
574 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
575 MBEDTLS_ERR_ASN1_INVALID_LENGTH);
576 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200577
Gilles Peskine449bd832023-01-11 14:50:10 +0100578 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200579}
580
581/*
toth92ga41954d2021-02-12 16:11:17 +0100582 * SubjectKeyIdentifier ::= KeyIdentifier
583 *
584 * KeyIdentifier ::= OCTET STRING
585 */
586static int x509_get_subject_key_id(unsigned char **p,
587 const unsigned char *end,
588 mbedtls_x509_buf *subject_key_id)
589{
590 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
591 size_t len = 0u;
592
593 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
594 MBEDTLS_ASN1_OCTET_STRING)) != 0) {
Przemek Stekiel75653b12023-02-01 11:31:32 +0100595 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
toth92ga41954d2021-02-12 16:11:17 +0100596 }
597
Przemek Stekiel61aed062023-05-08 11:14:36 +0200598 subject_key_id->len = len;
599 subject_key_id->tag = MBEDTLS_ASN1_OCTET_STRING;
600 subject_key_id->p = *p;
601 *p += len;
602
toth92gd96027a2021-04-27 15:41:25 +0200603 if (*p != end) {
Przemek Stekiel3520fe62023-01-30 14:38:18 +0100604 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
605 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
toth92gd96027a2021-04-27 15:41:25 +0200606 }
607
toth92ga41954d2021-02-12 16:11:17 +0100608 return 0;
609}
610
Przemek Stekiel4f3e7b92023-02-03 15:03:59 +0100611/*
toth92g8d435a02021-05-10 15:16:33 +0200612 * AuthorityKeyIdentifier ::= SEQUENCE {
613 * keyIdentifier [0] KeyIdentifier OPTIONAL,
614 * authorityCertIssuer [1] GeneralNames OPTIONAL,
615 * authorityCertSerialNumber [2] CertificateSerialNumber OPTIONAL }
616 *
617 * KeyIdentifier ::= OCTET STRING
618 */
619static int x509_get_authority_key_id(unsigned char **p,
620 unsigned char *end,
621 mbedtls_x509_authority *authority_key_id)
622{
623 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
624 size_t len = 0u;
625
626 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
Przemek Stekiel3520fe62023-01-30 14:38:18 +0100627 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
Przemek Stekiel75653b12023-02-01 11:31:32 +0100628 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
toth92g8d435a02021-05-10 15:16:33 +0200629 }
630
Przemek Stekiel6ec839a2023-02-01 11:06:08 +0100631 if (*p + len != end) {
632 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
633 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
634 }
635
Przemek Stekieled9fb782023-05-03 16:27:25 +0200636 ret = mbedtls_asn1_get_tag(p, end, &len,
637 MBEDTLS_ASN1_CONTEXT_SPECIFIC);
638
639 /* KeyIdentifier is an OPTIONAL field */
Przemek Stekiel61aed062023-05-08 11:14:36 +0200640 if (ret == 0) {
toth92g8d435a02021-05-10 15:16:33 +0200641 authority_key_id->keyIdentifier.len = len;
642 authority_key_id->keyIdentifier.p = *p;
toth92g9232e0a2021-05-11 12:55:58 +0200643 /* Setting tag of the keyIdentfier intentionally to 0x04.
644 * Although the .keyIdentfier field is CONTEXT_SPECIFIC ([0] OPTIONAL),
Przemek Stekiel9a7a7252023-04-17 16:06:57 +0200645 * its tag with the content is the payload of on OCTET STRING primitive */
toth92g8d435a02021-05-10 15:16:33 +0200646 authority_key_id->keyIdentifier.tag = MBEDTLS_ASN1_OCTET_STRING;
647
648 *p += len;
Przemek Stekiel61aed062023-05-08 11:14:36 +0200649 } else if (ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
650 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
toth92g8d435a02021-05-10 15:16:33 +0200651 }
652
653 if (*p < end) {
toth92g9232e0a2021-05-11 12:55:58 +0200654 /* Getting authorityCertIssuer using the required specific class tag [1] */
toth92g8d435a02021-05-10 15:16:33 +0200655 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
656 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
Przemek Stekiel4f3e7b92023-02-03 15:03:59 +0100657 1)) != 0) {
Przemek Stekielf5b8f782023-04-26 08:55:26 +0200658 /* authorityCertIssuer and authorityCertSerialNumber MUST both
659 be present or both be absent. At this point we expect to have both. */
660 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
toth92g8d435a02021-05-10 15:16:33 +0200661 }
Przemek Stekieled9fb782023-05-03 16:27:25 +0200662 /* "end" also includes the CertSerialNumber field so "len" shall be used */
663 ret = mbedtls_x509_get_subject_alt_name_ext(p,
664 (*p+len),
665 &authority_key_id->authorityCertIssuer);
666 if (ret != 0) {
667 return ret;
668 }
669
670 /* Getting authorityCertSerialNumber using the required specific class tag [2] */
671 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
672 MBEDTLS_ASN1_CONTEXT_SPECIFIC | 2)) != 0) {
673 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
674 }
675 authority_key_id->authorityCertSerialNumber.len = len;
676 authority_key_id->authorityCertSerialNumber.p = *p;
677 authority_key_id->authorityCertSerialNumber.tag = MBEDTLS_ASN1_INTEGER;
678 *p += len;
toth92g8d435a02021-05-10 15:16:33 +0200679 }
680
681 if (*p != end) {
Gilles Peskine8085f512024-09-15 12:45:44 +0200682 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
683 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
toth92g8d435a02021-05-10 15:16:33 +0200684 }
685
686 return 0;
687}
688
689/*
Ron Eldor74d9acc2019-03-21 14:00:03 +0200690 * id-ce-certificatePolicies OBJECT IDENTIFIER ::= { id-ce 32 }
691 *
692 * anyPolicy OBJECT IDENTIFIER ::= { id-ce-certificatePolicies 0 }
693 *
694 * certificatePolicies ::= SEQUENCE SIZE (1..MAX) OF PolicyInformation
695 *
696 * PolicyInformation ::= SEQUENCE {
697 * policyIdentifier CertPolicyId,
698 * policyQualifiers SEQUENCE SIZE (1..MAX) OF
699 * PolicyQualifierInfo OPTIONAL }
700 *
701 * CertPolicyId ::= OBJECT IDENTIFIER
702 *
703 * PolicyQualifierInfo ::= SEQUENCE {
704 * policyQualifierId PolicyQualifierId,
705 * qualifier ANY DEFINED BY policyQualifierId }
706 *
707 * -- policyQualifierIds for Internet policy qualifiers
708 *
709 * id-qt OBJECT IDENTIFIER ::= { id-pkix 2 }
710 * id-qt-cps OBJECT IDENTIFIER ::= { id-qt 1 }
711 * id-qt-unotice OBJECT IDENTIFIER ::= { id-qt 2 }
712 *
713 * PolicyQualifierId ::= OBJECT IDENTIFIER ( id-qt-cps | id-qt-unotice )
714 *
715 * Qualifier ::= CHOICE {
716 * cPSuri CPSuri,
717 * userNotice UserNotice }
718 *
719 * CPSuri ::= IA5String
720 *
721 * UserNotice ::= SEQUENCE {
722 * noticeRef NoticeReference OPTIONAL,
723 * explicitText DisplayText OPTIONAL }
724 *
725 * NoticeReference ::= SEQUENCE {
726 * organization DisplayText,
727 * noticeNumbers SEQUENCE OF INTEGER }
728 *
729 * DisplayText ::= CHOICE {
730 * ia5String IA5String (SIZE (1..200)),
731 * visibleString VisibleString (SIZE (1..200)),
732 * bmpString BMPString (SIZE (1..200)),
733 * utf8String UTF8String (SIZE (1..200)) }
734 *
735 * NOTE: we only parse and use anyPolicy without qualifiers at this point
736 * as defined in RFC 5280.
737 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100738static int x509_get_certificate_policies(unsigned char **p,
739 const unsigned char *end,
740 mbedtls_x509_sequence *certificate_policies)
Ron Eldor74d9acc2019-03-21 14:00:03 +0200741{
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300742 int ret, parse_ret = 0;
Ron Eldor74d9acc2019-03-21 14:00:03 +0200743 size_t len;
744 mbedtls_asn1_buf *buf;
745 mbedtls_asn1_sequence *cur = certificate_policies;
746
747 /* Get main sequence tag */
Gilles Peskine449bd832023-01-11 14:50:10 +0100748 ret = mbedtls_asn1_get_tag(p, end, &len,
749 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE);
750 if (ret != 0) {
751 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
752 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200753
Gilles Peskine449bd832023-01-11 14:50:10 +0100754 if (*p + len != end) {
755 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
756 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
757 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200758
759 /*
760 * Cannot be an empty sequence.
761 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100762 if (len == 0) {
763 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
764 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
765 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200766
Gilles Peskine449bd832023-01-11 14:50:10 +0100767 while (*p < end) {
Ron Eldor74d9acc2019-03-21 14:00:03 +0200768 mbedtls_x509_buf policy_oid;
769 const unsigned char *policy_end;
770
771 /*
772 * Get the policy sequence
773 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100774 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
775 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
776 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
777 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200778
779 policy_end = *p + len;
780
Gilles Peskine449bd832023-01-11 14:50:10 +0100781 if ((ret = mbedtls_asn1_get_tag(p, policy_end, &len,
782 MBEDTLS_ASN1_OID)) != 0) {
783 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
784 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200785
786 policy_oid.tag = MBEDTLS_ASN1_OID;
787 policy_oid.len = len;
788 policy_oid.p = *p;
789
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300790 /*
791 * Only AnyPolicy is currently supported when enforcing policy.
792 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100793 if (MBEDTLS_OID_CMP(MBEDTLS_OID_ANY_POLICY, &policy_oid) != 0) {
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300794 /*
795 * Set the parsing return code but continue parsing, in case this
TRodziewicz3ecb92e2021-05-11 18:22:05 +0200796 * extension is critical.
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300797 */
798 parse_ret = MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE;
799 }
800
Ron Eldor74d9acc2019-03-21 14:00:03 +0200801 /* Allocate and assign next pointer */
Gilles Peskine449bd832023-01-11 14:50:10 +0100802 if (cur->buf.p != NULL) {
803 if (cur->next != NULL) {
804 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
805 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200806
Gilles Peskine449bd832023-01-11 14:50:10 +0100807 cur->next = mbedtls_calloc(1, sizeof(mbedtls_asn1_sequence));
Ron Eldor74d9acc2019-03-21 14:00:03 +0200808
Gilles Peskine449bd832023-01-11 14:50:10 +0100809 if (cur->next == NULL) {
810 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
811 MBEDTLS_ERR_ASN1_ALLOC_FAILED);
812 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200813
814 cur = cur->next;
815 }
816
Gilles Peskine449bd832023-01-11 14:50:10 +0100817 buf = &(cur->buf);
Ron Eldor74d9acc2019-03-21 14:00:03 +0200818 buf->tag = policy_oid.tag;
819 buf->p = policy_oid.p;
820 buf->len = policy_oid.len;
Ron Eldor08063792019-05-13 16:38:39 +0300821
822 *p += len;
823
Gilles Peskine449bd832023-01-11 14:50:10 +0100824 /*
825 * If there is an optional qualifier, then *p < policy_end
826 * Check the Qualifier len to verify it doesn't exceed policy_end.
827 */
828 if (*p < policy_end) {
829 if ((ret = mbedtls_asn1_get_tag(p, policy_end, &len,
830 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) !=
831 0) {
832 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
833 }
Ron Eldor08063792019-05-13 16:38:39 +0300834 /*
835 * Skip the optional policy qualifiers.
836 */
837 *p += len;
838 }
839
Gilles Peskine449bd832023-01-11 14:50:10 +0100840 if (*p != policy_end) {
841 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
842 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
843 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200844 }
845
846 /* Set final sequence entry's next pointer to NULL */
847 cur->next = NULL;
848
Gilles Peskine449bd832023-01-11 14:50:10 +0100849 if (*p != end) {
850 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
851 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
852 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200853
Gilles Peskine449bd832023-01-11 14:50:10 +0100854 return parse_ret;
Ron Eldor74d9acc2019-03-21 14:00:03 +0200855}
856
857/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200858 * X.509 v3 extensions
859 *
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200860 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100861static int x509_get_crt_ext(unsigned char **p,
862 const unsigned char *end,
863 mbedtls_x509_crt *crt,
864 mbedtls_x509_crt_ext_cb_t cb,
865 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200866{
Janos Follath865b3eb2019-12-16 11:46:15 +0000867 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200868 size_t len;
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +0200869 unsigned char *end_ext_data, *start_ext_octet, *end_ext_octet;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200870
Gilles Peskine449bd832023-01-11 14:50:10 +0100871 if (*p == end) {
872 return 0;
873 }
Hanno Becker12f62fb2019-02-12 17:22:36 +0000874
Gilles Peskine449bd832023-01-11 14:50:10 +0100875 if ((ret = mbedtls_x509_get_ext(p, end, &crt->v3_ext, 3)) != 0) {
876 return ret;
877 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200878
Hanno Becker12f62fb2019-02-12 17:22:36 +0000879 end = crt->v3_ext.p + crt->v3_ext.len;
Gilles Peskine449bd832023-01-11 14:50:10 +0100880 while (*p < end) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200881 /*
882 * Extension ::= SEQUENCE {
883 * extnID OBJECT IDENTIFIER,
884 * critical BOOLEAN DEFAULT FALSE,
885 * extnValue OCTET STRING }
886 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100887 mbedtls_x509_buf extn_oid = { 0, 0, NULL };
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200888 int is_critical = 0; /* DEFAULT FALSE */
889 int ext_type = 0;
890
Gilles Peskine449bd832023-01-11 14:50:10 +0100891 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
892 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
893 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
894 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200895
896 end_ext_data = *p + len;
897
898 /* Get extension ID */
Gilles Peskine449bd832023-01-11 14:50:10 +0100899 if ((ret = mbedtls_asn1_get_tag(p, end_ext_data, &extn_oid.len,
900 MBEDTLS_ASN1_OID)) != 0) {
901 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
902 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200903
k-stachowiak463928a2018-07-24 12:50:59 +0200904 extn_oid.tag = MBEDTLS_ASN1_OID;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200905 extn_oid.p = *p;
906 *p += extn_oid.len;
907
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200908 /* Get optional critical */
Gilles Peskine449bd832023-01-11 14:50:10 +0100909 if ((ret = mbedtls_asn1_get_bool(p, end_ext_data, &is_critical)) != 0 &&
910 (ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG)) {
911 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
912 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200913
914 /* Data should be octet string type */
Gilles Peskine449bd832023-01-11 14:50:10 +0100915 if ((ret = mbedtls_asn1_get_tag(p, end_ext_data, &len,
916 MBEDTLS_ASN1_OCTET_STRING)) != 0) {
917 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
918 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200919
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +0200920 start_ext_octet = *p;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200921 end_ext_octet = *p + len;
922
Gilles Peskine449bd832023-01-11 14:50:10 +0100923 if (end_ext_octet != end_ext_data) {
924 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
925 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
926 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200927
928 /*
929 * Detect supported extensions
930 */
Gilles Peskine532e3ee2025-05-07 20:37:15 +0200931 ret = mbedtls_x509_oid_get_x509_ext_type(&extn_oid, &ext_type);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200932
Gilles Peskine449bd832023-01-11 14:50:10 +0100933 if (ret != 0) {
Nicola Di Lieto502d4b42020-04-25 14:41:25 +0200934 /* Give the callback (if any) a chance to handle the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +0100935 if (cb != NULL) {
936 ret = cb(p_ctx, crt, &extn_oid, is_critical, *p, end_ext_octet);
937 if (ret != 0 && is_critical) {
938 return ret;
939 }
Nicola Di Lietofae25a12020-05-28 08:55:08 +0200940 *p = end_ext_octet;
Nicola Di Lieto502d4b42020-04-25 14:41:25 +0200941 continue;
Nicola Di Lietofae25a12020-05-28 08:55:08 +0200942 }
Nicola Di Lieto502d4b42020-04-25 14:41:25 +0200943
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200944 /* No parser found, skip extension */
945 *p = end_ext_octet;
946
Gilles Peskine449bd832023-01-11 14:50:10 +0100947 if (is_critical) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200948 /* Data is marked as critical: fail */
Gilles Peskine449bd832023-01-11 14:50:10 +0100949 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
950 MBEDTLS_ERR_ASN1_UNEXPECTED_TAG);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200951 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200952 continue;
953 }
954
Manuel Pégourié-Gonnard8a5e3d42014-11-12 17:47:28 +0100955 /* Forbid repeated extensions */
Gilles Peskine449bd832023-01-11 14:50:10 +0100956 if ((crt->ext_types & ext_type) != 0) {
957 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
958 }
Manuel Pégourié-Gonnard8a5e3d42014-11-12 17:47:28 +0100959
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200960 crt->ext_types |= ext_type;
961
Gilles Peskine449bd832023-01-11 14:50:10 +0100962 switch (ext_type) {
963 case MBEDTLS_X509_EXT_BASIC_CONSTRAINTS:
964 /* Parse basic constraints */
965 if ((ret = x509_get_basic_constraints(p, end_ext_octet,
966 &crt->ca_istrue, &crt->max_pathlen)) != 0) {
967 return ret;
968 }
969 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200970
Gilles Peskine449bd832023-01-11 14:50:10 +0100971 case MBEDTLS_X509_EXT_KEY_USAGE:
972 /* Parse key usage */
Przemek Stekiel21c37282023-01-16 08:47:49 +0100973 if ((ret = mbedtls_x509_get_key_usage(p, end_ext_octet,
974 &crt->key_usage)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +0100975 return ret;
976 }
977 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200978
Gilles Peskine449bd832023-01-11 14:50:10 +0100979 case MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE:
980 /* Parse extended key usage */
981 if ((ret = x509_get_ext_key_usage(p, end_ext_octet,
982 &crt->ext_key_usage)) != 0) {
983 return ret;
984 }
985 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200986
toth92ga41954d2021-02-12 16:11:17 +0100987 case MBEDTLS_X509_EXT_SUBJECT_KEY_IDENTIFIER:
988 /* Parse subject key identifier */
989 if ((ret = x509_get_subject_key_id(p, end_ext_data,
990 &crt->subject_key_id)) != 0) {
991 return ret;
992 }
993 break;
toth92g8d435a02021-05-10 15:16:33 +0200994
toth92ga41954d2021-02-12 16:11:17 +0100995 case MBEDTLS_X509_EXT_AUTHORITY_KEY_IDENTIFIER:
996 /* Parse authority key identifier */
997 if ((ret = x509_get_authority_key_id(p, end_ext_octet,
998 &crt->authority_key_id)) != 0) {
999 return ret;
1000 }
1001 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01001002 case MBEDTLS_X509_EXT_SUBJECT_ALT_NAME:
toth92g8d435a02021-05-10 15:16:33 +02001003 /* Parse subject alt name
1004 * SubjectAltName ::= GeneralNames
1005 */
Przemek Stekiel21c37282023-01-16 08:47:49 +01001006 if ((ret = mbedtls_x509_get_subject_alt_name(p, end_ext_octet,
1007 &crt->subject_alt_names)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001008 return ret;
1009 }
1010 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001011
Gilles Peskine449bd832023-01-11 14:50:10 +01001012 case MBEDTLS_X509_EXT_NS_CERT_TYPE:
1013 /* Parse netscape certificate type */
Przemek Stekiel21c37282023-01-16 08:47:49 +01001014 if ((ret = mbedtls_x509_get_ns_cert_type(p, end_ext_octet,
1015 &crt->ns_cert_type)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001016 return ret;
1017 }
1018 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001019
Gilles Peskine32a11122025-04-09 21:51:46 +02001020 case MBEDTLS_X509_EXT_CERTIFICATE_POLICIES:
Gilles Peskine449bd832023-01-11 14:50:10 +01001021 /* Parse certificate policies type */
1022 if ((ret = x509_get_certificate_policies(p, end_ext_octet,
1023 &crt->certificate_policies)) != 0) {
1024 /* Give the callback (if any) a chance to handle the extension
1025 * if it contains unsupported policies */
1026 if (ret == MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE && cb != NULL &&
1027 cb(p_ctx, crt, &extn_oid, is_critical,
1028 start_ext_octet, end_ext_octet) == 0) {
1029 break;
1030 }
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +02001031
Gilles Peskine449bd832023-01-11 14:50:10 +01001032 if (is_critical) {
1033 return ret;
1034 } else
1035 /*
1036 * If MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE is returned, then we
1037 * cannot interpret or enforce the policy. However, it is up to
1038 * the user to choose how to enforce the policies,
1039 * unless the extension is critical.
1040 */
1041 if (ret != MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE) {
1042 return ret;
1043 }
1044 }
1045 break;
1046
1047 default:
Ron Eldor8b0c3c92019-05-15 12:20:00 +03001048 /*
Gilles Peskine449bd832023-01-11 14:50:10 +01001049 * If this is a non-critical extension, which the oid layer
1050 * supports, but there isn't an x509 parser for it,
1051 * skip the extension.
Ron Eldor8b0c3c92019-05-15 12:20:00 +03001052 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001053 if (is_critical) {
1054 return MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE;
1055 } else {
1056 *p = end_ext_octet;
1057 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001058 }
1059 }
1060
Gilles Peskine449bd832023-01-11 14:50:10 +01001061 if (*p != end) {
1062 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
1063 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
1064 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001065
Gilles Peskine449bd832023-01-11 14:50:10 +01001066 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001067}
1068
1069/*
1070 * Parse and fill a single X.509 certificate in DER format
1071 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001072static int x509_crt_parse_der_core(mbedtls_x509_crt *crt,
1073 const unsigned char *buf,
1074 size_t buflen,
1075 int make_copy,
1076 mbedtls_x509_crt_ext_cb_t cb,
1077 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001078{
Janos Follath865b3eb2019-12-16 11:46:15 +00001079 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001080 size_t len;
1081 unsigned char *p, *end, *crt_end;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001082 mbedtls_x509_buf sig_params1, sig_params2, sig_oid2;
Manuel Pégourié-Gonnard59a75d52014-01-22 10:12:57 +01001083
Gilles Peskine449bd832023-01-11 14:50:10 +01001084 memset(&sig_params1, 0, sizeof(mbedtls_x509_buf));
1085 memset(&sig_params2, 0, sizeof(mbedtls_x509_buf));
1086 memset(&sig_oid2, 0, sizeof(mbedtls_x509_buf));
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001087
1088 /*
1089 * Check for valid input
1090 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001091 if (crt == NULL || buf == NULL) {
1092 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1093 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001094
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001095 /* Use the original buffer until we figure out actual length. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001096 p = (unsigned char *) buf;
Janos Follathcc0e49d2016-02-17 14:34:12 +00001097 len = buflen;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001098 end = p + len;
1099
1100 /*
1101 * Certificate ::= SEQUENCE {
1102 * tbsCertificate TBSCertificate,
1103 * signatureAlgorithm AlgorithmIdentifier,
1104 * signatureValue BIT STRING }
1105 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001106 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1107 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1108 mbedtls_x509_crt_free(crt);
1109 return MBEDTLS_ERR_X509_INVALID_FORMAT;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001110 }
1111
Janos Follathcc0e49d2016-02-17 14:34:12 +00001112 end = crt_end = p + len;
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001113 crt->raw.len = (size_t) (crt_end - buf);
Gilles Peskine449bd832023-01-11 14:50:10 +01001114 if (make_copy != 0) {
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001115 /* Create and populate a new buffer for the raw field. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001116 crt->raw.p = p = mbedtls_calloc(1, crt->raw.len);
1117 if (crt->raw.p == NULL) {
1118 return MBEDTLS_ERR_X509_ALLOC_FAILED;
1119 }
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001120
Gilles Peskine449bd832023-01-11 14:50:10 +01001121 memcpy(crt->raw.p, buf, crt->raw.len);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001122 crt->own_buffer = 1;
1123
1124 p += crt->raw.len - len;
1125 end = crt_end = p + len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001126 } else {
1127 crt->raw.p = (unsigned char *) buf;
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001128 crt->own_buffer = 0;
1129 }
Janos Follathcc0e49d2016-02-17 14:34:12 +00001130
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001131 /*
1132 * TBSCertificate ::= SEQUENCE {
1133 */
1134 crt->tbs.p = p;
1135
Gilles Peskine449bd832023-01-11 14:50:10 +01001136 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1137 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1138 mbedtls_x509_crt_free(crt);
1139 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001140 }
1141
1142 end = p + len;
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001143 crt->tbs.len = (size_t) (end - crt->tbs.p);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001144
1145 /*
1146 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
1147 *
1148 * CertificateSerialNumber ::= INTEGER
1149 *
1150 * signature AlgorithmIdentifier
1151 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001152 if ((ret = x509_get_version(&p, end, &crt->version)) != 0 ||
1153 (ret = mbedtls_x509_get_serial(&p, end, &crt->serial)) != 0 ||
1154 (ret = mbedtls_x509_get_alg(&p, end, &crt->sig_oid,
1155 &sig_params1)) != 0) {
1156 mbedtls_x509_crt_free(crt);
1157 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001158 }
1159
Gilles Peskine449bd832023-01-11 14:50:10 +01001160 if (crt->version < 0 || crt->version > 2) {
1161 mbedtls_x509_crt_free(crt);
1162 return MBEDTLS_ERR_X509_UNKNOWN_VERSION;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001163 }
1164
Andres AG7ca4a032017-03-09 16:16:11 +00001165 crt->version++;
1166
Gilles Peskine449bd832023-01-11 14:50:10 +01001167 if ((ret = mbedtls_x509_get_sig_alg(&crt->sig_oid, &sig_params1,
Valerio Setti68878cc2025-04-10 23:30:26 +02001168 &crt->sig_md, &crt->sig_pk)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001169 mbedtls_x509_crt_free(crt);
1170 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001171 }
1172
1173 /*
1174 * issuer Name
1175 */
1176 crt->issuer_raw.p = p;
1177
Gilles Peskine449bd832023-01-11 14:50:10 +01001178 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1179 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1180 mbedtls_x509_crt_free(crt);
1181 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001182 }
1183
Gilles Peskine449bd832023-01-11 14:50:10 +01001184 if ((ret = mbedtls_x509_get_name(&p, p + len, &crt->issuer)) != 0) {
1185 mbedtls_x509_crt_free(crt);
1186 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001187 }
1188
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001189 crt->issuer_raw.len = (size_t) (p - crt->issuer_raw.p);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001190
1191 /*
1192 * Validity ::= SEQUENCE {
1193 * notBefore Time,
1194 * notAfter Time }
1195 *
1196 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001197 if ((ret = x509_get_dates(&p, end, &crt->valid_from,
1198 &crt->valid_to)) != 0) {
1199 mbedtls_x509_crt_free(crt);
1200 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001201 }
1202
1203 /*
1204 * subject Name
1205 */
1206 crt->subject_raw.p = p;
1207
Gilles Peskine449bd832023-01-11 14:50:10 +01001208 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1209 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1210 mbedtls_x509_crt_free(crt);
1211 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001212 }
1213
Gilles Peskine449bd832023-01-11 14:50:10 +01001214 if (len && (ret = mbedtls_x509_get_name(&p, p + len, &crt->subject)) != 0) {
1215 mbedtls_x509_crt_free(crt);
1216 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001217 }
1218
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001219 crt->subject_raw.len = (size_t) (p - crt->subject_raw.p);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001220
1221 /*
1222 * SubjectPublicKeyInfo
1223 */
Hanno Becker494dd7a2019-02-06 16:13:41 +00001224 crt->pk_raw.p = p;
Gilles Peskine449bd832023-01-11 14:50:10 +01001225 if ((ret = mbedtls_pk_parse_subpubkey(&p, end, &crt->pk)) != 0) {
1226 mbedtls_x509_crt_free(crt);
1227 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001228 }
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001229 crt->pk_raw.len = (size_t) (p - crt->pk_raw.p);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001230
1231 /*
1232 * issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONAL,
1233 * -- If present, version shall be v2 or v3
1234 * subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONAL,
1235 * -- If present, version shall be v2 or v3
1236 * extensions [3] EXPLICIT Extensions OPTIONAL
1237 * -- If present, version shall be v3
1238 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001239 if (crt->version == 2 || crt->version == 3) {
1240 ret = x509_get_uid(&p, end, &crt->issuer_id, 1);
1241 if (ret != 0) {
1242 mbedtls_x509_crt_free(crt);
1243 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001244 }
1245 }
1246
Gilles Peskine449bd832023-01-11 14:50:10 +01001247 if (crt->version == 2 || crt->version == 3) {
1248 ret = x509_get_uid(&p, end, &crt->subject_id, 2);
1249 if (ret != 0) {
1250 mbedtls_x509_crt_free(crt);
1251 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001252 }
1253 }
1254
Gilles Peskine449bd832023-01-11 14:50:10 +01001255 if (crt->version == 3) {
1256 ret = x509_get_crt_ext(&p, end, crt, cb, p_ctx);
1257 if (ret != 0) {
1258 mbedtls_x509_crt_free(crt);
1259 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001260 }
1261 }
1262
Gilles Peskine449bd832023-01-11 14:50:10 +01001263 if (p != end) {
1264 mbedtls_x509_crt_free(crt);
1265 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT,
1266 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001267 }
1268
1269 end = crt_end;
1270
1271 /*
1272 * }
1273 * -- end of TBSCertificate
1274 *
1275 * signatureAlgorithm AlgorithmIdentifier,
1276 * signatureValue BIT STRING
1277 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001278 if ((ret = mbedtls_x509_get_alg(&p, end, &sig_oid2, &sig_params2)) != 0) {
1279 mbedtls_x509_crt_free(crt);
1280 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001281 }
1282
Gilles Peskine449bd832023-01-11 14:50:10 +01001283 if (crt->sig_oid.len != sig_oid2.len ||
1284 memcmp(crt->sig_oid.p, sig_oid2.p, crt->sig_oid.len) != 0 ||
Paul Elliottca17ebf2020-11-24 17:30:18 +00001285 sig_params1.tag != sig_params2.tag ||
Manuel Pégourié-Gonnarddddbb1d2014-06-05 17:02:24 +02001286 sig_params1.len != sig_params2.len ||
Gilles Peskine449bd832023-01-11 14:50:10 +01001287 (sig_params1.len != 0 &&
1288 memcmp(sig_params1.p, sig_params2.p, sig_params1.len) != 0)) {
1289 mbedtls_x509_crt_free(crt);
1290 return MBEDTLS_ERR_X509_SIG_MISMATCH;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001291 }
1292
Gilles Peskine449bd832023-01-11 14:50:10 +01001293 if ((ret = mbedtls_x509_get_sig(&p, end, &crt->sig)) != 0) {
1294 mbedtls_x509_crt_free(crt);
1295 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001296 }
1297
Gilles Peskine449bd832023-01-11 14:50:10 +01001298 if (p != end) {
1299 mbedtls_x509_crt_free(crt);
1300 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT,
1301 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001302 }
1303
Gilles Peskine449bd832023-01-11 14:50:10 +01001304 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001305}
1306
1307/*
1308 * Parse one X.509 certificate in DER format from a buffer and add them to a
1309 * chained list
1310 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001311static int mbedtls_x509_crt_parse_der_internal(mbedtls_x509_crt *chain,
1312 const unsigned char *buf,
1313 size_t buflen,
1314 int make_copy,
1315 mbedtls_x509_crt_ext_cb_t cb,
1316 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001317{
Janos Follath865b3eb2019-12-16 11:46:15 +00001318 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001319 mbedtls_x509_crt *crt = chain, *prev = NULL;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001320
1321 /*
1322 * Check for valid input
1323 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001324 if (crt == NULL || buf == NULL) {
1325 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1326 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001327
Gilles Peskine449bd832023-01-11 14:50:10 +01001328 while (crt->version != 0 && crt->next != NULL) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001329 prev = crt;
1330 crt = crt->next;
1331 }
1332
1333 /*
1334 * Add new certificate on the end of the chain if needed.
1335 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001336 if (crt->version != 0 && crt->next == NULL) {
1337 crt->next = mbedtls_calloc(1, sizeof(mbedtls_x509_crt));
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001338
Gilles Peskine449bd832023-01-11 14:50:10 +01001339 if (crt->next == NULL) {
1340 return MBEDTLS_ERR_X509_ALLOC_FAILED;
1341 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001342
1343 prev = crt;
Gilles Peskine449bd832023-01-11 14:50:10 +01001344 mbedtls_x509_crt_init(crt->next);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001345 crt = crt->next;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001346 }
1347
Gilles Peskine449bd832023-01-11 14:50:10 +01001348 ret = x509_crt_parse_der_core(crt, buf, buflen, make_copy, cb, p_ctx);
1349 if (ret != 0) {
1350 if (prev) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001351 prev->next = NULL;
Gilles Peskine449bd832023-01-11 14:50:10 +01001352 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001353
Gilles Peskine449bd832023-01-11 14:50:10 +01001354 if (crt != chain) {
1355 mbedtls_free(crt);
1356 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001357
Gilles Peskine449bd832023-01-11 14:50:10 +01001358 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001359 }
1360
Gilles Peskine449bd832023-01-11 14:50:10 +01001361 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001362}
1363
Gilles Peskine449bd832023-01-11 14:50:10 +01001364int mbedtls_x509_crt_parse_der_nocopy(mbedtls_x509_crt *chain,
1365 const unsigned char *buf,
1366 size_t buflen)
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001367{
Gilles Peskine449bd832023-01-11 14:50:10 +01001368 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, 0, NULL, NULL);
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001369}
1370
Gilles Peskine449bd832023-01-11 14:50:10 +01001371int mbedtls_x509_crt_parse_der_with_ext_cb(mbedtls_x509_crt *chain,
1372 const unsigned char *buf,
1373 size_t buflen,
1374 int make_copy,
1375 mbedtls_x509_crt_ext_cb_t cb,
1376 void *p_ctx)
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001377{
Gilles Peskine449bd832023-01-11 14:50:10 +01001378 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, make_copy, cb, p_ctx);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001379}
1380
Gilles Peskine449bd832023-01-11 14:50:10 +01001381int mbedtls_x509_crt_parse_der(mbedtls_x509_crt *chain,
1382 const unsigned char *buf,
1383 size_t buflen)
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001384{
Gilles Peskine449bd832023-01-11 14:50:10 +01001385 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, 1, NULL, NULL);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001386}
1387
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001388/*
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02001389 * Parse one or more PEM certificates from a buffer and add them to the chained
1390 * list
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001391 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001392int mbedtls_x509_crt_parse(mbedtls_x509_crt *chain,
1393 const unsigned char *buf,
1394 size_t buflen)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001395{
Janos Follath98e28a72016-05-31 14:03:54 +01001396#if defined(MBEDTLS_PEM_PARSE_C)
Andres AGc0db5112016-12-07 15:05:53 +00001397 int success = 0, first_error = 0, total_failed = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001398 int buf_format = MBEDTLS_X509_FORMAT_DER;
Janos Follath98e28a72016-05-31 14:03:54 +01001399#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001400
1401 /*
1402 * Check for valid input
1403 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001404 if (chain == NULL || buf == NULL) {
1405 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1406 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001407
1408 /*
1409 * Determine buffer content. Buffer contains either one DER certificate or
1410 * one or more PEM certificates.
1411 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001412#if defined(MBEDTLS_PEM_PARSE_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001413 if (buflen != 0 && buf[buflen - 1] == '\0' &&
1414 strstr((const char *) buf, "-----BEGIN CERTIFICATE-----") != NULL) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001415 buf_format = MBEDTLS_X509_FORMAT_PEM;
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001416 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001417
Gilles Peskine449bd832023-01-11 14:50:10 +01001418 if (buf_format == MBEDTLS_X509_FORMAT_DER) {
1419 return mbedtls_x509_crt_parse_der(chain, buf, buflen);
1420 }
Janos Follath98e28a72016-05-31 14:03:54 +01001421#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001422 return mbedtls_x509_crt_parse_der(chain, buf, buflen);
Janos Follath98e28a72016-05-31 14:03:54 +01001423#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001424
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001425#if defined(MBEDTLS_PEM_PARSE_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001426 if (buf_format == MBEDTLS_X509_FORMAT_PEM) {
Janos Follath865b3eb2019-12-16 11:46:15 +00001427 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001428 mbedtls_pem_context pem;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001429
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001430 /* 1 rather than 0 since the terminating NULL byte is counted in */
Gilles Peskine449bd832023-01-11 14:50:10 +01001431 while (buflen > 1) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001432 size_t use_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001433 mbedtls_pem_init(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001434
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001435 /* If we get there, we know the string is null-terminated */
Gilles Peskine449bd832023-01-11 14:50:10 +01001436 ret = mbedtls_pem_read_buffer(&pem,
1437 "-----BEGIN CERTIFICATE-----",
1438 "-----END CERTIFICATE-----",
1439 buf, NULL, 0, &use_len);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001440
Gilles Peskine449bd832023-01-11 14:50:10 +01001441 if (ret == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001442 /*
1443 * Was PEM encoded
1444 */
1445 buflen -= use_len;
1446 buf += use_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001447 } else if (ret == MBEDTLS_ERR_PEM_BAD_INPUT_DATA) {
1448 return ret;
1449 } else if (ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT) {
1450 mbedtls_pem_free(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001451
1452 /*
1453 * PEM header and footer were found
1454 */
1455 buflen -= use_len;
1456 buf += use_len;
1457
Gilles Peskine449bd832023-01-11 14:50:10 +01001458 if (first_error == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001459 first_error = ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001460 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001461
Paul Bakker5a5fa922014-09-26 14:53:04 +02001462 total_failed++;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001463 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001464 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001465 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01001466 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001467
Gilles Peskine449bd832023-01-11 14:50:10 +01001468 ret = mbedtls_x509_crt_parse_der(chain, pem.buf, pem.buflen);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001469
Gilles Peskine449bd832023-01-11 14:50:10 +01001470 mbedtls_pem_free(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001471
Gilles Peskine449bd832023-01-11 14:50:10 +01001472 if (ret != 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001473 /*
1474 * Quit parsing on a memory error
1475 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001476 if (ret == MBEDTLS_ERR_X509_ALLOC_FAILED) {
1477 return ret;
1478 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001479
Gilles Peskine449bd832023-01-11 14:50:10 +01001480 if (first_error == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001481 first_error = ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001482 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001483
1484 total_failed++;
1485 continue;
1486 }
1487
1488 success = 1;
1489 }
1490 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001491
Gilles Peskine449bd832023-01-11 14:50:10 +01001492 if (success) {
1493 return total_failed;
1494 } else if (first_error) {
1495 return first_error;
1496 } else {
1497 return MBEDTLS_ERR_X509_CERT_UNKNOWN_FORMAT;
1498 }
Janos Follath98e28a72016-05-31 14:03:54 +01001499#endif /* MBEDTLS_PEM_PARSE_C */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001500}
1501
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001502#if defined(MBEDTLS_FS_IO)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001503/*
1504 * Load one or more certificates and add them to the chained list
1505 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001506int mbedtls_x509_crt_parse_file(mbedtls_x509_crt *chain, const char *path)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001507{
Janos Follath865b3eb2019-12-16 11:46:15 +00001508 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001509 size_t n;
1510 unsigned char *buf;
1511
Gilles Peskine449bd832023-01-11 14:50:10 +01001512 if ((ret = mbedtls_pk_load_file(path, &buf, &n)) != 0) {
1513 return ret;
1514 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001515
Gilles Peskine449bd832023-01-11 14:50:10 +01001516 ret = mbedtls_x509_crt_parse(chain, buf, n);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001517
Tom Cosgroveca8c61b2023-07-17 15:17:40 +01001518 mbedtls_zeroize_and_free(buf, n);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001519
Gilles Peskine449bd832023-01-11 14:50:10 +01001520 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001521}
1522
Gilles Peskine449bd832023-01-11 14:50:10 +01001523int mbedtls_x509_crt_parse_path(mbedtls_x509_crt *chain, const char *path)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001524{
1525 int ret = 0;
Paul Bakkerfa6a6202013-10-28 18:48:30 +01001526#if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001527 int w_ret;
1528 WCHAR szDir[MAX_PATH];
1529 char filename[MAX_PATH];
Paul Bakker9af723c2014-05-01 13:03:14 +02001530 char *p;
Gilles Peskine449bd832023-01-11 14:50:10 +01001531 size_t len = strlen(path);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001532
Paul Bakker9af723c2014-05-01 13:03:14 +02001533 WIN32_FIND_DATAW file_data;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001534 HANDLE hFind;
1535
Gilles Peskine449bd832023-01-11 14:50:10 +01001536 if (len > MAX_PATH - 3) {
1537 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1538 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001539
Gilles Peskine449bd832023-01-11 14:50:10 +01001540 memset(szDir, 0, sizeof(szDir));
1541 memset(filename, 0, MAX_PATH);
1542 memcpy(filename, path, len);
Paul Bakker9af723c2014-05-01 13:03:14 +02001543 filename[len++] = '\\';
1544 p = filename + len;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001545 filename[len++] = '*';
1546
Simon Butcher35e5dad2018-03-15 15:00:03 +00001547 /*
Minos Galanakis08a67cc2023-09-22 16:00:06 +01001548 * Note this function uses the code page CP_ACP which is the system default
1549 * ANSI codepage. The input string is always described in BYTES and the
1550 * output length is described in WCHARs.
Simon Butcher35e5dad2018-03-15 15:00:03 +00001551 */
Minos Galanakisa9bb34c2023-09-25 14:41:12 +01001552 w_ret = MultiByteToWideChar(CP_ACP, 0, filename, (int) len, szDir,
Gilles Peskine449bd832023-01-11 14:50:10 +01001553 MAX_PATH - 3);
1554 if (w_ret == 0) {
1555 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1556 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001557
Gilles Peskine449bd832023-01-11 14:50:10 +01001558 hFind = FindFirstFileW(szDir, &file_data);
1559 if (hFind == INVALID_HANDLE_VALUE) {
1560 return MBEDTLS_ERR_X509_FILE_IO_ERROR;
1561 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001562
1563 len = MAX_PATH - len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001564 do {
1565 memset(p, 0, len);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001566
Gilles Peskine449bd832023-01-11 14:50:10 +01001567 if (file_data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001568 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001569 }
Simon Butcherde573f52018-07-05 09:11:30 +01001570 w_ret = WideCharToMultiByte(CP_ACP, 0, file_data.cFileName,
Minos Galanakis59108d32023-09-25 14:11:22 +01001571 -1, p, (int) len, NULL, NULL);
Minos Galanakisa277b212023-08-09 16:32:22 +01001572 if (w_ret == 0) {
Ron Eldor36d90422017-01-09 15:09:16 +02001573 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1574 goto cleanup;
1575 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001576
Gilles Peskine449bd832023-01-11 14:50:10 +01001577 w_ret = mbedtls_x509_crt_parse_file(chain, filename);
1578 if (w_ret < 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001579 ret++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001580 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001581 ret += w_ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001582 }
1583 } while (FindNextFileW(hFind, &file_data) != 0);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001584
Gilles Peskine449bd832023-01-11 14:50:10 +01001585 if (GetLastError() != ERROR_NO_MORE_FILES) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001586 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
Gilles Peskine449bd832023-01-11 14:50:10 +01001587 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001588
Ron Eldor36d90422017-01-09 15:09:16 +02001589cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01001590 FindClose(hFind);
Paul Bakkerbe089b02013-10-14 15:51:50 +02001591#else /* _WIN32 */
Manuel Pégourié-Gonnard964bf9b2013-11-26 16:47:11 +01001592 int t_ret;
Andres AGf9113192016-09-02 14:06:04 +01001593 int snp_ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001594 struct stat sb;
Manuel Pégourié-Gonnard964bf9b2013-11-26 16:47:11 +01001595 struct dirent *entry;
Andres AGf9113192016-09-02 14:06:04 +01001596 char entry_name[MBEDTLS_X509_MAX_FILE_PATH_LEN];
Gilles Peskine449bd832023-01-11 14:50:10 +01001597 DIR *dir = opendir(path);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001598
Gilles Peskine449bd832023-01-11 14:50:10 +01001599 if (dir == NULL) {
1600 return MBEDTLS_ERR_X509_FILE_IO_ERROR;
1601 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001602
Ron Eldor63140682017-01-09 19:27:59 +02001603#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001604 if ((ret = mbedtls_mutex_lock(&mbedtls_threading_readdir_mutex)) != 0) {
1605 closedir(dir);
1606 return ret;
Manuel Pégourié-Gonnardf9b85d92015-06-22 18:39:57 +02001607 }
Ron Eldor63140682017-01-09 19:27:59 +02001608#endif /* MBEDTLS_THREADING_C */
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001609
Gilles Peskine449bd832023-01-11 14:50:10 +01001610 memset(&sb, 0, sizeof(sb));
Paul Elliottfb91a482021-03-05 14:17:51 +00001611
Gilles Peskine449bd832023-01-11 14:50:10 +01001612 while ((entry = readdir(dir)) != NULL) {
Dave Rodgman6dd757a2023-02-02 12:40:50 +00001613 snp_ret = mbedtls_snprintf(entry_name, sizeof(entry_name),
Gilles Peskine449bd832023-01-11 14:50:10 +01001614 "%s/%s", path, entry->d_name);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001615
Dave Rodgman6dd757a2023-02-02 12:40:50 +00001616 if (snp_ret < 0 || (size_t) snp_ret >= sizeof(entry_name)) {
Andres AGf9113192016-09-02 14:06:04 +01001617 ret = MBEDTLS_ERR_X509_BUFFER_TOO_SMALL;
1618 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01001619 } else if (stat(entry_name, &sb) == -1) {
1620 if (errno == ENOENT) {
Dave Rodgmanfa40b022022-07-20 16:08:00 +01001621 /* Broken symbolic link - ignore this entry.
1622 stat(2) will return this error for either (a) a dangling
1623 symlink or (b) a missing file.
1624 Given that we have just obtained the filename from readdir,
1625 assume that it does exist and therefore treat this as a
1626 dangling symlink. */
1627 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001628 } else {
Dave Rodgmanfa40b022022-07-20 16:08:00 +01001629 /* Some other file error; report the error. */
Eduardo Silvae1bfffc2019-04-25 10:43:26 -06001630 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1631 goto cleanup;
1632 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001633 }
1634
Gilles Peskine449bd832023-01-11 14:50:10 +01001635 if (!S_ISREG(sb.st_mode)) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001636 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001637 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001638
1639 // Ignore parse errors
1640 //
Gilles Peskine449bd832023-01-11 14:50:10 +01001641 t_ret = mbedtls_x509_crt_parse_file(chain, entry_name);
1642 if (t_ret < 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001643 ret++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001644 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001645 ret += t_ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001646 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001647 }
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001648
1649cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01001650 closedir(dir);
Andres AGf9113192016-09-02 14:06:04 +01001651
Ron Eldor63140682017-01-09 19:27:59 +02001652#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001653 if (mbedtls_mutex_unlock(&mbedtls_threading_readdir_mutex) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001654 ret = MBEDTLS_ERR_THREADING_MUTEX_ERROR;
Gilles Peskine449bd832023-01-11 14:50:10 +01001655 }
Ron Eldor63140682017-01-09 19:27:59 +02001656#endif /* MBEDTLS_THREADING_C */
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001657
Paul Bakkerbe089b02013-10-14 15:51:50 +02001658#endif /* _WIN32 */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001659
Gilles Peskine449bd832023-01-11 14:50:10 +01001660 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001661}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001662#endif /* MBEDTLS_FS_IO */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001663
Peter Kolbus9a969b62018-12-11 13:55:56 -06001664#if !defined(MBEDTLS_X509_REMOVE_INFO)
Przemek Stekielf4194942023-04-24 09:52:17 +02001665#define PRINT_ITEM(i) \
1666 do { \
1667 ret = mbedtls_snprintf(p, n, "%s" i, sep); \
1668 MBEDTLS_X509_SAFE_SNPRINTF; \
1669 sep = ", "; \
1670 } while (0)
toth92g8d435a02021-05-10 15:16:33 +02001671
Przemek Stekielf4194942023-04-24 09:52:17 +02001672#define CERT_TYPE(type, name) \
1673 do { \
Przemek Stekielf5b8f782023-04-26 08:55:26 +02001674 if (ns_cert_type & (type)) { \
1675 PRINT_ITEM(name); \
1676 } \
Przemek Stekielf4194942023-04-24 09:52:17 +02001677 } while (0)
toth92g8d435a02021-05-10 15:16:33 +02001678
Przemek Stekielf4194942023-04-24 09:52:17 +02001679#define KEY_USAGE(code, name) \
1680 do { \
Przemek Stekielf5b8f782023-04-26 08:55:26 +02001681 if (key_usage & (code)) { \
1682 PRINT_ITEM(name); \
1683 } \
Przemek Stekielf4194942023-04-24 09:52:17 +02001684 } while (0)
toth92g8d435a02021-05-10 15:16:33 +02001685
Gilles Peskine449bd832023-01-11 14:50:10 +01001686static int x509_info_ext_key_usage(char **buf, size_t *size,
1687 const mbedtls_x509_sequence *extended_key_usage)
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001688{
Janos Follath865b3eb2019-12-16 11:46:15 +00001689 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001690 const char *desc;
1691 size_t n = *size;
1692 char *p = *buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001693 const mbedtls_x509_sequence *cur = extended_key_usage;
Manuel Pégourié-Gonnard7b30cfc2014-04-01 18:00:07 +02001694 const char *sep = "";
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001695
Gilles Peskine449bd832023-01-11 14:50:10 +01001696 while (cur != NULL) {
Gilles Peskine532e3ee2025-05-07 20:37:15 +02001697 if (mbedtls_x509_oid_get_extended_key_usage(&cur->buf, &desc) != 0) {
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001698 desc = "???";
Gilles Peskine449bd832023-01-11 14:50:10 +01001699 }
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001700
Gilles Peskine449bd832023-01-11 14:50:10 +01001701 ret = mbedtls_snprintf(p, n, "%s%s", sep, desc);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001702 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001703
Manuel Pégourié-Gonnard7b30cfc2014-04-01 18:00:07 +02001704 sep = ", ";
1705
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001706 cur = cur->next;
1707 }
1708
1709 *size = n;
1710 *buf = p;
1711
Gilles Peskine449bd832023-01-11 14:50:10 +01001712 return 0;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001713}
1714
Gilles Peskine449bd832023-01-11 14:50:10 +01001715static int x509_info_cert_policies(char **buf, size_t *size,
1716 const mbedtls_x509_sequence *certificate_policies)
Ron Eldor74d9acc2019-03-21 14:00:03 +02001717{
Janos Follath865b3eb2019-12-16 11:46:15 +00001718 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Ron Eldor74d9acc2019-03-21 14:00:03 +02001719 const char *desc;
1720 size_t n = *size;
1721 char *p = *buf;
1722 const mbedtls_x509_sequence *cur = certificate_policies;
1723 const char *sep = "";
1724
Gilles Peskine449bd832023-01-11 14:50:10 +01001725 while (cur != NULL) {
Gilles Peskine532e3ee2025-05-07 20:37:15 +02001726 if (mbedtls_x509_oid_get_certificate_policies(&cur->buf, &desc) != 0) {
Ron Eldor74d9acc2019-03-21 14:00:03 +02001727 desc = "???";
Gilles Peskine449bd832023-01-11 14:50:10 +01001728 }
Ron Eldor74d9acc2019-03-21 14:00:03 +02001729
Gilles Peskine449bd832023-01-11 14:50:10 +01001730 ret = mbedtls_snprintf(p, n, "%s%s", sep, desc);
Ron Eldor74d9acc2019-03-21 14:00:03 +02001731 MBEDTLS_X509_SAFE_SNPRINTF;
1732
1733 sep = ", ";
1734
1735 cur = cur->next;
1736 }
1737
1738 *size = n;
1739 *buf = p;
1740
Gilles Peskine449bd832023-01-11 14:50:10 +01001741 return 0;
Ron Eldor74d9acc2019-03-21 14:00:03 +02001742}
1743
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001744/*
1745 * Return an informational string about the certificate.
1746 */
Stefan Gloorb5c079b2025-02-21 10:33:51 +01001747#define MBEDTLS_BEFORE_COLON 18
1748#define MBEDTLS_BEFORE_COLON_STR "18"
Gilles Peskine449bd832023-01-11 14:50:10 +01001749int mbedtls_x509_crt_info(char *buf, size_t size, const char *prefix,
1750 const mbedtls_x509_crt *crt)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001751{
Janos Follath865b3eb2019-12-16 11:46:15 +00001752 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001753 size_t n;
1754 char *p;
Stefan Gloorb5c079b2025-02-21 10:33:51 +01001755 char key_size_str[MBEDTLS_BEFORE_COLON];
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001756
1757 p = buf;
1758 n = size;
1759
Gilles Peskine449bd832023-01-11 14:50:10 +01001760 if (NULL == crt) {
1761 ret = mbedtls_snprintf(p, n, "\nCertificate is uninitialised!\n");
Janos Follath98e28a72016-05-31 14:03:54 +01001762 MBEDTLS_X509_SAFE_SNPRINTF;
1763
Gilles Peskine449bd832023-01-11 14:50:10 +01001764 return (int) (size - n);
Janos Follath98e28a72016-05-31 14:03:54 +01001765 }
1766
Gilles Peskine449bd832023-01-11 14:50:10 +01001767 ret = mbedtls_snprintf(p, n, "%scert. version : %d\n",
1768 prefix, crt->version);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001769 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001770 ret = mbedtls_snprintf(p, n, "%sserial number : ",
1771 prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001772 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001773
Gilles Peskine449bd832023-01-11 14:50:10 +01001774 ret = mbedtls_x509_serial_gets(p, n, &crt->serial);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001775 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001776
Gilles Peskine449bd832023-01-11 14:50:10 +01001777 ret = mbedtls_snprintf(p, n, "\n%sissuer name : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001778 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001779 ret = mbedtls_x509_dn_gets(p, n, &crt->issuer);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001780 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001781
Gilles Peskine449bd832023-01-11 14:50:10 +01001782 ret = mbedtls_snprintf(p, n, "\n%ssubject name : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001783 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001784 ret = mbedtls_x509_dn_gets(p, n, &crt->subject);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001785 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001786
Gilles Peskine449bd832023-01-11 14:50:10 +01001787 ret = mbedtls_snprintf(p, n, "\n%sissued on : " \
1788 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
1789 crt->valid_from.year, crt->valid_from.mon,
1790 crt->valid_from.day, crt->valid_from.hour,
1791 crt->valid_from.min, crt->valid_from.sec);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001792 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001793
Gilles Peskine449bd832023-01-11 14:50:10 +01001794 ret = mbedtls_snprintf(p, n, "\n%sexpires on : " \
1795 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
1796 crt->valid_to.year, crt->valid_to.mon,
1797 crt->valid_to.day, crt->valid_to.hour,
1798 crt->valid_to.min, crt->valid_to.sec);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001799 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001800
Gilles Peskine449bd832023-01-11 14:50:10 +01001801 ret = mbedtls_snprintf(p, n, "\n%ssigned using : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001802 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001803
Valerio Settid24dfad2025-04-23 11:13:02 +02001804 ret = mbedtls_x509_sig_alg_gets(p, n, &crt->sig_oid, crt->sig_pk, crt->sig_md);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001805 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001806
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001807 /* Key size */
Stefan Gloorb5c079b2025-02-21 10:33:51 +01001808 if ((ret = mbedtls_x509_key_size_helper(key_size_str, MBEDTLS_BEFORE_COLON,
Gilles Peskine449bd832023-01-11 14:50:10 +01001809 mbedtls_pk_get_name(&crt->pk))) != 0) {
1810 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001811 }
1812
Stefan Gloorb5c079b2025-02-21 10:33:51 +01001813 ret = mbedtls_snprintf(p, n, "\n%s%-" MBEDTLS_BEFORE_COLON_STR "s: %d bits",
1814 prefix, key_size_str, (int) mbedtls_pk_get_bitlen(&crt->pk));
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001815 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001816
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001817 /*
1818 * Optional extensions
1819 */
1820
Gilles Peskine449bd832023-01-11 14:50:10 +01001821 if (crt->ext_types & MBEDTLS_X509_EXT_BASIC_CONSTRAINTS) {
1822 ret = mbedtls_snprintf(p, n, "\n%sbasic constraints : CA=%s", prefix,
1823 crt->ca_istrue ? "true" : "false");
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001824 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001825
Gilles Peskine449bd832023-01-11 14:50:10 +01001826 if (crt->max_pathlen > 0) {
1827 ret = mbedtls_snprintf(p, n, ", max_pathlen=%d", crt->max_pathlen - 1);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001828 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001829 }
1830 }
1831
Gilles Peskine449bd832023-01-11 14:50:10 +01001832 if (crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME) {
1833 ret = mbedtls_snprintf(p, n, "\n%ssubject alt name :", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001834 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardbce2b302014-04-01 13:43:28 +02001835
Przemek Stekiel21c37282023-01-16 08:47:49 +01001836 if ((ret = mbedtls_x509_info_subject_alt_name(&p, &n,
1837 &crt->subject_alt_names,
1838 prefix)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001839 return ret;
1840 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001841 }
1842
Gilles Peskine449bd832023-01-11 14:50:10 +01001843 if (crt->ext_types & MBEDTLS_X509_EXT_NS_CERT_TYPE) {
1844 ret = mbedtls_snprintf(p, n, "\n%scert. type : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001845 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnard919f8f52014-04-01 13:01:11 +02001846
Przemek Stekiel21c37282023-01-16 08:47:49 +01001847 if ((ret = mbedtls_x509_info_cert_type(&p, &n, crt->ns_cert_type)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001848 return ret;
1849 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001850 }
1851
Gilles Peskine449bd832023-01-11 14:50:10 +01001852 if (crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE) {
1853 ret = mbedtls_snprintf(p, n, "\n%skey usage : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001854 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnard65c2ddc2014-04-01 14:12:11 +02001855
Przemek Stekiel21c37282023-01-16 08:47:49 +01001856 if ((ret = mbedtls_x509_info_key_usage(&p, &n, crt->key_usage)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001857 return ret;
1858 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001859 }
1860
Gilles Peskine449bd832023-01-11 14:50:10 +01001861 if (crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE) {
1862 ret = mbedtls_snprintf(p, n, "\n%sext key usage : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001863 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001864
Gilles Peskine449bd832023-01-11 14:50:10 +01001865 if ((ret = x509_info_ext_key_usage(&p, &n,
1866 &crt->ext_key_usage)) != 0) {
1867 return ret;
1868 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001869 }
1870
Gilles Peskine32a11122025-04-09 21:51:46 +02001871 if (crt->ext_types & MBEDTLS_X509_EXT_CERTIFICATE_POLICIES) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001872 ret = mbedtls_snprintf(p, n, "\n%scertificate policies : ", prefix);
Ron Eldor74d9acc2019-03-21 14:00:03 +02001873 MBEDTLS_X509_SAFE_SNPRINTF;
1874
Gilles Peskine449bd832023-01-11 14:50:10 +01001875 if ((ret = x509_info_cert_policies(&p, &n,
1876 &crt->certificate_policies)) != 0) {
1877 return ret;
1878 }
Ron Eldor74d9acc2019-03-21 14:00:03 +02001879 }
1880
Gilles Peskine449bd832023-01-11 14:50:10 +01001881 ret = mbedtls_snprintf(p, n, "\n");
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001882 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001883
Gilles Peskine449bd832023-01-11 14:50:10 +01001884 return (int) (size - n);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001885}
1886
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001887struct x509_crt_verify_string {
1888 int code;
1889 const char *string;
1890};
1891
Gilles Peskine449bd832023-01-11 14:50:10 +01001892#define X509_CRT_ERROR_INFO(err, err_str, info) { err, info },
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001893static const struct x509_crt_verify_string x509_crt_verify_strings[] = {
Hanno Becker7ac83f92020-10-09 10:48:22 +01001894 MBEDTLS_X509_CRT_ERROR_INFO_LIST
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001895 { 0, NULL }
1896};
Hanno Becker7ac83f92020-10-09 10:48:22 +01001897#undef X509_CRT_ERROR_INFO
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001898
Gilles Peskine449bd832023-01-11 14:50:10 +01001899int mbedtls_x509_crt_verify_info(char *buf, size_t size, const char *prefix,
1900 uint32_t flags)
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001901{
Janos Follath865b3eb2019-12-16 11:46:15 +00001902 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001903 const struct x509_crt_verify_string *cur;
1904 char *p = buf;
1905 size_t n = size;
1906
Gilles Peskine449bd832023-01-11 14:50:10 +01001907 for (cur = x509_crt_verify_strings; cur->string != NULL; cur++) {
1908 if ((flags & cur->code) == 0) {
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001909 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001910 }
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001911
Gilles Peskine449bd832023-01-11 14:50:10 +01001912 ret = mbedtls_snprintf(p, n, "%s%s\n", prefix, cur->string);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001913 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001914 flags ^= cur->code;
1915 }
1916
Gilles Peskine449bd832023-01-11 14:50:10 +01001917 if (flags != 0) {
1918 ret = mbedtls_snprintf(p, n, "%sUnknown reason "
1919 "(this should not happen)\n", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001920 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001921 }
1922
Gilles Peskine449bd832023-01-11 14:50:10 +01001923 return (int) (size - n);
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001924}
Hanno Becker612a2f12020-10-09 09:19:39 +01001925#endif /* MBEDTLS_X509_REMOVE_INFO */
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001926
Gilles Peskine449bd832023-01-11 14:50:10 +01001927int mbedtls_x509_crt_check_key_usage(const mbedtls_x509_crt *crt,
1928 unsigned int usage)
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02001929{
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02001930 unsigned int usage_must, usage_may;
1931 unsigned int may_mask = MBEDTLS_X509_KU_ENCIPHER_ONLY
Gilles Peskine449bd832023-01-11 14:50:10 +01001932 | MBEDTLS_X509_KU_DECIPHER_ONLY;
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02001933
Gilles Peskine449bd832023-01-11 14:50:10 +01001934 if ((crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE) == 0) {
1935 return 0;
1936 }
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02001937
1938 usage_must = usage & ~may_mask;
1939
Gilles Peskine449bd832023-01-11 14:50:10 +01001940 if (((crt->key_usage & ~may_mask) & usage_must) != usage_must) {
1941 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1942 }
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02001943
1944 usage_may = usage & may_mask;
1945
Gilles Peskine449bd832023-01-11 14:50:10 +01001946 if (((crt->key_usage & may_mask) | usage_may) != usage_may) {
1947 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1948 }
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02001949
Gilles Peskine449bd832023-01-11 14:50:10 +01001950 return 0;
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02001951}
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02001952
Gilles Peskine449bd832023-01-11 14:50:10 +01001953int mbedtls_x509_crt_check_extended_key_usage(const mbedtls_x509_crt *crt,
1954 const char *usage_oid,
1955 size_t usage_len)
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001956{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001957 const mbedtls_x509_sequence *cur;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001958
1959 /* Extension is not mandatory, absent means no restriction */
Gilles Peskine449bd832023-01-11 14:50:10 +01001960 if ((crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE) == 0) {
1961 return 0;
1962 }
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001963
1964 /*
1965 * Look for the requested usage (or wildcard ANY) in our list
1966 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001967 for (cur = &crt->ext_key_usage; cur != NULL; cur = cur->next) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001968 const mbedtls_x509_buf *cur_oid = &cur->buf;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001969
Gilles Peskine449bd832023-01-11 14:50:10 +01001970 if (cur_oid->len == usage_len &&
1971 memcmp(cur_oid->p, usage_oid, usage_len) == 0) {
1972 return 0;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001973 }
1974
Gilles Peskine449bd832023-01-11 14:50:10 +01001975 if (MBEDTLS_OID_CMP(MBEDTLS_OID_ANY_EXTENDED_KEY_USAGE, cur_oid) == 0) {
1976 return 0;
1977 }
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001978 }
1979
Gilles Peskine449bd832023-01-11 14:50:10 +01001980 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001981}
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02001982
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001983#if defined(MBEDTLS_X509_CRL_PARSE_C)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001984/*
1985 * Return 1 if the certificate is revoked, or 0 otherwise.
1986 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001987int mbedtls_x509_crt_is_revoked(const mbedtls_x509_crt *crt, const mbedtls_x509_crl *crl)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001988{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001989 const mbedtls_x509_crl_entry *cur = &crl->entry;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001990
Gilles Peskine449bd832023-01-11 14:50:10 +01001991 while (cur != NULL && cur->serial.len != 0) {
1992 if (crt->serial.len == cur->serial.len &&
1993 memcmp(crt->serial.p, cur->serial.p, crt->serial.len) == 0) {
1994 return 1;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001995 }
1996
1997 cur = cur->next;
1998 }
1999
Gilles Peskine449bd832023-01-11 14:50:10 +01002000 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002001}
2002
2003/*
Manuel Pégourié-Gonnardeeef9472016-02-22 11:36:55 +01002004 * Check that the given certificate is not revoked according to the CRL.
Manuel Pégourié-Gonnard08eacec2017-10-18 14:20:24 +02002005 * Skip validation if no CRL for the given CA is present.
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002006 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002007static int x509_crt_verifycrl(mbedtls_x509_crt *crt, mbedtls_x509_crt *ca,
2008 mbedtls_x509_crl *crl_list,
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002009 const mbedtls_x509_crt_profile *profile,
2010 const mbedtls_x509_time *now)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002011{
2012 int flags = 0;
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02002013 unsigned char hash[MBEDTLS_MD_MAX_SIZE];
pespacek7599a772022-02-07 14:40:55 +01002014 psa_algorithm_t psa_algorithm;
pespacek7599a772022-02-07 14:40:55 +01002015 size_t hash_length;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002016
Gilles Peskine449bd832023-01-11 14:50:10 +01002017 if (ca == NULL) {
2018 return flags;
2019 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002020
Gilles Peskine449bd832023-01-11 14:50:10 +01002021 while (crl_list != NULL) {
2022 if (crl_list->version == 0 ||
2023 x509_name_cmp(&crl_list->issuer, &ca->subject) != 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002024 crl_list = crl_list->next;
2025 continue;
2026 }
2027
2028 /*
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002029 * Check if the CA is configured to sign CRLs
2030 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002031 if (mbedtls_x509_crt_check_key_usage(ca,
2032 MBEDTLS_X509_KU_CRL_SIGN) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002033 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002034 break;
2035 }
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002036
2037 /*
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002038 * Check if CRL is correctly signed by the trusted CA
2039 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002040 if (x509_profile_check_md_alg(profile, crl_list->sig_md) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002041 flags |= MBEDTLS_X509_BADCRL_BAD_MD;
Gilles Peskine449bd832023-01-11 14:50:10 +01002042 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002043
Gilles Peskine449bd832023-01-11 14:50:10 +01002044 if (x509_profile_check_pk_alg(profile, crl_list->sig_pk) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002045 flags |= MBEDTLS_X509_BADCRL_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01002046 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002047
Manuel Pégourié-Gonnard2d6d9932023-03-28 11:38:08 +02002048 psa_algorithm = mbedtls_md_psa_alg_from_type(crl_list->sig_md);
Gilles Peskine449bd832023-01-11 14:50:10 +01002049 if (psa_hash_compute(psa_algorithm,
2050 crl_list->tbs.p,
2051 crl_list->tbs.len,
2052 hash,
2053 sizeof(hash),
2054 &hash_length) != PSA_SUCCESS) {
pespaceka7a64692022-02-14 15:18:43 +01002055 /* Note: this can't happen except after an internal error */
2056 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
2057 break;
2058 }
pespaceka7a64692022-02-14 15:18:43 +01002059
Gilles Peskine449bd832023-01-11 14:50:10 +01002060 if (x509_profile_check_key(profile, &ca->pk) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002061 flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01002062 }
Manuel Pégourié-Gonnard95051642015-06-15 10:39:46 +02002063
Ben Taylor306ffd32025-07-07 09:41:34 +01002064 if (mbedtls_pk_verify_new(crl_list->sig_pk, &ca->pk,
Gilles Peskine449bd832023-01-11 14:50:10 +01002065 crl_list->sig_md, hash, hash_length,
2066 crl_list->sig.p, crl_list->sig.len) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002067 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002068 break;
2069 }
2070
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002071#if defined(MBEDTLS_HAVE_TIME_DATE)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002072 /*
2073 * Check for validity of CRL (Do not drop out)
2074 */
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002075 if (mbedtls_x509_time_cmp(&crl_list->next_update, now) < 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002076 flags |= MBEDTLS_X509_BADCRL_EXPIRED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002077 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002078
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002079 if (mbedtls_x509_time_cmp(&crl_list->this_update, now) > 0) {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01002080 flags |= MBEDTLS_X509_BADCRL_FUTURE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002081 }
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002082#else
2083 ((void) now);
2084#endif
Manuel Pégourié-Gonnard95337652014-03-10 13:15:18 +01002085
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002086 /*
2087 * Check if certificate is revoked
2088 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002089 if (mbedtls_x509_crt_is_revoked(crt, crl_list)) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002090 flags |= MBEDTLS_X509_BADCERT_REVOKED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002091 break;
2092 }
2093
2094 crl_list = crl_list->next;
2095 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002096
Gilles Peskine449bd832023-01-11 14:50:10 +01002097 return flags;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002098}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002099#endif /* MBEDTLS_X509_CRL_PARSE_C */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002100
Manuel Pégourié-Gonnard88421242014-10-17 11:36:18 +02002101/*
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002102 * Check the signature of a certificate by its parent
2103 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002104static int x509_crt_check_signature(const mbedtls_x509_crt *child,
2105 mbedtls_x509_crt *parent,
2106 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002107{
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002108 size_t hash_len;
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02002109 unsigned char hash[MBEDTLS_MD_MAX_SIZE];
Manuel Pégourié-Gonnard2d6d9932023-03-28 11:38:08 +02002110 psa_algorithm_t hash_alg = mbedtls_md_psa_alg_from_type(child->sig_md);
pespacek7599a772022-02-07 14:40:55 +01002111 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002112
Gilles Peskine449bd832023-01-11 14:50:10 +01002113 status = psa_hash_compute(hash_alg,
2114 child->tbs.p,
2115 child->tbs.len,
2116 hash,
2117 sizeof(hash),
2118 &hash_len);
2119 if (status != PSA_SUCCESS) {
2120 return MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED;
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002121 }
2122
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002123 /* Skip expensive computation on obvious mismatch */
Gilles Peskine449bd832023-01-11 14:50:10 +01002124 if (!mbedtls_pk_can_do(&parent->pk, child->sig_pk)) {
2125 return -1;
2126 }
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002127
Valerio Settieaf57892025-05-06 17:07:09 +02002128#if defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002129 if (rs_ctx != NULL && child->sig_pk == MBEDTLS_PK_ECDSA) {
2130 return mbedtls_pk_verify_restartable(&parent->pk,
2131 child->sig_md, hash, hash_len,
2132 child->sig.p, child->sig.len, &rs_ctx->pk);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002133 }
2134#else
2135 (void) rs_ctx;
2136#endif
2137
Ben Taylor306ffd32025-07-07 09:41:34 +01002138 return mbedtls_pk_verify_new(child->sig_pk, &parent->pk,
Gilles Peskine449bd832023-01-11 14:50:10 +01002139 child->sig_md, hash, hash_len,
2140 child->sig.p, child->sig.len);
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002141}
2142
2143/*
Manuel Pégourié-Gonnard312010e2014-04-09 14:30:11 +02002144 * Check if 'parent' is a suitable parent (signing CA) for 'child'.
2145 * Return 0 if yes, -1 if not.
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002146 *
2147 * top means parent is a locally-trusted certificate
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002148 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002149static int x509_crt_check_parent(const mbedtls_x509_crt *child,
2150 const mbedtls_x509_crt *parent,
2151 int top)
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002152{
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002153 int need_ca_bit;
2154
Manuel Pégourié-Gonnardc4eff162014-06-19 12:18:08 +02002155 /* Parent must be the issuer */
Gilles Peskine449bd832023-01-11 14:50:10 +01002156 if (x509_name_cmp(&child->issuer, &parent->subject) != 0) {
2157 return -1;
2158 }
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002159
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002160 /* Parent must have the basicConstraints CA bit set as a general rule */
2161 need_ca_bit = 1;
2162
2163 /* Exception: v1/v2 certificates that are locally trusted. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002164 if (top && parent->version < 3) {
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002165 need_ca_bit = 0;
Manuel Pégourié-Gonnardc4eff162014-06-19 12:18:08 +02002166 }
Manuel Pégourié-Gonnard312010e2014-04-09 14:30:11 +02002167
Gilles Peskine449bd832023-01-11 14:50:10 +01002168 if (need_ca_bit && !parent->ca_istrue) {
2169 return -1;
2170 }
2171
2172 if (need_ca_bit &&
2173 mbedtls_x509_crt_check_key_usage(parent, MBEDTLS_X509_KU_KEY_CERT_SIGN) != 0) {
2174 return -1;
2175 }
2176
2177 return 0;
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002178}
2179
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002180/*
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002181 * Find a suitable parent for child in candidates, or return NULL.
2182 *
2183 * Here suitable is defined as:
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002184 * 1. subject name matches child's issuer
2185 * 2. if necessary, the CA bit is set and key usage allows signing certs
2186 * 3. for trusted roots, the signature is correct
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002187 * (for intermediates, the signature is checked and the result reported)
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002188 * 4. pathlen constraints are satisfied
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002189 *
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002190 * If there's a suitable candidate which is also time-valid, return the first
2191 * such. Otherwise, return the first suitable candidate (or NULL if there is
2192 * none).
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002193 *
2194 * The rationale for this rule is that someone could have a list of trusted
2195 * roots with two versions on the same root with different validity periods.
2196 * (At least one user reported having such a list and wanted it to just work.)
2197 * The reason we don't just require time-validity is that generally there is
2198 * only one version, and if it's expired we want the flags to state that
2199 * rather than NOT_TRUSTED, as would be the case if we required it here.
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002200 *
2201 * The rationale for rule 3 (signature for trusted roots) is that users might
2202 * have two versions of the same CA with different keys in their list, and the
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002203 * way we select the correct one is by checking the signature (as we don't
2204 * rely on key identifier extensions). (This is one way users might choose to
2205 * handle key rollover, another relies on self-issued certs, see [SIRO].)
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002206 *
2207 * Arguments:
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002208 * - [in] child: certificate for which we're looking for a parent
2209 * - [in] candidates: chained list of potential parents
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002210 * - [out] r_parent: parent found (or NULL)
2211 * - [out] r_signature_is_good: 1 if child signature by parent is valid, or 0
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002212 * - [in] top: 1 if candidates consists of trusted roots, ie we're at the top
2213 * of the chain, 0 otherwise
2214 * - [in] path_cnt: number of intermediates seen so far
2215 * - [in] self_cnt: number of self-signed intermediates seen so far
2216 * (will never be greater than path_cnt)
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002217 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002218 *
2219 * Return value:
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002220 * - 0 on success
2221 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002222 */
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002223static int x509_crt_find_parent_in(
Gilles Peskine449bd832023-01-11 14:50:10 +01002224 mbedtls_x509_crt *child,
2225 mbedtls_x509_crt *candidates,
2226 mbedtls_x509_crt **r_parent,
2227 int *r_signature_is_good,
2228 int top,
2229 unsigned path_cnt,
2230 unsigned self_cnt,
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002231 mbedtls_x509_crt_restart_ctx *rs_ctx,
2232 const mbedtls_x509_time *now)
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002233{
Janos Follath865b3eb2019-12-16 11:46:15 +00002234 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002235 mbedtls_x509_crt *parent, *fallback_parent;
Benjamin Kier36050732019-05-30 14:49:17 -04002236 int signature_is_good = 0, fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002237
Valerio Settieaf57892025-05-06 17:07:09 +02002238#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002239 /* did we have something in progress? */
Gilles Peskine449bd832023-01-11 14:50:10 +01002240 if (rs_ctx != NULL && rs_ctx->parent != NULL) {
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002241 /* restore saved state */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002242 parent = rs_ctx->parent;
2243 fallback_parent = rs_ctx->fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002244 fallback_signature_is_good = rs_ctx->fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002245
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002246 /* clear saved state */
2247 rs_ctx->parent = NULL;
2248 rs_ctx->fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002249 rs_ctx->fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002250
2251 /* resume where we left */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002252 goto check_signature;
2253 }
2254#endif
2255
2256 fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002257 fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002258
Gilles Peskine449bd832023-01-11 14:50:10 +01002259 for (parent = candidates; parent != NULL; parent = parent->next) {
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002260 /* basic parenting skills (name, CA bit, key usage) */
Gilles Peskine449bd832023-01-11 14:50:10 +01002261 if (x509_crt_check_parent(child, parent, top) != 0) {
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002262 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002263 }
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002264
Manuel Pégourié-Gonnard9c6118c2017-06-29 12:38:42 +02002265 /* +1 because stored max_pathlen is 1 higher that the actual value */
Gilles Peskine449bd832023-01-11 14:50:10 +01002266 if (parent->max_pathlen > 0 &&
2267 (size_t) parent->max_pathlen < 1 + path_cnt - self_cnt) {
Manuel Pégourié-Gonnard9c6118c2017-06-29 12:38:42 +02002268 continue;
2269 }
2270
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002271 /* Signature */
Valerio Settieaf57892025-05-06 17:07:09 +02002272#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002273check_signature:
2274#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002275 ret = x509_crt_check_signature(child, parent, rs_ctx);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002276
Valerio Settieaf57892025-05-06 17:07:09 +02002277#if defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002278 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002279 /* save state */
2280 rs_ctx->parent = parent;
2281 rs_ctx->fallback_parent = fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002282 rs_ctx->fallback_signature_is_good = fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002283
Gilles Peskine449bd832023-01-11 14:50:10 +01002284 return ret;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002285 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002286#else
2287 (void) ret;
2288#endif
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002289
2290 signature_is_good = ret == 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002291 if (top && !signature_is_good) {
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002292 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002293 }
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002294
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002295#if defined(MBEDTLS_HAVE_TIME_DATE)
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002296 /* optional time check */
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002297 if (mbedtls_x509_time_cmp(&parent->valid_to, now) < 0 || /* past */
2298 mbedtls_x509_time_cmp(&parent->valid_from, now) > 0) { /* future */
Gilles Peskine449bd832023-01-11 14:50:10 +01002299 if (fallback_parent == NULL) {
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002300 fallback_parent = parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002301 fallback_signature_is_good = signature_is_good;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002302 }
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002303
2304 continue;
2305 }
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002306#else
2307 ((void) now);
2308#endif
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002309
Andy Gross1f627142019-01-30 10:25:53 -06002310 *r_parent = parent;
2311 *r_signature_is_good = signature_is_good;
2312
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002313 break;
2314 }
2315
Gilles Peskine449bd832023-01-11 14:50:10 +01002316 if (parent == NULL) {
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002317 *r_parent = fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002318 *r_signature_is_good = fallback_signature_is_good;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002319 }
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002320
Gilles Peskine449bd832023-01-11 14:50:10 +01002321 return 0;
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002322}
2323
2324/*
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002325 * Find a parent in trusted CAs or the provided chain, or return NULL.
2326 *
2327 * Searches in trusted CAs first, and return the first suitable parent found
2328 * (see find_parent_in() for definition of suitable).
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002329 *
2330 * Arguments:
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002331 * - [in] child: certificate for which we're looking for a parent, followed
2332 * by a chain of possible intermediates
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002333 * - [in] trust_ca: list of locally trusted certificates
2334 * - [out] parent: parent found (or NULL)
2335 * - [out] parent_is_trusted: 1 if returned `parent` is trusted, or 0
2336 * - [out] signature_is_good: 1 if child signature by parent is valid, or 0
2337 * - [in] path_cnt: number of links in the chain so far (EE -> ... -> child)
2338 * - [in] self_cnt: number of self-signed certs in the chain so far
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002339 * (will always be no greater than path_cnt)
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002340 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002341 *
2342 * Return value:
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002343 * - 0 on success
2344 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002345 */
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002346static int x509_crt_find_parent(
Gilles Peskine449bd832023-01-11 14:50:10 +01002347 mbedtls_x509_crt *child,
2348 mbedtls_x509_crt *trust_ca,
2349 mbedtls_x509_crt **parent,
2350 int *parent_is_trusted,
2351 int *signature_is_good,
2352 unsigned path_cnt,
2353 unsigned self_cnt,
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002354 mbedtls_x509_crt_restart_ctx *rs_ctx,
2355 const mbedtls_x509_time *now)
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002356{
Janos Follath865b3eb2019-12-16 11:46:15 +00002357 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002358 mbedtls_x509_crt *search_list;
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002359
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002360 *parent_is_trusted = 1;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002361
Valerio Settieaf57892025-05-06 17:07:09 +02002362#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002363 /* restore then clear saved state if we have some stored */
Gilles Peskine449bd832023-01-11 14:50:10 +01002364 if (rs_ctx != NULL && rs_ctx->parent_is_trusted != -1) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002365 *parent_is_trusted = rs_ctx->parent_is_trusted;
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002366 rs_ctx->parent_is_trusted = -1;
2367 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002368#endif
2369
Gilles Peskine449bd832023-01-11 14:50:10 +01002370 while (1) {
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002371 search_list = *parent_is_trusted ? trust_ca : child->next;
2372
Gilles Peskine449bd832023-01-11 14:50:10 +01002373 ret = x509_crt_find_parent_in(child, search_list,
2374 parent, signature_is_good,
2375 *parent_is_trusted,
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002376 path_cnt, self_cnt, rs_ctx, now);
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002377
Valerio Settieaf57892025-05-06 17:07:09 +02002378#if defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002379 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002380 /* save state */
2381 rs_ctx->parent_is_trusted = *parent_is_trusted;
Gilles Peskine449bd832023-01-11 14:50:10 +01002382 return ret;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002383 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002384#else
2385 (void) ret;
2386#endif
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002387
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002388 /* stop here if found or already in second iteration */
Gilles Peskine449bd832023-01-11 14:50:10 +01002389 if (*parent != NULL || *parent_is_trusted == 0) {
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002390 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01002391 }
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002392
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002393 /* prepare second iteration */
2394 *parent_is_trusted = 0;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002395 }
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002396
2397 /* extra precaution against mistakes in the caller */
Gilles Peskine449bd832023-01-11 14:50:10 +01002398 if (*parent == NULL) {
Manuel Pégourié-Gonnarda5a3e402018-10-16 11:27:23 +02002399 *parent_is_trusted = 0;
2400 *signature_is_good = 0;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002401 }
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002402
Gilles Peskine449bd832023-01-11 14:50:10 +01002403 return 0;
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002404}
2405
2406/*
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002407 * Check if an end-entity certificate is locally trusted
2408 *
2409 * Currently we require such certificates to be self-signed (actually only
2410 * check for self-issued as self-signatures are not checked)
2411 */
2412static int x509_crt_check_ee_locally_trusted(
Gilles Peskine449bd832023-01-11 14:50:10 +01002413 mbedtls_x509_crt *crt,
2414 mbedtls_x509_crt *trust_ca)
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002415{
2416 mbedtls_x509_crt *cur;
2417
2418 /* must be self-issued */
Gilles Peskine449bd832023-01-11 14:50:10 +01002419 if (x509_name_cmp(&crt->issuer, &crt->subject) != 0) {
2420 return -1;
2421 }
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002422
2423 /* look for an exact match with trusted cert */
Gilles Peskine449bd832023-01-11 14:50:10 +01002424 for (cur = trust_ca; cur != NULL; cur = cur->next) {
2425 if (crt->raw.len == cur->raw.len &&
2426 memcmp(crt->raw.p, cur->raw.p, crt->raw.len) == 0) {
2427 return 0;
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002428 }
2429 }
2430
2431 /* too bad */
Gilles Peskine449bd832023-01-11 14:50:10 +01002432 return -1;
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002433}
2434
2435/*
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002436 * Build and verify a certificate chain
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002437 *
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002438 * Given a peer-provided list of certificates EE, C1, ..., Cn and
2439 * a list of trusted certs R1, ... Rp, try to build and verify a chain
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002440 * EE, Ci1, ... Ciq [, Rj]
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002441 * such that every cert in the chain is a child of the next one,
2442 * jumping to a trusted root as early as possible.
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002443 *
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002444 * Verify that chain and return it with flags for all issues found.
2445 *
2446 * Special cases:
2447 * - EE == Rj -> return a one-element list containing it
2448 * - EE, Ci1, ..., Ciq cannot be continued with a trusted root
2449 * -> return that chain with NOT_TRUSTED set on Ciq
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002450 *
Manuel Pégourié-Gonnardd19a41d2017-07-14 11:05:59 +02002451 * Tests for (aspects of) this function should include at least:
2452 * - trusted EE
2453 * - EE -> trusted root
Antonin Décimo36e89b52019-01-23 15:24:37 +01002454 * - EE -> intermediate CA -> trusted root
Manuel Pégourié-Gonnardd19a41d2017-07-14 11:05:59 +02002455 * - if relevant: EE untrusted
2456 * - if relevant: EE -> intermediate, untrusted
2457 * with the aspect under test checked at each relevant level (EE, int, root).
2458 * For some aspects longer chains are required, but usually length 2 is
2459 * enough (but length 1 is not in general).
2460 *
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002461 * Arguments:
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002462 * - [in] crt: the cert list EE, C1, ..., Cn
2463 * - [in] trust_ca: the trusted list R1, ..., Rp
2464 * - [in] ca_crl, profile: as in verify_with_profile()
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002465 * - [out] ver_chain: the built and verified chain
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002466 * Only valid when return value is 0, may contain garbage otherwise!
2467 * Restart note: need not be the same when calling again to resume.
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002468 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002469 *
2470 * Return value:
2471 * - non-zero if the chain could not be fully built and examined
2472 * - 0 is the chain was successfully built and examined,
2473 * even if it was found to be invalid
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002474 */
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002475static int x509_crt_verify_chain(
Gilles Peskine449bd832023-01-11 14:50:10 +01002476 mbedtls_x509_crt *crt,
2477 mbedtls_x509_crt *trust_ca,
2478 mbedtls_x509_crl *ca_crl,
2479 mbedtls_x509_crt_ca_cb_t f_ca_cb,
2480 void *p_ca_cb,
2481 const mbedtls_x509_crt_profile *profile,
2482 mbedtls_x509_crt_verify_chain *ver_chain,
2483 mbedtls_x509_crt_restart_ctx *rs_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002484{
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002485 /* Don't initialize any of those variables here, so that the compiler can
2486 * catch potential issues with jumping ahead when restarting */
Janos Follath865b3eb2019-12-16 11:46:15 +00002487 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002488 uint32_t *flags;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002489 mbedtls_x509_crt_verify_chain_item *cur;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002490 mbedtls_x509_crt *child;
Manuel Pégourié-Gonnard58dcd2d2017-07-03 21:35:04 +02002491 mbedtls_x509_crt *parent;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002492 int parent_is_trusted;
2493 int child_is_trusted;
2494 int signature_is_good;
Manuel Pégourié-Gonnardbb216bd2017-08-28 13:25:55 +02002495 unsigned self_cnt;
Hanno Beckerf53893b2019-03-28 13:45:55 +00002496 mbedtls_x509_crt *cur_trust_ca = NULL;
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002497 mbedtls_x509_time now;
2498
2499#if defined(MBEDTLS_HAVE_TIME_DATE)
2500 if (mbedtls_x509_time_gmtime(mbedtls_time(NULL), &now) != 0) {
2501 return MBEDTLS_ERR_X509_FATAL_ERROR;
2502 }
2503#endif
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002504
Valerio Settieaf57892025-05-06 17:07:09 +02002505#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002506 /* resume if we had an operation in progress */
Gilles Peskine449bd832023-01-11 14:50:10 +01002507 if (rs_ctx != NULL && rs_ctx->in_progress == x509_crt_rs_find_parent) {
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002508 /* restore saved state */
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002509 *ver_chain = rs_ctx->ver_chain; /* struct copy */
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002510 self_cnt = rs_ctx->self_cnt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002511
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002512 /* restore derived state */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002513 cur = &ver_chain->items[ver_chain->len - 1];
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002514 child = cur->crt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002515 flags = &cur->flags;
2516
2517 goto find_parent;
2518 }
Valerio Settieaf57892025-05-06 17:07:09 +02002519#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard8f8c2822017-07-03 21:25:10 +02002520
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002521 child = crt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002522 self_cnt = 0;
2523 parent_is_trusted = 0;
2524 child_is_trusted = 0;
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002525
Gilles Peskine449bd832023-01-11 14:50:10 +01002526 while (1) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002527 /* Add certificate to the verification chain */
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002528 cur = &ver_chain->items[ver_chain->len];
2529 cur->crt = child;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002530 cur->flags = 0;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002531 ver_chain->len++;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002532 flags = &cur->flags;
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002533
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002534#if defined(MBEDTLS_HAVE_TIME_DATE)
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002535 /* Check time-validity (all certificates) */
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002536 if (mbedtls_x509_time_cmp(&child->valid_to, &now) < 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002537 *flags |= MBEDTLS_X509_BADCERT_EXPIRED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002538 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002539
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002540 if (mbedtls_x509_time_cmp(&child->valid_from, &now) > 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002541 *flags |= MBEDTLS_X509_BADCERT_FUTURE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002542 }
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002543#endif
Manuel Pégourié-Gonnardcb396102017-07-04 00:00:24 +02002544
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002545 /* Stop here for trusted roots (but not for trusted EE certs) */
Gilles Peskine449bd832023-01-11 14:50:10 +01002546 if (child_is_trusted) {
2547 return 0;
2548 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002549
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002550 /* Check signature algorithm: MD & PK algs */
Gilles Peskine449bd832023-01-11 14:50:10 +01002551 if (x509_profile_check_md_alg(profile, child->sig_md) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002552 *flags |= MBEDTLS_X509_BADCERT_BAD_MD;
Gilles Peskine449bd832023-01-11 14:50:10 +01002553 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002554
Gilles Peskine449bd832023-01-11 14:50:10 +01002555 if (x509_profile_check_pk_alg(profile, child->sig_pk) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002556 *flags |= MBEDTLS_X509_BADCERT_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01002557 }
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002558
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002559 /* Special case: EE certs that are locally trusted */
Gilles Peskine449bd832023-01-11 14:50:10 +01002560 if (ver_chain->len == 1 &&
2561 x509_crt_check_ee_locally_trusted(child, trust_ca) == 0) {
2562 return 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002563 }
Manuel Pégourié-Gonnard8f8c2822017-07-03 21:25:10 +02002564
Valerio Settieaf57892025-05-06 17:07:09 +02002565#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002566find_parent:
2567#endif
Hanno Beckerf53893b2019-03-28 13:45:55 +00002568
2569 /* Obtain list of potential trusted signers from CA callback,
2570 * or use statically provided list. */
2571#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
Gilles Peskine449bd832023-01-11 14:50:10 +01002572 if (f_ca_cb != NULL) {
2573 mbedtls_x509_crt_free(ver_chain->trust_ca_cb_result);
2574 mbedtls_free(ver_chain->trust_ca_cb_result);
Hanno Beckerf53893b2019-03-28 13:45:55 +00002575 ver_chain->trust_ca_cb_result = NULL;
2576
Gilles Peskine449bd832023-01-11 14:50:10 +01002577 ret = f_ca_cb(p_ca_cb, child, &ver_chain->trust_ca_cb_result);
2578 if (ret != 0) {
2579 return MBEDTLS_ERR_X509_FATAL_ERROR;
2580 }
Hanno Beckerf53893b2019-03-28 13:45:55 +00002581
2582 cur_trust_ca = ver_chain->trust_ca_cb_result;
Gilles Peskine449bd832023-01-11 14:50:10 +01002583 } else
Hanno Beckerf53893b2019-03-28 13:45:55 +00002584#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2585 {
2586 ((void) f_ca_cb);
2587 ((void) p_ca_cb);
2588 cur_trust_ca = trust_ca;
2589 }
2590
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002591 /* Look for a parent in trusted CAs or up the chain */
Gilles Peskine449bd832023-01-11 14:50:10 +01002592 ret = x509_crt_find_parent(child, cur_trust_ca, &parent,
2593 &parent_is_trusted, &signature_is_good,
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002594 ver_chain->len - 1, self_cnt, rs_ctx,
2595 &now);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002596
Valerio Settieaf57892025-05-06 17:07:09 +02002597#if defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002598 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002599 /* save state */
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002600 rs_ctx->in_progress = x509_crt_rs_find_parent;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002601 rs_ctx->self_cnt = self_cnt;
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002602 rs_ctx->ver_chain = *ver_chain; /* struct copy */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002603
Gilles Peskine449bd832023-01-11 14:50:10 +01002604 return ret;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002605 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002606#else
2607 (void) ret;
2608#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002609
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002610 /* No parent? We're done here */
Gilles Peskine449bd832023-01-11 14:50:10 +01002611 if (parent == NULL) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002612 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002613 return 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002614 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002615
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002616 /* Count intermediate self-issued (not necessarily self-signed) certs.
2617 * These can occur with some strategies for key rollover, see [SIRO],
2618 * and should be excluded from max_pathlen checks. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002619 if (ver_chain->len != 1 &&
2620 x509_name_cmp(&child->issuer, &child->subject) == 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002621 self_cnt++;
Manuel Pégourié-Gonnard24611f92017-08-09 10:28:07 +02002622 }
Manuel Pégourié-Gonnardfd6c85c2014-11-20 16:34:20 +01002623
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002624 /* path_cnt is 0 for the first intermediate CA,
2625 * and if parent is trusted it's not an intermediate CA */
Gilles Peskine449bd832023-01-11 14:50:10 +01002626 if (!parent_is_trusted &&
2627 ver_chain->len > MBEDTLS_X509_MAX_INTERMEDIATE_CA) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002628 /* return immediately to avoid overflow the chain array */
Gilles Peskine449bd832023-01-11 14:50:10 +01002629 return MBEDTLS_ERR_X509_FATAL_ERROR;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002630 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002631
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002632 /* signature was checked while searching parent */
Gilles Peskine449bd832023-01-11 14:50:10 +01002633 if (!signature_is_good) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002634 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002635 }
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002636
2637 /* check size of signing key */
Gilles Peskine449bd832023-01-11 14:50:10 +01002638 if (x509_profile_check_key(profile, &parent->pk) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002639 *flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01002640 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002641
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002642#if defined(MBEDTLS_X509_CRL_PARSE_C)
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002643 /* Check trusted CA's CRL for the given crt */
Glenn Strauss4b2a6e82022-06-30 12:17:58 -04002644 *flags |= x509_crt_verifycrl(child, parent, ca_crl, profile, &now);
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002645#else
2646 (void) ca_crl;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002647#endif
2648
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002649 /* prepare for next iteration */
2650 child = parent;
2651 parent = NULL;
2652 child_is_trusted = parent_is_trusted;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002653 signature_is_good = 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002654 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002655}
2656
Glenn Straussc26bd762022-10-23 19:48:18 -04002657#ifdef _WIN32
2658#ifdef _MSC_VER
2659#pragma comment(lib, "ws2_32.lib")
2660#include <winsock2.h>
2661#include <ws2tcpip.h>
2662#elif (defined(__MINGW32__) || defined(__MINGW64__)) && _WIN32_WINNT >= 0x0600
2663#include <winsock2.h>
2664#include <ws2tcpip.h>
Steve Lhommeeb0f18a2023-06-16 14:12:19 +02002665#else
2666/* inet_pton() is not supported, fallback to software version */
2667#define MBEDTLS_TEST_SW_INET_PTON
Glenn Straussc26bd762022-10-23 19:48:18 -04002668#endif
2669#elif defined(__sun)
2670/* Solaris requires -lsocket -lnsl for inet_pton() */
2671#elif defined(__has_include)
2672#if __has_include(<sys/socket.h>)
2673#include <sys/socket.h>
2674#endif
2675#if __has_include(<arpa/inet.h>)
2676#include <arpa/inet.h>
2677#endif
2678#endif
2679
2680/* Use whether or not AF_INET6 is defined to indicate whether or not to use
2681 * the platform inet_pton() or a local implementation (below). The local
2682 * implementation may be used even in cases where the platform provides
2683 * inet_pton(), e.g. when there are different includes required and/or the
2684 * platform implementation requires dependencies on additional libraries.
2685 * Specifically, Windows requires custom includes and additional link
2686 * dependencies, and Solaris requires additional link dependencies.
2687 * Also, as a coarse heuristic, use the local implementation if the compiler
2688 * does not support __has_include(), or if the definition of AF_INET6 is not
Andrzej Kurek06969fc2023-04-12 10:34:50 -04002689 * provided by headers included (or not) via __has_include() above.
2690 * MBEDTLS_TEST_SW_INET_PTON is a bypass define to force testing of this code //no-check-names
2691 * despite having a platform that has inet_pton. */
2692#if !defined(AF_INET6) || defined(MBEDTLS_TEST_SW_INET_PTON) //no-check-names
2693/* Definition located further below to possibly reduce compiler inlining */
Glenn Strauss416c2952022-10-24 23:00:02 -04002694static int x509_inet_pton_ipv4(const char *src, void *dst);
2695
2696#define li_cton(c, n) \
2697 (((n) = (c) - '0') <= 9 || (((n) = ((c)&0xdf) - 'A') <= 5 ? ((n) += 10) : 0))
2698
2699static int x509_inet_pton_ipv6(const char *src, void *dst)
2700{
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002701 const unsigned char *p = (const unsigned char *) src;
Andrzej Kurek0d578962023-04-13 09:09:56 -04002702 int nonzero_groups = 0, num_digits, zero_group_start = -1;
Glenn Strauss416c2952022-10-24 23:00:02 -04002703 uint16_t addr[8];
2704 do {
2705 /* note: allows excess leading 0's, e.g. 1:0002:3:... */
Andrzej Kurek7f5a1a42023-04-13 08:02:27 -04002706 uint16_t group = num_digits = 0;
Andrzej Kurek8bc2cc92023-04-18 07:26:27 -04002707 for (uint8_t digit; num_digits < 4; num_digits++) {
2708 if (li_cton(*p, digit) == 0) {
2709 break;
2710 }
2711 group = (group << 4) | digit;
2712 p++;
Glenn Strauss416c2952022-10-24 23:00:02 -04002713 }
Andrzej Kurek7f5a1a42023-04-13 08:02:27 -04002714 if (num_digits != 0) {
Dave Rodgmancfa72232023-09-05 16:20:33 +01002715 MBEDTLS_PUT_UINT16_BE(group, addr, nonzero_groups);
2716 nonzero_groups++;
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002717 if (*p == '\0') {
Glenn Strauss416c2952022-10-24 23:00:02 -04002718 break;
Andrzej Kurek8bc2cc92023-04-18 07:26:27 -04002719 } else if (*p == '.') {
2720 /* Don't accept IPv4 too early or late */
2721 if ((nonzero_groups == 0 && zero_group_start == -1) ||
2722 nonzero_groups >= 7) {
2723 break;
2724 }
2725
2726 /* Walk back to prior ':', then parse as IPv4-mapped */
2727 int steps = 4;
2728 do {
2729 p--;
2730 steps--;
2731 } while (*p != ':' && steps > 0);
2732
2733 if (*p != ':') {
2734 break;
2735 }
2736 p++;
2737 nonzero_groups--;
2738 if (x509_inet_pton_ipv4((const char *) p,
2739 addr + nonzero_groups) != 0) {
2740 break;
2741 }
2742
Andrzej Kurek0d578962023-04-13 09:09:56 -04002743 nonzero_groups += 2;
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002744 p = (const unsigned char *) "";
Glenn Strauss416c2952022-10-24 23:00:02 -04002745 break;
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002746 } else if (*p != ':') {
Glenn Strauss416c2952022-10-24 23:00:02 -04002747 return -1;
2748 }
2749 } else {
Andrzej Kurek8bc2cc92023-04-18 07:26:27 -04002750 /* Don't accept a second zero group or an invalid delimiter */
2751 if (zero_group_start != -1 || *p != ':') {
Glenn Strauss416c2952022-10-24 23:00:02 -04002752 return -1;
2753 }
Andrzej Kurek8bc2cc92023-04-18 07:26:27 -04002754 zero_group_start = nonzero_groups;
2755
2756 /* Accept a zero group at start, but it has to be a double colon */
2757 if (zero_group_start == 0 && *++p != ':') {
2758 return -1;
2759 }
2760
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002761 if (p[1] == '\0') {
2762 ++p;
Glenn Strauss416c2952022-10-24 23:00:02 -04002763 break;
2764 }
2765 }
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002766 ++p;
Andrzej Kurek0d578962023-04-13 09:09:56 -04002767 } while (nonzero_groups < 8);
Andrzej Kurek90117db2023-04-18 07:32:47 -04002768
2769 if (*p != '\0') {
Glenn Strauss416c2952022-10-24 23:00:02 -04002770 return -1;
2771 }
2772
Andrzej Kurek7f5a1a42023-04-13 08:02:27 -04002773 if (zero_group_start != -1) {
Andrzej Kurek90117db2023-04-18 07:32:47 -04002774 if (nonzero_groups > 6) {
2775 return -1;
2776 }
Andrzej Kurek0d578962023-04-13 09:09:56 -04002777 int zero_groups = 8 - nonzero_groups;
2778 int groups_after_zero = nonzero_groups - zero_group_start;
2779
2780 /* Move the non-zero part to after the zeroes */
2781 if (groups_after_zero) {
2782 memmove(addr + zero_group_start + zero_groups,
Andrzej Kurek7f5a1a42023-04-13 08:02:27 -04002783 addr + zero_group_start,
Andrzej Kurek0d578962023-04-13 09:09:56 -04002784 groups_after_zero * sizeof(*addr));
Glenn Strauss416c2952022-10-24 23:00:02 -04002785 }
Andrzej Kurek0d578962023-04-13 09:09:56 -04002786 memset(addr + zero_group_start, 0, zero_groups * sizeof(*addr));
Andrzej Kurek90117db2023-04-18 07:32:47 -04002787 } else {
2788 if (nonzero_groups != 8) {
2789 return -1;
2790 }
Glenn Strauss416c2952022-10-24 23:00:02 -04002791 }
2792 memcpy(dst, addr, sizeof(addr));
2793 return 0;
2794}
2795
2796static int x509_inet_pton_ipv4(const char *src, void *dst)
2797{
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002798 const unsigned char *p = (const unsigned char *) src;
Glenn Strauss416c2952022-10-24 23:00:02 -04002799 uint8_t *res = (uint8_t *) dst;
Andrzej Kurekea3e71f2023-04-18 04:39:12 -04002800 uint8_t digit, num_digits = 0;
2801 uint8_t num_octets = 0;
Andrzej Kurek13b8b782023-04-12 09:43:47 -04002802 uint16_t octet;
2803
Glenn Strauss416c2952022-10-24 23:00:02 -04002804 do {
Andrzej Kurekea3e71f2023-04-18 04:39:12 -04002805 octet = num_digits = 0;
2806 do {
2807 digit = *p - '0';
2808 if (digit > 9) {
2809 break;
2810 }
Andrzej Kurek6f400a32023-05-01 05:26:47 -04002811
2812 /* Don't allow leading zeroes. These might mean octal format,
2813 * which this implementation does not support. */
2814 if (octet == 0 && num_digits > 0) {
Andrzej Kurek9c9880a2023-05-03 05:06:47 -04002815 return -1;
Andrzej Kurek6f400a32023-05-01 05:26:47 -04002816 }
2817
Andrzej Kurekea3e71f2023-04-18 04:39:12 -04002818 octet = octet * 10 + digit;
2819 num_digits++;
2820 p++;
2821 } while (num_digits < 3);
2822
2823 if (octet >= 256 || num_digits > 3 || num_digits == 0) {
Andrzej Kurek9c9880a2023-05-03 05:06:47 -04002824 return -1;
Glenn Strauss416c2952022-10-24 23:00:02 -04002825 }
Andrzej Kurekea3e71f2023-04-18 04:39:12 -04002826 *res++ = (uint8_t) octet;
2827 num_octets++;
2828 } while (num_octets < 4 && *p++ == '.');
Andrzej Kurek6cbca6d2023-04-13 09:22:48 -04002829 return num_octets == 4 && *p == '\0' ? 0 : -1;
Glenn Strauss416c2952022-10-24 23:00:02 -04002830}
Glenn Straussc26bd762022-10-23 19:48:18 -04002831
2832#else
2833
2834static int x509_inet_pton_ipv6(const char *src, void *dst)
2835{
2836 return inet_pton(AF_INET6, src, dst) == 1 ? 0 : -1;
2837}
2838
2839static int x509_inet_pton_ipv4(const char *src, void *dst)
2840{
2841 return inet_pton(AF_INET, src, dst) == 1 ? 0 : -1;
2842}
2843
Andrzej Kurek06969fc2023-04-12 10:34:50 -04002844#endif /* !AF_INET6 || MBEDTLS_TEST_SW_INET_PTON */ //no-check-names
Glenn Straussc26bd762022-10-23 19:48:18 -04002845
Glenn Strauss6f545ac2022-10-25 15:02:14 -04002846size_t mbedtls_x509_crt_parse_cn_inet_pton(const char *cn, void *dst)
Glenn Straussc26bd762022-10-23 19:48:18 -04002847{
2848 return strchr(cn, ':') == NULL
2849 ? x509_inet_pton_ipv4(cn, dst) == 0 ? 4 : 0
2850 : x509_inet_pton_ipv6(cn, dst) == 0 ? 16 : 0;
2851}
2852
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002853/*
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002854 * Check for CN match
2855 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002856static int x509_crt_check_cn(const mbedtls_x509_buf *name,
2857 const char *cn, size_t cn_len)
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002858{
2859 /* try exact match */
Gilles Peskine449bd832023-01-11 14:50:10 +01002860 if (name->len == cn_len &&
2861 x509_memcasecmp(cn, name->p, cn_len) == 0) {
2862 return 0;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002863 }
2864
2865 /* try wildcard match */
Gilles Peskine449bd832023-01-11 14:50:10 +01002866 if (x509_check_wildcard(cn, name) == 0) {
2867 return 0;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002868 }
2869
Gilles Peskine449bd832023-01-11 14:50:10 +01002870 return -1;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002871}
2872
Glenn Straussc26bd762022-10-23 19:48:18 -04002873static int x509_crt_check_san_ip(const mbedtls_x509_sequence *san,
2874 const char *cn, size_t cn_len)
2875{
2876 uint32_t ip[4];
Glenn Strauss6f545ac2022-10-25 15:02:14 -04002877 cn_len = mbedtls_x509_crt_parse_cn_inet_pton(cn, ip);
Glenn Straussc26bd762022-10-23 19:48:18 -04002878 if (cn_len == 0) {
2879 return -1;
2880 }
2881
2882 for (const mbedtls_x509_sequence *cur = san; cur != NULL; cur = cur->next) {
2883 const unsigned char san_type = (unsigned char) cur->buf.tag &
2884 MBEDTLS_ASN1_TAG_VALUE_MASK;
2885 if (san_type == MBEDTLS_X509_SAN_IP_ADDRESS &&
2886 cur->buf.len == cn_len && memcmp(cur->buf.p, ip, cn_len) == 0) {
2887 return 0;
2888 }
2889 }
2890
2891 return -1;
2892}
2893
Andrzej Kurek199eab92023-05-10 09:57:19 -04002894static int x509_crt_check_san_uri(const mbedtls_x509_sequence *san,
2895 const char *cn, size_t cn_len)
2896{
2897 for (const mbedtls_x509_sequence *cur = san; cur != NULL; cur = cur->next) {
2898 const unsigned char san_type = (unsigned char) cur->buf.tag &
2899 MBEDTLS_ASN1_TAG_VALUE_MASK;
2900 if (san_type == MBEDTLS_X509_SAN_UNIFORM_RESOURCE_IDENTIFIER &&
2901 cur->buf.len == cn_len && memcmp(cur->buf.p, cn, cn_len) == 0) {
2902 return 0;
2903 }
2904 }
2905
2906 return -1;
2907}
2908
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002909/*
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002910 * Check for SAN match, see RFC 5280 Section 4.2.1.6
2911 */
Glenn Straussc26bd762022-10-23 19:48:18 -04002912static int x509_crt_check_san(const mbedtls_x509_sequence *san,
Gilles Peskine449bd832023-01-11 14:50:10 +01002913 const char *cn, size_t cn_len)
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002914{
Glenn Straussc26bd762022-10-23 19:48:18 -04002915 int san_ip = 0;
Andrzej Kurek199eab92023-05-10 09:57:19 -04002916 int san_uri = 0;
2917 /* Prioritize DNS name over other subtypes due to popularity */
Glenn Straussc26bd762022-10-23 19:48:18 -04002918 for (const mbedtls_x509_sequence *cur = san; cur != NULL; cur = cur->next) {
2919 switch ((unsigned char) cur->buf.tag & MBEDTLS_ASN1_TAG_VALUE_MASK) {
Andrzej Kurek199eab92023-05-10 09:57:19 -04002920 case MBEDTLS_X509_SAN_DNS_NAME:
Glenn Straussc26bd762022-10-23 19:48:18 -04002921 if (x509_crt_check_cn(&cur->buf, cn, cn_len) == 0) {
2922 return 0;
2923 }
2924 break;
Andrzej Kurek199eab92023-05-10 09:57:19 -04002925 case MBEDTLS_X509_SAN_IP_ADDRESS:
Glenn Straussc26bd762022-10-23 19:48:18 -04002926 san_ip = 1;
2927 break;
Andrzej Kurek199eab92023-05-10 09:57:19 -04002928 case MBEDTLS_X509_SAN_UNIFORM_RESOURCE_IDENTIFIER:
2929 san_uri = 1;
2930 break;
Glenn Straussc26bd762022-10-23 19:48:18 -04002931 /* (We may handle other types here later.) */
2932 default: /* Unrecognized type */
2933 break;
2934 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002935 }
Andrzej Kurek199eab92023-05-10 09:57:19 -04002936 if (san_ip) {
2937 if (x509_crt_check_san_ip(san, cn, cn_len) == 0) {
2938 return 0;
2939 }
2940 }
2941 if (san_uri) {
2942 if (x509_crt_check_san_uri(san, cn, cn_len) == 0) {
2943 return 0;
2944 }
2945 }
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002946
Andrzej Kurek199eab92023-05-10 09:57:19 -04002947 return -1;
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002948}
2949
2950/*
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002951 * Verify the requested CN - only call this if cn is not NULL!
2952 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002953static void x509_crt_verify_name(const mbedtls_x509_crt *crt,
2954 const char *cn,
2955 uint32_t *flags)
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002956{
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002957 const mbedtls_x509_name *name;
Gilles Peskine449bd832023-01-11 14:50:10 +01002958 size_t cn_len = strlen(cn);
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002959
Gilles Peskine449bd832023-01-11 14:50:10 +01002960 if (crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME) {
Glenn Straussc26bd762022-10-23 19:48:18 -04002961 if (x509_crt_check_san(&crt->subject_alt_names, cn, cn_len) == 0) {
2962 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002963 }
2964 } else {
2965 for (name = &crt->subject; name != NULL; name = name->next) {
2966 if (MBEDTLS_OID_CMP(MBEDTLS_OID_AT_CN, &name->oid) == 0 &&
2967 x509_crt_check_cn(&name->val, cn, cn_len) == 0) {
Glenn Straussc26bd762022-10-23 19:48:18 -04002968 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002969 }
2970 }
2971
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002972 }
Glenn Straussc26bd762022-10-23 19:48:18 -04002973
2974 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002975}
2976
2977/*
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002978 * Merge the flags for all certs in the chain, after calling callback
2979 */
2980static int x509_crt_merge_flags_with_cb(
Gilles Peskine449bd832023-01-11 14:50:10 +01002981 uint32_t *flags,
2982 const mbedtls_x509_crt_verify_chain *ver_chain,
2983 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
2984 void *p_vrfy)
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002985{
Janos Follath865b3eb2019-12-16 11:46:15 +00002986 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbb216bd2017-08-28 13:25:55 +02002987 unsigned i;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002988 uint32_t cur_flags;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002989 const mbedtls_x509_crt_verify_chain_item *cur;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002990
Gilles Peskine449bd832023-01-11 14:50:10 +01002991 for (i = ver_chain->len; i != 0; --i) {
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002992 cur = &ver_chain->items[i-1];
2993 cur_flags = cur->flags;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002994
Gilles Peskine449bd832023-01-11 14:50:10 +01002995 if (NULL != f_vrfy) {
2996 if ((ret = f_vrfy(p_vrfy, cur->crt, (int) i-1, &cur_flags)) != 0) {
2997 return ret;
2998 }
2999 }
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02003000
3001 *flags |= cur_flags;
3002 }
3003
Gilles Peskine449bd832023-01-11 14:50:10 +01003004 return 0;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02003005}
3006
3007/*
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003008 * Verify the certificate validity, with profile, restartable version
3009 *
3010 * This function:
3011 * - checks the requested CN (if any)
3012 * - checks the type and size of the EE cert's key,
3013 * as that isn't done as part of chain building/verification currently
3014 * - builds and verifies the chain
3015 * - then calls the callback and merges the flags
Hanno Becker3116fb32019-03-28 13:34:42 +00003016 *
3017 * The parameters pairs `trust_ca`, `ca_crl` and `f_ca_cb`, `p_ca_cb`
3018 * are mutually exclusive: If `f_ca_cb != NULL`, it will be used by the
3019 * verification routine to search for trusted signers, and CRLs will
3020 * be disabled. Otherwise, `trust_ca` will be used as the static list
3021 * of trusted signers, and `ca_crl` will be use as the static list
3022 * of CRLs.
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003023 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003024static int x509_crt_verify_restartable_ca_cb(mbedtls_x509_crt *crt,
3025 mbedtls_x509_crt *trust_ca,
3026 mbedtls_x509_crl *ca_crl,
3027 mbedtls_x509_crt_ca_cb_t f_ca_cb,
3028 void *p_ca_cb,
3029 const mbedtls_x509_crt_profile *profile,
3030 const char *cn, uint32_t *flags,
3031 int (*f_vrfy)(void *,
3032 mbedtls_x509_crt *,
3033 int,
3034 uint32_t *),
3035 void *p_vrfy,
3036 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003037{
Janos Follath865b3eb2019-12-16 11:46:15 +00003038 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02003039 mbedtls_pk_type_t pk_type;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02003040 mbedtls_x509_crt_verify_chain ver_chain;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02003041 uint32_t ee_flags;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003042
3043 *flags = 0;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02003044 ee_flags = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003045 x509_crt_verify_chain_reset(&ver_chain);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003046
Gilles Peskine449bd832023-01-11 14:50:10 +01003047 if (profile == NULL) {
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02003048 ret = MBEDTLS_ERR_X509_BAD_INPUT_DATA;
3049 goto exit;
3050 }
3051
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02003052 /* check name if requested */
Gilles Peskine449bd832023-01-11 14:50:10 +01003053 if (cn != NULL) {
3054 x509_crt_verify_name(crt, cn, &ee_flags);
3055 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003056
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02003057 /* Check the type and size of the key */
Gilles Peskine449bd832023-01-11 14:50:10 +01003058 pk_type = mbedtls_pk_get_type(&crt->pk);
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02003059
Gilles Peskine449bd832023-01-11 14:50:10 +01003060 if (x509_profile_check_pk_alg(profile, pk_type) != 0) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02003061 ee_flags |= MBEDTLS_X509_BADCERT_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01003062 }
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02003063
Gilles Peskine449bd832023-01-11 14:50:10 +01003064 if (x509_profile_check_key(profile, &crt->pk) != 0) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02003065 ee_flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01003066 }
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02003067
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02003068 /* Check the chain */
Gilles Peskine449bd832023-01-11 14:50:10 +01003069 ret = x509_crt_verify_chain(crt, trust_ca, ca_crl,
3070 f_ca_cb, p_ca_cb, profile,
3071 &ver_chain, rs_ctx);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02003072
Gilles Peskine449bd832023-01-11 14:50:10 +01003073 if (ret != 0) {
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +02003074 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01003075 }
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +02003076
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02003077 /* Merge end-entity flags */
3078 ver_chain.items[0].flags |= ee_flags;
3079
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02003080 /* Build final flags, calling callback on the way if any */
Gilles Peskine449bd832023-01-11 14:50:10 +01003081 ret = x509_crt_merge_flags_with_cb(flags, &ver_chain, f_vrfy, p_vrfy);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003082
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02003083exit:
Hanno Beckerf53893b2019-03-28 13:45:55 +00003084
3085#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
Gilles Peskine449bd832023-01-11 14:50:10 +01003086 mbedtls_x509_crt_free(ver_chain.trust_ca_cb_result);
3087 mbedtls_free(ver_chain.trust_ca_cb_result);
Hanno Beckerf53893b2019-03-28 13:45:55 +00003088 ver_chain.trust_ca_cb_result = NULL;
3089#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
3090
Valerio Settieaf57892025-05-06 17:07:09 +02003091#if defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003092 if (rs_ctx != NULL && ret != MBEDTLS_ERR_ECP_IN_PROGRESS) {
3093 mbedtls_x509_crt_restart_free(rs_ctx);
3094 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003095#endif
3096
Manuel Pégourié-Gonnard9107b5f2017-07-06 12:16:25 +02003097 /* prevent misuse of the vrfy callback - VERIFY_FAILED would be ignored by
3098 * the SSL module for authmode optional, but non-zero return from the
3099 * callback means a fatal error so it shouldn't be ignored */
Gilles Peskine449bd832023-01-11 14:50:10 +01003100 if (ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED) {
Manuel Pégourié-Gonnard31458a12017-06-26 10:11:49 +02003101 ret = MBEDTLS_ERR_X509_FATAL_ERROR;
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02003102 }
3103
Gilles Peskine449bd832023-01-11 14:50:10 +01003104 if (ret != 0) {
3105 *flags = (uint32_t) -1;
3106 return ret;
3107 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003108
Gilles Peskine449bd832023-01-11 14:50:10 +01003109 if (*flags != 0) {
3110 return MBEDTLS_ERR_X509_CERT_VERIFY_FAILED;
3111 }
3112
3113 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003114}
3115
Hanno Becker3116fb32019-03-28 13:34:42 +00003116
3117/*
3118 * Verify the certificate validity (default profile, not restartable)
3119 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003120int mbedtls_x509_crt_verify(mbedtls_x509_crt *crt,
3121 mbedtls_x509_crt *trust_ca,
3122 mbedtls_x509_crl *ca_crl,
3123 const char *cn, uint32_t *flags,
3124 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3125 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00003126{
Gilles Peskine449bd832023-01-11 14:50:10 +01003127 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
3128 NULL, NULL,
3129 &mbedtls_x509_crt_profile_default,
3130 cn, flags,
3131 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00003132}
3133
3134/*
3135 * Verify the certificate validity (user-chosen profile, not restartable)
3136 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003137int mbedtls_x509_crt_verify_with_profile(mbedtls_x509_crt *crt,
3138 mbedtls_x509_crt *trust_ca,
3139 mbedtls_x509_crl *ca_crl,
3140 const mbedtls_x509_crt_profile *profile,
3141 const char *cn, uint32_t *flags,
3142 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3143 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00003144{
Gilles Peskine449bd832023-01-11 14:50:10 +01003145 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
3146 NULL, NULL,
3147 profile, cn, flags,
3148 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00003149}
3150
3151#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
3152/*
3153 * Verify the certificate validity (user-chosen profile, CA callback,
3154 * not restartable).
3155 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003156int mbedtls_x509_crt_verify_with_ca_cb(mbedtls_x509_crt *crt,
3157 mbedtls_x509_crt_ca_cb_t f_ca_cb,
3158 void *p_ca_cb,
3159 const mbedtls_x509_crt_profile *profile,
3160 const char *cn, uint32_t *flags,
3161 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3162 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00003163{
Gilles Peskine449bd832023-01-11 14:50:10 +01003164 return x509_crt_verify_restartable_ca_cb(crt, NULL, NULL,
3165 f_ca_cb, p_ca_cb,
3166 profile, cn, flags,
3167 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00003168}
3169#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
3170
Gilles Peskine449bd832023-01-11 14:50:10 +01003171int mbedtls_x509_crt_verify_restartable(mbedtls_x509_crt *crt,
3172 mbedtls_x509_crt *trust_ca,
3173 mbedtls_x509_crl *ca_crl,
3174 const mbedtls_x509_crt_profile *profile,
3175 const char *cn, uint32_t *flags,
3176 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3177 void *p_vrfy,
3178 mbedtls_x509_crt_restart_ctx *rs_ctx)
Hanno Becker3116fb32019-03-28 13:34:42 +00003179{
Gilles Peskine449bd832023-01-11 14:50:10 +01003180 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
3181 NULL, NULL,
3182 profile, cn, flags,
3183 f_vrfy, p_vrfy, rs_ctx);
Hanno Becker3116fb32019-03-28 13:34:42 +00003184}
3185
3186
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003187/*
Paul Bakker369d2eb2013-09-18 11:58:25 +02003188 * Initialize a certificate chain
3189 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003190void mbedtls_x509_crt_init(mbedtls_x509_crt *crt)
Paul Bakker369d2eb2013-09-18 11:58:25 +02003191{
Gilles Peskine449bd832023-01-11 14:50:10 +01003192 memset(crt, 0, sizeof(mbedtls_x509_crt));
Paul Bakker369d2eb2013-09-18 11:58:25 +02003193}
3194
3195/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003196 * Unallocate all certificate data
3197 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003198void mbedtls_x509_crt_free(mbedtls_x509_crt *crt)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003199{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003200 mbedtls_x509_crt *cert_cur = crt;
3201 mbedtls_x509_crt *cert_prv;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003202
Gilles Peskine449bd832023-01-11 14:50:10 +01003203 while (cert_cur != NULL) {
3204 mbedtls_pk_free(&cert_cur->pk);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003205
Gilles Peskine449bd832023-01-11 14:50:10 +01003206 mbedtls_asn1_free_named_data_list_shallow(cert_cur->issuer.next);
3207 mbedtls_asn1_free_named_data_list_shallow(cert_cur->subject.next);
3208 mbedtls_asn1_sequence_free(cert_cur->ext_key_usage.next);
3209 mbedtls_asn1_sequence_free(cert_cur->subject_alt_names.next);
3210 mbedtls_asn1_sequence_free(cert_cur->certificate_policies.next);
Przemek Stekiel690ff692023-05-15 09:54:02 +02003211 mbedtls_asn1_sequence_free(cert_cur->authority_key_id.authorityCertIssuer.next);
Ron Eldor74d9acc2019-03-21 14:00:03 +02003212
Gilles Peskine449bd832023-01-11 14:50:10 +01003213 if (cert_cur->raw.p != NULL && cert_cur->own_buffer) {
Tom Cosgroveca8c61b2023-07-17 15:17:40 +01003214 mbedtls_zeroize_and_free(cert_cur->raw.p, cert_cur->raw.len);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003215 }
3216
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003217 cert_prv = cert_cur;
3218 cert_cur = cert_cur->next;
3219
Gilles Peskine449bd832023-01-11 14:50:10 +01003220 mbedtls_platform_zeroize(cert_prv, sizeof(mbedtls_x509_crt));
3221 if (cert_prv != crt) {
3222 mbedtls_free(cert_prv);
3223 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003224 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003225}
3226
Valerio Settieaf57892025-05-06 17:07:09 +02003227#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003228/*
3229 * Initialize a restart context
3230 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003231void mbedtls_x509_crt_restart_init(mbedtls_x509_crt_restart_ctx *ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003232{
Gilles Peskine449bd832023-01-11 14:50:10 +01003233 mbedtls_pk_restart_init(&ctx->pk);
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003234
3235 ctx->parent = NULL;
3236 ctx->fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02003237 ctx->fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003238
3239 ctx->parent_is_trusted = -1;
3240
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02003241 ctx->in_progress = x509_crt_rs_none;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003242 ctx->self_cnt = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003243 x509_crt_verify_chain_reset(&ctx->ver_chain);
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003244}
3245
3246/*
3247 * Free the components of a restart context
3248 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003249void mbedtls_x509_crt_restart_free(mbedtls_x509_crt_restart_ctx *ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003250{
Gilles Peskine449bd832023-01-11 14:50:10 +01003251 if (ctx == NULL) {
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003252 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01003253 }
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003254
Gilles Peskine449bd832023-01-11 14:50:10 +01003255 mbedtls_pk_restart_free(&ctx->pk);
3256 mbedtls_x509_crt_restart_init(ctx);
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003257}
Valerio Settieaf57892025-05-06 17:07:09 +02003258#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003259
Minos Galanakis2abbac72024-01-18 17:05:21 +00003260int mbedtls_x509_crt_get_ca_istrue(const mbedtls_x509_crt *crt)
3261{
3262 if ((crt->ext_types & MBEDTLS_X509_EXT_BASIC_CONSTRAINTS) != 0) {
3263 return crt->MBEDTLS_PRIVATE(ca_istrue);
3264 }
3265 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
3266}
3267
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003268#endif /* MBEDTLS_X509_CRT_PARSE_C */