1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) Jeremy Harris 2014 */
7 /* This module provides TLS (aka SSL) support for Exim using the OpenSSL
8 library. It is #included into the tls.c file when that library is used.
14 #include <openssl/lhash.h>
15 #include <openssl/ssl.h>
16 #include <openssl/err.h>
17 #include <openssl/rand.h>
18 #include <openssl/x509v3.h>
21 /*****************************************************
22 * Export/import a certificate, binary/printable
23 *****************************************************/
25 tls_export_cert(uschar * buf, size_t buflen, void * cert)
27 BIO * bp = BIO_new(BIO_s_mem());
30 if ((fail = PEM_write_bio_X509(bp, (X509 *)cert) ? 0 : 1))
31 log_write(0, LOG_MAIN, "TLS error in certificate export: %s",
32 ERR_error_string(ERR_get_error(), NULL));
40 if ((n = BIO_gets(bp, cp, (int)buflen)) <= 0) break;
43 cp[-2] = '\\'; cp[-1] = 'n'; /* newline->"\n" */
44 } /* compat with string_printing() */
53 tls_import_cert(const uschar * buf, void ** cert)
55 void * reset_point = store_get(0);
56 const uschar * cp = string_unprinting(US buf);
61 bp = BIO_new_mem_buf(US cp, -1);
62 if (!(x = PEM_read_bio_X509(bp, NULL, 0, NULL)))
64 log_write(0, LOG_MAIN, "TLS error in certificate import: %s",
65 ERR_error_string(ERR_get_error(), NULL));
71 store_reset(reset_point);
76 tls_free_cert(void * cert)
78 X509_free((X509 *)cert);
82 /*****************************************************
83 * Certificate field extraction routines
84 *****************************************************/
86 /* First, some internal service functions */
91 expand_string_message = US"allocation failure";
96 bio_string_copy(BIO * bp, int len)
99 len = len > 0 ? (int) BIO_get_mem_data(bp, &cp) : 0;
100 cp = string_copyn(cp, len);
106 asn1_time_copy(const ASN1_TIME * asntime, uschar * mod)
109 BIO * bp = BIO_new(BIO_s_mem());
114 len = ASN1_TIME_print(bp, asntime);
115 len = len > 0 ? (int) BIO_get_mem_data(bp, &s) : 0;
117 if (mod && Ustrcmp(mod, "raw") == 0) /* native ASN */
118 s = string_copyn(s, len);
122 struct tm * tm_p = &tm;
124 uschar * tz = to_tz(US"GMT0"); /* need to call strptime with baseline TZ */
126 /* Parse OpenSSL ASN1_TIME_print output. A shame there seems to
127 be no other interface for the times.
130 /*XXX %Z might be glibc-specific? Solaris has it, at least*/
131 /*XXX should we switch to POSIX locale for this? */
133 if (!strptime(CCS s, "%b %e %T %Y %Z", &tm))
134 expand_string_message = US"failed time conversion";
138 time_t t = mktime(&tm); /* make the tm self-consistent */
140 if (mod && Ustrcmp(mod, "int") == 0) /* seconds since epoch */
141 s = string_sprintf("%u", t);
145 if (!timestamps_utc) /* decoded string in local TZ */
146 { /* shift to local TZ */
149 tm_p = localtime(&t);
151 /* "utc" is default, and rfc5280 says cert times should be Zulu */
153 /* convert to string in our format */
156 strftime(CS s, (size_t)len, "%b %e %T %Y %z", tm_p);
168 x509_name_copy(X509_NAME * name)
170 BIO * bp = BIO_new(BIO_s_mem());
173 if (!bp) return badalloc();
176 X509_NAME_print_ex(bp, name, 0, XN_FLAG_RFC2253) >= 0
178 return bio_string_copy(bp, len_good);
182 /* Now the extractors, called from expand.c
185 mod Optional modifiers for the operator
188 Allocated string with extracted value
192 tls_cert_issuer(void * cert, uschar * mod)
194 uschar * cp = x509_name_copy(X509_get_issuer_name((X509 *)cert));
195 return mod ? tls_field_from_dn(cp, mod) : cp;
199 tls_cert_not_before(void * cert, uschar * mod)
201 return asn1_time_copy(X509_get_notBefore((X509 *)cert), mod);
205 tls_cert_not_after(void * cert, uschar * mod)
207 return asn1_time_copy(X509_get_notAfter((X509 *)cert), mod);
211 tls_cert_serial_number(void * cert, uschar * mod)
214 BIO * bp = BIO_new(BIO_s_mem());
217 if (!bp) return badalloc();
219 len = i2a_ASN1_INTEGER(bp, X509_get_serialNumber((X509 *)cert));
220 if (len < sizeof(txt))
221 BIO_read(bp, txt, len);
225 return string_copynlc(txt, len); /* lowercase */
229 tls_cert_signature(void * cert, uschar * mod)
232 BIO * bp = BIO_new(BIO_s_mem());
234 if (!bp) return badalloc();
236 if (X509_print_ex(bp, (X509 *)cert, 0,
237 X509_FLAG_NO_HEADER | X509_FLAG_NO_VERSION | X509_FLAG_NO_SERIAL |
238 X509_FLAG_NO_SIGNAME | X509_FLAG_NO_ISSUER | X509_FLAG_NO_VALIDITY |
239 X509_FLAG_NO_SUBJECT | X509_FLAG_NO_PUBKEY | X509_FLAG_NO_EXTENSIONS |
240 /* X509_FLAG_NO_SIGDUMP is the missing one */
241 X509_FLAG_NO_AUX) == 1)
243 long len = BIO_get_mem_data(bp, &cp);
245 /* Strip leading "Signature Algorithm" line */
246 while (*cp && *cp != '\n') { cp++; len--; }
248 cp = string_copyn(cp+1, len-1);
255 tls_cert_signature_algorithm(void * cert, uschar * mod)
258 BIO * bp = BIO_new(BIO_s_mem());
260 if (!bp) return badalloc();
262 if (X509_print_ex(bp, (X509 *)cert, 0,
263 X509_FLAG_NO_HEADER | X509_FLAG_NO_VERSION | X509_FLAG_NO_SERIAL |
264 /* X509_FLAG_NO_SIGNAME is the missing one */
265 X509_FLAG_NO_ISSUER | X509_FLAG_NO_VALIDITY |
266 X509_FLAG_NO_SUBJECT | X509_FLAG_NO_PUBKEY | X509_FLAG_NO_EXTENSIONS |
267 X509_FLAG_NO_SIGDUMP | X509_FLAG_NO_AUX) == 1)
269 long len = BIO_get_mem_data(bp, &cp);
271 /* Strip leading " Signature Algorithm: " and trailing newline */
272 while (*cp && *cp != ':') { cp++; len--; }
273 do { cp++; len--; } while (*cp && *cp == ' ');
274 if (cp[len-1] == '\n') len--;
276 cp = string_copyn(cp, len);
283 tls_cert_subject(void * cert, uschar * mod)
285 uschar * cp = x509_name_copy(X509_get_subject_name((X509 *)cert));
286 return mod ? tls_field_from_dn(cp, mod) : cp;
290 tls_cert_version(void * cert, uschar * mod)
292 return string_sprintf("%d", X509_get_version((X509 *)cert));
296 tls_cert_ext_by_oid(void * cert, uschar * oid, int idx)
298 int nid = OBJ_create(CS oid, "", "");
299 int nidx = X509_get_ext_by_NID((X509 *)cert, nid, idx);
300 X509_EXTENSION * ex = X509_get_ext((X509 *)cert, nidx);
301 ASN1_OCTET_STRING * adata = X509_EXTENSION_get_data(ex);
302 BIO * bp = BIO_new(BIO_s_mem());
308 if (!bp) return badalloc();
310 M_ASN1_OCTET_STRING_print(bp, adata);
311 /* binary data, DER encoded */
313 /* just dump for now */
314 len = BIO_get_mem_data(bp, &cp1);
315 cp3 = cp2 = store_get(len*3+1);
319 sprintf(CS cp2, "%.2x ", *cp1++);
329 tls_cert_subject_altname(void * cert, uschar * mod)
331 uschar * list = NULL;
332 STACK_OF(GENERAL_NAME) * san = (STACK_OF(GENERAL_NAME) *)
333 X509_get_ext_d2i((X509 *)cert, NID_subject_alt_name, NULL, NULL);
340 if (!san) return NULL;
344 if (*mod == '>' && *++mod) sep = *mod++;
345 else if (Ustrcmp(mod, "dns")==0) { match = GEN_DNS; mod += 3; }
346 else if (Ustrcmp(mod, "uri")==0) { match = GEN_URI; mod += 3; }
347 else if (Ustrcmp(mod, "mail")==0) { match = GEN_EMAIL; mod += 4; }
354 while (sk_GENERAL_NAME_num(san) > 0)
356 GENERAL_NAME * namePart = sk_GENERAL_NAME_pop(san);
357 if (match != -1 && match != namePart->type)
359 switch (namePart->type)
363 ele = ASN1_STRING_data(namePart->d.dNSName);
364 len = ASN1_STRING_length(namePart->d.dNSName);
368 ele = ASN1_STRING_data(namePart->d.uniformResourceIdentifier);
369 len = ASN1_STRING_length(namePart->d.uniformResourceIdentifier);
373 ele = ASN1_STRING_data(namePart->d.rfc822Name);
374 len = ASN1_STRING_length(namePart->d.rfc822Name);
377 continue; /* ignore unrecognised types */
379 if (ele[len]) /* not nul-terminated */
380 ele = string_copyn(ele, len);
382 if (Ustrlen(ele) == len) /* ignore any with embedded nul */
383 list = string_append_listele(list, sep,
384 match == -1 ? string_sprintf("%s=%s", tag, ele) : ele);
387 sk_GENERAL_NAME_free(san);
392 tls_cert_ocsp_uri(void * cert, uschar * mod)
394 STACK_OF(ACCESS_DESCRIPTION) * ads = (STACK_OF(ACCESS_DESCRIPTION) *)
395 X509_get_ext_d2i((X509 *)cert, NID_info_access, NULL, NULL);
396 int adsnum = sk_ACCESS_DESCRIPTION_num(ads);
399 uschar * list = NULL;
402 if (*mod == '>' && *++mod) sep = *mod++;
404 for (i = 0; i < adsnum; i++)
406 ACCESS_DESCRIPTION * ad = sk_ACCESS_DESCRIPTION_value(ads, i);
408 if (ad && OBJ_obj2nid(ad->method) == NID_ad_OCSP)
409 list = string_append_listele(list, sep,
410 ASN1_STRING_data(ad->location->d.ia5));
416 tls_cert_crl_uri(void * cert, uschar * mod)
418 STACK_OF(DIST_POINT) * dps = (STACK_OF(DIST_POINT) *)
419 X509_get_ext_d2i((X509 *)cert, NID_crl_distribution_points,
422 int dpsnum = sk_DIST_POINT_num(dps);
425 uschar * list = NULL;
428 if (*mod == '>' && *++mod) sep = *mod++;
430 if (dps) for (i = 0; i < dpsnum; i++)
431 if ((dp = sk_DIST_POINT_value(dps, i)))
433 STACK_OF(GENERAL_NAME) * names = dp->distpoint->name.fullname;
435 int nnum = sk_GENERAL_NAME_num(names);
438 for (j = 0; j < nnum; j++)
439 if ( (np = sk_GENERAL_NAME_value(names, j))
440 && np->type == GEN_URI
442 list = string_append_listele(list, sep,
443 ASN1_STRING_data(np->d.uniformResourceIdentifier));
450 /*****************************************************
451 * Certificate operator routines
452 *****************************************************/
454 fingerprint(X509 * cert, const EVP_MD * fdig)
458 uschar md[EVP_MAX_MD_SIZE];
461 if (!X509_digest(cert,fdig,md,&n))
463 expand_string_message = US"tls_cert_fprt: out of mem\n";
466 cp = store_get(n*2+1);
467 for (j = 0; j < (int)n; j++) sprintf(CS cp+2*j, "%02X", md[j]);
472 tls_cert_fprt_md5(void * cert)
474 return fingerprint((X509 *)cert, EVP_md5());
478 tls_cert_fprt_sha1(void * cert)
480 return fingerprint((X509 *)cert, EVP_sha1());
484 tls_cert_fprt_sha256(void * cert)
486 return fingerprint((X509 *)cert, EVP_sha256());
492 /* End of tlscert-openssl.c */