1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 2012 - 2014, Nick Zitzmann, <nickzman@gmail.com>.
9 * Copyright (C) 2012 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
11 * This software is licensed as described in the file COPYING, which
12 * you should have received as part of this distribution. The terms
13 * are also available at https://curl.haxx.se/docs/copyright.html.
15 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
16 * copies of the Software, and permit persons to whom the Software is
17 * furnished to do so, under the terms of the COPYING file.
19 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
20 * KIND, either express or implied.
22 ***************************************************************************/
25 * Source file for all iOS and Mac OS X SecureTransport-specific code for the
26 * TLS/SSL layer. No code but vtls.c should ever call or use these functions.
29 #include "curl_setup.h"
31 #include "urldata.h" /* for the Curl_easy definition */
32 #include "curl_base64.h"
41 #include <Security/Security.h>
42 #include <Security/SecureTransport.h>
43 #include <CoreFoundation/CoreFoundation.h>
44 #include <CommonCrypto/CommonDigest.h>
46 /* The Security framework has changed greatly between iOS and different OS X
47 versions, and we will try to support as many of them as we can (back to
48 Leopard and iOS 5) by using macros and weak-linking.
50 IMPORTANT: If TLS 1.1 and 1.2 support are important for you on OS X, then
51 you must build this project against the 10.8 SDK or later. */
52 #if (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED || TARGET_OS_IPHONE))
54 #if MAC_OS_X_VERSION_MAX_ALLOWED < 1050
55 #error "The darwinssl back-end requires Leopard or later."
56 #endif /* MAC_OS_X_VERSION_MAX_ALLOWED < 1050 */
58 #define CURL_BUILD_IOS 0
59 #define CURL_BUILD_IOS_7 0
60 #define CURL_BUILD_MAC 1
61 /* This is the maximum API level we are allowed to use when building: */
62 #define CURL_BUILD_MAC_10_5 MAC_OS_X_VERSION_MAX_ALLOWED >= 1050
63 #define CURL_BUILD_MAC_10_6 MAC_OS_X_VERSION_MAX_ALLOWED >= 1060
64 #define CURL_BUILD_MAC_10_7 MAC_OS_X_VERSION_MAX_ALLOWED >= 1070
65 #define CURL_BUILD_MAC_10_8 MAC_OS_X_VERSION_MAX_ALLOWED >= 1080
66 #define CURL_BUILD_MAC_10_9 MAC_OS_X_VERSION_MAX_ALLOWED >= 1090
67 /* These macros mean "the following code is present to allow runtime backward
68 compatibility with at least this cat or earlier":
69 (You set this at build-time by setting the MACOSX_DEPLOYMENT_TARGET
70 environmental variable.) */
71 #define CURL_SUPPORT_MAC_10_5 MAC_OS_X_VERSION_MIN_REQUIRED <= 1050
72 #define CURL_SUPPORT_MAC_10_6 MAC_OS_X_VERSION_MIN_REQUIRED <= 1060
73 #define CURL_SUPPORT_MAC_10_7 MAC_OS_X_VERSION_MIN_REQUIRED <= 1070
74 #define CURL_SUPPORT_MAC_10_8 MAC_OS_X_VERSION_MIN_REQUIRED <= 1080
75 #define CURL_SUPPORT_MAC_10_9 MAC_OS_X_VERSION_MIN_REQUIRED <= 1090
77 #elif TARGET_OS_EMBEDDED || TARGET_OS_IPHONE
78 #define CURL_BUILD_IOS 1
79 #define CURL_BUILD_IOS_7 __IPHONE_OS_VERSION_MAX_ALLOWED >= 70000
80 #define CURL_BUILD_MAC 0
81 #define CURL_BUILD_MAC_10_5 0
82 #define CURL_BUILD_MAC_10_6 0
83 #define CURL_BUILD_MAC_10_7 0
84 #define CURL_BUILD_MAC_10_8 0
85 #define CURL_SUPPORT_MAC_10_5 0
86 #define CURL_SUPPORT_MAC_10_6 0
87 #define CURL_SUPPORT_MAC_10_7 0
88 #define CURL_SUPPORT_MAC_10_8 0
89 #define CURL_SUPPORT_MAC_10_9 0
92 #error "The darwinssl back-end requires iOS or OS X."
93 #endif /* (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED || TARGET_OS_IPHONE)) */
96 #include <sys/sysctl.h>
97 #endif /* CURL_BUILD_MAC */
101 #include "inet_pton.h"
105 #include "darwinssl.h"
106 #include "curl_printf.h"
108 #include "curl_memory.h"
109 /* The last #include file should be: */
110 #include "memdebug.h"
112 /* From MacTypes.h (which we can't include because it isn't present in iOS: */
116 /* The following two functions were ripped from Apple sample code,
117 * with some modifications: */
118 static OSStatus SocketRead(SSLConnectionRef connection,
119 void *data, /* owned by
122 size_t *dataLength) /* IN/OUT */
124 size_t bytesToGo = *dataLength;
125 size_t initLen = bytesToGo;
126 UInt8 *currData = (UInt8 *)data;
127 /*int sock = *(int *)connection;*/
128 struct ssl_connect_data *connssl = (struct ssl_connect_data *)connection;
129 int sock = connssl->ssl_sockfd;
130 OSStatus rtn = noErr;
139 rrtn = read(sock, currData, bytesToGo);
141 /* this is guesswork... */
143 if(rrtn == 0) { /* EOF = server hung up */
144 /* the framework will turn this into errSSLClosedNoNotify */
145 rtn = errSSLClosedGraceful;
147 else /* do the switch */
150 /* connection closed */
151 rtn = errSSLClosedGraceful;
154 rtn = errSSLClosedAbort;
157 rtn = errSSLWouldBlock;
158 connssl->ssl_direction = false;
169 bytesToGo -= bytesRead;
170 currData += bytesRead;
173 /* filled buffer with incoming data, done */
177 *dataLength = initLen - bytesToGo;
182 static OSStatus SocketWrite(SSLConnectionRef connection,
184 size_t *dataLength) /* IN/OUT */
186 size_t bytesSent = 0;
187 /*int sock = *(int *)connection;*/
188 struct ssl_connect_data *connssl = (struct ssl_connect_data *)connection;
189 int sock = connssl->ssl_sockfd;
191 size_t dataLen = *dataLength;
192 const UInt8 *dataPtr = (UInt8 *)data;
200 (char*)dataPtr + bytesSent,
201 dataLen - bytesSent);
202 } while((length > 0) &&
203 ( (bytesSent += length) < dataLen) );
207 if(theErr == EAGAIN) {
208 ortn = errSSLWouldBlock;
209 connssl->ssl_direction = true;
218 *dataLength = bytesSent;
222 CF_INLINE const char *SSLCipherNameForNumber(SSLCipherSuite cipher) {
224 /* SSL version 3.0 */
225 case SSL_RSA_WITH_NULL_MD5:
226 return "SSL_RSA_WITH_NULL_MD5";
228 case SSL_RSA_WITH_NULL_SHA:
229 return "SSL_RSA_WITH_NULL_SHA";
231 case SSL_RSA_EXPORT_WITH_RC4_40_MD5:
232 return "SSL_RSA_EXPORT_WITH_RC4_40_MD5";
234 case SSL_RSA_WITH_RC4_128_MD5:
235 return "SSL_RSA_WITH_RC4_128_MD5";
237 case SSL_RSA_WITH_RC4_128_SHA:
238 return "SSL_RSA_WITH_RC4_128_SHA";
240 case SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5:
241 return "SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5";
243 case SSL_RSA_WITH_IDEA_CBC_SHA:
244 return "SSL_RSA_WITH_IDEA_CBC_SHA";
246 case SSL_RSA_EXPORT_WITH_DES40_CBC_SHA:
247 return "SSL_RSA_EXPORT_WITH_DES40_CBC_SHA";
249 case SSL_RSA_WITH_DES_CBC_SHA:
250 return "SSL_RSA_WITH_DES_CBC_SHA";
252 case SSL_RSA_WITH_3DES_EDE_CBC_SHA:
253 return "SSL_RSA_WITH_3DES_EDE_CBC_SHA";
255 case SSL_DH_DSS_EXPORT_WITH_DES40_CBC_SHA:
256 return "SSL_DH_DSS_EXPORT_WITH_DES40_CBC_SHA";
258 case SSL_DH_DSS_WITH_DES_CBC_SHA:
259 return "SSL_DH_DSS_WITH_DES_CBC_SHA";
261 case SSL_DH_DSS_WITH_3DES_EDE_CBC_SHA:
262 return "SSL_DH_DSS_WITH_3DES_EDE_CBC_SHA";
264 case SSL_DH_RSA_EXPORT_WITH_DES40_CBC_SHA:
265 return "SSL_DH_RSA_EXPORT_WITH_DES40_CBC_SHA";
267 case SSL_DH_RSA_WITH_DES_CBC_SHA:
268 return "SSL_DH_RSA_WITH_DES_CBC_SHA";
270 case SSL_DH_RSA_WITH_3DES_EDE_CBC_SHA:
271 return "SSL_DH_RSA_WITH_3DES_EDE_CBC_SHA";
273 case SSL_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA:
274 return "SSL_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA";
276 case SSL_DHE_DSS_WITH_DES_CBC_SHA:
277 return "SSL_DHE_DSS_WITH_DES_CBC_SHA";
279 case SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA:
280 return "SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA";
282 case SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA:
283 return "SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA";
285 case SSL_DHE_RSA_WITH_DES_CBC_SHA:
286 return "SSL_DHE_RSA_WITH_DES_CBC_SHA";
288 case SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA:
289 return "SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA";
291 case SSL_DH_anon_EXPORT_WITH_RC4_40_MD5:
292 return "SSL_DH_anon_EXPORT_WITH_RC4_40_MD5";
294 case SSL_DH_anon_WITH_RC4_128_MD5:
295 return "SSL_DH_anon_WITH_RC4_128_MD5";
297 case SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA:
298 return "SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA";
300 case SSL_DH_anon_WITH_DES_CBC_SHA:
301 return "SSL_DH_anon_WITH_DES_CBC_SHA";
303 case SSL_DH_anon_WITH_3DES_EDE_CBC_SHA:
304 return "SSL_DH_anon_WITH_3DES_EDE_CBC_SHA";
306 case SSL_FORTEZZA_DMS_WITH_NULL_SHA:
307 return "SSL_FORTEZZA_DMS_WITH_NULL_SHA";
309 case SSL_FORTEZZA_DMS_WITH_FORTEZZA_CBC_SHA:
310 return "SSL_FORTEZZA_DMS_WITH_FORTEZZA_CBC_SHA";
312 /* TLS 1.0 with AES (RFC 3268)
313 (Apparently these are used in SSLv3 implementations as well.) */
314 case TLS_RSA_WITH_AES_128_CBC_SHA:
315 return "TLS_RSA_WITH_AES_128_CBC_SHA";
317 case TLS_DH_DSS_WITH_AES_128_CBC_SHA:
318 return "TLS_DH_DSS_WITH_AES_128_CBC_SHA";
320 case TLS_DH_RSA_WITH_AES_128_CBC_SHA:
321 return "TLS_DH_RSA_WITH_AES_128_CBC_SHA";
323 case TLS_DHE_DSS_WITH_AES_128_CBC_SHA:
324 return "TLS_DHE_DSS_WITH_AES_128_CBC_SHA";
326 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA:
327 return "TLS_DHE_RSA_WITH_AES_128_CBC_SHA";
329 case TLS_DH_anon_WITH_AES_128_CBC_SHA:
330 return "TLS_DH_anon_WITH_AES_128_CBC_SHA";
332 case TLS_RSA_WITH_AES_256_CBC_SHA:
333 return "TLS_RSA_WITH_AES_256_CBC_SHA";
335 case TLS_DH_DSS_WITH_AES_256_CBC_SHA:
336 return "TLS_DH_DSS_WITH_AES_256_CBC_SHA";
338 case TLS_DH_RSA_WITH_AES_256_CBC_SHA:
339 return "TLS_DH_RSA_WITH_AES_256_CBC_SHA";
341 case TLS_DHE_DSS_WITH_AES_256_CBC_SHA:
342 return "TLS_DHE_DSS_WITH_AES_256_CBC_SHA";
344 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA:
345 return "TLS_DHE_RSA_WITH_AES_256_CBC_SHA";
347 case TLS_DH_anon_WITH_AES_256_CBC_SHA:
348 return "TLS_DH_anon_WITH_AES_256_CBC_SHA";
350 /* SSL version 2.0 */
351 case SSL_RSA_WITH_RC2_CBC_MD5:
352 return "SSL_RSA_WITH_RC2_CBC_MD5";
354 case SSL_RSA_WITH_IDEA_CBC_MD5:
355 return "SSL_RSA_WITH_IDEA_CBC_MD5";
357 case SSL_RSA_WITH_DES_CBC_MD5:
358 return "SSL_RSA_WITH_DES_CBC_MD5";
360 case SSL_RSA_WITH_3DES_EDE_CBC_MD5:
361 return "SSL_RSA_WITH_3DES_EDE_CBC_MD5";
364 return "SSL_NULL_WITH_NULL_NULL";
367 CF_INLINE const char *TLSCipherNameForNumber(SSLCipherSuite cipher) {
369 /* TLS 1.0 with AES (RFC 3268) */
370 case TLS_RSA_WITH_AES_128_CBC_SHA:
371 return "TLS_RSA_WITH_AES_128_CBC_SHA";
373 case TLS_DH_DSS_WITH_AES_128_CBC_SHA:
374 return "TLS_DH_DSS_WITH_AES_128_CBC_SHA";
376 case TLS_DH_RSA_WITH_AES_128_CBC_SHA:
377 return "TLS_DH_RSA_WITH_AES_128_CBC_SHA";
379 case TLS_DHE_DSS_WITH_AES_128_CBC_SHA:
380 return "TLS_DHE_DSS_WITH_AES_128_CBC_SHA";
382 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA:
383 return "TLS_DHE_RSA_WITH_AES_128_CBC_SHA";
385 case TLS_DH_anon_WITH_AES_128_CBC_SHA:
386 return "TLS_DH_anon_WITH_AES_128_CBC_SHA";
388 case TLS_RSA_WITH_AES_256_CBC_SHA:
389 return "TLS_RSA_WITH_AES_256_CBC_SHA";
391 case TLS_DH_DSS_WITH_AES_256_CBC_SHA:
392 return "TLS_DH_DSS_WITH_AES_256_CBC_SHA";
394 case TLS_DH_RSA_WITH_AES_256_CBC_SHA:
395 return "TLS_DH_RSA_WITH_AES_256_CBC_SHA";
397 case TLS_DHE_DSS_WITH_AES_256_CBC_SHA:
398 return "TLS_DHE_DSS_WITH_AES_256_CBC_SHA";
400 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA:
401 return "TLS_DHE_RSA_WITH_AES_256_CBC_SHA";
403 case TLS_DH_anon_WITH_AES_256_CBC_SHA:
404 return "TLS_DH_anon_WITH_AES_256_CBC_SHA";
406 #if CURL_BUILD_MAC_10_6 || CURL_BUILD_IOS
407 /* TLS 1.0 with ECDSA (RFC 4492) */
408 case TLS_ECDH_ECDSA_WITH_NULL_SHA:
409 return "TLS_ECDH_ECDSA_WITH_NULL_SHA";
411 case TLS_ECDH_ECDSA_WITH_RC4_128_SHA:
412 return "TLS_ECDH_ECDSA_WITH_RC4_128_SHA";
414 case TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA:
415 return "TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA";
417 case TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA:
418 return "TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA";
420 case TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA:
421 return "TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA";
423 case TLS_ECDHE_ECDSA_WITH_NULL_SHA:
424 return "TLS_ECDHE_ECDSA_WITH_NULL_SHA";
426 case TLS_ECDHE_ECDSA_WITH_RC4_128_SHA:
427 return "TLS_ECDHE_ECDSA_WITH_RC4_128_SHA";
429 case TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA:
430 return "TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA";
432 case TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA:
433 return "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA";
435 case TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA:
436 return "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA";
438 case TLS_ECDH_RSA_WITH_NULL_SHA:
439 return "TLS_ECDH_RSA_WITH_NULL_SHA";
441 case TLS_ECDH_RSA_WITH_RC4_128_SHA:
442 return "TLS_ECDH_RSA_WITH_RC4_128_SHA";
444 case TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA:
445 return "TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA";
447 case TLS_ECDH_RSA_WITH_AES_128_CBC_SHA:
448 return "TLS_ECDH_RSA_WITH_AES_128_CBC_SHA";
450 case TLS_ECDH_RSA_WITH_AES_256_CBC_SHA:
451 return "TLS_ECDH_RSA_WITH_AES_256_CBC_SHA";
453 case TLS_ECDHE_RSA_WITH_NULL_SHA:
454 return "TLS_ECDHE_RSA_WITH_NULL_SHA";
456 case TLS_ECDHE_RSA_WITH_RC4_128_SHA:
457 return "TLS_ECDHE_RSA_WITH_RC4_128_SHA";
459 case TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA:
460 return "TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA";
462 case TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA:
463 return "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA";
465 case TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA:
466 return "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA";
468 case TLS_ECDH_anon_WITH_NULL_SHA:
469 return "TLS_ECDH_anon_WITH_NULL_SHA";
471 case TLS_ECDH_anon_WITH_RC4_128_SHA:
472 return "TLS_ECDH_anon_WITH_RC4_128_SHA";
474 case TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA:
475 return "TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA";
477 case TLS_ECDH_anon_WITH_AES_128_CBC_SHA:
478 return "TLS_ECDH_anon_WITH_AES_128_CBC_SHA";
480 case TLS_ECDH_anon_WITH_AES_256_CBC_SHA:
481 return "TLS_ECDH_anon_WITH_AES_256_CBC_SHA";
483 #endif /* CURL_BUILD_MAC_10_6 || CURL_BUILD_IOS */
484 #if CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS
485 /* TLS 1.2 (RFC 5246) */
486 case TLS_RSA_WITH_NULL_MD5:
487 return "TLS_RSA_WITH_NULL_MD5";
489 case TLS_RSA_WITH_NULL_SHA:
490 return "TLS_RSA_WITH_NULL_SHA";
492 case TLS_RSA_WITH_RC4_128_MD5:
493 return "TLS_RSA_WITH_RC4_128_MD5";
495 case TLS_RSA_WITH_RC4_128_SHA:
496 return "TLS_RSA_WITH_RC4_128_SHA";
498 case TLS_RSA_WITH_3DES_EDE_CBC_SHA:
499 return "TLS_RSA_WITH_3DES_EDE_CBC_SHA";
501 case TLS_RSA_WITH_NULL_SHA256:
502 return "TLS_RSA_WITH_NULL_SHA256";
504 case TLS_RSA_WITH_AES_128_CBC_SHA256:
505 return "TLS_RSA_WITH_AES_128_CBC_SHA256";
507 case TLS_RSA_WITH_AES_256_CBC_SHA256:
508 return "TLS_RSA_WITH_AES_256_CBC_SHA256";
510 case TLS_DH_DSS_WITH_3DES_EDE_CBC_SHA:
511 return "TLS_DH_DSS_WITH_3DES_EDE_CBC_SHA";
513 case TLS_DH_RSA_WITH_3DES_EDE_CBC_SHA:
514 return "TLS_DH_RSA_WITH_3DES_EDE_CBC_SHA";
516 case TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA:
517 return "TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA";
519 case TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA:
520 return "TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA";
522 case TLS_DH_DSS_WITH_AES_128_CBC_SHA256:
523 return "TLS_DH_DSS_WITH_AES_128_CBC_SHA256";
525 case TLS_DH_RSA_WITH_AES_128_CBC_SHA256:
526 return "TLS_DH_RSA_WITH_AES_128_CBC_SHA256";
528 case TLS_DHE_DSS_WITH_AES_128_CBC_SHA256:
529 return "TLS_DHE_DSS_WITH_AES_128_CBC_SHA256";
531 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA256:
532 return "TLS_DHE_RSA_WITH_AES_128_CBC_SHA256";
534 case TLS_DH_DSS_WITH_AES_256_CBC_SHA256:
535 return "TLS_DH_DSS_WITH_AES_256_CBC_SHA256";
537 case TLS_DH_RSA_WITH_AES_256_CBC_SHA256:
538 return "TLS_DH_RSA_WITH_AES_256_CBC_SHA256";
540 case TLS_DHE_DSS_WITH_AES_256_CBC_SHA256:
541 return "TLS_DHE_DSS_WITH_AES_256_CBC_SHA256";
543 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA256:
544 return "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256";
546 case TLS_DH_anon_WITH_RC4_128_MD5:
547 return "TLS_DH_anon_WITH_RC4_128_MD5";
549 case TLS_DH_anon_WITH_3DES_EDE_CBC_SHA:
550 return "TLS_DH_anon_WITH_3DES_EDE_CBC_SHA";
552 case TLS_DH_anon_WITH_AES_128_CBC_SHA256:
553 return "TLS_DH_anon_WITH_AES_128_CBC_SHA256";
555 case TLS_DH_anon_WITH_AES_256_CBC_SHA256:
556 return "TLS_DH_anon_WITH_AES_256_CBC_SHA256";
558 /* TLS 1.2 with AES GCM (RFC 5288) */
559 case TLS_RSA_WITH_AES_128_GCM_SHA256:
560 return "TLS_RSA_WITH_AES_128_GCM_SHA256";
562 case TLS_RSA_WITH_AES_256_GCM_SHA384:
563 return "TLS_RSA_WITH_AES_256_GCM_SHA384";
565 case TLS_DHE_RSA_WITH_AES_128_GCM_SHA256:
566 return "TLS_DHE_RSA_WITH_AES_128_GCM_SHA256";
568 case TLS_DHE_RSA_WITH_AES_256_GCM_SHA384:
569 return "TLS_DHE_RSA_WITH_AES_256_GCM_SHA384";
571 case TLS_DH_RSA_WITH_AES_128_GCM_SHA256:
572 return "TLS_DH_RSA_WITH_AES_128_GCM_SHA256";
574 case TLS_DH_RSA_WITH_AES_256_GCM_SHA384:
575 return "TLS_DH_RSA_WITH_AES_256_GCM_SHA384";
577 case TLS_DHE_DSS_WITH_AES_128_GCM_SHA256:
578 return "TLS_DHE_DSS_WITH_AES_128_GCM_SHA256";
580 case TLS_DHE_DSS_WITH_AES_256_GCM_SHA384:
581 return "TLS_DHE_DSS_WITH_AES_256_GCM_SHA384";
583 case TLS_DH_DSS_WITH_AES_128_GCM_SHA256:
584 return "TLS_DH_DSS_WITH_AES_128_GCM_SHA256";
586 case TLS_DH_DSS_WITH_AES_256_GCM_SHA384:
587 return "TLS_DH_DSS_WITH_AES_256_GCM_SHA384";
589 case TLS_DH_anon_WITH_AES_128_GCM_SHA256:
590 return "TLS_DH_anon_WITH_AES_128_GCM_SHA256";
592 case TLS_DH_anon_WITH_AES_256_GCM_SHA384:
593 return "TLS_DH_anon_WITH_AES_256_GCM_SHA384";
595 /* TLS 1.2 with elliptic curve ciphers (RFC 5289) */
596 case TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256:
597 return "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256";
599 case TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384:
600 return "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384";
602 case TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256:
603 return "TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256";
605 case TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384:
606 return "TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384";
608 case TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256:
609 return "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256";
611 case TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384:
612 return "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384";
614 case TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256:
615 return "TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256";
617 case TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384:
618 return "TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384";
620 case TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256:
621 return "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256";
623 case TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384:
624 return "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384";
626 case TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256:
627 return "TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256";
629 case TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384:
630 return "TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384";
632 case TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256:
633 return "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256";
635 case TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384:
636 return "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384";
638 case TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256:
639 return "TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256";
641 case TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384:
642 return "TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384";
644 case TLS_EMPTY_RENEGOTIATION_INFO_SCSV:
645 return "TLS_EMPTY_RENEGOTIATION_INFO_SCSV";
648 case SSL_RSA_WITH_NULL_MD5:
649 return "TLS_RSA_WITH_NULL_MD5";
651 case SSL_RSA_WITH_NULL_SHA:
652 return "TLS_RSA_WITH_NULL_SHA";
654 case SSL_RSA_WITH_RC4_128_MD5:
655 return "TLS_RSA_WITH_RC4_128_MD5";
657 case SSL_RSA_WITH_RC4_128_SHA:
658 return "TLS_RSA_WITH_RC4_128_SHA";
660 case SSL_RSA_WITH_3DES_EDE_CBC_SHA:
661 return "TLS_RSA_WITH_3DES_EDE_CBC_SHA";
663 case SSL_DH_anon_WITH_RC4_128_MD5:
664 return "TLS_DH_anon_WITH_RC4_128_MD5";
666 case SSL_DH_anon_WITH_3DES_EDE_CBC_SHA:
667 return "TLS_DH_anon_WITH_3DES_EDE_CBC_SHA";
669 #endif /* CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS */
670 #if CURL_BUILD_MAC_10_9 || CURL_BUILD_IOS_7
671 /* TLS PSK (RFC 4279): */
672 case TLS_PSK_WITH_RC4_128_SHA:
673 return "TLS_PSK_WITH_RC4_128_SHA";
675 case TLS_PSK_WITH_3DES_EDE_CBC_SHA:
676 return "TLS_PSK_WITH_3DES_EDE_CBC_SHA";
678 case TLS_PSK_WITH_AES_128_CBC_SHA:
679 return "TLS_PSK_WITH_AES_128_CBC_SHA";
681 case TLS_PSK_WITH_AES_256_CBC_SHA:
682 return "TLS_PSK_WITH_AES_256_CBC_SHA";
684 case TLS_DHE_PSK_WITH_RC4_128_SHA:
685 return "TLS_DHE_PSK_WITH_RC4_128_SHA";
687 case TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA:
688 return "TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA";
690 case TLS_DHE_PSK_WITH_AES_128_CBC_SHA:
691 return "TLS_DHE_PSK_WITH_AES_128_CBC_SHA";
693 case TLS_DHE_PSK_WITH_AES_256_CBC_SHA:
694 return "TLS_DHE_PSK_WITH_AES_256_CBC_SHA";
696 case TLS_RSA_PSK_WITH_RC4_128_SHA:
697 return "TLS_RSA_PSK_WITH_RC4_128_SHA";
699 case TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA:
700 return "TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA";
702 case TLS_RSA_PSK_WITH_AES_128_CBC_SHA:
703 return "TLS_RSA_PSK_WITH_AES_128_CBC_SHA";
705 case TLS_RSA_PSK_WITH_AES_256_CBC_SHA:
706 return "TLS_RSA_PSK_WITH_AES_256_CBC_SHA";
708 /* More TLS PSK (RFC 4785): */
709 case TLS_PSK_WITH_NULL_SHA:
710 return "TLS_PSK_WITH_NULL_SHA";
712 case TLS_DHE_PSK_WITH_NULL_SHA:
713 return "TLS_DHE_PSK_WITH_NULL_SHA";
715 case TLS_RSA_PSK_WITH_NULL_SHA:
716 return "TLS_RSA_PSK_WITH_NULL_SHA";
718 /* Even more TLS PSK (RFC 5487): */
719 case TLS_PSK_WITH_AES_128_GCM_SHA256:
720 return "TLS_PSK_WITH_AES_128_GCM_SHA256";
722 case TLS_PSK_WITH_AES_256_GCM_SHA384:
723 return "TLS_PSK_WITH_AES_256_GCM_SHA384";
725 case TLS_DHE_PSK_WITH_AES_128_GCM_SHA256:
726 return "TLS_DHE_PSK_WITH_AES_128_GCM_SHA256";
728 case TLS_DHE_PSK_WITH_AES_256_GCM_SHA384:
729 return "TLS_DHE_PSK_WITH_AES_256_GCM_SHA384";
731 case TLS_RSA_PSK_WITH_AES_128_GCM_SHA256:
732 return "TLS_RSA_PSK_WITH_AES_128_GCM_SHA256";
734 case TLS_RSA_PSK_WITH_AES_256_GCM_SHA384:
735 return "TLS_PSK_WITH_AES_256_GCM_SHA384";
737 case TLS_PSK_WITH_AES_128_CBC_SHA256:
738 return "TLS_PSK_WITH_AES_128_CBC_SHA256";
740 case TLS_PSK_WITH_AES_256_CBC_SHA384:
741 return "TLS_PSK_WITH_AES_256_CBC_SHA384";
743 case TLS_PSK_WITH_NULL_SHA256:
744 return "TLS_PSK_WITH_NULL_SHA256";
746 case TLS_PSK_WITH_NULL_SHA384:
747 return "TLS_PSK_WITH_NULL_SHA384";
749 case TLS_DHE_PSK_WITH_AES_128_CBC_SHA256:
750 return "TLS_DHE_PSK_WITH_AES_128_CBC_SHA256";
752 case TLS_DHE_PSK_WITH_AES_256_CBC_SHA384:
753 return "TLS_DHE_PSK_WITH_AES_256_CBC_SHA384";
755 case TLS_DHE_PSK_WITH_NULL_SHA256:
756 return "TLS_DHE_PSK_WITH_NULL_SHA256";
758 case TLS_DHE_PSK_WITH_NULL_SHA384:
759 return "TLS_RSA_PSK_WITH_NULL_SHA384";
761 case TLS_RSA_PSK_WITH_AES_128_CBC_SHA256:
762 return "TLS_RSA_PSK_WITH_AES_128_CBC_SHA256";
764 case TLS_RSA_PSK_WITH_AES_256_CBC_SHA384:
765 return "TLS_RSA_PSK_WITH_AES_256_CBC_SHA384";
767 case TLS_RSA_PSK_WITH_NULL_SHA256:
768 return "TLS_RSA_PSK_WITH_NULL_SHA256";
770 case TLS_RSA_PSK_WITH_NULL_SHA384:
771 return "TLS_RSA_PSK_WITH_NULL_SHA384";
773 #endif /* CURL_BUILD_MAC_10_9 || CURL_BUILD_IOS_7 */
775 return "TLS_NULL_WITH_NULL_NULL";
779 CF_INLINE void GetDarwinVersionNumber(int *major, int *minor)
783 size_t os_version_len;
784 char *os_version_major, *os_version_minor;
787 /* Get the Darwin kernel version from the kernel using sysctl(): */
789 mib[1] = KERN_OSRELEASE;
790 if(sysctl(mib, 2, NULL, &os_version_len, NULL, 0) == -1)
792 os_version = malloc(os_version_len*sizeof(char));
795 if(sysctl(mib, 2, os_version, &os_version_len, NULL, 0) == -1) {
800 /* Parse the version: */
801 os_version_major = strtok_r(os_version, ".", &tok_buf);
802 os_version_minor = strtok_r(NULL, ".", &tok_buf);
803 *major = atoi(os_version_major);
804 *minor = atoi(os_version_minor);
807 #endif /* CURL_BUILD_MAC */
809 /* Apple provides a myriad of ways of getting information about a certificate
810 into a string. Some aren't available under iOS or newer cats. So here's
811 a unified function for getting a string describing the certificate that
812 ought to work in all cats starting with Leopard. */
813 CF_INLINE CFStringRef CopyCertSubject(SecCertificateRef cert)
815 CFStringRef server_cert_summary = CFSTR("(null)");
818 /* iOS: There's only one way to do this. */
819 server_cert_summary = SecCertificateCopySubjectSummary(cert);
821 #if CURL_BUILD_MAC_10_7
822 /* Lion & later: Get the long description if we can. */
823 if(SecCertificateCopyLongDescription != NULL)
824 server_cert_summary =
825 SecCertificateCopyLongDescription(NULL, cert, NULL);
827 #endif /* CURL_BUILD_MAC_10_7 */
828 #if CURL_BUILD_MAC_10_6
829 /* Snow Leopard: Get the certificate summary. */
830 if(SecCertificateCopySubjectSummary != NULL)
831 server_cert_summary = SecCertificateCopySubjectSummary(cert);
833 #endif /* CURL_BUILD_MAC_10_6 */
834 /* Leopard is as far back as we go... */
835 (void)SecCertificateCopyCommonName(cert, &server_cert_summary);
836 #endif /* CURL_BUILD_IOS */
837 return server_cert_summary;
840 #if CURL_SUPPORT_MAC_10_6
841 /* The SecKeychainSearch API was deprecated in Lion, and using it will raise
842 deprecation warnings, so let's not compile this unless it's necessary: */
843 static OSStatus CopyIdentityWithLabelOldSchool(char *label,
844 SecIdentityRef *out_c_a_k)
846 OSStatus status = errSecItemNotFound;
847 SecKeychainAttributeList attr_list;
848 SecKeychainAttribute attr;
849 SecKeychainSearchRef search = NULL;
850 SecCertificateRef cert = NULL;
852 /* Set up the attribute list: */
853 attr_list.count = 1L;
854 attr_list.attr = &attr;
856 /* Set up our lone search criterion: */
857 attr.tag = kSecLabelItemAttr;
859 attr.length = (UInt32)strlen(label);
861 /* Start searching: */
862 status = SecKeychainSearchCreateFromAttributes(NULL,
863 kSecCertificateItemClass,
866 if(status == noErr) {
867 status = SecKeychainSearchCopyNext(search,
868 (SecKeychainItemRef *)&cert);
869 if(status == noErr && cert) {
870 /* If we found a certificate, does it have a private key? */
871 status = SecIdentityCreateWithCertificate(NULL, cert, out_c_a_k);
880 #endif /* CURL_SUPPORT_MAC_10_6 */
882 static OSStatus CopyIdentityWithLabel(char *label,
883 SecIdentityRef *out_cert_and_key)
885 OSStatus status = errSecItemNotFound;
887 #if CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS
888 /* SecItemCopyMatching() was introduced in iOS and Snow Leopard.
889 kSecClassIdentity was introduced in Lion. If both exist, let's use them
890 to find the certificate. */
891 if(SecItemCopyMatching != NULL && kSecClassIdentity != NULL) {
894 CFDictionaryRef query_dict;
895 CFStringRef label_cf = CFStringCreateWithCString(NULL, label,
896 kCFStringEncodingUTF8);
898 /* Set up our search criteria and expected results: */
899 values[0] = kSecClassIdentity; /* we want a certificate and a key */
901 values[1] = kCFBooleanTrue; /* we want a reference */
902 keys[1] = kSecReturnRef;
903 values[2] = kSecMatchLimitOne; /* one is enough, thanks */
904 keys[2] = kSecMatchLimit;
905 /* identity searches need a SecPolicyRef in order to work */
906 values[3] = SecPolicyCreateSSL(false, label_cf);
907 keys[3] = kSecMatchPolicy;
908 query_dict = CFDictionaryCreate(NULL, (const void **)keys,
909 (const void **)values, 4L,
910 &kCFCopyStringDictionaryKeyCallBacks,
911 &kCFTypeDictionaryValueCallBacks);
912 CFRelease(values[3]);
915 /* Do we have a match? */
916 status = SecItemCopyMatching(query_dict, (CFTypeRef *)out_cert_and_key);
917 CFRelease(query_dict);
920 #if CURL_SUPPORT_MAC_10_6
921 /* On Leopard and Snow Leopard, fall back to SecKeychainSearch. */
922 status = CopyIdentityWithLabelOldSchool(label, out_cert_and_key);
923 #endif /* CURL_SUPPORT_MAC_10_7 */
925 #elif CURL_SUPPORT_MAC_10_6
926 /* For developers building on older cats, we have no choice but to fall back
927 to SecKeychainSearch. */
928 status = CopyIdentityWithLabelOldSchool(label, out_cert_and_key);
929 #endif /* CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS */
933 static OSStatus CopyIdentityFromPKCS12File(const char *cPath,
934 const char *cPassword,
935 SecIdentityRef *out_cert_and_key)
937 OSStatus status = errSecItemNotFound;
938 CFURLRef pkcs_url = CFURLCreateFromFileSystemRepresentation(NULL,
939 (const UInt8 *)cPath, strlen(cPath), false);
940 CFStringRef password = cPassword ? CFStringCreateWithCString(NULL,
941 cPassword, kCFStringEncodingUTF8) : NULL;
942 CFDataRef pkcs_data = NULL;
944 /* We can import P12 files on iOS or OS X 10.7 or later: */
945 /* These constants are documented as having first appeared in 10.6 but they
946 raise linker errors when used on that cat for some reason. */
947 #if CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS
948 if(CFURLCreateDataAndPropertiesFromResource(NULL, pkcs_url, &pkcs_data,
949 NULL, NULL, &status)) {
950 const void *cKeys[] = {kSecImportExportPassphrase};
951 const void *cValues[] = {password};
952 CFDictionaryRef options = CFDictionaryCreate(NULL, cKeys, cValues,
953 password ? 1L : 0L, NULL, NULL);
954 CFArrayRef items = NULL;
957 status = SecPKCS12Import(pkcs_data, options, &items);
958 if(status == errSecSuccess && items && CFArrayGetCount(items)) {
959 CFDictionaryRef identity_and_trust = CFArrayGetValueAtIndex(items, 0L);
960 const void *temp_identity = CFDictionaryGetValue(identity_and_trust,
961 kSecImportItemIdentity);
963 /* Retain the identity; we don't care about any other data... */
964 CFRetain(temp_identity);
965 *out_cert_and_key = (SecIdentityRef)temp_identity;
971 CFRelease(pkcs_data);
973 #endif /* CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS */
980 /* This code was borrowed from nss.c, with some modifications:
981 * Determine whether the nickname passed in is a filename that needs to
982 * be loaded as a PEM or a regular NSS nickname.
984 * returns 1 for a file
985 * returns 0 for not a file
987 CF_INLINE bool is_file(const char *filename)
994 if(stat(filename, &st) == 0)
995 return S_ISREG(st.st_mode);
999 static CURLcode darwinssl_connect_step1(struct connectdata *conn,
1002 struct Curl_easy *data = conn->data;
1003 curl_socket_t sockfd = conn->sock[sockindex];
1004 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1006 struct in6_addr addr;
1008 struct in_addr addr;
1009 #endif /* ENABLE_IPV6 */
1010 size_t all_ciphers_count = 0UL, allowed_ciphers_count = 0UL, i;
1011 SSLCipherSuite *all_ciphers = NULL, *allowed_ciphers = NULL;
1012 OSStatus err = noErr;
1014 int darwinver_maj = 0, darwinver_min = 0;
1016 GetDarwinVersionNumber(&darwinver_maj, &darwinver_min);
1017 #endif /* CURL_BUILD_MAC */
1019 #if CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS
1020 if(SSLCreateContext != NULL) { /* use the newer API if avaialble */
1021 if(connssl->ssl_ctx)
1022 CFRelease(connssl->ssl_ctx);
1023 connssl->ssl_ctx = SSLCreateContext(NULL, kSSLClientSide, kSSLStreamType);
1024 if(!connssl->ssl_ctx) {
1025 failf(data, "SSL: couldn't create a context!");
1026 return CURLE_OUT_OF_MEMORY;
1030 /* The old ST API does not exist under iOS, so don't compile it: */
1031 #if CURL_SUPPORT_MAC_10_8
1032 if(connssl->ssl_ctx)
1033 (void)SSLDisposeContext(connssl->ssl_ctx);
1034 err = SSLNewContext(false, &(connssl->ssl_ctx));
1036 failf(data, "SSL: couldn't create a context: OSStatus %d", err);
1037 return CURLE_OUT_OF_MEMORY;
1039 #endif /* CURL_SUPPORT_MAC_10_8 */
1042 if(connssl->ssl_ctx)
1043 (void)SSLDisposeContext(connssl->ssl_ctx);
1044 err = SSLNewContext(false, &(connssl->ssl_ctx));
1046 failf(data, "SSL: couldn't create a context: OSStatus %d", err);
1047 return CURLE_OUT_OF_MEMORY;
1049 #endif /* CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS */
1050 connssl->ssl_write_buffered_length = 0UL; /* reset buffered write length */
1052 /* check to see if we've been told to use an explicit SSL/TLS version */
1053 #if CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS
1054 if(SSLSetProtocolVersionMax != NULL) {
1055 switch(data->set.ssl.version) {
1057 case CURL_SSLVERSION_DEFAULT:
1058 case CURL_SSLVERSION_TLSv1:
1059 (void)SSLSetProtocolVersionMin(connssl->ssl_ctx, kTLSProtocol1);
1060 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kTLSProtocol12);
1062 case CURL_SSLVERSION_TLSv1_0:
1063 (void)SSLSetProtocolVersionMin(connssl->ssl_ctx, kTLSProtocol1);
1064 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kTLSProtocol1);
1066 case CURL_SSLVERSION_TLSv1_1:
1067 (void)SSLSetProtocolVersionMin(connssl->ssl_ctx, kTLSProtocol11);
1068 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kTLSProtocol11);
1070 case CURL_SSLVERSION_TLSv1_2:
1071 (void)SSLSetProtocolVersionMin(connssl->ssl_ctx, kTLSProtocol12);
1072 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kTLSProtocol12);
1074 case CURL_SSLVERSION_SSLv3:
1075 err = SSLSetProtocolVersionMin(connssl->ssl_ctx, kSSLProtocol3);
1077 failf(data, "Your version of the OS does not support SSLv3");
1078 return CURLE_SSL_CONNECT_ERROR;
1080 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kSSLProtocol3);
1082 case CURL_SSLVERSION_SSLv2:
1083 err = SSLSetProtocolVersionMin(connssl->ssl_ctx, kSSLProtocol2);
1085 failf(data, "Your version of the OS does not support SSLv2");
1086 return CURLE_SSL_CONNECT_ERROR;
1088 (void)SSLSetProtocolVersionMax(connssl->ssl_ctx, kSSLProtocol2);
1092 #if CURL_SUPPORT_MAC_10_8
1093 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1096 switch (data->set.ssl.version) {
1098 case CURL_SSLVERSION_DEFAULT:
1099 case CURL_SSLVERSION_TLSv1:
1100 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1103 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1106 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1110 case CURL_SSLVERSION_TLSv1_0:
1111 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1115 case CURL_SSLVERSION_TLSv1_1:
1116 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1120 case CURL_SSLVERSION_TLSv1_2:
1121 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1125 case CURL_SSLVERSION_SSLv3:
1126 err = SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1130 failf(data, "Your version of the OS does not support SSLv3");
1131 return CURLE_SSL_CONNECT_ERROR;
1134 case CURL_SSLVERSION_SSLv2:
1135 err = SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1139 failf(data, "Your version of the OS does not support SSLv2");
1140 return CURLE_SSL_CONNECT_ERROR;
1144 #endif /* CURL_SUPPORT_MAC_10_8 */
1147 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx, kSSLProtocolAll, false);
1148 switch(data->set.ssl.version) {
1150 case CURL_SSLVERSION_DEFAULT:
1151 case CURL_SSLVERSION_TLSv1:
1152 case CURL_SSLVERSION_TLSv1_0:
1153 (void)SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1157 case CURL_SSLVERSION_TLSv1_1:
1158 failf(data, "Your version of the OS does not support TLSv1.1");
1159 return CURLE_SSL_CONNECT_ERROR;
1160 case CURL_SSLVERSION_TLSv1_2:
1161 failf(data, "Your version of the OS does not support TLSv1.2");
1162 return CURLE_SSL_CONNECT_ERROR;
1163 case CURL_SSLVERSION_SSLv2:
1164 err = SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1168 failf(data, "Your version of the OS does not support SSLv2");
1169 return CURLE_SSL_CONNECT_ERROR;
1172 case CURL_SSLVERSION_SSLv3:
1173 err = SSLSetProtocolVersionEnabled(connssl->ssl_ctx,
1177 failf(data, "Your version of the OS does not support SSLv3");
1178 return CURLE_SSL_CONNECT_ERROR;
1182 #endif /* CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS */
1184 if(data->set.str[STRING_KEY]) {
1185 infof(data, "WARNING: SSL: CURLOPT_SSLKEY is ignored by Secure "
1186 "Transport. The private key must be in the Keychain.\n");
1189 if(data->set.str[STRING_CERT]) {
1190 SecIdentityRef cert_and_key = NULL;
1191 bool is_cert_file = is_file(data->set.str[STRING_CERT]);
1193 /* User wants to authenticate with a client cert. Look for it:
1194 If we detect that this is a file on disk, then let's load it.
1195 Otherwise, assume that the user wants to use an identity loaded
1196 from the Keychain. */
1198 if(!data->set.str[STRING_CERT_TYPE])
1199 infof(data, "WARNING: SSL: Certificate type not set, assuming "
1200 "PKCS#12 format.\n");
1201 else if(strncmp(data->set.str[STRING_CERT_TYPE], "P12",
1202 strlen(data->set.str[STRING_CERT_TYPE])) != 0)
1203 infof(data, "WARNING: SSL: The Security framework only supports "
1204 "loading identities that are in PKCS#12 format.\n");
1206 err = CopyIdentityFromPKCS12File(data->set.str[STRING_CERT],
1207 data->set.str[STRING_KEY_PASSWD], &cert_and_key);
1210 err = CopyIdentityWithLabel(data->set.str[STRING_CERT], &cert_and_key);
1213 SecCertificateRef cert = NULL;
1214 CFTypeRef certs_c[1];
1217 /* If we found one, print it out: */
1218 err = SecIdentityCopyCertificate(cert_and_key, &cert);
1220 CFStringRef cert_summary = CopyCertSubject(cert);
1221 char cert_summary_c[128];
1224 memset(cert_summary_c, 0, 128);
1225 if(CFStringGetCString(cert_summary,
1228 kCFStringEncodingUTF8)) {
1229 infof(data, "Client certificate: %s\n", cert_summary_c);
1231 CFRelease(cert_summary);
1235 certs_c[0] = cert_and_key;
1236 certs = CFArrayCreate(NULL, (const void **)certs_c, 1L,
1237 &kCFTypeArrayCallBacks);
1238 err = SSLSetCertificate(connssl->ssl_ctx, certs);
1242 failf(data, "SSL: SSLSetCertificate() failed: OSStatus %d", err);
1243 return CURLE_SSL_CERTPROBLEM;
1245 CFRelease(cert_and_key);
1249 case errSecAuthFailed: case -25264: /* errSecPkcs12VerifyFailure */
1250 failf(data, "SSL: Incorrect password for the certificate \"%s\" "
1251 "and its private key.", data->set.str[STRING_CERT]);
1253 case -26275: /* errSecDecode */ case -25257: /* errSecUnknownFormat */
1254 failf(data, "SSL: Couldn't make sense of the data in the "
1255 "certificate \"%s\" and its private key.",
1256 data->set.str[STRING_CERT]);
1258 case -25260: /* errSecPassphraseRequired */
1259 failf(data, "SSL The certificate \"%s\" requires a password.",
1260 data->set.str[STRING_CERT]);
1262 case errSecItemNotFound:
1263 failf(data, "SSL: Can't find the certificate \"%s\" and its private "
1264 "key in the Keychain.", data->set.str[STRING_CERT]);
1267 failf(data, "SSL: Can't load the certificate \"%s\" and its private "
1268 "key: OSStatus %d", data->set.str[STRING_CERT], err);
1271 return CURLE_SSL_CERTPROBLEM;
1275 /* SSL always tries to verify the peer, this only says whether it should
1276 * fail to connect if the verification fails, or if it should continue
1277 * anyway. In the latter case the result of the verification is checked with
1278 * SSL_get_verify_result() below. */
1279 #if CURL_BUILD_MAC_10_6 || CURL_BUILD_IOS
1280 /* Snow Leopard introduced the SSLSetSessionOption() function, but due to
1281 a library bug with the way the kSSLSessionOptionBreakOnServerAuth flag
1282 works, it doesn't work as expected under Snow Leopard, Lion or
1284 So we need to call SSLSetEnableCertVerify() on those older cats in order
1285 to disable certificate validation if the user turned that off.
1286 (SecureTransport will always validate the certificate chain by
1289 Darwin 11.x.x is Lion (10.7)
1290 Darwin 12.x.x is Mountain Lion (10.8)
1291 Darwin 13.x.x is Mavericks (10.9)
1292 Darwin 14.x.x is Yosemite (10.10)
1293 Darwin 15.x.x is El Capitan (10.11)
1296 if(SSLSetSessionOption != NULL && darwinver_maj >= 13) {
1298 if(SSLSetSessionOption != NULL) {
1299 #endif /* CURL_BUILD_MAC */
1300 bool break_on_auth = !data->set.ssl.verifypeer ||
1301 data->set.str[STRING_SSL_CAFILE];
1302 err = SSLSetSessionOption(connssl->ssl_ctx,
1303 kSSLSessionOptionBreakOnServerAuth,
1306 failf(data, "SSL: SSLSetSessionOption() failed: OSStatus %d", err);
1307 return CURLE_SSL_CONNECT_ERROR;
1311 #if CURL_SUPPORT_MAC_10_8
1312 err = SSLSetEnableCertVerify(connssl->ssl_ctx,
1313 data->set.ssl.verifypeer?true:false);
1315 failf(data, "SSL: SSLSetEnableCertVerify() failed: OSStatus %d", err);
1316 return CURLE_SSL_CONNECT_ERROR;
1318 #endif /* CURL_SUPPORT_MAC_10_8 */
1321 err = SSLSetEnableCertVerify(connssl->ssl_ctx,
1322 data->set.ssl.verifypeer?true:false);
1324 failf(data, "SSL: SSLSetEnableCertVerify() failed: OSStatus %d", err);
1325 return CURLE_SSL_CONNECT_ERROR;
1327 #endif /* CURL_BUILD_MAC_10_6 || CURL_BUILD_IOS */
1329 if(data->set.str[STRING_SSL_CAFILE]) {
1330 bool is_cert_file = is_file(data->set.str[STRING_SSL_CAFILE]);
1333 failf(data, "SSL: can't load CA certificate file %s",
1334 data->set.str[STRING_SSL_CAFILE]);
1335 return CURLE_SSL_CACERT_BADFILE;
1337 if(!data->set.ssl.verifypeer) {
1338 failf(data, "SSL: CA certificate set, but certificate verification "
1340 return CURLE_SSL_CONNECT_ERROR;
1344 /* Configure hostname check. SNI is used if available.
1345 * Both hostname check and SNI require SSLSetPeerDomainName().
1346 * Also: the verifyhost setting influences SNI usage */
1347 if(data->set.ssl.verifyhost) {
1348 err = SSLSetPeerDomainName(connssl->ssl_ctx, conn->host.name,
1349 strlen(conn->host.name));
1352 infof(data, "WARNING: SSL: SSLSetPeerDomainName() failed: OSStatus %d\n",
1356 if((Curl_inet_pton(AF_INET, conn->host.name, &addr))
1358 || (Curl_inet_pton(AF_INET6, conn->host.name, &addr))
1361 infof(data, "WARNING: using IP address, SNI is being disabled by "
1366 /* Disable cipher suites that ST supports but are not safe. These ciphers
1367 are unlikely to be used in any case since ST gives other ciphers a much
1368 higher priority, but it's probably better that we not connect at all than
1369 to give the user a false sense of security if the server only supports
1370 insecure ciphers. (Note: We don't care about SSLv2-only ciphers.) */
1371 (void)SSLGetNumberSupportedCiphers(connssl->ssl_ctx, &all_ciphers_count);
1372 all_ciphers = malloc(all_ciphers_count*sizeof(SSLCipherSuite));
1373 allowed_ciphers = malloc(all_ciphers_count*sizeof(SSLCipherSuite));
1374 if(all_ciphers && allowed_ciphers &&
1375 SSLGetSupportedCiphers(connssl->ssl_ctx, all_ciphers,
1376 &all_ciphers_count) == noErr) {
1377 for(i = 0UL ; i < all_ciphers_count ; i++) {
1379 /* There's a known bug in early versions of Mountain Lion where ST's ECC
1380 ciphers (cipher suite 0xC001 through 0xC032) simply do not work.
1381 Work around the problem here by disabling those ciphers if we are
1382 running in an affected version of OS X. */
1383 if(darwinver_maj == 12 && darwinver_min <= 3 &&
1384 all_ciphers[i] >= 0xC001 && all_ciphers[i] <= 0xC032) {
1387 #endif /* CURL_BUILD_MAC */
1388 switch(all_ciphers[i]) {
1389 /* Disable NULL ciphersuites: */
1390 case SSL_NULL_WITH_NULL_NULL:
1391 case SSL_RSA_WITH_NULL_MD5:
1392 case SSL_RSA_WITH_NULL_SHA:
1393 case 0x003B: /* TLS_RSA_WITH_NULL_SHA256 */
1394 case SSL_FORTEZZA_DMS_WITH_NULL_SHA:
1395 case 0xC001: /* TLS_ECDH_ECDSA_WITH_NULL_SHA */
1396 case 0xC006: /* TLS_ECDHE_ECDSA_WITH_NULL_SHA */
1397 case 0xC00B: /* TLS_ECDH_RSA_WITH_NULL_SHA */
1398 case 0xC010: /* TLS_ECDHE_RSA_WITH_NULL_SHA */
1399 case 0x002C: /* TLS_PSK_WITH_NULL_SHA */
1400 case 0x002D: /* TLS_DHE_PSK_WITH_NULL_SHA */
1401 case 0x002E: /* TLS_RSA_PSK_WITH_NULL_SHA */
1402 case 0x00B0: /* TLS_PSK_WITH_NULL_SHA256 */
1403 case 0x00B1: /* TLS_PSK_WITH_NULL_SHA384 */
1404 case 0x00B4: /* TLS_DHE_PSK_WITH_NULL_SHA256 */
1405 case 0x00B5: /* TLS_DHE_PSK_WITH_NULL_SHA384 */
1406 case 0x00B8: /* TLS_RSA_PSK_WITH_NULL_SHA256 */
1407 case 0x00B9: /* TLS_RSA_PSK_WITH_NULL_SHA384 */
1408 /* Disable anonymous ciphersuites: */
1409 case SSL_DH_anon_EXPORT_WITH_RC4_40_MD5:
1410 case SSL_DH_anon_WITH_RC4_128_MD5:
1411 case SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA:
1412 case SSL_DH_anon_WITH_DES_CBC_SHA:
1413 case SSL_DH_anon_WITH_3DES_EDE_CBC_SHA:
1414 case TLS_DH_anon_WITH_AES_128_CBC_SHA:
1415 case TLS_DH_anon_WITH_AES_256_CBC_SHA:
1416 case 0xC015: /* TLS_ECDH_anon_WITH_NULL_SHA */
1417 case 0xC016: /* TLS_ECDH_anon_WITH_RC4_128_SHA */
1418 case 0xC017: /* TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA */
1419 case 0xC018: /* TLS_ECDH_anon_WITH_AES_128_CBC_SHA */
1420 case 0xC019: /* TLS_ECDH_anon_WITH_AES_256_CBC_SHA */
1421 case 0x006C: /* TLS_DH_anon_WITH_AES_128_CBC_SHA256 */
1422 case 0x006D: /* TLS_DH_anon_WITH_AES_256_CBC_SHA256 */
1423 case 0x00A6: /* TLS_DH_anon_WITH_AES_128_GCM_SHA256 */
1424 case 0x00A7: /* TLS_DH_anon_WITH_AES_256_GCM_SHA384 */
1425 /* Disable weak key ciphersuites: */
1426 case SSL_RSA_EXPORT_WITH_RC4_40_MD5:
1427 case SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5:
1428 case SSL_RSA_EXPORT_WITH_DES40_CBC_SHA:
1429 case SSL_DH_DSS_EXPORT_WITH_DES40_CBC_SHA:
1430 case SSL_DH_RSA_EXPORT_WITH_DES40_CBC_SHA:
1431 case SSL_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA:
1432 case SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA:
1433 case SSL_RSA_WITH_DES_CBC_SHA:
1434 case SSL_DH_DSS_WITH_DES_CBC_SHA:
1435 case SSL_DH_RSA_WITH_DES_CBC_SHA:
1436 case SSL_DHE_DSS_WITH_DES_CBC_SHA:
1437 case SSL_DHE_RSA_WITH_DES_CBC_SHA:
1439 case SSL_RSA_WITH_IDEA_CBC_SHA:
1440 case SSL_RSA_WITH_IDEA_CBC_MD5:
1442 default: /* enable everything else */
1443 allowed_ciphers[allowed_ciphers_count++] = all_ciphers[i];
1447 err = SSLSetEnabledCiphers(connssl->ssl_ctx, allowed_ciphers,
1448 allowed_ciphers_count);
1450 failf(data, "SSL: SSLSetEnabledCiphers() failed: OSStatus %d", err);
1451 return CURLE_SSL_CONNECT_ERROR;
1455 Curl_safefree(all_ciphers);
1456 Curl_safefree(allowed_ciphers);
1457 failf(data, "SSL: Failed to allocate memory for allowed ciphers");
1458 return CURLE_OUT_OF_MEMORY;
1460 Curl_safefree(all_ciphers);
1461 Curl_safefree(allowed_ciphers);
1463 #if CURL_BUILD_MAC_10_9 || CURL_BUILD_IOS_7
1464 /* We want to enable 1/n-1 when using a CBC cipher unless the user
1465 specifically doesn't want us doing that: */
1466 if(SSLSetSessionOption != NULL) {
1467 SSLSetSessionOption(connssl->ssl_ctx, kSSLSessionOptionSendOneByteRecord,
1468 !data->set.ssl_enable_beast);
1469 SSLSetSessionOption(connssl->ssl_ctx, kSSLSessionOptionFalseStart,
1470 data->set.ssl.falsestart); /* false start support */
1472 #endif /* CURL_BUILD_MAC_10_9 || CURL_BUILD_IOS_7 */
1474 /* Check if there's a cached ID we can/should use here! */
1475 if(conn->ssl_config.sessionid) {
1476 char *ssl_sessionid;
1477 size_t ssl_sessionid_len;
1479 Curl_ssl_sessionid_lock(conn);
1480 if(!Curl_ssl_getsessionid(conn, (void **)&ssl_sessionid,
1481 &ssl_sessionid_len)) {
1482 /* we got a session id, use it! */
1483 err = SSLSetPeerID(connssl->ssl_ctx, ssl_sessionid, ssl_sessionid_len);
1484 Curl_ssl_sessionid_unlock(conn);
1486 failf(data, "SSL: SSLSetPeerID() failed: OSStatus %d", err);
1487 return CURLE_SSL_CONNECT_ERROR;
1489 /* Informational message */
1490 infof(data, "SSL re-using session ID\n");
1492 /* If there isn't one, then let's make one up! This has to be done prior
1493 to starting the handshake. */
1497 aprintf("%s:%d:%d:%s:%hu", data->set.str[STRING_SSL_CAFILE],
1498 data->set.ssl.verifypeer, data->set.ssl.verifyhost,
1499 conn->host.name, conn->remote_port);
1500 ssl_sessionid_len = strlen(ssl_sessionid);
1502 err = SSLSetPeerID(connssl->ssl_ctx, ssl_sessionid, ssl_sessionid_len);
1504 Curl_ssl_sessionid_unlock(conn);
1505 failf(data, "SSL: SSLSetPeerID() failed: OSStatus %d", err);
1506 return CURLE_SSL_CONNECT_ERROR;
1509 result = Curl_ssl_addsessionid(conn, ssl_sessionid, ssl_sessionid_len);
1510 Curl_ssl_sessionid_unlock(conn);
1512 failf(data, "failed to store ssl session");
1518 err = SSLSetIOFuncs(connssl->ssl_ctx, SocketRead, SocketWrite);
1520 failf(data, "SSL: SSLSetIOFuncs() failed: OSStatus %d", err);
1521 return CURLE_SSL_CONNECT_ERROR;
1524 /* pass the raw socket into the SSL layers */
1525 /* We need to store the FD in a constant memory address, because
1526 * SSLSetConnection() will not copy that address. I've found that
1527 * conn->sock[sockindex] may change on its own. */
1528 connssl->ssl_sockfd = sockfd;
1529 err = SSLSetConnection(connssl->ssl_ctx, connssl);
1531 failf(data, "SSL: SSLSetConnection() failed: %d", err);
1532 return CURLE_SSL_CONNECT_ERROR;
1535 connssl->connecting_state = ssl_connect_2;
1539 static long pem_to_der(const char *in, unsigned char **out, size_t *outlen)
1541 char *sep_start, *sep_end, *cert_start, *cert_end;
1546 /* Jump through the separators at the beginning of the certificate. */
1547 sep_start = strstr(in, "-----");
1548 if(sep_start == NULL)
1550 cert_start = strstr(sep_start + 1, "-----");
1551 if(cert_start == NULL)
1556 /* Find separator after the end of the certificate. */
1557 cert_end = strstr(cert_start, "-----");
1558 if(cert_end == NULL)
1561 sep_end = strstr(cert_end + 1, "-----");
1566 len = cert_end - cert_start;
1567 b64 = malloc(len + 1);
1571 /* Create base64 string without linefeeds. */
1572 for(i = 0, j = 0; i < len; i++) {
1573 if(cert_start[i] != '\r' && cert_start[i] != '\n')
1574 b64[j++] = cert_start[i];
1578 err = Curl_base64_decode((const char *)b64, out, outlen);
1585 return sep_end - in;
1588 static int read_cert(const char *file, unsigned char **out, size_t *outlen)
1591 ssize_t n, len = 0, cap = 512;
1592 unsigned char buf[cap], *data;
1605 n = read(fd, buf, sizeof(buf));
1616 if(len + n >= cap) {
1618 data = realloc(data, cap);
1625 memcpy(data + len, buf, n);
1636 static int sslerr_to_curlerr(struct Curl_easy *data, int err)
1639 case errSSLXCertChainInvalid:
1640 failf(data, "SSL certificate problem: Invalid certificate chain");
1641 return CURLE_SSL_CACERT;
1642 case errSSLUnknownRootCert:
1643 failf(data, "SSL certificate problem: Untrusted root certificate");
1644 return CURLE_SSL_CACERT;
1645 case errSSLNoRootCert:
1646 failf(data, "SSL certificate problem: No root certificate");
1647 return CURLE_SSL_CACERT;
1648 case errSSLCertExpired:
1649 failf(data, "SSL certificate problem: Certificate chain had an "
1650 "expired certificate");
1651 return CURLE_SSL_CACERT;
1653 failf(data, "SSL certificate problem: Couldn't understand the server "
1654 "certificate format");
1655 return CURLE_SSL_CONNECT_ERROR;
1656 case errSSLHostNameMismatch:
1657 failf(data, "SSL certificate peer hostname mismatch");
1658 return CURLE_PEER_FAILED_VERIFICATION;
1660 failf(data, "SSL unexpected certificate error %d", err);
1661 return CURLE_SSL_CACERT;
1665 static int append_cert_to_array(struct Curl_easy *data,
1666 unsigned char *buf, size_t buflen,
1667 CFMutableArrayRef array)
1669 CFDataRef certdata = CFDataCreate(kCFAllocatorDefault, buf, buflen);
1671 failf(data, "SSL: failed to allocate array for CA certificate");
1672 return CURLE_OUT_OF_MEMORY;
1675 SecCertificateRef cacert =
1676 SecCertificateCreateWithData(kCFAllocatorDefault, certdata);
1677 CFRelease(certdata);
1679 failf(data, "SSL: failed to create SecCertificate from CA certificate");
1680 return CURLE_SSL_CACERT;
1683 /* Check if cacert is valid. */
1684 CFStringRef subject = CopyCertSubject(cacert);
1686 char subject_cbuf[128];
1687 memset(subject_cbuf, 0, 128);
1688 if(!CFStringGetCString(subject,
1691 kCFStringEncodingUTF8)) {
1693 failf(data, "SSL: invalid CA certificate subject");
1694 return CURLE_SSL_CACERT;
1700 failf(data, "SSL: invalid CA certificate");
1701 return CURLE_SSL_CACERT;
1704 CFArrayAppendValue(array, cacert);
1710 static int verify_cert(const char *cafile, struct Curl_easy *data,
1715 unsigned char *certbuf, *der;
1716 size_t buflen, derlen, offset = 0;
1718 if(read_cert(cafile, &certbuf, &buflen) < 0) {
1719 failf(data, "SSL: failed to read or invalid CA certificate");
1720 return CURLE_SSL_CACERT;
1724 * Certbuf now contains the contents of the certificate file, which can be
1725 * - a single DER certificate,
1726 * - a single PEM certificate or
1727 * - a bunch of PEM certificates (certificate bundle).
1729 * Go through certbuf, and convert any PEM certificate in it into DER
1732 CFMutableArrayRef array = CFArrayCreateMutable(kCFAllocatorDefault, 0,
1733 &kCFTypeArrayCallBacks);
1736 failf(data, "SSL: out of memory creating CA certificate array");
1737 return CURLE_OUT_OF_MEMORY;
1740 while(offset < buflen) {
1744 * Check if the certificate is in PEM format, and convert it to DER. If
1745 * this fails, we assume the certificate is in DER format.
1747 res = pem_to_der((const char *)certbuf + offset, &der, &derlen);
1751 failf(data, "SSL: invalid CA certificate #%d (offset %d) in bundle",
1753 return CURLE_SSL_CACERT;
1757 if(res == 0 && offset == 0) {
1758 /* This is not a PEM file, probably a certificate in DER format. */
1759 rc = append_cert_to_array(data, certbuf, buflen, array);
1761 if(rc != CURLE_OK) {
1768 /* No more certificates in the bundle. */
1773 rc = append_cert_to_array(data, der, derlen, array);
1775 if(rc != CURLE_OK) {
1783 OSStatus ret = SSLCopyPeerTrust(ctx, &trust);
1785 failf(data, "SSL: error getting certificate chain");
1787 return CURLE_OUT_OF_MEMORY;
1789 else if(ret != noErr) {
1791 return sslerr_to_curlerr(data, ret);
1794 ret = SecTrustSetAnchorCertificates(trust, array);
1797 return sslerr_to_curlerr(data, ret);
1799 ret = SecTrustSetAnchorCertificatesOnly(trust, true);
1802 return sslerr_to_curlerr(data, ret);
1805 SecTrustResultType trust_eval = 0;
1806 ret = SecTrustEvaluate(trust, &trust_eval);
1810 return sslerr_to_curlerr(data, ret);
1813 switch (trust_eval) {
1814 case kSecTrustResultUnspecified:
1815 case kSecTrustResultProceed:
1818 case kSecTrustResultRecoverableTrustFailure:
1819 case kSecTrustResultDeny:
1821 failf(data, "SSL: certificate verification failed (result: %d)",
1823 return CURLE_PEER_FAILED_VERIFICATION;
1828 darwinssl_connect_step2(struct connectdata *conn, int sockindex)
1830 struct Curl_easy *data = conn->data;
1831 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1833 SSLCipherSuite cipher;
1834 SSLProtocol protocol = 0;
1836 DEBUGASSERT(ssl_connect_2 == connssl->connecting_state
1837 || ssl_connect_2_reading == connssl->connecting_state
1838 || ssl_connect_2_writing == connssl->connecting_state);
1840 /* Here goes nothing: */
1841 err = SSLHandshake(connssl->ssl_ctx);
1845 case errSSLWouldBlock: /* they're not done with us yet */
1846 connssl->connecting_state = connssl->ssl_direction ?
1847 ssl_connect_2_writing : ssl_connect_2_reading;
1850 /* The below is errSSLServerAuthCompleted; it's not defined in
1851 Leopard's headers */
1853 if(data->set.str[STRING_SSL_CAFILE]) {
1854 int res = verify_cert(data->set.str[STRING_SSL_CAFILE], data,
1859 /* the documentation says we need to call SSLHandshake() again */
1860 return darwinssl_connect_step2(conn, sockindex);
1862 /* These are all certificate problems with the server: */
1863 case errSSLXCertChainInvalid:
1864 failf(data, "SSL certificate problem: Invalid certificate chain");
1865 return CURLE_SSL_CACERT;
1866 case errSSLUnknownRootCert:
1867 failf(data, "SSL certificate problem: Untrusted root certificate");
1868 return CURLE_SSL_CACERT;
1869 case errSSLNoRootCert:
1870 failf(data, "SSL certificate problem: No root certificate");
1871 return CURLE_SSL_CACERT;
1872 case errSSLCertExpired:
1873 failf(data, "SSL certificate problem: Certificate chain had an "
1874 "expired certificate");
1875 return CURLE_SSL_CACERT;
1877 failf(data, "SSL certificate problem: Couldn't understand the server "
1878 "certificate format");
1879 return CURLE_SSL_CONNECT_ERROR;
1881 /* These are all certificate problems with the client: */
1882 case errSecAuthFailed:
1883 failf(data, "SSL authentication failed");
1884 return CURLE_SSL_CONNECT_ERROR;
1885 case errSSLPeerHandshakeFail:
1886 failf(data, "SSL peer handshake failed, the server most likely "
1887 "requires a client certificate to connect");
1888 return CURLE_SSL_CONNECT_ERROR;
1889 case errSSLPeerUnknownCA:
1890 failf(data, "SSL server rejected the client certificate due to "
1891 "the certificate being signed by an unknown certificate "
1893 return CURLE_SSL_CONNECT_ERROR;
1895 /* This error is raised if the server's cert didn't match the server's
1897 case errSSLHostNameMismatch:
1898 failf(data, "SSL certificate peer verification failed, the "
1899 "certificate did not match \"%s\"\n", conn->host.dispname);
1900 return CURLE_PEER_FAILED_VERIFICATION;
1902 /* Generic handshake errors: */
1903 case errSSLConnectionRefused:
1904 failf(data, "Server dropped the connection during the SSL handshake");
1905 return CURLE_SSL_CONNECT_ERROR;
1906 case errSSLClosedAbort:
1907 failf(data, "Server aborted the SSL handshake");
1908 return CURLE_SSL_CONNECT_ERROR;
1909 case errSSLNegotiation:
1910 failf(data, "Could not negotiate an SSL cipher suite with the server");
1911 return CURLE_SSL_CONNECT_ERROR;
1912 /* Sometimes paramErr happens with buggy ciphers: */
1913 case paramErr: case errSSLInternal:
1914 failf(data, "Internal SSL engine error encountered during the "
1916 return CURLE_SSL_CONNECT_ERROR;
1917 case errSSLFatalAlert:
1918 failf(data, "Fatal SSL engine error encountered during the SSL "
1920 return CURLE_SSL_CONNECT_ERROR;
1922 failf(data, "Unknown SSL protocol error in connection to %s:%d",
1923 conn->host.name, err);
1924 return CURLE_SSL_CONNECT_ERROR;
1928 /* we have been connected fine, we're not waiting for anything else. */
1929 connssl->connecting_state = ssl_connect_3;
1931 /* Informational message */
1932 (void)SSLGetNegotiatedCipher(connssl->ssl_ctx, &cipher);
1933 (void)SSLGetNegotiatedProtocolVersion(connssl->ssl_ctx, &protocol);
1936 infof(data, "SSL 2.0 connection using %s\n",
1937 SSLCipherNameForNumber(cipher));
1940 infof(data, "SSL 3.0 connection using %s\n",
1941 SSLCipherNameForNumber(cipher));
1944 infof(data, "TLS 1.0 connection using %s\n",
1945 TLSCipherNameForNumber(cipher));
1947 #if CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS
1948 case kTLSProtocol11:
1949 infof(data, "TLS 1.1 connection using %s\n",
1950 TLSCipherNameForNumber(cipher));
1952 case kTLSProtocol12:
1953 infof(data, "TLS 1.2 connection using %s\n",
1954 TLSCipherNameForNumber(cipher));
1958 infof(data, "Unknown protocol connection\n");
1967 darwinssl_connect_step3(struct connectdata *conn,
1970 struct Curl_easy *data = conn->data;
1971 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
1972 CFStringRef server_cert_summary;
1973 char server_cert_summary_c[128];
1974 CFArrayRef server_certs = NULL;
1975 SecCertificateRef server_cert;
1978 SecTrustRef trust = NULL;
1980 /* There is no step 3!
1981 * Well, okay, if verbose mode is on, let's print the details of the
1982 * server certificates. */
1983 #if CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS
1985 #pragma unused(server_certs)
1986 err = SSLCopyPeerTrust(connssl->ssl_ctx, &trust);
1987 /* For some reason, SSLCopyPeerTrust() can return noErr and yet return
1988 a null trust, so be on guard for that: */
1989 if(err == noErr && trust) {
1990 count = SecTrustGetCertificateCount(trust);
1991 for(i = 0L ; i < count ; i++) {
1992 server_cert = SecTrustGetCertificateAtIndex(trust, i);
1993 server_cert_summary = CopyCertSubject(server_cert);
1994 memset(server_cert_summary_c, 0, 128);
1995 if(CFStringGetCString(server_cert_summary,
1996 server_cert_summary_c,
1998 kCFStringEncodingUTF8)) {
1999 infof(data, "Server certificate: %s\n", server_cert_summary_c);
2001 CFRelease(server_cert_summary);
2006 /* SSLCopyPeerCertificates() is deprecated as of Mountain Lion.
2007 The function SecTrustGetCertificateAtIndex() is officially present
2008 in Lion, but it is unfortunately also present in Snow Leopard as
2009 private API and doesn't work as expected. So we have to look for
2010 a different symbol to make sure this code is only executed under
2012 if(SecTrustEvaluateAsync != NULL) {
2013 #pragma unused(server_certs)
2014 err = SSLCopyPeerTrust(connssl->ssl_ctx, &trust);
2015 /* For some reason, SSLCopyPeerTrust() can return noErr and yet return
2016 a null trust, so be on guard for that: */
2017 if(err == noErr && trust) {
2018 count = SecTrustGetCertificateCount(trust);
2019 for(i = 0L ; i < count ; i++) {
2020 server_cert = SecTrustGetCertificateAtIndex(trust, i);
2021 server_cert_summary = CopyCertSubject(server_cert);
2022 memset(server_cert_summary_c, 0, 128);
2023 if(CFStringGetCString(server_cert_summary,
2024 server_cert_summary_c,
2026 kCFStringEncodingUTF8)) {
2027 infof(data, "Server certificate: %s\n", server_cert_summary_c);
2029 CFRelease(server_cert_summary);
2035 #if CURL_SUPPORT_MAC_10_8
2036 err = SSLCopyPeerCertificates(connssl->ssl_ctx, &server_certs);
2037 /* Just in case SSLCopyPeerCertificates() returns null too... */
2038 if(err == noErr && server_certs) {
2039 count = CFArrayGetCount(server_certs);
2040 for(i = 0L ; i < count ; i++) {
2041 server_cert = (SecCertificateRef)CFArrayGetValueAtIndex(server_certs,
2044 server_cert_summary = CopyCertSubject(server_cert);
2045 memset(server_cert_summary_c, 0, 128);
2046 if(CFStringGetCString(server_cert_summary,
2047 server_cert_summary_c,
2049 kCFStringEncodingUTF8)) {
2050 infof(data, "Server certificate: %s\n", server_cert_summary_c);
2052 CFRelease(server_cert_summary);
2054 CFRelease(server_certs);
2056 #endif /* CURL_SUPPORT_MAC_10_8 */
2058 #endif /* CURL_BUILD_IOS */
2060 #pragma unused(trust)
2061 err = SSLCopyPeerCertificates(connssl->ssl_ctx, &server_certs);
2063 count = CFArrayGetCount(server_certs);
2064 for(i = 0L ; i < count ; i++) {
2065 server_cert = (SecCertificateRef)CFArrayGetValueAtIndex(server_certs, i);
2066 server_cert_summary = CopyCertSubject(server_cert);
2067 memset(server_cert_summary_c, 0, 128);
2068 if(CFStringGetCString(server_cert_summary,
2069 server_cert_summary_c,
2071 kCFStringEncodingUTF8)) {
2072 infof(data, "Server certificate: %s\n", server_cert_summary_c);
2074 CFRelease(server_cert_summary);
2076 CFRelease(server_certs);
2078 #endif /* CURL_BUILD_MAC_10_7 || CURL_BUILD_IOS */
2080 connssl->connecting_state = ssl_connect_done;
2084 static Curl_recv darwinssl_recv;
2085 static Curl_send darwinssl_send;
2088 darwinssl_connect_common(struct connectdata *conn,
2094 struct Curl_easy *data = conn->data;
2095 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
2096 curl_socket_t sockfd = conn->sock[sockindex];
2100 /* check if the connection has already been established */
2101 if(ssl_connection_complete == connssl->state) {
2106 if(ssl_connect_1==connssl->connecting_state) {
2107 /* Find out how much more time we're allowed */
2108 timeout_ms = Curl_timeleft(data, NULL, TRUE);
2110 if(timeout_ms < 0) {
2111 /* no need to continue if time already is up */
2112 failf(data, "SSL connection timeout");
2113 return CURLE_OPERATION_TIMEDOUT;
2116 result = darwinssl_connect_step1(conn, sockindex);
2121 while(ssl_connect_2 == connssl->connecting_state ||
2122 ssl_connect_2_reading == connssl->connecting_state ||
2123 ssl_connect_2_writing == connssl->connecting_state) {
2125 /* check allowed time left */
2126 timeout_ms = Curl_timeleft(data, NULL, TRUE);
2128 if(timeout_ms < 0) {
2129 /* no need to continue if time already is up */
2130 failf(data, "SSL connection timeout");
2131 return CURLE_OPERATION_TIMEDOUT;
2134 /* if ssl is expecting something, check if it's available. */
2135 if(connssl->connecting_state == ssl_connect_2_reading ||
2136 connssl->connecting_state == ssl_connect_2_writing) {
2138 curl_socket_t writefd = ssl_connect_2_writing ==
2139 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
2140 curl_socket_t readfd = ssl_connect_2_reading ==
2141 connssl->connecting_state?sockfd:CURL_SOCKET_BAD;
2143 what = Curl_socket_ready(readfd, writefd, nonblocking?0:timeout_ms);
2146 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
2147 return CURLE_SSL_CONNECT_ERROR;
2149 else if(0 == what) {
2156 failf(data, "SSL connection timeout");
2157 return CURLE_OPERATION_TIMEDOUT;
2160 /* socket is readable or writable */
2163 /* Run transaction, and return to the caller if it failed or if this
2164 * connection is done nonblocking and this loop would execute again. This
2165 * permits the owner of a multi handle to abort a connection attempt
2166 * before step2 has completed while ensuring that a client using select()
2167 * or epoll() will always have a valid fdset to wait on.
2169 result = darwinssl_connect_step2(conn, sockindex);
2170 if(result || (nonblocking &&
2171 (ssl_connect_2 == connssl->connecting_state ||
2172 ssl_connect_2_reading == connssl->connecting_state ||
2173 ssl_connect_2_writing == connssl->connecting_state)))
2176 } /* repeat step2 until all transactions are done. */
2179 if(ssl_connect_3 == connssl->connecting_state) {
2180 result = darwinssl_connect_step3(conn, sockindex);
2185 if(ssl_connect_done == connssl->connecting_state) {
2186 connssl->state = ssl_connection_complete;
2187 conn->recv[sockindex] = darwinssl_recv;
2188 conn->send[sockindex] = darwinssl_send;
2194 /* Reset our connect state machine */
2195 connssl->connecting_state = ssl_connect_1;
2201 Curl_darwinssl_connect_nonblocking(struct connectdata *conn,
2205 return darwinssl_connect_common(conn, sockindex, TRUE, done);
2209 Curl_darwinssl_connect(struct connectdata *conn,
2215 result = darwinssl_connect_common(conn, sockindex, FALSE, &done);
2225 void Curl_darwinssl_close(struct connectdata *conn, int sockindex)
2227 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
2229 if(connssl->ssl_ctx) {
2230 (void)SSLClose(connssl->ssl_ctx);
2231 #if CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS
2232 if(SSLCreateContext != NULL)
2233 CFRelease(connssl->ssl_ctx);
2234 #if CURL_SUPPORT_MAC_10_8
2236 (void)SSLDisposeContext(connssl->ssl_ctx);
2237 #endif /* CURL_SUPPORT_MAC_10_8 */
2239 (void)SSLDisposeContext(connssl->ssl_ctx);
2240 #endif /* CURL_BUILD_MAC_10_8 || CURL_BUILD_IOS */
2241 connssl->ssl_ctx = NULL;
2243 connssl->ssl_sockfd = 0;
2246 int Curl_darwinssl_shutdown(struct connectdata *conn, int sockindex)
2248 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
2249 struct Curl_easy *data = conn->data;
2255 if(!connssl->ssl_ctx)
2258 if(data->set.ftp_ccc != CURLFTPSSL_CCC_ACTIVE)
2261 Curl_darwinssl_close(conn, sockindex);
2265 what = Curl_socket_ready(conn->sock[sockindex],
2266 CURL_SOCKET_BAD, SSL_SHUTDOWN_TIMEOUT);
2270 /* anything that gets here is fatally bad */
2271 failf(data, "select/poll on SSL socket, errno: %d", SOCKERRNO);
2276 if(!what) { /* timeout */
2277 failf(data, "SSL shutdown timeout");
2281 /* Something to read, let's do it and hope that it is the close
2282 notify alert from the server. No way to SSL_Read now, so use read(). */
2284 nread = read(conn->sock[sockindex], buf, sizeof(buf));
2287 failf(data, "read: %s", strerror(errno));
2294 what = Curl_socket_ready(conn->sock[sockindex], CURL_SOCKET_BAD, 0);
2300 void Curl_darwinssl_session_free(void *ptr)
2302 /* ST, as of iOS 5 and Mountain Lion, has no public method of deleting a
2303 cached session ID inside the Security framework. There is a private
2304 function that does this, but I don't want to have to explain to you why I
2305 got your application rejected from the App Store due to the use of a
2306 private API, so the best we can do is free up our own char array that we
2307 created way back in darwinssl_connect_step1... */
2311 size_t Curl_darwinssl_version(char *buffer, size_t size)
2313 return snprintf(buffer, size, "SecureTransport");
2317 * This function uses SSLGetSessionState to determine connection status.
2320 * 1 means the connection is still in place
2321 * 0 means the connection has been closed
2322 * -1 means the connection status is unknown
2324 int Curl_darwinssl_check_cxn(struct connectdata *conn)
2326 struct ssl_connect_data *connssl = &conn->ssl[FIRSTSOCKET];
2328 SSLSessionState state;
2330 if(connssl->ssl_ctx) {
2331 err = SSLGetSessionState(connssl->ssl_ctx, &state);
2333 return state == kSSLConnected || state == kSSLHandshake;
2339 bool Curl_darwinssl_data_pending(const struct connectdata *conn,
2342 const struct ssl_connect_data *connssl = &conn->ssl[connindex];
2346 if(connssl->ssl_ctx) { /* SSL is in use */
2347 err = SSLGetBufferedReadSize(connssl->ssl_ctx, &buffer);
2349 return buffer > 0UL;
2356 int Curl_darwinssl_random(unsigned char *entropy,
2359 /* arc4random_buf() isn't available on cats older than Lion, so let's
2360 do this manually for the benefit of the older cats. */
2362 u_int32_t random_number = 0;
2364 for(i = 0 ; i < length ; i++) {
2365 if(i % sizeof(u_int32_t) == 0)
2366 random_number = arc4random();
2367 entropy[i] = random_number & 0xFF;
2368 random_number >>= 8;
2370 i = random_number = 0;
2374 void Curl_darwinssl_md5sum(unsigned char *tmp, /* input */
2376 unsigned char *md5sum, /* output */
2380 (void)CC_MD5(tmp, (CC_LONG)tmplen, md5sum);
2383 bool Curl_darwinssl_false_start(void) {
2384 #if CURL_BUILD_MAC_10_9 || CURL_BUILD_IOS_7
2385 if(SSLSetSessionOption != NULL)
2391 static ssize_t darwinssl_send(struct connectdata *conn,
2397 /*struct Curl_easy *data = conn->data;*/
2398 struct ssl_connect_data *connssl = &conn->ssl[sockindex];
2399 size_t processed = 0UL;
2402 /* The SSLWrite() function works a little differently than expected. The
2403 fourth argument (processed) is currently documented in Apple's
2404 documentation as: "On return, the length, in bytes, of the data actually
2407 Now, one could interpret that as "written to the socket," but actually,
2408 it returns the amount of data that was written to a buffer internal to
2409 the SSLContextRef instead. So it's possible for SSLWrite() to return
2410 errSSLWouldBlock and a number of bytes "written" because those bytes were
2411 encrypted and written to a buffer, not to the socket.
2413 So if this happens, then we need to keep calling SSLWrite() over and
2414 over again with no new data until it quits returning errSSLWouldBlock. */
2416 /* Do we have buffered data to write from the last time we were called? */
2417 if(connssl->ssl_write_buffered_length) {
2418 /* Write the buffered data: */
2419 err = SSLWrite(connssl->ssl_ctx, NULL, 0UL, &processed);
2422 /* processed is always going to be 0 because we didn't write to
2423 the buffer, so return how much was written to the socket */
2424 processed = connssl->ssl_write_buffered_length;
2425 connssl->ssl_write_buffered_length = 0UL;
2427 case errSSLWouldBlock: /* argh, try again */
2428 *curlcode = CURLE_AGAIN;
2431 failf(conn->data, "SSLWrite() returned error %d", err);
2432 *curlcode = CURLE_SEND_ERROR;
2437 /* We've got new data to write: */
2438 err = SSLWrite(connssl->ssl_ctx, mem, len, &processed);
2441 case errSSLWouldBlock:
2442 /* Data was buffered but not sent, we have to tell the caller
2443 to try sending again, and remember how much was buffered */
2444 connssl->ssl_write_buffered_length = len;
2445 *curlcode = CURLE_AGAIN;
2448 failf(conn->data, "SSLWrite() returned error %d", err);
2449 *curlcode = CURLE_SEND_ERROR;
2454 return (ssize_t)processed;
2457 static ssize_t darwinssl_recv(struct connectdata *conn,
2463 /*struct Curl_easy *data = conn->data;*/
2464 struct ssl_connect_data *connssl = &conn->ssl[num];
2465 size_t processed = 0UL;
2466 OSStatus err = SSLRead(connssl->ssl_ctx, buf, buffersize, &processed);
2470 case errSSLWouldBlock: /* return how much we read (if anything) */
2472 return (ssize_t)processed;
2473 *curlcode = CURLE_AGAIN;
2477 /* errSSLClosedGraceful - server gracefully shut down the SSL session
2478 errSSLClosedNoNotify - server hung up on us instead of sending a
2479 closure alert notice, read() is returning 0
2480 Either way, inform the caller that the server disconnected. */
2481 case errSSLClosedGraceful:
2482 case errSSLClosedNoNotify:
2483 *curlcode = CURLE_OK;
2488 failf(conn->data, "SSLRead() return error %d", err);
2489 *curlcode = CURLE_RECV_ERROR;
2494 return (ssize_t)processed;
2497 #endif /* USE_DARWINSSL */