1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2014, 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 http://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/gnutls.h>
36 #include <gnutls/x509.h>
38 #ifdef USE_GNUTLS_NETTLE
39 #include <gnutls/crypto.h>
40 #include <nettle/md5.h>
47 #include "inet_pton.h"
50 #include "parsedate.h"
51 #include "connect.h" /* for the connect timeout */
56 #define _MPRINTF_REPLACE /* use our functions only */
57 #include <curl/mprintf.h>
58 #include "curl_memory.h"
59 /* The last #include file should be: */
63 Some hackish cast macros based on:
64 http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html
66 #ifndef GNUTLS_POINTER_TO_INT_CAST
67 #define GNUTLS_POINTER_TO_INT_CAST(p) ((int) (long) (p))
69 #ifndef GNUTLS_INT_TO_POINTER_CAST
70 #define GNUTLS_INT_TO_POINTER_CAST(i) ((void*) (long) (i))
73 /* Enable GnuTLS debugging by defining GTLSDEBUG */
74 /*#define GTLSDEBUG */
77 static void tls_log_func(int level, const char *str)
79 fprintf(stderr, "|<%d>| %s", level, str);
82 static bool gtls_inited = FALSE;
84 #if defined(GNUTLS_VERSION_NUMBER)
85 # if (GNUTLS_VERSION_NUMBER >= 0x020c00)
86 # undef gnutls_transport_set_lowat
87 # define gnutls_transport_set_lowat(A,B) Curl_nop_stmt
88 # define USE_GNUTLS_PRIORITY_SET_DIRECT 1
90 # if (GNUTLS_VERSION_NUMBER >= 0x020c03)
91 # define GNUTLS_MAPS_WINSOCK_ERRORS 1
96 # if (GNUTLS_VERSION_NUMBER >= 0x030200)
103 * Custom push and pull callback functions used by GNU TLS to read and write
104 * to the socket. These functions are simple wrappers to send() and recv()
105 * (although here using the sread/swrite macros as defined by
106 * curl_setup_once.h).
107 * We use custom functions rather than the GNU TLS defaults because it allows
108 * us to get specific about the fourth "flags" argument, and to use arbitrary
109 * private data with gnutls_transport_set_ptr if we wish.
111 * When these custom push and pull callbacks fail, GNU TLS checks its own
112 * session-specific error variable, and when not set also its own global
113 * errno variable, in order to take appropriate action. GNU TLS does not
114 * require that the transport is actually a socket. This implies that for
115 * Windows builds these callbacks should ideally set the session-specific
116 * error variable using function gnutls_transport_set_errno or as a last
117 * resort global errno variable using gnutls_transport_set_global_errno,
118 * with a transport agnostic error value. This implies that some winsock
119 * error translation must take place in these callbacks.
121 * Paragraph above applies to GNU TLS versions older than 2.12.3, since
122 * this version GNU TLS does its own internal winsock error translation
123 * using system_errno() function.
126 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
127 # define gtls_EINTR 4
129 # define gtls_EAGAIN 11
130 static int gtls_mapped_sockerrno(void)
144 static ssize_t Curl_gtls_push(void *s, const void *buf, size_t len)
146 ssize_t ret = swrite(GNUTLS_POINTER_TO_INT_CAST(s), buf, len);
147 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
149 gnutls_transport_set_global_errno(gtls_mapped_sockerrno());
154 static ssize_t Curl_gtls_pull(void *s, void *buf, size_t len)
156 ssize_t ret = sread(GNUTLS_POINTER_TO_INT_CAST(s), buf, len);
157 #if defined(USE_WINSOCK) && !defined(GNUTLS_MAPS_WINSOCK_ERRORS)
159 gnutls_transport_set_global_errno(gtls_mapped_sockerrno());
166 * Global GnuTLS init, called from Curl_ssl_init(). This calls functions that
167 * are not thread-safe and thus this function itself is not thread-safe and
168 * must only be called from within curl_global_init() to keep the thread
169 * situation under control!
171 int Curl_gtls_init(void)
175 ret = gnutls_global_init()?0:1;
177 gnutls_global_set_log_function(tls_log_func);
178 gnutls_global_set_log_level(2);
185 int Curl_gtls_cleanup(void)
188 gnutls_global_deinit();
194 static void showtime(struct SessionHandle *data,
199 const struct tm *tm = &buffer;
200 CURLcode result = Curl_gmtime(stamp, &buffer);
204 snprintf(data->state.buffer,
206 "\t %s: %s, %02d %s %4d %02d:%02d:%02d GMT\n",
208 Curl_wkday[tm->tm_wday?tm->tm_wday-1:6],
210 Curl_month[tm->tm_mon],
215 infof(data, "%s\n", data->state.buffer);
218 static gnutls_datum_t load_file (const char *file)
221 gnutls_datum_t loaded_file = { NULL, 0 };
225 if(!(f = fopen(file, "r")))
227 if(fseek(f, 0, SEEK_END) != 0
228 || (filelen = ftell(f)) < 0
229 || fseek(f, 0, SEEK_SET) != 0
230 || !(ptr = malloc((size_t)filelen)))
232 if(fread(ptr, 1, (size_t)filelen, f) < (size_t)filelen) {
237 loaded_file.data = ptr;
238 loaded_file.size = (unsigned int)filelen;
244 static void unload_file(gnutls_datum_t data) {
249 /* this function does a SSL/TLS (re-)handshake */
250 static CURLcode handshake(struct connectdata *conn,
255 struct SessionHandle *data = conn->data;
256 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
257 gnutls_session_t session = conn->ssl[sockindex].session;
258 curl_socket_t sockfd = conn->sock[sockindex];
264 /* check allowed time left */
265 timeout_ms = Curl_timeleft(data, NULL, duringconnect);
268 /* no need to continue if time already is up */
269 failf(data, "SSL connection timeout");
270 return CURLE_OPERATION_TIMEDOUT;
273 /* if ssl is expecting something, check if it's available. */
274 if(connssl->connecting_state == ssl_connect_2_reading
275 || connssl->connecting_state == ssl_connect_2_writing) {
277 curl_socket_t writefd = ssl_connect_2_writing==
278 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
279 curl_socket_t readfd = ssl_connect_2_reading==
280 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
282 what = Curl_socket_ready(readfd, writefd,
284 timeout_ms?timeout_ms:1000);
287 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
288 return CURLE_SSL_CONNECT_ERROR;
293 else if(timeout_ms) {
295 failf(data, "SSL connection timeout at %ld", timeout_ms);
296 return CURLE_OPERATION_TIMEDOUT;
299 /* socket is readable or writable */
302 rc = gnutls_handshake(session);
304 if((rc == GNUTLS_E_AGAIN) || (rc == GNUTLS_E_INTERRUPTED)) {
305 connssl->connecting_state =
306 gnutls_record_get_direction(session)?
307 ssl_connect_2_writing:ssl_connect_2_reading;
312 else if((rc < 0) && !gnutls_error_is_fatal(rc)) {
313 const char *strerr = NULL;
315 if(rc == GNUTLS_E_WARNING_ALERT_RECEIVED) {
316 int alert = gnutls_alert_get(session);
317 strerr = gnutls_alert_get_name(alert);
321 strerr = gnutls_strerror(rc);
323 failf(data, "gnutls_handshake() warning: %s", strerr);
326 const char *strerr = NULL;
328 if(rc == GNUTLS_E_FATAL_ALERT_RECEIVED) {
329 int alert = gnutls_alert_get(session);
330 strerr = gnutls_alert_get_name(alert);
334 strerr = gnutls_strerror(rc);
336 failf(data, "gnutls_handshake() failed: %s", strerr);
337 return CURLE_SSL_CONNECT_ERROR;
340 /* Reset our connect state machine */
341 connssl->connecting_state = ssl_connect_1;
346 static gnutls_x509_crt_fmt_t do_file_type(const char *type)
348 if(!type || !type[0])
349 return GNUTLS_X509_FMT_PEM;
350 if(Curl_raw_equal(type, "PEM"))
351 return GNUTLS_X509_FMT_PEM;
352 if(Curl_raw_equal(type, "DER"))
353 return GNUTLS_X509_FMT_DER;
358 gtls_connect_step1(struct connectdata *conn,
361 struct SessionHandle *data = conn->data;
362 gnutls_session_t session;
366 bool sni = TRUE; /* default is SNI enabled */
368 struct in6_addr addr;
372 #ifndef USE_GNUTLS_PRIORITY_SET_DIRECT
373 static const int cipher_priority[] = {
374 /* These two ciphers were added to GnuTLS as late as ver. 3.0.1,
375 but this code path is only ever used for ver. < 2.12.0.
376 GNUTLS_CIPHER_AES_128_GCM,
377 GNUTLS_CIPHER_AES_256_GCM,
379 GNUTLS_CIPHER_AES_128_CBC,
380 GNUTLS_CIPHER_AES_256_CBC,
381 GNUTLS_CIPHER_CAMELLIA_128_CBC,
382 GNUTLS_CIPHER_CAMELLIA_256_CBC,
383 GNUTLS_CIPHER_3DES_CBC,
385 static const int cert_type_priority[] = { GNUTLS_CRT_X509, 0 };
386 static int protocol_priority[] = { 0, 0, 0, 0 };
388 #define GNUTLS_CIPHERS "NORMAL:-ARCFOUR-128:-CTYPE-ALL:+CTYPE-X509"
389 /* If GnuTLS was compiled without support for SRP it will error out if SRP is
390 requested in the priority string, so treat it specially
392 #define GNUTLS_SRP "+SRP"
393 const char* prioritylist;
394 const char *err = NULL;
397 int protocols_size = 2;
398 gnutls_datum_t protocols[2];
401 if(conn->ssl[sockindex].state == ssl_connection_complete)
402 /* to make us tolerant against being called more than once for the
409 /* GnuTLS only supports SSLv3 and TLSv1 */
410 if(data->set.ssl.version == CURL_SSLVERSION_SSLv2) {
411 failf(data, "GnuTLS does not support SSLv2");
412 return CURLE_SSL_CONNECT_ERROR;
414 else if(data->set.ssl.version == CURL_SSLVERSION_SSLv3)
415 sni = FALSE; /* SSLv3 has no SNI */
417 /* allocate a cred struct */
418 rc = gnutls_certificate_allocate_credentials(&conn->ssl[sockindex].cred);
419 if(rc != GNUTLS_E_SUCCESS) {
420 failf(data, "gnutls_cert_all_cred() failed: %s", gnutls_strerror(rc));
421 return CURLE_SSL_CONNECT_ERROR;
425 if(data->set.ssl.authtype == CURL_TLSAUTH_SRP) {
426 infof(data, "Using TLS-SRP username: %s\n", data->set.ssl.username);
428 rc = gnutls_srp_allocate_client_credentials(
429 &conn->ssl[sockindex].srp_client_cred);
430 if(rc != GNUTLS_E_SUCCESS) {
431 failf(data, "gnutls_srp_allocate_client_cred() failed: %s",
432 gnutls_strerror(rc));
433 return CURLE_OUT_OF_MEMORY;
436 rc = gnutls_srp_set_client_credentials(conn->ssl[sockindex].
438 data->set.ssl.username,
439 data->set.ssl.password);
440 if(rc != GNUTLS_E_SUCCESS) {
441 failf(data, "gnutls_srp_set_client_cred() failed: %s",
442 gnutls_strerror(rc));
443 return CURLE_BAD_FUNCTION_ARGUMENT;
448 if(data->set.ssl.CAfile) {
449 /* set the trusted CA cert bundle file */
450 gnutls_certificate_set_verify_flags(conn->ssl[sockindex].cred,
451 GNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT);
453 rc = gnutls_certificate_set_x509_trust_file(conn->ssl[sockindex].cred,
454 data->set.ssl.CAfile,
455 GNUTLS_X509_FMT_PEM);
457 infof(data, "error reading ca cert file %s (%s)\n",
458 data->set.ssl.CAfile, gnutls_strerror(rc));
459 if(data->set.ssl.verifypeer)
460 return CURLE_SSL_CACERT_BADFILE;
463 infof(data, "found %d certificates in %s\n",
464 rc, data->set.ssl.CAfile);
467 if(data->set.ssl.CRLfile) {
468 /* set the CRL list file */
469 rc = gnutls_certificate_set_x509_crl_file(conn->ssl[sockindex].cred,
470 data->set.ssl.CRLfile,
471 GNUTLS_X509_FMT_PEM);
473 failf(data, "error reading crl file %s (%s)",
474 data->set.ssl.CRLfile, gnutls_strerror(rc));
475 return CURLE_SSL_CRL_BADFILE;
478 infof(data, "found %d CRL in %s\n",
479 rc, data->set.ssl.CRLfile);
482 /* Initialize TLS session as a client */
483 rc = gnutls_init(&conn->ssl[sockindex].session, GNUTLS_CLIENT);
484 if(rc != GNUTLS_E_SUCCESS) {
485 failf(data, "gnutls_init() failed: %d", rc);
486 return CURLE_SSL_CONNECT_ERROR;
489 /* convenient assign */
490 session = conn->ssl[sockindex].session;
492 if((0 == Curl_inet_pton(AF_INET, conn->host.name, &addr)) &&
494 (0 == Curl_inet_pton(AF_INET6, conn->host.name, &addr)) &&
497 (gnutls_server_name_set(session, GNUTLS_NAME_DNS, conn->host.name,
498 strlen(conn->host.name)) < 0))
499 infof(data, "WARNING: failed to configure server name indication (SNI) "
502 /* Use default priorities */
503 rc = gnutls_set_default_priority(session);
504 if(rc != GNUTLS_E_SUCCESS)
505 return CURLE_SSL_CONNECT_ERROR;
507 #ifndef USE_GNUTLS_PRIORITY_SET_DIRECT
508 rc = gnutls_cipher_set_priority(session, cipher_priority);
509 if(rc != GNUTLS_E_SUCCESS)
510 return CURLE_SSL_CONNECT_ERROR;
512 /* Sets the priority on the certificate types supported by gnutls. Priority
513 is higher for types specified before others. After specifying the types
514 you want, you must append a 0. */
515 rc = gnutls_certificate_type_set_priority(session, cert_type_priority);
516 if(rc != GNUTLS_E_SUCCESS)
517 return CURLE_SSL_CONNECT_ERROR;
519 if(data->set.ssl.cipher_list != NULL) {
520 failf(data, "can't pass a custom cipher list to older GnuTLS"
522 return CURLE_SSL_CONNECT_ERROR;
525 switch (data->set.ssl.version) {
526 case CURL_SSLVERSION_SSLv3:
527 protocol_priority[0] = GNUTLS_SSL3;
529 case CURL_SSLVERSION_DEFAULT:
530 case CURL_SSLVERSION_TLSv1:
531 protocol_priority[0] = GNUTLS_TLS1_0;
532 protocol_priority[1] = GNUTLS_TLS1_1;
533 protocol_priority[2] = GNUTLS_TLS1_2;
535 case CURL_SSLVERSION_TLSv1_0:
536 protocol_priority[0] = GNUTLS_TLS1_0;
538 case CURL_SSLVERSION_TLSv1_1:
539 protocol_priority[0] = GNUTLS_TLS1_1;
541 case CURL_SSLVERSION_TLSv1_2:
542 protocol_priority[0] = GNUTLS_TLS1_2;
544 case CURL_SSLVERSION_SSLv2:
546 failf(data, "GnuTLS does not support SSLv2");
547 return CURLE_SSL_CONNECT_ERROR;
550 rc = gnutls_protocol_set_priority(session, protocol_priority);
551 if(rc != GNUTLS_E_SUCCESS) {
552 failf(data, "Did you pass a valid GnuTLS cipher list?");
553 return CURLE_SSL_CONNECT_ERROR;
557 /* Ensure +SRP comes at the *end* of all relevant strings so that it can be
558 * removed if a run-time error indicates that SRP is not supported by this
560 switch (data->set.ssl.version) {
561 case CURL_SSLVERSION_SSLv3:
562 prioritylist = GNUTLS_CIPHERS ":-VERS-TLS-ALL:+VERS-SSL3.0";
565 case CURL_SSLVERSION_DEFAULT:
566 case CURL_SSLVERSION_TLSv1:
567 prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:" GNUTLS_SRP;
569 case CURL_SSLVERSION_TLSv1_0:
570 prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
571 "+VERS-TLS1.0:" GNUTLS_SRP;
573 case CURL_SSLVERSION_TLSv1_1:
574 prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
575 "+VERS-TLS1.1:" GNUTLS_SRP;
577 case CURL_SSLVERSION_TLSv1_2:
578 prioritylist = GNUTLS_CIPHERS ":-VERS-SSL3.0:-VERS-TLS-ALL:"
579 "+VERS-TLS1.2:" GNUTLS_SRP;
581 case CURL_SSLVERSION_SSLv2:
583 failf(data, "GnuTLS does not support SSLv2");
584 return CURLE_SSL_CONNECT_ERROR;
587 rc = gnutls_priority_set_direct(session, prioritylist, &err);
588 if((rc == GNUTLS_E_INVALID_REQUEST) && err) {
589 if(!strcmp(err, GNUTLS_SRP)) {
590 /* This GnuTLS was probably compiled without support for SRP.
591 * Note that fact and try again without it. */
592 int validprioritylen = curlx_uztosi(err - prioritylist);
593 char *prioritycopy = strdup(prioritylist);
595 return CURLE_OUT_OF_MEMORY;
597 infof(data, "This GnuTLS does not support SRP\n");
599 /* Remove the :+SRP */
600 prioritycopy[validprioritylen - 1] = 0;
601 rc = gnutls_priority_set_direct(session, prioritycopy, &err);
605 if(rc != GNUTLS_E_SUCCESS) {
606 failf(data, "Error %d setting GnuTLS cipher list starting with %s",
608 return CURLE_SSL_CONNECT_ERROR;
613 if(data->set.httpversion == CURL_HTTP_VERSION_2_0) {
614 if(data->set.ssl_enable_alpn) {
615 protocols[0].data = NGHTTP2_PROTO_VERSION_ID;
616 protocols[0].size = NGHTTP2_PROTO_VERSION_ID_LEN;
617 protocols[1].data = ALPN_HTTP_1_1;
618 protocols[1].size = ALPN_HTTP_1_1_LENGTH;
619 gnutls_alpn_set_protocols(session, protocols, protocols_size, 0);
620 infof(data, "ALPN, offering %s, %s\n", NGHTTP2_PROTO_VERSION_ID,
624 infof(data, "SSL, can't negotiate HTTP/2.0 without ALPN\n");
629 if(data->set.str[STRING_CERT]) {
630 if(gnutls_certificate_set_x509_key_file(
631 conn->ssl[sockindex].cred,
632 data->set.str[STRING_CERT],
633 data->set.str[STRING_KEY] ?
634 data->set.str[STRING_KEY] : data->set.str[STRING_CERT],
635 do_file_type(data->set.str[STRING_CERT_TYPE]) ) !=
637 failf(data, "error reading X.509 key or certificate file");
638 return CURLE_SSL_CONNECT_ERROR;
643 /* put the credentials to the current session */
644 if(data->set.ssl.authtype == CURL_TLSAUTH_SRP) {
645 rc = gnutls_credentials_set(session, GNUTLS_CRD_SRP,
646 conn->ssl[sockindex].srp_client_cred);
647 if(rc != GNUTLS_E_SUCCESS)
648 failf(data, "gnutls_credentials_set() failed: %s", gnutls_strerror(rc));
652 rc = gnutls_credentials_set(session, GNUTLS_CRD_CERTIFICATE,
653 conn->ssl[sockindex].cred);
655 /* set the connection handle (file descriptor for the socket) */
656 gnutls_transport_set_ptr(session,
657 GNUTLS_INT_TO_POINTER_CAST(conn->sock[sockindex]));
659 /* register callback functions to send and receive data. */
660 gnutls_transport_set_push_function(session, Curl_gtls_push);
661 gnutls_transport_set_pull_function(session, Curl_gtls_pull);
663 /* lowat must be set to zero when using custom push and pull functions. */
664 gnutls_transport_set_lowat(session, 0);
666 /* This might be a reconnect, so we check for a session ID in the cache
667 to speed up things */
669 if(!Curl_ssl_getsessionid(conn, &ssl_sessionid, &ssl_idsize)) {
670 /* we got a session id, use it! */
671 gnutls_session_set_data(session, ssl_sessionid, ssl_idsize);
673 /* Informational message */
674 infof (data, "SSL re-using session ID\n");
680 static Curl_recv gtls_recv;
681 static Curl_send gtls_send;
684 gtls_connect_step3(struct connectdata *conn,
687 unsigned int cert_list_size;
688 const gnutls_datum_t *chainp;
689 unsigned int verify_status;
690 gnutls_x509_crt_t x509_cert,x509_issuer;
691 gnutls_datum_t issuerp;
692 char certbuf[256] = ""; /* big enough? */
698 struct SessionHandle *data = conn->data;
699 gnutls_session_t session = conn->ssl[sockindex].session;
704 gnutls_datum_t proto;
706 CURLcode result = CURLE_OK;
708 /* This function will return the peer's raw certificate (chain) as sent by
709 the peer. These certificates are in raw format (DER encoded for
710 X.509). In case of a X.509 then a certificate list may be present. The
711 first certificate in the list is the peer's certificate, following the
712 issuer's certificate, then the issuer's issuer etc. */
714 chainp = gnutls_certificate_get_peers(session, &cert_list_size);
716 if(data->set.ssl.verifypeer ||
717 data->set.ssl.verifyhost ||
718 data->set.ssl.issuercert) {
720 if(data->set.ssl.authtype == CURL_TLSAUTH_SRP
721 && data->set.ssl.username != NULL
722 && !data->set.ssl.verifypeer
723 && gnutls_cipher_get(session)) {
724 /* no peer cert, but auth is ok if we have SRP user and cipher and no
729 failf(data, "failed to get server cert");
730 return CURLE_PEER_FAILED_VERIFICATION;
735 infof(data, "\t common name: WARNING couldn't obtain\n");
738 if(data->set.ssl.verifypeer) {
739 /* This function will try to verify the peer's certificate and return its
740 status (trusted, invalid etc.). The value of status should be one or
741 more of the gnutls_certificate_status_t enumerated elements bitwise
742 or'd. To avoid denial of service attacks some default upper limits
743 regarding the certificate key size and chain size are set. To override
744 them use gnutls_certificate_set_verify_limits(). */
746 rc = gnutls_certificate_verify_peers2(session, &verify_status);
748 failf(data, "server cert verify failed: %d", rc);
749 return CURLE_SSL_CONNECT_ERROR;
752 /* verify_status is a bitmask of gnutls_certificate_status bits */
753 if(verify_status & GNUTLS_CERT_INVALID) {
754 if(data->set.ssl.verifypeer) {
755 failf(data, "server certificate verification failed. CAfile: %s "
756 "CRLfile: %s", data->set.ssl.CAfile?data->set.ssl.CAfile:"none",
757 data->set.ssl.CRLfile?data->set.ssl.CRLfile:"none");
758 return CURLE_SSL_CACERT;
761 infof(data, "\t server certificate verification FAILED\n");
764 infof(data, "\t server certificate verification OK\n");
767 infof(data, "\t server certificate verification SKIPPED\n");
769 /* initialize an X.509 certificate structure. */
770 gnutls_x509_crt_init(&x509_cert);
773 /* convert the given DER or PEM encoded Certificate to the native
774 gnutls_x509_crt_t format */
775 gnutls_x509_crt_import(x509_cert, chainp, GNUTLS_X509_FMT_DER);
777 if(data->set.ssl.issuercert) {
778 gnutls_x509_crt_init(&x509_issuer);
779 issuerp = load_file(data->set.ssl.issuercert);
780 gnutls_x509_crt_import(x509_issuer, &issuerp, GNUTLS_X509_FMT_PEM);
781 rc = gnutls_x509_crt_check_issuer(x509_cert,x509_issuer);
782 unload_file(issuerp);
784 failf(data, "server certificate issuer check failed (IssuerCert: %s)",
785 data->set.ssl.issuercert?data->set.ssl.issuercert:"none");
786 return CURLE_SSL_ISSUER_ERROR;
788 infof(data,"\t server certificate issuer check OK (Issuer Cert: %s)\n",
789 data->set.ssl.issuercert?data->set.ssl.issuercert:"none");
792 size=sizeof(certbuf);
793 rc = gnutls_x509_crt_get_dn_by_oid(x509_cert, GNUTLS_OID_X520_COMMON_NAME,
794 0, /* the first and only one */
799 infof(data, "error fetching CN from cert:%s\n",
800 gnutls_strerror(rc));
803 /* This function will check if the given certificate's subject matches the
804 given hostname. This is a basic implementation of the matching described
805 in RFC2818 (HTTPS), which takes into account wildcards, and the subject
806 alternative name PKIX extension. Returns non zero on success, and zero on
808 rc = gnutls_x509_crt_check_hostname(x509_cert, conn->host.name);
809 #if GNUTLS_VERSION_NUMBER < 0x030306
810 /* Before 3.3.6, gnutls_x509_crt_check_hostname() didn't check IP
814 #define use_addr in6_addr
816 #define use_addr in_addr
818 unsigned char addrbuf[sizeof(struct use_addr)];
819 unsigned char certaddr[sizeof(struct use_addr)];
820 size_t addrlen = 0, certaddrlen;
824 if(Curl_inet_pton(AF_INET, conn->host.name, addrbuf) > 0)
827 else if(Curl_inet_pton(AF_INET6, conn->host.name, addrbuf) > 0)
833 certaddrlen = sizeof(certaddr);
834 ret = gnutls_x509_crt_get_subject_alt_name(x509_cert, i, certaddr,
836 /* If this happens, it wasn't an IP address. */
837 if(ret == GNUTLS_E_SHORT_MEMORY_BUFFER)
841 if(ret != GNUTLS_SAN_IPADDRESS)
843 if(certaddrlen == addrlen && !memcmp(addrbuf, certaddr, addrlen)) {
852 if(data->set.ssl.verifyhost) {
853 failf(data, "SSL: certificate subject name (%s) does not match "
854 "target host name '%s'", certbuf, conn->host.dispname);
855 gnutls_x509_crt_deinit(x509_cert);
856 return CURLE_PEER_FAILED_VERIFICATION;
859 infof(data, "\t common name: %s (does not match '%s')\n",
860 certbuf, conn->host.dispname);
863 infof(data, "\t common name: %s (matched)\n", certbuf);
865 /* Check for time-based validity */
866 certclock = gnutls_x509_crt_get_expiration_time(x509_cert);
868 if(certclock == (time_t)-1) {
869 if(data->set.ssl.verifypeer) {
870 failf(data, "server cert expiration date verify failed");
871 return CURLE_SSL_CONNECT_ERROR;
874 infof(data, "\t server certificate expiration date verify FAILED\n");
877 if(certclock < time(NULL)) {
878 if(data->set.ssl.verifypeer) {
879 failf(data, "server certificate expiration date has passed.");
880 return CURLE_PEER_FAILED_VERIFICATION;
883 infof(data, "\t server certificate expiration date FAILED\n");
886 infof(data, "\t server certificate expiration date OK\n");
889 certclock = gnutls_x509_crt_get_activation_time(x509_cert);
891 if(certclock == (time_t)-1) {
892 if(data->set.ssl.verifypeer) {
893 failf(data, "server cert activation date verify failed");
894 return CURLE_SSL_CONNECT_ERROR;
897 infof(data, "\t server certificate activation date verify FAILED\n");
900 if(certclock > time(NULL)) {
901 if(data->set.ssl.verifypeer) {
902 failf(data, "server certificate not activated yet.");
903 return CURLE_PEER_FAILED_VERIFICATION;
906 infof(data, "\t server certificate activation date FAILED\n");
909 infof(data, "\t server certificate activation date OK\n");
923 /* public key algorithm's parameters */
924 algo = gnutls_x509_crt_get_pk_algorithm(x509_cert, &bits);
925 infof(data, "\t certificate public key: %s\n",
926 gnutls_pk_algorithm_get_name(algo));
928 /* version of the X.509 certificate. */
929 infof(data, "\t certificate version: #%d\n",
930 gnutls_x509_crt_get_version(x509_cert));
933 size = sizeof(certbuf);
934 gnutls_x509_crt_get_dn(x509_cert, certbuf, &size);
935 infof(data, "\t subject: %s\n", certbuf);
937 certclock = gnutls_x509_crt_get_activation_time(x509_cert);
938 showtime(data, "start date", certclock);
940 certclock = gnutls_x509_crt_get_expiration_time(x509_cert);
941 showtime(data, "expire date", certclock);
943 size = sizeof(certbuf);
944 gnutls_x509_crt_get_issuer_dn(x509_cert, certbuf, &size);
945 infof(data, "\t issuer: %s\n", certbuf);
947 gnutls_x509_crt_deinit(x509_cert);
949 /* compression algorithm (if any) */
950 ptr = gnutls_compression_get_name(gnutls_compression_get(session));
951 /* the *_get_name() says "NULL" if GNUTLS_COMP_NULL is returned */
952 infof(data, "\t compression: %s\n", ptr);
954 /* the name of the cipher used. ie 3DES. */
955 ptr = gnutls_cipher_get_name(gnutls_cipher_get(session));
956 infof(data, "\t cipher: %s\n", ptr);
958 /* the MAC algorithms name. ie SHA1 */
959 ptr = gnutls_mac_get_name(gnutls_mac_get(session));
960 infof(data, "\t MAC: %s\n", ptr);
963 if(data->set.ssl_enable_alpn) {
964 rc = gnutls_alpn_get_selected_protocol(session, &proto);
966 infof(data, "ALPN, server accepted to use %.*s\n", proto.size,
969 if(proto.size == NGHTTP2_PROTO_VERSION_ID_LEN &&
970 memcmp(NGHTTP2_PROTO_VERSION_ID, proto.data,
971 NGHTTP2_PROTO_VERSION_ID_LEN) == 0) {
972 conn->negnpn = NPN_HTTP2;
974 else if(proto.size == ALPN_HTTP_1_1_LENGTH && memcmp(ALPN_HTTP_1_1,
975 proto.data, ALPN_HTTP_1_1_LENGTH) == 0) {
976 conn->negnpn = NPN_HTTP1_1;
980 infof(data, "ALPN, server did not agree to a protocol\n");
985 conn->ssl[sockindex].state = ssl_connection_complete;
986 conn->recv[sockindex] = gtls_recv;
987 conn->send[sockindex] = gtls_send;
990 /* we always unconditionally get the session id here, as even if we
991 already got it from the cache and asked to use it in the connection, it
992 might've been rejected and then a new one is in use now and we need to
994 void *connect_sessionid;
995 size_t connect_idsize = 0;
997 /* get the session ID data size */
998 gnutls_session_get_data(session, NULL, &connect_idsize);
999 connect_sessionid = malloc(connect_idsize); /* get a buffer for it */
1001 if(connect_sessionid) {
1002 /* extract session ID to the allocated buffer */
1003 gnutls_session_get_data(session, connect_sessionid, &connect_idsize);
1005 incache = !(Curl_ssl_getsessionid(conn, &ssl_sessionid, NULL));
1007 /* there was one before in the cache, so instead of risking that the
1008 previous one was rejected, we just kill that and store the new */
1009 Curl_ssl_delsessionid(conn, ssl_sessionid);
1012 /* store this session id */
1013 result = Curl_ssl_addsessionid(conn, connect_sessionid, connect_idsize);
1015 free(connect_sessionid);
1016 result = CURLE_OUT_OF_MEMORY;
1020 result = CURLE_OUT_OF_MEMORY;
1028 * This function is called after the TCP connect has completed. Setup the TLS
1029 * layer and do all necessary magic.
1031 /* We use connssl->connecting_state to keep track of the connection status;
1032 there are three states: 'ssl_connect_1' (not started yet or complete),
1033 'ssl_connect_2_reading' (waiting for data from server), and
1034 'ssl_connect_2_writing' (waiting to be able to write).
1037 gtls_connect_common(struct connectdata *conn,
1043 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1045 /* Initiate the connection, if not already done */
1046 if(ssl_connect_1==connssl->connecting_state) {
1047 rc = gtls_connect_step1 (conn, sockindex);
1052 rc = handshake(conn, sockindex, TRUE, nonblocking);
1054 /* handshake() sets its own error message with failf() */
1057 /* Finish connecting once the handshake is done */
1058 if(ssl_connect_1==connssl->connecting_state) {
1059 rc = gtls_connect_step3(conn, sockindex);
1064 *done = ssl_connect_1==connssl->connecting_state;
1070 Curl_gtls_connect_nonblocking(struct connectdata *conn,
1074 return gtls_connect_common(conn, sockindex, TRUE, done);
1078 Curl_gtls_connect(struct connectdata *conn,
1085 retcode = gtls_connect_common(conn, sockindex, FALSE, &done);
1094 static ssize_t gtls_send(struct connectdata *conn,
1100 ssize_t rc = gnutls_record_send(conn->ssl[sockindex].session, mem, len);
1103 *curlcode = (rc == GNUTLS_E_AGAIN)
1113 void Curl_gtls_close_all(struct SessionHandle *data)
1115 /* FIX: make the OpenSSL code more generic and use parts of it here */
1119 static void close_one(struct connectdata *conn,
1122 if(conn->ssl[idx].session) {
1123 gnutls_bye(conn->ssl[idx].session, GNUTLS_SHUT_RDWR);
1124 gnutls_deinit(conn->ssl[idx].session);
1125 conn->ssl[idx].session = NULL;
1127 if(conn->ssl[idx].cred) {
1128 gnutls_certificate_free_credentials(conn->ssl[idx].cred);
1129 conn->ssl[idx].cred = NULL;
1132 if(conn->ssl[idx].srp_client_cred) {
1133 gnutls_srp_free_client_credentials(conn->ssl[idx].srp_client_cred);
1134 conn->ssl[idx].srp_client_cred = NULL;
1139 void Curl_gtls_close(struct connectdata *conn, int sockindex)
1141 close_one(conn, sockindex);
1145 * This function is called to shut down the SSL layer but keep the
1146 * socket open (CCC - Clear Command Channel)
1148 int Curl_gtls_shutdown(struct connectdata *conn, int sockindex)
1152 struct SessionHandle *data = conn->data;
1156 /* This has only been tested on the proftpd server, and the mod_tls code
1157 sends a close notify alert without waiting for a close notify alert in
1158 response. Thus we wait for a close notify alert from the server, but
1159 we do not send one. Let's hope other servers do the same... */
1161 if(data->set.ftp_ccc == CURLFTPSSL_CCC_ACTIVE)
1162 gnutls_bye(conn->ssl[sockindex].session, GNUTLS_SHUT_WR);
1164 if(conn->ssl[sockindex].session) {
1166 int what = Curl_socket_ready(conn->sock[sockindex],
1167 CURL_SOCKET_BAD, SSL_SHUTDOWN_TIMEOUT);
1169 /* Something to read, let's do it and hope that it is the close
1170 notify alert from the server */
1171 result = gnutls_record_recv(conn->ssl[sockindex].session,
1175 /* This is the expected response. There was no data but only
1176 the close notify alert */
1179 case GNUTLS_E_AGAIN:
1180 case GNUTLS_E_INTERRUPTED:
1181 infof(data, "GNUTLS_E_AGAIN || GNUTLS_E_INTERRUPTED\n");
1189 else if(0 == what) {
1191 failf(data, "SSL shutdown timeout");
1196 /* anything that gets here is fatally bad */
1197 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
1202 gnutls_deinit(conn->ssl[sockindex].session);
1204 gnutls_certificate_free_credentials(conn->ssl[sockindex].cred);
1207 if(data->set.ssl.authtype == CURL_TLSAUTH_SRP
1208 && data->set.ssl.username != NULL)
1209 gnutls_srp_free_client_credentials(conn->ssl[sockindex].srp_client_cred);
1212 conn->ssl[sockindex].cred = NULL;
1213 conn->ssl[sockindex].session = NULL;
1218 static ssize_t gtls_recv(struct connectdata *conn, /* connection data */
1219 int num, /* socketindex */
1220 char *buf, /* store read data here */
1221 size_t buffersize, /* max amount to read */
1226 ret = gnutls_record_recv(conn->ssl[num].session, buf, buffersize);
1227 if((ret == GNUTLS_E_AGAIN) || (ret == GNUTLS_E_INTERRUPTED)) {
1228 *curlcode = CURLE_AGAIN;
1232 if(ret == GNUTLS_E_REHANDSHAKE) {
1233 /* BLOCKING call, this is bad but a work-around for now. Fixing this "the
1234 proper way" takes a whole lot of work. */
1235 CURLcode rc = handshake(conn, num, FALSE, FALSE);
1237 /* handshake() writes error message on its own */
1240 *curlcode = CURLE_AGAIN; /* then return as if this was a wouldblock */
1245 failf(conn->data, "GnuTLS recv error (%d): %s",
1246 (int)ret, gnutls_strerror((int)ret));
1247 *curlcode = CURLE_RECV_ERROR;
1254 void Curl_gtls_session_free(void *ptr)
1259 size_t Curl_gtls_version(char *buffer, size_t size)
1261 return snprintf(buffer, size, "GnuTLS/%s", gnutls_check_version(NULL));
1264 int Curl_gtls_seed(struct SessionHandle *data)
1266 /* we have the "SSL is seeded" boolean static to prevent multiple
1267 time-consuming seedings in vain */
1268 static bool ssl_seeded = FALSE;
1270 /* Quickly add a bit of entropy */
1271 #ifndef USE_GNUTLS_NETTLE
1272 gcry_fast_random_poll();
1275 if(!ssl_seeded || data->set.str[STRING_SSL_RANDOM_FILE] ||
1276 data->set.str[STRING_SSL_EGDSOCKET]) {
1278 /* TODO: to a good job seeding the RNG
1279 This may involve the gcry_control function and these options:
1280 GCRYCTL_SET_RANDOM_SEED_FILE
1281 GCRYCTL_SET_RNDEGD_SOCKET
1288 void Curl_gtls_random(struct SessionHandle *data,
1289 unsigned char *entropy,
1292 #if defined(USE_GNUTLS_NETTLE)
1294 gnutls_rnd(GNUTLS_RND_RANDOM, entropy, length);
1295 #elif defined(USE_GNUTLS)
1296 Curl_gtls_seed(data); /* Initiate the seed if not already done */
1297 gcry_randomize(entropy, length, GCRY_STRONG_RANDOM);
1301 void Curl_gtls_md5sum(unsigned char *tmp, /* input */
1303 unsigned char *md5sum, /* output */
1306 #if defined(USE_GNUTLS_NETTLE)
1307 struct md5_ctx MD5pw;
1309 md5_update(&MD5pw, (unsigned int)tmplen, tmp);
1310 md5_digest(&MD5pw, (unsigned int)md5len, md5sum);
1311 #elif defined(USE_GNUTLS)
1313 gcry_md_open(&MD5pw, GCRY_MD_MD5, 0);
1314 gcry_md_write(MD5pw, tmp, tmplen);
1315 memcpy(md5sum, gcry_md_read (MD5pw, 0), md5len);
1316 gcry_md_close(MD5pw);
1320 #endif /* USE_GNUTLS */