1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at https://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
24 * Source file for all GnuTLS-specific code for the TLS/SSL layer. No code
25 * but vtls.c should ever call or use these functions.
27 * Note: don't use the GnuTLS' *_t variable type names in this source code,
28 * since they were not present in 1.0.X.
31 #include "curl_setup.h"
35 #include <gnutls/abstract.h>
36 #include <gnutls/gnutls.h>
37 #include <gnutls/x509.h>
39 #ifdef USE_GNUTLS_NETTLE
40 #include <gnutls/crypto.h>
41 #include <nettle/md5.h>
42 #include <nettle/sha2.h>
49 #include "inet_pton.h"
52 #include "parsedate.h"
53 #include "connect.h" /* for the connect timeout */
58 #include "curl_printf.h"
59 #include "curl_memory.h"
60 /* The last #include file should be: */
63 /* Enable GnuTLS debugging by defining GTLSDEBUG */
64 /*#define GTLSDEBUG */
67 static void tls_log_func(int level, const char *str)
69 fprintf(stderr, "|<%d>| %s", level, str);
72 static bool gtls_inited = FALSE;
74 #if defined(GNUTLS_VERSION_NUMBER)
75 # if (GNUTLS_VERSION_NUMBER >= 0x020c00)
76 # undef gnutls_transport_set_lowat
77 # define gnutls_transport_set_lowat(A,B) Curl_nop_stmt
78 # define USE_GNUTLS_PRIORITY_SET_DIRECT 1
80 # if (GNUTLS_VERSION_NUMBER >= 0x020c03)
81 # define GNUTLS_MAPS_WINSOCK_ERRORS 1
84 # if HAVE_GNUTLS_ALPN_SET_PROTOCOLS
88 # if HAVE_GNUTLS_OCSP_REQ_INIT
92 # if (GNUTLS_VERSION_NUMBER >= 0x030306)
98 # include <gnutls/ocsp.h>
101 struct ssl_backend_data {
102 gnutls_session_t session;
103 gnutls_certificate_credentials_t cred;
105 gnutls_srp_client_credentials_t srp_client_cred;
109 #define BACKEND connssl->backend
112 * Custom push and pull callback functions used by GNU TLS to read and write
113 * to the socket. These functions are simple wrappers to send() and recv()
114 * (although here using the sread/swrite macros as defined by
115 * curl_setup_once.h).
116 * We use custom functions rather than the GNU TLS defaults because it allows
117 * us to get specific about the fourth "flags" argument, and to use arbitrary
118 * private data with gnutls_transport_set_ptr if we wish.
120 * When these custom push and pull callbacks fail, GNU TLS checks its own
121 * session-specific error variable, and when not set also its own global
122 * errno variable, in order to take appropriate action. GNU TLS does not
123 * require that the transport is actually a socket. This implies that for
124 * Windows builds these callbacks should ideally set the session-specific
125 * error variable using function gnutls_transport_set_errno or as a last
126 * resort global errno variable using gnutls_transport_set_global_errno,
127 * with a transport agnostic error value. This implies that some winsock
128 * error translation must take place in these callbacks.
130 * Paragraph above applies to GNU TLS versions older than 2.12.3, since
131 * this version GNU TLS does its own internal winsock error translation
132 * using system_errno() function.
135 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
136 # define gtls_EINTR 4
138 # define gtls_EAGAIN 11
139 static int gtls_mapped_sockerrno(void)
153 static ssize_t Curl_gtls_push(void *s, const void *buf, size_t len)
155 ssize_t ret = swrite(CURLX_POINTER_TO_INTEGER_CAST(s), buf, len);
156 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
158 gnutls_transport_set_global_errno(gtls_mapped_sockerrno());
163 static ssize_t Curl_gtls_pull(void *s, void *buf, size_t len)
165 ssize_t ret = sread(CURLX_POINTER_TO_INTEGER_CAST(s), buf, len);
166 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
168 gnutls_transport_set_global_errno(gtls_mapped_sockerrno());
173 static ssize_t Curl_gtls_push_ssl(void *s, const void *buf, size_t len)
175 return gnutls_record_send((gnutls_session_t) s, buf, len);
178 static ssize_t Curl_gtls_pull_ssl(void *s, void *buf, size_t len)
180 return gnutls_record_recv((gnutls_session_t) s, buf, len);
185 * Global GnuTLS init, called from Curl_ssl_init(). This calls functions that
186 * are not thread-safe and thus this function itself is not thread-safe and
187 * must only be called from within curl_global_init() to keep the thread
188 * situation under control!
190 static int Curl_gtls_init(void)
194 ret = gnutls_global_init()?0:1;
196 gnutls_global_set_log_function(tls_log_func);
197 gnutls_global_set_log_level(2);
204 static void Curl_gtls_cleanup(void)
207 gnutls_global_deinit();
212 #ifndef CURL_DISABLE_VERBOSE_STRINGS
213 static void showtime(struct Curl_easy *data,
218 const struct tm *tm = &buffer;
220 CURLcode result = Curl_gmtime(stamp, &buffer);
226 "\t %s: %s, %02d %s %4d %02d:%02d:%02d GMT",
228 Curl_wkday[tm->tm_wday?tm->tm_wday-1:6],
230 Curl_month[tm->tm_mon],
235 infof(data, "%s\n", str);
239 static gnutls_datum_t load_file(const char *file)
242 gnutls_datum_t loaded_file = { NULL, 0 };
246 f = fopen(file, "rb");
249 if(fseek(f, 0, SEEK_END) != 0
250 || (filelen = ftell(f)) < 0
251 || fseek(f, 0, SEEK_SET) != 0
252 || !(ptr = malloc((size_t)filelen)))
254 if(fread(ptr, 1, (size_t)filelen, f) < (size_t)filelen) {
259 loaded_file.data = ptr;
260 loaded_file.size = (unsigned int)filelen;
266 static void unload_file(gnutls_datum_t data)
272 /* this function does a SSL/TLS (re-)handshake */
273 static CURLcode handshake(struct connectdata *conn,
278 struct Curl_easy *data = conn->data;
279 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
280 gnutls_session_t session = BACKEND->session;
281 curl_socket_t sockfd = conn->sock[sockindex];
287 /* check allowed time left */
288 timeout_ms = Curl_timeleft(data, NULL, duringconnect);
291 /* no need to continue if time already is up */
292 failf(data, "SSL connection timeout");
293 return CURLE_OPERATION_TIMEDOUT;
296 /* if ssl is expecting something, check if it's available. */
297 if(connssl->connecting_state == ssl_connect_2_reading
298 || connssl->connecting_state == ssl_connect_2_writing) {
300 curl_socket_t writefd = ssl_connect_2_writing ==
301 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
302 curl_socket_t readfd = ssl_connect_2_reading ==
303 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
305 what = Curl_socket_check(readfd, CURL_SOCKET_BAD, writefd,
307 timeout_ms?timeout_ms:1000);
310 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
311 return CURLE_SSL_CONNECT_ERROR;
316 else if(timeout_ms) {
318 failf(data, "SSL connection timeout at %ld", (long)timeout_ms);
319 return CURLE_OPERATION_TIMEDOUT;
322 /* socket is readable or writable */
325 rc = gnutls_handshake(session);
327 if((rc == GNUTLS_E_AGAIN) || (rc == GNUTLS_E_INTERRUPTED)) {
328 connssl->connecting_state =
329 gnutls_record_get_direction(session)?
330 ssl_connect_2_writing:ssl_connect_2_reading;
333 else if((rc < 0) && !gnutls_error_is_fatal(rc)) {
334 const char *strerr = NULL;
336 if(rc == GNUTLS_E_WARNING_ALERT_RECEIVED) {
337 int alert = gnutls_alert_get(session);
338 strerr = gnutls_alert_get_name(alert);
342 strerr = gnutls_strerror(rc);
344 infof(data, "gnutls_handshake() warning: %s\n", strerr);
348 const char *strerr = NULL;
350 if(rc == GNUTLS_E_FATAL_ALERT_RECEIVED) {
351 int alert = gnutls_alert_get(session);
352 strerr = gnutls_alert_get_name(alert);
356 strerr = gnutls_strerror(rc);
358 failf(data, "gnutls_handshake() failed: %s", strerr);
359 return CURLE_SSL_CONNECT_ERROR;
362 /* Reset our connect state machine */
363 connssl->connecting_state = ssl_connect_1;
368 static gnutls_x509_crt_fmt_t do_file_type(const char *type)
370 if(!type || !type[0])
371 return GNUTLS_X509_FMT_PEM;
372 if(strcasecompare(type, "PEM"))
373 return GNUTLS_X509_FMT_PEM;
374 if(strcasecompare(type, "DER"))
375 return GNUTLS_X509_FMT_DER;
379 #ifndef USE_GNUTLS_PRIORITY_SET_DIRECT
381 set_ssl_version_min_max(int *list, size_t list_size, struct connectdata *conn)
383 struct Curl_easy *data = conn->data;
384 long ssl_version = SSL_CONN_CONFIG(version);
385 long ssl_version_max = SSL_CONN_CONFIG(version_max);
386 long i = ssl_version;
387 long protocol_priority_idx = 0;
389 switch(ssl_version_max) {
390 case CURL_SSLVERSION_MAX_NONE:
391 ssl_version_max = ssl_version << 16;
393 case CURL_SSLVERSION_MAX_DEFAULT:
394 ssl_version_max = CURL_SSLVERSION_MAX_TLSv1_2;
398 for(; i <= (ssl_version_max >> 16) &&
399 protocol_priority_idx < list_size; ++i) {
401 case CURL_SSLVERSION_TLSv1_0:
402 protocol_priority[protocol_priority_idx++] = GNUTLS_TLS1_0;
404 case CURL_SSLVERSION_TLSv1_1:
405 protocol_priority[protocol_priority_idx++] = GNUTLS_TLS1_1;
407 case CURL_SSLVERSION_TLSv1_2:
408 protocol_priority[protocol_priority_idx++] = GNUTLS_TLS1_2;
410 case CURL_SSLVERSION_TLSv1_3:
411 failf(data, "GnuTLS: TLS 1.3 is not yet supported");
412 return CURLE_SSL_CONNECT_ERROR;
418 #define GNUTLS_CIPHERS "NORMAL:-ARCFOUR-128:-CTYPE-ALL:+CTYPE-X509"
419 /* If GnuTLS was compiled without support for SRP it will error out if SRP is
420 requested in the priority string, so treat it specially
422 #define GNUTLS_SRP "+SRP"
425 set_ssl_version_min_max(const char **prioritylist, struct connectdata *conn)
427 struct Curl_easy *data = conn->data;
428 long ssl_version = SSL_CONN_CONFIG(version);
429 long ssl_version_max = SSL_CONN_CONFIG(version_max);
430 if(ssl_version == CURL_SSLVERSION_TLSv1_3 ||
431 ssl_version_max == CURL_SSLVERSION_MAX_TLSv1_3) {
432 failf(data, "GnuTLS: TLS 1.3 is not yet supported");
433 return CURLE_SSL_CONNECT_ERROR;
435 if(ssl_version_max == CURL_SSLVERSION_MAX_NONE) {
436 ssl_version_max = ssl_version << 16;
438 switch(ssl_version | ssl_version_max) {
439 case CURL_SSLVERSION_TLSv1_0 | CURL_SSLVERSION_MAX_TLSv1_0:
440 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
441 "+VERS-TLS1.0:" GNUTLS_SRP;
443 case CURL_SSLVERSION_TLSv1_0 | CURL_SSLVERSION_MAX_TLSv1_1:
444 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
445 "+VERS-TLS1.0:+VERS-TLS1.1:" GNUTLS_SRP;
447 case CURL_SSLVERSION_TLSv1_0 | CURL_SSLVERSION_MAX_TLSv1_2:
448 case CURL_SSLVERSION_TLSv1_0 | CURL_SSLVERSION_MAX_DEFAULT:
449 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
450 "+VERS-TLS1.0:+VERS-TLS1.1:+VERS-TLS1.2:" GNUTLS_SRP;
452 case CURL_SSLVERSION_TLSv1_1 | CURL_SSLVERSION_MAX_TLSv1_1:
453 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
454 "+VERS-TLS1.1:" GNUTLS_SRP;
456 case CURL_SSLVERSION_TLSv1_1 | CURL_SSLVERSION_MAX_TLSv1_2:
457 case CURL_SSLVERSION_TLSv1_1 | CURL_SSLVERSION_MAX_DEFAULT:
458 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
459 "+VERS-TLS1.1:+VERS-TLS1.2:" GNUTLS_SRP;
461 case CURL_SSLVERSION_TLSv1_2 | CURL_SSLVERSION_MAX_TLSv1_2:
462 case CURL_SSLVERSION_TLSv1_2 | CURL_SSLVERSION_MAX_DEFAULT:
463 *prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
464 "+VERS-TLS1.2:" GNUTLS_SRP;
468 failf(data, "GnuTLS: cannot set ssl protocol");
469 return CURLE_SSL_CONNECT_ERROR;
474 gtls_connect_step1(struct connectdata *conn,
477 struct Curl_easy *data = conn->data;
478 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
479 unsigned int init_flags;
480 gnutls_session_t session;
482 bool sni = TRUE; /* default is SNI enabled */
483 void *transport_ptr = NULL;
484 gnutls_push_func gnutls_transport_push = NULL;
485 gnutls_pull_func gnutls_transport_pull = NULL;
487 struct in6_addr addr;
491 #ifndef USE_GNUTLS_PRIORITY_SET_DIRECT
492 static const int cipher_priority[] = {
493 /* These two ciphers were added to GnuTLS as late as ver. 3.0.1,
494 but this code path is only ever used for ver. < 2.12.0.
495 GNUTLS_CIPHER_AES_128_GCM,
496 GNUTLS_CIPHER_AES_256_GCM,
498 GNUTLS_CIPHER_AES_128_CBC,
499 GNUTLS_CIPHER_AES_256_CBC,
500 GNUTLS_CIPHER_CAMELLIA_128_CBC,
501 GNUTLS_CIPHER_CAMELLIA_256_CBC,
502 GNUTLS_CIPHER_3DES_CBC,
504 static const int cert_type_priority[] = { GNUTLS_CRT_X509, 0 };
505 int protocol_priority[] = { 0, 0, 0, 0 };
507 const char *prioritylist;
508 const char *err = NULL;
511 const char * const hostname = SSL_IS_PROXY() ? conn->http_proxy.host.name :
514 if(connssl->state == ssl_connection_complete)
515 /* to make us tolerant against being called more than once for the
522 if(SSL_CONN_CONFIG(version) == CURL_SSLVERSION_SSLv2) {
523 failf(data, "GnuTLS does not support SSLv2");
524 return CURLE_SSL_CONNECT_ERROR;
526 else if(SSL_CONN_CONFIG(version) == CURL_SSLVERSION_SSLv3)
527 sni = FALSE; /* SSLv3 has no SNI */
529 /* allocate a cred struct */
530 rc = gnutls_certificate_allocate_credentials(&BACKEND->cred);
531 if(rc != GNUTLS_E_SUCCESS) {
532 failf(data, "gnutls_cert_all_cred() failed: %s", gnutls_strerror(rc));
533 return CURLE_SSL_CONNECT_ERROR;
537 if(SSL_SET_OPTION(authtype) == CURL_TLSAUTH_SRP) {
538 infof(data, "Using TLS-SRP username: %s\n", SSL_SET_OPTION(username));
540 rc = gnutls_srp_allocate_client_credentials(
541 &BACKEND->srp_client_cred);
542 if(rc != GNUTLS_E_SUCCESS) {
543 failf(data, "gnutls_srp_allocate_client_cred() failed: %s",
544 gnutls_strerror(rc));
545 return CURLE_OUT_OF_MEMORY;
548 rc = gnutls_srp_set_client_credentials(BACKEND->srp_client_cred,
549 SSL_SET_OPTION(username),
550 SSL_SET_OPTION(password));
551 if(rc != GNUTLS_E_SUCCESS) {
552 failf(data, "gnutls_srp_set_client_cred() failed: %s",
553 gnutls_strerror(rc));
554 return CURLE_BAD_FUNCTION_ARGUMENT;
559 if(SSL_CONN_CONFIG(CAfile)) {
560 /* set the trusted CA cert bundle file */
561 gnutls_certificate_set_verify_flags(BACKEND->cred,
562 GNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT);
564 rc = gnutls_certificate_set_x509_trust_file(BACKEND->cred,
565 SSL_CONN_CONFIG(CAfile),
566 GNUTLS_X509_FMT_PEM);
568 infof(data, "error reading ca cert file %s (%s)\n",
569 SSL_CONN_CONFIG(CAfile), gnutls_strerror(rc));
570 if(SSL_CONN_CONFIG(verifypeer))
571 return CURLE_SSL_CACERT_BADFILE;
574 infof(data, "found %d certificates in %s\n", rc,
575 SSL_CONN_CONFIG(CAfile));
579 if(SSL_CONN_CONFIG(CApath)) {
580 /* set the trusted CA cert directory */
581 rc = gnutls_certificate_set_x509_trust_dir(BACKEND->cred,
582 SSL_CONN_CONFIG(CApath),
583 GNUTLS_X509_FMT_PEM);
585 infof(data, "error reading ca cert file %s (%s)\n",
586 SSL_CONN_CONFIG(CApath), gnutls_strerror(rc));
587 if(SSL_CONN_CONFIG(verifypeer))
588 return CURLE_SSL_CACERT_BADFILE;
591 infof(data, "found %d certificates in %s\n",
592 rc, SSL_CONN_CONFIG(CApath));
596 #ifdef CURL_CA_FALLBACK
597 /* use system ca certificate store as fallback */
598 if(SSL_CONN_CONFIG(verifypeer) &&
599 !(SSL_CONN_CONFIG(CAfile) || SSL_CONN_CONFIG(CApath))) {
600 gnutls_certificate_set_x509_system_trust(BACKEND->cred);
604 if(SSL_SET_OPTION(CRLfile)) {
605 /* set the CRL list file */
606 rc = gnutls_certificate_set_x509_crl_file(BACKEND->cred,
607 SSL_SET_OPTION(CRLfile),
608 GNUTLS_X509_FMT_PEM);
610 failf(data, "error reading crl file %s (%s)",
611 SSL_SET_OPTION(CRLfile), gnutls_strerror(rc));
612 return CURLE_SSL_CRL_BADFILE;
615 infof(data, "found %d CRL in %s\n",
616 rc, SSL_SET_OPTION(CRLfile));
619 /* Initialize TLS session as a client */
620 init_flags = GNUTLS_CLIENT;
622 #if defined(GNUTLS_NO_TICKETS)
623 /* Disable TLS session tickets */
624 init_flags |= GNUTLS_NO_TICKETS;
627 rc = gnutls_init(&BACKEND->session, init_flags);
628 if(rc != GNUTLS_E_SUCCESS) {
629 failf(data, "gnutls_init() failed: %d", rc);
630 return CURLE_SSL_CONNECT_ERROR;
633 /* convenient assign */
634 session = BACKEND->session;
636 if((0 == Curl_inet_pton(AF_INET, hostname, &addr)) &&
638 (0 == Curl_inet_pton(AF_INET6, hostname, &addr)) &&
641 (gnutls_server_name_set(session, GNUTLS_NAME_DNS, hostname,
642 strlen(hostname)) < 0))
643 infof(data, "WARNING: failed to configure server name indication (SNI) "
646 /* Use default priorities */
647 rc = gnutls_set_default_priority(session);
648 if(rc != GNUTLS_E_SUCCESS)
649 return CURLE_SSL_CONNECT_ERROR;
651 #ifndef USE_GNUTLS_PRIORITY_SET_DIRECT
652 rc = gnutls_cipher_set_priority(session, cipher_priority);
653 if(rc != GNUTLS_E_SUCCESS)
654 return CURLE_SSL_CONNECT_ERROR;
656 /* Sets the priority on the certificate types supported by gnutls. Priority
657 is higher for types specified before others. After specifying the types
658 you want, you must append a 0. */
659 rc = gnutls_certificate_type_set_priority(session, cert_type_priority);
660 if(rc != GNUTLS_E_SUCCESS)
661 return CURLE_SSL_CONNECT_ERROR;
663 if(SSL_CONN_CONFIG(cipher_list) != NULL) {
664 failf(data, "can't pass a custom cipher list to older GnuTLS"
666 return CURLE_SSL_CONNECT_ERROR;
669 switch(SSL_CONN_CONFIG(version)) {
670 case CURL_SSLVERSION_SSLv3:
671 protocol_priority[0] = GNUTLS_SSL3;
673 case CURL_SSLVERSION_DEFAULT:
674 case CURL_SSLVERSION_TLSv1:
675 protocol_priority[0] = GNUTLS_TLS1_0;
676 protocol_priority[1] = GNUTLS_TLS1_1;
677 protocol_priority[2] = GNUTLS_TLS1_2;
679 case CURL_SSLVERSION_TLSv1_0:
680 case CURL_SSLVERSION_TLSv1_1:
681 case CURL_SSLVERSION_TLSv1_2:
682 case CURL_SSLVERSION_TLSv1_3:
684 CURLcode result = set_ssl_version_min_max(protocol_priority,
685 sizeof(protocol_priority)/sizeof(protocol_priority[0]), conn);
686 if(result != CURLE_OK)
690 case CURL_SSLVERSION_SSLv2:
691 failf(data, "GnuTLS does not support SSLv2");
692 return CURLE_SSL_CONNECT_ERROR;
694 failf(data, "Unrecognized parameter passed via CURLOPT_SSLVERSION");
695 return CURLE_SSL_CONNECT_ERROR;
697 rc = gnutls_protocol_set_priority(session, protocol_priority);
698 if(rc != GNUTLS_E_SUCCESS) {
699 failf(data, "Did you pass a valid GnuTLS cipher list?");
700 return CURLE_SSL_CONNECT_ERROR;
704 /* Ensure +SRP comes at the *end* of all relevant strings so that it can be
705 * removed if a run-time error indicates that SRP is not supported by this
707 switch(SSL_CONN_CONFIG(version)) {
708 case CURL_SSLVERSION_SSLv3:
709 prioritylist = GNUTLS_CIPHERS ":-VERS-TLS-ALL:+VERS-SSL3.0";
712 case CURL_SSLVERSION_DEFAULT:
713 case CURL_SSLVERSION_TLSv1:
714 prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:" GNUTLS_SRP;
716 case CURL_SSLVERSION_TLSv1_0:
717 case CURL_SSLVERSION_TLSv1_1:
718 case CURL_SSLVERSION_TLSv1_2:
719 case CURL_SSLVERSION_TLSv1_3:
721 CURLcode result = set_ssl_version_min_max(&prioritylist, conn);
722 if(result != CURLE_OK)
726 case CURL_SSLVERSION_SSLv2:
727 failf(data, "GnuTLS does not support SSLv2");
728 return CURLE_SSL_CONNECT_ERROR;
730 failf(data, "Unrecognized parameter passed via CURLOPT_SSLVERSION");
731 return CURLE_SSL_CONNECT_ERROR;
733 rc = gnutls_priority_set_direct(session, prioritylist, &err);
734 if((rc == GNUTLS_E_INVALID_REQUEST) && err) {
735 if(!strcmp(err, GNUTLS_SRP)) {
736 /* This GnuTLS was probably compiled without support for SRP.
737 * Note that fact and try again without it. */
738 int validprioritylen = curlx_uztosi(err - prioritylist);
739 char *prioritycopy = strdup(prioritylist);
741 return CURLE_OUT_OF_MEMORY;
743 infof(data, "This GnuTLS does not support SRP\n");
745 /* Remove the :+SRP */
746 prioritycopy[validprioritylen - 1] = 0;
747 rc = gnutls_priority_set_direct(session, prioritycopy, &err);
751 if(rc != GNUTLS_E_SUCCESS) {
752 failf(data, "Error %d setting GnuTLS cipher list starting with %s",
754 return CURLE_SSL_CONNECT_ERROR;
759 if(conn->bits.tls_enable_alpn) {
761 gnutls_datum_t protocols[2];
764 if(data->set.httpversion >= CURL_HTTP_VERSION_2 &&
765 (!SSL_IS_PROXY() || !conn->bits.tunnel_proxy)) {
766 protocols[cur].data = (unsigned char *)NGHTTP2_PROTO_VERSION_ID;
767 protocols[cur].size = NGHTTP2_PROTO_VERSION_ID_LEN;
769 infof(data, "ALPN, offering %s\n", NGHTTP2_PROTO_VERSION_ID);
773 protocols[cur].data = (unsigned char *)ALPN_HTTP_1_1;
774 protocols[cur].size = ALPN_HTTP_1_1_LENGTH;
776 infof(data, "ALPN, offering %s\n", ALPN_HTTP_1_1);
778 gnutls_alpn_set_protocols(session, protocols, cur, 0);
782 if(SSL_SET_OPTION(cert)) {
783 if(SSL_SET_OPTION(key_passwd)) {
784 #if HAVE_GNUTLS_CERTIFICATE_SET_X509_KEY_FILE2
785 const unsigned int supported_key_encryption_algorithms =
786 GNUTLS_PKCS_USE_PKCS12_3DES | GNUTLS_PKCS_USE_PKCS12_ARCFOUR |
787 GNUTLS_PKCS_USE_PKCS12_RC2_40 | GNUTLS_PKCS_USE_PBES2_3DES |
788 GNUTLS_PKCS_USE_PBES2_AES_128 | GNUTLS_PKCS_USE_PBES2_AES_192 |
789 GNUTLS_PKCS_USE_PBES2_AES_256;
790 rc = gnutls_certificate_set_x509_key_file2(
792 SSL_SET_OPTION(cert),
793 SSL_SET_OPTION(key) ?
794 SSL_SET_OPTION(key) : SSL_SET_OPTION(cert),
795 do_file_type(SSL_SET_OPTION(cert_type)),
796 SSL_SET_OPTION(key_passwd),
797 supported_key_encryption_algorithms);
798 if(rc != GNUTLS_E_SUCCESS) {
800 "error reading X.509 potentially-encrypted key file: %s",
801 gnutls_strerror(rc));
802 return CURLE_SSL_CONNECT_ERROR;
805 failf(data, "gnutls lacks support for encrypted key files");
806 return CURLE_SSL_CONNECT_ERROR;
810 if(gnutls_certificate_set_x509_key_file(
812 SSL_SET_OPTION(cert),
813 SSL_SET_OPTION(key) ?
814 SSL_SET_OPTION(key) : SSL_SET_OPTION(cert),
815 do_file_type(SSL_SET_OPTION(cert_type)) ) !=
817 failf(data, "error reading X.509 key or certificate file");
818 return CURLE_SSL_CONNECT_ERROR;
824 /* put the credentials to the current session */
825 if(SSL_SET_OPTION(authtype) == CURL_TLSAUTH_SRP) {
826 rc = gnutls_credentials_set(session, GNUTLS_CRD_SRP,
827 BACKEND->srp_client_cred);
828 if(rc != GNUTLS_E_SUCCESS) {
829 failf(data, "gnutls_credentials_set() failed: %s", gnutls_strerror(rc));
830 return CURLE_SSL_CONNECT_ERROR;
836 rc = gnutls_credentials_set(session, GNUTLS_CRD_CERTIFICATE,
838 if(rc != GNUTLS_E_SUCCESS) {
839 failf(data, "gnutls_credentials_set() failed: %s", gnutls_strerror(rc));
840 return CURLE_SSL_CONNECT_ERROR;
844 if(conn->proxy_ssl[sockindex].use) {
845 transport_ptr = conn->proxy_ssl[sockindex].backend->session;
846 gnutls_transport_push = Curl_gtls_push_ssl;
847 gnutls_transport_pull = Curl_gtls_pull_ssl;
850 /* file descriptor for the socket */
851 transport_ptr = CURLX_INTEGER_TO_POINTER_CAST(conn->sock[sockindex]);
852 gnutls_transport_push = Curl_gtls_push;
853 gnutls_transport_pull = Curl_gtls_pull;
856 /* set the connection handle */
857 gnutls_transport_set_ptr(session, transport_ptr);
859 /* register callback functions to send and receive data. */
860 gnutls_transport_set_push_function(session, gnutls_transport_push);
861 gnutls_transport_set_pull_function(session, gnutls_transport_pull);
863 /* lowat must be set to zero when using custom push and pull functions. */
864 gnutls_transport_set_lowat(session, 0);
867 if(SSL_CONN_CONFIG(verifystatus)) {
868 rc = gnutls_ocsp_status_request_enable_client(session, NULL, 0, NULL);
869 if(rc != GNUTLS_E_SUCCESS) {
870 failf(data, "gnutls_ocsp_status_request_enable_client() failed: %d", rc);
871 return CURLE_SSL_CONNECT_ERROR;
876 /* This might be a reconnect, so we check for a session ID in the cache
877 to speed up things */
878 if(SSL_SET_OPTION(primary.sessionid)) {
882 Curl_ssl_sessionid_lock(conn);
883 if(!Curl_ssl_getsessionid(conn, &ssl_sessionid, &ssl_idsize, sockindex)) {
884 /* we got a session id, use it! */
885 gnutls_session_set_data(session, ssl_sessionid, ssl_idsize);
887 /* Informational message */
888 infof(data, "SSL re-using session ID\n");
890 Curl_ssl_sessionid_unlock(conn);
896 static CURLcode pkp_pin_peer_pubkey(struct Curl_easy *data,
897 gnutls_x509_crt_t cert,
898 const char *pinnedpubkey)
901 size_t len1 = 0, len2 = 0;
902 unsigned char *buff1 = NULL;
904 gnutls_pubkey_t key = NULL;
906 /* Result is returned to caller */
908 CURLcode result = CURLE_SSL_PINNEDPUBKEYNOTMATCH;
910 /* if a path wasn't specified, don't pin */
911 if(NULL == pinnedpubkey)
918 /* Begin Gyrations to get the public key */
919 gnutls_pubkey_init(&key);
921 ret = gnutls_pubkey_import_x509(key, cert, 0);
925 ret = gnutls_pubkey_export(key, GNUTLS_X509_FMT_DER, NULL, &len1);
926 if(ret != GNUTLS_E_SHORT_MEMORY_BUFFER || len1 == 0)
929 buff1 = malloc(len1);
935 ret = gnutls_pubkey_export(key, GNUTLS_X509_FMT_DER, buff1, &len2);
936 if(ret < 0 || len1 != len2)
941 /* The one good exit point */
942 result = Curl_pin_peer_pubkey(data, pinnedpubkey, buff1, len1);
946 gnutls_pubkey_deinit(key);
948 Curl_safefree(buff1);
953 static Curl_recv gtls_recv;
954 static Curl_send gtls_send;
957 gtls_connect_step3(struct connectdata *conn,
960 unsigned int cert_list_size;
961 const gnutls_datum_t *chainp;
962 unsigned int verify_status = 0;
963 gnutls_x509_crt_t x509_cert, x509_issuer;
964 gnutls_datum_t issuerp;
965 char certbuf[256] = ""; /* big enough? */
969 struct Curl_easy *data = conn->data;
970 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
971 gnutls_session_t session = BACKEND->session;
974 gnutls_datum_t proto;
976 CURLcode result = CURLE_OK;
977 #ifndef CURL_DISABLE_VERBOSE_STRINGS
980 gnutls_protocol_t version = gnutls_protocol_get_version(session);
982 const char * const hostname = SSL_IS_PROXY() ? conn->http_proxy.host.name :
985 /* the name of the cipher suite used, e.g. ECDHE_RSA_AES_256_GCM_SHA384. */
986 ptr = gnutls_cipher_suite_get_name(gnutls_kx_get(session),
987 gnutls_cipher_get(session),
988 gnutls_mac_get(session));
990 infof(data, "SSL connection using %s / %s\n",
991 gnutls_protocol_get_name(version), ptr);
993 /* This function will return the peer's raw certificate (chain) as sent by
994 the peer. These certificates are in raw format (DER encoded for
995 X.509). In case of a X.509 then a certificate list may be present. The
996 first certificate in the list is the peer's certificate, following the
997 issuer's certificate, then the issuer's issuer etc. */
999 chainp = gnutls_certificate_get_peers(session, &cert_list_size);
1001 if(SSL_CONN_CONFIG(verifypeer) ||
1002 SSL_CONN_CONFIG(verifyhost) ||
1003 SSL_SET_OPTION(issuercert)) {
1005 if(SSL_SET_OPTION(authtype) == CURL_TLSAUTH_SRP
1006 && SSL_SET_OPTION(username) != NULL
1007 && !SSL_CONN_CONFIG(verifypeer)
1008 && gnutls_cipher_get(session)) {
1009 /* no peer cert, but auth is ok if we have SRP user and cipher and no
1014 failf(data, "failed to get server cert");
1015 return CURLE_PEER_FAILED_VERIFICATION;
1020 infof(data, "\t common name: WARNING couldn't obtain\n");
1023 if(data->set.ssl.certinfo && chainp) {
1026 result = Curl_ssl_init_certinfo(data, cert_list_size);
1030 for(i = 0; i < cert_list_size; i++) {
1031 const char *beg = (const char *) chainp[i].data;
1032 const char *end = beg + chainp[i].size;
1034 result = Curl_extract_certinfo(conn, i, beg, end);
1040 if(SSL_CONN_CONFIG(verifypeer)) {
1041 /* This function will try to verify the peer's certificate and return its
1042 status (trusted, invalid etc.). The value of status should be one or
1043 more of the gnutls_certificate_status_t enumerated elements bitwise
1044 or'd. To avoid denial of service attacks some default upper limits
1045 regarding the certificate key size and chain size are set. To override
1046 them use gnutls_certificate_set_verify_limits(). */
1048 rc = gnutls_certificate_verify_peers2(session, &verify_status);
1050 failf(data, "server cert verify failed: %d", rc);
1051 return CURLE_SSL_CONNECT_ERROR;
1054 /* verify_status is a bitmask of gnutls_certificate_status bits */
1055 if(verify_status & GNUTLS_CERT_INVALID) {
1056 if(SSL_CONN_CONFIG(verifypeer)) {
1057 failf(data, "server certificate verification failed. CAfile: %s "
1058 "CRLfile: %s", SSL_CONN_CONFIG(CAfile) ? SSL_CONN_CONFIG(CAfile):
1060 SSL_SET_OPTION(CRLfile)?SSL_SET_OPTION(CRLfile):"none");
1061 return CURLE_SSL_CACERT;
1064 infof(data, "\t server certificate verification FAILED\n");
1067 infof(data, "\t server certificate verification OK\n");
1070 infof(data, "\t server certificate verification SKIPPED\n");
1073 if(SSL_CONN_CONFIG(verifystatus)) {
1074 if(gnutls_ocsp_status_request_is_checked(session, 0) == 0) {
1075 gnutls_datum_t status_request;
1076 gnutls_ocsp_resp_t ocsp_resp;
1078 gnutls_ocsp_cert_status_t status;
1079 gnutls_x509_crl_reason_t reason;
1081 rc = gnutls_ocsp_status_request_get(session, &status_request);
1083 infof(data, "\t server certificate status verification FAILED\n");
1085 if(rc == GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE) {
1086 failf(data, "No OCSP response received");
1087 return CURLE_SSL_INVALIDCERTSTATUS;
1091 failf(data, "Invalid OCSP response received");
1092 return CURLE_SSL_INVALIDCERTSTATUS;
1095 gnutls_ocsp_resp_init(&ocsp_resp);
1097 rc = gnutls_ocsp_resp_import(ocsp_resp, &status_request);
1099 failf(data, "Invalid OCSP response received");
1100 return CURLE_SSL_INVALIDCERTSTATUS;
1103 rc = gnutls_ocsp_resp_get_single(ocsp_resp, 0, NULL, NULL, NULL, NULL,
1104 &status, NULL, NULL, NULL, &reason);
1107 case GNUTLS_OCSP_CERT_GOOD:
1110 case GNUTLS_OCSP_CERT_REVOKED: {
1111 const char *crl_reason;
1115 case GNUTLS_X509_CRLREASON_UNSPECIFIED:
1116 crl_reason = "unspecified reason";
1119 case GNUTLS_X509_CRLREASON_KEYCOMPROMISE:
1120 crl_reason = "private key compromised";
1123 case GNUTLS_X509_CRLREASON_CACOMPROMISE:
1124 crl_reason = "CA compromised";
1127 case GNUTLS_X509_CRLREASON_AFFILIATIONCHANGED:
1128 crl_reason = "affiliation has changed";
1131 case GNUTLS_X509_CRLREASON_SUPERSEDED:
1132 crl_reason = "certificate superseded";
1135 case GNUTLS_X509_CRLREASON_CESSATIONOFOPERATION:
1136 crl_reason = "operation has ceased";
1139 case GNUTLS_X509_CRLREASON_CERTIFICATEHOLD:
1140 crl_reason = "certificate is on hold";
1143 case GNUTLS_X509_CRLREASON_REMOVEFROMCRL:
1144 crl_reason = "will be removed from delta CRL";
1147 case GNUTLS_X509_CRLREASON_PRIVILEGEWITHDRAWN:
1148 crl_reason = "privilege withdrawn";
1151 case GNUTLS_X509_CRLREASON_AACOMPROMISE:
1152 crl_reason = "AA compromised";
1156 failf(data, "Server certificate was revoked: %s", crl_reason);
1161 case GNUTLS_OCSP_CERT_UNKNOWN:
1162 failf(data, "Server certificate status is unknown");
1166 gnutls_ocsp_resp_deinit(ocsp_resp);
1168 return CURLE_SSL_INVALIDCERTSTATUS;
1171 infof(data, "\t server certificate status verification OK\n");
1174 infof(data, "\t server certificate status verification SKIPPED\n");
1177 /* initialize an X.509 certificate structure. */
1178 gnutls_x509_crt_init(&x509_cert);
1181 /* convert the given DER or PEM encoded Certificate to the native
1182 gnutls_x509_crt_t format */
1183 gnutls_x509_crt_import(x509_cert, chainp, GNUTLS_X509_FMT_DER);
1185 if(SSL_SET_OPTION(issuercert)) {
1186 gnutls_x509_crt_init(&x509_issuer);
1187 issuerp = load_file(SSL_SET_OPTION(issuercert));
1188 gnutls_x509_crt_import(x509_issuer, &issuerp, GNUTLS_X509_FMT_PEM);
1189 rc = gnutls_x509_crt_check_issuer(x509_cert, x509_issuer);
1190 gnutls_x509_crt_deinit(x509_issuer);
1191 unload_file(issuerp);
1193 failf(data, "server certificate issuer check failed (IssuerCert: %s)",
1194 SSL_SET_OPTION(issuercert)?SSL_SET_OPTION(issuercert):"none");
1195 gnutls_x509_crt_deinit(x509_cert);
1196 return CURLE_SSL_ISSUER_ERROR;
1198 infof(data, "\t server certificate issuer check OK (Issuer Cert: %s)\n",
1199 SSL_SET_OPTION(issuercert)?SSL_SET_OPTION(issuercert):"none");
1202 size = sizeof(certbuf);
1203 rc = gnutls_x509_crt_get_dn_by_oid(x509_cert, GNUTLS_OID_X520_COMMON_NAME,
1204 0, /* the first and only one */
1209 infof(data, "error fetching CN from cert:%s\n",
1210 gnutls_strerror(rc));
1213 /* This function will check if the given certificate's subject matches the
1214 given hostname. This is a basic implementation of the matching described
1215 in RFC2818 (HTTPS), which takes into account wildcards, and the subject
1216 alternative name PKIX extension. Returns non zero on success, and zero on
1218 rc = gnutls_x509_crt_check_hostname(x509_cert, hostname);
1219 #if GNUTLS_VERSION_NUMBER < 0x030306
1220 /* Before 3.3.6, gnutls_x509_crt_check_hostname() didn't check IP
1224 #define use_addr in6_addr
1226 #define use_addr in_addr
1228 unsigned char addrbuf[sizeof(struct use_addr)];
1229 unsigned char certaddr[sizeof(struct use_addr)];
1230 size_t addrlen = 0, certaddrlen;
1234 if(Curl_inet_pton(AF_INET, hostname, addrbuf) > 0)
1237 else if(Curl_inet_pton(AF_INET6, hostname, addrbuf) > 0)
1243 certaddrlen = sizeof(certaddr);
1244 ret = gnutls_x509_crt_get_subject_alt_name(x509_cert, i, certaddr,
1245 &certaddrlen, NULL);
1246 /* If this happens, it wasn't an IP address. */
1247 if(ret == GNUTLS_E_SHORT_MEMORY_BUFFER)
1251 if(ret != GNUTLS_SAN_IPADDRESS)
1253 if(certaddrlen == addrlen && !memcmp(addrbuf, certaddr, addrlen)) {
1262 const char * const dispname = SSL_IS_PROXY() ?
1263 conn->http_proxy.host.dispname : conn->host.dispname;
1265 if(SSL_CONN_CONFIG(verifyhost)) {
1266 failf(data, "SSL: certificate subject name (%s) does not match "
1267 "target host name '%s'", certbuf, dispname);
1268 gnutls_x509_crt_deinit(x509_cert);
1269 return CURLE_PEER_FAILED_VERIFICATION;
1272 infof(data, "\t common name: %s (does not match '%s')\n",
1276 infof(data, "\t common name: %s (matched)\n", certbuf);
1278 /* Check for time-based validity */
1279 certclock = gnutls_x509_crt_get_expiration_time(x509_cert);
1281 if(certclock == (time_t)-1) {
1282 if(SSL_CONN_CONFIG(verifypeer)) {
1283 failf(data, "server cert expiration date verify failed");
1284 gnutls_x509_crt_deinit(x509_cert);
1285 return CURLE_SSL_CONNECT_ERROR;
1288 infof(data, "\t server certificate expiration date verify FAILED\n");
1291 if(certclock < time(NULL)) {
1292 if(SSL_CONN_CONFIG(verifypeer)) {
1293 failf(data, "server certificate expiration date has passed.");
1294 gnutls_x509_crt_deinit(x509_cert);
1295 return CURLE_PEER_FAILED_VERIFICATION;
1298 infof(data, "\t server certificate expiration date FAILED\n");
1301 infof(data, "\t server certificate expiration date OK\n");
1304 certclock = gnutls_x509_crt_get_activation_time(x509_cert);
1306 if(certclock == (time_t)-1) {
1307 if(SSL_CONN_CONFIG(verifypeer)) {
1308 failf(data, "server cert activation date verify failed");
1309 gnutls_x509_crt_deinit(x509_cert);
1310 return CURLE_SSL_CONNECT_ERROR;
1313 infof(data, "\t server certificate activation date verify FAILED\n");
1316 if(certclock > time(NULL)) {
1317 if(SSL_CONN_CONFIG(verifypeer)) {
1318 failf(data, "server certificate not activated yet.");
1319 gnutls_x509_crt_deinit(x509_cert);
1320 return CURLE_PEER_FAILED_VERIFICATION;
1323 infof(data, "\t server certificate activation date FAILED\n");
1326 infof(data, "\t server certificate activation date OK\n");
1329 ptr = SSL_IS_PROXY() ? data->set.str[STRING_SSL_PINNEDPUBLICKEY_PROXY] :
1330 data->set.str[STRING_SSL_PINNEDPUBLICKEY_ORIG];
1332 result = pkp_pin_peer_pubkey(data, x509_cert, ptr);
1333 if(result != CURLE_OK) {
1334 failf(data, "SSL: public key does not match pinned public key!");
1335 gnutls_x509_crt_deinit(x509_cert);
1350 #ifndef CURL_DISABLE_VERBOSE_STRINGS
1351 /* public key algorithm's parameters */
1352 algo = gnutls_x509_crt_get_pk_algorithm(x509_cert, &bits);
1353 infof(data, "\t certificate public key: %s\n",
1354 gnutls_pk_algorithm_get_name(algo));
1356 /* version of the X.509 certificate. */
1357 infof(data, "\t certificate version: #%d\n",
1358 gnutls_x509_crt_get_version(x509_cert));
1361 size = sizeof(certbuf);
1362 gnutls_x509_crt_get_dn(x509_cert, certbuf, &size);
1363 infof(data, "\t subject: %s\n", certbuf);
1365 certclock = gnutls_x509_crt_get_activation_time(x509_cert);
1366 showtime(data, "start date", certclock);
1368 certclock = gnutls_x509_crt_get_expiration_time(x509_cert);
1369 showtime(data, "expire date", certclock);
1371 size = sizeof(certbuf);
1372 gnutls_x509_crt_get_issuer_dn(x509_cert, certbuf, &size);
1373 infof(data, "\t issuer: %s\n", certbuf);
1375 /* compression algorithm (if any) */
1376 ptr = gnutls_compression_get_name(gnutls_compression_get(session));
1377 /* the *_get_name() says "NULL" if GNUTLS_COMP_NULL is returned */
1378 infof(data, "\t compression: %s\n", ptr);
1381 gnutls_x509_crt_deinit(x509_cert);
1384 if(conn->bits.tls_enable_alpn) {
1385 rc = gnutls_alpn_get_selected_protocol(session, &proto);
1387 infof(data, "ALPN, server accepted to use %.*s\n", proto.size,
1391 if(proto.size == NGHTTP2_PROTO_VERSION_ID_LEN &&
1392 !memcmp(NGHTTP2_PROTO_VERSION_ID, proto.data,
1393 NGHTTP2_PROTO_VERSION_ID_LEN)) {
1394 conn->negnpn = CURL_HTTP_VERSION_2;
1398 if(proto.size == ALPN_HTTP_1_1_LENGTH &&
1399 !memcmp(ALPN_HTTP_1_1, proto.data, ALPN_HTTP_1_1_LENGTH)) {
1400 conn->negnpn = CURL_HTTP_VERSION_1_1;
1404 infof(data, "ALPN, server did not agree to a protocol\n");
1408 conn->ssl[sockindex].state = ssl_connection_complete;
1409 conn->recv[sockindex] = gtls_recv;
1410 conn->send[sockindex] = gtls_send;
1412 if(SSL_SET_OPTION(primary.sessionid)) {
1413 /* we always unconditionally get the session id here, as even if we
1414 already got it from the cache and asked to use it in the connection, it
1415 might've been rejected and then a new one is in use now and we need to
1418 void *ssl_sessionid;
1419 void *connect_sessionid;
1420 size_t connect_idsize = 0;
1422 /* get the session ID data size */
1423 gnutls_session_get_data(session, NULL, &connect_idsize);
1424 connect_sessionid = malloc(connect_idsize); /* get a buffer for it */
1426 if(connect_sessionid) {
1427 /* extract session ID to the allocated buffer */
1428 gnutls_session_get_data(session, connect_sessionid, &connect_idsize);
1430 Curl_ssl_sessionid_lock(conn);
1431 incache = !(Curl_ssl_getsessionid(conn, &ssl_sessionid, NULL,
1434 /* there was one before in the cache, so instead of risking that the
1435 previous one was rejected, we just kill that and store the new */
1436 Curl_ssl_delsessionid(conn, ssl_sessionid);
1439 /* store this session id */
1440 result = Curl_ssl_addsessionid(conn, connect_sessionid, connect_idsize,
1442 Curl_ssl_sessionid_unlock(conn);
1444 free(connect_sessionid);
1445 result = CURLE_OUT_OF_MEMORY;
1449 result = CURLE_OUT_OF_MEMORY;
1457 * This function is called after the TCP connect has completed. Setup the TLS
1458 * layer and do all necessary magic.
1460 /* We use connssl->connecting_state to keep track of the connection status;
1461 there are three states: 'ssl_connect_1' (not started yet or complete),
1462 'ssl_connect_2_reading' (waiting for data from server), and
1463 'ssl_connect_2_writing' (waiting to be able to write).
1466 gtls_connect_common(struct connectdata *conn,
1472 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1474 /* Initiate the connection, if not already done */
1475 if(ssl_connect_1 == connssl->connecting_state) {
1476 rc = gtls_connect_step1(conn, sockindex);
1481 rc = handshake(conn, sockindex, TRUE, nonblocking);
1483 /* handshake() sets its own error message with failf() */
1486 /* Finish connecting once the handshake is done */
1487 if(ssl_connect_1 == connssl->connecting_state) {
1488 rc = gtls_connect_step3(conn, sockindex);
1493 *done = ssl_connect_1 == connssl->connecting_state;
1498 static CURLcode Curl_gtls_connect_nonblocking(struct connectdata *conn,
1499 int sockindex, bool *done)
1501 return gtls_connect_common(conn, sockindex, TRUE, done);
1504 static CURLcode Curl_gtls_connect(struct connectdata *conn, int sockindex)
1509 result = gtls_connect_common(conn, sockindex, FALSE, &done);
1518 static bool Curl_gtls_data_pending(const struct connectdata *conn,
1521 const struct ssl_connect_data *connssl = &conn->ssl[connindex];
1523 if(BACKEND->session &&
1524 0 != gnutls_record_check_pending(BACKEND->session))
1527 connssl = &conn->proxy_ssl[connindex];
1528 if(BACKEND->session &&
1529 0 != gnutls_record_check_pending(BACKEND->session))
1535 static ssize_t gtls_send(struct connectdata *conn,
1541 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1542 ssize_t rc = gnutls_record_send(BACKEND->session, mem, len);
1545 *curlcode = (rc == GNUTLS_E_AGAIN)
1555 static void close_one(struct ssl_connect_data *connssl)
1557 if(BACKEND->session) {
1558 gnutls_bye(BACKEND->session, GNUTLS_SHUT_RDWR);
1559 gnutls_deinit(BACKEND->session);
1560 BACKEND->session = NULL;
1563 gnutls_certificate_free_credentials(BACKEND->cred);
1564 BACKEND->cred = NULL;
1567 if(BACKEND->srp_client_cred) {
1568 gnutls_srp_free_client_credentials(BACKEND->srp_client_cred);
1569 BACKEND->srp_client_cred = NULL;
1574 static void Curl_gtls_close(struct connectdata *conn, int sockindex)
1576 close_one(&conn->ssl[sockindex]);
1577 close_one(&conn->proxy_ssl[sockindex]);
1581 * This function is called to shut down the SSL layer but keep the
1582 * socket open (CCC - Clear Command Channel)
1584 static int Curl_gtls_shutdown(struct connectdata *conn, int sockindex)
1586 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1589 struct Curl_easy *data = conn->data;
1593 /* This has only been tested on the proftpd server, and the mod_tls code
1594 sends a close notify alert without waiting for a close notify alert in
1595 response. Thus we wait for a close notify alert from the server, but
1596 we do not send one. Let's hope other servers do the same... */
1598 if(data->set.ftp_ccc == CURLFTPSSL_CCC_ACTIVE)
1599 gnutls_bye(BACKEND->session, GNUTLS_SHUT_WR);
1601 if(BACKEND->session) {
1603 int what = SOCKET_READABLE(conn->sock[sockindex],
1604 SSL_SHUTDOWN_TIMEOUT);
1606 /* Something to read, let's do it and hope that it is the close
1607 notify alert from the server */
1608 result = gnutls_record_recv(BACKEND->session,
1612 /* This is the expected response. There was no data but only
1613 the close notify alert */
1616 case GNUTLS_E_AGAIN:
1617 case GNUTLS_E_INTERRUPTED:
1618 infof(data, "GNUTLS_E_AGAIN || GNUTLS_E_INTERRUPTED\n");
1626 else if(0 == what) {
1628 failf(data, "SSL shutdown timeout");
1633 /* anything that gets here is fatally bad */
1634 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
1639 gnutls_deinit(BACKEND->session);
1641 gnutls_certificate_free_credentials(BACKEND->cred);
1644 if(SSL_SET_OPTION(authtype) == CURL_TLSAUTH_SRP
1645 && SSL_SET_OPTION(username) != NULL)
1646 gnutls_srp_free_client_credentials(BACKEND->srp_client_cred);
1649 BACKEND->cred = NULL;
1650 BACKEND->session = NULL;
1655 static ssize_t gtls_recv(struct connectdata *conn, /* connection data */
1656 int num, /* socketindex */
1657 char *buf, /* store read data here */
1658 size_t buffersize, /* max amount to read */
1661 struct ssl_connect_data *connssl = &conn->ssl[num];
1664 ret = gnutls_record_recv(BACKEND->session, buf, buffersize);
1665 if((ret == GNUTLS_E_AGAIN) || (ret == GNUTLS_E_INTERRUPTED)) {
1666 *curlcode = CURLE_AGAIN;
1670 if(ret == GNUTLS_E_REHANDSHAKE) {
1671 /* BLOCKING call, this is bad but a work-around for now. Fixing this "the
1672 proper way" takes a whole lot of work. */
1673 CURLcode result = handshake(conn, num, FALSE, FALSE);
1675 /* handshake() writes error message on its own */
1678 *curlcode = CURLE_AGAIN; /* then return as if this was a wouldblock */
1683 failf(conn->data, "GnuTLS recv error (%d): %s",
1685 (int)ret, gnutls_strerror((int)ret));
1686 *curlcode = CURLE_RECV_ERROR;
1693 static void Curl_gtls_session_free(void *ptr)
1698 static size_t Curl_gtls_version(char *buffer, size_t size)
1700 return snprintf(buffer, size, "GnuTLS/%s", gnutls_check_version(NULL));
1703 #ifndef USE_GNUTLS_NETTLE
1704 static int Curl_gtls_seed(struct Curl_easy *data)
1706 /* we have the "SSL is seeded" boolean static to prevent multiple
1707 time-consuming seedings in vain */
1708 static bool ssl_seeded = FALSE;
1710 /* Quickly add a bit of entropy */
1711 gcry_fast_random_poll();
1713 if(!ssl_seeded || data->set.str[STRING_SSL_RANDOM_FILE] ||
1714 data->set.str[STRING_SSL_EGDSOCKET]) {
1716 /* TODO: to a good job seeding the RNG
1717 This may involve the gcry_control function and these options:
1718 GCRYCTL_SET_RANDOM_SEED_FILE
1719 GCRYCTL_SET_RNDEGD_SOCKET
1727 /* data might be NULL! */
1728 static CURLcode Curl_gtls_random(struct Curl_easy *data,
1729 unsigned char *entropy, size_t length)
1731 #if defined(USE_GNUTLS_NETTLE)
1734 rc = gnutls_rnd(GNUTLS_RND_RANDOM, entropy, length);
1735 return rc?CURLE_FAILED_INIT:CURLE_OK;
1736 #elif defined(USE_GNUTLS)
1738 Curl_gtls_seed(data); /* Initiate the seed if not already done */
1739 gcry_randomize(entropy, length, GCRY_STRONG_RANDOM);
1744 static CURLcode Curl_gtls_md5sum(unsigned char *tmp, /* input */
1746 unsigned char *md5sum, /* output */
1749 #if defined(USE_GNUTLS_NETTLE)
1750 struct md5_ctx MD5pw;
1752 md5_update(&MD5pw, (unsigned int)tmplen, tmp);
1753 md5_digest(&MD5pw, (unsigned int)md5len, md5sum);
1754 #elif defined(USE_GNUTLS)
1756 gcry_md_open(&MD5pw, GCRY_MD_MD5, 0);
1757 gcry_md_write(MD5pw, tmp, tmplen);
1758 memcpy(md5sum, gcry_md_read(MD5pw, 0), md5len);
1759 gcry_md_close(MD5pw);
1764 static void Curl_gtls_sha256sum(const unsigned char *tmp, /* input */
1766 unsigned char *sha256sum, /* output */
1769 #if defined(USE_GNUTLS_NETTLE)
1770 struct sha256_ctx SHA256pw;
1771 sha256_init(&SHA256pw);
1772 sha256_update(&SHA256pw, (unsigned int)tmplen, tmp);
1773 sha256_digest(&SHA256pw, (unsigned int)sha256len, sha256sum);
1774 #elif defined(USE_GNUTLS)
1775 gcry_md_hd_t SHA256pw;
1776 gcry_md_open(&SHA256pw, GCRY_MD_SHA256, 0);
1777 gcry_md_write(SHA256pw, tmp, tmplen);
1778 memcpy(sha256sum, gcry_md_read(SHA256pw, 0), sha256len);
1779 gcry_md_close(SHA256pw);
1783 static bool Curl_gtls_cert_status_request(void)
1792 static void *Curl_gtls_get_internals(struct ssl_connect_data *connssl,
1793 CURLINFO info UNUSED_PARAM)
1796 return BACKEND->session;
1799 const struct Curl_ssl Curl_ssl_gnutls = {
1800 { CURLSSLBACKEND_GNUTLS, "gnutls" }, /* info */
1802 1, /* have_ca_path */
1803 1, /* have_certinfo */
1804 1, /* have_pinnedpubkey */
1805 0, /* have_ssl_ctx */
1806 1, /* support_https_proxy */
1808 sizeof(struct ssl_backend_data),
1810 Curl_gtls_init, /* init */
1811 Curl_gtls_cleanup, /* cleanup */
1812 Curl_gtls_version, /* version */
1813 Curl_none_check_cxn, /* check_cxn */
1814 Curl_gtls_shutdown, /* shutdown */
1815 Curl_gtls_data_pending, /* data_pending */
1816 Curl_gtls_random, /* random */
1817 Curl_gtls_cert_status_request, /* cert_status_request */
1818 Curl_gtls_connect, /* connect */
1819 Curl_gtls_connect_nonblocking, /* connect_nonblocking */
1820 Curl_gtls_get_internals, /* get_internals */
1821 Curl_gtls_close, /* close_one */
1822 Curl_none_close_all, /* close_all */
1823 Curl_gtls_session_free, /* session_free */
1824 Curl_none_set_engine, /* set_engine */
1825 Curl_none_set_engine_default, /* set_engine_default */
1826 Curl_none_engines_list, /* engines_list */
1827 Curl_none_false_start, /* false_start */
1828 Curl_gtls_md5sum, /* md5sum */
1829 Curl_gtls_sha256sum /* sha256sum */
1832 #endif /* USE_GNUTLS */