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 NSS-specific code for the TLS/SSL layer. No code
25 * but vtls.c should ever call or use these functions.
28 #include "curl_setup.h"
34 #include "formdata.h" /* for the boundary function */
35 #include "url.h" /* for the ssl config check function */
42 #define _MPRINTF_REPLACE /* use the internal *printf() functions */
43 #include <curl/mprintf.h>
63 #include "curl_memory.h"
68 /* The last #include file should be: */
71 #define SSL_DIR "/etc/pki/nssdb"
73 /* enough to fit the string "PEM Token #[0|1]" */
76 PRFileDesc *PR_ImportTCPSocket(PRInt32 osfd);
78 PRLock * nss_initlock = NULL;
79 PRLock * nss_crllock = NULL;
80 struct curl_llist *nss_crl_list = NULL;
81 NSSInitContext * nss_context = NULL;
83 volatile int initialized = 0;
90 #define PK11_SETATTRS(_attr, _idx, _type, _val, _len) do { \
91 CK_ATTRIBUTE *ptr = (_attr) + ((_idx)++); \
92 ptr->type = (_type); \
93 ptr->pValue = (_val); \
94 ptr->ulValueLen = (_len); \
97 #define CERT_NewTempCertificate __CERT_NewTempCertificate
99 #define NUM_OF_CIPHERS sizeof(cipherlist)/sizeof(cipherlist[0])
100 static const cipher_s cipherlist[] = {
101 /* SSL2 cipher suites */
102 {"rc4", SSL_EN_RC4_128_WITH_MD5},
103 {"rc4-md5", SSL_EN_RC4_128_WITH_MD5},
104 {"rc4export", SSL_EN_RC4_128_EXPORT40_WITH_MD5},
105 {"rc2", SSL_EN_RC2_128_CBC_WITH_MD5},
106 {"rc2export", SSL_EN_RC2_128_CBC_EXPORT40_WITH_MD5},
107 {"des", SSL_EN_DES_64_CBC_WITH_MD5},
108 {"desede3", SSL_EN_DES_192_EDE3_CBC_WITH_MD5},
109 /* SSL3/TLS cipher suites */
110 {"rsa_rc4_128_md5", SSL_RSA_WITH_RC4_128_MD5},
111 {"rsa_rc4_128_sha", SSL_RSA_WITH_RC4_128_SHA},
112 {"rsa_3des_sha", SSL_RSA_WITH_3DES_EDE_CBC_SHA},
113 {"rsa_des_sha", SSL_RSA_WITH_DES_CBC_SHA},
114 {"rsa_rc4_40_md5", SSL_RSA_EXPORT_WITH_RC4_40_MD5},
115 {"rsa_rc2_40_md5", SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5},
116 {"rsa_null_md5", SSL_RSA_WITH_NULL_MD5},
117 {"rsa_null_sha", SSL_RSA_WITH_NULL_SHA},
118 {"fips_3des_sha", SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA},
119 {"fips_des_sha", SSL_RSA_FIPS_WITH_DES_CBC_SHA},
120 {"fortezza", SSL_FORTEZZA_DMS_WITH_FORTEZZA_CBC_SHA},
121 {"fortezza_rc4_128_sha", SSL_FORTEZZA_DMS_WITH_RC4_128_SHA},
122 {"fortezza_null", SSL_FORTEZZA_DMS_WITH_NULL_SHA},
123 /* TLS 1.0: Exportable 56-bit Cipher Suites. */
124 {"rsa_des_56_sha", TLS_RSA_EXPORT1024_WITH_DES_CBC_SHA},
125 {"rsa_rc4_56_sha", TLS_RSA_EXPORT1024_WITH_RC4_56_SHA},
127 {"dhe_dss_aes_128_cbc_sha", TLS_DHE_DSS_WITH_AES_128_CBC_SHA},
128 {"dhe_dss_aes_256_cbc_sha", TLS_DHE_DSS_WITH_AES_256_CBC_SHA},
129 {"dhe_rsa_aes_128_cbc_sha", TLS_DHE_RSA_WITH_AES_128_CBC_SHA},
130 {"dhe_rsa_aes_256_cbc_sha", TLS_DHE_RSA_WITH_AES_256_CBC_SHA},
131 {"rsa_aes_128_sha", TLS_RSA_WITH_AES_128_CBC_SHA},
132 {"rsa_aes_256_sha", TLS_RSA_WITH_AES_256_CBC_SHA},
134 {"ecdh_ecdsa_null_sha", TLS_ECDH_ECDSA_WITH_NULL_SHA},
135 {"ecdh_ecdsa_rc4_128_sha", TLS_ECDH_ECDSA_WITH_RC4_128_SHA},
136 {"ecdh_ecdsa_3des_sha", TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA},
137 {"ecdh_ecdsa_aes_128_sha", TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA},
138 {"ecdh_ecdsa_aes_256_sha", TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA},
139 {"ecdhe_ecdsa_null_sha", TLS_ECDHE_ECDSA_WITH_NULL_SHA},
140 {"ecdhe_ecdsa_rc4_128_sha", TLS_ECDHE_ECDSA_WITH_RC4_128_SHA},
141 {"ecdhe_ecdsa_3des_sha", TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA},
142 {"ecdhe_ecdsa_aes_128_sha", TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA},
143 {"ecdhe_ecdsa_aes_256_sha", TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA},
144 {"ecdh_rsa_null_sha", TLS_ECDH_RSA_WITH_NULL_SHA},
145 {"ecdh_rsa_128_sha", TLS_ECDH_RSA_WITH_RC4_128_SHA},
146 {"ecdh_rsa_3des_sha", TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA},
147 {"ecdh_rsa_aes_128_sha", TLS_ECDH_RSA_WITH_AES_128_CBC_SHA},
148 {"ecdh_rsa_aes_256_sha", TLS_ECDH_RSA_WITH_AES_256_CBC_SHA},
149 {"echde_rsa_null", TLS_ECDHE_RSA_WITH_NULL_SHA},
150 {"ecdhe_rsa_rc4_128_sha", TLS_ECDHE_RSA_WITH_RC4_128_SHA},
151 {"ecdhe_rsa_3des_sha", TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA},
152 {"ecdhe_rsa_aes_128_sha", TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA},
153 {"ecdhe_rsa_aes_256_sha", TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA},
154 {"ecdh_anon_null_sha", TLS_ECDH_anon_WITH_NULL_SHA},
155 {"ecdh_anon_rc4_128sha", TLS_ECDH_anon_WITH_RC4_128_SHA},
156 {"ecdh_anon_3des_sha", TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA},
157 {"ecdh_anon_aes_128_sha", TLS_ECDH_anon_WITH_AES_128_CBC_SHA},
158 {"ecdh_anon_aes_256_sha", TLS_ECDH_anon_WITH_AES_256_CBC_SHA},
159 #ifdef TLS_RSA_WITH_NULL_SHA256
160 /* new HMAC-SHA256 cipher suites specified in RFC */
161 {"rsa_null_sha_256", TLS_RSA_WITH_NULL_SHA256},
162 {"rsa_aes_128_cbc_sha_256", TLS_RSA_WITH_AES_128_CBC_SHA256},
163 {"rsa_aes_256_cbc_sha_256", TLS_RSA_WITH_AES_256_CBC_SHA256},
164 {"dhe_rsa_aes_128_cbc_sha_256", TLS_DHE_RSA_WITH_AES_128_CBC_SHA256},
165 {"dhe_rsa_aes_256_cbc_sha_256", TLS_DHE_RSA_WITH_AES_256_CBC_SHA256},
166 {"ecdhe_ecdsa_aes_128_cbc_sha_256", TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256},
167 {"ecdhe_rsa_aes_128_cbc_sha_256", TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256},
169 #ifdef TLS_RSA_WITH_AES_128_GCM_SHA256
170 /* AES GCM cipher suites in RFC 5288 and RFC 5289 */
171 {"rsa_aes_128_gcm_sha_256", TLS_RSA_WITH_AES_128_GCM_SHA256},
172 {"dhe_rsa_aes_128_gcm_sha_256", TLS_DHE_RSA_WITH_AES_128_GCM_SHA256},
173 {"dhe_dss_aes_128_gcm_sha_256", TLS_DHE_DSS_WITH_AES_128_GCM_SHA256},
174 {"ecdhe_ecdsa_aes_128_gcm_sha_256", TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256},
175 {"ecdh_ecdsa_aes_128_gcm_sha_256", TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256},
176 {"ecdhe_rsa_aes_128_gcm_sha_256", TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256},
177 {"ecdh_rsa_aes_128_gcm_sha_256", TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256},
181 static const char* pem_library = "libnsspem.so";
182 SECMODModule* mod = NULL;
184 /* NSPR I/O layer we use to detect blocking direction during SSL handshake */
185 static PRDescIdentity nspr_io_identity = PR_INVALID_IO_LAYER;
186 static PRIOMethods nspr_io_methods;
188 static const char* nss_error_to_name(PRErrorCode code)
190 const char *name = PR_ErrorToName(code);
194 return "unknown error";
197 static void nss_print_error_message(struct SessionHandle *data, PRUint32 err)
199 failf(data, "%s", PR_ErrorToString(err, PR_LANGUAGE_I_DEFAULT));
202 static SECStatus set_ciphers(struct SessionHandle *data, PRFileDesc * model,
206 PRBool cipher_state[NUM_OF_CIPHERS];
210 /* First disable all ciphers. This uses a different max value in case
211 * NSS adds more ciphers later we don't want them available by
214 for(i=0; i<SSL_NumImplementedCiphers; i++) {
215 SSL_CipherPrefSet(model, SSL_ImplementedCiphers[i], PR_FALSE);
218 /* Set every entry in our list to false */
219 for(i=0; i<NUM_OF_CIPHERS; i++) {
220 cipher_state[i] = PR_FALSE;
223 cipher = cipher_list;
225 while(cipher_list && (cipher_list[0])) {
226 while((*cipher) && (ISSPACE(*cipher)))
229 if((cipher_list = strchr(cipher, ','))) {
230 *cipher_list++ = '\0';
235 for(i=0; i<NUM_OF_CIPHERS; i++) {
236 if(Curl_raw_equal(cipher, cipherlist[i].name)) {
237 cipher_state[i] = PR_TRUE;
243 if(found == PR_FALSE) {
244 failf(data, "Unknown cipher in list: %s", cipher);
249 cipher = cipher_list;
253 /* Finally actually enable the selected ciphers */
254 for(i=0; i<NUM_OF_CIPHERS; i++) {
258 if(SSL_CipherPrefSet(model, cipherlist[i].num, PR_TRUE) != SECSuccess) {
259 failf(data, "cipher-suite not supported by NSS: %s", cipherlist[i].name);
268 * Get the number of ciphers that are enabled. We use this to determine
269 * if we need to call NSS_SetDomesticPolicy() to enable the default ciphers.
271 static int num_enabled_ciphers(void)
277 for(i=0; i<NUM_OF_CIPHERS; i++) {
278 SSL_CipherPolicyGet(cipherlist[i].num, &policy);
286 * Determine whether the nickname passed in is a filename that needs to
287 * be loaded as a PEM or a regular NSS nickname.
289 * returns 1 for a file
290 * returns 0 for not a file (NSS nickname)
292 static int is_file(const char *filename)
299 if(stat(filename, &st) == 0)
300 if(S_ISREG(st.st_mode))
306 /* Check if the given string is filename or nickname of a certificate. If the
307 * given string is recognized as filename, return NULL. If the given string is
308 * recognized as nickname, return a duplicated string. The returned string
309 * should be later deallocated using free(). If the OOM failure occurs, we
312 static char* dup_nickname(struct SessionHandle *data, enum dupstring cert_kind)
314 const char *str = data->set.str[cert_kind];
318 /* no such file exists, use the string as nickname */
321 /* search the last slash; we require at least one slash in a file name */
322 n = strrchr(str, '/');
324 infof(data, "warning: certificate file name \"%s\" handled as nickname; "
325 "please use \"./%s\" to force file name\n", str, str);
329 /* we'll use the PEM reader to read the certificate from file */
333 /* Call PK11_CreateGenericObject() with the given obj_class and filename. If
334 * the call succeeds, append the object handle to the list of objects so that
335 * the object can be destroyed in Curl_nss_close(). */
336 static CURLcode nss_create_object(struct ssl_connect_data *ssl,
337 CK_OBJECT_CLASS obj_class,
338 const char *filename, bool cacert)
341 PK11GenericObject *obj;
342 CK_BBOOL cktrue = CK_TRUE;
343 CK_BBOOL ckfalse = CK_FALSE;
344 CK_ATTRIBUTE attrs[/* max count of attributes */ 4];
346 CURLcode err = (cacert)
347 ? CURLE_SSL_CACERT_BADFILE
348 : CURLE_SSL_CERTPROBLEM;
350 const int slot_id = (cacert) ? 0 : 1;
351 char *slot_name = aprintf("PEM Token #%d", slot_id);
353 return CURLE_OUT_OF_MEMORY;
355 slot = PK11_FindSlotByName(slot_name);
360 PK11_SETATTRS(attrs, attr_cnt, CKA_CLASS, &obj_class, sizeof(obj_class));
361 PK11_SETATTRS(attrs, attr_cnt, CKA_TOKEN, &cktrue, sizeof(CK_BBOOL));
362 PK11_SETATTRS(attrs, attr_cnt, CKA_LABEL, (unsigned char *)filename,
363 strlen(filename) + 1);
365 if(CKO_CERTIFICATE == obj_class) {
366 CK_BBOOL *pval = (cacert) ? (&cktrue) : (&ckfalse);
367 PK11_SETATTRS(attrs, attr_cnt, CKA_TRUST, pval, sizeof(*pval));
370 obj = PK11_CreateGenericObject(slot, attrs, attr_cnt, PR_FALSE);
375 if(!Curl_llist_insert_next(ssl->obj_list, ssl->obj_list->tail, obj)) {
376 PK11_DestroyGenericObject(obj);
377 return CURLE_OUT_OF_MEMORY;
380 if(!cacert && CKO_CERTIFICATE == obj_class)
381 /* store reference to a client certificate */
382 ssl->obj_clicert = obj;
387 /* Destroy the NSS object whose handle is given by ptr. This function is
388 * a callback of Curl_llist_alloc() used by Curl_llist_destroy() to destroy
389 * NSS objects in Curl_nss_close() */
390 static void nss_destroy_object(void *user, void *ptr)
392 PK11GenericObject *obj = (PK11GenericObject *)ptr;
394 PK11_DestroyGenericObject(obj);
397 /* same as nss_destroy_object() but for CRL items */
398 static void nss_destroy_crl_item(void *user, void *ptr)
400 SECItem *crl_der = (SECItem *)ptr;
402 SECITEM_FreeItem(crl_der, PR_TRUE);
405 static CURLcode nss_load_cert(struct ssl_connect_data *ssl,
406 const char *filename, PRBool cacert)
408 CURLcode err = (cacert)
409 ? CURLE_SSL_CACERT_BADFILE
410 : CURLE_SSL_CERTPROBLEM;
412 /* libnsspem.so leaks memory if the requested file does not exist. For more
413 * details, go to <https://bugzilla.redhat.com/734760>. */
414 if(is_file(filename))
415 err = nss_create_object(ssl, CKO_CERTIFICATE, filename, cacert);
417 if(CURLE_OK == err && !cacert) {
418 /* we have successfully loaded a client certificate */
419 CERTCertificate *cert;
420 char *nickname = NULL;
421 char *n = strrchr(filename, '/');
425 /* The following undocumented magic helps to avoid a SIGSEGV on call
426 * of PK11_ReadRawAttribute() from SelectClientCert() when using an
427 * immature version of libnsspem.so. For more details, go to
428 * <https://bugzilla.redhat.com/733685>. */
429 nickname = aprintf("PEM Token #1:%s", n);
431 cert = PK11_FindCertFromNickname(nickname, NULL);
433 CERT_DestroyCertificate(cert);
442 /* add given CRL to cache if it is not already there */
443 static CURLcode nss_cache_crl(SECItem *crl_der)
445 CERTCertDBHandle *db = CERT_GetDefaultCertDB();
446 CERTSignedCrl *crl = SEC_FindCrlByDERCert(db, crl_der, 0);
448 /* CRL already cached */
450 SECITEM_FreeItem(crl_der, PR_TRUE);
451 return CURLE_SSL_CRL_BADFILE;
454 /* acquire lock before call of CERT_CacheCRL() and accessing nss_crl_list */
455 PR_Lock(nss_crllock);
457 /* store the CRL item so that we can free it in Curl_nss_cleanup() */
458 if(!Curl_llist_insert_next(nss_crl_list, nss_crl_list->tail, crl_der)) {
459 SECITEM_FreeItem(crl_der, PR_TRUE);
460 PR_Unlock(nss_crllock);
461 return CURLE_OUT_OF_MEMORY;
464 if(SECSuccess != CERT_CacheCRL(db, crl_der)) {
465 /* unable to cache CRL */
466 PR_Unlock(nss_crllock);
467 return CURLE_SSL_CRL_BADFILE;
470 /* we need to clear session cache, so that the CRL could take effect */
471 SSL_ClearSessionCache();
472 PR_Unlock(nss_crllock);
476 static CURLcode nss_load_crl(const char* crlfilename)
480 SECItem filedata = { 0, NULL, 0 };
481 SECItem *crl_der = NULL;
484 infile = PR_Open(crlfilename, PR_RDONLY, 0);
486 return CURLE_SSL_CRL_BADFILE;
488 if(PR_SUCCESS != PR_GetOpenFileInfo(infile, &info))
491 if(!SECITEM_AllocItem(NULL, &filedata, info.size + /* zero ended */ 1))
494 if(info.size != PR_Read(infile, filedata.data, info.size))
497 crl_der = SECITEM_AllocItem(NULL, NULL, 0U);
501 /* place a trailing zero right after the visible data */
502 body = (char*)filedata.data;
503 body[--filedata.len] = '\0';
505 body = strstr(body, "-----BEGIN");
509 char *begin = PORT_Strchr(body, '\n');
511 begin = PORT_Strchr(body, '\r');
515 trailer = strstr(++begin, "-----END");
519 /* retrieve DER from ASCII */
521 if(ATOB_ConvertAsciiToItem(crl_der, begin))
524 SECITEM_FreeItem(&filedata, PR_FALSE);
531 return nss_cache_crl(crl_der);
535 SECITEM_FreeItem(crl_der, PR_TRUE);
536 SECITEM_FreeItem(&filedata, PR_FALSE);
537 return CURLE_SSL_CRL_BADFILE;
540 static CURLcode nss_load_key(struct connectdata *conn, int sockindex,
546 struct ssl_connect_data *ssl = conn->ssl;
547 (void)sockindex; /* unused */
549 rv = nss_create_object(ssl, CKO_PRIVATE_KEY, key_file, FALSE);
551 PR_SetError(SEC_ERROR_BAD_KEY, 0);
555 slot = PK11_FindSlotByName("PEM Token #1");
557 return CURLE_SSL_CERTPROBLEM;
559 /* This will force the token to be seen as re-inserted */
560 SECMOD_WaitForAnyTokenEvent(mod, 0, 0);
561 PK11_IsPresent(slot);
563 status = PK11_Authenticate(slot, PR_TRUE,
564 conn->data->set.str[STRING_KEY_PASSWD]);
566 return (SECSuccess == status)
568 : CURLE_SSL_CERTPROBLEM;
571 static int display_error(struct connectdata *conn, PRInt32 err,
572 const char *filename)
575 case SEC_ERROR_BAD_PASSWORD:
576 failf(conn->data, "Unable to load client key: Incorrect password");
578 case SEC_ERROR_UNKNOWN_CERT:
579 failf(conn->data, "Unable to load certificate %s", filename);
584 return 0; /* The caller will print a generic error */
587 static CURLcode cert_stuff(struct connectdata *conn, int sockindex,
588 char *cert_file, char *key_file)
590 struct SessionHandle *data = conn->data;
594 rv = nss_load_cert(&conn->ssl[sockindex], cert_file, PR_FALSE);
596 const PRErrorCode err = PR_GetError();
597 if(!display_error(conn, err, cert_file)) {
598 const char *err_name = nss_error_to_name(err);
599 failf(data, "unable to load client cert: %d (%s)", err, err_name);
606 if(key_file || (is_file(cert_file))) {
608 rv = nss_load_key(conn, sockindex, key_file);
610 /* In case the cert file also has the key */
611 rv = nss_load_key(conn, sockindex, cert_file);
613 const PRErrorCode err = PR_GetError();
614 if(!display_error(conn, err, key_file)) {
615 const char *err_name = nss_error_to_name(err);
616 failf(data, "unable to load client key: %d (%s)", err, err_name);
626 static char * nss_get_password(PK11SlotInfo * slot, PRBool retry, void *arg)
628 (void)slot; /* unused */
629 if(retry || NULL == arg)
632 return (char *)PORT_Strdup((char *)arg);
635 /* bypass the default SSL_AuthCertificate() hook in case we do not want to
637 static SECStatus nss_auth_cert_hook(void *arg, PRFileDesc *fd, PRBool checksig,
640 struct connectdata *conn = (struct connectdata *)arg;
641 if(!conn->data->set.ssl.verifypeer) {
642 infof(conn->data, "skipping SSL peer certificate verification\n");
646 return SSL_AuthCertificate(CERT_GetDefaultCertDB(), fd, checksig, isServer);
650 * Inform the application that the handshake is complete.
652 static void HandshakeCallback(PRFileDesc *sock, void *arg)
655 struct connectdata *conn = (struct connectdata*) arg;
656 unsigned int buflenmax = 50;
657 unsigned char buf[50];
659 SSLNextProtoState state;
661 if(!conn->data->set.ssl_enable_npn && !conn->data->set.ssl_enable_alpn) {
665 if(SSL_GetNextProto(sock, &state, buf, &buflen, buflenmax) == SECSuccess) {
668 case SSL_NEXT_PROTO_NO_SUPPORT:
669 case SSL_NEXT_PROTO_NO_OVERLAP:
670 infof(conn->data, "TLS, neither ALPN nor NPN succeeded\n");
672 #ifdef SSL_ENABLE_ALPN
673 case SSL_NEXT_PROTO_SELECTED:
674 infof(conn->data, "ALPN, server accepted to use %.*s\n", buflen, buf);
677 case SSL_NEXT_PROTO_NEGOTIATED:
678 infof(conn->data, "NPN, server accepted to use %.*s\n", buflen, buf);
682 if(buflen == NGHTTP2_PROTO_VERSION_ID_LEN &&
683 memcmp(NGHTTP2_PROTO_VERSION_ID, buf, NGHTTP2_PROTO_VERSION_ID_LEN)
685 conn->negnpn = NPN_HTTP2;
687 else if(buflen == ALPN_HTTP_1_1_LENGTH && memcmp(ALPN_HTTP_1_1, buf,
688 ALPN_HTTP_1_1_LENGTH)) {
689 conn->negnpn = NPN_HTTP1_1;
698 static void display_cert_info(struct SessionHandle *data,
699 CERTCertificate *cert)
701 char *subject, *issuer, *common_name;
702 PRExplodedTime printableTime;
703 char timeString[256];
704 PRTime notBefore, notAfter;
706 subject = CERT_NameToAscii(&cert->subject);
707 issuer = CERT_NameToAscii(&cert->issuer);
708 common_name = CERT_GetCommonName(&cert->subject);
709 infof(data, "\tsubject: %s\n", subject);
711 CERT_GetCertTimes(cert, ¬Before, ¬After);
712 PR_ExplodeTime(notBefore, PR_GMTParameters, &printableTime);
713 PR_FormatTime(timeString, 256, "%b %d %H:%M:%S %Y GMT", &printableTime);
714 infof(data, "\tstart date: %s\n", timeString);
715 PR_ExplodeTime(notAfter, PR_GMTParameters, &printableTime);
716 PR_FormatTime(timeString, 256, "%b %d %H:%M:%S %Y GMT", &printableTime);
717 infof(data, "\texpire date: %s\n", timeString);
718 infof(data, "\tcommon name: %s\n", common_name);
719 infof(data, "\tissuer: %s\n", issuer);
723 PR_Free(common_name);
726 static void display_conn_info(struct connectdata *conn, PRFileDesc *sock)
728 SSLChannelInfo channel;
729 SSLCipherSuiteInfo suite;
730 CERTCertificate *cert;
731 CERTCertificate *cert2;
732 CERTCertificate *cert3;
736 if(SSL_GetChannelInfo(sock, &channel, sizeof channel) ==
737 SECSuccess && channel.length == sizeof channel &&
738 channel.cipherSuite) {
739 if(SSL_GetCipherSuiteInfo(channel.cipherSuite,
740 &suite, sizeof suite) == SECSuccess) {
741 infof(conn->data, "SSL connection using %s\n", suite.cipherSuiteName);
745 cert = SSL_PeerCertificate(sock);
748 infof(conn->data, "Server certificate:\n");
750 if(!conn->data->set.ssl.certinfo) {
751 display_cert_info(conn->data, cert);
752 CERT_DestroyCertificate(cert);
755 /* Count certificates in chain. */
759 cert2 = CERT_FindCertIssuer(cert, now, certUsageSSLCA);
763 CERT_DestroyCertificate(cert2);
766 cert3 = CERT_FindCertIssuer(cert2, now, certUsageSSLCA);
767 CERT_DestroyCertificate(cert2);
771 Curl_ssl_init_certinfo(conn->data, i);
772 for(i = 0; cert; cert = cert2) {
773 Curl_extract_certinfo(conn, i++, (char *)cert->derCert.data,
774 (char *)cert->derCert.data + cert->derCert.len);
776 CERT_DestroyCertificate(cert);
779 cert2 = CERT_FindCertIssuer(cert, now, certUsageSSLCA);
780 CERT_DestroyCertificate(cert);
788 static SECStatus BadCertHandler(void *arg, PRFileDesc *sock)
790 struct connectdata *conn = (struct connectdata *)arg;
791 struct SessionHandle *data = conn->data;
792 PRErrorCode err = PR_GetError();
793 CERTCertificate *cert;
795 /* remember the cert verification result */
796 data->set.ssl.certverifyresult = err;
798 if(err == SSL_ERROR_BAD_CERT_DOMAIN && !data->set.ssl.verifyhost)
799 /* we are asked not to verify the host name */
802 /* print only info about the cert, the error is printed off the callback */
803 cert = SSL_PeerCertificate(sock);
805 infof(data, "Server certificate:\n");
806 display_cert_info(data, cert);
807 CERT_DestroyCertificate(cert);
815 * Check that the Peer certificate's issuer certificate matches the one found
816 * by issuer_nickname. This is not exactly the way OpenSSL and GNU TLS do the
817 * issuer check, so we provide comments that mimic the OpenSSL
818 * X509_check_issued function (in x509v3/v3_purp.c)
820 static SECStatus check_issuer_cert(PRFileDesc *sock,
821 char *issuer_nickname)
823 CERTCertificate *cert,*cert_issuer,*issuer;
824 SECStatus res=SECSuccess;
825 void *proto_win = NULL;
828 PRArenaPool *tmpArena = NULL;
829 CERTAuthKeyID *authorityKeyID = NULL;
830 SECITEM *caname = NULL;
833 cert = SSL_PeerCertificate(sock);
834 cert_issuer = CERT_FindCertIssuer(cert,PR_Now(),certUsageObjectSigner);
836 proto_win = SSL_RevealPinArg(sock);
837 issuer = PK11_FindCertFromNickname(issuer_nickname, proto_win);
839 if((!cert_issuer) || (!issuer))
841 else if(SECITEM_CompareItem(&cert_issuer->derCert,
842 &issuer->derCert)!=SECEqual)
845 CERT_DestroyCertificate(cert);
846 CERT_DestroyCertificate(issuer);
847 CERT_DestroyCertificate(cert_issuer);
853 * Callback to pick the SSL client certificate.
855 static SECStatus SelectClientCert(void *arg, PRFileDesc *sock,
856 struct CERTDistNamesStr *caNames,
857 struct CERTCertificateStr **pRetCert,
858 struct SECKEYPrivateKeyStr **pRetKey)
860 struct ssl_connect_data *connssl = (struct ssl_connect_data *)arg;
861 struct SessionHandle *data = connssl->data;
862 const char *nickname = connssl->client_nickname;
864 if(connssl->obj_clicert) {
865 /* use the cert/key provided by PEM reader */
866 static const char pem_slotname[] = "PEM Token #1";
867 SECItem cert_der = { 0, NULL, 0 };
868 void *proto_win = SSL_RevealPinArg(sock);
869 struct CERTCertificateStr *cert;
870 struct SECKEYPrivateKeyStr *key;
872 PK11SlotInfo *slot = PK11_FindSlotByName(pem_slotname);
874 failf(data, "NSS: PK11 slot not found: %s", pem_slotname);
878 if(PK11_ReadRawAttribute(PK11_TypeGeneric, connssl->obj_clicert, CKA_VALUE,
879 &cert_der) != SECSuccess) {
880 failf(data, "NSS: CKA_VALUE not found in PK11 generic object");
885 cert = PK11_FindCertFromDERCertItem(slot, &cert_der, proto_win);
886 SECITEM_FreeItem(&cert_der, PR_FALSE);
888 failf(data, "NSS: client certificate from file not found");
893 key = PK11_FindPrivateKeyFromCert(slot, cert, NULL);
896 failf(data, "NSS: private key from file not found");
897 CERT_DestroyCertificate(cert);
901 infof(data, "NSS: client certificate from file\n");
902 display_cert_info(data, cert);
909 /* use the default NSS hook */
910 if(SECSuccess != NSS_GetClientAuthData((void *)nickname, sock, caNames,
912 || NULL == *pRetCert) {
915 failf(data, "NSS: client certificate not found (nickname not "
918 failf(data, "NSS: client certificate not found: %s", nickname);
923 /* get certificate nickname if any */
924 nickname = (*pRetCert)->nickname;
926 nickname = "[unknown]";
928 if(NULL == *pRetKey) {
929 failf(data, "NSS: private key not found for certificate: %s", nickname);
933 infof(data, "NSS: using client certificate: %s\n", nickname);
934 display_cert_info(data, *pRetCert);
938 /* This function is supposed to decide, which error codes should be used
939 * to conclude server is TLS intolerant.
941 * taken from xulrunner - nsNSSIOLayer.cpp
944 isTLSIntoleranceError(PRInt32 err)
947 case SSL_ERROR_BAD_MAC_ALERT:
948 case SSL_ERROR_BAD_MAC_READ:
949 case SSL_ERROR_HANDSHAKE_FAILURE_ALERT:
950 case SSL_ERROR_HANDSHAKE_UNEXPECTED_ALERT:
951 case SSL_ERROR_CLIENT_KEY_EXCHANGE_FAILURE:
952 case SSL_ERROR_ILLEGAL_PARAMETER_ALERT:
953 case SSL_ERROR_NO_CYPHER_OVERLAP:
954 case SSL_ERROR_BAD_SERVER:
955 case SSL_ERROR_BAD_BLOCK_PADDING:
956 case SSL_ERROR_UNSUPPORTED_VERSION:
957 case SSL_ERROR_PROTOCOL_VERSION_ALERT:
958 case SSL_ERROR_RX_MALFORMED_FINISHED:
959 case SSL_ERROR_BAD_HANDSHAKE_HASH_VALUE:
960 case SSL_ERROR_DECODE_ERROR_ALERT:
961 case SSL_ERROR_RX_UNKNOWN_ALERT:
968 /* update blocking direction in case of PR_WOULD_BLOCK_ERROR */
969 static void nss_update_connecting_state(ssl_connect_state state, void *secret)
971 struct ssl_connect_data *connssl = (struct ssl_connect_data *)secret;
972 if(PR_GetError() != PR_WOULD_BLOCK_ERROR)
973 /* an unrelated error is passing by */
976 switch(connssl->connecting_state) {
978 case ssl_connect_2_reading:
979 case ssl_connect_2_writing:
982 /* we are not called from an SSL handshake */
986 /* update the state accordingly */
987 connssl->connecting_state = state;
990 /* recv() wrapper we use to detect blocking direction during SSL handshake */
991 static PRInt32 nspr_io_recv(PRFileDesc *fd, void *buf, PRInt32 amount,
992 PRIntn flags, PRIntervalTime timeout)
994 const PRRecvFN recv_fn = fd->lower->methods->recv;
995 const PRInt32 rv = recv_fn(fd->lower, buf, amount, flags, timeout);
997 /* check for PR_WOULD_BLOCK_ERROR and update blocking direction */
998 nss_update_connecting_state(ssl_connect_2_reading, fd->secret);
1002 /* send() wrapper we use to detect blocking direction during SSL handshake */
1003 static PRInt32 nspr_io_send(PRFileDesc *fd, const void *buf, PRInt32 amount,
1004 PRIntn flags, PRIntervalTime timeout)
1006 const PRSendFN send_fn = fd->lower->methods->send;
1007 const PRInt32 rv = send_fn(fd->lower, buf, amount, flags, timeout);
1009 /* check for PR_WOULD_BLOCK_ERROR and update blocking direction */
1010 nss_update_connecting_state(ssl_connect_2_writing, fd->secret);
1014 /* close() wrapper to avoid assertion failure due to fd->secret != NULL */
1015 static PRStatus nspr_io_close(PRFileDesc *fd)
1017 const PRCloseFN close_fn = PR_GetDefaultIOMethods()->close;
1019 return close_fn(fd);
1022 static CURLcode nss_init_core(struct SessionHandle *data, const char *cert_dir)
1024 NSSInitParameters initparams;
1026 if(nss_context != NULL)
1029 memset((void *) &initparams, '\0', sizeof(initparams));
1030 initparams.length = sizeof(initparams);
1033 const bool use_sql = NSS_VersionCheck("3.12.0");
1034 char *certpath = aprintf("%s%s", use_sql ? "sql:" : "", cert_dir);
1036 return CURLE_OUT_OF_MEMORY;
1038 infof(data, "Initializing NSS with certpath: %s\n", certpath);
1039 nss_context = NSS_InitContext(certpath, "", "", "", &initparams,
1040 NSS_INIT_READONLY | NSS_INIT_PK11RELOAD);
1043 if(nss_context != NULL)
1046 infof(data, "Unable to initialize NSS database\n");
1049 infof(data, "Initializing NSS with certpath: none\n");
1050 nss_context = NSS_InitContext("", "", "", "", &initparams, NSS_INIT_READONLY
1051 | NSS_INIT_NOCERTDB | NSS_INIT_NOMODDB | NSS_INIT_FORCEOPEN
1052 | NSS_INIT_NOROOTINIT | NSS_INIT_OPTIMIZESPACE | NSS_INIT_PK11RELOAD);
1053 if(nss_context != NULL)
1056 infof(data, "Unable to initialize NSS\n");
1057 return CURLE_SSL_CACERT_BADFILE;
1060 static CURLcode nss_init(struct SessionHandle *data)
1069 /* list of all CRL items we need to destroy in Curl_nss_cleanup() */
1070 nss_crl_list = Curl_llist_alloc(nss_destroy_crl_item);
1072 return CURLE_OUT_OF_MEMORY;
1074 /* First we check if $SSL_DIR points to a valid dir */
1075 cert_dir = getenv("SSL_DIR");
1077 if((stat(cert_dir, &st) != 0) ||
1078 (!S_ISDIR(st.st_mode))) {
1083 /* Now we check if the default location is a valid dir */
1085 if((stat(SSL_DIR, &st) == 0) &&
1086 (S_ISDIR(st.st_mode))) {
1087 cert_dir = (char *)SSL_DIR;
1091 if(nspr_io_identity == PR_INVALID_IO_LAYER) {
1092 /* allocate an identity for our own NSPR I/O layer */
1093 nspr_io_identity = PR_GetUniqueIdentity("libcurl");
1094 if(nspr_io_identity == PR_INVALID_IO_LAYER)
1095 return CURLE_OUT_OF_MEMORY;
1097 /* the default methods just call down to the lower I/O layer */
1098 memcpy(&nspr_io_methods, PR_GetDefaultIOMethods(), sizeof nspr_io_methods);
1100 /* override certain methods in the table by our wrappers */
1101 nspr_io_methods.recv = nspr_io_recv;
1102 nspr_io_methods.send = nspr_io_send;
1103 nspr_io_methods.close = nspr_io_close;
1106 rv = nss_init_core(data, cert_dir);
1110 if(num_enabled_ciphers() == 0)
1111 NSS_SetDomesticPolicy();
1120 * @retval 0 error initializing SSL
1121 * @retval 1 SSL initialized successfully
1123 int Curl_nss_init(void)
1125 /* curl_global_init() is not thread-safe so this test is ok */
1126 if(nss_initlock == NULL) {
1127 PR_Init(PR_USER_THREAD, PR_PRIORITY_NORMAL, 256);
1128 nss_initlock = PR_NewLock();
1129 nss_crllock = PR_NewLock();
1132 /* We will actually initialize NSS later */
1137 CURLcode Curl_nss_force_init(struct SessionHandle *data)
1142 "unable to initialize NSS, curl_global_init() should have been "
1143 "called with CURL_GLOBAL_SSL or CURL_GLOBAL_ALL");
1144 return CURLE_FAILED_INIT;
1147 PR_Lock(nss_initlock);
1148 rv = nss_init(data);
1149 PR_Unlock(nss_initlock);
1153 /* Global cleanup */
1154 void Curl_nss_cleanup(void)
1156 /* This function isn't required to be threadsafe and this is only done
1157 * as a safety feature.
1159 PR_Lock(nss_initlock);
1161 /* Free references to client certificates held in the SSL session cache.
1162 * Omitting this hampers destruction of the security module owning
1163 * the certificates. */
1164 SSL_ClearSessionCache();
1166 if(mod && SECSuccess == SECMOD_UnloadUserModule(mod)) {
1167 SECMOD_DestroyModule(mod);
1170 NSS_ShutdownContext(nss_context);
1174 /* destroy all CRL items */
1175 Curl_llist_destroy(nss_crl_list, NULL);
1176 nss_crl_list = NULL;
1178 PR_Unlock(nss_initlock);
1180 PR_DestroyLock(nss_initlock);
1181 PR_DestroyLock(nss_crllock);
1182 nss_initlock = NULL;
1188 * This function uses SSL_peek to determine connection status.
1191 * 1 means the connection is still in place
1192 * 0 means the connection has been closed
1193 * -1 means the connection status is unknown
1196 Curl_nss_check_cxn(struct connectdata *conn)
1202 PR_Recv(conn->ssl[FIRSTSOCKET].handle, (void *)&buf, 1, PR_MSG_PEEK,
1203 PR_SecondsToInterval(1));
1205 return 1; /* connection still in place */
1208 return 0; /* connection has been closed */
1210 return -1; /* connection status unknown */
1214 * This function is called when an SSL connection is closed.
1216 void Curl_nss_close(struct connectdata *conn, int sockindex)
1218 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1220 if(connssl->handle) {
1221 /* NSS closes the socket we previously handed to it, so we must mark it
1222 as closed to avoid double close */
1223 fake_sclose(conn->sock[sockindex]);
1224 conn->sock[sockindex] = CURL_SOCKET_BAD;
1226 if((connssl->client_nickname != NULL) || (connssl->obj_clicert != NULL))
1227 /* A server might require different authentication based on the
1228 * particular path being requested by the client. To support this
1229 * scenario, we must ensure that a connection will never reuse the
1230 * authentication data from a previous connection. */
1231 SSL_InvalidateSession(connssl->handle);
1233 if(connssl->client_nickname != NULL) {
1234 free(connssl->client_nickname);
1235 connssl->client_nickname = NULL;
1237 /* destroy all NSS objects in order to avoid failure of NSS shutdown */
1238 Curl_llist_destroy(connssl->obj_list, NULL);
1239 connssl->obj_list = NULL;
1240 connssl->obj_clicert = NULL;
1242 PR_Close(connssl->handle);
1243 connssl->handle = NULL;
1248 * This function is called when the 'data' struct is going away. Close
1249 * down everything and free all resources!
1251 int Curl_nss_close_all(struct SessionHandle *data)
1257 /* return true if NSS can provide error code (and possibly msg) for the
1259 static bool is_nss_error(CURLcode err)
1262 case CURLE_PEER_FAILED_VERIFICATION:
1263 case CURLE_SSL_CACERT:
1264 case CURLE_SSL_CERTPROBLEM:
1265 case CURLE_SSL_CONNECT_ERROR:
1266 case CURLE_SSL_ISSUER_ERROR:
1274 /* return true if the given error code is related to a client certificate */
1275 static bool is_cc_error(PRInt32 err)
1278 case SSL_ERROR_BAD_CERT_ALERT:
1279 case SSL_ERROR_EXPIRED_CERT_ALERT:
1280 case SSL_ERROR_REVOKED_CERT_ALERT:
1288 static Curl_recv nss_recv;
1289 static Curl_send nss_send;
1291 static CURLcode nss_load_ca_certificates(struct connectdata *conn,
1294 struct SessionHandle *data = conn->data;
1295 const char *cafile = data->set.ssl.CAfile;
1296 const char *capath = data->set.ssl.CApath;
1299 CURLcode rv = nss_load_cert(&conn->ssl[sockindex], cafile, PR_TRUE);
1306 if(stat(capath, &st) == -1)
1307 return CURLE_SSL_CACERT_BADFILE;
1309 if(S_ISDIR(st.st_mode)) {
1311 PRDir *dir = PR_OpenDir(capath);
1313 return CURLE_SSL_CACERT_BADFILE;
1315 while((entry = PR_ReadDir(dir, PR_SKIP_BOTH | PR_SKIP_HIDDEN))) {
1316 char *fullpath = aprintf("%s/%s", capath, entry->name);
1319 return CURLE_OUT_OF_MEMORY;
1322 if(CURLE_OK != nss_load_cert(&conn->ssl[sockindex], fullpath, PR_TRUE))
1323 /* This is purposefully tolerant of errors so non-PEM files can
1324 * be in the same directory */
1325 infof(data, "failed to load '%s' from CURLOPT_CAPATH\n", fullpath);
1333 infof(data, "warning: CURLOPT_CAPATH not a directory (%s)\n", capath);
1336 infof(data, " CAfile: %s\n CApath: %s\n",
1337 cafile ? cafile : "none",
1338 capath ? capath : "none");
1343 static CURLcode nss_init_sslver(SSLVersionRange *sslver,
1344 struct SessionHandle *data)
1346 switch (data->set.ssl.version) {
1348 case CURL_SSLVERSION_DEFAULT:
1349 sslver->min = SSL_LIBRARY_VERSION_3_0;
1350 if(data->state.ssl_connect_retry) {
1351 infof(data, "TLS disabled due to previous handshake failure\n");
1352 sslver->max = SSL_LIBRARY_VERSION_3_0;
1355 /* intentional fall-through to default to highest TLS version if possible */
1357 case CURL_SSLVERSION_TLSv1:
1358 #ifdef SSL_LIBRARY_VERSION_TLS_1_2
1359 sslver->max = SSL_LIBRARY_VERSION_TLS_1_2;
1360 #elif defined SSL_LIBRARY_VERSION_TLS_1_1
1361 sslver->max = SSL_LIBRARY_VERSION_TLS_1_1;
1363 sslver->max = SSL_LIBRARY_VERSION_TLS_1_0;
1367 case CURL_SSLVERSION_SSLv2:
1368 sslver->min = SSL_LIBRARY_VERSION_2;
1369 sslver->max = SSL_LIBRARY_VERSION_2;
1372 case CURL_SSLVERSION_SSLv3:
1373 sslver->min = SSL_LIBRARY_VERSION_3_0;
1374 sslver->max = SSL_LIBRARY_VERSION_3_0;
1377 case CURL_SSLVERSION_TLSv1_0:
1378 sslver->min = SSL_LIBRARY_VERSION_TLS_1_0;
1379 sslver->max = SSL_LIBRARY_VERSION_TLS_1_0;
1382 case CURL_SSLVERSION_TLSv1_1:
1383 #ifdef SSL_LIBRARY_VERSION_TLS_1_1
1384 sslver->min = SSL_LIBRARY_VERSION_TLS_1_1;
1385 sslver->max = SSL_LIBRARY_VERSION_TLS_1_1;
1390 case CURL_SSLVERSION_TLSv1_2:
1391 #ifdef SSL_LIBRARY_VERSION_TLS_1_2
1392 sslver->min = SSL_LIBRARY_VERSION_TLS_1_2;
1393 sslver->max = SSL_LIBRARY_VERSION_TLS_1_2;
1399 failf(data, "TLS minor version cannot be set");
1400 return CURLE_SSL_CONNECT_ERROR;
1403 static CURLcode nss_fail_connect(struct ssl_connect_data *connssl,
1404 struct SessionHandle *data,
1407 SSLVersionRange sslver;
1408 PRErrorCode err = 0;
1410 /* reset the flag to avoid an infinite loop */
1411 data->state.ssl_connect_retry = FALSE;
1413 if(is_nss_error(curlerr)) {
1414 /* read NSPR error code */
1415 err = PR_GetError();
1416 if(is_cc_error(err))
1417 curlerr = CURLE_SSL_CERTPROBLEM;
1419 /* print the error number and error string */
1420 infof(data, "NSS error %d (%s)\n", err, nss_error_to_name(err));
1422 /* print a human-readable message describing the error if available */
1423 nss_print_error_message(data, err);
1426 /* cleanup on connection failure */
1427 Curl_llist_destroy(connssl->obj_list, NULL);
1428 connssl->obj_list = NULL;
1431 && (SSL_VersionRangeGet(connssl->handle, &sslver) == SECSuccess)
1432 && (sslver.min == SSL_LIBRARY_VERSION_3_0)
1433 && (sslver.max != SSL_LIBRARY_VERSION_3_0)
1434 && isTLSIntoleranceError(err)) {
1435 /* schedule reconnect through Curl_retry_request() */
1436 data->state.ssl_connect_retry = TRUE;
1437 infof(data, "Error in TLS handshake, trying SSLv3...\n");
1444 /* Switch the SSL socket into non-blocking mode. */
1445 static CURLcode nss_set_nonblock(struct ssl_connect_data *connssl,
1446 struct SessionHandle *data)
1448 static PRSocketOptionData sock_opt;
1449 sock_opt.option = PR_SockOpt_Nonblocking;
1450 sock_opt.value.non_blocking = PR_TRUE;
1452 if(PR_SetSocketOption(connssl->handle, &sock_opt) != PR_SUCCESS)
1453 return nss_fail_connect(connssl, data, CURLE_SSL_CONNECT_ERROR);
1458 static CURLcode nss_setup_connect(struct connectdata *conn, int sockindex)
1460 PRFileDesc *model = NULL;
1461 PRFileDesc *nspr_io = NULL;
1462 PRFileDesc *nspr_io_stub = NULL;
1463 PRBool ssl_no_cache;
1464 PRBool ssl_cbc_random_iv;
1465 struct SessionHandle *data = conn->data;
1466 curl_socket_t sockfd = conn->sock[sockindex];
1467 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1470 SSLVersionRange sslver = {
1471 SSL_LIBRARY_VERSION_TLS_1_0, /* min */
1472 SSL_LIBRARY_VERSION_TLS_1_0 /* max */
1476 #if defined(SSL_ENABLE_NPN) || defined(SSL_ENABLE_ALPN)
1477 unsigned int alpn_protos_len = NGHTTP2_PROTO_VERSION_ID_LEN +
1478 ALPN_HTTP_1_1_LENGTH + 2;
1479 unsigned char alpn_protos[NGHTTP2_PROTO_VERSION_ID_LEN + ALPN_HTTP_1_1_LENGTH
1486 if(connssl->state == ssl_connection_complete)
1489 connssl->data = data;
1491 /* list of all NSS objects we need to destroy in Curl_nss_close() */
1492 connssl->obj_list = Curl_llist_alloc(nss_destroy_object);
1493 if(!connssl->obj_list)
1494 return CURLE_OUT_OF_MEMORY;
1496 /* FIXME. NSS doesn't support multiple databases open at the same time. */
1497 PR_Lock(nss_initlock);
1498 curlerr = nss_init(conn->data);
1499 if(CURLE_OK != curlerr) {
1500 PR_Unlock(nss_initlock);
1504 curlerr = CURLE_SSL_CONNECT_ERROR;
1507 char *configstring = aprintf("library=%s name=PEM", pem_library);
1509 PR_Unlock(nss_initlock);
1512 mod = SECMOD_LoadUserModule(configstring, NULL, PR_FALSE);
1515 if(!mod || !mod->loaded) {
1517 SECMOD_DestroyModule(mod);
1520 infof(data, "WARNING: failed to load NSS PEM library %s. Using "
1521 "OpenSSL PEM certificates will not work.\n", pem_library);
1525 PK11_SetPasswordFunc(nss_get_password);
1526 PR_Unlock(nss_initlock);
1528 model = PR_NewTCPSocket();
1531 model = SSL_ImportFD(NULL, model);
1533 if(SSL_OptionSet(model, SSL_SECURITY, PR_TRUE) != SECSuccess)
1535 if(SSL_OptionSet(model, SSL_HANDSHAKE_AS_SERVER, PR_FALSE) != SECSuccess)
1537 if(SSL_OptionSet(model, SSL_HANDSHAKE_AS_CLIENT, PR_TRUE) != SECSuccess)
1540 /* do not use SSL cache if disabled or we are not going to verify peer */
1541 ssl_no_cache = (conn->ssl_config.sessionid && data->set.ssl.verifypeer) ?
1543 if(SSL_OptionSet(model, SSL_NO_CACHE, ssl_no_cache) != SECSuccess)
1546 /* enable/disable the requested SSL version(s) */
1547 if(nss_init_sslver(&sslver, data) != CURLE_OK)
1549 if(SSL_VersionRangeSet(model, &sslver) != SECSuccess)
1552 ssl_cbc_random_iv = !data->set.ssl_enable_beast;
1553 #ifdef SSL_CBC_RANDOM_IV
1554 /* unless the user explicitly asks to allow the protocol vulnerability, we
1555 use the work-around */
1556 if(SSL_OptionSet(model, SSL_CBC_RANDOM_IV, ssl_cbc_random_iv) != SECSuccess)
1557 infof(data, "warning: failed to set SSL_CBC_RANDOM_IV = %d\n",
1560 if(ssl_cbc_random_iv)
1561 infof(data, "warning: support for SSL_CBC_RANDOM_IV not compiled in\n");
1564 /* reset the flag to avoid an infinite loop */
1565 data->state.ssl_connect_retry = FALSE;
1567 if(data->set.ssl.cipher_list) {
1568 if(set_ciphers(data, model, data->set.ssl.cipher_list) != SECSuccess) {
1569 curlerr = CURLE_SSL_CIPHER;
1574 if(!data->set.ssl.verifypeer && data->set.ssl.verifyhost)
1575 infof(data, "warning: ignoring value of ssl.verifyhost\n");
1577 /* bypass the default SSL_AuthCertificate() hook in case we do not want to
1579 if(SSL_AuthCertificateHook(model, nss_auth_cert_hook, conn) != SECSuccess)
1582 data->set.ssl.certverifyresult=0; /* not checked yet */
1583 if(SSL_BadCertHook(model, BadCertHandler, conn) != SECSuccess)
1586 if(SSL_HandshakeCallback(model, HandshakeCallback, conn) != SECSuccess)
1589 if(data->set.ssl.verifypeer) {
1590 const CURLcode rv = nss_load_ca_certificates(conn, sockindex);
1591 if(CURLE_OK != rv) {
1597 if(data->set.ssl.CRLfile) {
1598 const CURLcode rv = nss_load_crl(data->set.ssl.CRLfile);
1599 if(CURLE_OK != rv) {
1603 infof(data, " CRLfile: %s\n", data->set.ssl.CRLfile);
1606 if(data->set.str[STRING_CERT]) {
1607 char *nickname = dup_nickname(data, STRING_CERT);
1609 /* we are not going to use libnsspem.so to read the client cert */
1610 connssl->obj_clicert = NULL;
1613 CURLcode rv = cert_stuff(conn, sockindex, data->set.str[STRING_CERT],
1614 data->set.str[STRING_KEY]);
1615 if(CURLE_OK != rv) {
1616 /* failf() is already done in cert_stuff() */
1622 /* store the nickname for SelectClientCert() called during handshake */
1623 connssl->client_nickname = nickname;
1626 connssl->client_nickname = NULL;
1628 if(SSL_GetClientAuthDataHook(model, SelectClientCert,
1629 (void *)connssl) != SECSuccess) {
1630 curlerr = CURLE_SSL_CERTPROBLEM;
1634 /* wrap OS file descriptor by NSPR's file descriptor abstraction */
1635 nspr_io = PR_ImportTCPSocket(sockfd);
1639 /* create our own NSPR I/O layer */
1640 nspr_io_stub = PR_CreateIOLayerStub(nspr_io_identity, &nspr_io_methods);
1646 /* make the per-connection data accessible from NSPR I/O callbacks */
1647 nspr_io_stub->secret = (void *)connssl;
1649 /* push our new layer to the NSPR I/O stack */
1650 if(PR_PushIOLayer(nspr_io, PR_TOP_IO_LAYER, nspr_io_stub) != PR_SUCCESS) {
1652 PR_Close(nspr_io_stub);
1656 /* import our model socket onto the current I/O stack */
1657 connssl->handle = SSL_ImportFD(model, nspr_io);
1658 if(!connssl->handle) {
1663 PR_Close(model); /* We don't need this any more */
1666 /* This is the password associated with the cert that we're using */
1667 if(data->set.str[STRING_KEY_PASSWD]) {
1668 SSL_SetPKCS11PinArg(connssl->handle, data->set.str[STRING_KEY_PASSWD]);
1672 if(data->set.httpversion == CURL_HTTP_VERSION_2_0) {
1673 #ifdef SSL_ENABLE_NPN
1674 if(data->set.ssl_enable_npn) {
1675 if(SSL_OptionSet(connssl->handle, SSL_ENABLE_NPN, PR_TRUE) != SECSuccess)
1680 #ifdef SSL_ENABLE_ALPN
1681 if(data->set.ssl_enable_alpn) {
1682 if(SSL_OptionSet(connssl->handle, SSL_ENABLE_ALPN, PR_TRUE)
1688 #if defined(SSL_ENABLE_NPN) || defined(SSL_ENABLE_ALPN)
1689 if(data->set.ssl_enable_npn || data->set.ssl_enable_alpn) {
1690 alpn_protos[cur] = NGHTTP2_PROTO_VERSION_ID_LEN;
1692 memcpy(&alpn_protos[cur], NGHTTP2_PROTO_VERSION_ID,
1693 NGHTTP2_PROTO_VERSION_ID_LEN);
1694 cur += NGHTTP2_PROTO_VERSION_ID_LEN;
1695 alpn_protos[cur] = ALPN_HTTP_1_1_LENGTH;
1697 memcpy(&alpn_protos[cur], ALPN_HTTP_1_1, ALPN_HTTP_1_1_LENGTH);
1699 if(SSL_SetNextProtoNego(connssl->handle, alpn_protos, alpn_protos_len)
1704 infof(data, "SSL, can't negotiate HTTP/2.0 with neither NPN nor ALPN\n");
1711 /* Force handshake on next I/O */
1712 SSL_ResetHandshake(connssl->handle, /* asServer */ PR_FALSE);
1714 SSL_SetURL(connssl->handle, conn->host.name);
1722 return nss_fail_connect(connssl, data, curlerr);
1725 static CURLcode nss_do_connect(struct connectdata *conn, int sockindex)
1727 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1728 struct SessionHandle *data = conn->data;
1729 CURLcode curlerr = CURLE_SSL_CONNECT_ERROR;
1732 /* check timeout situation */
1733 const long time_left = Curl_timeleft(data, NULL, TRUE);
1734 if(time_left < 0L) {
1735 failf(data, "timed out before SSL handshake");
1736 curlerr = CURLE_OPERATION_TIMEDOUT;
1740 /* Force the handshake now */
1741 timeout = PR_MillisecondsToInterval((PRUint32) time_left);
1742 if(SSL_ForceHandshakeWithTimeout(connssl->handle, timeout) != SECSuccess) {
1743 if(PR_GetError() == PR_WOULD_BLOCK_ERROR)
1744 /* blocking direction is updated by nss_update_connecting_state() */
1746 else if(conn->data->set.ssl.certverifyresult == SSL_ERROR_BAD_CERT_DOMAIN)
1747 curlerr = CURLE_PEER_FAILED_VERIFICATION;
1748 else if(conn->data->set.ssl.certverifyresult!=0)
1749 curlerr = CURLE_SSL_CACERT;
1753 connssl->state = ssl_connection_complete;
1754 conn->recv[sockindex] = nss_recv;
1755 conn->send[sockindex] = nss_send;
1757 display_conn_info(conn, connssl->handle);
1759 if(data->set.str[STRING_SSL_ISSUERCERT]) {
1760 SECStatus ret = SECFailure;
1761 char *nickname = dup_nickname(data, STRING_SSL_ISSUERCERT);
1763 /* we support only nicknames in case of STRING_SSL_ISSUERCERT for now */
1764 ret = check_issuer_cert(connssl->handle, nickname);
1768 if(SECFailure == ret) {
1769 infof(data,"SSL certificate issuer check failed\n");
1770 curlerr = CURLE_SSL_ISSUER_ERROR;
1774 infof(data, "SSL certificate issuer check ok\n");
1781 return nss_fail_connect(connssl, data, curlerr);
1784 static CURLcode nss_connect_common(struct connectdata *conn, int sockindex,
1787 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1788 struct SessionHandle *data = conn->data;
1789 const bool blocking = (done == NULL);
1792 if(connssl->connecting_state == ssl_connect_1) {
1793 rv = nss_setup_connect(conn, sockindex);
1795 /* we do not expect CURLE_AGAIN from nss_setup_connect() */
1799 /* in non-blocking mode, set NSS non-blocking mode before handshake */
1800 rv = nss_set_nonblock(connssl, data);
1805 connssl->connecting_state = ssl_connect_2;
1808 rv = nss_do_connect(conn, sockindex);
1814 /* CURLE_AGAIN in non-blocking mode is not an error */
1822 /* in blocking mode, set NSS non-blocking mode _after_ SSL handshake */
1823 rv = nss_set_nonblock(connssl, data);
1828 /* signal completed SSL handshake */
1831 connssl->connecting_state = ssl_connect_done;
1835 CURLcode Curl_nss_connect(struct connectdata *conn, int sockindex)
1837 return nss_connect_common(conn, sockindex, /* blocking */ NULL);
1840 CURLcode Curl_nss_connect_nonblocking(struct connectdata *conn,
1841 int sockindex, bool *done)
1843 return nss_connect_common(conn, sockindex, done);
1846 static ssize_t nss_send(struct connectdata *conn, /* connection data */
1847 int sockindex, /* socketindex */
1848 const void *mem, /* send this data */
1849 size_t len, /* amount to write */
1852 ssize_t rc = PR_Send(conn->ssl[sockindex].handle, mem, (int)len, 0,
1853 PR_INTERVAL_NO_WAIT);
1855 PRInt32 err = PR_GetError();
1856 if(err == PR_WOULD_BLOCK_ERROR)
1857 *curlcode = CURLE_AGAIN;
1859 /* print the error number and error string */
1860 const char *err_name = nss_error_to_name(err);
1861 infof(conn->data, "SSL write: error %d (%s)\n", err, err_name);
1863 /* print a human-readable message describing the error if available */
1864 nss_print_error_message(conn->data, err);
1866 *curlcode = (is_cc_error(err))
1867 ? CURLE_SSL_CERTPROBLEM
1872 return rc; /* number of bytes */
1875 static ssize_t nss_recv(struct connectdata * conn, /* connection data */
1876 int num, /* socketindex */
1877 char *buf, /* store read data here */
1878 size_t buffersize, /* max amount to read */
1881 ssize_t nread = PR_Recv(conn->ssl[num].handle, buf, (int)buffersize, 0,
1882 PR_INTERVAL_NO_WAIT);
1884 /* failed SSL read */
1885 PRInt32 err = PR_GetError();
1887 if(err == PR_WOULD_BLOCK_ERROR)
1888 *curlcode = CURLE_AGAIN;
1890 /* print the error number and error string */
1891 const char *err_name = nss_error_to_name(err);
1892 infof(conn->data, "SSL read: errno %d (%s)\n", err, err_name);
1894 /* print a human-readable message describing the error if available */
1895 nss_print_error_message(conn->data, err);
1897 *curlcode = (is_cc_error(err))
1898 ? CURLE_SSL_CERTPROBLEM
1906 size_t Curl_nss_version(char *buffer, size_t size)
1908 return snprintf(buffer, size, "NSS/%s", NSS_VERSION);
1911 int Curl_nss_seed(struct SessionHandle *data)
1913 /* make sure that NSS is initialized */
1914 return !!Curl_nss_force_init(data);
1917 void Curl_nss_random(struct SessionHandle *data,
1918 unsigned char *entropy,
1921 Curl_nss_seed(data); /* Initiate the seed if not already done */
1922 if(SECSuccess != PK11_GenerateRandom(entropy, curlx_uztosi(length))) {
1923 /* no way to signal a failure from here, we have to abort */
1924 failf(data, "PK11_GenerateRandom() failed, calling abort()...");
1929 void Curl_nss_md5sum(unsigned char *tmp, /* input */
1931 unsigned char *md5sum, /* output */
1934 PK11Context *MD5pw = PK11_CreateDigestContext(SEC_OID_MD5);
1935 unsigned int MD5out;
1936 PK11_DigestOp(MD5pw, tmp, curlx_uztoui(tmplen));
1937 PK11_DigestFinal(MD5pw, md5sum, &MD5out, curlx_uztoui(md5len));
1938 PK11_DestroyContext(MD5pw, PR_TRUE);
1941 #endif /* USE_NSS */