1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) Jeremy Harris 2014 - 2018 */
7 /* This file provides TLS/SSL support for Exim using the GnuTLS library,
8 one of the available supported implementations. This file is #included into
9 tls.c when USE_GNUTLS has been set.
12 #include <gnutls/gnutls.h>
13 /* needed for cert checks in verification and DN extraction: */
14 #include <gnutls/x509.h>
15 /* needed to disable PKCS11 autoload unless requested */
16 #if GNUTLS_VERSION_NUMBER >= 0x020c00
17 # include <gnutls/pkcs11.h>
21 /*****************************************************
22 * Export/import a certificate, binary/printable
23 *****************************************************/
25 tls_export_cert(uschar * buf, size_t buflen, void * cert)
28 void * reset_point = store_get(0);
32 if ((fail = gnutls_x509_crt_export((gnutls_x509_crt_t)cert,
33 GNUTLS_X509_FMT_PEM, buf, &sz)))
35 log_write(0, LOG_MAIN, "TLS error in certificate export: %s",
36 gnutls_strerror(fail));
39 if ((cp = string_printing(buf)) != buf)
41 Ustrncpy(buf, cp, buflen);
45 store_reset(reset_point);
50 tls_import_cert(const uschar * buf, void ** cert)
52 void * reset_point = store_get(0);
54 gnutls_x509_crt_t crt = *(gnutls_x509_crt_t *)cert;
58 gnutls_x509_crt_deinit(crt);
62 gnutls_x509_crt_init(&crt);
64 datum.data = string_unprinting(US buf);
65 datum.size = Ustrlen(datum.data);
66 if ((fail = gnutls_x509_crt_import(crt, &datum, GNUTLS_X509_FMT_PEM)))
68 log_write(0, LOG_MAIN, "TLS error in certificate import: %s",
69 gnutls_strerror(fail));
75 store_reset(reset_point);
80 tls_free_cert(void ** cert)
82 gnutls_x509_crt_t crt = *(gnutls_x509_crt_t *)cert;
85 gnutls_x509_crt_deinit(crt);
86 gnutls_global_deinit();
91 /*****************************************************
92 * Certificate field extraction routines
93 *****************************************************/
95 /* First, some internal service functions */
98 g_err(const char * tag, const char * from, int gnutls_err)
100 expand_string_message = string_sprintf("%s: %s fail: %s\n",
101 from, tag, gnutls_strerror(gnutls_err));
107 time_copy(time_t t, uschar * mod)
112 if (mod && Ustrcmp(mod, "int") == 0)
113 return string_sprintf("%u", (unsigned)t);
116 if (f.timestamps_utc)
118 uschar * tz = to_tz(US"GMT0");
119 len = strftime(CS cp, len, "%b %e %T %Y %Z", gmtime(&t));
123 len = strftime(CS cp, len, "%b %e %T %Y %Z", localtime(&t));
124 return len > 0 ? cp : NULL;
129 /* Now the extractors, called from expand.c
132 mod Optional modifiers for the operator
135 Allocated string with extracted value
139 tls_cert_issuer(void * cert, uschar * mod)
145 if ((ret = gnutls_x509_crt_get_issuer_dn(cert, CS cp, &siz))
146 != GNUTLS_E_SHORT_MEMORY_BUFFER)
147 return g_err("gi0", __FUNCTION__, ret);
150 if ((ret = gnutls_x509_crt_get_issuer_dn(cert, CS cp, &siz)) < 0)
151 return g_err("gi1", __FUNCTION__, ret);
153 return mod ? tls_field_from_dn(cp, mod) : cp;
157 tls_cert_not_after(void * cert, uschar * mod)
160 gnutls_x509_crt_get_expiration_time((gnutls_x509_crt_t)cert),
165 tls_cert_not_before(void * cert, uschar * mod)
168 gnutls_x509_crt_get_activation_time((gnutls_x509_crt_t)cert),
173 tls_cert_serial_number(void * cert, uschar * mod)
175 uschar bin[50], txt[150];
176 size_t sz = sizeof(bin);
181 if ((ret = gnutls_x509_crt_get_serial((gnutls_x509_crt_t)cert,
183 return g_err("gs0", __FUNCTION__, ret);
185 for(dp = txt, sp = bin; sz; sz--)
186 dp += sprintf(CS dp, "%.2x", *sp++);
187 for(sp = txt; sp[0]=='0' && sp[1]; ) sp++; /* leading zeroes */
188 return string_copy(sp);
192 tls_cert_signature(void * cert, uschar * mod)
200 if ((ret = gnutls_x509_crt_get_signature((gnutls_x509_crt_t)cert, CS cp1, &len))
201 != GNUTLS_E_SHORT_MEMORY_BUFFER)
202 return g_err("gs0", __FUNCTION__, ret);
204 cp1 = store_get(len*4+1);
205 if (gnutls_x509_crt_get_signature((gnutls_x509_crt_t)cert, CS cp1, &len) != 0)
206 return g_err("gs1", __FUNCTION__, ret);
208 for(cp3 = cp2 = cp1+len; cp1 < cp2; cp1++)
209 cp3 += sprintf(CS cp3, "%.2x ", *cp1);
216 tls_cert_signature_algorithm(void * cert, uschar * mod)
218 gnutls_sign_algorithm_t algo =
219 gnutls_x509_crt_get_signature_algorithm((gnutls_x509_crt_t)cert);
220 return algo < 0 ? NULL : string_copy(US gnutls_sign_get_name(algo));
224 tls_cert_subject(void * cert, uschar * mod)
230 if ((ret = gnutls_x509_crt_get_dn(cert, CS cp, &siz))
231 != GNUTLS_E_SHORT_MEMORY_BUFFER)
232 return g_err("gs0", __FUNCTION__, ret);
235 if ((ret = gnutls_x509_crt_get_dn(cert, CS cp, &siz)) < 0)
236 return g_err("gs1", __FUNCTION__, ret);
238 return mod ? tls_field_from_dn(cp, mod) : cp;
242 tls_cert_version(void * cert, uschar * mod)
244 return string_sprintf("%d", gnutls_x509_crt_get_version(cert));
248 tls_cert_ext_by_oid(void * cert, uschar * oid, int idx)
257 ret = gnutls_x509_crt_get_extension_by_oid ((gnutls_x509_crt_t)cert,
258 oid, idx, CS cp1, &siz, &crit);
259 if (ret != GNUTLS_E_SHORT_MEMORY_BUFFER)
260 return g_err("ge0", __FUNCTION__, ret);
262 cp1 = store_get(siz*4 + 1);
264 ret = gnutls_x509_crt_get_extension_by_oid ((gnutls_x509_crt_t)cert,
265 oid, idx, CS cp1, &siz, &crit);
267 return g_err("ge1", __FUNCTION__, ret);
269 /* binary data, DER encoded */
271 /* just dump for now */
272 for(cp3 = cp2 = cp1+siz; cp1 < cp2; cp1++)
273 cp3 += sprintf(CS cp3, "%.2x ", *cp1);
280 tls_cert_subject_altname(void * cert, uschar * mod)
282 gstring * list = NULL;
293 if (*mod == '>' && *++mod) sep = *mod++;
294 else if (Ustrcmp(mod, "dns")==0) { match = GNUTLS_SAN_DNSNAME; mod += 3; }
295 else if (Ustrcmp(mod, "uri")==0) { match = GNUTLS_SAN_URI; mod += 3; }
296 else if (Ustrcmp(mod, "mail")==0) { match = GNUTLS_SAN_RFC822NAME; mod += 4; }
303 for(index = 0;; index++)
306 switch(ret = gnutls_x509_crt_get_subject_alt_name(
307 (gnutls_x509_crt_t)cert, index, NULL, &siz, NULL))
309 case GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE:
310 return string_from_gstring(list); /* no more elements; normal exit */
312 case GNUTLS_E_SHORT_MEMORY_BUFFER:
316 return g_err("gs0", __FUNCTION__, ret);
319 ele = store_get(siz+1);
320 if ((ret = gnutls_x509_crt_get_subject_alt_name(
321 (gnutls_x509_crt_t)cert, index, ele, &siz, NULL)) < 0)
322 return g_err("gs1", __FUNCTION__, ret);
325 if ( match != -1 && match != ret /* wrong type of SAN */
326 || Ustrlen(ele) != siz) /* contains a NUL */
330 case GNUTLS_SAN_DNSNAME: tag = US"DNS"; break;
331 case GNUTLS_SAN_URI: tag = US"URI"; break;
332 case GNUTLS_SAN_RFC822NAME: tag = US"MAIL"; break;
333 default: continue; /* ignore unrecognised types */
335 list = string_append_listele(list, sep,
336 match == -1 ? string_sprintf("%s=%s", tag, ele) : ele);
342 tls_cert_ocsp_uri(void * cert, uschar * mod)
344 #if GNUTLS_VERSION_NUMBER >= 0x030000
349 gstring * list = NULL;
352 if (*mod == '>' && *++mod) sep = *mod++;
354 for(index = 0;; index++)
356 ret = gnutls_x509_crt_get_authority_info_access((gnutls_x509_crt_t)cert,
357 index, GNUTLS_IA_OCSP_URI, &uri, NULL);
359 if (ret == GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE)
360 return string_from_gstring(list);
362 return g_err("gai", __FUNCTION__, ret);
364 list = string_append_listele_n(list, sep, uri.data, uri.size);
370 expand_string_message =
371 string_sprintf("%s: OCSP support with GnuTLS requires version 3.0.0\n",
379 tls_cert_crl_uri(void * cert, uschar * mod)
385 gstring * list = NULL;
389 if (*mod == '>' && *++mod) sep = *mod++;
391 for(index = 0;; index++)
394 switch(ret = gnutls_x509_crt_get_crl_dist_points(
395 (gnutls_x509_crt_t)cert, index, NULL, &siz, NULL, NULL))
397 case GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE:
398 return string_from_gstring(list);
399 case GNUTLS_E_SHORT_MEMORY_BUFFER:
402 return g_err("gc0", __FUNCTION__, ret);
405 ele = store_get(siz);
406 if ((ret = gnutls_x509_crt_get_crl_dist_points(
407 (gnutls_x509_crt_t)cert, index, ele, &siz, NULL, NULL)) < 0)
408 return g_err("gc1", __FUNCTION__, ret);
410 list = string_append_listele_n(list, sep, ele, siz);
416 /*****************************************************
417 * Certificate operator routines
418 *****************************************************/
420 tls_cert_der_b64(void * cert)
426 if ( (fail = gnutls_x509_crt_export((gnutls_x509_crt_t)cert,
427 GNUTLS_X509_FMT_DER, cp, &len)) != GNUTLS_E_SHORT_MEMORY_BUFFER
428 || !(cp = store_get((int)len))
429 || (fail = gnutls_x509_crt_export((gnutls_x509_crt_t)cert,
430 GNUTLS_X509_FMT_DER, cp, &len))
433 log_write(0, LOG_MAIN, "TLS error in certificate export: %s",
434 gnutls_strerror(fail));
437 return b64encode(cp, (int)len);
442 fingerprint(gnutls_x509_crt_t cert, gnutls_digest_algorithm_t algo)
450 if ((ret = gnutls_x509_crt_get_fingerprint(cert, algo, NULL, &siz))
451 != GNUTLS_E_SHORT_MEMORY_BUFFER)
452 return g_err("gf0", __FUNCTION__, ret);
454 cp = store_get(siz*3+1);
455 if ((ret = gnutls_x509_crt_get_fingerprint(cert, algo, cp, &siz)) < 0)
456 return g_err("gf1", __FUNCTION__, ret);
458 for (cp3 = cp2 = cp+siz; cp < cp2; cp++)
459 cp3 += sprintf(CS cp3, "%02X", *cp);
465 tls_cert_fprt_md5(void * cert)
467 return fingerprint((gnutls_x509_crt_t)cert, GNUTLS_DIG_MD5);
471 tls_cert_fprt_sha1(void * cert)
473 return fingerprint((gnutls_x509_crt_t)cert, GNUTLS_DIG_SHA1);
477 tls_cert_fprt_sha256(void * cert)
479 return fingerprint((gnutls_x509_crt_t)cert, GNUTLS_DIG_SHA256);
485 /* End of tlscert-gnu.c */