blob: e7a98dd622fa09117dd8c0fc798c3656df894a32 [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
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02005 * SPDX-License-Identifier: Apache-2.0
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
8 * not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
Paul Bakker7c6b2c32013-09-16 13:49:26 +020018 */
19/*
20 * The ITU-T X.509 standard defines a certificate format for PKI.
21 *
Manuel Pégourié-Gonnard1c082f32014-06-12 22:34:55 +020022 * http://www.ietf.org/rfc/rfc5280.txt (Certificates and CRLs)
23 * http://www.ietf.org/rfc/rfc3279.txt (Alg IDs for CRLs)
24 * http://www.ietf.org/rfc/rfc2986.txt (CSRs, aka PKCS#10)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020025 *
26 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.680-0207.pdf
27 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +020028 *
29 * [SIRO] https://cabforum.org/wp-content/uploads/Chunghwatelecom201503cabforumV4.pdf
Paul Bakker7c6b2c32013-09-16 13:49:26 +020030 */
31
Gilles Peskinedb09ef62020-06-03 01:43:33 +020032#include "common.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020033
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020034#if defined(MBEDTLS_X509_CRT_PARSE_C)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020035
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000036#include "mbedtls/x509_crt.h"
Janos Follath73c616b2019-12-18 15:07:04 +000037#include "mbedtls/error.h"
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000038#include "mbedtls/oid.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050039#include "mbedtls/platform_util.h"
Rich Evans00ab4702015-02-06 13:43:58 +000040
Rich Evans00ab4702015-02-06 13:43:58 +000041#include <string.h>
42
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020043#if defined(MBEDTLS_PEM_PARSE_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000044#include "mbedtls/pem.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020045#endif
46
Andrzej Kurekd4a65532018-10-31 06:18:39 -040047#if defined(MBEDTLS_USE_PSA_CRYPTO)
48#include "psa/crypto.h"
49#include "mbedtls/psa_util.h"
pespacek7599a772022-02-07 14:40:55 +010050#endif /* MBEDTLS_USE_PSA_CRYPTO */
Przemek Stekiel40afdd22022-09-06 13:08:28 +020051#include "hash_info.h"
Andrzej Kurekd4a65532018-10-31 06:18:39 -040052
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000053#include "mbedtls/platform.h"
Paul Bakker7c6b2c32013-09-16 13:49:26 +020054
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020055#if defined(MBEDTLS_THREADING_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000056#include "mbedtls/threading.h"
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +010057#endif
58
Daniel Axtensf0710242020-05-28 11:43:41 +100059#if defined(MBEDTLS_HAVE_TIME)
Paul Bakkerfa6a6202013-10-28 18:48:30 +010060#if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020061#include <windows.h>
62#else
63#include <time.h>
64#endif
Daniel Axtensf0710242020-05-28 11:43:41 +100065#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +020066
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020067#if defined(MBEDTLS_FS_IO)
Rich Evans00ab4702015-02-06 13:43:58 +000068#include <stdio.h>
Paul Bakker5ff3f912014-04-04 15:08:20 +020069#if !defined(_WIN32) || defined(EFIX64) || defined(EFI32)
Paul Bakker7c6b2c32013-09-16 13:49:26 +020070#include <sys/types.h>
71#include <sys/stat.h>
Martino Facchin0ec05ec2021-05-04 11:47:36 +020072#if defined(__MBED__)
73#include <platform/mbed_retarget.h>
74#else
Paul Bakker7c6b2c32013-09-16 13:49:26 +020075#include <dirent.h>
Martino Facchin0ec05ec2021-05-04 11:47:36 +020076#endif /* __MBED__ */
Eduardo Silvae1bfffc2019-04-25 10:43:26 -060077#include <errno.h>
Rich Evans00ab4702015-02-06 13:43:58 +000078#endif /* !_WIN32 || EFIX64 || EFI32 */
Paul Bakker7c6b2c32013-09-16 13:49:26 +020079#endif
80
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +020081/*
82 * Item in a verification chain: cert and flags for it
83 */
84typedef struct {
85 mbedtls_x509_crt *crt;
86 uint32_t flags;
87} x509_crt_verify_chain_item;
88
89/*
90 * Max size of verification chain: end-entity + intermediates + trusted root
91 */
Gilles Peskine449bd832023-01-11 14:50:10 +010092#define X509_MAX_VERIFY_CHAIN_SIZE (MBEDTLS_X509_MAX_INTERMEDIATE_CA + 2)
Paul Bakker34617722014-06-13 17:20:13 +020093
Gilles Peskineffb92da2021-06-02 00:03:26 +020094/* Default profile. Do not remove items unless there are serious security
95 * concerns. */
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +020096const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_default =
97{
Gilles Peskineae270bf2021-06-02 00:05:29 +020098 /* Hashes from SHA-256 and above. Note that this selection
99 * should be aligned with ssl_preset_default_hashes in ssl_tls.c. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100100 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
101 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384) |
102 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA512),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200103 0xFFFFFFF, /* Any PK alg */
104#if defined(MBEDTLS_ECP_C)
Gilles Peskineae270bf2021-06-02 00:05:29 +0200105 /* Curves at or above 128-bit security level. Note that this selection
106 * should be aligned with ssl_preset_default_curves in ssl_tls.c. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100107 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
108 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1) |
109 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP521R1) |
110 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP256R1) |
111 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP384R1) |
112 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP512R1) |
Gilles Peskine39957502021-06-17 23:17:52 +0200113 0,
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200114#else
115 0,
116#endif
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200117 2048,
118};
119
Gilles Peskineffb92da2021-06-02 00:03:26 +0200120/* Next-generation profile. Currently identical to the default, but may
121 * be tightened at any time. */
122const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_next =
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200123{
124 /* Hashes from SHA-256 and above. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100125 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
126 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384) |
127 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA512),
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200128 0xFFFFFFF, /* Any PK alg */
129#if defined(MBEDTLS_ECP_C)
130 /* Curves at or above 128-bit security level. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100131 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
132 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1) |
133 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP521R1) |
134 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP256R1) |
135 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP384R1) |
136 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_BP512R1) |
137 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256K1),
Gilles Peskine2c69fa22021-06-02 00:33:33 +0200138#else
139 0,
140#endif
141 2048,
142};
Gilles Peskineffb92da2021-06-02 00:03:26 +0200143
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200144/*
145 * NSA Suite B Profile
146 */
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200147const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_suiteb =
148{
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200149 /* Only SHA-256 and 384 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100150 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA256) |
151 MBEDTLS_X509_ID_FLAG(MBEDTLS_MD_SHA384),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200152 /* Only ECDSA */
Gilles Peskine449bd832023-01-11 14:50:10 +0100153 MBEDTLS_X509_ID_FLAG(MBEDTLS_PK_ECDSA) |
154 MBEDTLS_X509_ID_FLAG(MBEDTLS_PK_ECKEY),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200155#if defined(MBEDTLS_ECP_C)
156 /* Only NIST P-256 and P-384 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100157 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP256R1) |
158 MBEDTLS_X509_ID_FLAG(MBEDTLS_ECP_DP_SECP384R1),
Manuel Pégourié-Gonnardf8ea8562015-06-15 15:33:19 +0200159#else
160 0,
161#endif
162 0,
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200163};
164
165/*
Manuel Pégourié-Gonnard9d4c2c42021-06-18 09:48:27 +0200166 * Empty / all-forbidden profile
167 */
168const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_none =
169{
170 0,
171 0,
172 0,
173 (uint32_t) -1,
174};
175
176/*
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200177 * Check md_alg against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200178 * Return 0 if md_alg is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200179 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100180static int x509_profile_check_md_alg(const mbedtls_x509_crt_profile *profile,
181 mbedtls_md_type_t md_alg)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200182{
Gilles Peskine449bd832023-01-11 14:50:10 +0100183 if (md_alg == MBEDTLS_MD_NONE) {
184 return -1;
185 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200186
Gilles Peskine449bd832023-01-11 14:50:10 +0100187 if ((profile->allowed_mds & MBEDTLS_X509_ID_FLAG(md_alg)) != 0) {
188 return 0;
189 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200190
Gilles Peskine449bd832023-01-11 14:50:10 +0100191 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200192}
193
194/*
195 * Check pk_alg against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200196 * Return 0 if pk_alg is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200197 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100198static int x509_profile_check_pk_alg(const mbedtls_x509_crt_profile *profile,
199 mbedtls_pk_type_t pk_alg)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200200{
Gilles Peskine449bd832023-01-11 14:50:10 +0100201 if (pk_alg == MBEDTLS_PK_NONE) {
202 return -1;
203 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200204
Gilles Peskine449bd832023-01-11 14:50:10 +0100205 if ((profile->allowed_pks & MBEDTLS_X509_ID_FLAG(pk_alg)) != 0) {
206 return 0;
207 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200208
Gilles Peskine449bd832023-01-11 14:50:10 +0100209 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200210}
211
212/*
213 * Check key against profile
Manuel Pégourié-Gonnard3f816912017-10-26 10:24:16 +0200214 * Return 0 if pk is acceptable for this profile, -1 otherwise
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200215 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100216static int x509_profile_check_key(const mbedtls_x509_crt_profile *profile,
217 const mbedtls_pk_context *pk)
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200218{
Gilles Peskine449bd832023-01-11 14:50:10 +0100219 const mbedtls_pk_type_t pk_alg = mbedtls_pk_get_type(pk);
Manuel Pégourié-Gonnard19773ff2017-10-24 10:51:26 +0200220
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200221#if defined(MBEDTLS_RSA_C)
Gilles Peskine449bd832023-01-11 14:50:10 +0100222 if (pk_alg == MBEDTLS_PK_RSA || pk_alg == MBEDTLS_PK_RSASSA_PSS) {
223 if (mbedtls_pk_get_bitlen(pk) >= profile->rsa_min_bitlen) {
224 return 0;
225 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200226
Gilles Peskine449bd832023-01-11 14:50:10 +0100227 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200228 }
229#endif
230
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +0200231#if defined(MBEDTLS_ECP_C)
Gilles Peskine449bd832023-01-11 14:50:10 +0100232 if (pk_alg == MBEDTLS_PK_ECDSA ||
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +0200233 pk_alg == MBEDTLS_PK_ECKEY ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100234 pk_alg == MBEDTLS_PK_ECKEY_DH) {
235 const mbedtls_ecp_group_id gid = mbedtls_pk_ec(*pk)->grp.id;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200236
Gilles Peskine449bd832023-01-11 14:50:10 +0100237 if (gid == MBEDTLS_ECP_DP_NONE) {
238 return -1;
239 }
Philippe Antoineb5b25432018-05-11 11:06:29 +0200240
Gilles Peskine449bd832023-01-11 14:50:10 +0100241 if ((profile->allowed_curves & MBEDTLS_X509_ID_FLAG(gid)) != 0) {
242 return 0;
243 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200244
Gilles Peskine449bd832023-01-11 14:50:10 +0100245 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200246 }
247#endif
248
Gilles Peskine449bd832023-01-11 14:50:10 +0100249 return -1;
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +0200250}
251
252/*
Hanno Becker1f8527f2018-11-02 09:19:16 +0000253 * Like memcmp, but case-insensitive and always returns -1 if different
254 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100255static int x509_memcasecmp(const void *s1, const void *s2, size_t len)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000256{
257 size_t i;
258 unsigned char diff;
259 const unsigned char *n1 = s1, *n2 = s2;
260
Gilles Peskine449bd832023-01-11 14:50:10 +0100261 for (i = 0; i < len; i++) {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000262 diff = n1[i] ^ n2[i];
263
Gilles Peskine449bd832023-01-11 14:50:10 +0100264 if (diff == 0) {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000265 continue;
266 }
267
Gilles Peskine449bd832023-01-11 14:50:10 +0100268 if (diff == 32 &&
269 ((n1[i] >= 'a' && n1[i] <= 'z') ||
270 (n1[i] >= 'A' && n1[i] <= 'Z'))) {
271 continue;
272 }
273
274 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000275 }
276
Gilles Peskine449bd832023-01-11 14:50:10 +0100277 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000278}
279
280/*
281 * Return 0 if name matches wildcard, -1 otherwise
282 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100283static int x509_check_wildcard(const char *cn, const mbedtls_x509_buf *name)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000284{
285 size_t i;
Gilles Peskine449bd832023-01-11 14:50:10 +0100286 size_t cn_idx = 0, cn_len = strlen(cn);
Hanno Becker1f8527f2018-11-02 09:19:16 +0000287
288 /* We can't have a match if there is no wildcard to match */
Gilles Peskine449bd832023-01-11 14:50:10 +0100289 if (name->len < 3 || name->p[0] != '*' || name->p[1] != '.') {
290 return -1;
291 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000292
Gilles Peskine449bd832023-01-11 14:50:10 +0100293 for (i = 0; i < cn_len; ++i) {
294 if (cn[i] == '.') {
Hanno Becker1f8527f2018-11-02 09:19:16 +0000295 cn_idx = i;
296 break;
297 }
298 }
299
Gilles Peskine449bd832023-01-11 14:50:10 +0100300 if (cn_idx == 0) {
301 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000302 }
303
Gilles Peskine449bd832023-01-11 14:50:10 +0100304 if (cn_len - cn_idx == name->len - 1 &&
305 x509_memcasecmp(name->p + 1, cn + cn_idx, name->len - 1) == 0) {
306 return 0;
307 }
308
309 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000310}
311
312/*
313 * Compare two X.509 strings, case-insensitive, and allowing for some encoding
314 * variations (but not all).
315 *
316 * Return 0 if equal, -1 otherwise.
317 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100318static int x509_string_cmp(const mbedtls_x509_buf *a, const mbedtls_x509_buf *b)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000319{
Gilles Peskine449bd832023-01-11 14:50:10 +0100320 if (a->tag == b->tag &&
Hanno Becker1f8527f2018-11-02 09:19:16 +0000321 a->len == b->len &&
Gilles Peskine449bd832023-01-11 14:50:10 +0100322 memcmp(a->p, b->p, b->len) == 0) {
323 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000324 }
325
Gilles Peskine449bd832023-01-11 14:50:10 +0100326 if ((a->tag == MBEDTLS_ASN1_UTF8_STRING || a->tag == MBEDTLS_ASN1_PRINTABLE_STRING) &&
327 (b->tag == MBEDTLS_ASN1_UTF8_STRING || b->tag == MBEDTLS_ASN1_PRINTABLE_STRING) &&
Hanno Becker1f8527f2018-11-02 09:19:16 +0000328 a->len == b->len &&
Gilles Peskine449bd832023-01-11 14:50:10 +0100329 x509_memcasecmp(a->p, b->p, b->len) == 0) {
330 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000331 }
332
Gilles Peskine449bd832023-01-11 14:50:10 +0100333 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000334}
335
336/*
337 * Compare two X.509 Names (aka rdnSequence).
338 *
339 * See RFC 5280 section 7.1, though we don't implement the whole algorithm:
340 * we sometimes return unequal when the full algorithm would return equal,
341 * but never the other way. (In particular, we don't do Unicode normalisation
342 * or space folding.)
343 *
344 * Return 0 if equal, -1 otherwise.
345 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100346static int x509_name_cmp(const mbedtls_x509_name *a, const mbedtls_x509_name *b)
Hanno Becker1f8527f2018-11-02 09:19:16 +0000347{
348 /* Avoid recursion, it might not be optimised by the compiler */
Gilles Peskine449bd832023-01-11 14:50:10 +0100349 while (a != NULL || b != NULL) {
350 if (a == NULL || b == NULL) {
351 return -1;
352 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000353
354 /* type */
Gilles Peskine449bd832023-01-11 14:50:10 +0100355 if (a->oid.tag != b->oid.tag ||
Hanno Becker1f8527f2018-11-02 09:19:16 +0000356 a->oid.len != b->oid.len ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100357 memcmp(a->oid.p, b->oid.p, b->oid.len) != 0) {
358 return -1;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000359 }
360
361 /* value */
Gilles Peskine449bd832023-01-11 14:50:10 +0100362 if (x509_string_cmp(&a->val, &b->val) != 0) {
363 return -1;
364 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000365
366 /* structure of the list of sets */
Gilles Peskine449bd832023-01-11 14:50:10 +0100367 if (a->next_merged != b->next_merged) {
368 return -1;
369 }
Hanno Becker1f8527f2018-11-02 09:19:16 +0000370
371 a = a->next;
372 b = b->next;
373 }
374
375 /* a == NULL == b */
Gilles Peskine449bd832023-01-11 14:50:10 +0100376 return 0;
Hanno Becker1f8527f2018-11-02 09:19:16 +0000377}
378
379/*
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200380 * Reset (init or clear) a verify_chain
381 */
382static void x509_crt_verify_chain_reset(
Gilles Peskine449bd832023-01-11 14:50:10 +0100383 mbedtls_x509_crt_verify_chain *ver_chain)
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200384{
385 size_t i;
386
Gilles Peskine449bd832023-01-11 14:50:10 +0100387 for (i = 0; i < MBEDTLS_X509_MAX_VERIFY_CHAIN_SIZE; i++) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200388 ver_chain->items[i].crt = NULL;
Hanno Beckera9375b32019-01-10 09:19:26 +0000389 ver_chain->items[i].flags = (uint32_t) -1;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200390 }
391
392 ver_chain->len = 0;
Hanno Beckerf53893b2019-03-28 13:45:55 +0000393
394#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
395 ver_chain->trust_ca_cb_result = NULL;
396#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +0200397}
398
399/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200400 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
401 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100402static int x509_get_version(unsigned char **p,
403 const unsigned char *end,
404 int *ver)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200405{
Janos Follath865b3eb2019-12-16 11:46:15 +0000406 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200407 size_t len;
408
Gilles Peskine449bd832023-01-11 14:50:10 +0100409 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
410 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
411 0)) != 0) {
412 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200413 *ver = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +0100414 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200415 }
416
Gilles Peskine449bd832023-01-11 14:50:10 +0100417 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200418 }
419
420 end = *p + len;
421
Gilles Peskine449bd832023-01-11 14:50:10 +0100422 if ((ret = mbedtls_asn1_get_int(p, end, ver)) != 0) {
423 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_VERSION, ret);
424 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200425
Gilles Peskine449bd832023-01-11 14:50:10 +0100426 if (*p != end) {
427 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_VERSION,
428 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
429 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200430
Gilles Peskine449bd832023-01-11 14:50:10 +0100431 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200432}
433
434/*
435 * Validity ::= SEQUENCE {
436 * notBefore Time,
437 * notAfter Time }
438 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100439static int x509_get_dates(unsigned char **p,
440 const unsigned char *end,
441 mbedtls_x509_time *from,
442 mbedtls_x509_time *to)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200443{
Janos Follath865b3eb2019-12-16 11:46:15 +0000444 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200445 size_t len;
446
Gilles Peskine449bd832023-01-11 14:50:10 +0100447 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
448 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
449 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_DATE, ret);
450 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200451
452 end = *p + len;
453
Gilles Peskine449bd832023-01-11 14:50:10 +0100454 if ((ret = mbedtls_x509_get_time(p, end, from)) != 0) {
455 return ret;
456 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200457
Gilles Peskine449bd832023-01-11 14:50:10 +0100458 if ((ret = mbedtls_x509_get_time(p, end, to)) != 0) {
459 return ret;
460 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200461
Gilles Peskine449bd832023-01-11 14:50:10 +0100462 if (*p != end) {
463 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_DATE,
464 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
465 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200466
Gilles Peskine449bd832023-01-11 14:50:10 +0100467 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200468}
469
470/*
471 * X.509 v2/v3 unique identifier (not parsed)
472 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100473static int x509_get_uid(unsigned char **p,
474 const unsigned char *end,
475 mbedtls_x509_buf *uid, int n)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200476{
Janos Follath865b3eb2019-12-16 11:46:15 +0000477 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200478
Gilles Peskine449bd832023-01-11 14:50:10 +0100479 if (*p == end) {
480 return 0;
481 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200482
483 uid->tag = **p;
484
Gilles Peskine449bd832023-01-11 14:50:10 +0100485 if ((ret = mbedtls_asn1_get_tag(p, end, &uid->len,
486 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
487 n)) != 0) {
488 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
489 return 0;
490 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200491
Gilles Peskine449bd832023-01-11 14:50:10 +0100492 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200493 }
494
495 uid->p = *p;
496 *p += uid->len;
497
Gilles Peskine449bd832023-01-11 14:50:10 +0100498 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200499}
500
Gilles Peskine449bd832023-01-11 14:50:10 +0100501static int x509_get_basic_constraints(unsigned char **p,
502 const unsigned char *end,
503 int *ca_istrue,
504 int *max_pathlen)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200505{
Janos Follath865b3eb2019-12-16 11:46:15 +0000506 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200507 size_t len;
508
509 /*
510 * BasicConstraints ::= SEQUENCE {
511 * cA BOOLEAN DEFAULT FALSE,
512 * pathLenConstraint INTEGER (0..MAX) OPTIONAL }
513 */
514 *ca_istrue = 0; /* DEFAULT FALSE */
515 *max_pathlen = 0; /* endless */
516
Gilles Peskine449bd832023-01-11 14:50:10 +0100517 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
518 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
519 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200520 }
521
Gilles Peskine449bd832023-01-11 14:50:10 +0100522 if (*p == end) {
523 return 0;
524 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200525
Gilles Peskine449bd832023-01-11 14:50:10 +0100526 if ((ret = mbedtls_asn1_get_bool(p, end, ca_istrue)) != 0) {
527 if (ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG) {
528 ret = mbedtls_asn1_get_int(p, end, ca_istrue);
529 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200530
Gilles Peskine449bd832023-01-11 14:50:10 +0100531 if (ret != 0) {
532 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
533 }
534
535 if (*ca_istrue != 0) {
536 *ca_istrue = 1;
537 }
538 }
539
540 if (*p == end) {
541 return 0;
542 }
543
544 if ((ret = mbedtls_asn1_get_int(p, end, max_pathlen)) != 0) {
545 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
546 }
547
548 if (*p != end) {
549 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
550 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
551 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200552
Andrzej Kurek16050742020-04-14 09:49:52 -0400553 /* Do not accept max_pathlen equal to INT_MAX to avoid a signed integer
554 * overflow, which is an undefined behavior. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100555 if (*max_pathlen == INT_MAX) {
556 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
557 MBEDTLS_ERR_ASN1_INVALID_LENGTH);
558 }
Andrzej Kurek16050742020-04-14 09:49:52 -0400559
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200560 (*max_pathlen)++;
561
Gilles Peskine449bd832023-01-11 14:50:10 +0100562 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200563}
564
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200565/*
566 * ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
567 *
568 * KeyPurposeId ::= OBJECT IDENTIFIER
569 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100570static int x509_get_ext_key_usage(unsigned char **p,
571 const unsigned char *end,
572 mbedtls_x509_sequence *ext_key_usage)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200573{
Janos Follath865b3eb2019-12-16 11:46:15 +0000574 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200575
Gilles Peskine449bd832023-01-11 14:50:10 +0100576 if ((ret = mbedtls_asn1_get_sequence_of(p, end, ext_key_usage, MBEDTLS_ASN1_OID)) != 0) {
577 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
578 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200579
580 /* Sequence length must be >= 1 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100581 if (ext_key_usage->buf.p == NULL) {
582 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
583 MBEDTLS_ERR_ASN1_INVALID_LENGTH);
584 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200585
Gilles Peskine449bd832023-01-11 14:50:10 +0100586 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200587}
588
589/*
toth92ga41954d2021-02-12 16:11:17 +0100590 * SubjectKeyIdentifier ::= KeyIdentifier
591 *
592 * KeyIdentifier ::= OCTET STRING
593 */
594static int x509_get_subject_key_id(unsigned char **p,
595 const unsigned char *end,
596 mbedtls_x509_buf *subject_key_id)
597{
598 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
599 size_t len = 0u;
600
601 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
602 MBEDTLS_ASN1_OCTET_STRING)) != 0) {
603 return ret;
604 } else {
605 subject_key_id->len = len;
606 subject_key_id->tag = MBEDTLS_ASN1_OCTET_STRING;
607 subject_key_id->p = *p;
608 *p += len;
609 }
610
611 return 0;
612}
613
614/*
615 * AuthorityKeyIdentifier ::= SEQUENCE {
616 * keyIdentifier [0] KeyIdentifier OPTIONAL,
617 * authorityCertIssuer [1] GeneralNames OPTIONAL,
618 * authorityCertSerialNumber [2] CertificateSerialNumber OPTIONAL }
619 *
620 * KeyIdentifier ::= OCTET STRING
621 */
622static int x509_get_authority_key_id(unsigned char **p,
623 unsigned char *end,
624 mbedtls_x509_authority *authority_key_id)
625{
626 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
627 size_t len = 0u;
628
629 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
630 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
631 return ret;
632 }
633
634 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
635 MBEDTLS_ASN1_CONTEXT_SPECIFIC)) != 0) {
636 /* KeyIdentifier is an OPTIONAL field */
637 } else {
638 authority_key_id->keyIdentifier.len = len;
639 authority_key_id->keyIdentifier.p = *p;
640 authority_key_id->keyIdentifier.tag = MBEDTLS_ASN1_OCTET_STRING;
641
642 *p += len;
643 }
644
645 if (*p < end) {
646 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
647 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED |
648 MBEDTLS_ASN1_BOOLEAN)) != 0) {
649 /* authorityCertIssuer is an OPTIONAL field */
650 } else {
651 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
652 MBEDTLS_ASN1_CONTEXT_SPECIFIC |
653 MBEDTLS_ASN1_CONSTRUCTED |
654 MBEDTLS_ASN1_OCTET_STRING)) != 0) {
655 return ret;
656 } else {
657 authority_key_id->raw.p = *p;
658
659 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
660 MBEDTLS_ASN1_CONSTRUCTED |
661 MBEDTLS_ASN1_SEQUENCE)) != 0) {
662 return ret;
663 }
664
665 if ((ret =
666 mbedtls_x509_get_name(p, *p + len,
667 &authority_key_id->authorityCertIssuer)) != 0) {
668 return ret;
669 }
670
671 authority_key_id->raw.len = *p - authority_key_id->raw.p;
672 }
673 }
674 }
675
676 if (*p < end) {
677 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
678 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_INTEGER)) !=
679 0) {
680 /* authorityCertSerialNumber is an OPTIONAL field, but if there are still data it must be the serial number */
681 return ret;
682 } else {
683 authority_key_id->authorityCertSerialNumber.len = len;
684 authority_key_id->authorityCertSerialNumber.p = *p;
685 authority_key_id->authorityCertSerialNumber.tag = MBEDTLS_ASN1_OCTET_STRING;
686 *p += len;
687 }
688 }
689
690 if (*p != end) {
691 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
692 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH;
693 }
694
695 return 0;
696}
697
698/*
699 * SubjectAltName ::= GeneralNames
700 *
701 * GeneralNames ::= SEQUENCE SIZE (1..MAX) OF GeneralName
702 *
703 * GeneralName ::= CHOICE {
704 * otherName [0] OtherName,
705 * rfc822Name [1] IA5String,
706 * dNSName [2] IA5String,
707 * x400Address [3] ORAddress,
708 * directoryName [4] Name,
709 * ediPartyName [5] EDIPartyName,
710 * uniformResourceIdentifier [6] IA5String,
711 * iPAddress [7] OCTET STRING,
712 * registeredID [8] OBJECT IDENTIFIER }
713 *
714 * OtherName ::= SEQUENCE {
715 * type-id OBJECT IDENTIFIER,
716 * value [0] EXPLICIT ANY DEFINED BY type-id }
717 *
718 * EDIPartyName ::= SEQUENCE {
719 * nameAssigner [0] DirectoryString OPTIONAL,
720 * partyName [1] DirectoryString }
721 *
722 * NOTE: we list all types, but only use dNSName and otherName
723 * of type HwModuleName, as defined in RFC 4108, at this point.
724 */
725static int x509_get_subject_alt_name(unsigned char **p,
726 const unsigned char *end,
727 mbedtls_x509_sequence *subject_alt_name)
728{
729 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
730 size_t len, tag_len;
731 mbedtls_asn1_buf *buf;
732 unsigned char tag;
733 mbedtls_asn1_sequence *cur = subject_alt_name;
734
735 /* Get main sequence tag */
736 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
737 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
738 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
739 }
740
741 if (*p + len != end) {
742 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
743 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
744 }
745
746 while (*p < end) {
747 mbedtls_x509_subject_alternative_name dummy_san_buf;
748 memset(&dummy_san_buf, 0, sizeof(dummy_san_buf));
749
750 tag = **p;
751 (*p)++;
752 if ((ret = mbedtls_asn1_get_len(p, end, &tag_len)) != 0) {
753 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
754 }
755
756 if ((tag & MBEDTLS_ASN1_TAG_CLASS_MASK) !=
757 MBEDTLS_ASN1_CONTEXT_SPECIFIC) {
758 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
759 MBEDTLS_ERR_ASN1_UNEXPECTED_TAG);
760 }
761
762 /*
763 * Check that the SAN is structured correctly.
764 */
765 ret = mbedtls_x509_parse_subject_alt_name(&(cur->buf), &dummy_san_buf);
766 /*
767 * In case the extension is malformed, return an error,
768 * and clear the allocated sequences.
769 */
770 if (ret != 0 && ret != MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE) {
771 mbedtls_asn1_sequence_free(subject_alt_name->next);
772 subject_alt_name->next = NULL;
773 return ret;
774 }
775
776 /* Allocate and assign next pointer */
777 if (cur->buf.p != NULL) {
778 if (cur->next != NULL) {
779 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
780 }
781
782 cur->next = mbedtls_calloc(1, sizeof(mbedtls_asn1_sequence));
783
784 if (cur->next == NULL) {
785 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
786 MBEDTLS_ERR_ASN1_ALLOC_FAILED);
787 }
788
789 cur = cur->next;
790 }
791
792 buf = &(cur->buf);
793 buf->tag = tag;
794 buf->p = *p;
795 buf->len = tag_len;
796 *p += buf->len;
797 }
798
799 /* Set final sequence entry's next pointer to NULL */
800 cur->next = NULL;
801
802 if (*p != end) {
803 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
804 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
805 }
806
807 return 0;
808}
809
810/*
Ron Eldor74d9acc2019-03-21 14:00:03 +0200811 * id-ce-certificatePolicies OBJECT IDENTIFIER ::= { id-ce 32 }
812 *
813 * anyPolicy OBJECT IDENTIFIER ::= { id-ce-certificatePolicies 0 }
814 *
815 * certificatePolicies ::= SEQUENCE SIZE (1..MAX) OF PolicyInformation
816 *
817 * PolicyInformation ::= SEQUENCE {
818 * policyIdentifier CertPolicyId,
819 * policyQualifiers SEQUENCE SIZE (1..MAX) OF
820 * PolicyQualifierInfo OPTIONAL }
821 *
822 * CertPolicyId ::= OBJECT IDENTIFIER
823 *
824 * PolicyQualifierInfo ::= SEQUENCE {
825 * policyQualifierId PolicyQualifierId,
826 * qualifier ANY DEFINED BY policyQualifierId }
827 *
828 * -- policyQualifierIds for Internet policy qualifiers
829 *
830 * id-qt OBJECT IDENTIFIER ::= { id-pkix 2 }
831 * id-qt-cps OBJECT IDENTIFIER ::= { id-qt 1 }
832 * id-qt-unotice OBJECT IDENTIFIER ::= { id-qt 2 }
833 *
834 * PolicyQualifierId ::= OBJECT IDENTIFIER ( id-qt-cps | id-qt-unotice )
835 *
836 * Qualifier ::= CHOICE {
837 * cPSuri CPSuri,
838 * userNotice UserNotice }
839 *
840 * CPSuri ::= IA5String
841 *
842 * UserNotice ::= SEQUENCE {
843 * noticeRef NoticeReference OPTIONAL,
844 * explicitText DisplayText OPTIONAL }
845 *
846 * NoticeReference ::= SEQUENCE {
847 * organization DisplayText,
848 * noticeNumbers SEQUENCE OF INTEGER }
849 *
850 * DisplayText ::= CHOICE {
851 * ia5String IA5String (SIZE (1..200)),
852 * visibleString VisibleString (SIZE (1..200)),
853 * bmpString BMPString (SIZE (1..200)),
854 * utf8String UTF8String (SIZE (1..200)) }
855 *
856 * NOTE: we only parse and use anyPolicy without qualifiers at this point
857 * as defined in RFC 5280.
858 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100859static int x509_get_certificate_policies(unsigned char **p,
860 const unsigned char *end,
861 mbedtls_x509_sequence *certificate_policies)
Ron Eldor74d9acc2019-03-21 14:00:03 +0200862{
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300863 int ret, parse_ret = 0;
Ron Eldor74d9acc2019-03-21 14:00:03 +0200864 size_t len;
865 mbedtls_asn1_buf *buf;
866 mbedtls_asn1_sequence *cur = certificate_policies;
867
868 /* Get main sequence tag */
Gilles Peskine449bd832023-01-11 14:50:10 +0100869 ret = mbedtls_asn1_get_tag(p, end, &len,
870 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE);
871 if (ret != 0) {
872 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
873 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200874
Gilles Peskine449bd832023-01-11 14:50:10 +0100875 if (*p + len != end) {
876 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
877 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
878 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200879
880 /*
881 * Cannot be an empty sequence.
882 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100883 if (len == 0) {
884 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
885 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
886 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200887
Gilles Peskine449bd832023-01-11 14:50:10 +0100888 while (*p < end) {
Ron Eldor74d9acc2019-03-21 14:00:03 +0200889 mbedtls_x509_buf policy_oid;
890 const unsigned char *policy_end;
891
892 /*
893 * Get the policy sequence
894 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100895 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
896 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
897 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
898 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200899
900 policy_end = *p + len;
901
Gilles Peskine449bd832023-01-11 14:50:10 +0100902 if ((ret = mbedtls_asn1_get_tag(p, policy_end, &len,
903 MBEDTLS_ASN1_OID)) != 0) {
904 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
905 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200906
907 policy_oid.tag = MBEDTLS_ASN1_OID;
908 policy_oid.len = len;
909 policy_oid.p = *p;
910
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300911 /*
912 * Only AnyPolicy is currently supported when enforcing policy.
913 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100914 if (MBEDTLS_OID_CMP(MBEDTLS_OID_ANY_POLICY, &policy_oid) != 0) {
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300915 /*
916 * Set the parsing return code but continue parsing, in case this
TRodziewicz3ecb92e2021-05-11 18:22:05 +0200917 * extension is critical.
Ron Eldor8b0c3c92019-05-15 12:20:00 +0300918 */
919 parse_ret = MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE;
920 }
921
Ron Eldor74d9acc2019-03-21 14:00:03 +0200922 /* Allocate and assign next pointer */
Gilles Peskine449bd832023-01-11 14:50:10 +0100923 if (cur->buf.p != NULL) {
924 if (cur->next != NULL) {
925 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
926 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200927
Gilles Peskine449bd832023-01-11 14:50:10 +0100928 cur->next = mbedtls_calloc(1, sizeof(mbedtls_asn1_sequence));
Ron Eldor74d9acc2019-03-21 14:00:03 +0200929
Gilles Peskine449bd832023-01-11 14:50:10 +0100930 if (cur->next == NULL) {
931 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
932 MBEDTLS_ERR_ASN1_ALLOC_FAILED);
933 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200934
935 cur = cur->next;
936 }
937
Gilles Peskine449bd832023-01-11 14:50:10 +0100938 buf = &(cur->buf);
Ron Eldor74d9acc2019-03-21 14:00:03 +0200939 buf->tag = policy_oid.tag;
940 buf->p = policy_oid.p;
941 buf->len = policy_oid.len;
Ron Eldor08063792019-05-13 16:38:39 +0300942
943 *p += len;
944
Gilles Peskine449bd832023-01-11 14:50:10 +0100945 /*
946 * If there is an optional qualifier, then *p < policy_end
947 * Check the Qualifier len to verify it doesn't exceed policy_end.
948 */
949 if (*p < policy_end) {
950 if ((ret = mbedtls_asn1_get_tag(p, policy_end, &len,
951 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) !=
952 0) {
953 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
954 }
Ron Eldor08063792019-05-13 16:38:39 +0300955 /*
956 * Skip the optional policy qualifiers.
957 */
958 *p += len;
959 }
960
Gilles Peskine449bd832023-01-11 14:50:10 +0100961 if (*p != policy_end) {
962 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
963 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
964 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200965 }
966
967 /* Set final sequence entry's next pointer to NULL */
968 cur->next = NULL;
969
Gilles Peskine449bd832023-01-11 14:50:10 +0100970 if (*p != end) {
971 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
972 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
973 }
Ron Eldor74d9acc2019-03-21 14:00:03 +0200974
Gilles Peskine449bd832023-01-11 14:50:10 +0100975 return parse_ret;
Ron Eldor74d9acc2019-03-21 14:00:03 +0200976}
977
978/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200979 * X.509 v3 extensions
980 *
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200981 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100982static int x509_get_crt_ext(unsigned char **p,
983 const unsigned char *end,
984 mbedtls_x509_crt *crt,
985 mbedtls_x509_crt_ext_cb_t cb,
986 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200987{
Janos Follath865b3eb2019-12-16 11:46:15 +0000988 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200989 size_t len;
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +0200990 unsigned char *end_ext_data, *start_ext_octet, *end_ext_octet;
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200991
Gilles Peskine449bd832023-01-11 14:50:10 +0100992 if (*p == end) {
993 return 0;
994 }
Hanno Becker12f62fb2019-02-12 17:22:36 +0000995
Gilles Peskine449bd832023-01-11 14:50:10 +0100996 if ((ret = mbedtls_x509_get_ext(p, end, &crt->v3_ext, 3)) != 0) {
997 return ret;
998 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +0200999
Hanno Becker12f62fb2019-02-12 17:22:36 +00001000 end = crt->v3_ext.p + crt->v3_ext.len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001001 while (*p < end) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001002 /*
1003 * Extension ::= SEQUENCE {
1004 * extnID OBJECT IDENTIFIER,
1005 * critical BOOLEAN DEFAULT FALSE,
1006 * extnValue OCTET STRING }
1007 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001008 mbedtls_x509_buf extn_oid = { 0, 0, NULL };
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001009 int is_critical = 0; /* DEFAULT FALSE */
1010 int ext_type = 0;
1011
Gilles Peskine449bd832023-01-11 14:50:10 +01001012 if ((ret = mbedtls_asn1_get_tag(p, end, &len,
1013 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1014 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
1015 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001016
1017 end_ext_data = *p + len;
1018
1019 /* Get extension ID */
Gilles Peskine449bd832023-01-11 14:50:10 +01001020 if ((ret = mbedtls_asn1_get_tag(p, end_ext_data, &extn_oid.len,
1021 MBEDTLS_ASN1_OID)) != 0) {
1022 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
1023 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001024
k-stachowiak463928a2018-07-24 12:50:59 +02001025 extn_oid.tag = MBEDTLS_ASN1_OID;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001026 extn_oid.p = *p;
1027 *p += extn_oid.len;
1028
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001029 /* Get optional critical */
Gilles Peskine449bd832023-01-11 14:50:10 +01001030 if ((ret = mbedtls_asn1_get_bool(p, end_ext_data, &is_critical)) != 0 &&
1031 (ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG)) {
1032 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
1033 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001034
1035 /* Data should be octet string type */
Gilles Peskine449bd832023-01-11 14:50:10 +01001036 if ((ret = mbedtls_asn1_get_tag(p, end_ext_data, &len,
1037 MBEDTLS_ASN1_OCTET_STRING)) != 0) {
1038 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS, ret);
1039 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001040
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +02001041 start_ext_octet = *p;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001042 end_ext_octet = *p + len;
1043
Gilles Peskine449bd832023-01-11 14:50:10 +01001044 if (end_ext_octet != end_ext_data) {
1045 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
1046 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
1047 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001048
1049 /*
1050 * Detect supported extensions
1051 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001052 ret = mbedtls_oid_get_x509_ext_type(&extn_oid, &ext_type);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001053
Gilles Peskine449bd832023-01-11 14:50:10 +01001054 if (ret != 0) {
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001055 /* Give the callback (if any) a chance to handle the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +01001056 if (cb != NULL) {
1057 ret = cb(p_ctx, crt, &extn_oid, is_critical, *p, end_ext_octet);
1058 if (ret != 0 && is_critical) {
1059 return ret;
1060 }
Nicola Di Lietofae25a12020-05-28 08:55:08 +02001061 *p = end_ext_octet;
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001062 continue;
Nicola Di Lietofae25a12020-05-28 08:55:08 +02001063 }
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001064
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001065 /* No parser found, skip extension */
1066 *p = end_ext_octet;
1067
Gilles Peskine449bd832023-01-11 14:50:10 +01001068 if (is_critical) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001069 /* Data is marked as critical: fail */
Gilles Peskine449bd832023-01-11 14:50:10 +01001070 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
1071 MBEDTLS_ERR_ASN1_UNEXPECTED_TAG);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001072 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001073 continue;
1074 }
1075
Manuel Pégourié-Gonnard8a5e3d42014-11-12 17:47:28 +01001076 /* Forbid repeated extensions */
Gilles Peskine449bd832023-01-11 14:50:10 +01001077 if ((crt->ext_types & ext_type) != 0) {
1078 return MBEDTLS_ERR_X509_INVALID_EXTENSIONS;
1079 }
Manuel Pégourié-Gonnard8a5e3d42014-11-12 17:47:28 +01001080
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001081 crt->ext_types |= ext_type;
1082
Gilles Peskine449bd832023-01-11 14:50:10 +01001083 switch (ext_type) {
1084 case MBEDTLS_X509_EXT_BASIC_CONSTRAINTS:
1085 /* Parse basic constraints */
1086 if ((ret = x509_get_basic_constraints(p, end_ext_octet,
1087 &crt->ca_istrue, &crt->max_pathlen)) != 0) {
1088 return ret;
1089 }
1090 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001091
Gilles Peskine449bd832023-01-11 14:50:10 +01001092 case MBEDTLS_X509_EXT_KEY_USAGE:
1093 /* Parse key usage */
Przemek Stekiel21c37282023-01-16 08:47:49 +01001094 if ((ret = mbedtls_x509_get_key_usage(p, end_ext_octet,
1095 &crt->key_usage)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001096 return ret;
1097 }
1098 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001099
Gilles Peskine449bd832023-01-11 14:50:10 +01001100 case MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE:
1101 /* Parse extended key usage */
1102 if ((ret = x509_get_ext_key_usage(p, end_ext_octet,
1103 &crt->ext_key_usage)) != 0) {
1104 return ret;
1105 }
1106 break;
toth92ga41954d2021-02-12 16:11:17 +01001107 case MBEDTLS_X509_EXT_SUBJECT_KEY_IDENTIFIER:
1108 /* Parse subject key identifier */
1109 if ((ret = x509_get_subject_key_id(p, end_ext_data,
1110 &crt->subject_key_id)) != 0) {
1111 return ret;
1112 }
1113 break;
1114 case MBEDTLS_X509_EXT_AUTHORITY_KEY_IDENTIFIER:
1115 /* Parse authority key identifier */
1116 if ((ret = x509_get_authority_key_id(p, end_ext_octet,
1117 &crt->authority_key_id)) != 0) {
1118 return ret;
1119 }
1120 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01001121 case MBEDTLS_X509_EXT_SUBJECT_ALT_NAME:
1122 /* Parse subject alt name */
Przemek Stekiel21c37282023-01-16 08:47:49 +01001123 if ((ret = mbedtls_x509_get_subject_alt_name(p, end_ext_octet,
1124 &crt->subject_alt_names)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001125 return ret;
1126 }
1127 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001128
Gilles Peskine449bd832023-01-11 14:50:10 +01001129 case MBEDTLS_X509_EXT_NS_CERT_TYPE:
1130 /* Parse netscape certificate type */
Przemek Stekiel21c37282023-01-16 08:47:49 +01001131 if ((ret = mbedtls_x509_get_ns_cert_type(p, end_ext_octet,
1132 &crt->ns_cert_type)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001133 return ret;
1134 }
1135 break;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001136
Gilles Peskine449bd832023-01-11 14:50:10 +01001137 case MBEDTLS_OID_X509_EXT_CERTIFICATE_POLICIES:
1138 /* Parse certificate policies type */
1139 if ((ret = x509_get_certificate_policies(p, end_ext_octet,
1140 &crt->certificate_policies)) != 0) {
1141 /* Give the callback (if any) a chance to handle the extension
1142 * if it contains unsupported policies */
1143 if (ret == MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE && cb != NULL &&
1144 cb(p_ctx, crt, &extn_oid, is_critical,
1145 start_ext_octet, end_ext_octet) == 0) {
1146 break;
1147 }
Nicola Di Lietoc84b1e62020-06-13 11:08:16 +02001148
Gilles Peskine449bd832023-01-11 14:50:10 +01001149 if (is_critical) {
1150 return ret;
1151 } else
1152 /*
1153 * If MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE is returned, then we
1154 * cannot interpret or enforce the policy. However, it is up to
1155 * the user to choose how to enforce the policies,
1156 * unless the extension is critical.
1157 */
1158 if (ret != MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE) {
1159 return ret;
1160 }
1161 }
1162 break;
1163
1164 default:
Ron Eldor8b0c3c92019-05-15 12:20:00 +03001165 /*
Gilles Peskine449bd832023-01-11 14:50:10 +01001166 * If this is a non-critical extension, which the oid layer
1167 * supports, but there isn't an x509 parser for it,
1168 * skip the extension.
Ron Eldor8b0c3c92019-05-15 12:20:00 +03001169 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001170 if (is_critical) {
1171 return MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE;
1172 } else {
1173 *p = end_ext_octet;
1174 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001175 }
1176 }
1177
Gilles Peskine449bd832023-01-11 14:50:10 +01001178 if (*p != end) {
1179 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_EXTENSIONS,
1180 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
1181 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001182
Gilles Peskine449bd832023-01-11 14:50:10 +01001183 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001184}
1185
1186/*
1187 * Parse and fill a single X.509 certificate in DER format
1188 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001189static int x509_crt_parse_der_core(mbedtls_x509_crt *crt,
1190 const unsigned char *buf,
1191 size_t buflen,
1192 int make_copy,
1193 mbedtls_x509_crt_ext_cb_t cb,
1194 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001195{
Janos Follath865b3eb2019-12-16 11:46:15 +00001196 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001197 size_t len;
1198 unsigned char *p, *end, *crt_end;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001199 mbedtls_x509_buf sig_params1, sig_params2, sig_oid2;
Manuel Pégourié-Gonnard59a75d52014-01-22 10:12:57 +01001200
Gilles Peskine449bd832023-01-11 14:50:10 +01001201 memset(&sig_params1, 0, sizeof(mbedtls_x509_buf));
1202 memset(&sig_params2, 0, sizeof(mbedtls_x509_buf));
1203 memset(&sig_oid2, 0, sizeof(mbedtls_x509_buf));
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001204
1205 /*
1206 * Check for valid input
1207 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001208 if (crt == NULL || buf == NULL) {
1209 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1210 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001211
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001212 /* Use the original buffer until we figure out actual length. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001213 p = (unsigned char *) buf;
Janos Follathcc0e49d2016-02-17 14:34:12 +00001214 len = buflen;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001215 end = p + len;
1216
1217 /*
1218 * Certificate ::= SEQUENCE {
1219 * tbsCertificate TBSCertificate,
1220 * signatureAlgorithm AlgorithmIdentifier,
1221 * signatureValue BIT STRING }
1222 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001223 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1224 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1225 mbedtls_x509_crt_free(crt);
1226 return MBEDTLS_ERR_X509_INVALID_FORMAT;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001227 }
1228
Janos Follathcc0e49d2016-02-17 14:34:12 +00001229 end = crt_end = p + len;
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001230 crt->raw.len = crt_end - buf;
Gilles Peskine449bd832023-01-11 14:50:10 +01001231 if (make_copy != 0) {
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001232 /* Create and populate a new buffer for the raw field. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001233 crt->raw.p = p = mbedtls_calloc(1, crt->raw.len);
1234 if (crt->raw.p == NULL) {
1235 return MBEDTLS_ERR_X509_ALLOC_FAILED;
1236 }
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001237
Gilles Peskine449bd832023-01-11 14:50:10 +01001238 memcpy(crt->raw.p, buf, crt->raw.len);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001239 crt->own_buffer = 1;
1240
1241 p += crt->raw.len - len;
1242 end = crt_end = p + len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001243 } else {
1244 crt->raw.p = (unsigned char *) buf;
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001245 crt->own_buffer = 0;
1246 }
Janos Follathcc0e49d2016-02-17 14:34:12 +00001247
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001248 /*
1249 * TBSCertificate ::= SEQUENCE {
1250 */
1251 crt->tbs.p = p;
1252
Gilles Peskine449bd832023-01-11 14:50:10 +01001253 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1254 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1255 mbedtls_x509_crt_free(crt);
1256 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001257 }
1258
1259 end = p + len;
1260 crt->tbs.len = end - crt->tbs.p;
1261
1262 /*
1263 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
1264 *
1265 * CertificateSerialNumber ::= INTEGER
1266 *
1267 * signature AlgorithmIdentifier
1268 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001269 if ((ret = x509_get_version(&p, end, &crt->version)) != 0 ||
1270 (ret = mbedtls_x509_get_serial(&p, end, &crt->serial)) != 0 ||
1271 (ret = mbedtls_x509_get_alg(&p, end, &crt->sig_oid,
1272 &sig_params1)) != 0) {
1273 mbedtls_x509_crt_free(crt);
1274 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001275 }
1276
Gilles Peskine449bd832023-01-11 14:50:10 +01001277 if (crt->version < 0 || crt->version > 2) {
1278 mbedtls_x509_crt_free(crt);
1279 return MBEDTLS_ERR_X509_UNKNOWN_VERSION;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001280 }
1281
Andres AG7ca4a032017-03-09 16:16:11 +00001282 crt->version++;
1283
Gilles Peskine449bd832023-01-11 14:50:10 +01001284 if ((ret = mbedtls_x509_get_sig_alg(&crt->sig_oid, &sig_params1,
1285 &crt->sig_md, &crt->sig_pk,
1286 &crt->sig_opts)) != 0) {
1287 mbedtls_x509_crt_free(crt);
1288 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001289 }
1290
1291 /*
1292 * issuer Name
1293 */
1294 crt->issuer_raw.p = p;
1295
Gilles Peskine449bd832023-01-11 14:50:10 +01001296 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1297 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1298 mbedtls_x509_crt_free(crt);
1299 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001300 }
1301
Gilles Peskine449bd832023-01-11 14:50:10 +01001302 if ((ret = mbedtls_x509_get_name(&p, p + len, &crt->issuer)) != 0) {
1303 mbedtls_x509_crt_free(crt);
1304 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001305 }
1306
1307 crt->issuer_raw.len = p - crt->issuer_raw.p;
1308
1309 /*
1310 * Validity ::= SEQUENCE {
1311 * notBefore Time,
1312 * notAfter Time }
1313 *
1314 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001315 if ((ret = x509_get_dates(&p, end, &crt->valid_from,
1316 &crt->valid_to)) != 0) {
1317 mbedtls_x509_crt_free(crt);
1318 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001319 }
1320
1321 /*
1322 * subject Name
1323 */
1324 crt->subject_raw.p = p;
1325
Gilles Peskine449bd832023-01-11 14:50:10 +01001326 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
1327 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
1328 mbedtls_x509_crt_free(crt);
1329 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT, ret);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001330 }
1331
Gilles Peskine449bd832023-01-11 14:50:10 +01001332 if (len && (ret = mbedtls_x509_get_name(&p, p + len, &crt->subject)) != 0) {
1333 mbedtls_x509_crt_free(crt);
1334 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001335 }
1336
1337 crt->subject_raw.len = p - crt->subject_raw.p;
1338
1339 /*
1340 * SubjectPublicKeyInfo
1341 */
Hanno Becker494dd7a2019-02-06 16:13:41 +00001342 crt->pk_raw.p = p;
Gilles Peskine449bd832023-01-11 14:50:10 +01001343 if ((ret = mbedtls_pk_parse_subpubkey(&p, end, &crt->pk)) != 0) {
1344 mbedtls_x509_crt_free(crt);
1345 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001346 }
Hanno Becker494dd7a2019-02-06 16:13:41 +00001347 crt->pk_raw.len = p - crt->pk_raw.p;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001348
1349 /*
1350 * issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONAL,
1351 * -- If present, version shall be v2 or v3
1352 * subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONAL,
1353 * -- If present, version shall be v2 or v3
1354 * extensions [3] EXPLICIT Extensions OPTIONAL
1355 * -- If present, version shall be v3
1356 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001357 if (crt->version == 2 || crt->version == 3) {
1358 ret = x509_get_uid(&p, end, &crt->issuer_id, 1);
1359 if (ret != 0) {
1360 mbedtls_x509_crt_free(crt);
1361 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001362 }
1363 }
1364
Gilles Peskine449bd832023-01-11 14:50:10 +01001365 if (crt->version == 2 || crt->version == 3) {
1366 ret = x509_get_uid(&p, end, &crt->subject_id, 2);
1367 if (ret != 0) {
1368 mbedtls_x509_crt_free(crt);
1369 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001370 }
1371 }
1372
Gilles Peskine449bd832023-01-11 14:50:10 +01001373 if (crt->version == 3) {
1374 ret = x509_get_crt_ext(&p, end, crt, cb, p_ctx);
1375 if (ret != 0) {
1376 mbedtls_x509_crt_free(crt);
1377 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001378 }
1379 }
1380
Gilles Peskine449bd832023-01-11 14:50:10 +01001381 if (p != end) {
1382 mbedtls_x509_crt_free(crt);
1383 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT,
1384 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001385 }
1386
1387 end = crt_end;
1388
1389 /*
1390 * }
1391 * -- end of TBSCertificate
1392 *
1393 * signatureAlgorithm AlgorithmIdentifier,
1394 * signatureValue BIT STRING
1395 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001396 if ((ret = mbedtls_x509_get_alg(&p, end, &sig_oid2, &sig_params2)) != 0) {
1397 mbedtls_x509_crt_free(crt);
1398 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001399 }
1400
Gilles Peskine449bd832023-01-11 14:50:10 +01001401 if (crt->sig_oid.len != sig_oid2.len ||
1402 memcmp(crt->sig_oid.p, sig_oid2.p, crt->sig_oid.len) != 0 ||
Paul Elliottca17ebf2020-11-24 17:30:18 +00001403 sig_params1.tag != sig_params2.tag ||
Manuel Pégourié-Gonnarddddbb1d2014-06-05 17:02:24 +02001404 sig_params1.len != sig_params2.len ||
Gilles Peskine449bd832023-01-11 14:50:10 +01001405 (sig_params1.len != 0 &&
1406 memcmp(sig_params1.p, sig_params2.p, sig_params1.len) != 0)) {
1407 mbedtls_x509_crt_free(crt);
1408 return MBEDTLS_ERR_X509_SIG_MISMATCH;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001409 }
1410
Gilles Peskine449bd832023-01-11 14:50:10 +01001411 if ((ret = mbedtls_x509_get_sig(&p, end, &crt->sig)) != 0) {
1412 mbedtls_x509_crt_free(crt);
1413 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001414 }
1415
Gilles Peskine449bd832023-01-11 14:50:10 +01001416 if (p != end) {
1417 mbedtls_x509_crt_free(crt);
1418 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_X509_INVALID_FORMAT,
1419 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001420 }
1421
Gilles Peskine449bd832023-01-11 14:50:10 +01001422 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001423}
1424
1425/*
1426 * Parse one X.509 certificate in DER format from a buffer and add them to a
1427 * chained list
1428 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001429static int mbedtls_x509_crt_parse_der_internal(mbedtls_x509_crt *chain,
1430 const unsigned char *buf,
1431 size_t buflen,
1432 int make_copy,
1433 mbedtls_x509_crt_ext_cb_t cb,
1434 void *p_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001435{
Janos Follath865b3eb2019-12-16 11:46:15 +00001436 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001437 mbedtls_x509_crt *crt = chain, *prev = NULL;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001438
1439 /*
1440 * Check for valid input
1441 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001442 if (crt == NULL || buf == NULL) {
1443 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1444 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001445
Gilles Peskine449bd832023-01-11 14:50:10 +01001446 while (crt->version != 0 && crt->next != NULL) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001447 prev = crt;
1448 crt = crt->next;
1449 }
1450
1451 /*
1452 * Add new certificate on the end of the chain if needed.
1453 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001454 if (crt->version != 0 && crt->next == NULL) {
1455 crt->next = mbedtls_calloc(1, sizeof(mbedtls_x509_crt));
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001456
Gilles Peskine449bd832023-01-11 14:50:10 +01001457 if (crt->next == NULL) {
1458 return MBEDTLS_ERR_X509_ALLOC_FAILED;
1459 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001460
1461 prev = crt;
Gilles Peskine449bd832023-01-11 14:50:10 +01001462 mbedtls_x509_crt_init(crt->next);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001463 crt = crt->next;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001464 }
1465
Gilles Peskine449bd832023-01-11 14:50:10 +01001466 ret = x509_crt_parse_der_core(crt, buf, buflen, make_copy, cb, p_ctx);
1467 if (ret != 0) {
1468 if (prev) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001469 prev->next = NULL;
Gilles Peskine449bd832023-01-11 14:50:10 +01001470 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001471
Gilles Peskine449bd832023-01-11 14:50:10 +01001472 if (crt != chain) {
1473 mbedtls_free(crt);
1474 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001475
Gilles Peskine449bd832023-01-11 14:50:10 +01001476 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001477 }
1478
Gilles Peskine449bd832023-01-11 14:50:10 +01001479 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001480}
1481
Gilles Peskine449bd832023-01-11 14:50:10 +01001482int mbedtls_x509_crt_parse_der_nocopy(mbedtls_x509_crt *chain,
1483 const unsigned char *buf,
1484 size_t buflen)
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001485{
Gilles Peskine449bd832023-01-11 14:50:10 +01001486 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, 0, NULL, NULL);
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001487}
1488
Gilles Peskine449bd832023-01-11 14:50:10 +01001489int mbedtls_x509_crt_parse_der_with_ext_cb(mbedtls_x509_crt *chain,
1490 const unsigned char *buf,
1491 size_t buflen,
1492 int make_copy,
1493 mbedtls_x509_crt_ext_cb_t cb,
1494 void *p_ctx)
Nicola Di Lieto502d4b42020-04-25 14:41:25 +02001495{
Gilles Peskine449bd832023-01-11 14:50:10 +01001496 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, make_copy, cb, p_ctx);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001497}
1498
Gilles Peskine449bd832023-01-11 14:50:10 +01001499int mbedtls_x509_crt_parse_der(mbedtls_x509_crt *chain,
1500 const unsigned char *buf,
1501 size_t buflen)
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001502{
Gilles Peskine449bd832023-01-11 14:50:10 +01001503 return mbedtls_x509_crt_parse_der_internal(chain, buf, buflen, 1, NULL, NULL);
Hanno Becker1a65dcd2019-01-31 08:57:44 +00001504}
1505
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001506/*
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02001507 * Parse one or more PEM certificates from a buffer and add them to the chained
1508 * list
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001509 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001510int mbedtls_x509_crt_parse(mbedtls_x509_crt *chain,
1511 const unsigned char *buf,
1512 size_t buflen)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001513{
Janos Follath98e28a72016-05-31 14:03:54 +01001514#if defined(MBEDTLS_PEM_PARSE_C)
Andres AGc0db5112016-12-07 15:05:53 +00001515 int success = 0, first_error = 0, total_failed = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001516 int buf_format = MBEDTLS_X509_FORMAT_DER;
Janos Follath98e28a72016-05-31 14:03:54 +01001517#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001518
1519 /*
1520 * Check for valid input
1521 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001522 if (chain == NULL || buf == NULL) {
1523 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1524 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001525
1526 /*
1527 * Determine buffer content. Buffer contains either one DER certificate or
1528 * one or more PEM certificates.
1529 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001530#if defined(MBEDTLS_PEM_PARSE_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001531 if (buflen != 0 && buf[buflen - 1] == '\0' &&
1532 strstr((const char *) buf, "-----BEGIN CERTIFICATE-----") != NULL) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001533 buf_format = MBEDTLS_X509_FORMAT_PEM;
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001534 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001535
Gilles Peskine449bd832023-01-11 14:50:10 +01001536 if (buf_format == MBEDTLS_X509_FORMAT_DER) {
1537 return mbedtls_x509_crt_parse_der(chain, buf, buflen);
1538 }
Janos Follath98e28a72016-05-31 14:03:54 +01001539#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001540 return mbedtls_x509_crt_parse_der(chain, buf, buflen);
Janos Follath98e28a72016-05-31 14:03:54 +01001541#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001542
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001543#if defined(MBEDTLS_PEM_PARSE_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001544 if (buf_format == MBEDTLS_X509_FORMAT_PEM) {
Janos Follath865b3eb2019-12-16 11:46:15 +00001545 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001546 mbedtls_pem_context pem;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001547
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001548 /* 1 rather than 0 since the terminating NULL byte is counted in */
Gilles Peskine449bd832023-01-11 14:50:10 +01001549 while (buflen > 1) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001550 size_t use_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001551 mbedtls_pem_init(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001552
Manuel Pégourié-Gonnard43b37cb2015-05-12 11:20:10 +02001553 /* If we get there, we know the string is null-terminated */
Gilles Peskine449bd832023-01-11 14:50:10 +01001554 ret = mbedtls_pem_read_buffer(&pem,
1555 "-----BEGIN CERTIFICATE-----",
1556 "-----END CERTIFICATE-----",
1557 buf, NULL, 0, &use_len);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001558
Gilles Peskine449bd832023-01-11 14:50:10 +01001559 if (ret == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001560 /*
1561 * Was PEM encoded
1562 */
1563 buflen -= use_len;
1564 buf += use_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001565 } else if (ret == MBEDTLS_ERR_PEM_BAD_INPUT_DATA) {
1566 return ret;
1567 } else if (ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT) {
1568 mbedtls_pem_free(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001569
1570 /*
1571 * PEM header and footer were found
1572 */
1573 buflen -= use_len;
1574 buf += use_len;
1575
Gilles Peskine449bd832023-01-11 14:50:10 +01001576 if (first_error == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001577 first_error = ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001578 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001579
Paul Bakker5a5fa922014-09-26 14:53:04 +02001580 total_failed++;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001581 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001582 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001583 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01001584 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001585
Gilles Peskine449bd832023-01-11 14:50:10 +01001586 ret = mbedtls_x509_crt_parse_der(chain, pem.buf, pem.buflen);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001587
Gilles Peskine449bd832023-01-11 14:50:10 +01001588 mbedtls_pem_free(&pem);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001589
Gilles Peskine449bd832023-01-11 14:50:10 +01001590 if (ret != 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001591 /*
1592 * Quit parsing on a memory error
1593 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001594 if (ret == MBEDTLS_ERR_X509_ALLOC_FAILED) {
1595 return ret;
1596 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001597
Gilles Peskine449bd832023-01-11 14:50:10 +01001598 if (first_error == 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001599 first_error = ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001600 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001601
1602 total_failed++;
1603 continue;
1604 }
1605
1606 success = 1;
1607 }
1608 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001609
Gilles Peskine449bd832023-01-11 14:50:10 +01001610 if (success) {
1611 return total_failed;
1612 } else if (first_error) {
1613 return first_error;
1614 } else {
1615 return MBEDTLS_ERR_X509_CERT_UNKNOWN_FORMAT;
1616 }
Janos Follath98e28a72016-05-31 14:03:54 +01001617#endif /* MBEDTLS_PEM_PARSE_C */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001618}
1619
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001620#if defined(MBEDTLS_FS_IO)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001621/*
1622 * Load one or more certificates and add them to the chained list
1623 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001624int mbedtls_x509_crt_parse_file(mbedtls_x509_crt *chain, const char *path)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001625{
Janos Follath865b3eb2019-12-16 11:46:15 +00001626 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001627 size_t n;
1628 unsigned char *buf;
1629
Gilles Peskine449bd832023-01-11 14:50:10 +01001630 if ((ret = mbedtls_pk_load_file(path, &buf, &n)) != 0) {
1631 return ret;
1632 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001633
Gilles Peskine449bd832023-01-11 14:50:10 +01001634 ret = mbedtls_x509_crt_parse(chain, buf, n);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001635
Gilles Peskine449bd832023-01-11 14:50:10 +01001636 mbedtls_platform_zeroize(buf, n);
1637 mbedtls_free(buf);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001638
Gilles Peskine449bd832023-01-11 14:50:10 +01001639 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001640}
1641
Gilles Peskine449bd832023-01-11 14:50:10 +01001642int mbedtls_x509_crt_parse_path(mbedtls_x509_crt *chain, const char *path)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001643{
1644 int ret = 0;
Paul Bakkerfa6a6202013-10-28 18:48:30 +01001645#if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001646 int w_ret;
1647 WCHAR szDir[MAX_PATH];
1648 char filename[MAX_PATH];
Paul Bakker9af723c2014-05-01 13:03:14 +02001649 char *p;
Gilles Peskine449bd832023-01-11 14:50:10 +01001650 size_t len = strlen(path);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001651
Paul Bakker9af723c2014-05-01 13:03:14 +02001652 WIN32_FIND_DATAW file_data;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001653 HANDLE hFind;
1654
Gilles Peskine449bd832023-01-11 14:50:10 +01001655 if (len > MAX_PATH - 3) {
1656 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1657 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001658
Gilles Peskine449bd832023-01-11 14:50:10 +01001659 memset(szDir, 0, sizeof(szDir));
1660 memset(filename, 0, MAX_PATH);
1661 memcpy(filename, path, len);
Paul Bakker9af723c2014-05-01 13:03:14 +02001662 filename[len++] = '\\';
1663 p = filename + len;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001664 filename[len++] = '*';
1665
Gilles Peskine449bd832023-01-11 14:50:10 +01001666 w_ret = MultiByteToWideChar(CP_ACP, 0, filename, (int) len, szDir,
1667 MAX_PATH - 3);
1668 if (w_ret == 0) {
1669 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
1670 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001671
Gilles Peskine449bd832023-01-11 14:50:10 +01001672 hFind = FindFirstFileW(szDir, &file_data);
1673 if (hFind == INVALID_HANDLE_VALUE) {
1674 return MBEDTLS_ERR_X509_FILE_IO_ERROR;
1675 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001676
1677 len = MAX_PATH - len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001678 do {
1679 memset(p, 0, len);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001680
Gilles Peskine449bd832023-01-11 14:50:10 +01001681 if (file_data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001682 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001683 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001684
Gilles Peskine449bd832023-01-11 14:50:10 +01001685 w_ret = WideCharToMultiByte(CP_ACP, 0, file_data.cFileName,
Tom Cosgroveb96c3092023-02-10 12:52:13 +00001686 -1,
1687 p, (int) len,
Gilles Peskine449bd832023-01-11 14:50:10 +01001688 NULL, NULL);
1689 if (w_ret == 0) {
Ron Eldor36d90422017-01-09 15:09:16 +02001690 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1691 goto cleanup;
1692 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001693
Gilles Peskine449bd832023-01-11 14:50:10 +01001694 w_ret = mbedtls_x509_crt_parse_file(chain, filename);
1695 if (w_ret < 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001696 ret++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001697 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001698 ret += w_ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001699 }
1700 } while (FindNextFileW(hFind, &file_data) != 0);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001701
Gilles Peskine449bd832023-01-11 14:50:10 +01001702 if (GetLastError() != ERROR_NO_MORE_FILES) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001703 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
Gilles Peskine449bd832023-01-11 14:50:10 +01001704 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001705
Ron Eldor36d90422017-01-09 15:09:16 +02001706cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01001707 FindClose(hFind);
Paul Bakkerbe089b02013-10-14 15:51:50 +02001708#else /* _WIN32 */
Manuel Pégourié-Gonnard964bf9b2013-11-26 16:47:11 +01001709 int t_ret;
Andres AGf9113192016-09-02 14:06:04 +01001710 int snp_ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001711 struct stat sb;
Manuel Pégourié-Gonnard964bf9b2013-11-26 16:47:11 +01001712 struct dirent *entry;
Andres AGf9113192016-09-02 14:06:04 +01001713 char entry_name[MBEDTLS_X509_MAX_FILE_PATH_LEN];
Gilles Peskine449bd832023-01-11 14:50:10 +01001714 DIR *dir = opendir(path);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001715
Gilles Peskine449bd832023-01-11 14:50:10 +01001716 if (dir == NULL) {
1717 return MBEDTLS_ERR_X509_FILE_IO_ERROR;
1718 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001719
Ron Eldor63140682017-01-09 19:27:59 +02001720#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001721 if ((ret = mbedtls_mutex_lock(&mbedtls_threading_readdir_mutex)) != 0) {
1722 closedir(dir);
1723 return ret;
Manuel Pégourié-Gonnardf9b85d92015-06-22 18:39:57 +02001724 }
Ron Eldor63140682017-01-09 19:27:59 +02001725#endif /* MBEDTLS_THREADING_C */
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001726
Gilles Peskine449bd832023-01-11 14:50:10 +01001727 memset(&sb, 0, sizeof(sb));
Paul Elliottfb91a482021-03-05 14:17:51 +00001728
Gilles Peskine449bd832023-01-11 14:50:10 +01001729 while ((entry = readdir(dir)) != NULL) {
Dave Rodgman6dd757a2023-02-02 12:40:50 +00001730 snp_ret = mbedtls_snprintf(entry_name, sizeof(entry_name),
Gilles Peskine449bd832023-01-11 14:50:10 +01001731 "%s/%s", path, entry->d_name);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001732
Dave Rodgman6dd757a2023-02-02 12:40:50 +00001733 if (snp_ret < 0 || (size_t) snp_ret >= sizeof(entry_name)) {
Andres AGf9113192016-09-02 14:06:04 +01001734 ret = MBEDTLS_ERR_X509_BUFFER_TOO_SMALL;
1735 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01001736 } else if (stat(entry_name, &sb) == -1) {
1737 if (errno == ENOENT) {
Dave Rodgmanfa40b022022-07-20 16:08:00 +01001738 /* Broken symbolic link - ignore this entry.
1739 stat(2) will return this error for either (a) a dangling
1740 symlink or (b) a missing file.
1741 Given that we have just obtained the filename from readdir,
1742 assume that it does exist and therefore treat this as a
1743 dangling symlink. */
1744 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001745 } else {
Dave Rodgmanfa40b022022-07-20 16:08:00 +01001746 /* Some other file error; report the error. */
Eduardo Silvae1bfffc2019-04-25 10:43:26 -06001747 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1748 goto cleanup;
1749 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001750 }
1751
Gilles Peskine449bd832023-01-11 14:50:10 +01001752 if (!S_ISREG(sb.st_mode)) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001753 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001754 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001755
1756 // Ignore parse errors
1757 //
Gilles Peskine449bd832023-01-11 14:50:10 +01001758 t_ret = mbedtls_x509_crt_parse_file(chain, entry_name);
1759 if (t_ret < 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001760 ret++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001761 } else {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001762 ret += t_ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01001763 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001764 }
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001765
1766cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01001767 closedir(dir);
Andres AGf9113192016-09-02 14:06:04 +01001768
Ron Eldor63140682017-01-09 19:27:59 +02001769#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001770 if (mbedtls_mutex_unlock(&mbedtls_threading_readdir_mutex) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001771 ret = MBEDTLS_ERR_THREADING_MUTEX_ERROR;
Gilles Peskine449bd832023-01-11 14:50:10 +01001772 }
Ron Eldor63140682017-01-09 19:27:59 +02001773#endif /* MBEDTLS_THREADING_C */
Manuel Pégourié-Gonnard5ad68e42013-11-28 17:11:54 +01001774
Paul Bakkerbe089b02013-10-14 15:51:50 +02001775#endif /* _WIN32 */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001776
Gilles Peskine449bd832023-01-11 14:50:10 +01001777 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001778}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001779#endif /* MBEDTLS_FS_IO */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001780
Peter Kolbus9a969b62018-12-11 13:55:56 -06001781#if !defined(MBEDTLS_X509_REMOVE_INFO)
Gilles Peskine449bd832023-01-11 14:50:10 +01001782static int x509_info_ext_key_usage(char **buf, size_t *size,
1783 const mbedtls_x509_sequence *extended_key_usage)
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001784{
Janos Follath865b3eb2019-12-16 11:46:15 +00001785 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001786 const char *desc;
1787 size_t n = *size;
1788 char *p = *buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001789 const mbedtls_x509_sequence *cur = extended_key_usage;
Manuel Pégourié-Gonnard7b30cfc2014-04-01 18:00:07 +02001790 const char *sep = "";
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001791
Gilles Peskine449bd832023-01-11 14:50:10 +01001792 while (cur != NULL) {
1793 if (mbedtls_oid_get_extended_key_usage(&cur->buf, &desc) != 0) {
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001794 desc = "???";
Gilles Peskine449bd832023-01-11 14:50:10 +01001795 }
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001796
Gilles Peskine449bd832023-01-11 14:50:10 +01001797 ret = mbedtls_snprintf(p, n, "%s%s", sep, desc);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001798 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001799
Manuel Pégourié-Gonnard7b30cfc2014-04-01 18:00:07 +02001800 sep = ", ";
1801
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001802 cur = cur->next;
1803 }
1804
1805 *size = n;
1806 *buf = p;
1807
Gilles Peskine449bd832023-01-11 14:50:10 +01001808 return 0;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001809}
1810
Gilles Peskine449bd832023-01-11 14:50:10 +01001811static int x509_info_cert_policies(char **buf, size_t *size,
1812 const mbedtls_x509_sequence *certificate_policies)
Ron Eldor74d9acc2019-03-21 14:00:03 +02001813{
Janos Follath865b3eb2019-12-16 11:46:15 +00001814 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Ron Eldor74d9acc2019-03-21 14:00:03 +02001815 const char *desc;
1816 size_t n = *size;
1817 char *p = *buf;
1818 const mbedtls_x509_sequence *cur = certificate_policies;
1819 const char *sep = "";
1820
Gilles Peskine449bd832023-01-11 14:50:10 +01001821 while (cur != NULL) {
1822 if (mbedtls_oid_get_certificate_policies(&cur->buf, &desc) != 0) {
Ron Eldor74d9acc2019-03-21 14:00:03 +02001823 desc = "???";
Gilles Peskine449bd832023-01-11 14:50:10 +01001824 }
Ron Eldor74d9acc2019-03-21 14:00:03 +02001825
Gilles Peskine449bd832023-01-11 14:50:10 +01001826 ret = mbedtls_snprintf(p, n, "%s%s", sep, desc);
Ron Eldor74d9acc2019-03-21 14:00:03 +02001827 MBEDTLS_X509_SAFE_SNPRINTF;
1828
1829 sep = ", ";
1830
1831 cur = cur->next;
1832 }
1833
1834 *size = n;
1835 *buf = p;
1836
Gilles Peskine449bd832023-01-11 14:50:10 +01001837 return 0;
Ron Eldor74d9acc2019-03-21 14:00:03 +02001838}
1839
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001840/*
1841 * Return an informational string about the certificate.
1842 */
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001843#define BEFORE_COLON 18
1844#define BC "18"
Gilles Peskine449bd832023-01-11 14:50:10 +01001845int mbedtls_x509_crt_info(char *buf, size_t size, const char *prefix,
1846 const mbedtls_x509_crt *crt)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001847{
Janos Follath865b3eb2019-12-16 11:46:15 +00001848 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001849 size_t n;
1850 char *p;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001851 char key_size_str[BEFORE_COLON];
1852
1853 p = buf;
1854 n = size;
1855
Gilles Peskine449bd832023-01-11 14:50:10 +01001856 if (NULL == crt) {
1857 ret = mbedtls_snprintf(p, n, "\nCertificate is uninitialised!\n");
Janos Follath98e28a72016-05-31 14:03:54 +01001858 MBEDTLS_X509_SAFE_SNPRINTF;
1859
Gilles Peskine449bd832023-01-11 14:50:10 +01001860 return (int) (size - n);
Janos Follath98e28a72016-05-31 14:03:54 +01001861 }
1862
Gilles Peskine449bd832023-01-11 14:50:10 +01001863 ret = mbedtls_snprintf(p, n, "%scert. version : %d\n",
1864 prefix, crt->version);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001865 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001866 ret = mbedtls_snprintf(p, n, "%sserial number : ",
1867 prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001868 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001869
Gilles Peskine449bd832023-01-11 14:50:10 +01001870 ret = mbedtls_x509_serial_gets(p, n, &crt->serial);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001871 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001872
Gilles Peskine449bd832023-01-11 14:50:10 +01001873 ret = mbedtls_snprintf(p, n, "\n%sissuer name : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001874 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001875 ret = mbedtls_x509_dn_gets(p, n, &crt->issuer);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001876 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001877
Gilles Peskine449bd832023-01-11 14:50:10 +01001878 ret = mbedtls_snprintf(p, n, "\n%ssubject name : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001879 MBEDTLS_X509_SAFE_SNPRINTF;
Gilles Peskine449bd832023-01-11 14:50:10 +01001880 ret = mbedtls_x509_dn_gets(p, n, &crt->subject);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001881 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001882
Gilles Peskine449bd832023-01-11 14:50:10 +01001883 ret = mbedtls_snprintf(p, n, "\n%sissued on : " \
1884 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
1885 crt->valid_from.year, crt->valid_from.mon,
1886 crt->valid_from.day, crt->valid_from.hour,
1887 crt->valid_from.min, crt->valid_from.sec);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001888 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001889
Gilles Peskine449bd832023-01-11 14:50:10 +01001890 ret = mbedtls_snprintf(p, n, "\n%sexpires on : " \
1891 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
1892 crt->valid_to.year, crt->valid_to.mon,
1893 crt->valid_to.day, crt->valid_to.hour,
1894 crt->valid_to.min, crt->valid_to.sec);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001895 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001896
Gilles Peskine449bd832023-01-11 14:50:10 +01001897 ret = mbedtls_snprintf(p, n, "\n%ssigned using : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001898 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001899
Gilles Peskine449bd832023-01-11 14:50:10 +01001900 ret = mbedtls_x509_sig_alg_gets(p, n, &crt->sig_oid, crt->sig_pk,
1901 crt->sig_md, crt->sig_opts);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001902 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001903
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001904 /* Key size */
Gilles Peskine449bd832023-01-11 14:50:10 +01001905 if ((ret = mbedtls_x509_key_size_helper(key_size_str, BEFORE_COLON,
1906 mbedtls_pk_get_name(&crt->pk))) != 0) {
1907 return ret;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001908 }
1909
Gilles Peskine449bd832023-01-11 14:50:10 +01001910 ret = mbedtls_snprintf(p, n, "\n%s%-" BC "s: %d bits", prefix, key_size_str,
1911 (int) mbedtls_pk_get_bitlen(&crt->pk));
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001912 MBEDTLS_X509_SAFE_SNPRINTF;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001913
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001914 /*
1915 * Optional extensions
1916 */
1917
Gilles Peskine449bd832023-01-11 14:50:10 +01001918 if (crt->ext_types & MBEDTLS_X509_EXT_BASIC_CONSTRAINTS) {
1919 ret = mbedtls_snprintf(p, n, "\n%sbasic constraints : CA=%s", prefix,
1920 crt->ca_istrue ? "true" : "false");
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001921 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001922
Gilles Peskine449bd832023-01-11 14:50:10 +01001923 if (crt->max_pathlen > 0) {
1924 ret = mbedtls_snprintf(p, n, ", max_pathlen=%d", crt->max_pathlen - 1);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001925 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001926 }
1927 }
1928
Gilles Peskine449bd832023-01-11 14:50:10 +01001929 if (crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME) {
1930 ret = mbedtls_snprintf(p, n, "\n%ssubject alt name :", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001931 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardbce2b302014-04-01 13:43:28 +02001932
Przemek Stekiel21c37282023-01-16 08:47:49 +01001933 if ((ret = mbedtls_x509_info_subject_alt_name(&p, &n,
1934 &crt->subject_alt_names,
1935 prefix)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001936 return ret;
1937 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001938 }
1939
Gilles Peskine449bd832023-01-11 14:50:10 +01001940 if (crt->ext_types & MBEDTLS_X509_EXT_NS_CERT_TYPE) {
1941 ret = mbedtls_snprintf(p, n, "\n%scert. type : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001942 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnard919f8f52014-04-01 13:01:11 +02001943
Przemek Stekiel21c37282023-01-16 08:47:49 +01001944 if ((ret = mbedtls_x509_info_cert_type(&p, &n, crt->ns_cert_type)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001945 return ret;
1946 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001947 }
1948
Gilles Peskine449bd832023-01-11 14:50:10 +01001949 if (crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE) {
1950 ret = mbedtls_snprintf(p, n, "\n%skey usage : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001951 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnard65c2ddc2014-04-01 14:12:11 +02001952
Przemek Stekiel21c37282023-01-16 08:47:49 +01001953 if ((ret = mbedtls_x509_info_key_usage(&p, &n, crt->key_usage)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001954 return ret;
1955 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001956 }
1957
Gilles Peskine449bd832023-01-11 14:50:10 +01001958 if (crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE) {
1959 ret = mbedtls_snprintf(p, n, "\n%sext key usage : ", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001960 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardf6f4ab42014-04-01 17:32:44 +02001961
Gilles Peskine449bd832023-01-11 14:50:10 +01001962 if ((ret = x509_info_ext_key_usage(&p, &n,
1963 &crt->ext_key_usage)) != 0) {
1964 return ret;
1965 }
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001966 }
1967
Gilles Peskine449bd832023-01-11 14:50:10 +01001968 if (crt->ext_types & MBEDTLS_OID_X509_EXT_CERTIFICATE_POLICIES) {
1969 ret = mbedtls_snprintf(p, n, "\n%scertificate policies : ", prefix);
Ron Eldor74d9acc2019-03-21 14:00:03 +02001970 MBEDTLS_X509_SAFE_SNPRINTF;
1971
Gilles Peskine449bd832023-01-11 14:50:10 +01001972 if ((ret = x509_info_cert_policies(&p, &n,
1973 &crt->certificate_policies)) != 0) {
1974 return ret;
1975 }
Ron Eldor74d9acc2019-03-21 14:00:03 +02001976 }
1977
Gilles Peskine449bd832023-01-11 14:50:10 +01001978 ret = mbedtls_snprintf(p, n, "\n");
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02001979 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb28487d2014-04-01 12:19:09 +02001980
Gilles Peskine449bd832023-01-11 14:50:10 +01001981 return (int) (size - n);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02001982}
1983
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001984struct x509_crt_verify_string {
1985 int code;
1986 const char *string;
1987};
1988
Gilles Peskine449bd832023-01-11 14:50:10 +01001989#define X509_CRT_ERROR_INFO(err, err_str, info) { err, info },
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001990static const struct x509_crt_verify_string x509_crt_verify_strings[] = {
Hanno Becker7ac83f92020-10-09 10:48:22 +01001991 MBEDTLS_X509_CRT_ERROR_INFO_LIST
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001992 { 0, NULL }
1993};
Hanno Becker7ac83f92020-10-09 10:48:22 +01001994#undef X509_CRT_ERROR_INFO
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001995
Gilles Peskine449bd832023-01-11 14:50:10 +01001996int mbedtls_x509_crt_verify_info(char *buf, size_t size, const char *prefix,
1997 uint32_t flags)
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01001998{
Janos Follath865b3eb2019-12-16 11:46:15 +00001999 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002000 const struct x509_crt_verify_string *cur;
2001 char *p = buf;
2002 size_t n = size;
2003
Gilles Peskine449bd832023-01-11 14:50:10 +01002004 for (cur = x509_crt_verify_strings; cur->string != NULL; cur++) {
2005 if ((flags & cur->code) == 0) {
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002006 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002007 }
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002008
Gilles Peskine449bd832023-01-11 14:50:10 +01002009 ret = mbedtls_snprintf(p, n, "%s%s\n", prefix, cur->string);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02002010 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002011 flags ^= cur->code;
2012 }
2013
Gilles Peskine449bd832023-01-11 14:50:10 +01002014 if (flags != 0) {
2015 ret = mbedtls_snprintf(p, n, "%sUnknown reason "
2016 "(this should not happen)\n", prefix);
Manuel Pégourié-Gonnard16853682015-06-22 11:12:02 +02002017 MBEDTLS_X509_SAFE_SNPRINTF;
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002018 }
2019
Gilles Peskine449bd832023-01-11 14:50:10 +01002020 return (int) (size - n);
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002021}
Hanno Becker612a2f12020-10-09 09:19:39 +01002022#endif /* MBEDTLS_X509_REMOVE_INFO */
Manuel Pégourié-Gonnardb5f48ad2015-04-20 10:38:13 +01002023
Gilles Peskine449bd832023-01-11 14:50:10 +01002024int mbedtls_x509_crt_check_key_usage(const mbedtls_x509_crt *crt,
2025 unsigned int usage)
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02002026{
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02002027 unsigned int usage_must, usage_may;
2028 unsigned int may_mask = MBEDTLS_X509_KU_ENCIPHER_ONLY
Gilles Peskine449bd832023-01-11 14:50:10 +01002029 | MBEDTLS_X509_KU_DECIPHER_ONLY;
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02002030
Gilles Peskine449bd832023-01-11 14:50:10 +01002031 if ((crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE) == 0) {
2032 return 0;
2033 }
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02002034
2035 usage_must = usage & ~may_mask;
2036
Gilles Peskine449bd832023-01-11 14:50:10 +01002037 if (((crt->key_usage & ~may_mask) & usage_must) != usage_must) {
2038 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
2039 }
Manuel Pégourié-Gonnard655a9642015-06-23 10:48:44 +02002040
2041 usage_may = usage & may_mask;
2042
Gilles Peskine449bd832023-01-11 14:50:10 +01002043 if (((crt->key_usage & may_mask) | usage_may) != usage_may) {
2044 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
2045 }
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02002046
Gilles Peskine449bd832023-01-11 14:50:10 +01002047 return 0;
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02002048}
Manuel Pégourié-Gonnard603116c2014-04-09 09:50:03 +02002049
Gilles Peskine449bd832023-01-11 14:50:10 +01002050int mbedtls_x509_crt_check_extended_key_usage(const mbedtls_x509_crt *crt,
2051 const char *usage_oid,
2052 size_t usage_len)
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002053{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002054 const mbedtls_x509_sequence *cur;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002055
2056 /* Extension is not mandatory, absent means no restriction */
Gilles Peskine449bd832023-01-11 14:50:10 +01002057 if ((crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE) == 0) {
2058 return 0;
2059 }
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002060
2061 /*
2062 * Look for the requested usage (or wildcard ANY) in our list
2063 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002064 for (cur = &crt->ext_key_usage; cur != NULL; cur = cur->next) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002065 const mbedtls_x509_buf *cur_oid = &cur->buf;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002066
Gilles Peskine449bd832023-01-11 14:50:10 +01002067 if (cur_oid->len == usage_len &&
2068 memcmp(cur_oid->p, usage_oid, usage_len) == 0) {
2069 return 0;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002070 }
2071
Gilles Peskine449bd832023-01-11 14:50:10 +01002072 if (MBEDTLS_OID_CMP(MBEDTLS_OID_ANY_EXTENDED_KEY_USAGE, cur_oid) == 0) {
2073 return 0;
2074 }
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002075 }
2076
Gilles Peskine449bd832023-01-11 14:50:10 +01002077 return MBEDTLS_ERR_X509_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002078}
Manuel Pégourié-Gonnard7afb8a02014-04-10 17:53:56 +02002079
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002080#if defined(MBEDTLS_X509_CRL_PARSE_C)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002081/*
2082 * Return 1 if the certificate is revoked, or 0 otherwise.
2083 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002084int mbedtls_x509_crt_is_revoked(const mbedtls_x509_crt *crt, const mbedtls_x509_crl *crl)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002085{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002086 const mbedtls_x509_crl_entry *cur = &crl->entry;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002087
Gilles Peskine449bd832023-01-11 14:50:10 +01002088 while (cur != NULL && cur->serial.len != 0) {
2089 if (crt->serial.len == cur->serial.len &&
2090 memcmp(crt->serial.p, cur->serial.p, crt->serial.len) == 0) {
2091 return 1;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002092 }
2093
2094 cur = cur->next;
2095 }
2096
Gilles Peskine449bd832023-01-11 14:50:10 +01002097 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002098}
2099
2100/*
Manuel Pégourié-Gonnardeeef9472016-02-22 11:36:55 +01002101 * Check that the given certificate is not revoked according to the CRL.
Manuel Pégourié-Gonnard08eacec2017-10-18 14:20:24 +02002102 * Skip validation if no CRL for the given CA is present.
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002103 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002104static int x509_crt_verifycrl(mbedtls_x509_crt *crt, mbedtls_x509_crt *ca,
2105 mbedtls_x509_crl *crl_list,
2106 const mbedtls_x509_crt_profile *profile)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002107{
2108 int flags = 0;
Przemek Stekiel40afdd22022-09-06 13:08:28 +02002109 unsigned char hash[MBEDTLS_HASH_MAX_SIZE];
pespacek7599a772022-02-07 14:40:55 +01002110#if defined(MBEDTLS_USE_PSA_CRYPTO)
pespacek7599a772022-02-07 14:40:55 +01002111 psa_algorithm_t psa_algorithm;
2112#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002113 const mbedtls_md_info_t *md_info;
pespacek7599a772022-02-07 14:40:55 +01002114#endif /* MBEDTLS_USE_PSA_CRYPTO */
2115 size_t hash_length;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002116
Gilles Peskine449bd832023-01-11 14:50:10 +01002117 if (ca == NULL) {
2118 return flags;
2119 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002120
Gilles Peskine449bd832023-01-11 14:50:10 +01002121 while (crl_list != NULL) {
2122 if (crl_list->version == 0 ||
2123 x509_name_cmp(&crl_list->issuer, &ca->subject) != 0) {
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002124 crl_list = crl_list->next;
2125 continue;
2126 }
2127
2128 /*
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002129 * Check if the CA is configured to sign CRLs
2130 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002131 if (mbedtls_x509_crt_check_key_usage(ca,
2132 MBEDTLS_X509_KU_CRL_SIGN) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002133 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002134 break;
2135 }
Manuel Pégourié-Gonnard99d4f192014-04-08 15:10:07 +02002136
2137 /*
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002138 * Check if CRL is correctly signed by the trusted CA
2139 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002140 if (x509_profile_check_md_alg(profile, crl_list->sig_md) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002141 flags |= MBEDTLS_X509_BADCRL_BAD_MD;
Gilles Peskine449bd832023-01-11 14:50:10 +01002142 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002143
Gilles Peskine449bd832023-01-11 14:50:10 +01002144 if (x509_profile_check_pk_alg(profile, crl_list->sig_pk) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002145 flags |= MBEDTLS_X509_BADCRL_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01002146 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002147
pespacek7599a772022-02-07 14:40:55 +01002148#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01002149 psa_algorithm = mbedtls_hash_info_psa_from_md(crl_list->sig_md);
2150 if (psa_hash_compute(psa_algorithm,
2151 crl_list->tbs.p,
2152 crl_list->tbs.len,
2153 hash,
2154 sizeof(hash),
2155 &hash_length) != PSA_SUCCESS) {
pespaceka7a64692022-02-14 15:18:43 +01002156 /* Note: this can't happen except after an internal error */
2157 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
2158 break;
2159 }
pespacek7599a772022-02-07 14:40:55 +01002160#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002161 md_info = mbedtls_md_info_from_type(crl_list->sig_md);
2162 hash_length = mbedtls_md_get_size(md_info);
2163 if (mbedtls_md(md_info,
2164 crl_list->tbs.p,
2165 crl_list->tbs.len,
2166 hash) != 0) {
Manuel Pégourié-Gonnard329e78c2017-06-26 12:22:17 +02002167 /* Note: this can't happen except after an internal error */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002168 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002169 break;
2170 }
pespaceka7a64692022-02-14 15:18:43 +01002171#endif /* MBEDTLS_USE_PSA_CRYPTO */
2172
Gilles Peskine449bd832023-01-11 14:50:10 +01002173 if (x509_profile_check_key(profile, &ca->pk) != 0) {
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002174 flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01002175 }
Manuel Pégourié-Gonnard95051642015-06-15 10:39:46 +02002176
Gilles Peskine449bd832023-01-11 14:50:10 +01002177 if (mbedtls_pk_verify_ext(crl_list->sig_pk, crl_list->sig_opts, &ca->pk,
2178 crl_list->sig_md, hash, hash_length,
2179 crl_list->sig.p, crl_list->sig.len) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002180 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002181 break;
2182 }
2183
2184 /*
2185 * Check for validity of CRL (Do not drop out)
2186 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002187 if (mbedtls_x509_time_is_past(&crl_list->next_update)) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002188 flags |= MBEDTLS_X509_BADCRL_EXPIRED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002189 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002190
Gilles Peskine449bd832023-01-11 14:50:10 +01002191 if (mbedtls_x509_time_is_future(&crl_list->this_update)) {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01002192 flags |= MBEDTLS_X509_BADCRL_FUTURE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002193 }
Manuel Pégourié-Gonnard95337652014-03-10 13:15:18 +01002194
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002195 /*
2196 * Check if certificate is revoked
2197 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002198 if (mbedtls_x509_crt_is_revoked(crt, crl_list)) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002199 flags |= MBEDTLS_X509_BADCERT_REVOKED;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002200 break;
2201 }
2202
2203 crl_list = crl_list->next;
2204 }
Manuel Pégourié-Gonnardcbb1f6e2015-06-15 16:17:55 +02002205
Gilles Peskine449bd832023-01-11 14:50:10 +01002206 return flags;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002207}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002208#endif /* MBEDTLS_X509_CRL_PARSE_C */
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002209
Manuel Pégourié-Gonnard88421242014-10-17 11:36:18 +02002210/*
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002211 * Check the signature of a certificate by its parent
2212 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002213static int x509_crt_check_signature(const mbedtls_x509_crt *child,
2214 mbedtls_x509_crt *parent,
2215 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002216{
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002217 size_t hash_len;
Przemek Stekiel51669542022-09-13 12:57:05 +02002218 unsigned char hash[MBEDTLS_HASH_MAX_SIZE];
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002219#if !defined(MBEDTLS_USE_PSA_CRYPTO)
2220 const mbedtls_md_info_t *md_info;
Gilles Peskine449bd832023-01-11 14:50:10 +01002221 md_info = mbedtls_md_info_from_type(child->sig_md);
2222 hash_len = mbedtls_md_get_size(md_info);
Andrzej Kurek8b38ff52018-11-20 03:20:09 -05002223
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002224 /* Note: hash errors can happen only after an internal error */
Gilles Peskine449bd832023-01-11 14:50:10 +01002225 if (mbedtls_md(md_info, child->tbs.p, child->tbs.len, hash) != 0) {
2226 return -1;
2227 }
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002228#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002229 psa_algorithm_t hash_alg = mbedtls_hash_info_psa_from_md(child->sig_md);
pespacek7599a772022-02-07 14:40:55 +01002230 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002231
Gilles Peskine449bd832023-01-11 14:50:10 +01002232 status = psa_hash_compute(hash_alg,
2233 child->tbs.p,
2234 child->tbs.len,
2235 hash,
2236 sizeof(hash),
2237 &hash_len);
2238 if (status != PSA_SUCCESS) {
2239 return MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED;
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002240 }
2241
Andrzej Kurekd4a65532018-10-31 06:18:39 -04002242#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002243 /* Skip expensive computation on obvious mismatch */
Gilles Peskine449bd832023-01-11 14:50:10 +01002244 if (!mbedtls_pk_can_do(&parent->pk, child->sig_pk)) {
2245 return -1;
2246 }
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002247
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002248#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002249 if (rs_ctx != NULL && child->sig_pk == MBEDTLS_PK_ECDSA) {
2250 return mbedtls_pk_verify_restartable(&parent->pk,
2251 child->sig_md, hash, hash_len,
2252 child->sig.p, child->sig.len, &rs_ctx->pk);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002253 }
2254#else
2255 (void) rs_ctx;
2256#endif
2257
Gilles Peskine449bd832023-01-11 14:50:10 +01002258 return mbedtls_pk_verify_ext(child->sig_pk, child->sig_opts, &parent->pk,
2259 child->sig_md, hash, hash_len,
2260 child->sig.p, child->sig.len);
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002261}
2262
2263/*
Manuel Pégourié-Gonnard312010e2014-04-09 14:30:11 +02002264 * Check if 'parent' is a suitable parent (signing CA) for 'child'.
2265 * Return 0 if yes, -1 if not.
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002266 *
2267 * top means parent is a locally-trusted certificate
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002268 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002269static int x509_crt_check_parent(const mbedtls_x509_crt *child,
2270 const mbedtls_x509_crt *parent,
2271 int top)
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002272{
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002273 int need_ca_bit;
2274
Manuel Pégourié-Gonnardc4eff162014-06-19 12:18:08 +02002275 /* Parent must be the issuer */
Gilles Peskine449bd832023-01-11 14:50:10 +01002276 if (x509_name_cmp(&child->issuer, &parent->subject) != 0) {
2277 return -1;
2278 }
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002279
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002280 /* Parent must have the basicConstraints CA bit set as a general rule */
2281 need_ca_bit = 1;
2282
2283 /* Exception: v1/v2 certificates that are locally trusted. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002284 if (top && parent->version < 3) {
Manuel Pégourié-Gonnardd249b7a2014-06-24 11:49:16 +02002285 need_ca_bit = 0;
Manuel Pégourié-Gonnardc4eff162014-06-19 12:18:08 +02002286 }
Manuel Pégourié-Gonnard312010e2014-04-09 14:30:11 +02002287
Gilles Peskine449bd832023-01-11 14:50:10 +01002288 if (need_ca_bit && !parent->ca_istrue) {
2289 return -1;
2290 }
2291
2292 if (need_ca_bit &&
2293 mbedtls_x509_crt_check_key_usage(parent, MBEDTLS_X509_KU_KEY_CERT_SIGN) != 0) {
2294 return -1;
2295 }
2296
2297 return 0;
Manuel Pégourié-Gonnard3fed0b32014-04-08 13:18:01 +02002298}
2299
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002300/*
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002301 * Find a suitable parent for child in candidates, or return NULL.
2302 *
2303 * Here suitable is defined as:
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002304 * 1. subject name matches child's issuer
2305 * 2. if necessary, the CA bit is set and key usage allows signing certs
2306 * 3. for trusted roots, the signature is correct
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002307 * (for intermediates, the signature is checked and the result reported)
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002308 * 4. pathlen constraints are satisfied
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002309 *
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002310 * If there's a suitable candidate which is also time-valid, return the first
2311 * such. Otherwise, return the first suitable candidate (or NULL if there is
2312 * none).
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002313 *
2314 * The rationale for this rule is that someone could have a list of trusted
2315 * roots with two versions on the same root with different validity periods.
2316 * (At least one user reported having such a list and wanted it to just work.)
2317 * The reason we don't just require time-validity is that generally there is
2318 * only one version, and if it's expired we want the flags to state that
2319 * rather than NOT_TRUSTED, as would be the case if we required it here.
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002320 *
2321 * The rationale for rule 3 (signature for trusted roots) is that users might
2322 * have two versions of the same CA with different keys in their list, and the
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002323 * way we select the correct one is by checking the signature (as we don't
2324 * rely on key identifier extensions). (This is one way users might choose to
2325 * handle key rollover, another relies on self-issued certs, see [SIRO].)
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002326 *
2327 * Arguments:
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002328 * - [in] child: certificate for which we're looking for a parent
2329 * - [in] candidates: chained list of potential parents
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002330 * - [out] r_parent: parent found (or NULL)
2331 * - [out] r_signature_is_good: 1 if child signature by parent is valid, or 0
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002332 * - [in] top: 1 if candidates consists of trusted roots, ie we're at the top
2333 * of the chain, 0 otherwise
2334 * - [in] path_cnt: number of intermediates seen so far
2335 * - [in] self_cnt: number of self-signed intermediates seen so far
2336 * (will never be greater than path_cnt)
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002337 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002338 *
2339 * Return value:
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002340 * - 0 on success
2341 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002342 */
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002343static int x509_crt_find_parent_in(
Gilles Peskine449bd832023-01-11 14:50:10 +01002344 mbedtls_x509_crt *child,
2345 mbedtls_x509_crt *candidates,
2346 mbedtls_x509_crt **r_parent,
2347 int *r_signature_is_good,
2348 int top,
2349 unsigned path_cnt,
2350 unsigned self_cnt,
2351 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002352{
Janos Follath865b3eb2019-12-16 11:46:15 +00002353 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002354 mbedtls_x509_crt *parent, *fallback_parent;
Benjamin Kier36050732019-05-30 14:49:17 -04002355 int signature_is_good = 0, fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002356
2357#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002358 /* did we have something in progress? */
Gilles Peskine449bd832023-01-11 14:50:10 +01002359 if (rs_ctx != NULL && rs_ctx->parent != NULL) {
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002360 /* restore saved state */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002361 parent = rs_ctx->parent;
2362 fallback_parent = rs_ctx->fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002363 fallback_signature_is_good = rs_ctx->fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002364
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002365 /* clear saved state */
2366 rs_ctx->parent = NULL;
2367 rs_ctx->fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002368 rs_ctx->fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002369
2370 /* resume where we left */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002371 goto check_signature;
2372 }
2373#endif
2374
2375 fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002376 fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002377
Gilles Peskine449bd832023-01-11 14:50:10 +01002378 for (parent = candidates; parent != NULL; parent = parent->next) {
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002379 /* basic parenting skills (name, CA bit, key usage) */
Gilles Peskine449bd832023-01-11 14:50:10 +01002380 if (x509_crt_check_parent(child, parent, top) != 0) {
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002381 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002382 }
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002383
Manuel Pégourié-Gonnard9c6118c2017-06-29 12:38:42 +02002384 /* +1 because stored max_pathlen is 1 higher that the actual value */
Gilles Peskine449bd832023-01-11 14:50:10 +01002385 if (parent->max_pathlen > 0 &&
2386 (size_t) parent->max_pathlen < 1 + path_cnt - self_cnt) {
Manuel Pégourié-Gonnard9c6118c2017-06-29 12:38:42 +02002387 continue;
2388 }
2389
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002390 /* Signature */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002391#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2392check_signature:
2393#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002394 ret = x509_crt_check_signature(child, parent, rs_ctx);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002395
2396#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002397 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002398 /* save state */
2399 rs_ctx->parent = parent;
2400 rs_ctx->fallback_parent = fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002401 rs_ctx->fallback_signature_is_good = fallback_signature_is_good;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002402
Gilles Peskine449bd832023-01-11 14:50:10 +01002403 return ret;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002404 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002405#else
2406 (void) ret;
2407#endif
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002408
2409 signature_is_good = ret == 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002410 if (top && !signature_is_good) {
Manuel Pégourié-Gonnardf82a4d52017-07-03 19:26:25 +02002411 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002412 }
Manuel Pégourié-Gonnard2f09d592017-07-03 18:30:43 +02002413
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002414 /* optional time check */
Gilles Peskine449bd832023-01-11 14:50:10 +01002415 if (mbedtls_x509_time_is_past(&parent->valid_to) ||
2416 mbedtls_x509_time_is_future(&parent->valid_from)) {
2417 if (fallback_parent == NULL) {
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002418 fallback_parent = parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002419 fallback_signature_is_good = signature_is_good;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002420 }
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002421
2422 continue;
2423 }
2424
Andy Gross1f627142019-01-30 10:25:53 -06002425 *r_parent = parent;
2426 *r_signature_is_good = signature_is_good;
2427
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002428 break;
2429 }
2430
Gilles Peskine449bd832023-01-11 14:50:10 +01002431 if (parent == NULL) {
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002432 *r_parent = fallback_parent;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02002433 *r_signature_is_good = fallback_signature_is_good;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002434 }
Manuel Pégourié-Gonnard3e329b82017-06-29 12:55:27 +02002435
Gilles Peskine449bd832023-01-11 14:50:10 +01002436 return 0;
Manuel Pégourié-Gonnard2f1c33d2017-06-29 12:27:23 +02002437}
2438
2439/*
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002440 * Find a parent in trusted CAs or the provided chain, or return NULL.
2441 *
2442 * Searches in trusted CAs first, and return the first suitable parent found
2443 * (see find_parent_in() for definition of suitable).
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002444 *
2445 * Arguments:
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002446 * - [in] child: certificate for which we're looking for a parent, followed
2447 * by a chain of possible intermediates
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002448 * - [in] trust_ca: list of locally trusted certificates
2449 * - [out] parent: parent found (or NULL)
2450 * - [out] parent_is_trusted: 1 if returned `parent` is trusted, or 0
2451 * - [out] signature_is_good: 1 if child signature by parent is valid, or 0
2452 * - [in] path_cnt: number of links in the chain so far (EE -> ... -> child)
2453 * - [in] self_cnt: number of self-signed certs in the chain so far
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002454 * (will always be no greater than path_cnt)
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002455 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnarde57d7432018-03-07 10:00:57 +01002456 *
2457 * Return value:
Manuel Pégourié-Gonnardda19f4c2018-06-12 12:40:54 +02002458 * - 0 on success
2459 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002460 */
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002461static int x509_crt_find_parent(
Gilles Peskine449bd832023-01-11 14:50:10 +01002462 mbedtls_x509_crt *child,
2463 mbedtls_x509_crt *trust_ca,
2464 mbedtls_x509_crt **parent,
2465 int *parent_is_trusted,
2466 int *signature_is_good,
2467 unsigned path_cnt,
2468 unsigned self_cnt,
2469 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002470{
Janos Follath865b3eb2019-12-16 11:46:15 +00002471 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002472 mbedtls_x509_crt *search_list;
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002473
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002474 *parent_is_trusted = 1;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002475
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002476#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002477 /* restore then clear saved state if we have some stored */
Gilles Peskine449bd832023-01-11 14:50:10 +01002478 if (rs_ctx != NULL && rs_ctx->parent_is_trusted != -1) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002479 *parent_is_trusted = rs_ctx->parent_is_trusted;
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002480 rs_ctx->parent_is_trusted = -1;
2481 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002482#endif
2483
Gilles Peskine449bd832023-01-11 14:50:10 +01002484 while (1) {
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002485 search_list = *parent_is_trusted ? trust_ca : child->next;
2486
Gilles Peskine449bd832023-01-11 14:50:10 +01002487 ret = x509_crt_find_parent_in(child, search_list,
2488 parent, signature_is_good,
2489 *parent_is_trusted,
2490 path_cnt, self_cnt, rs_ctx);
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002491
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002492#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002493 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002494 /* save state */
2495 rs_ctx->parent_is_trusted = *parent_is_trusted;
Gilles Peskine449bd832023-01-11 14:50:10 +01002496 return ret;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002497 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002498#else
2499 (void) ret;
2500#endif
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002501
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002502 /* stop here if found or already in second iteration */
Gilles Peskine449bd832023-01-11 14:50:10 +01002503 if (*parent != NULL || *parent_is_trusted == 0) {
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002504 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01002505 }
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002506
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002507 /* prepare second iteration */
2508 *parent_is_trusted = 0;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002509 }
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002510
2511 /* extra precaution against mistakes in the caller */
Gilles Peskine449bd832023-01-11 14:50:10 +01002512 if (*parent == NULL) {
Manuel Pégourié-Gonnarda5a3e402018-10-16 11:27:23 +02002513 *parent_is_trusted = 0;
2514 *signature_is_good = 0;
Manuel Pégourié-Gonnard18547b52017-08-14 16:11:43 +02002515 }
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002516
Gilles Peskine449bd832023-01-11 14:50:10 +01002517 return 0;
Manuel Pégourié-Gonnard63686122017-07-04 01:01:39 +02002518}
2519
2520/*
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002521 * Check if an end-entity certificate is locally trusted
2522 *
2523 * Currently we require such certificates to be self-signed (actually only
2524 * check for self-issued as self-signatures are not checked)
2525 */
2526static int x509_crt_check_ee_locally_trusted(
Gilles Peskine449bd832023-01-11 14:50:10 +01002527 mbedtls_x509_crt *crt,
2528 mbedtls_x509_crt *trust_ca)
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002529{
2530 mbedtls_x509_crt *cur;
2531
2532 /* must be self-issued */
Gilles Peskine449bd832023-01-11 14:50:10 +01002533 if (x509_name_cmp(&crt->issuer, &crt->subject) != 0) {
2534 return -1;
2535 }
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002536
2537 /* look for an exact match with trusted cert */
Gilles Peskine449bd832023-01-11 14:50:10 +01002538 for (cur = trust_ca; cur != NULL; cur = cur->next) {
2539 if (crt->raw.len == cur->raw.len &&
2540 memcmp(crt->raw.p, cur->raw.p, crt->raw.len) == 0) {
2541 return 0;
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002542 }
2543 }
2544
2545 /* too bad */
Gilles Peskine449bd832023-01-11 14:50:10 +01002546 return -1;
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002547}
2548
2549/*
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002550 * Build and verify a certificate chain
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002551 *
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002552 * Given a peer-provided list of certificates EE, C1, ..., Cn and
2553 * a list of trusted certs R1, ... Rp, try to build and verify a chain
Manuel Pégourié-Gonnard562df402017-08-08 18:09:14 +02002554 * EE, Ci1, ... Ciq [, Rj]
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002555 * such that every cert in the chain is a child of the next one,
2556 * jumping to a trusted root as early as possible.
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002557 *
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002558 * Verify that chain and return it with flags for all issues found.
2559 *
2560 * Special cases:
2561 * - EE == Rj -> return a one-element list containing it
2562 * - EE, Ci1, ..., Ciq cannot be continued with a trusted root
2563 * -> return that chain with NOT_TRUSTED set on Ciq
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002564 *
Manuel Pégourié-Gonnardd19a41d2017-07-14 11:05:59 +02002565 * Tests for (aspects of) this function should include at least:
2566 * - trusted EE
2567 * - EE -> trusted root
Antonin Décimo36e89b52019-01-23 15:24:37 +01002568 * - EE -> intermediate CA -> trusted root
Manuel Pégourié-Gonnardd19a41d2017-07-14 11:05:59 +02002569 * - if relevant: EE untrusted
2570 * - if relevant: EE -> intermediate, untrusted
2571 * with the aspect under test checked at each relevant level (EE, int, root).
2572 * For some aspects longer chains are required, but usually length 2 is
2573 * enough (but length 1 is not in general).
2574 *
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002575 * Arguments:
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002576 * - [in] crt: the cert list EE, C1, ..., Cn
2577 * - [in] trust_ca: the trusted list R1, ..., Rp
2578 * - [in] ca_crl, profile: as in verify_with_profile()
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002579 * - [out] ver_chain: the built and verified chain
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002580 * Only valid when return value is 0, may contain garbage otherwise!
2581 * Restart note: need not be the same when calling again to resume.
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002582 * - [in-out] rs_ctx: context for restarting operations
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002583 *
2584 * Return value:
2585 * - non-zero if the chain could not be fully built and examined
2586 * - 0 is the chain was successfully built and examined,
2587 * even if it was found to be invalid
Manuel Pégourié-Gonnard35407c72017-06-29 10:45:25 +02002588 */
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002589static int x509_crt_verify_chain(
Gilles Peskine449bd832023-01-11 14:50:10 +01002590 mbedtls_x509_crt *crt,
2591 mbedtls_x509_crt *trust_ca,
2592 mbedtls_x509_crl *ca_crl,
2593 mbedtls_x509_crt_ca_cb_t f_ca_cb,
2594 void *p_ca_cb,
2595 const mbedtls_x509_crt_profile *profile,
2596 mbedtls_x509_crt_verify_chain *ver_chain,
2597 mbedtls_x509_crt_restart_ctx *rs_ctx)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002598{
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002599 /* Don't initialize any of those variables here, so that the compiler can
2600 * catch potential issues with jumping ahead when restarting */
Janos Follath865b3eb2019-12-16 11:46:15 +00002601 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002602 uint32_t *flags;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002603 mbedtls_x509_crt_verify_chain_item *cur;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002604 mbedtls_x509_crt *child;
Manuel Pégourié-Gonnard58dcd2d2017-07-03 21:35:04 +02002605 mbedtls_x509_crt *parent;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002606 int parent_is_trusted;
2607 int child_is_trusted;
2608 int signature_is_good;
Manuel Pégourié-Gonnardbb216bd2017-08-28 13:25:55 +02002609 unsigned self_cnt;
Hanno Beckerf53893b2019-03-28 13:45:55 +00002610 mbedtls_x509_crt *cur_trust_ca = NULL;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002611
2612#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2613 /* resume if we had an operation in progress */
Gilles Peskine449bd832023-01-11 14:50:10 +01002614 if (rs_ctx != NULL && rs_ctx->in_progress == x509_crt_rs_find_parent) {
Manuel Pégourié-Gonnard3627a8b2017-08-23 11:20:48 +02002615 /* restore saved state */
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002616 *ver_chain = rs_ctx->ver_chain; /* struct copy */
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002617 self_cnt = rs_ctx->self_cnt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002618
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002619 /* restore derived state */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002620 cur = &ver_chain->items[ver_chain->len - 1];
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002621 child = cur->crt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002622 flags = &cur->flags;
2623
2624 goto find_parent;
2625 }
2626#endif /* MBEDTLS_ECDSA_C && MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard8f8c2822017-07-03 21:25:10 +02002627
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002628 child = crt;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002629 self_cnt = 0;
2630 parent_is_trusted = 0;
2631 child_is_trusted = 0;
Manuel Pégourié-Gonnardf86f4912017-07-05 16:43:44 +02002632
Gilles Peskine449bd832023-01-11 14:50:10 +01002633 while (1) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002634 /* Add certificate to the verification chain */
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002635 cur = &ver_chain->items[ver_chain->len];
2636 cur->crt = child;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002637 cur->flags = 0;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002638 ver_chain->len++;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002639 flags = &cur->flags;
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002640
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002641 /* Check time-validity (all certificates) */
Gilles Peskine449bd832023-01-11 14:50:10 +01002642 if (mbedtls_x509_time_is_past(&child->valid_to)) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002643 *flags |= MBEDTLS_X509_BADCERT_EXPIRED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002644 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002645
Gilles Peskine449bd832023-01-11 14:50:10 +01002646 if (mbedtls_x509_time_is_future(&child->valid_from)) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002647 *flags |= MBEDTLS_X509_BADCERT_FUTURE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002648 }
Manuel Pégourié-Gonnardcb396102017-07-04 00:00:24 +02002649
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002650 /* Stop here for trusted roots (but not for trusted EE certs) */
Gilles Peskine449bd832023-01-11 14:50:10 +01002651 if (child_is_trusted) {
2652 return 0;
2653 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002654
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002655 /* Check signature algorithm: MD & PK algs */
Gilles Peskine449bd832023-01-11 14:50:10 +01002656 if (x509_profile_check_md_alg(profile, child->sig_md) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002657 *flags |= MBEDTLS_X509_BADCERT_BAD_MD;
Gilles Peskine449bd832023-01-11 14:50:10 +01002658 }
Manuel Pégourié-Gonnard66fac752017-07-03 21:39:21 +02002659
Gilles Peskine449bd832023-01-11 14:50:10 +01002660 if (x509_profile_check_pk_alg(profile, child->sig_pk) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002661 *flags |= MBEDTLS_X509_BADCERT_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01002662 }
Manuel Pégourié-Gonnard27e94792017-07-04 00:49:31 +02002663
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002664 /* Special case: EE certs that are locally trusted */
Gilles Peskine449bd832023-01-11 14:50:10 +01002665 if (ver_chain->len == 1 &&
2666 x509_crt_check_ee_locally_trusted(child, trust_ca) == 0) {
2667 return 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002668 }
Manuel Pégourié-Gonnard8f8c2822017-07-03 21:25:10 +02002669
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002670#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2671find_parent:
2672#endif
Hanno Beckerf53893b2019-03-28 13:45:55 +00002673
2674 /* Obtain list of potential trusted signers from CA callback,
2675 * or use statically provided list. */
2676#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
Gilles Peskine449bd832023-01-11 14:50:10 +01002677 if (f_ca_cb != NULL) {
2678 mbedtls_x509_crt_free(ver_chain->trust_ca_cb_result);
2679 mbedtls_free(ver_chain->trust_ca_cb_result);
Hanno Beckerf53893b2019-03-28 13:45:55 +00002680 ver_chain->trust_ca_cb_result = NULL;
2681
Gilles Peskine449bd832023-01-11 14:50:10 +01002682 ret = f_ca_cb(p_ca_cb, child, &ver_chain->trust_ca_cb_result);
2683 if (ret != 0) {
2684 return MBEDTLS_ERR_X509_FATAL_ERROR;
2685 }
Hanno Beckerf53893b2019-03-28 13:45:55 +00002686
2687 cur_trust_ca = ver_chain->trust_ca_cb_result;
Gilles Peskine449bd832023-01-11 14:50:10 +01002688 } else
Hanno Beckerf53893b2019-03-28 13:45:55 +00002689#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2690 {
2691 ((void) f_ca_cb);
2692 ((void) p_ca_cb);
2693 cur_trust_ca = trust_ca;
2694 }
2695
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002696 /* Look for a parent in trusted CAs or up the chain */
Gilles Peskine449bd832023-01-11 14:50:10 +01002697 ret = x509_crt_find_parent(child, cur_trust_ca, &parent,
2698 &parent_is_trusted, &signature_is_good,
2699 ver_chain->len - 1, self_cnt, rs_ctx);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002700
2701#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002702 if (rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS) {
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002703 /* save state */
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02002704 rs_ctx->in_progress = x509_crt_rs_find_parent;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002705 rs_ctx->self_cnt = self_cnt;
Manuel Pégourié-Gonnarda9688432017-08-23 11:23:59 +02002706 rs_ctx->ver_chain = *ver_chain; /* struct copy */
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002707
Gilles Peskine449bd832023-01-11 14:50:10 +01002708 return ret;
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002709 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002710#else
2711 (void) ret;
2712#endif
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002713
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002714 /* No parent? We're done here */
Gilles Peskine449bd832023-01-11 14:50:10 +01002715 if (parent == NULL) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002716 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002717 return 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002718 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002719
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002720 /* Count intermediate self-issued (not necessarily self-signed) certs.
2721 * These can occur with some strategies for key rollover, see [SIRO],
2722 * and should be excluded from max_pathlen checks. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002723 if (ver_chain->len != 1 &&
2724 x509_name_cmp(&child->issuer, &child->subject) == 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002725 self_cnt++;
Manuel Pégourié-Gonnard24611f92017-08-09 10:28:07 +02002726 }
Manuel Pégourié-Gonnardfd6c85c2014-11-20 16:34:20 +01002727
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002728 /* path_cnt is 0 for the first intermediate CA,
2729 * and if parent is trusted it's not an intermediate CA */
Gilles Peskine449bd832023-01-11 14:50:10 +01002730 if (!parent_is_trusted &&
2731 ver_chain->len > MBEDTLS_X509_MAX_INTERMEDIATE_CA) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002732 /* return immediately to avoid overflow the chain array */
Gilles Peskine449bd832023-01-11 14:50:10 +01002733 return MBEDTLS_ERR_X509_FATAL_ERROR;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002734 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002735
Manuel Pégourié-Gonnard98a67782017-08-17 10:52:20 +02002736 /* signature was checked while searching parent */
Gilles Peskine449bd832023-01-11 14:50:10 +01002737 if (!signature_is_good) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002738 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002739 }
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002740
2741 /* check size of signing key */
Gilles Peskine449bd832023-01-11 14:50:10 +01002742 if (x509_profile_check_key(profile, &parent->pk) != 0) {
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002743 *flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01002744 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002745
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002746#if defined(MBEDTLS_X509_CRL_PARSE_C)
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002747 /* Check trusted CA's CRL for the given crt */
Gilles Peskine449bd832023-01-11 14:50:10 +01002748 *flags |= x509_crt_verifycrl(child, parent, ca_crl, profile);
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002749#else
2750 (void) ca_crl;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002751#endif
2752
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002753 /* prepare for next iteration */
2754 child = parent;
2755 parent = NULL;
2756 child_is_trusted = parent_is_trusted;
Manuel Pégourié-Gonnardbe4ff422017-07-14 12:04:14 +02002757 signature_is_good = 0;
Manuel Pégourié-Gonnardce6e52f2017-07-05 17:05:03 +02002758 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002759}
2760
2761/*
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002762 * Check for CN match
2763 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002764static int x509_crt_check_cn(const mbedtls_x509_buf *name,
2765 const char *cn, size_t cn_len)
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002766{
2767 /* try exact match */
Gilles Peskine449bd832023-01-11 14:50:10 +01002768 if (name->len == cn_len &&
2769 x509_memcasecmp(cn, name->p, cn_len) == 0) {
2770 return 0;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002771 }
2772
2773 /* try wildcard match */
Gilles Peskine449bd832023-01-11 14:50:10 +01002774 if (x509_check_wildcard(cn, name) == 0) {
2775 return 0;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002776 }
2777
Gilles Peskine449bd832023-01-11 14:50:10 +01002778 return -1;
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002779}
2780
2781/*
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002782 * Check for SAN match, see RFC 5280 Section 4.2.1.6
2783 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002784static int x509_crt_check_san(const mbedtls_x509_buf *name,
2785 const char *cn, size_t cn_len)
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002786{
2787 const unsigned char san_type = (unsigned char) name->tag &
2788 MBEDTLS_ASN1_TAG_VALUE_MASK;
2789
2790 /* dNSName */
Gilles Peskine449bd832023-01-11 14:50:10 +01002791 if (san_type == MBEDTLS_X509_SAN_DNS_NAME) {
2792 return x509_crt_check_cn(name, cn, cn_len);
2793 }
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002794
2795 /* (We may handle other types here later.) */
2796
2797 /* Unrecognized type */
Gilles Peskine449bd832023-01-11 14:50:10 +01002798 return -1;
Manuel Pégourié-Gonnardf3e4bd82020-07-21 13:22:41 +02002799}
2800
2801/*
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002802 * Verify the requested CN - only call this if cn is not NULL!
2803 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002804static void x509_crt_verify_name(const mbedtls_x509_crt *crt,
2805 const char *cn,
2806 uint32_t *flags)
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002807{
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002808 const mbedtls_x509_name *name;
2809 const mbedtls_x509_sequence *cur;
Gilles Peskine449bd832023-01-11 14:50:10 +01002810 size_t cn_len = strlen(cn);
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002811
Gilles Peskine449bd832023-01-11 14:50:10 +01002812 if (crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME) {
2813 for (cur = &crt->subject_alt_names; cur != NULL; cur = cur->next) {
2814 if (x509_crt_check_san(&cur->buf, cn, cn_len) == 0) {
Manuel Pégourié-Gonnarda468eb12017-07-04 01:31:59 +02002815 break;
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002816 }
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002817 }
2818
Gilles Peskine449bd832023-01-11 14:50:10 +01002819 if (cur == NULL) {
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002820 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
Gilles Peskine449bd832023-01-11 14:50:10 +01002821 }
2822 } else {
2823 for (name = &crt->subject; name != NULL; name = name->next) {
2824 if (MBEDTLS_OID_CMP(MBEDTLS_OID_AT_CN, &name->oid) == 0 &&
2825 x509_crt_check_cn(&name->val, cn, cn_len) == 0) {
2826 break;
2827 }
2828 }
2829
2830 if (name == NULL) {
2831 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
2832 }
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002833 }
2834}
2835
2836/*
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002837 * Merge the flags for all certs in the chain, after calling callback
2838 */
2839static int x509_crt_merge_flags_with_cb(
Gilles Peskine449bd832023-01-11 14:50:10 +01002840 uint32_t *flags,
2841 const mbedtls_x509_crt_verify_chain *ver_chain,
2842 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
2843 void *p_vrfy)
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002844{
Janos Follath865b3eb2019-12-16 11:46:15 +00002845 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbb216bd2017-08-28 13:25:55 +02002846 unsigned i;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002847 uint32_t cur_flags;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002848 const mbedtls_x509_crt_verify_chain_item *cur;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002849
Gilles Peskine449bd832023-01-11 14:50:10 +01002850 for (i = ver_chain->len; i != 0; --i) {
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002851 cur = &ver_chain->items[i-1];
2852 cur_flags = cur->flags;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002853
Gilles Peskine449bd832023-01-11 14:50:10 +01002854 if (NULL != f_vrfy) {
2855 if ((ret = f_vrfy(p_vrfy, cur->crt, (int) i-1, &cur_flags)) != 0) {
2856 return ret;
2857 }
2858 }
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002859
2860 *flags |= cur_flags;
2861 }
2862
Gilles Peskine449bd832023-01-11 14:50:10 +01002863 return 0;
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002864}
2865
2866/*
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02002867 * Verify the certificate validity, with profile, restartable version
2868 *
2869 * This function:
2870 * - checks the requested CN (if any)
2871 * - checks the type and size of the EE cert's key,
2872 * as that isn't done as part of chain building/verification currently
2873 * - builds and verifies the chain
2874 * - then calls the callback and merges the flags
Hanno Becker3116fb32019-03-28 13:34:42 +00002875 *
2876 * The parameters pairs `trust_ca`, `ca_crl` and `f_ca_cb`, `p_ca_cb`
2877 * are mutually exclusive: If `f_ca_cb != NULL`, it will be used by the
2878 * verification routine to search for trusted signers, and CRLs will
2879 * be disabled. Otherwise, `trust_ca` will be used as the static list
2880 * of trusted signers, and `ca_crl` will be use as the static list
2881 * of CRLs.
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02002882 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002883static int x509_crt_verify_restartable_ca_cb(mbedtls_x509_crt *crt,
2884 mbedtls_x509_crt *trust_ca,
2885 mbedtls_x509_crl *ca_crl,
2886 mbedtls_x509_crt_ca_cb_t f_ca_cb,
2887 void *p_ca_cb,
2888 const mbedtls_x509_crt_profile *profile,
2889 const char *cn, uint32_t *flags,
2890 int (*f_vrfy)(void *,
2891 mbedtls_x509_crt *,
2892 int,
2893 uint32_t *),
2894 void *p_vrfy,
2895 mbedtls_x509_crt_restart_ctx *rs_ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02002896{
Janos Follath865b3eb2019-12-16 11:46:15 +00002897 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02002898 mbedtls_pk_type_t pk_type;
Manuel Pégourié-Gonnardc11e4ba2017-08-14 17:17:14 +02002899 mbedtls_x509_crt_verify_chain ver_chain;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002900 uint32_t ee_flags;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002901
2902 *flags = 0;
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002903 ee_flags = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002904 x509_crt_verify_chain_reset(&ver_chain);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002905
Gilles Peskine449bd832023-01-11 14:50:10 +01002906 if (profile == NULL) {
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02002907 ret = MBEDTLS_ERR_X509_BAD_INPUT_DATA;
2908 goto exit;
2909 }
2910
Manuel Pégourié-Gonnard1300e992017-07-04 01:13:44 +02002911 /* check name if requested */
Gilles Peskine449bd832023-01-11 14:50:10 +01002912 if (cn != NULL) {
2913 x509_crt_verify_name(crt, cn, &ee_flags);
2914 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002915
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02002916 /* Check the type and size of the key */
Gilles Peskine449bd832023-01-11 14:50:10 +01002917 pk_type = mbedtls_pk_get_type(&crt->pk);
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02002918
Gilles Peskine449bd832023-01-11 14:50:10 +01002919 if (x509_profile_check_pk_alg(profile, pk_type) != 0) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002920 ee_flags |= MBEDTLS_X509_BADCERT_BAD_PK;
Gilles Peskine449bd832023-01-11 14:50:10 +01002921 }
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02002922
Gilles Peskine449bd832023-01-11 14:50:10 +01002923 if (x509_profile_check_key(profile, &crt->pk) != 0) {
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002924 ee_flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
Gilles Peskine449bd832023-01-11 14:50:10 +01002925 }
Manuel Pégourié-Gonnard65eefc82015-10-23 14:08:48 +02002926
Manuel Pégourié-Gonnardbdc54402017-07-04 00:33:39 +02002927 /* Check the chain */
Gilles Peskine449bd832023-01-11 14:50:10 +01002928 ret = x509_crt_verify_chain(crt, trust_ca, ca_crl,
2929 f_ca_cb, p_ca_cb, profile,
2930 &ver_chain, rs_ctx);
Manuel Pégourié-Gonnarda4a5d1d2017-07-17 10:26:19 +02002931
Gilles Peskine449bd832023-01-11 14:50:10 +01002932 if (ret != 0) {
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +02002933 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01002934 }
Manuel Pégourié-Gonnardc547d1a2017-07-05 13:28:45 +02002935
Manuel Pégourié-Gonnard83e923b2017-08-23 10:55:41 +02002936 /* Merge end-entity flags */
2937 ver_chain.items[0].flags |= ee_flags;
2938
Manuel Pégourié-Gonnarda707e1d2017-07-05 17:18:42 +02002939 /* Build final flags, calling callback on the way if any */
Gilles Peskine449bd832023-01-11 14:50:10 +01002940 ret = x509_crt_merge_flags_with_cb(flags, &ver_chain, f_vrfy, p_vrfy);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002941
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02002942exit:
Hanno Beckerf53893b2019-03-28 13:45:55 +00002943
2944#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
Gilles Peskine449bd832023-01-11 14:50:10 +01002945 mbedtls_x509_crt_free(ver_chain.trust_ca_cb_result);
2946 mbedtls_free(ver_chain.trust_ca_cb_result);
Hanno Beckerf53893b2019-03-28 13:45:55 +00002947 ver_chain.trust_ca_cb_result = NULL;
2948#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2949
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002950#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
Gilles Peskine449bd832023-01-11 14:50:10 +01002951 if (rs_ctx != NULL && ret != MBEDTLS_ERR_ECP_IN_PROGRESS) {
2952 mbedtls_x509_crt_restart_free(rs_ctx);
2953 }
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02002954#endif
2955
Manuel Pégourié-Gonnard9107b5f2017-07-06 12:16:25 +02002956 /* prevent misuse of the vrfy callback - VERIFY_FAILED would be ignored by
2957 * the SSL module for authmode optional, but non-zero return from the
2958 * callback means a fatal error so it shouldn't be ignored */
Gilles Peskine449bd832023-01-11 14:50:10 +01002959 if (ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED) {
Manuel Pégourié-Gonnard31458a12017-06-26 10:11:49 +02002960 ret = MBEDTLS_ERR_X509_FATAL_ERROR;
Manuel Pégourié-Gonnardd15795a2017-06-22 12:19:27 +02002961 }
2962
Gilles Peskine449bd832023-01-11 14:50:10 +01002963 if (ret != 0) {
2964 *flags = (uint32_t) -1;
2965 return ret;
2966 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002967
Gilles Peskine449bd832023-01-11 14:50:10 +01002968 if (*flags != 0) {
2969 return MBEDTLS_ERR_X509_CERT_VERIFY_FAILED;
2970 }
2971
2972 return 0;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02002973}
2974
Hanno Becker3116fb32019-03-28 13:34:42 +00002975
2976/*
2977 * Verify the certificate validity (default profile, not restartable)
2978 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002979int mbedtls_x509_crt_verify(mbedtls_x509_crt *crt,
2980 mbedtls_x509_crt *trust_ca,
2981 mbedtls_x509_crl *ca_crl,
2982 const char *cn, uint32_t *flags,
2983 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
2984 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00002985{
Gilles Peskine449bd832023-01-11 14:50:10 +01002986 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
2987 NULL, NULL,
2988 &mbedtls_x509_crt_profile_default,
2989 cn, flags,
2990 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00002991}
2992
2993/*
2994 * Verify the certificate validity (user-chosen profile, not restartable)
2995 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002996int mbedtls_x509_crt_verify_with_profile(mbedtls_x509_crt *crt,
2997 mbedtls_x509_crt *trust_ca,
2998 mbedtls_x509_crl *ca_crl,
2999 const mbedtls_x509_crt_profile *profile,
3000 const char *cn, uint32_t *flags,
3001 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3002 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00003003{
Gilles Peskine449bd832023-01-11 14:50:10 +01003004 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
3005 NULL, NULL,
3006 profile, cn, flags,
3007 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00003008}
3009
3010#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
3011/*
3012 * Verify the certificate validity (user-chosen profile, CA callback,
3013 * not restartable).
3014 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003015int mbedtls_x509_crt_verify_with_ca_cb(mbedtls_x509_crt *crt,
3016 mbedtls_x509_crt_ca_cb_t f_ca_cb,
3017 void *p_ca_cb,
3018 const mbedtls_x509_crt_profile *profile,
3019 const char *cn, uint32_t *flags,
3020 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3021 void *p_vrfy)
Hanno Becker3116fb32019-03-28 13:34:42 +00003022{
Gilles Peskine449bd832023-01-11 14:50:10 +01003023 return x509_crt_verify_restartable_ca_cb(crt, NULL, NULL,
3024 f_ca_cb, p_ca_cb,
3025 profile, cn, flags,
3026 f_vrfy, p_vrfy, NULL);
Hanno Becker3116fb32019-03-28 13:34:42 +00003027}
3028#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
3029
Gilles Peskine449bd832023-01-11 14:50:10 +01003030int mbedtls_x509_crt_verify_restartable(mbedtls_x509_crt *crt,
3031 mbedtls_x509_crt *trust_ca,
3032 mbedtls_x509_crl *ca_crl,
3033 const mbedtls_x509_crt_profile *profile,
3034 const char *cn, uint32_t *flags,
3035 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3036 void *p_vrfy,
3037 mbedtls_x509_crt_restart_ctx *rs_ctx)
Hanno Becker3116fb32019-03-28 13:34:42 +00003038{
Gilles Peskine449bd832023-01-11 14:50:10 +01003039 return x509_crt_verify_restartable_ca_cb(crt, trust_ca, ca_crl,
3040 NULL, NULL,
3041 profile, cn, flags,
3042 f_vrfy, p_vrfy, rs_ctx);
Hanno Becker3116fb32019-03-28 13:34:42 +00003043}
3044
3045
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003046/*
Paul Bakker369d2eb2013-09-18 11:58:25 +02003047 * Initialize a certificate chain
3048 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003049void mbedtls_x509_crt_init(mbedtls_x509_crt *crt)
Paul Bakker369d2eb2013-09-18 11:58:25 +02003050{
Gilles Peskine449bd832023-01-11 14:50:10 +01003051 memset(crt, 0, sizeof(mbedtls_x509_crt));
Paul Bakker369d2eb2013-09-18 11:58:25 +02003052}
3053
3054/*
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003055 * Unallocate all certificate data
3056 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003057void mbedtls_x509_crt_free(mbedtls_x509_crt *crt)
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003058{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003059 mbedtls_x509_crt *cert_cur = crt;
3060 mbedtls_x509_crt *cert_prv;
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003061
Gilles Peskine449bd832023-01-11 14:50:10 +01003062 while (cert_cur != NULL) {
3063 mbedtls_pk_free(&cert_cur->pk);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003064
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003065#if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT)
Gilles Peskine449bd832023-01-11 14:50:10 +01003066 mbedtls_free(cert_cur->sig_opts);
Manuel Pégourié-Gonnardf75f2f72014-06-05 15:14:28 +02003067#endif
3068
Gilles Peskine449bd832023-01-11 14:50:10 +01003069 mbedtls_asn1_free_named_data_list_shallow(cert_cur->issuer.next);
3070 mbedtls_asn1_free_named_data_list_shallow(cert_cur->subject.next);
3071 mbedtls_asn1_sequence_free(cert_cur->ext_key_usage.next);
3072 mbedtls_asn1_sequence_free(cert_cur->subject_alt_names.next);
3073 mbedtls_asn1_sequence_free(cert_cur->certificate_policies.next);
Ron Eldor74d9acc2019-03-21 14:00:03 +02003074
toth92ga41954d2021-02-12 16:11:17 +01003075 name_cur = cert_cur->authority_key_id.authorityCertIssuer.next;
3076 while (name_cur != NULL) {
3077 name_prv = name_cur;
3078 name_cur = name_cur->next;
3079 mbedtls_platform_zeroize(name_prv, sizeof(mbedtls_x509_name));
3080 mbedtls_free(name_prv);
3081 }
3082
Gilles Peskine449bd832023-01-11 14:50:10 +01003083 if (cert_cur->raw.p != NULL && cert_cur->own_buffer) {
3084 mbedtls_platform_zeroize(cert_cur->raw.p, cert_cur->raw.len);
3085 mbedtls_free(cert_cur->raw.p);
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003086 }
3087
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003088 cert_prv = cert_cur;
3089 cert_cur = cert_cur->next;
3090
Gilles Peskine449bd832023-01-11 14:50:10 +01003091 mbedtls_platform_zeroize(cert_prv, sizeof(mbedtls_x509_crt));
3092 if (cert_prv != crt) {
3093 mbedtls_free(cert_prv);
3094 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003095 }
Paul Bakker7c6b2c32013-09-16 13:49:26 +02003096}
3097
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003098#if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
3099/*
3100 * Initialize a restart context
3101 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003102void mbedtls_x509_crt_restart_init(mbedtls_x509_crt_restart_ctx *ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003103{
Gilles Peskine449bd832023-01-11 14:50:10 +01003104 mbedtls_pk_restart_init(&ctx->pk);
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003105
3106 ctx->parent = NULL;
3107 ctx->fallback_parent = NULL;
Manuel Pégourié-Gonnard78d7e8c2018-07-02 12:33:14 +02003108 ctx->fallback_signature_is_good = 0;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003109
3110 ctx->parent_is_trusted = -1;
3111
Manuel Pégourié-Gonnarddaf04912017-08-23 12:32:19 +02003112 ctx->in_progress = x509_crt_rs_none;
Manuel Pégourié-Gonnard8b590492017-08-14 18:04:19 +02003113 ctx->self_cnt = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003114 x509_crt_verify_chain_reset(&ctx->ver_chain);
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003115}
3116
3117/*
3118 * Free the components of a restart context
3119 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003120void mbedtls_x509_crt_restart_free(mbedtls_x509_crt_restart_ctx *ctx)
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003121{
Gilles Peskine449bd832023-01-11 14:50:10 +01003122 if (ctx == NULL) {
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003123 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01003124 }
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003125
Gilles Peskine449bd832023-01-11 14:50:10 +01003126 mbedtls_pk_restart_free(&ctx->pk);
3127 mbedtls_x509_crt_restart_init(ctx);
Manuel Pégourié-Gonnardbc3f44a2017-07-11 11:02:20 +02003128}
3129#endif /* MBEDTLS_ECDSA_C && MBEDTLS_ECP_RESTARTABLE */
3130
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003131#endif /* MBEDTLS_X509_CRT_PARSE_C */