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;
424 str = name->d.iPAddress;
431 unsigned char* cstring =
nullptr;
432 const int rc = ASN1_STRING_to_UTF8(&cstring, str);
435 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() failed for %s: %s",
436 general_name_type_label(name->type), ERR_error_string(ERR_get_error(),
nullptr));
440 if (!fkt(x509, cstring, WINPR_ASSERTING_INT_CAST(
size_t, rc)))
442 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() does not conform to expected format %s: %s",
443 general_name_type_label(name->type), (
const char*)str);
444 OPENSSL_free(cstring);
448 if (!string_list_allocate(list, WINPR_ASSERTING_INT_CAST(WINPR_CIPHER_TYPE, count)) ||
449 (list->allocated <= 0))
451 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() allocation failed: %s",
452 general_name_type_label(name->type));
453 OPENSSL_free(cstring);
457 list->strings[list->count] = (
char*)cstring;
458 list->lengths[list->count] = WINPR_ASSERTING_INT_CAST(
size_t, rc);
461 if (list->count >= list->maximum)
463 WLog_ERR(TAG,
"ASN1_STRING_to_UTF8() limit exceeded: %s",
464 general_name_type_label(name->type));
472static int extract_string(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
int count)
474 return extract_string_generic(x509, name, data, index, count, check_string_is_dns_name);
477static int extract_email(
const X509* x509, GENERAL_NAME* name,
void* data,
int index,
int count)
479 return extract_string_generic(x509, name, data, index, count, check_string_is_email);
500typedef struct object_list
502 ASN1_OBJECT* type_id;
511static object_list object_list_initialize(
void)
513 const object_list empty = { .type_id =
nullptr,
518 .maximum = INT_MAX };
523static BOOL object_list_allocate(object_list* list,
size_t allocate_count)
525 if (!list->strings && (list->allocated == 0) && (allocate_count > 0))
527 list->strings = (
char**)calloc(allocate_count,
sizeof(list->strings[0]));
528 list->lengths = calloc(allocate_count,
sizeof(
size_t));
530 if (!list->strings || !list->lengths)
532 free((
void*)list->strings);
534 list->strings =
nullptr;
535 list->lengths =
nullptr;
538 list->allocated = allocate_count;
543WINPR_ATTR_MALLOC(free, 1)
544static
char* object_string(const X509* x509, ASN1_TYPE*
object,
size_t* pLength)
546 unsigned char* utf8String =
nullptr;
548 WINPR_ASSERT(
object);
549 WINPR_ASSERT(pLength);
554 const int length = ASN1_STRING_to_UTF8(&utf8String, object->value.asn1_string);
559 char* result =
nullptr;
560 if (check_string_is_host_or_ip_or_email(x509, utf8String,
561 WINPR_ASSERTING_INT_CAST(
size_t, length)))
563 result = strndup((
char*)utf8String, WINPR_ASSERTING_INT_CAST(
size_t, length));
565 *pLength = WINPR_ASSERTING_INT_CAST(
size_t, length);
568 WLog_ERR(TAG,
"Found invalid object_string entry in certificate: '%s'", utf8String);
569 OPENSSL_free(utf8String);
573static void object_list_free(object_list* list)
576 free((
void*)list->strings);
581static int extract_othername_object_as_string(
const X509* x509, GENERAL_NAME* name,
void* data,
582 int index,
int count)
584 object_list* list = data;
591 if (name->type != GEN_OTHERNAME)
596 if (0 != OBJ_cmp(name->d.otherName->type_id, list->type_id))
601 if (!object_list_allocate(list, WINPR_ASSERTING_INT_CAST(
size_t, count)) ||
602 (list->allocated <= 0))
607 list->strings[list->count] =
608 object_string(x509, name->d.otherName->value, &list->lengths[list->count]);
609 if (list->strings[list->count])
614 if (list->count >= list->maximum)
622char* x509_utils_get_email(
const X509* x509)
624 string_list list = string_list_initialize();
626 map_subject_alt_name(x509, GEN_EMAIL, extract_email, &list);
630 string_list_free(&list);
634 char* result = strndup(list.strings[0], list.lengths[0]);
635 OPENSSL_free(list.strings[0]);
636 string_list_free(&list);
640char* x509_utils_get_upn(
const X509* x509)
642 object_list list = object_list_initialize();
644 list.type_id = OBJ_nid2obj(NID_ms_upn);
646 map_subject_alt_name(x509, GEN_OTHERNAME, extract_othername_object_as_string, &list);
650 object_list_free(&list);
654 char* result = list.strings[0];
655 object_list_free(&list);
659char* x509_utils_get_date(
const X509* x509, BOOL startDate)
663 const ASN1_TIME* date = startDate ? X509_get0_notBefore(x509) : X509_get0_notAfter(x509);
667 BIO* bmem = BIO_new(BIO_s_mem());
672 if (ASN1_TIME_print(bmem, date))
674 BUF_MEM* bptr =
nullptr;
676 BIO_get_mem_ptr(bmem, &bptr);
677 str = strndup(bptr->data, bptr->length);
686void x509_utils_dns_names_free(
size_t count,
size_t* lengths,
char** dns_names)
692 for (
size_t i = 0; i < count; i++)
696 OPENSSL_free(dns_names[i]);
700 free((
void*)dns_names);
705static char** x509_utils_get_names(
const X509* xcert,
int general_name_type,
size_t* count,
708 string_list list = string_list_initialize();
709 map_subject_alt_name(xcert, general_name_type, extract_string, &list);
710 (*count) = list.count;
714 string_list_free(&list);
720 char** result = (
char**)calloc(list.count,
sizeof(*result));
721 (*lengths) = calloc(list.count,
sizeof(**lengths));
723 if (!result || !(*lengths))
725 string_list_free(&list);
728 (*lengths) =
nullptr;
733 for (
size_t i = 0; i < list.count; i++)
735 result[i] = list.strings[i];
736 (*lengths)[i] = list.lengths[i];
739 string_list_free(&list);
743char** x509_utils_get_dns_names(
const X509* xcert,
size_t* count,
size_t** pplengths)
745 return x509_utils_get_names(xcert, GEN_DNS, count, pplengths);
748char** x509_utils_get_ip_names(
const X509* xcert,
size_t* count,
size_t** pplengths)
750 return x509_utils_get_names(xcert, GEN_IPADD, count, pplengths);
753char* x509_utils_get_issuer(
const X509* xcert)
755 char* issuer =
nullptr;
758 WLog_ERR(TAG,
"Invalid certificate nullptr");
761 issuer = crypto_print_name(X509_get_issuer_name(xcert));
763 WLog_WARN(TAG,
"certificate does not have an issuer!");
768static int asn1_object_cmp(
const ASN1_OBJECT*
const* a,
const ASN1_OBJECT*
const* b)
771 return (a == b) ? 0 : (a ? 1 : -1);
774 return (*a == *b) ? 0 : (*a ? 1 : -1);
776 return OBJ_cmp(*a, *b);
779BOOL x509_utils_check_eku(
const X509* xcert,
int nid)
782 STACK_OF(ASN1_OBJECT)* oid_stack =
nullptr;
783 ASN1_OBJECT* oid =
nullptr;
788 oid = OBJ_nid2obj(nid);
792 oid_stack = X509_get_ext_d2i(xcert, NID_ext_key_usage,
nullptr,
nullptr);
798 WINPR_PRAGMA_DIAG_PUSH
799 WINPR_PRAGMA_DIAG_IGNORED_CAST_FUNCTION_TYPE
800 sk_ASN1_OBJECT_set_cmp_func(oid_stack, asn1_object_cmp);
801 WINPR_PRAGMA_DIAG_POP
802 if (sk_ASN1_OBJECT_find(oid_stack, oid) >= 0)
805 sk_ASN1_OBJECT_pop_free(oid_stack, ASN1_OBJECT_free);
809void x509_utils_print_info(
const X509* xcert)
811 char* subject = x509_utils_get_subject(xcert);
812 char* issuer = x509_utils_get_issuer(xcert);
813 char* fp = (
char*)x509_utils_get_hash(xcert,
"sha256",
nullptr);
817 WLog_ERR(TAG,
"error computing fingerprint");
818 goto out_free_issuer;
821 WLog_INFO(TAG,
"Certificate details:");
822 WLog_INFO(TAG,
"\tSubject: %s", subject);
823 WLog_INFO(TAG,
"\tIssuer: %s", issuer);
824 WLog_INFO(TAG,
"\tThumbprint: %s", fp);
826 "The above X.509 certificate could not be verified, possibly because you do not have "
827 "the CA certificate in your certificate store, or the certificate has expired. "
828 "Please look at the OpenSSL documentation on how to add a private CA to the store.");
835X509* x509_utils_from_pem(
const char* data,
size_t len, BOOL fromFile)
839 bio = BIO_new_file(data,
"rb");
845 bio = BIO_new_mem_buf(data, (
int)len);
850 WLog_ERR(TAG,
"BIO_new failed for certificate");
854 X509* x509 = PEM_read_bio_X509(bio,
nullptr,
nullptr,
nullptr);
857 WLog_ERR(TAG,
"PEM_read_bio_X509 returned nullptr [input length %" PRIuz
"]", len);
863static WINPR_MD_TYPE hash_nid_to_winpr(
int hash_nid)
874 return WINPR_MD_SHA1;
876 return WINPR_MD_SHA224;
878 return WINPR_MD_SHA256;
880 return WINPR_MD_SHA384;
882 return WINPR_MD_SHA512;
884 return WINPR_MD_RIPEMD160;
885#if (OPENSSL_VERSION_NUMBER >= 0x1010101fL) && !defined(LIBRESSL_VERSION_NUMBER)
887 return WINPR_MD_SHA3_224;
889 return WINPR_MD_SHA3_256;
891 return WINPR_MD_SHA3_384;
893 return WINPR_MD_SHA3_512;
895 return WINPR_MD_SHAKE128;
897 return WINPR_MD_SHAKE256;
901 return WINPR_MD_NONE;
906static WINPR_MD_TYPE get_rsa_pss_digest(
const X509_ALGOR* alg)
908 WINPR_MD_TYPE ret = WINPR_MD_NONE;
909 WINPR_MD_TYPE message_digest = WINPR_MD_NONE;
910 WINPR_MD_TYPE mgf1_digest = WINPR_MD_NONE;
912 const void* param_value =
nullptr;
913 const ASN1_STRING* sequence =
nullptr;
914 const unsigned char* inp =
nullptr;
915 RSA_PSS_PARAMS* params =
nullptr;
916 X509_ALGOR* mgf1_digest_alg =
nullptr;
920 X509_ALGOR_get0(
nullptr, ¶m_type, ¶m_value, alg);
925 if (param_type != V_ASN1_SEQUENCE)
927 sequence = param_value;
930 inp = ASN1_STRING_get0_data(sequence);
931 params = d2i_RSA_PSS_PARAMS(
nullptr, &inp, ASN1_STRING_length(sequence));
932 if (params ==
nullptr)
938 message_digest = WINPR_MD_SHA1;
939 if (params->hashAlgorithm !=
nullptr)
941 const ASN1_OBJECT* obj =
nullptr;
942 X509_ALGOR_get0(&obj,
nullptr,
nullptr, params->hashAlgorithm);
943 message_digest = hash_nid_to_winpr(OBJ_obj2nid(obj));
944 if (message_digest == WINPR_MD_NONE)
948 mgf1_digest = WINPR_MD_SHA1;
949 if (params->maskGenAlgorithm !=
nullptr)
951 const ASN1_OBJECT* obj =
nullptr;
952 int mgf_param_type = 0;
953 const void* mgf_param_value =
nullptr;
954 const ASN1_STRING* mgf_param_sequence =
nullptr;
956 X509_ALGOR_get0(&obj, &mgf_param_type, &mgf_param_value, params->maskGenAlgorithm);
957 if (OBJ_obj2nid(obj) != NID_mgf1)
961 if (mgf_param_type != V_ASN1_SEQUENCE)
963 mgf_param_sequence = mgf_param_value;
964 inp = ASN1_STRING_get0_data(mgf_param_sequence);
965 mgf1_digest_alg = d2i_X509_ALGOR(
nullptr, &inp, ASN1_STRING_length(mgf_param_sequence));
966 if (mgf1_digest_alg ==
nullptr)
970 X509_ALGOR_get0(&obj,
nullptr,
nullptr, mgf1_digest_alg);
971 mgf1_digest = hash_nid_to_winpr(OBJ_obj2nid(obj));
972 if (mgf1_digest == WINPR_MD_NONE)
979 if (message_digest != mgf1_digest)
981 ret = message_digest;
984 RSA_PSS_PARAMS_free(params);
985 X509_ALGOR_free(mgf1_digest_alg);
989WINPR_MD_TYPE x509_utils_get_signature_alg(
const X509* xcert)
993 const int nid = X509_get_signature_nid(xcert);
995 if (nid == NID_rsassaPss)
997 const X509_ALGOR* alg =
nullptr;
998 X509_get0_signature(
nullptr, &alg, xcert);
999 return get_rsa_pss_digest(alg);
1003 if (OBJ_find_sigid_algs(nid, &hash_nid,
nullptr) != 1)
1004 return WINPR_MD_NONE;
1006 return hash_nid_to_winpr(hash_nid);
1009char* x509_utils_get_common_name(
const X509* xcert,
size_t* plength)
1011 const X509_NAME* subject_name = X509_get_subject_name(xcert);
1012 if (subject_name ==
nullptr)
1015 const int index = X509_NAME_get_index_by_NID(subject_name, NID_commonName, -1);
1019 const X509_NAME_ENTRY* entry = X509_NAME_get_entry(subject_name, index);
1020 if (entry ==
nullptr)
1023 const ASN1_STRING* entry_data = X509_NAME_ENTRY_get_data(entry);
1024 if (entry_data ==
nullptr)
1027 BYTE* common_name_raw =
nullptr;
1028 const int length = ASN1_STRING_to_UTF8(&common_name_raw, entry_data);
1032 char* common_name =
nullptr;
1033 if (check_string_is_dns_name(xcert, common_name_raw, WINPR_ASSERTING_INT_CAST(
size_t, length)))
1036 *plength = (size_t)length;
1038 common_name = strndup((
char*)common_name_raw, (
size_t)length);
1040 OPENSSL_free(common_name_raw);
1045static int verify_cb(
int ok, X509_STORE_CTX* csc)
1050 int err = X509_STORE_CTX_get_error(csc);
1051 int derr = X509_STORE_CTX_get_error_depth(csc);
1052 X509* where = X509_STORE_CTX_get_current_cert(csc);
1053 const char* what = X509_verify_cert_error_string(err);
1054 char* name = x509_utils_get_subject(where);
1056 WLog_WARN(TAG,
"Certificate verification failure '%s (%d)' at stack position %d", what, err,
1058 WLog_WARN(TAG,
"%s", name);
1065BOOL x509_utils_verify(X509* xcert, STACK_OF(X509) * chain,
const char* certificate_store_path)
1067 const int purposes[] = { X509_PURPOSE_SSL_SERVER };
1068 BOOL status = FALSE;
1073 X509_STORE* cert_ctx = X509_STORE_new();
1075 if (cert_ctx ==
nullptr)
1078#if OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
1079 OpenSSL_add_all_algorithms();
1081 OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS | OPENSSL_INIT_ADD_ALL_DIGESTS |
1082 OPENSSL_INIT_LOAD_CONFIG,
1086 if (X509_STORE_set_default_paths(cert_ctx) != 1)
1089 X509_LOOKUP* lookup = X509_STORE_add_lookup(cert_ctx, X509_LOOKUP_hash_dir());
1091 if (lookup ==
nullptr)
1094 X509_LOOKUP_add_dir(lookup,
nullptr, X509_FILETYPE_DEFAULT);
1096 if (certificate_store_path !=
nullptr)
1098 X509_LOOKUP_add_dir(lookup, certificate_store_path, X509_FILETYPE_PEM);
1101 X509_STORE_set_flags(cert_ctx, 0);
1103 for (
size_t i = 0; i < ARRAYSIZE(purposes); i++)
1107 int purpose = purposes[i];
1108 X509_STORE_CTX* csc = X509_STORE_CTX_new();
1112 if (!X509_STORE_CTX_init(csc, cert_ctx, xcert, chain))
1115 X509_STORE_CTX_set_purpose(csc, purpose);
1116 X509_STORE_CTX_set_verify_cb(csc, verify_cb);
1118 rc = X509_verify_cert(csc);
1119 err = X509_STORE_CTX_get_error(csc);
1121 X509_STORE_CTX_free(csc);
1127 else if (err != X509_V_ERR_INVALID_PURPOSE)
1131 X509_STORE_free(cert_ctx);
1136char* x509_utils_bio_read(BIO* bio,
size_t* plen)
1138 char* buffer =
nullptr;
1146 const UINT64 size = BIO_number_written(bio);
1150 buffer = calloc(1, (
size_t)size + 1ull);
1156 const int rc = BIO_read(bio, buffer, (
int)size);
1169void x509_utils_ip_names_free(
size_t count,
size_t* lengths,
char** dns_names)
1171 x509_utils_dns_names_free(count, lengths, dns_names);