24#include <openssl/objects.h>
25#include <openssl/x509v3.h>
26#include <openssl/pem.h>
27#include <openssl/rsa.h>
28#include <openssl/err.h>
30#include <freerdp/config.h>
33#include <winpr/string.h>
34#include <winpr/assert.h>
36#include <freerdp/log.h>
38#include "x509_utils.h"
40#define TAG FREERDP_TAG("crypto")
42BYTE* x509_utils_get_hash(
const X509* xcert,
const char* hash,
size_t* length)
44 UINT32 fp_len = EVP_MAX_MD_SIZE;
46 const EVP_MD* md = EVP_get_digestbyname(hash);
49 WLog_ERR(TAG,
"System does not support %s hash!", hash);
52 if (!xcert || !length)
54 WLog_ERR(TAG,
"Invalid arguments: xcert=%p, length=%p",
55 WINPR_CXX_COMPAT_CAST(
const void*, xcert),
56 WINPR_CXX_COMPAT_CAST(
const void*, length));
60 fp = calloc(fp_len + 1,
sizeof(BYTE));
63 WLog_ERR(TAG,
"could not allocate %" PRIu32
" bytes", fp_len);
67 if (X509_digest(xcert, md, fp, &fp_len) != 1)
70 WLog_ERR(TAG,
"certificate does not have a %s hash!", hash);
79static char* crypto_print_name(
const X509_NAME* name)
81 char* buffer =
nullptr;
82 BIO* outBIO = BIO_new(BIO_s_mem());
86 if (X509_NAME_print_ex(outBIO, name, 0, XN_FLAG_ONELINE) > 0)
87 buffer = x509_utils_bio_read(outBIO,
nullptr);
93char* x509_utils_get_subject(
const X509* xcert)
95 char* subject =
nullptr;
98 WLog_ERR(TAG,
"Invalid certificate nullptr");
101 subject = crypto_print_name(X509_get_subject_name(xcert));
103 WLog_WARN(TAG,
"certificate does not have a subject!");
109static const char* general_name_type_labels[] = {
"OTHERNAME",
"EMAIL ",
"DNS ",
110 "X400 ",
"DIRNAME ",
"EDIPARTY ",
111 "URI ",
"IPADD ",
"RID " };
114static const char* general_name_type_label(
int general_name_type)
116 if ((0 <= general_name_type) &&
117 ((
size_t)general_name_type < ARRAYSIZE(general_name_type_labels)))
119 return general_name_type_labels[general_name_type];
123 static char buffer[80] = WINPR_C_ARRAY_INIT;
124 (void)snprintf(buffer,
sizeof(buffer),
"Unknown general name type (%d)", general_name_type);
174typedef int (*general_name_mapper_pr)(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
177static void map_subject_alt_name(
const X509* x509,
int general_name_type,
178 general_name_mapper_pr mapper,
void* data)
180 STACK_OF(GENERAL_NAME)* gens = X509_get_ext_d2i(x509, NID_subject_alt_name,
nullptr,
nullptr);
185 const int num = sk_GENERAL_NAME_num(gens);
187 for (
int i = 0; (i < num); i++)
189 GENERAL_NAME* name = sk_GENERAL_NAME_value(gens, i);
193 if ((general_name_type == GEN_ALL) || (general_name_type == name->type))
195 if (!mapper(x509, name, data, i, num))
203 sk_GENERAL_NAME_pop_free(gens, GENERAL_NAME_free);
225typedef struct string_list
234static string_list string_list_initialize(
void)
236 const string_list empty = {
237 .strings =
nullptr, .lengths =
nullptr, .allocated = 0, .count = 0, .maximum = INT_MAX
242static BOOL string_list_allocate(string_list* list,
size_t allocate_count)
245 if (!list->strings && (list->allocated == 0) && (allocate_count > 0))
247 list->strings = (
char**)calloc(allocate_count,
sizeof(
char*));
248 list->lengths = calloc(allocate_count,
sizeof(
size_t));
250 if (!list->strings || !list->lengths)
252 free((
void*)list->strings);
254 list->strings =
nullptr;
255 list->lengths =
nullptr;
258 list->allocated = allocate_count;
263static void string_list_free(string_list* list)
268 free((
void*)list->strings);
273static BOOL check_string_is_email(WINPR_ATTR_UNUSED
const X509* x509,
const unsigned char* ustr,
276 const size_t MAX_EMAIL_LENGTH = 256;
277 const size_t MIN_EMAIL_LENGTH = 5;
282 const char* email = (
const char*)ustr;
283 const size_t len = strnlen(email, length);
284 if ((len < MIN_EMAIL_LENGTH) || (len > MAX_EMAIL_LENGTH))
290 for (
size_t i = 0; i < len; i++)
314 if ((email[0] ==
'.') || (email[at_pos - 1] ==
'.'))
318 for (
size_t i = 0; i < at_pos - 1; i++)
320 if ((email[i] ==
'.') && (email[i + 1] ==
'.'))
325 const char* domain = &email[at_pos + 1];
326 size_t domain_len = strnlen(domain, len);
328 if (!winpr_str_is_valid_hostnameN(domain, domain_len))
332 for (
size_t i = 0; i < at_pos; i++)
334 if (!isalnum(email[i]) && email[i] !=
'.' && email[i] !=
'-' && email[i] !=
'_' &&
345static BOOL check_string_is_host_or_ip(WINPR_ATTR_UNUSED
const X509* x509,
346 const unsigned char* ustr,
size_t length)
348 const char* str = (
const char*)ustr;
349 if (strnlen(str, length) != length)
351 return winpr_str_is_valid_hostnameN(str, length);
355static BOOL check_string_is_dns_name(
const X509* x509,
const unsigned char* ustr,
size_t length)
361 if ((length > 2) && (ustr[0] ==
'*') && (ustr[1] ==
'.'))
363 const unsigned char* suffix = &ustr[2];
364 const size_t suffixLength = length - 2;
367 if ((suffix[0] ==
'.') || (suffix[suffixLength - 1] ==
'.'))
370 for (
size_t x = 1; x < suffixLength; x++)
372 if (suffix[x] ==
'.')
374 if (suffix[x - 1] ==
'.')
382 return check_string_is_host_or_ip(x509, suffix, suffixLength);
384 return check_string_is_host_or_ip(x509, ustr, length);
388static BOOL check_string_is_host_or_ip_or_email(WINPR_ATTR_UNUSED
const X509* x509,
389 const unsigned char* ustr,
size_t length)
391 if (check_string_is_host_or_ip(x509, ustr, length))
393 return check_string_is_email(x509, ustr, length);
398extract_string_generic(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
int count,
399 BOOL (*fkt)(
const X509* x509,
const unsigned char* str,
size_t length))
401 string_list* list = data;
408 const ASN1_STRING* str =
nullptr;
412 str = name->d.uniformResourceIdentifier;
416 str = name->d.dNSName;
420 str = name->d.rfc822Name;
427 unsigned char* cstring =
nullptr;
428 const int rc = ASN1_STRING_to_UTF8(&cstring, str);
431 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() failed for %s: %s",
432 general_name_type_label(name->type), ERR_error_string(ERR_get_error(),
nullptr));
436 if (!fkt(x509, cstring, WINPR_ASSERTING_INT_CAST(
size_t, rc)))
438 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() does not conform to expected format %s: %s",
439 general_name_type_label(name->type), (
const char*)str);
440 OPENSSL_free(cstring);
444 if (!string_list_allocate(list, WINPR_ASSERTING_INT_CAST(WINPR_CIPHER_TYPE, count)) ||
445 (list->allocated <= 0))
447 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() allocation failed: %s",
448 general_name_type_label(name->type));
449 OPENSSL_free(cstring);
453 list->strings[list->count] = (
char*)cstring;
454 list->lengths[list->count] = WINPR_ASSERTING_INT_CAST(
size_t, rc);
457 if (list->count >= list->maximum)
459 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() limit exceeded: %s",
460 general_name_type_label(name->type));
468static int extract_string(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
int count)
470 return extract_string_generic(x509, name, data, index, count, check_string_is_dns_name);
473static int extract_email(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
int count)
475 return extract_string_generic(x509, name, data, index, count, check_string_is_email);
496typedef struct object_list
498 ASN1_OBJECT* type_id;
507static object_list object_list_initialize(
void)
509 const object_list empty = { .type_id =
nullptr,
514 .maximum = INT_MAX };
519static BOOL object_list_allocate(object_list* list,
size_t allocate_count)
521 if (!list->strings && (list->allocated == 0) && (allocate_count > 0))
523 list->strings = (
char**)calloc(allocate_count,
sizeof(list->strings[0]));
524 list->lengths = calloc(allocate_count,
sizeof(
size_t));
526 if (!list->strings || !list->lengths)
528 free((
void*)list->strings);
530 list->strings =
nullptr;
531 list->lengths =
nullptr;
534 list->allocated = allocate_count;
539WINPR_ATTR_MALLOC(free, 1)
540static
char* object_string(const X509* x509, ASN1_TYPE*
object,
size_t* pLength)
542 unsigned char* utf8String =
nullptr;
544 WINPR_ASSERT(
object);
545 WINPR_ASSERT(pLength);
550 const int length = ASN1_STRING_to_UTF8(&utf8String, object->value.asn1_string);
555 char* result =
nullptr;
556 if (check_string_is_host_or_ip_or_email(x509, utf8String,
557 WINPR_ASSERTING_INT_CAST(
size_t, length)))
559 result = strndup((
char*)utf8String, WINPR_ASSERTING_INT_CAST(
size_t, length));
561 *pLength = WINPR_ASSERTING_INT_CAST(
size_t, length);
564 WLog_ERR(TAG,
"Found invalid object_string entry in certificate: '%s'", utf8String);
565 OPENSSL_free(utf8String);
569static void object_list_free(object_list* list)
572 free((
void*)list->strings);
577static int extract_othername_object_as_string(
const X509* x509, GENERAL_NAME* name,
void* data,
578 int index,
int count)
580 object_list* list = data;
587 if (name->type != GEN_OTHERNAME)
592 if (0 != OBJ_cmp(name->d.otherName->type_id, list->type_id))
597 if (!object_list_allocate(list, WINPR_ASSERTING_INT_CAST(
size_t, count)) ||
598 (list->allocated <= 0))
603 list->strings[list->count] =
604 object_string(x509, name->d.otherName->value, &list->lengths[list->count]);
605 if (list->strings[list->count])
610 if (list->count >= list->maximum)
618char* x509_utils_get_email(
const X509* x509)
620 string_list list = string_list_initialize();
622 map_subject_alt_name(x509, GEN_EMAIL, extract_email, &list);
626 string_list_free(&list);
630 char* result = strndup(list.strings[0], list.lengths[0]);
631 OPENSSL_free(list.strings[0]);
632 string_list_free(&list);
636char* x509_utils_get_upn(
const X509* x509)
638 object_list list = object_list_initialize();
640 list.type_id = OBJ_nid2obj(NID_ms_upn);
642 map_subject_alt_name(x509, GEN_OTHERNAME, extract_othername_object_as_string, &list);
646 object_list_free(&list);
650 char* result = list.strings[0];
651 object_list_free(&list);
655char* x509_utils_get_date(
const X509* x509, BOOL startDate)
659 const ASN1_TIME* date = startDate ? X509_get0_notBefore(x509) : X509_get0_notAfter(x509);
663 BIO* bmem = BIO_new(BIO_s_mem());
668 if (ASN1_TIME_print(bmem, date))
670 BUF_MEM* bptr =
nullptr;
672 BIO_get_mem_ptr(bmem, &bptr);
673 str = strndup(bptr->data, bptr->length);
682void x509_utils_dns_names_free(
size_t count,
size_t* lengths,
char** dns_names)
688 for (
size_t i = 0; i < count; i++)
692 OPENSSL_free(dns_names[i]);
696 free((
void*)dns_names);
701static char** x509_utils_get_names(
const X509* xcert,
int general_name_type,
size_t* count,
704 string_list list = string_list_initialize();
705 map_subject_alt_name(xcert, general_name_type, extract_string, &list);
706 (*count) = list.count;
710 string_list_free(&list);
716 char** result = (
char**)calloc(list.count,
sizeof(*result));
717 (*lengths) = calloc(list.count,
sizeof(**lengths));
719 if (!result || !(*lengths))
721 string_list_free(&list);
724 (*lengths) =
nullptr;
729 for (
size_t i = 0; i < list.count; i++)
731 result[i] = list.strings[i];
732 (*lengths)[i] = list.lengths[i];
735 string_list_free(&list);
739char** x509_utils_get_dns_names(
const X509* xcert,
size_t* count,
size_t** pplengths)
741 return x509_utils_get_names(xcert, GEN_DNS, count, pplengths);
744char** x509_utils_get_ip_names(
const X509* xcert,
size_t* count,
size_t** pplengths)
746 return x509_utils_get_names(xcert, GEN_IPADD, count, pplengths);
749char* x509_utils_get_issuer(
const X509* xcert)
751 char* issuer =
nullptr;
754 WLog_ERR(TAG,
"Invalid certificate nullptr");
757 issuer = crypto_print_name(X509_get_issuer_name(xcert));
759 WLog_WARN(TAG,
"certificate does not have an issuer!");
764static int asn1_object_cmp(
const ASN1_OBJECT*
const* a,
const ASN1_OBJECT*
const* b)
767 return (a == b) ? 0 : (a ? 1 : -1);
770 return (*a == *b) ? 0 : (*a ? 1 : -1);
772 return OBJ_cmp(*a, *b);
775BOOL x509_utils_check_eku(
const X509* xcert,
int nid)
778 STACK_OF(ASN1_OBJECT)* oid_stack =
nullptr;
779 ASN1_OBJECT* oid =
nullptr;
784 oid = OBJ_nid2obj(nid);
788 oid_stack = X509_get_ext_d2i(xcert, NID_ext_key_usage,
nullptr,
nullptr);
794 WINPR_PRAGMA_DIAG_PUSH
795 WINPR_PRAGMA_DIAG_IGNORED_CAST_FUNCTION_TYPE
796 sk_ASN1_OBJECT_set_cmp_func(oid_stack, asn1_object_cmp);
797 WINPR_PRAGMA_DIAG_POP
798 if (sk_ASN1_OBJECT_find(oid_stack, oid) >= 0)
801 sk_ASN1_OBJECT_pop_free(oid_stack, ASN1_OBJECT_free);
805void x509_utils_print_info(
const X509* xcert)
807 char* subject = x509_utils_get_subject(xcert);
808 char* issuer = x509_utils_get_issuer(xcert);
809 char* fp = (
char*)x509_utils_get_hash(xcert,
"sha256",
nullptr);
813 WLog_ERR(TAG,
"error computing fingerprint");
814 goto out_free_issuer;
817 WLog_INFO(TAG,
"Certificate details:");
818 WLog_INFO(TAG,
"\tSubject: %s", subject);
819 WLog_INFO(TAG,
"\tIssuer: %s", issuer);
820 WLog_INFO(TAG,
"\tThumbprint: %s", fp);
822 "The above X.509 certificate could not be verified, possibly because you do not have "
823 "the CA certificate in your certificate store, or the certificate has expired. "
824 "Please look at the OpenSSL documentation on how to add a private CA to the store.");
831X509* x509_utils_from_pem(
const char* data,
size_t len, BOOL fromFile)
835 bio = BIO_new_file(data,
"rb");
841 bio = BIO_new_mem_buf(data, (
int)len);
846 WLog_ERR(TAG,
"BIO_new failed for certificate");
850 X509* x509 = PEM_read_bio_X509(bio,
nullptr,
nullptr,
nullptr);
853 WLog_ERR(TAG,
"PEM_read_bio_X509 returned nullptr [input length %" PRIuz
"]", len);
859static WINPR_MD_TYPE hash_nid_to_winpr(
int hash_nid)
870 return WINPR_MD_SHA1;
872 return WINPR_MD_SHA224;
874 return WINPR_MD_SHA256;
876 return WINPR_MD_SHA384;
878 return WINPR_MD_SHA512;
880 return WINPR_MD_RIPEMD160;
881#if (OPENSSL_VERSION_NUMBER >= 0x1010101fL) && !defined(LIBRESSL_VERSION_NUMBER)
883 return WINPR_MD_SHA3_224;
885 return WINPR_MD_SHA3_256;
887 return WINPR_MD_SHA3_384;
889 return WINPR_MD_SHA3_512;
891 return WINPR_MD_SHAKE128;
893 return WINPR_MD_SHAKE256;
897 return WINPR_MD_NONE;
902static WINPR_MD_TYPE get_rsa_pss_digest(
const X509_ALGOR* alg)
904 WINPR_MD_TYPE ret = WINPR_MD_NONE;
905 WINPR_MD_TYPE message_digest = WINPR_MD_NONE;
906 WINPR_MD_TYPE mgf1_digest = WINPR_MD_NONE;
908 const void* param_value =
nullptr;
909 const ASN1_STRING* sequence =
nullptr;
910 const unsigned char* inp =
nullptr;
911 RSA_PSS_PARAMS* params =
nullptr;
912 X509_ALGOR* mgf1_digest_alg =
nullptr;
916 X509_ALGOR_get0(
nullptr, ¶m_type, ¶m_value, alg);
921 if (param_type != V_ASN1_SEQUENCE)
923 sequence = param_value;
926 inp = ASN1_STRING_get0_data(sequence);
927 params = d2i_RSA_PSS_PARAMS(
nullptr, &inp, ASN1_STRING_length(sequence));
928 if (params ==
nullptr)
934 message_digest = WINPR_MD_SHA1;
935 if (params->hashAlgorithm !=
nullptr)
937 const ASN1_OBJECT* obj =
nullptr;
938 X509_ALGOR_get0(&obj,
nullptr,
nullptr, params->hashAlgorithm);
939 message_digest = hash_nid_to_winpr(OBJ_obj2nid(obj));
940 if (message_digest == WINPR_MD_NONE)
944 mgf1_digest = WINPR_MD_SHA1;
945 if (params->maskGenAlgorithm !=
nullptr)
947 const ASN1_OBJECT* obj =
nullptr;
948 int mgf_param_type = 0;
949 const void* mgf_param_value =
nullptr;
950 const ASN1_STRING* mgf_param_sequence =
nullptr;
952 X509_ALGOR_get0(&obj, &mgf_param_type, &mgf_param_value, params->maskGenAlgorithm);
953 if (OBJ_obj2nid(obj) != NID_mgf1)
957 if (mgf_param_type != V_ASN1_SEQUENCE)
959 mgf_param_sequence = mgf_param_value;
960 inp = ASN1_STRING_get0_data(mgf_param_sequence);
961 mgf1_digest_alg = d2i_X509_ALGOR(
nullptr, &inp, ASN1_STRING_length(mgf_param_sequence));
962 if (mgf1_digest_alg ==
nullptr)
966 X509_ALGOR_get0(&obj,
nullptr,
nullptr, mgf1_digest_alg);
967 mgf1_digest = hash_nid_to_winpr(OBJ_obj2nid(obj));
968 if (mgf1_digest == WINPR_MD_NONE)
975 if (message_digest != mgf1_digest)
977 ret = message_digest;
980 RSA_PSS_PARAMS_free(params);
981 X509_ALGOR_free(mgf1_digest_alg);
985WINPR_MD_TYPE x509_utils_get_signature_alg(
const X509* xcert)
989 const int nid = X509_get_signature_nid(xcert);
991 if (nid == NID_rsassaPss)
993 const X509_ALGOR* alg =
nullptr;
994 X509_get0_signature(
nullptr, &alg, xcert);
995 return get_rsa_pss_digest(alg);
999 if (OBJ_find_sigid_algs(nid, &hash_nid,
nullptr) != 1)
1000 return WINPR_MD_NONE;
1002 return hash_nid_to_winpr(hash_nid);
1005char* x509_utils_get_common_name(
const X509* xcert,
size_t* plength)
1007 const X509_NAME* subject_name = X509_get_subject_name(xcert);
1008 if (subject_name ==
nullptr)
1011 const int index = X509_NAME_get_index_by_NID(subject_name, NID_commonName, -1);
1015 const X509_NAME_ENTRY* entry = X509_NAME_get_entry(subject_name, index);
1016 if (entry ==
nullptr)
1019 const ASN1_STRING* entry_data = X509_NAME_ENTRY_get_data(entry);
1020 if (entry_data ==
nullptr)
1023 BYTE* common_name_raw =
nullptr;
1024 const int length = ASN1_STRING_to_UTF8(&common_name_raw, entry_data);
1028 char* common_name =
nullptr;
1029 if (check_string_is_dns_name(xcert, common_name_raw, WINPR_ASSERTING_INT_CAST(
size_t, length)))
1032 *plength = (size_t)length;
1034 common_name = strndup((
char*)common_name_raw, (
size_t)length);
1036 OPENSSL_free(common_name_raw);
1041static int verify_cb(
int ok, X509_STORE_CTX* csc)
1046 int err = X509_STORE_CTX_get_error(csc);
1047 int derr = X509_STORE_CTX_get_error_depth(csc);
1048 X509* where = X509_STORE_CTX_get_current_cert(csc);
1049 const char* what = X509_verify_cert_error_string(err);
1050 char* name = x509_utils_get_subject(where);
1052 WLog_WARN(TAG,
"Certificate verification failure '%s (%d)' at stack position %d", what, err,
1054 WLog_WARN(TAG,
"%s", name);
1061BOOL x509_utils_verify(X509* xcert, STACK_OF(X509) * chain,
const char* certificate_store_path)
1063 const int purposes[] = { X509_PURPOSE_SSL_SERVER };
1064 BOOL status = FALSE;
1069 X509_STORE* cert_ctx = X509_STORE_new();
1071 if (cert_ctx ==
nullptr)
1074#if OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
1075 OpenSSL_add_all_algorithms();
1077 OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS | OPENSSL_INIT_ADD_ALL_DIGESTS |
1078 OPENSSL_INIT_LOAD_CONFIG,
1082 if (X509_STORE_set_default_paths(cert_ctx) != 1)
1085 X509_LOOKUP* lookup = X509_STORE_add_lookup(cert_ctx, X509_LOOKUP_hash_dir());
1087 if (lookup ==
nullptr)
1090 X509_LOOKUP_add_dir(lookup,
nullptr, X509_FILETYPE_DEFAULT);
1092 if (certificate_store_path !=
nullptr)
1094 X509_LOOKUP_add_dir(lookup, certificate_store_path, X509_FILETYPE_PEM);
1097 X509_STORE_set_flags(cert_ctx, 0);
1099 for (
size_t i = 0; i < ARRAYSIZE(purposes); i++)
1103 int purpose = purposes[i];
1104 X509_STORE_CTX* csc = X509_STORE_CTX_new();
1108 if (!X509_STORE_CTX_init(csc, cert_ctx, xcert, chain))
1111 X509_STORE_CTX_set_purpose(csc, purpose);
1112 X509_STORE_CTX_set_verify_cb(csc, verify_cb);
1114 rc = X509_verify_cert(csc);
1115 err = X509_STORE_CTX_get_error(csc);
1117 X509_STORE_CTX_free(csc);
1123 else if (err != X509_V_ERR_INVALID_PURPOSE)
1127 X509_STORE_free(cert_ctx);
1132char* x509_utils_bio_read(BIO* bio,
size_t* plen)
1134 char* buffer =
nullptr;
1142 const UINT64 size = BIO_number_written(bio);
1146 buffer = calloc(1, (
size_t)size + 1ull);
1152 const int rc = BIO_read(bio, buffer, (
int)size);
1165void x509_utils_ip_names_free(
size_t count,
size_t* lengths,
char** dns_names)
1167 x509_utils_dns_names_free(count, lengths, dns_names);