2 * X.509 certificate parsing and verification
4 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
5 * SPDX-License-Identifier: Apache-2.0
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
11 * http://www.apache.org/licenses/LICENSE-2.0
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.
19 * This file is part of mbed TLS (https://tls.mbed.org)
22 * The ITU-T X.509 standard defines a certificate format for PKI.
24 * http://www.ietf.org/rfc/rfc5280.txt (Certificates and CRLs)
25 * http://www.ietf.org/rfc/rfc3279.txt (Alg IDs for CRLs)
26 * http://www.ietf.org/rfc/rfc2986.txt (CSRs, aka PKCS#10)
28 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.680-0207.pdf
29 * http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf
31 * [SIRO] https://cabforum.org/wp-content/uploads/Chunghwatelecom201503cabforumV4.pdf
34 #if !defined(MBEDTLS_CONFIG_FILE)
35 #include "mbedtls/config.h"
37 #include MBEDTLS_CONFIG_FILE
40 #if defined(MBEDTLS_X509_CRT_PARSE_C)
42 #include "mbedtls/x509_crt.h"
43 #include "mbedtls/oid.h"
44 #include "mbedtls/platform_util.h"
48 #if defined(MBEDTLS_PEM_PARSE_C)
49 #include "mbedtls/pem.h"
52 #if defined(MBEDTLS_USE_PSA_CRYPTO)
53 #include "psa/crypto.h"
54 #include "mbedtls/psa_util.h"
57 #if defined(MBEDTLS_PLATFORM_C)
58 #include "mbedtls/platform.h"
62 #define mbedtls_free free
63 #define mbedtls_calloc calloc
64 #define mbedtls_snprintf snprintf
67 #if defined(MBEDTLS_THREADING_C)
68 #include "mbedtls/threading.h"
71 #if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
77 #if defined(MBEDTLS_FS_IO)
79 #if !defined(_WIN32) || defined(EFIX64) || defined(EFI32)
80 #include <sys/types.h>
83 #endif /* !_WIN32 || EFIX64 || EFI32 */
87 * Item in a verification chain: cert and flags for it
90 mbedtls_x509_crt *crt;
92 } x509_crt_verify_chain_item;
95 * Max size of verification chain: end-entity + intermediates + trusted root
97 #define X509_MAX_VERIFY_CHAIN_SIZE ( MBEDTLS_X509_MAX_INTERMEDIATE_CA + 2 )
102 const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_default =
104 #if defined(MBEDTLS_TLS_DEFAULT_ALLOW_SHA1_IN_CERTIFICATES)
105 /* Allow SHA-1 (weak, but still safe in controlled environments) */
106 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA1 ) |
108 /* Only SHA-2 hashes */
109 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA224 ) |
110 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA256 ) |
111 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA384 ) |
112 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA512 ),
113 0xFFFFFFF, /* Any PK alg */
114 0xFFFFFFF, /* Any curve */
119 * Next-default profile
121 const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_next =
123 /* Hashes from SHA-256 and above */
124 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA256 ) |
125 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA384 ) |
126 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA512 ),
127 0xFFFFFFF, /* Any PK alg */
128 #if defined(MBEDTLS_ECP_C)
129 /* Curves at or above 128-bit security level */
130 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP256R1 ) |
131 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP384R1 ) |
132 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP521R1 ) |
133 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_BP256R1 ) |
134 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_BP384R1 ) |
135 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_BP512R1 ) |
136 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP256K1 ),
144 * NSA Suite B Profile
146 const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_suiteb =
148 /* Only SHA-256 and 384 */
149 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA256 ) |
150 MBEDTLS_X509_ID_FLAG( MBEDTLS_MD_SHA384 ),
152 MBEDTLS_X509_ID_FLAG( MBEDTLS_PK_ECDSA ) |
153 MBEDTLS_X509_ID_FLAG( MBEDTLS_PK_ECKEY ),
154 #if defined(MBEDTLS_ECP_C)
155 /* Only NIST P-256 and P-384 */
156 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP256R1 ) |
157 MBEDTLS_X509_ID_FLAG( MBEDTLS_ECP_DP_SECP384R1 ),
165 * Check md_alg against profile
166 * Return 0 if md_alg is acceptable for this profile, -1 otherwise
168 static int x509_profile_check_md_alg( const mbedtls_x509_crt_profile *profile,
169 mbedtls_md_type_t md_alg )
171 if( md_alg == MBEDTLS_MD_NONE )
174 if( ( profile->allowed_mds & MBEDTLS_X509_ID_FLAG( md_alg ) ) != 0 )
181 * Check pk_alg against profile
182 * Return 0 if pk_alg is acceptable for this profile, -1 otherwise
184 static int x509_profile_check_pk_alg( const mbedtls_x509_crt_profile *profile,
185 mbedtls_pk_type_t pk_alg )
187 if( pk_alg == MBEDTLS_PK_NONE )
190 if( ( profile->allowed_pks & MBEDTLS_X509_ID_FLAG( pk_alg ) ) != 0 )
197 * Check key against profile
198 * Return 0 if pk is acceptable for this profile, -1 otherwise
200 static int x509_profile_check_key( const mbedtls_x509_crt_profile *profile,
201 const mbedtls_pk_context *pk )
203 const mbedtls_pk_type_t pk_alg = mbedtls_pk_get_type( pk );
205 #if defined(MBEDTLS_RSA_C)
206 if( pk_alg == MBEDTLS_PK_RSA || pk_alg == MBEDTLS_PK_RSASSA_PSS )
208 if( mbedtls_pk_get_bitlen( pk ) >= profile->rsa_min_bitlen )
215 #if defined(MBEDTLS_ECP_C)
216 if( pk_alg == MBEDTLS_PK_ECDSA ||
217 pk_alg == MBEDTLS_PK_ECKEY ||
218 pk_alg == MBEDTLS_PK_ECKEY_DH )
220 const mbedtls_ecp_group_id gid = mbedtls_pk_ec( *pk )->grp.id;
222 if( gid == MBEDTLS_ECP_DP_NONE )
225 if( ( profile->allowed_curves & MBEDTLS_X509_ID_FLAG( gid ) ) != 0 )
236 * Like memcmp, but case-insensitive and always returns -1 if different
238 static int x509_memcasecmp( const void *s1, const void *s2, size_t len )
242 const unsigned char *n1 = s1, *n2 = s2;
244 for( i = 0; i < len; i++ )
246 diff = n1[i] ^ n2[i];
252 ( ( n1[i] >= 'a' && n1[i] <= 'z' ) ||
253 ( n1[i] >= 'A' && n1[i] <= 'Z' ) ) )
265 * Return 0 if name matches wildcard, -1 otherwise
267 static int x509_check_wildcard( const char *cn, const mbedtls_x509_buf *name )
270 size_t cn_idx = 0, cn_len = strlen( cn );
272 /* We can't have a match if there is no wildcard to match */
273 if( name->len < 3 || name->p[0] != '*' || name->p[1] != '.' )
276 for( i = 0; i < cn_len; ++i )
288 if( cn_len - cn_idx == name->len - 1 &&
289 x509_memcasecmp( name->p + 1, cn + cn_idx, name->len - 1 ) == 0 )
298 * Compare two X.509 strings, case-insensitive, and allowing for some encoding
299 * variations (but not all).
301 * Return 0 if equal, -1 otherwise.
303 static int x509_string_cmp( const mbedtls_x509_buf *a, const mbedtls_x509_buf *b )
305 if( a->tag == b->tag &&
307 memcmp( a->p, b->p, b->len ) == 0 )
312 if( ( a->tag == MBEDTLS_ASN1_UTF8_STRING || a->tag == MBEDTLS_ASN1_PRINTABLE_STRING ) &&
313 ( b->tag == MBEDTLS_ASN1_UTF8_STRING || b->tag == MBEDTLS_ASN1_PRINTABLE_STRING ) &&
315 x509_memcasecmp( a->p, b->p, b->len ) == 0 )
324 * Compare two X.509 Names (aka rdnSequence).
326 * See RFC 5280 section 7.1, though we don't implement the whole algorithm:
327 * we sometimes return unequal when the full algorithm would return equal,
328 * but never the other way. (In particular, we don't do Unicode normalisation
331 * Return 0 if equal, -1 otherwise.
333 static int x509_name_cmp( const mbedtls_x509_name *a, const mbedtls_x509_name *b )
335 /* Avoid recursion, it might not be optimised by the compiler */
336 while( a != NULL || b != NULL )
338 if( a == NULL || b == NULL )
342 if( a->oid.tag != b->oid.tag ||
343 a->oid.len != b->oid.len ||
344 memcmp( a->oid.p, b->oid.p, b->oid.len ) != 0 )
350 if( x509_string_cmp( &a->val, &b->val ) != 0 )
353 /* structure of the list of sets */
354 if( a->next_merged != b->next_merged )
366 * Reset (init or clear) a verify_chain
368 static void x509_crt_verify_chain_reset(
369 mbedtls_x509_crt_verify_chain *ver_chain )
373 for( i = 0; i < MBEDTLS_X509_MAX_VERIFY_CHAIN_SIZE; i++ )
375 ver_chain->items[i].crt = NULL;
376 ver_chain->items[i].flags = (uint32_t) -1;
381 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
382 ver_chain->trust_ca_cb_result = NULL;
383 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
387 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
389 static int x509_get_version( unsigned char **p,
390 const unsigned char *end,
396 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
397 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED | 0 ) ) != 0 )
399 if( ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
410 if( ( ret = mbedtls_asn1_get_int( p, end, ver ) ) != 0 )
411 return( MBEDTLS_ERR_X509_INVALID_VERSION + ret );
414 return( MBEDTLS_ERR_X509_INVALID_VERSION +
415 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
421 * Validity ::= SEQUENCE {
425 static int x509_get_dates( unsigned char **p,
426 const unsigned char *end,
427 mbedtls_x509_time *from,
428 mbedtls_x509_time *to )
433 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
434 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
435 return( MBEDTLS_ERR_X509_INVALID_DATE + ret );
439 if( ( ret = mbedtls_x509_get_time( p, end, from ) ) != 0 )
442 if( ( ret = mbedtls_x509_get_time( p, end, to ) ) != 0 )
446 return( MBEDTLS_ERR_X509_INVALID_DATE +
447 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
453 * X.509 v2/v3 unique identifier (not parsed)
455 static int x509_get_uid( unsigned char **p,
456 const unsigned char *end,
457 mbedtls_x509_buf *uid, int n )
466 if( ( ret = mbedtls_asn1_get_tag( p, end, &uid->len,
467 MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_ASN1_CONSTRUCTED | n ) ) != 0 )
469 if( ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
481 static int x509_get_basic_constraints( unsigned char **p,
482 const unsigned char *end,
490 * BasicConstraints ::= SEQUENCE {
491 * cA BOOLEAN DEFAULT FALSE,
492 * pathLenConstraint INTEGER (0..MAX) OPTIONAL }
494 *ca_istrue = 0; /* DEFAULT FALSE */
495 *max_pathlen = 0; /* endless */
497 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
498 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
499 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
504 if( ( ret = mbedtls_asn1_get_bool( p, end, ca_istrue ) ) != 0 )
506 if( ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
507 ret = mbedtls_asn1_get_int( p, end, ca_istrue );
510 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
512 if( *ca_istrue != 0 )
519 if( ( ret = mbedtls_asn1_get_int( p, end, max_pathlen ) ) != 0 )
520 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
523 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
524 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
531 static int x509_get_ns_cert_type( unsigned char **p,
532 const unsigned char *end,
533 unsigned char *ns_cert_type)
536 mbedtls_x509_bitstring bs = { 0, 0, NULL };
538 if( ( ret = mbedtls_asn1_get_bitstring( p, end, &bs ) ) != 0 )
539 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
542 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
543 MBEDTLS_ERR_ASN1_INVALID_LENGTH );
545 /* Get actual bitstring */
546 *ns_cert_type = *bs.p;
550 static int x509_get_key_usage( unsigned char **p,
551 const unsigned char *end,
552 unsigned int *key_usage)
556 mbedtls_x509_bitstring bs = { 0, 0, NULL };
558 if( ( ret = mbedtls_asn1_get_bitstring( p, end, &bs ) ) != 0 )
559 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
562 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
563 MBEDTLS_ERR_ASN1_INVALID_LENGTH );
565 /* Get actual bitstring */
567 for( i = 0; i < bs.len && i < sizeof( unsigned int ); i++ )
569 *key_usage |= (unsigned int) bs.p[i] << (8*i);
576 * ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
578 * KeyPurposeId ::= OBJECT IDENTIFIER
580 static int x509_get_ext_key_usage( unsigned char **p,
581 const unsigned char *end,
582 mbedtls_x509_sequence *ext_key_usage)
586 if( ( ret = mbedtls_asn1_get_sequence_of( p, end, ext_key_usage, MBEDTLS_ASN1_OID ) ) != 0 )
587 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
589 /* Sequence length must be >= 1 */
590 if( ext_key_usage->buf.p == NULL )
591 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
592 MBEDTLS_ERR_ASN1_INVALID_LENGTH );
598 * SubjectAltName ::= GeneralNames
600 * GeneralNames ::= SEQUENCE SIZE (1..MAX) OF GeneralName
602 * GeneralName ::= CHOICE {
603 * otherName [0] OtherName,
604 * rfc822Name [1] IA5String,
605 * dNSName [2] IA5String,
606 * x400Address [3] ORAddress,
607 * directoryName [4] Name,
608 * ediPartyName [5] EDIPartyName,
609 * uniformResourceIdentifier [6] IA5String,
610 * iPAddress [7] OCTET STRING,
611 * registeredID [8] OBJECT IDENTIFIER }
613 * OtherName ::= SEQUENCE {
614 * type-id OBJECT IDENTIFIER,
615 * value [0] EXPLICIT ANY DEFINED BY type-id }
617 * EDIPartyName ::= SEQUENCE {
618 * nameAssigner [0] DirectoryString OPTIONAL,
619 * partyName [1] DirectoryString }
621 * NOTE: we list all types, but only use dNSName and otherName
622 * of type HwModuleName, as defined in RFC 4108, at this point.
624 static int x509_get_subject_alt_name( unsigned char **p,
625 const unsigned char *end,
626 mbedtls_x509_sequence *subject_alt_name )
630 mbedtls_asn1_buf *buf;
632 mbedtls_asn1_sequence *cur = subject_alt_name;
634 /* Get main sequence tag */
635 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
636 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
637 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
639 if( *p + len != end )
640 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
641 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
645 mbedtls_x509_subject_alternative_name dummy_san_buf;
646 memset( &dummy_san_buf, 0, sizeof( dummy_san_buf ) );
648 if( ( end - *p ) < 1 )
649 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
650 MBEDTLS_ERR_ASN1_OUT_OF_DATA );
654 if( ( ret = mbedtls_asn1_get_len( p, end, &tag_len ) ) != 0 )
655 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
657 if( ( tag & MBEDTLS_ASN1_TAG_CLASS_MASK ) !=
658 MBEDTLS_ASN1_CONTEXT_SPECIFIC )
660 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
661 MBEDTLS_ERR_ASN1_UNEXPECTED_TAG );
665 * Check that the SAN are structured correct.
667 ret = mbedtls_x509_parse_subject_alt_name( &(cur->buf), &dummy_san_buf );
669 * In case the extension is malformed, return an error,
670 * and clear the allocated sequences.
672 if( ret != 0 && ret != MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE )
674 mbedtls_x509_sequence *seq_cur = subject_alt_name->next;
675 mbedtls_x509_sequence *seq_prv;
676 while( seq_cur != NULL )
679 seq_cur = seq_cur->next;
680 mbedtls_platform_zeroize( seq_prv,
681 sizeof( mbedtls_x509_sequence ) );
682 mbedtls_free( seq_prv );
684 subject_alt_name->next = NULL;
688 /* Allocate and assign next pointer */
689 if( cur->buf.p != NULL )
691 if( cur->next != NULL )
692 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS );
694 cur->next = mbedtls_calloc( 1, sizeof( mbedtls_asn1_sequence ) );
696 if( cur->next == NULL )
697 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
698 MBEDTLS_ERR_ASN1_ALLOC_FAILED );
710 /* Set final sequence entry's next pointer to NULL */
714 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
715 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
721 * id-ce-certificatePolicies OBJECT IDENTIFIER ::= { id-ce 32 }
723 * anyPolicy OBJECT IDENTIFIER ::= { id-ce-certificatePolicies 0 }
725 * certificatePolicies ::= SEQUENCE SIZE (1..MAX) OF PolicyInformation
727 * PolicyInformation ::= SEQUENCE {
728 * policyIdentifier CertPolicyId,
729 * policyQualifiers SEQUENCE SIZE (1..MAX) OF
730 * PolicyQualifierInfo OPTIONAL }
732 * CertPolicyId ::= OBJECT IDENTIFIER
734 * PolicyQualifierInfo ::= SEQUENCE {
735 * policyQualifierId PolicyQualifierId,
736 * qualifier ANY DEFINED BY policyQualifierId }
738 * -- policyQualifierIds for Internet policy qualifiers
740 * id-qt OBJECT IDENTIFIER ::= { id-pkix 2 }
741 * id-qt-cps OBJECT IDENTIFIER ::= { id-qt 1 }
742 * id-qt-unotice OBJECT IDENTIFIER ::= { id-qt 2 }
744 * PolicyQualifierId ::= OBJECT IDENTIFIER ( id-qt-cps | id-qt-unotice )
746 * Qualifier ::= CHOICE {
748 * userNotice UserNotice }
750 * CPSuri ::= IA5String
752 * UserNotice ::= SEQUENCE {
753 * noticeRef NoticeReference OPTIONAL,
754 * explicitText DisplayText OPTIONAL }
756 * NoticeReference ::= SEQUENCE {
757 * organization DisplayText,
758 * noticeNumbers SEQUENCE OF INTEGER }
760 * DisplayText ::= CHOICE {
761 * ia5String IA5String (SIZE (1..200)),
762 * visibleString VisibleString (SIZE (1..200)),
763 * bmpString BMPString (SIZE (1..200)),
764 * utf8String UTF8String (SIZE (1..200)) }
766 * NOTE: we only parse and use anyPolicy without qualifiers at this point
767 * as defined in RFC 5280.
769 static int x509_get_certificate_policies( unsigned char **p,
770 const unsigned char *end,
771 mbedtls_x509_sequence *certificate_policies )
773 int ret, parse_ret = 0;
775 mbedtls_asn1_buf *buf;
776 mbedtls_asn1_sequence *cur = certificate_policies;
778 /* Get main sequence tag */
779 ret = mbedtls_asn1_get_tag( p, end, &len,
780 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE );
782 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
784 if( *p + len != end )
785 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
786 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
789 * Cannot be an empty sequence.
792 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
793 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
797 mbedtls_x509_buf policy_oid;
798 const unsigned char *policy_end;
801 * Get the policy sequence
803 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
804 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
805 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
807 policy_end = *p + len;
809 if( ( ret = mbedtls_asn1_get_tag( p, policy_end, &len,
810 MBEDTLS_ASN1_OID ) ) != 0 )
811 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
813 policy_oid.tag = MBEDTLS_ASN1_OID;
814 policy_oid.len = len;
818 * Only AnyPolicy is currently supported when enforcing policy.
820 if( MBEDTLS_OID_CMP( MBEDTLS_OID_ANY_POLICY, &policy_oid ) != 0 )
823 * Set the parsing return code but continue parsing, in case this
824 * extension is critical and MBEDTLS_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION
827 parse_ret = MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE;
830 /* Allocate and assign next pointer */
831 if( cur->buf.p != NULL )
833 if( cur->next != NULL )
834 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS );
836 cur->next = mbedtls_calloc( 1, sizeof( mbedtls_asn1_sequence ) );
838 if( cur->next == NULL )
839 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
840 MBEDTLS_ERR_ASN1_ALLOC_FAILED );
846 buf->tag = policy_oid.tag;
847 buf->p = policy_oid.p;
848 buf->len = policy_oid.len;
853 * If there is an optional qualifier, then *p < policy_end
854 * Check the Qualifier len to verify it doesn't exceed policy_end.
856 if( *p < policy_end )
858 if( ( ret = mbedtls_asn1_get_tag( p, policy_end, &len,
859 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
860 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
862 * Skip the optional policy qualifiers.
867 if( *p != policy_end )
868 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
869 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
872 /* Set final sequence entry's next pointer to NULL */
876 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
877 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
883 * X.509 v3 extensions
886 static int x509_get_crt_ext( unsigned char **p,
887 const unsigned char *end,
888 mbedtls_x509_crt *crt )
892 unsigned char *end_ext_data, *end_ext_octet;
894 if( ( ret = mbedtls_x509_get_ext( p, end, &crt->v3_ext, 3 ) ) != 0 )
896 if( ret == MBEDTLS_ERR_ASN1_UNEXPECTED_TAG )
905 * Extension ::= SEQUENCE {
906 * extnID OBJECT IDENTIFIER,
907 * critical BOOLEAN DEFAULT FALSE,
908 * extnValue OCTET STRING }
910 mbedtls_x509_buf extn_oid = {0, 0, NULL};
911 int is_critical = 0; /* DEFAULT FALSE */
914 if( ( ret = mbedtls_asn1_get_tag( p, end, &len,
915 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
916 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
918 end_ext_data = *p + len;
920 /* Get extension ID */
921 if( ( ret = mbedtls_asn1_get_tag( p, end_ext_data, &extn_oid.len,
922 MBEDTLS_ASN1_OID ) ) != 0 )
923 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
925 extn_oid.tag = MBEDTLS_ASN1_OID;
929 /* Get optional critical */
930 if( ( ret = mbedtls_asn1_get_bool( p, end_ext_data, &is_critical ) ) != 0 &&
931 ( ret != MBEDTLS_ERR_ASN1_UNEXPECTED_TAG ) )
932 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
934 /* Data should be octet string type */
935 if( ( ret = mbedtls_asn1_get_tag( p, end_ext_data, &len,
936 MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
937 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
939 end_ext_octet = *p + len;
941 if( end_ext_octet != end_ext_data )
942 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
943 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
946 * Detect supported extensions
948 ret = mbedtls_oid_get_x509_ext_type( &extn_oid, &ext_type );
952 /* No parser found, skip extension */
955 #if !defined(MBEDTLS_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION)
958 /* Data is marked as critical: fail */
959 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
960 MBEDTLS_ERR_ASN1_UNEXPECTED_TAG );
966 /* Forbid repeated extensions */
967 if( ( crt->ext_types & ext_type ) != 0 )
968 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS );
970 crt->ext_types |= ext_type;
974 case MBEDTLS_X509_EXT_BASIC_CONSTRAINTS:
975 /* Parse basic constraints */
976 if( ( ret = x509_get_basic_constraints( p, end_ext_octet,
977 &crt->ca_istrue, &crt->max_pathlen ) ) != 0 )
981 case MBEDTLS_X509_EXT_KEY_USAGE:
982 /* Parse key usage */
983 if( ( ret = x509_get_key_usage( p, end_ext_octet,
984 &crt->key_usage ) ) != 0 )
988 case MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE:
989 /* Parse extended key usage */
990 if( ( ret = x509_get_ext_key_usage( p, end_ext_octet,
991 &crt->ext_key_usage ) ) != 0 )
995 case MBEDTLS_X509_EXT_SUBJECT_ALT_NAME:
996 /* Parse subject alt name */
997 if( ( ret = x509_get_subject_alt_name( p, end_ext_octet,
998 &crt->subject_alt_names ) ) != 0 )
1002 case MBEDTLS_X509_EXT_NS_CERT_TYPE:
1003 /* Parse netscape certificate type */
1004 if( ( ret = x509_get_ns_cert_type( p, end_ext_octet,
1005 &crt->ns_cert_type ) ) != 0 )
1009 case MBEDTLS_OID_X509_EXT_CERTIFICATE_POLICIES:
1010 /* Parse certificate policies type */
1011 if( ( ret = x509_get_certificate_policies( p, end_ext_octet,
1012 &crt->certificate_policies ) ) != 0 )
1014 #if !defined(MBEDTLS_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION)
1020 * If MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE is returned, then we
1021 * cannot interpret or enforce the policy. However, it is up to
1022 * the user to choose how to enforce the policies,
1023 * unless the extension is critical.
1025 if( ret != MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE )
1032 * If this is a non-critical extension, which the oid layer
1033 * supports, but there isn't an x509 parser for it,
1034 * skip the extension.
1036 #if !defined(MBEDTLS_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION)
1038 return( MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE );
1046 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
1047 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1053 * Parse and fill a single X.509 certificate in DER format
1055 static int x509_crt_parse_der_core( mbedtls_x509_crt *crt,
1056 const unsigned char *buf,
1062 unsigned char *p, *end, *crt_end;
1063 mbedtls_x509_buf sig_params1, sig_params2, sig_oid2;
1065 memset( &sig_params1, 0, sizeof( mbedtls_x509_buf ) );
1066 memset( &sig_params2, 0, sizeof( mbedtls_x509_buf ) );
1067 memset( &sig_oid2, 0, sizeof( mbedtls_x509_buf ) );
1070 * Check for valid input
1072 if( crt == NULL || buf == NULL )
1073 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1075 /* Use the original buffer until we figure out actual length. */
1076 p = (unsigned char*) buf;
1081 * Certificate ::= SEQUENCE {
1082 * tbsCertificate TBSCertificate,
1083 * signatureAlgorithm AlgorithmIdentifier,
1084 * signatureValue BIT STRING }
1086 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1087 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
1089 mbedtls_x509_crt_free( crt );
1090 return( MBEDTLS_ERR_X509_INVALID_FORMAT );
1093 end = crt_end = p + len;
1094 crt->raw.len = crt_end - buf;
1095 if( make_copy != 0 )
1097 /* Create and populate a new buffer for the raw field. */
1098 crt->raw.p = p = mbedtls_calloc( 1, crt->raw.len );
1099 if( crt->raw.p == NULL )
1100 return( MBEDTLS_ERR_X509_ALLOC_FAILED );
1102 memcpy( crt->raw.p, buf, crt->raw.len );
1103 crt->own_buffer = 1;
1105 p += crt->raw.len - len;
1106 end = crt_end = p + len;
1110 crt->raw.p = (unsigned char*) buf;
1111 crt->own_buffer = 0;
1115 * TBSCertificate ::= SEQUENCE {
1119 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1120 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
1122 mbedtls_x509_crt_free( crt );
1123 return( MBEDTLS_ERR_X509_INVALID_FORMAT + ret );
1127 crt->tbs.len = end - crt->tbs.p;
1130 * Version ::= INTEGER { v1(0), v2(1), v3(2) }
1132 * CertificateSerialNumber ::= INTEGER
1134 * signature AlgorithmIdentifier
1136 if( ( ret = x509_get_version( &p, end, &crt->version ) ) != 0 ||
1137 ( ret = mbedtls_x509_get_serial( &p, end, &crt->serial ) ) != 0 ||
1138 ( ret = mbedtls_x509_get_alg( &p, end, &crt->sig_oid,
1139 &sig_params1 ) ) != 0 )
1141 mbedtls_x509_crt_free( crt );
1145 if( crt->version < 0 || crt->version > 2 )
1147 mbedtls_x509_crt_free( crt );
1148 return( MBEDTLS_ERR_X509_UNKNOWN_VERSION );
1153 if( ( ret = mbedtls_x509_get_sig_alg( &crt->sig_oid, &sig_params1,
1154 &crt->sig_md, &crt->sig_pk,
1155 &crt->sig_opts ) ) != 0 )
1157 mbedtls_x509_crt_free( crt );
1164 crt->issuer_raw.p = p;
1166 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1167 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
1169 mbedtls_x509_crt_free( crt );
1170 return( MBEDTLS_ERR_X509_INVALID_FORMAT + ret );
1173 if( ( ret = mbedtls_x509_get_name( &p, p + len, &crt->issuer ) ) != 0 )
1175 mbedtls_x509_crt_free( crt );
1179 crt->issuer_raw.len = p - crt->issuer_raw.p;
1182 * Validity ::= SEQUENCE {
1187 if( ( ret = x509_get_dates( &p, end, &crt->valid_from,
1188 &crt->valid_to ) ) != 0 )
1190 mbedtls_x509_crt_free( crt );
1197 crt->subject_raw.p = p;
1199 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1200 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
1202 mbedtls_x509_crt_free( crt );
1203 return( MBEDTLS_ERR_X509_INVALID_FORMAT + ret );
1206 if( len && ( ret = mbedtls_x509_get_name( &p, p + len, &crt->subject ) ) != 0 )
1208 mbedtls_x509_crt_free( crt );
1212 crt->subject_raw.len = p - crt->subject_raw.p;
1215 * SubjectPublicKeyInfo
1218 if( ( ret = mbedtls_pk_parse_subpubkey( &p, end, &crt->pk ) ) != 0 )
1220 mbedtls_x509_crt_free( crt );
1223 crt->pk_raw.len = p - crt->pk_raw.p;
1226 * issuerUniqueID [1] IMPLICIT UniqueIdentifier OPTIONAL,
1227 * -- If present, version shall be v2 or v3
1228 * subjectUniqueID [2] IMPLICIT UniqueIdentifier OPTIONAL,
1229 * -- If present, version shall be v2 or v3
1230 * extensions [3] EXPLICIT Extensions OPTIONAL
1231 * -- If present, version shall be v3
1233 if( crt->version == 2 || crt->version == 3 )
1235 ret = x509_get_uid( &p, end, &crt->issuer_id, 1 );
1238 mbedtls_x509_crt_free( crt );
1243 if( crt->version == 2 || crt->version == 3 )
1245 ret = x509_get_uid( &p, end, &crt->subject_id, 2 );
1248 mbedtls_x509_crt_free( crt );
1253 #if !defined(MBEDTLS_X509_ALLOW_EXTENSIONS_NON_V3)
1254 if( crt->version == 3 )
1257 ret = x509_get_crt_ext( &p, end, crt );
1260 mbedtls_x509_crt_free( crt );
1267 mbedtls_x509_crt_free( crt );
1268 return( MBEDTLS_ERR_X509_INVALID_FORMAT +
1269 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1276 * -- end of TBSCertificate
1278 * signatureAlgorithm AlgorithmIdentifier,
1279 * signatureValue BIT STRING
1281 if( ( ret = mbedtls_x509_get_alg( &p, end, &sig_oid2, &sig_params2 ) ) != 0 )
1283 mbedtls_x509_crt_free( crt );
1287 if( crt->sig_oid.len != sig_oid2.len ||
1288 memcmp( crt->sig_oid.p, sig_oid2.p, crt->sig_oid.len ) != 0 ||
1289 sig_params1.len != sig_params2.len ||
1290 ( sig_params1.len != 0 &&
1291 memcmp( sig_params1.p, sig_params2.p, sig_params1.len ) != 0 ) )
1293 mbedtls_x509_crt_free( crt );
1294 return( MBEDTLS_ERR_X509_SIG_MISMATCH );
1297 if( ( ret = mbedtls_x509_get_sig( &p, end, &crt->sig ) ) != 0 )
1299 mbedtls_x509_crt_free( crt );
1305 mbedtls_x509_crt_free( crt );
1306 return( MBEDTLS_ERR_X509_INVALID_FORMAT +
1307 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1314 * Parse one X.509 certificate in DER format from a buffer and add them to a
1317 static int mbedtls_x509_crt_parse_der_internal( mbedtls_x509_crt *chain,
1318 const unsigned char *buf,
1323 mbedtls_x509_crt *crt = chain, *prev = NULL;
1326 * Check for valid input
1328 if( crt == NULL || buf == NULL )
1329 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1331 while( crt->version != 0 && crt->next != NULL )
1338 * Add new certificate on the end of the chain if needed.
1340 if( crt->version != 0 && crt->next == NULL )
1342 crt->next = mbedtls_calloc( 1, sizeof( mbedtls_x509_crt ) );
1344 if( crt->next == NULL )
1345 return( MBEDTLS_ERR_X509_ALLOC_FAILED );
1348 mbedtls_x509_crt_init( crt->next );
1352 if( ( ret = x509_crt_parse_der_core( crt, buf, buflen, make_copy ) ) != 0 )
1358 mbedtls_free( crt );
1366 int mbedtls_x509_crt_parse_der_nocopy( mbedtls_x509_crt *chain,
1367 const unsigned char *buf,
1370 return( mbedtls_x509_crt_parse_der_internal( chain, buf, buflen, 0 ) );
1373 int mbedtls_x509_crt_parse_der( mbedtls_x509_crt *chain,
1374 const unsigned char *buf,
1377 return( mbedtls_x509_crt_parse_der_internal( chain, buf, buflen, 1 ) );
1381 * Parse one or more PEM certificates from a buffer and add them to the chained
1384 int mbedtls_x509_crt_parse( mbedtls_x509_crt *chain,
1385 const unsigned char *buf,
1388 #if defined(MBEDTLS_PEM_PARSE_C)
1389 int success = 0, first_error = 0, total_failed = 0;
1390 int buf_format = MBEDTLS_X509_FORMAT_DER;
1394 * Check for valid input
1396 if( chain == NULL || buf == NULL )
1397 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1400 * Determine buffer content. Buffer contains either one DER certificate or
1401 * one or more PEM certificates.
1403 #if defined(MBEDTLS_PEM_PARSE_C)
1404 if( buflen != 0 && buf[buflen - 1] == '\0' &&
1405 strstr( (const char *) buf, "-----BEGIN CERTIFICATE-----" ) != NULL )
1407 buf_format = MBEDTLS_X509_FORMAT_PEM;
1410 if( buf_format == MBEDTLS_X509_FORMAT_DER )
1411 return mbedtls_x509_crt_parse_der( chain, buf, buflen );
1413 return mbedtls_x509_crt_parse_der( chain, buf, buflen );
1416 #if defined(MBEDTLS_PEM_PARSE_C)
1417 if( buf_format == MBEDTLS_X509_FORMAT_PEM )
1420 mbedtls_pem_context pem;
1422 /* 1 rather than 0 since the terminating NULL byte is counted in */
1426 mbedtls_pem_init( &pem );
1428 /* If we get there, we know the string is null-terminated */
1429 ret = mbedtls_pem_read_buffer( &pem,
1430 "-----BEGIN CERTIFICATE-----",
1431 "-----END CERTIFICATE-----",
1432 buf, NULL, 0, &use_len );
1442 else if( ret == MBEDTLS_ERR_PEM_BAD_INPUT_DATA )
1446 else if( ret != MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT )
1448 mbedtls_pem_free( &pem );
1451 * PEM header and footer were found
1456 if( first_error == 0 )
1465 ret = mbedtls_x509_crt_parse_der( chain, pem.buf, pem.buflen );
1467 mbedtls_pem_free( &pem );
1472 * Quit parsing on a memory error
1474 if( ret == MBEDTLS_ERR_X509_ALLOC_FAILED )
1477 if( first_error == 0 )
1489 return( total_failed );
1490 else if( first_error )
1491 return( first_error );
1493 return( MBEDTLS_ERR_X509_CERT_UNKNOWN_FORMAT );
1494 #endif /* MBEDTLS_PEM_PARSE_C */
1497 #if defined(MBEDTLS_FS_IO)
1499 * Load one or more certificates and add them to the chained list
1501 int mbedtls_x509_crt_parse_file( mbedtls_x509_crt *chain, const char *path )
1507 if( ( ret = mbedtls_pk_load_file( path, &buf, &n ) ) != 0 )
1510 ret = mbedtls_x509_crt_parse( chain, buf, n );
1512 mbedtls_platform_zeroize( buf, n );
1513 mbedtls_free( buf );
1518 int mbedtls_x509_crt_parse_path( mbedtls_x509_crt *chain, const char *path )
1521 #if defined(_WIN32) && !defined(EFIX64) && !defined(EFI32)
1523 WCHAR szDir[MAX_PATH];
1524 char filename[MAX_PATH];
1526 size_t len = strlen( path );
1528 WIN32_FIND_DATAW file_data;
1531 if( len > MAX_PATH - 3 )
1532 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1534 memset( szDir, 0, sizeof(szDir) );
1535 memset( filename, 0, MAX_PATH );
1536 memcpy( filename, path, len );
1537 filename[len++] = '\\';
1539 filename[len++] = '*';
1541 w_ret = MultiByteToWideChar( CP_ACP, 0, filename, (int)len, szDir,
1544 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1546 hFind = FindFirstFileW( szDir, &file_data );
1547 if( hFind == INVALID_HANDLE_VALUE )
1548 return( MBEDTLS_ERR_X509_FILE_IO_ERROR );
1550 len = MAX_PATH - len;
1553 memset( p, 0, len );
1555 if( file_data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY )
1558 w_ret = WideCharToMultiByte( CP_ACP, 0, file_data.cFileName,
1559 lstrlenW( file_data.cFileName ),
1564 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1568 w_ret = mbedtls_x509_crt_parse_file( chain, filename );
1574 while( FindNextFileW( hFind, &file_data ) != 0 );
1576 if( GetLastError() != ERROR_NO_MORE_FILES )
1577 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1585 struct dirent *entry;
1586 char entry_name[MBEDTLS_X509_MAX_FILE_PATH_LEN];
1587 DIR *dir = opendir( path );
1590 return( MBEDTLS_ERR_X509_FILE_IO_ERROR );
1592 #if defined(MBEDTLS_THREADING_C)
1593 if( ( ret = mbedtls_mutex_lock( &mbedtls_threading_readdir_mutex ) ) != 0 )
1598 #endif /* MBEDTLS_THREADING_C */
1600 while( ( entry = readdir( dir ) ) != NULL )
1602 snp_ret = mbedtls_snprintf( entry_name, sizeof entry_name,
1603 "%s/%s", path, entry->d_name );
1605 if( snp_ret < 0 || (size_t)snp_ret >= sizeof entry_name )
1607 ret = MBEDTLS_ERR_X509_BUFFER_TOO_SMALL;
1610 else if( stat( entry_name, &sb ) == -1 )
1612 ret = MBEDTLS_ERR_X509_FILE_IO_ERROR;
1616 if( !S_ISREG( sb.st_mode ) )
1619 // Ignore parse errors
1621 t_ret = mbedtls_x509_crt_parse_file( chain, entry_name );
1631 #if defined(MBEDTLS_THREADING_C)
1632 if( mbedtls_mutex_unlock( &mbedtls_threading_readdir_mutex ) != 0 )
1633 ret = MBEDTLS_ERR_THREADING_MUTEX_ERROR;
1634 #endif /* MBEDTLS_THREADING_C */
1640 #endif /* MBEDTLS_FS_IO */
1643 * OtherName ::= SEQUENCE {
1644 * type-id OBJECT IDENTIFIER,
1645 * value [0] EXPLICIT ANY DEFINED BY type-id }
1647 * HardwareModuleName ::= SEQUENCE {
1648 * hwType OBJECT IDENTIFIER,
1649 * hwSerialNum OCTET STRING }
1651 * NOTE: we currently only parse and use otherName of type HwModuleName,
1652 * as defined in RFC 4108.
1654 static int x509_get_other_name( const mbedtls_x509_buf *subject_alt_name,
1655 mbedtls_x509_san_other_name *other_name )
1659 unsigned char *p = subject_alt_name->p;
1660 const unsigned char *end = p + subject_alt_name->len;
1661 mbedtls_x509_buf cur_oid;
1663 if( ( subject_alt_name->tag &
1664 ( MBEDTLS_ASN1_TAG_CLASS_MASK | MBEDTLS_ASN1_TAG_VALUE_MASK ) ) !=
1665 ( MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_X509_SAN_OTHER_NAME ) )
1668 * The given subject alternative name is not of type "othername".
1670 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
1673 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1674 MBEDTLS_ASN1_OID ) ) != 0 )
1675 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
1677 cur_oid.tag = MBEDTLS_ASN1_OID;
1682 * Only HwModuleName is currently supported.
1684 if( MBEDTLS_OID_CMP( MBEDTLS_OID_ON_HW_MODULE_NAME, &cur_oid ) != 0 )
1686 return( MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE );
1689 if( p + len >= end )
1691 mbedtls_platform_zeroize( other_name, sizeof( other_name ) );
1692 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
1693 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1696 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1697 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_CONTEXT_SPECIFIC ) ) != 0 )
1698 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
1700 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1701 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE ) ) != 0 )
1702 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
1704 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len, MBEDTLS_ASN1_OID ) ) != 0 )
1705 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
1707 other_name->value.hardware_module_name.oid.tag = MBEDTLS_ASN1_OID;
1708 other_name->value.hardware_module_name.oid.p = p;
1709 other_name->value.hardware_module_name.oid.len = len;
1711 if( p + len >= end )
1713 mbedtls_platform_zeroize( other_name, sizeof( other_name ) );
1714 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
1715 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1718 if( ( ret = mbedtls_asn1_get_tag( &p, end, &len,
1719 MBEDTLS_ASN1_OCTET_STRING ) ) != 0 )
1720 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS + ret );
1722 other_name->value.hardware_module_name.val.tag = MBEDTLS_ASN1_OCTET_STRING;
1723 other_name->value.hardware_module_name.val.p = p;
1724 other_name->value.hardware_module_name.val.len = len;
1728 mbedtls_platform_zeroize( other_name,
1729 sizeof( other_name ) );
1730 return( MBEDTLS_ERR_X509_INVALID_EXTENSIONS +
1731 MBEDTLS_ERR_ASN1_LENGTH_MISMATCH );
1736 static int x509_info_subject_alt_name( char **buf, size_t *size,
1737 const mbedtls_x509_sequence
1739 const char *prefix )
1744 const mbedtls_x509_sequence *cur = subject_alt_name;
1745 mbedtls_x509_subject_alternative_name san;
1748 while( cur != NULL )
1750 memset( &san, 0, sizeof( san ) );
1751 parse_ret = mbedtls_x509_parse_subject_alt_name( &cur->buf, &san );
1752 if( parse_ret != 0 )
1754 if( parse_ret == MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE )
1756 ret = mbedtls_snprintf( p, n, "\n%s <unsupported>", prefix );
1757 MBEDTLS_X509_SAFE_SNPRINTF;
1761 ret = mbedtls_snprintf( p, n, "\n%s <malformed>", prefix );
1762 MBEDTLS_X509_SAFE_SNPRINTF;
1773 case MBEDTLS_X509_SAN_OTHER_NAME:
1775 mbedtls_x509_san_other_name *other_name = &san.san.other_name;
1777 ret = mbedtls_snprintf( p, n, "\n%s otherName :", prefix );
1778 MBEDTLS_X509_SAFE_SNPRINTF;
1780 if( MBEDTLS_OID_CMP( MBEDTLS_OID_ON_HW_MODULE_NAME,
1781 &other_name->value.hardware_module_name.oid ) != 0 )
1783 ret = mbedtls_snprintf( p, n, "\n%s hardware module name :", prefix );
1784 MBEDTLS_X509_SAFE_SNPRINTF;
1785 ret = mbedtls_snprintf( p, n, "\n%s hardware type : ", prefix );
1786 MBEDTLS_X509_SAFE_SNPRINTF;
1788 ret = mbedtls_oid_get_numeric_string( p, n, &other_name->value.hardware_module_name.oid );
1789 MBEDTLS_X509_SAFE_SNPRINTF;
1791 ret = mbedtls_snprintf( p, n, "\n%s hardware serial number : ", prefix );
1792 MBEDTLS_X509_SAFE_SNPRINTF;
1794 if( other_name->value.hardware_module_name.val.len >= n )
1797 return( MBEDTLS_ERR_X509_BUFFER_TOO_SMALL );
1800 memcpy( p, other_name->value.hardware_module_name.val.p,
1801 other_name->value.hardware_module_name.val.len );
1802 p += other_name->value.hardware_module_name.val.len;
1804 n -= other_name->value.hardware_module_name.val.len;
1806 }/* MBEDTLS_OID_ON_HW_MODULE_NAME */
1813 case MBEDTLS_X509_SAN_DNS_NAME:
1815 ret = mbedtls_snprintf( p, n, "\n%s dNSName : ", prefix );
1816 MBEDTLS_X509_SAFE_SNPRINTF;
1817 if( san.san.unstructured_name.len >= n )
1820 return( MBEDTLS_ERR_X509_BUFFER_TOO_SMALL );
1823 memcpy( p, san.san.unstructured_name.p, san.san.unstructured_name.len );
1824 p += san.san.unstructured_name.len;
1825 n -= san.san.unstructured_name.len;
1830 * Type not supported, skip item.
1833 ret = mbedtls_snprintf( p, n, "\n%s <unsupported>", prefix );
1834 MBEDTLS_X509_SAFE_SNPRINTF;
1849 int mbedtls_x509_parse_subject_alt_name( const mbedtls_x509_buf *san_buf,
1850 mbedtls_x509_subject_alternative_name *san )
1853 switch( san_buf->tag &
1854 ( MBEDTLS_ASN1_TAG_CLASS_MASK |
1855 MBEDTLS_ASN1_TAG_VALUE_MASK ) )
1860 case( MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_X509_SAN_OTHER_NAME ):
1862 mbedtls_x509_san_other_name other_name;
1864 ret = x509_get_other_name( san_buf, &other_name );
1868 memset( san, 0, sizeof( mbedtls_x509_subject_alternative_name ) );
1869 san->type = MBEDTLS_X509_SAN_OTHER_NAME;
1870 memcpy( &san->san.other_name,
1871 &other_name, sizeof( other_name ) );
1879 case( MBEDTLS_ASN1_CONTEXT_SPECIFIC | MBEDTLS_X509_SAN_DNS_NAME ):
1881 memset( san, 0, sizeof( mbedtls_x509_subject_alternative_name ) );
1882 san->type = MBEDTLS_X509_SAN_DNS_NAME;
1884 memcpy( &san->san.unstructured_name,
1885 san_buf, sizeof( *san_buf ) );
1891 * Type not supported
1894 return( MBEDTLS_ERR_X509_FEATURE_UNAVAILABLE );
1899 #define PRINT_ITEM(i) \
1901 ret = mbedtls_snprintf( p, n, "%s" i, sep ); \
1902 MBEDTLS_X509_SAFE_SNPRINTF; \
1906 #define CERT_TYPE(type,name) \
1907 if( ns_cert_type & (type) ) \
1910 static int x509_info_cert_type( char **buf, size_t *size,
1911 unsigned char ns_cert_type )
1916 const char *sep = "";
1918 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_SSL_CLIENT, "SSL Client" );
1919 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_SSL_SERVER, "SSL Server" );
1920 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_EMAIL, "Email" );
1921 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_OBJECT_SIGNING, "Object Signing" );
1922 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_RESERVED, "Reserved" );
1923 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_SSL_CA, "SSL CA" );
1924 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_EMAIL_CA, "Email CA" );
1925 CERT_TYPE( MBEDTLS_X509_NS_CERT_TYPE_OBJECT_SIGNING_CA, "Object Signing CA" );
1933 #define KEY_USAGE(code,name) \
1934 if( key_usage & (code) ) \
1937 static int x509_info_key_usage( char **buf, size_t *size,
1938 unsigned int key_usage )
1943 const char *sep = "";
1945 KEY_USAGE( MBEDTLS_X509_KU_DIGITAL_SIGNATURE, "Digital Signature" );
1946 KEY_USAGE( MBEDTLS_X509_KU_NON_REPUDIATION, "Non Repudiation" );
1947 KEY_USAGE( MBEDTLS_X509_KU_KEY_ENCIPHERMENT, "Key Encipherment" );
1948 KEY_USAGE( MBEDTLS_X509_KU_DATA_ENCIPHERMENT, "Data Encipherment" );
1949 KEY_USAGE( MBEDTLS_X509_KU_KEY_AGREEMENT, "Key Agreement" );
1950 KEY_USAGE( MBEDTLS_X509_KU_KEY_CERT_SIGN, "Key Cert Sign" );
1951 KEY_USAGE( MBEDTLS_X509_KU_CRL_SIGN, "CRL Sign" );
1952 KEY_USAGE( MBEDTLS_X509_KU_ENCIPHER_ONLY, "Encipher Only" );
1953 KEY_USAGE( MBEDTLS_X509_KU_DECIPHER_ONLY, "Decipher Only" );
1961 static int x509_info_ext_key_usage( char **buf, size_t *size,
1962 const mbedtls_x509_sequence *extended_key_usage )
1968 const mbedtls_x509_sequence *cur = extended_key_usage;
1969 const char *sep = "";
1971 while( cur != NULL )
1973 if( mbedtls_oid_get_extended_key_usage( &cur->buf, &desc ) != 0 )
1976 ret = mbedtls_snprintf( p, n, "%s%s", sep, desc );
1977 MBEDTLS_X509_SAFE_SNPRINTF;
1990 static int x509_info_cert_policies( char **buf, size_t *size,
1991 const mbedtls_x509_sequence *certificate_policies )
1997 const mbedtls_x509_sequence *cur = certificate_policies;
1998 const char *sep = "";
2000 while( cur != NULL )
2002 if( mbedtls_oid_get_certificate_policies( &cur->buf, &desc ) != 0 )
2005 ret = mbedtls_snprintf( p, n, "%s%s", sep, desc );
2006 MBEDTLS_X509_SAFE_SNPRINTF;
2020 * Return an informational string about the certificate.
2022 #define BEFORE_COLON 18
2024 int mbedtls_x509_crt_info( char *buf, size_t size, const char *prefix,
2025 const mbedtls_x509_crt *crt )
2030 char key_size_str[BEFORE_COLON];
2037 ret = mbedtls_snprintf( p, n, "\nCertificate is uninitialised!\n" );
2038 MBEDTLS_X509_SAFE_SNPRINTF;
2040 return( (int) ( size - n ) );
2043 ret = mbedtls_snprintf( p, n, "%scert. version : %d\n",
2044 prefix, crt->version );
2045 MBEDTLS_X509_SAFE_SNPRINTF;
2046 ret = mbedtls_snprintf( p, n, "%sserial number : ",
2048 MBEDTLS_X509_SAFE_SNPRINTF;
2050 ret = mbedtls_x509_serial_gets( p, n, &crt->serial );
2051 MBEDTLS_X509_SAFE_SNPRINTF;
2053 ret = mbedtls_snprintf( p, n, "\n%sissuer name : ", prefix );
2054 MBEDTLS_X509_SAFE_SNPRINTF;
2055 ret = mbedtls_x509_dn_gets( p, n, &crt->issuer );
2056 MBEDTLS_X509_SAFE_SNPRINTF;
2058 ret = mbedtls_snprintf( p, n, "\n%ssubject name : ", prefix );
2059 MBEDTLS_X509_SAFE_SNPRINTF;
2060 ret = mbedtls_x509_dn_gets( p, n, &crt->subject );
2061 MBEDTLS_X509_SAFE_SNPRINTF;
2063 ret = mbedtls_snprintf( p, n, "\n%sissued on : " \
2064 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
2065 crt->valid_from.year, crt->valid_from.mon,
2066 crt->valid_from.day, crt->valid_from.hour,
2067 crt->valid_from.min, crt->valid_from.sec );
2068 MBEDTLS_X509_SAFE_SNPRINTF;
2070 ret = mbedtls_snprintf( p, n, "\n%sexpires on : " \
2071 "%04d-%02d-%02d %02d:%02d:%02d", prefix,
2072 crt->valid_to.year, crt->valid_to.mon,
2073 crt->valid_to.day, crt->valid_to.hour,
2074 crt->valid_to.min, crt->valid_to.sec );
2075 MBEDTLS_X509_SAFE_SNPRINTF;
2077 ret = mbedtls_snprintf( p, n, "\n%ssigned using : ", prefix );
2078 MBEDTLS_X509_SAFE_SNPRINTF;
2080 ret = mbedtls_x509_sig_alg_gets( p, n, &crt->sig_oid, crt->sig_pk,
2081 crt->sig_md, crt->sig_opts );
2082 MBEDTLS_X509_SAFE_SNPRINTF;
2085 if( ( ret = mbedtls_x509_key_size_helper( key_size_str, BEFORE_COLON,
2086 mbedtls_pk_get_name( &crt->pk ) ) ) != 0 )
2091 ret = mbedtls_snprintf( p, n, "\n%s%-" BC "s: %d bits", prefix, key_size_str,
2092 (int) mbedtls_pk_get_bitlen( &crt->pk ) );
2093 MBEDTLS_X509_SAFE_SNPRINTF;
2096 * Optional extensions
2099 if( crt->ext_types & MBEDTLS_X509_EXT_BASIC_CONSTRAINTS )
2101 ret = mbedtls_snprintf( p, n, "\n%sbasic constraints : CA=%s", prefix,
2102 crt->ca_istrue ? "true" : "false" );
2103 MBEDTLS_X509_SAFE_SNPRINTF;
2105 if( crt->max_pathlen > 0 )
2107 ret = mbedtls_snprintf( p, n, ", max_pathlen=%d", crt->max_pathlen - 1 );
2108 MBEDTLS_X509_SAFE_SNPRINTF;
2112 if( crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME )
2114 ret = mbedtls_snprintf( p, n, "\n%ssubject alt name :", prefix );
2115 MBEDTLS_X509_SAFE_SNPRINTF;
2117 if( ( ret = x509_info_subject_alt_name( &p, &n,
2118 &crt->subject_alt_names,
2123 if( crt->ext_types & MBEDTLS_X509_EXT_NS_CERT_TYPE )
2125 ret = mbedtls_snprintf( p, n, "\n%scert. type : ", prefix );
2126 MBEDTLS_X509_SAFE_SNPRINTF;
2128 if( ( ret = x509_info_cert_type( &p, &n, crt->ns_cert_type ) ) != 0 )
2132 if( crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE )
2134 ret = mbedtls_snprintf( p, n, "\n%skey usage : ", prefix );
2135 MBEDTLS_X509_SAFE_SNPRINTF;
2137 if( ( ret = x509_info_key_usage( &p, &n, crt->key_usage ) ) != 0 )
2141 if( crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE )
2143 ret = mbedtls_snprintf( p, n, "\n%sext key usage : ", prefix );
2144 MBEDTLS_X509_SAFE_SNPRINTF;
2146 if( ( ret = x509_info_ext_key_usage( &p, &n,
2147 &crt->ext_key_usage ) ) != 0 )
2151 if( crt->ext_types & MBEDTLS_OID_X509_EXT_CERTIFICATE_POLICIES )
2153 ret = mbedtls_snprintf( p, n, "\n%scertificate policies : ", prefix );
2154 MBEDTLS_X509_SAFE_SNPRINTF;
2156 if( ( ret = x509_info_cert_policies( &p, &n,
2157 &crt->certificate_policies ) ) != 0 )
2161 ret = mbedtls_snprintf( p, n, "\n" );
2162 MBEDTLS_X509_SAFE_SNPRINTF;
2164 return( (int) ( size - n ) );
2167 struct x509_crt_verify_string {
2172 static const struct x509_crt_verify_string x509_crt_verify_strings[] = {
2173 { MBEDTLS_X509_BADCERT_EXPIRED, "The certificate validity has expired" },
2174 { MBEDTLS_X509_BADCERT_REVOKED, "The certificate has been revoked (is on a CRL)" },
2175 { MBEDTLS_X509_BADCERT_CN_MISMATCH, "The certificate Common Name (CN) does not match with the expected CN" },
2176 { MBEDTLS_X509_BADCERT_NOT_TRUSTED, "The certificate is not correctly signed by the trusted CA" },
2177 { MBEDTLS_X509_BADCRL_NOT_TRUSTED, "The CRL is not correctly signed by the trusted CA" },
2178 { MBEDTLS_X509_BADCRL_EXPIRED, "The CRL is expired" },
2179 { MBEDTLS_X509_BADCERT_MISSING, "Certificate was missing" },
2180 { MBEDTLS_X509_BADCERT_SKIP_VERIFY, "Certificate verification was skipped" },
2181 { MBEDTLS_X509_BADCERT_OTHER, "Other reason (can be used by verify callback)" },
2182 { MBEDTLS_X509_BADCERT_FUTURE, "The certificate validity starts in the future" },
2183 { MBEDTLS_X509_BADCRL_FUTURE, "The CRL is from the future" },
2184 { MBEDTLS_X509_BADCERT_KEY_USAGE, "Usage does not match the keyUsage extension" },
2185 { MBEDTLS_X509_BADCERT_EXT_KEY_USAGE, "Usage does not match the extendedKeyUsage extension" },
2186 { MBEDTLS_X509_BADCERT_NS_CERT_TYPE, "Usage does not match the nsCertType extension" },
2187 { MBEDTLS_X509_BADCERT_BAD_MD, "The certificate is signed with an unacceptable hash." },
2188 { MBEDTLS_X509_BADCERT_BAD_PK, "The certificate is signed with an unacceptable PK alg (eg RSA vs ECDSA)." },
2189 { MBEDTLS_X509_BADCERT_BAD_KEY, "The certificate is signed with an unacceptable key (eg bad curve, RSA too short)." },
2190 { MBEDTLS_X509_BADCRL_BAD_MD, "The CRL is signed with an unacceptable hash." },
2191 { MBEDTLS_X509_BADCRL_BAD_PK, "The CRL is signed with an unacceptable PK alg (eg RSA vs ECDSA)." },
2192 { MBEDTLS_X509_BADCRL_BAD_KEY, "The CRL is signed with an unacceptable key (eg bad curve, RSA too short)." },
2196 int mbedtls_x509_crt_verify_info( char *buf, size_t size, const char *prefix,
2200 const struct x509_crt_verify_string *cur;
2204 for( cur = x509_crt_verify_strings; cur->string != NULL ; cur++ )
2206 if( ( flags & cur->code ) == 0 )
2209 ret = mbedtls_snprintf( p, n, "%s%s\n", prefix, cur->string );
2210 MBEDTLS_X509_SAFE_SNPRINTF;
2216 ret = mbedtls_snprintf( p, n, "%sUnknown reason "
2217 "(this should not happen)\n", prefix );
2218 MBEDTLS_X509_SAFE_SNPRINTF;
2221 return( (int) ( size - n ) );
2224 #if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
2225 int mbedtls_x509_crt_check_key_usage( const mbedtls_x509_crt *crt,
2226 unsigned int usage )
2228 unsigned int usage_must, usage_may;
2229 unsigned int may_mask = MBEDTLS_X509_KU_ENCIPHER_ONLY
2230 | MBEDTLS_X509_KU_DECIPHER_ONLY;
2232 if( ( crt->ext_types & MBEDTLS_X509_EXT_KEY_USAGE ) == 0 )
2235 usage_must = usage & ~may_mask;
2237 if( ( ( crt->key_usage & ~may_mask ) & usage_must ) != usage_must )
2238 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
2240 usage_may = usage & may_mask;
2242 if( ( ( crt->key_usage & may_mask ) | usage_may ) != usage_may )
2243 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
2249 #if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
2250 int mbedtls_x509_crt_check_extended_key_usage( const mbedtls_x509_crt *crt,
2251 const char *usage_oid,
2254 const mbedtls_x509_sequence *cur;
2256 /* Extension is not mandatory, absent means no restriction */
2257 if( ( crt->ext_types & MBEDTLS_X509_EXT_EXTENDED_KEY_USAGE ) == 0 )
2261 * Look for the requested usage (or wildcard ANY) in our list
2263 for( cur = &crt->ext_key_usage; cur != NULL; cur = cur->next )
2265 const mbedtls_x509_buf *cur_oid = &cur->buf;
2267 if( cur_oid->len == usage_len &&
2268 memcmp( cur_oid->p, usage_oid, usage_len ) == 0 )
2273 if( MBEDTLS_OID_CMP( MBEDTLS_OID_ANY_EXTENDED_KEY_USAGE, cur_oid ) == 0 )
2277 return( MBEDTLS_ERR_X509_BAD_INPUT_DATA );
2279 #endif /* MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE */
2281 #if defined(MBEDTLS_X509_CRL_PARSE_C)
2283 * Return 1 if the certificate is revoked, or 0 otherwise.
2285 int mbedtls_x509_crt_is_revoked( const mbedtls_x509_crt *crt, const mbedtls_x509_crl *crl )
2287 const mbedtls_x509_crl_entry *cur = &crl->entry;
2289 while( cur != NULL && cur->serial.len != 0 )
2291 if( crt->serial.len == cur->serial.len &&
2292 memcmp( crt->serial.p, cur->serial.p, crt->serial.len ) == 0 )
2294 if( mbedtls_x509_time_is_past( &cur->revocation_date ) )
2305 * Check that the given certificate is not revoked according to the CRL.
2306 * Skip validation if no CRL for the given CA is present.
2308 static int x509_crt_verifycrl( mbedtls_x509_crt *crt, mbedtls_x509_crt *ca,
2309 mbedtls_x509_crl *crl_list,
2310 const mbedtls_x509_crt_profile *profile )
2313 unsigned char hash[MBEDTLS_MD_MAX_SIZE];
2314 const mbedtls_md_info_t *md_info;
2319 while( crl_list != NULL )
2321 if( crl_list->version == 0 ||
2322 x509_name_cmp( &crl_list->issuer, &ca->subject ) != 0 )
2324 crl_list = crl_list->next;
2329 * Check if the CA is configured to sign CRLs
2331 #if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
2332 if( mbedtls_x509_crt_check_key_usage( ca,
2333 MBEDTLS_X509_KU_CRL_SIGN ) != 0 )
2335 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
2341 * Check if CRL is correctly signed by the trusted CA
2343 if( x509_profile_check_md_alg( profile, crl_list->sig_md ) != 0 )
2344 flags |= MBEDTLS_X509_BADCRL_BAD_MD;
2346 if( x509_profile_check_pk_alg( profile, crl_list->sig_pk ) != 0 )
2347 flags |= MBEDTLS_X509_BADCRL_BAD_PK;
2349 md_info = mbedtls_md_info_from_type( crl_list->sig_md );
2350 if( mbedtls_md( md_info, crl_list->tbs.p, crl_list->tbs.len, hash ) != 0 )
2352 /* Note: this can't happen except after an internal error */
2353 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
2357 if( x509_profile_check_key( profile, &ca->pk ) != 0 )
2358 flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
2360 if( mbedtls_pk_verify_ext( crl_list->sig_pk, crl_list->sig_opts, &ca->pk,
2361 crl_list->sig_md, hash, mbedtls_md_get_size( md_info ),
2362 crl_list->sig.p, crl_list->sig.len ) != 0 )
2364 flags |= MBEDTLS_X509_BADCRL_NOT_TRUSTED;
2369 * Check for validity of CRL (Do not drop out)
2371 if( mbedtls_x509_time_is_past( &crl_list->next_update ) )
2372 flags |= MBEDTLS_X509_BADCRL_EXPIRED;
2374 if( mbedtls_x509_time_is_future( &crl_list->this_update ) )
2375 flags |= MBEDTLS_X509_BADCRL_FUTURE;
2378 * Check if certificate is revoked
2380 if( mbedtls_x509_crt_is_revoked( crt, crl_list ) )
2382 flags |= MBEDTLS_X509_BADCERT_REVOKED;
2386 crl_list = crl_list->next;
2391 #endif /* MBEDTLS_X509_CRL_PARSE_C */
2394 * Check the signature of a certificate by its parent
2396 static int x509_crt_check_signature( const mbedtls_x509_crt *child,
2397 mbedtls_x509_crt *parent,
2398 mbedtls_x509_crt_restart_ctx *rs_ctx )
2400 unsigned char hash[MBEDTLS_MD_MAX_SIZE];
2402 #if !defined(MBEDTLS_USE_PSA_CRYPTO)
2403 const mbedtls_md_info_t *md_info;
2404 md_info = mbedtls_md_info_from_type( child->sig_md );
2405 hash_len = mbedtls_md_get_size( md_info );
2407 /* Note: hash errors can happen only after an internal error */
2408 if( mbedtls_md( md_info, child->tbs.p, child->tbs.len, hash ) != 0 )
2411 psa_hash_operation_t hash_operation = PSA_HASH_OPERATION_INIT;
2412 psa_algorithm_t hash_alg = mbedtls_psa_translate_md( child->sig_md );
2414 if( psa_hash_setup( &hash_operation, hash_alg ) != PSA_SUCCESS )
2417 if( psa_hash_update( &hash_operation, child->tbs.p, child->tbs.len )
2423 if( psa_hash_finish( &hash_operation, hash, sizeof( hash ), &hash_len )
2428 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2429 /* Skip expensive computation on obvious mismatch */
2430 if( ! mbedtls_pk_can_do( &parent->pk, child->sig_pk ) )
2433 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2434 if( rs_ctx != NULL && child->sig_pk == MBEDTLS_PK_ECDSA )
2436 return( mbedtls_pk_verify_restartable( &parent->pk,
2437 child->sig_md, hash, hash_len,
2438 child->sig.p, child->sig.len, &rs_ctx->pk ) );
2444 return( mbedtls_pk_verify_ext( child->sig_pk, child->sig_opts, &parent->pk,
2445 child->sig_md, hash, hash_len,
2446 child->sig.p, child->sig.len ) );
2450 * Check if 'parent' is a suitable parent (signing CA) for 'child'.
2451 * Return 0 if yes, -1 if not.
2453 * top means parent is a locally-trusted certificate
2455 static int x509_crt_check_parent( const mbedtls_x509_crt *child,
2456 const mbedtls_x509_crt *parent,
2461 /* Parent must be the issuer */
2462 if( x509_name_cmp( &child->issuer, &parent->subject ) != 0 )
2465 /* Parent must have the basicConstraints CA bit set as a general rule */
2468 /* Exception: v1/v2 certificates that are locally trusted. */
2469 if( top && parent->version < 3 )
2472 if( need_ca_bit && ! parent->ca_istrue )
2475 #if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
2477 mbedtls_x509_crt_check_key_usage( parent, MBEDTLS_X509_KU_KEY_CERT_SIGN ) != 0 )
2487 * Find a suitable parent for child in candidates, or return NULL.
2489 * Here suitable is defined as:
2490 * 1. subject name matches child's issuer
2491 * 2. if necessary, the CA bit is set and key usage allows signing certs
2492 * 3. for trusted roots, the signature is correct
2493 * (for intermediates, the signature is checked and the result reported)
2494 * 4. pathlen constraints are satisfied
2496 * If there's a suitable candidate which is also time-valid, return the first
2497 * such. Otherwise, return the first suitable candidate (or NULL if there is
2500 * The rationale for this rule is that someone could have a list of trusted
2501 * roots with two versions on the same root with different validity periods.
2502 * (At least one user reported having such a list and wanted it to just work.)
2503 * The reason we don't just require time-validity is that generally there is
2504 * only one version, and if it's expired we want the flags to state that
2505 * rather than NOT_TRUSTED, as would be the case if we required it here.
2507 * The rationale for rule 3 (signature for trusted roots) is that users might
2508 * have two versions of the same CA with different keys in their list, and the
2509 * way we select the correct one is by checking the signature (as we don't
2510 * rely on key identifier extensions). (This is one way users might choose to
2511 * handle key rollover, another relies on self-issued certs, see [SIRO].)
2514 * - [in] child: certificate for which we're looking for a parent
2515 * - [in] candidates: chained list of potential parents
2516 * - [out] r_parent: parent found (or NULL)
2517 * - [out] r_signature_is_good: 1 if child signature by parent is valid, or 0
2518 * - [in] top: 1 if candidates consists of trusted roots, ie we're at the top
2519 * of the chain, 0 otherwise
2520 * - [in] path_cnt: number of intermediates seen so far
2521 * - [in] self_cnt: number of self-signed intermediates seen so far
2522 * (will never be greater than path_cnt)
2523 * - [in-out] rs_ctx: context for restarting operations
2527 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
2529 static int x509_crt_find_parent_in(
2530 mbedtls_x509_crt *child,
2531 mbedtls_x509_crt *candidates,
2532 mbedtls_x509_crt **r_parent,
2533 int *r_signature_is_good,
2537 mbedtls_x509_crt_restart_ctx *rs_ctx )
2540 mbedtls_x509_crt *parent, *fallback_parent;
2541 int signature_is_good, fallback_signature_is_good;
2543 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2544 /* did we have something in progress? */
2545 if( rs_ctx != NULL && rs_ctx->parent != NULL )
2547 /* restore saved state */
2548 parent = rs_ctx->parent;
2549 fallback_parent = rs_ctx->fallback_parent;
2550 fallback_signature_is_good = rs_ctx->fallback_signature_is_good;
2552 /* clear saved state */
2553 rs_ctx->parent = NULL;
2554 rs_ctx->fallback_parent = NULL;
2555 rs_ctx->fallback_signature_is_good = 0;
2557 /* resume where we left */
2558 goto check_signature;
2562 fallback_parent = NULL;
2563 fallback_signature_is_good = 0;
2565 for( parent = candidates; parent != NULL; parent = parent->next )
2567 /* basic parenting skills (name, CA bit, key usage) */
2568 if( x509_crt_check_parent( child, parent, top ) != 0 )
2571 /* +1 because stored max_pathlen is 1 higher that the actual value */
2572 if( parent->max_pathlen > 0 &&
2573 (size_t) parent->max_pathlen < 1 + path_cnt - self_cnt )
2579 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2582 ret = x509_crt_check_signature( child, parent, rs_ctx );
2584 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2585 if( rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
2588 rs_ctx->parent = parent;
2589 rs_ctx->fallback_parent = fallback_parent;
2590 rs_ctx->fallback_signature_is_good = fallback_signature_is_good;
2598 signature_is_good = ret == 0;
2599 if( top && ! signature_is_good )
2602 /* optional time check */
2603 if( mbedtls_x509_time_is_past( &parent->valid_to ) ||
2604 mbedtls_x509_time_is_future( &parent->valid_from ) )
2606 if( fallback_parent == NULL )
2608 fallback_parent = parent;
2609 fallback_signature_is_good = signature_is_good;
2618 if( parent != NULL )
2621 *r_signature_is_good = signature_is_good;
2625 *r_parent = fallback_parent;
2626 *r_signature_is_good = fallback_signature_is_good;
2633 * Find a parent in trusted CAs or the provided chain, or return NULL.
2635 * Searches in trusted CAs first, and return the first suitable parent found
2636 * (see find_parent_in() for definition of suitable).
2639 * - [in] child: certificate for which we're looking for a parent, followed
2640 * by a chain of possible intermediates
2641 * - [in] trust_ca: list of locally trusted certificates
2642 * - [out] parent: parent found (or NULL)
2643 * - [out] parent_is_trusted: 1 if returned `parent` is trusted, or 0
2644 * - [out] signature_is_good: 1 if child signature by parent is valid, or 0
2645 * - [in] path_cnt: number of links in the chain so far (EE -> ... -> child)
2646 * - [in] self_cnt: number of self-signed certs in the chain so far
2647 * (will always be no greater than path_cnt)
2648 * - [in-out] rs_ctx: context for restarting operations
2652 * - MBEDTLS_ERR_ECP_IN_PROGRESS otherwise
2654 static int x509_crt_find_parent(
2655 mbedtls_x509_crt *child,
2656 mbedtls_x509_crt *trust_ca,
2657 mbedtls_x509_crt **parent,
2658 int *parent_is_trusted,
2659 int *signature_is_good,
2662 mbedtls_x509_crt_restart_ctx *rs_ctx )
2665 mbedtls_x509_crt *search_list;
2667 *parent_is_trusted = 1;
2669 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2670 /* restore then clear saved state if we have some stored */
2671 if( rs_ctx != NULL && rs_ctx->parent_is_trusted != -1 )
2673 *parent_is_trusted = rs_ctx->parent_is_trusted;
2674 rs_ctx->parent_is_trusted = -1;
2679 search_list = *parent_is_trusted ? trust_ca : child->next;
2681 ret = x509_crt_find_parent_in( child, search_list,
2682 parent, signature_is_good,
2684 path_cnt, self_cnt, rs_ctx );
2686 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2687 if( rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
2690 rs_ctx->parent_is_trusted = *parent_is_trusted;
2697 /* stop here if found or already in second iteration */
2698 if( *parent != NULL || *parent_is_trusted == 0 )
2701 /* prepare second iteration */
2702 *parent_is_trusted = 0;
2705 /* extra precaution against mistakes in the caller */
2706 if( *parent == NULL )
2708 *parent_is_trusted = 0;
2709 *signature_is_good = 0;
2716 * Check if an end-entity certificate is locally trusted
2718 * Currently we require such certificates to be self-signed (actually only
2719 * check for self-issued as self-signatures are not checked)
2721 static int x509_crt_check_ee_locally_trusted(
2722 mbedtls_x509_crt *crt,
2723 mbedtls_x509_crt *trust_ca )
2725 mbedtls_x509_crt *cur;
2727 /* must be self-issued */
2728 if( x509_name_cmp( &crt->issuer, &crt->subject ) != 0 )
2731 /* look for an exact match with trusted cert */
2732 for( cur = trust_ca; cur != NULL; cur = cur->next )
2734 if( crt->raw.len == cur->raw.len &&
2735 memcmp( crt->raw.p, cur->raw.p, crt->raw.len ) == 0 )
2746 * Build and verify a certificate chain
2748 * Given a peer-provided list of certificates EE, C1, ..., Cn and
2749 * a list of trusted certs R1, ... Rp, try to build and verify a chain
2750 * EE, Ci1, ... Ciq [, Rj]
2751 * such that every cert in the chain is a child of the next one,
2752 * jumping to a trusted root as early as possible.
2754 * Verify that chain and return it with flags for all issues found.
2757 * - EE == Rj -> return a one-element list containing it
2758 * - EE, Ci1, ..., Ciq cannot be continued with a trusted root
2759 * -> return that chain with NOT_TRUSTED set on Ciq
2761 * Tests for (aspects of) this function should include at least:
2763 * - EE -> trusted root
2764 * - EE -> intermediate CA -> trusted root
2765 * - if relevant: EE untrusted
2766 * - if relevant: EE -> intermediate, untrusted
2767 * with the aspect under test checked at each relevant level (EE, int, root).
2768 * For some aspects longer chains are required, but usually length 2 is
2769 * enough (but length 1 is not in general).
2772 * - [in] crt: the cert list EE, C1, ..., Cn
2773 * - [in] trust_ca: the trusted list R1, ..., Rp
2774 * - [in] ca_crl, profile: as in verify_with_profile()
2775 * - [out] ver_chain: the built and verified chain
2776 * Only valid when return value is 0, may contain garbage otherwise!
2777 * Restart note: need not be the same when calling again to resume.
2778 * - [in-out] rs_ctx: context for restarting operations
2781 * - non-zero if the chain could not be fully built and examined
2782 * - 0 is the chain was successfully built and examined,
2783 * even if it was found to be invalid
2785 static int x509_crt_verify_chain(
2786 mbedtls_x509_crt *crt,
2787 mbedtls_x509_crt *trust_ca,
2788 mbedtls_x509_crl *ca_crl,
2789 mbedtls_x509_crt_ca_cb_t f_ca_cb,
2791 const mbedtls_x509_crt_profile *profile,
2792 mbedtls_x509_crt_verify_chain *ver_chain,
2793 mbedtls_x509_crt_restart_ctx *rs_ctx )
2795 /* Don't initialize any of those variables here, so that the compiler can
2796 * catch potential issues with jumping ahead when restarting */
2799 mbedtls_x509_crt_verify_chain_item *cur;
2800 mbedtls_x509_crt *child;
2801 mbedtls_x509_crt *parent;
2802 int parent_is_trusted;
2803 int child_is_trusted;
2804 int signature_is_good;
2806 mbedtls_x509_crt *cur_trust_ca = NULL;
2808 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2809 /* resume if we had an operation in progress */
2810 if( rs_ctx != NULL && rs_ctx->in_progress == x509_crt_rs_find_parent )
2812 /* restore saved state */
2813 *ver_chain = rs_ctx->ver_chain; /* struct copy */
2814 self_cnt = rs_ctx->self_cnt;
2816 /* restore derived state */
2817 cur = &ver_chain->items[ver_chain->len - 1];
2819 flags = &cur->flags;
2823 #endif /* MBEDTLS_ECDSA_C && MBEDTLS_ECP_RESTARTABLE */
2827 parent_is_trusted = 0;
2828 child_is_trusted = 0;
2831 /* Add certificate to the verification chain */
2832 cur = &ver_chain->items[ver_chain->len];
2836 flags = &cur->flags;
2838 /* Check time-validity (all certificates) */
2839 if( mbedtls_x509_time_is_past( &child->valid_to ) )
2840 *flags |= MBEDTLS_X509_BADCERT_EXPIRED;
2842 if( mbedtls_x509_time_is_future( &child->valid_from ) )
2843 *flags |= MBEDTLS_X509_BADCERT_FUTURE;
2845 /* Stop here for trusted roots (but not for trusted EE certs) */
2846 if( child_is_trusted )
2849 /* Check signature algorithm: MD & PK algs */
2850 if( x509_profile_check_md_alg( profile, child->sig_md ) != 0 )
2851 *flags |= MBEDTLS_X509_BADCERT_BAD_MD;
2853 if( x509_profile_check_pk_alg( profile, child->sig_pk ) != 0 )
2854 *flags |= MBEDTLS_X509_BADCERT_BAD_PK;
2856 /* Special case: EE certs that are locally trusted */
2857 if( ver_chain->len == 1 &&
2858 x509_crt_check_ee_locally_trusted( child, trust_ca ) == 0 )
2863 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2867 /* Obtain list of potential trusted signers from CA callback,
2868 * or use statically provided list. */
2869 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
2870 if( f_ca_cb != NULL )
2872 mbedtls_x509_crt_free( ver_chain->trust_ca_cb_result );
2873 mbedtls_free( ver_chain->trust_ca_cb_result );
2874 ver_chain->trust_ca_cb_result = NULL;
2876 ret = f_ca_cb( p_ca_cb, child, &ver_chain->trust_ca_cb_result );
2878 return( MBEDTLS_ERR_X509_FATAL_ERROR );
2880 cur_trust_ca = ver_chain->trust_ca_cb_result;
2883 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2887 cur_trust_ca = trust_ca;
2890 /* Look for a parent in trusted CAs or up the chain */
2891 ret = x509_crt_find_parent( child, cur_trust_ca, &parent,
2892 &parent_is_trusted, &signature_is_good,
2893 ver_chain->len - 1, self_cnt, rs_ctx );
2895 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
2896 if( rs_ctx != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
2899 rs_ctx->in_progress = x509_crt_rs_find_parent;
2900 rs_ctx->self_cnt = self_cnt;
2901 rs_ctx->ver_chain = *ver_chain; /* struct copy */
2909 /* No parent? We're done here */
2910 if( parent == NULL )
2912 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
2916 /* Count intermediate self-issued (not necessarily self-signed) certs.
2917 * These can occur with some strategies for key rollover, see [SIRO],
2918 * and should be excluded from max_pathlen checks. */
2919 if( ver_chain->len != 1 &&
2920 x509_name_cmp( &child->issuer, &child->subject ) == 0 )
2925 /* path_cnt is 0 for the first intermediate CA,
2926 * and if parent is trusted it's not an intermediate CA */
2927 if( ! parent_is_trusted &&
2928 ver_chain->len > MBEDTLS_X509_MAX_INTERMEDIATE_CA )
2930 /* return immediately to avoid overflow the chain array */
2931 return( MBEDTLS_ERR_X509_FATAL_ERROR );
2934 /* signature was checked while searching parent */
2935 if( ! signature_is_good )
2936 *flags |= MBEDTLS_X509_BADCERT_NOT_TRUSTED;
2938 /* check size of signing key */
2939 if( x509_profile_check_key( profile, &parent->pk ) != 0 )
2940 *flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
2942 #if defined(MBEDTLS_X509_CRL_PARSE_C)
2943 /* Check trusted CA's CRL for the given crt */
2944 *flags |= x509_crt_verifycrl( child, parent, ca_crl, profile );
2949 /* prepare for next iteration */
2952 child_is_trusted = parent_is_trusted;
2953 signature_is_good = 0;
2958 * Check for CN match
2960 static int x509_crt_check_cn( const mbedtls_x509_buf *name,
2961 const char *cn, size_t cn_len )
2963 /* try exact match */
2964 if( name->len == cn_len &&
2965 x509_memcasecmp( cn, name->p, cn_len ) == 0 )
2970 /* try wildcard match */
2971 if( x509_check_wildcard( cn, name ) == 0 )
2980 * Verify the requested CN - only call this if cn is not NULL!
2982 static void x509_crt_verify_name( const mbedtls_x509_crt *crt,
2986 const mbedtls_x509_name *name;
2987 const mbedtls_x509_sequence *cur;
2988 size_t cn_len = strlen( cn );
2990 if( crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME )
2992 for( cur = &crt->subject_alt_names; cur != NULL; cur = cur->next )
2994 if( x509_crt_check_cn( &cur->buf, cn, cn_len ) == 0 )
2999 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
3003 for( name = &crt->subject; name != NULL; name = name->next )
3005 if( MBEDTLS_OID_CMP( MBEDTLS_OID_AT_CN, &name->oid ) == 0 &&
3006 x509_crt_check_cn( &name->val, cn, cn_len ) == 0 )
3013 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
3018 * Merge the flags for all certs in the chain, after calling callback
3020 static int x509_crt_merge_flags_with_cb(
3022 const mbedtls_x509_crt_verify_chain *ver_chain,
3023 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3029 const mbedtls_x509_crt_verify_chain_item *cur;
3031 for( i = ver_chain->len; i != 0; --i )
3033 cur = &ver_chain->items[i-1];
3034 cur_flags = cur->flags;
3036 if( NULL != f_vrfy )
3037 if( ( ret = f_vrfy( p_vrfy, cur->crt, (int) i-1, &cur_flags ) ) != 0 )
3040 *flags |= cur_flags;
3047 * Verify the certificate validity, with profile, restartable version
3050 * - checks the requested CN (if any)
3051 * - checks the type and size of the EE cert's key,
3052 * as that isn't done as part of chain building/verification currently
3053 * - builds and verifies the chain
3054 * - then calls the callback and merges the flags
3056 * The parameters pairs `trust_ca`, `ca_crl` and `f_ca_cb`, `p_ca_cb`
3057 * are mutually exclusive: If `f_ca_cb != NULL`, it will be used by the
3058 * verification routine to search for trusted signers, and CRLs will
3059 * be disabled. Otherwise, `trust_ca` will be used as the static list
3060 * of trusted signers, and `ca_crl` will be use as the static list
3063 static int x509_crt_verify_restartable_ca_cb( mbedtls_x509_crt *crt,
3064 mbedtls_x509_crt *trust_ca,
3065 mbedtls_x509_crl *ca_crl,
3066 mbedtls_x509_crt_ca_cb_t f_ca_cb,
3068 const mbedtls_x509_crt_profile *profile,
3069 const char *cn, uint32_t *flags,
3070 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3072 mbedtls_x509_crt_restart_ctx *rs_ctx )
3075 mbedtls_pk_type_t pk_type;
3076 mbedtls_x509_crt_verify_chain ver_chain;
3081 x509_crt_verify_chain_reset( &ver_chain );
3083 if( profile == NULL )
3085 ret = MBEDTLS_ERR_X509_BAD_INPUT_DATA;
3089 /* check name if requested */
3091 x509_crt_verify_name( crt, cn, &ee_flags );
3093 /* Check the type and size of the key */
3094 pk_type = mbedtls_pk_get_type( &crt->pk );
3096 if( x509_profile_check_pk_alg( profile, pk_type ) != 0 )
3097 ee_flags |= MBEDTLS_X509_BADCERT_BAD_PK;
3099 if( x509_profile_check_key( profile, &crt->pk ) != 0 )
3100 ee_flags |= MBEDTLS_X509_BADCERT_BAD_KEY;
3102 /* Check the chain */
3103 ret = x509_crt_verify_chain( crt, trust_ca, ca_crl,
3104 f_ca_cb, p_ca_cb, profile,
3105 &ver_chain, rs_ctx );
3110 /* Merge end-entity flags */
3111 ver_chain.items[0].flags |= ee_flags;
3113 /* Build final flags, calling callback on the way if any */
3114 ret = x509_crt_merge_flags_with_cb( flags, &ver_chain, f_vrfy, p_vrfy );
3118 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
3119 mbedtls_x509_crt_free( ver_chain.trust_ca_cb_result );
3120 mbedtls_free( ver_chain.trust_ca_cb_result );
3121 ver_chain.trust_ca_cb_result = NULL;
3122 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
3124 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
3125 if( rs_ctx != NULL && ret != MBEDTLS_ERR_ECP_IN_PROGRESS )
3126 mbedtls_x509_crt_restart_free( rs_ctx );
3129 /* prevent misuse of the vrfy callback - VERIFY_FAILED would be ignored by
3130 * the SSL module for authmode optional, but non-zero return from the
3131 * callback means a fatal error so it shouldn't be ignored */
3132 if( ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED )
3133 ret = MBEDTLS_ERR_X509_FATAL_ERROR;
3137 *flags = (uint32_t) -1;
3142 return( MBEDTLS_ERR_X509_CERT_VERIFY_FAILED );
3149 * Verify the certificate validity (default profile, not restartable)
3151 int mbedtls_x509_crt_verify( mbedtls_x509_crt *crt,
3152 mbedtls_x509_crt *trust_ca,
3153 mbedtls_x509_crl *ca_crl,
3154 const char *cn, uint32_t *flags,
3155 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3158 return( x509_crt_verify_restartable_ca_cb( crt, trust_ca, ca_crl,
3160 &mbedtls_x509_crt_profile_default,
3162 f_vrfy, p_vrfy, NULL ) );
3166 * Verify the certificate validity (user-chosen profile, not restartable)
3168 int mbedtls_x509_crt_verify_with_profile( mbedtls_x509_crt *crt,
3169 mbedtls_x509_crt *trust_ca,
3170 mbedtls_x509_crl *ca_crl,
3171 const mbedtls_x509_crt_profile *profile,
3172 const char *cn, uint32_t *flags,
3173 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3176 return( x509_crt_verify_restartable_ca_cb( crt, trust_ca, ca_crl,
3179 f_vrfy, p_vrfy, NULL ) );
3182 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
3184 * Verify the certificate validity (user-chosen profile, CA callback,
3187 int mbedtls_x509_crt_verify_with_ca_cb( mbedtls_x509_crt *crt,
3188 mbedtls_x509_crt_ca_cb_t f_ca_cb,
3190 const mbedtls_x509_crt_profile *profile,
3191 const char *cn, uint32_t *flags,
3192 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3195 return( x509_crt_verify_restartable_ca_cb( crt, NULL, NULL,
3198 f_vrfy, p_vrfy, NULL ) );
3200 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
3202 int mbedtls_x509_crt_verify_restartable( mbedtls_x509_crt *crt,
3203 mbedtls_x509_crt *trust_ca,
3204 mbedtls_x509_crl *ca_crl,
3205 const mbedtls_x509_crt_profile *profile,
3206 const char *cn, uint32_t *flags,
3207 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
3209 mbedtls_x509_crt_restart_ctx *rs_ctx )
3211 return( x509_crt_verify_restartable_ca_cb( crt, trust_ca, ca_crl,
3214 f_vrfy, p_vrfy, rs_ctx ) );
3219 * Initialize a certificate chain
3221 void mbedtls_x509_crt_init( mbedtls_x509_crt *crt )
3223 memset( crt, 0, sizeof(mbedtls_x509_crt) );
3227 * Unallocate all certificate data
3229 void mbedtls_x509_crt_free( mbedtls_x509_crt *crt )
3231 mbedtls_x509_crt *cert_cur = crt;
3232 mbedtls_x509_crt *cert_prv;
3233 mbedtls_x509_name *name_cur;
3234 mbedtls_x509_name *name_prv;
3235 mbedtls_x509_sequence *seq_cur;
3236 mbedtls_x509_sequence *seq_prv;
3243 mbedtls_pk_free( &cert_cur->pk );
3245 #if defined(MBEDTLS_X509_RSASSA_PSS_SUPPORT)
3246 mbedtls_free( cert_cur->sig_opts );
3249 name_cur = cert_cur->issuer.next;
3250 while( name_cur != NULL )
3252 name_prv = name_cur;
3253 name_cur = name_cur->next;
3254 mbedtls_platform_zeroize( name_prv, sizeof( mbedtls_x509_name ) );
3255 mbedtls_free( name_prv );
3258 name_cur = cert_cur->subject.next;
3259 while( name_cur != NULL )
3261 name_prv = name_cur;
3262 name_cur = name_cur->next;
3263 mbedtls_platform_zeroize( name_prv, sizeof( mbedtls_x509_name ) );
3264 mbedtls_free( name_prv );
3267 seq_cur = cert_cur->ext_key_usage.next;
3268 while( seq_cur != NULL )
3271 seq_cur = seq_cur->next;
3272 mbedtls_platform_zeroize( seq_prv,
3273 sizeof( mbedtls_x509_sequence ) );
3274 mbedtls_free( seq_prv );
3277 seq_cur = cert_cur->subject_alt_names.next;
3278 while( seq_cur != NULL )
3281 seq_cur = seq_cur->next;
3282 mbedtls_platform_zeroize( seq_prv,
3283 sizeof( mbedtls_x509_sequence ) );
3284 mbedtls_free( seq_prv );
3287 seq_cur = cert_cur->certificate_policies.next;
3288 while( seq_cur != NULL )
3291 seq_cur = seq_cur->next;
3292 mbedtls_platform_zeroize( seq_prv,
3293 sizeof( mbedtls_x509_sequence ) );
3294 mbedtls_free( seq_prv );
3297 if( cert_cur->raw.p != NULL && cert_cur->own_buffer )
3299 mbedtls_platform_zeroize( cert_cur->raw.p, cert_cur->raw.len );
3300 mbedtls_free( cert_cur->raw.p );
3303 cert_cur = cert_cur->next;
3305 while( cert_cur != NULL );
3310 cert_prv = cert_cur;
3311 cert_cur = cert_cur->next;
3313 mbedtls_platform_zeroize( cert_prv, sizeof( mbedtls_x509_crt ) );
3314 if( cert_prv != crt )
3315 mbedtls_free( cert_prv );
3317 while( cert_cur != NULL );
3320 #if defined(MBEDTLS_ECDSA_C) && defined(MBEDTLS_ECP_RESTARTABLE)
3322 * Initialize a restart context
3324 void mbedtls_x509_crt_restart_init( mbedtls_x509_crt_restart_ctx *ctx )
3326 mbedtls_pk_restart_init( &ctx->pk );
3329 ctx->fallback_parent = NULL;
3330 ctx->fallback_signature_is_good = 0;
3332 ctx->parent_is_trusted = -1;
3334 ctx->in_progress = x509_crt_rs_none;
3336 x509_crt_verify_chain_reset( &ctx->ver_chain );
3340 * Free the components of a restart context
3342 void mbedtls_x509_crt_restart_free( mbedtls_x509_crt_restart_ctx *ctx )
3347 mbedtls_pk_restart_free( &ctx->pk );
3348 mbedtls_x509_crt_restart_init( ctx );
3350 #endif /* MBEDTLS_ECDSA_C && MBEDTLS_ECP_RESTARTABLE */
3352 #endif /* MBEDTLS_X509_CRT_PARSE_C */