2 * TLS support code for CUPS on macOS.
4 * Copyright 2007-2017 by Apple Inc.
5 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
7 * These coded instructions, statements, and computer programs are the
8 * property of Apple Inc. and are protected by Federal copyright
9 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
10 * which should have been included with this file. If this file is
11 * missing or damaged, see the license at "http://www.cups.org/".
13 * This file is subject to the Apple OS-Developed Software exception.
16 /**** This file is included from tls.c ****/
19 * Include necessary headers...
24 extern char **environ
; /* @private@ */
28 * Constants, very secure stuff...
31 #define _CUPS_CDSA_PASSWORD "42" /* CUPS keychain password */
32 #define _CUPS_CDSA_PASSLEN 2 /* Length of keychain password */
39 static int tls_auto_create
= 0;
40 /* Auto-create self-signed certs? */
41 static char *tls_common_name
= NULL
;
42 /* Default common name */
43 #ifdef HAVE_SECKEYCHAINOPEN
44 static int tls_cups_keychain
= 0;
45 /* Opened the CUPS keychain? */
46 static SecKeychainRef tls_keychain
= NULL
;
47 /* Server cert keychain */
49 static SecIdentityRef tls_selfsigned
= NULL
;
50 /* Temporary self-signed cert */
51 #endif /* HAVE_SECKEYCHAINOPEN */
52 static char *tls_keypath
= NULL
;
53 /* Server cert keychain path */
54 static _cups_mutex_t tls_mutex
= _CUPS_MUTEX_INITIALIZER
;
55 /* Mutex for keychain/certs */
56 static int tls_options
= -1,/* Options for TLS connections */
57 tls_min_version
= _HTTP_TLS_1_0
,
58 tls_max_version
= _HTTP_TLS_MAX
;
65 static CFArrayRef
http_cdsa_copy_server(const char *common_name
);
66 static SecCertificateRef
http_cdsa_create_credential(http_credential_t
*credential
);
67 #ifdef HAVE_SECKEYCHAINOPEN
68 static const char *http_cdsa_default_path(char *buffer
, size_t bufsize
);
69 static SecKeychainRef
http_cdsa_open_keychain(const char *path
, char *filename
, size_t filesize
);
70 static SecKeychainRef
http_cdsa_open_system_keychain(void);
71 #endif /* HAVE_SECKEYCHAINOPEN */
72 static OSStatus
http_cdsa_read(SSLConnectionRef connection
, void *data
, size_t *dataLength
);
73 static int http_cdsa_set_credentials(http_t
*http
);
74 static OSStatus
http_cdsa_write(SSLConnectionRef connection
, const void *data
, size_t *dataLength
);
78 * 'cupsMakeServerCredentials()' - Make a self-signed certificate and private key pair.
80 * @since CUPS 2.0/OS 10.10@
83 int /* O - 1 on success, 0 on failure */
84 cupsMakeServerCredentials(
85 const char *path
, /* I - Keychain path or @code NULL@ for default */
86 const char *common_name
, /* I - Common name */
87 int num_alt_names
, /* I - Number of subject alternate names */
88 const char **alt_names
, /* I - Subject Alternate Names */
89 time_t expiration_date
) /* I - Expiration date */
91 #if defined(HAVE_SECGENERATESELFSIGNEDCERTIFICATE)
92 int status
= 0; /* Return status */
93 OSStatus err
; /* Error code (if any) */
94 CFStringRef cfcommon_name
= NULL
;
95 /* CF string for server name */
96 SecIdentityRef ident
= NULL
; /* Identity */
97 SecKeyRef publicKey
= NULL
,
101 SecCertificateRef cert
= NULL
; /* Self-signed certificate */
102 CFMutableDictionaryRef keyParams
= NULL
;
103 /* Key generation parameters */
106 DEBUG_printf(("cupsMakeServerCredentials(path=\"%s\", common_name=\"%s\", num_alt_names=%d, alt_names=%p, expiration_date=%d)", path
, common_name
, num_alt_names
, alt_names
, (int)expiration_date
));
111 (void)expiration_date
;
115 DEBUG_puts("1cupsMakeServerCredentials: No keychain support compiled in, returning 0.");
121 DEBUG_puts("1cupsMakeServerCredentials: Using existing self-signed cert.");
125 cfcommon_name
= CFStringCreateWithCString(kCFAllocatorDefault
, common_name
, kCFStringEncodingUTF8
);
128 DEBUG_puts("1cupsMakeServerCredentials: Unable to create CF string of common name.");
133 * Create a public/private key pair...
136 keyParams
= CFDictionaryCreateMutable(kCFAllocatorDefault
, 0, &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
);
139 DEBUG_puts("1cupsMakeServerCredentials: Unable to create key parameters dictionary.");
143 CFDictionaryAddValue(keyParams
, kSecAttrKeyType
, kSecAttrKeyTypeRSA
);
144 CFDictionaryAddValue(keyParams
, kSecAttrKeySizeInBits
, CFSTR("2048"));
145 CFDictionaryAddValue(keyParams
, kSecAttrLabel
, cfcommon_name
);
147 err
= SecKeyGeneratePair(keyParams
, &publicKey
, &privateKey
);
150 DEBUG_printf(("1cupsMakeServerCredentials: Unable to generate key pair: %d.", (int)err
));
155 * Create a self-signed certificate using the public/private key pair...
158 CFIndex usageInt
= kSecKeyUsageAll
;
159 CFNumberRef usage
= CFNumberCreate(kCFAllocatorDefault
, kCFNumberCFIndexType
, &usageInt
);
161 CFNumberRef len
= CFNumberCreate(kCFAllocatorDefault
, kCFNumberCFIndexType
, &lenInt
);
162 CFTypeRef certKeys
[] = { kSecCSRBasicContraintsPathLen
, kSecSubjectAltName
, kSecCertificateKeyUsage
};
163 CFTypeRef certValues
[] = { len
, cfcommon_name
, usage
};
164 CFDictionaryRef certParams
= CFDictionaryCreate(kCFAllocatorDefault
, certKeys
, certValues
, sizeof(certKeys
) / sizeof(certKeys
[0]), &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
);
168 const void *ca_o
[] = { kSecOidOrganization
, CFSTR("") };
169 const void *ca_cn
[] = { kSecOidCommonName
, cfcommon_name
};
170 CFArrayRef ca_o_dn
= CFArrayCreate(kCFAllocatorDefault
, ca_o
, 2, NULL
);
171 CFArrayRef ca_cn_dn
= CFArrayCreate(kCFAllocatorDefault
, ca_cn
, 2, NULL
);
172 const void *ca_dn_array
[2];
174 ca_dn_array
[0] = CFArrayCreate(kCFAllocatorDefault
, (const void **)&ca_o_dn
, 1, NULL
);
175 ca_dn_array
[1] = CFArrayCreate(kCFAllocatorDefault
, (const void **)&ca_cn_dn
, 1, NULL
);
177 CFArrayRef subject
= CFArrayCreate(kCFAllocatorDefault
, ca_dn_array
, 2, NULL
);
179 cert
= SecGenerateSelfSignedCertificate(subject
, certParams
, publicKey
, privateKey
);
182 CFRelease(certParams
);
186 DEBUG_puts("1cupsMakeServerCredentials: Unable to create self-signed certificate.");
190 ident
= SecIdentityCreate(kCFAllocatorDefault
, cert
, privateKey
);
194 _cupsMutexLock(&tls_mutex
);
199 tls_selfsigned
= ident
;
201 _cupsMutexLock(&tls_mutex
);
203 # if 0 /* Someday perhaps SecItemCopyMatching will work for identities, at which point */
204 CFTypeRef itemKeys
[] = { kSecClass
, kSecAttrLabel
, kSecValueRef
};
205 CFTypeRef itemValues
[] = { kSecClassIdentity
, cfcommon_name
, ident
};
206 CFDictionaryRef itemAttrs
= CFDictionaryCreate(kCFAllocatorDefault
, itemKeys
, itemValues
, sizeof(itemKeys
) / sizeof(itemKeys
[0]), &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
);
208 err
= SecItemAdd(itemAttrs
, NULL
);
209 /* SecItemAdd consumes itemAttrs... */
215 DEBUG_printf(("1cupsMakeServerCredentials: Unable to add identity to keychain: %d.", (int)err
));
223 DEBUG_puts("1cupsMakeServerCredentials: Unable to create identity from cert and keys.");
226 * Cleanup and return...
232 CFRelease(cfcommon_name
);
235 CFRelease(keyParams
);
241 CFRelease(publicKey
);
244 CFRelease(privateKey
);
246 DEBUG_printf(("1cupsMakeServerCredentials: Returning %d.", status
));
250 #else /* !HAVE_SECGENERATESELFSIGNEDCERTIFICATE */
251 int pid
, /* Process ID of command */
252 status
, /* Status of command */
254 char command
[1024], /* Command */
255 *argv
[5], /* Command-line arguments */
256 *envp
[1000], /* Environment variables */
257 days
[32], /* CERTTOOL_EXPIRATION_DAYS env var */
258 keychain
[1024], /* Keychain argument */
259 infofile
[1024], /* Type-in information for cert */
260 filename
[1024]; /* Default keychain path */
261 cups_file_t
*fp
; /* Seed/info file */
264 DEBUG_printf(("cupsMakeServerCredentials(path=\"%s\", common_name=\"%s\", num_alt_names=%d, alt_names=%p, expiration_date=%d)", path
, common_name
, num_alt_names
, (void *)alt_names
, (int)expiration_date
));
270 path
= http_cdsa_default_path(filename
, sizeof(filename
));
273 * Run the "certtool" command to generate a self-signed certificate...
276 if (!cupsFileFind("certtool", getenv("PATH"), 1, command
, sizeof(command
)))
280 * Create a file with the certificate information fields...
282 * Note: This assumes that the default questions are asked by the certtool
286 if ((fp
= cupsTempFile2(infofile
, sizeof(infofile
))) == NULL
)
290 "CUPS Self-Signed Certificate\n"
291 /* Enter key and certificate label */
292 "r\n" /* Generate RSA key pair */
293 "2048\n" /* 2048 bit encryption key */
294 "y\n" /* OK (y = yes) */
295 "b\n" /* Usage (b=signing/encryption) */
296 "2\n" /* Sign with SHA256 */
297 "y\n" /* OK (y = yes) */
298 "%s\n" /* Common name */
299 "\n" /* Country (default) */
300 "\n" /* Organization (default) */
301 "\n" /* Organizational unit (default) */
302 "\n" /* State/Province (default) */
303 "\n" /* Email address */
304 "y\n", /* OK (y = yes) */
308 snprintf(keychain
, sizeof(keychain
), "k=%s", path
);
310 argv
[0] = "certtool";
315 snprintf(days
, sizeof(days
), "CERTTOOL_EXPIRATION_DAYS=%d", (int)((expiration_date
- time(NULL
) + 86399) / 86400));
317 for (i
= 0; i
< (int)(sizeof(envp
) / sizeof(envp
[0]) - 2) && environ
[i
]; i
++)
318 envp
[i
+ 1] = environ
[i
];
321 posix_spawn_file_actions_t actions
; /* File actions */
323 posix_spawn_file_actions_init(&actions
);
324 posix_spawn_file_actions_addclose(&actions
, 0);
325 posix_spawn_file_actions_addopen(&actions
, 0, infofile
, O_RDONLY
, 0);
326 posix_spawn_file_actions_addclose(&actions
, 1);
327 posix_spawn_file_actions_addopen(&actions
, 1, "/dev/null", O_WRONLY
, 0);
328 posix_spawn_file_actions_addclose(&actions
, 2);
329 posix_spawn_file_actions_addopen(&actions
, 2, "/dev/null", O_WRONLY
, 0);
331 if (posix_spawn(&pid
, command
, &actions
, NULL
, argv
, envp
))
337 posix_spawn_file_actions_destroy(&actions
);
341 while (waitpid(pid
, &status
, 0) < 0)
349 #endif /* HAVE_SECGENERATESELFSIGNEDCERTIFICATE && HAVE_SECKEYCHAINOPEN */
354 * 'cupsSetServerCredentials()' - Set the default server credentials.
356 * Note: The server credentials are used by all threads in the running process.
357 * This function is threadsafe.
359 * @since CUPS 2.0/macOS 10.10@
362 int /* O - 1 on success, 0 on failure */
363 cupsSetServerCredentials(
364 const char *path
, /* I - Keychain path or @code NULL@ for default */
365 const char *common_name
, /* I - Default common name for server */
366 int auto_create
) /* I - 1 = automatically create self-signed certificates */
368 DEBUG_printf(("cupsSetServerCredentials(path=\"%s\", common_name=\"%s\", auto_create=%d)", path
, common_name
, auto_create
));
370 #ifdef HAVE_SECKEYCHAINOPEN
371 char filename
[1024]; /* Keychain filename */
372 SecKeychainRef keychain
= http_cdsa_open_keychain(path
, filename
, sizeof(filename
));
376 DEBUG_puts("1cupsSetServerCredentials: Unable to open keychain.");
380 _cupsMutexLock(&tls_mutex
);
383 * Close any keychain that is currently open...
387 CFRelease(tls_keychain
);
390 _cupsStrFree(tls_keypath
);
393 _cupsStrFree(tls_common_name
);
396 * Save the new keychain...
399 tls_keychain
= keychain
;
400 tls_keypath
= _cupsStrAlloc(filename
);
401 tls_auto_create
= auto_create
;
402 tls_common_name
= _cupsStrAlloc(common_name
);
404 _cupsMutexUnlock(&tls_mutex
);
406 DEBUG_puts("1cupsSetServerCredentials: Opened keychain, returning 1.");
412 DEBUG_puts("1cupsSetServerCredentials: No keychain support compiled in, returning 0.");
416 tls_auto_create
= auto_create
;
417 tls_common_name
= _cupsStrAlloc(common_name
);
420 #endif /* HAVE_SECKEYCHAINOPEN */
425 * 'httpCopyCredentials()' - Copy the credentials associated with the peer in
426 * an encrypted connection.
428 * @since CUPS 1.5/macOS 10.7@
431 int /* O - Status of call (0 = success) */
433 http_t
*http
, /* I - Connection to server */
434 cups_array_t
**credentials
) /* O - Array of credentials */
436 OSStatus error
; /* Error code */
437 SecTrustRef peerTrust
; /* Peer trust reference */
438 CFIndex count
; /* Number of credentials */
439 SecCertificateRef secCert
; /* Certificate reference */
440 CFDataRef data
; /* Certificate data */
441 int i
; /* Looping var */
444 DEBUG_printf(("httpCopyCredentials(http=%p, credentials=%p)", (void *)http
, (void *)credentials
));
449 if (!http
|| !http
->tls
|| !credentials
)
452 if (!(error
= SSLCopyPeerTrust(http
->tls
, &peerTrust
)) && peerTrust
)
454 DEBUG_printf(("2httpCopyCredentials: Peer provided %d certificates.", (int)SecTrustGetCertificateCount(peerTrust
)));
456 if ((*credentials
= cupsArrayNew(NULL
, NULL
)) != NULL
)
458 count
= SecTrustGetCertificateCount(peerTrust
);
460 for (i
= 0; i
< count
; i
++)
462 secCert
= SecTrustGetCertificateAtIndex(peerTrust
, i
);
465 CFStringRef cf_name
= SecCertificateCopySubjectSummary(secCert
);
468 CFStringGetCString(cf_name
, name
, sizeof(name
), kCFStringEncodingUTF8
);
470 strlcpy(name
, "unknown", sizeof(name
));
472 DEBUG_printf(("2httpCopyCredentials: Certificate %d name is \"%s\".", i
, name
));
475 if ((data
= SecCertificateCopyData(secCert
)) != NULL
)
477 DEBUG_printf(("2httpCopyCredentials: Adding %d byte certificate blob.", (int)CFDataGetLength(data
)));
479 httpAddCredential(*credentials
, CFDataGetBytePtr(data
), (size_t)CFDataGetLength(data
));
485 CFRelease(peerTrust
);
493 * '_httpCreateCredentials()' - Create credentials in the internal format.
496 http_tls_credentials_t
/* O - Internal credentials */
497 _httpCreateCredentials(
498 cups_array_t
*credentials
) /* I - Array of credentials */
500 CFMutableArrayRef peerCerts
; /* Peer credentials reference */
501 SecCertificateRef secCert
; /* Certificate reference */
502 http_credential_t
*credential
; /* Credential data */
508 if ((peerCerts
= CFArrayCreateMutable(kCFAllocatorDefault
,
509 cupsArrayCount(credentials
),
510 &kCFTypeArrayCallBacks
)) == NULL
)
513 for (credential
= (http_credential_t
*)cupsArrayFirst(credentials
);
515 credential
= (http_credential_t
*)cupsArrayNext(credentials
))
517 if ((secCert
= http_cdsa_create_credential(credential
)) != NULL
)
519 CFArrayAppendValue(peerCerts
, secCert
);
529 * 'httpCredentialsAreValidForName()' - Return whether the credentials are valid for the given name.
531 * @since CUPS 2.0/macOS 10.10@
534 int /* O - 1 if valid, 0 otherwise */
535 httpCredentialsAreValidForName(
536 cups_array_t
*credentials
, /* I - Credentials */
537 const char *common_name
) /* I - Name to check */
539 SecCertificateRef secCert
; /* Certificate reference */
540 CFStringRef cfcert_name
= NULL
;
541 /* Certificate's common name (CF string) */
542 char cert_name
[256]; /* Certificate's common name (C string) */
543 int valid
= 1; /* Valid name? */
546 if ((secCert
= http_cdsa_create_credential((http_credential_t
*)cupsArrayFirst(credentials
))) == NULL
)
550 * Compare the common names...
553 if ((cfcert_name
= SecCertificateCopySubjectSummary(secCert
)) == NULL
)
556 * Can't get common name, cannot be valid...
561 else if (CFStringGetCString(cfcert_name
, cert_name
, sizeof(cert_name
), kCFStringEncodingUTF8
) &&
562 _cups_strcasecmp(common_name
, cert_name
))
565 * Not an exact match for the common name, check for wildcard certs...
568 const char *domain
= strchr(common_name
, '.');
569 /* Domain in common name */
571 if (strncmp(cert_name
, "*.", 2) || !domain
|| _cups_strcasecmp(domain
, cert_name
+ 1))
574 * Not a wildcard match.
577 /* TODO: Check subject alternate names */
583 CFRelease(cfcert_name
);
592 * 'httpCredentialsGetTrust()' - Return the trust of credentials.
594 * @since CUPS 2.0/macOS 10.10@
597 http_trust_t
/* O - Level of trust */
598 httpCredentialsGetTrust(
599 cups_array_t
*credentials
, /* I - Credentials */
600 const char *common_name
) /* I - Common name for trust lookup */
602 SecCertificateRef secCert
; /* Certificate reference */
603 http_trust_t trust
= HTTP_TRUST_OK
;
605 cups_array_t
*tcreds
= NULL
; /* Trusted credentials */
606 _cups_globals_t
*cg
= _cupsGlobals();
607 /* Per-thread globals */
612 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No common name specified."), 1);
613 return (HTTP_TRUST_UNKNOWN
);
616 if ((secCert
= http_cdsa_create_credential((http_credential_t
*)cupsArrayFirst(credentials
))) == NULL
)
618 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unable to create credentials from array."), 1);
619 return (HTTP_TRUST_UNKNOWN
);
622 if (cg
->any_root
< 0)
626 * Look this common name up in the default keychains...
629 httpLoadCredentials(NULL
, &tcreds
, common_name
);
633 char credentials_str
[1024], /* String for incoming credentials */
634 tcreds_str
[1024]; /* String for saved credentials */
636 httpCredentialsString(credentials
, credentials_str
, sizeof(credentials_str
));
637 httpCredentialsString(tcreds
, tcreds_str
, sizeof(tcreds_str
));
639 if (strcmp(credentials_str
, tcreds_str
))
642 * Credentials don't match, let's look at the expiration date of the new
643 * credentials and allow if the new ones have a later expiration...
646 if (!cg
->trust_first
)
649 * Do not trust certificates on first use...
652 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Trust on first use is disabled."), 1);
654 trust
= HTTP_TRUST_INVALID
;
656 else if (httpCredentialsGetExpiration(credentials
) <= httpCredentialsGetExpiration(tcreds
))
659 * The new credentials are not newly issued...
662 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("New credentials are older than stored credentials."), 1);
664 trust
= HTTP_TRUST_INVALID
;
666 else if (!httpCredentialsAreValidForName(credentials
, common_name
))
669 * The common name does not match the issued certificate...
672 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("New credentials are not valid for name."), 1);
674 trust
= HTTP_TRUST_INVALID
;
676 else if (httpCredentialsGetExpiration(tcreds
) < time(NULL
))
679 * Save the renewed credentials...
682 trust
= HTTP_TRUST_RENEWED
;
684 httpSaveCredentials(NULL
, credentials
, common_name
);
688 httpFreeCredentials(tcreds
);
690 else if (cg
->validate_certs
&& !httpCredentialsAreValidForName(credentials
, common_name
))
692 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No stored credentials, not valid for name."), 1);
693 trust
= HTTP_TRUST_INVALID
;
695 else if (!cg
->trust_first
)
698 * See if we have a site CA certificate we can compare...
701 if (!httpLoadCredentials(NULL
, &tcreds
, "site"))
703 if (cupsArrayCount(credentials
) != (cupsArrayCount(tcreds
) + 1))
706 * Certificate isn't directly generated from the CA cert...
709 trust
= HTTP_TRUST_INVALID
;
714 * Do a tail comparison of the two certificates...
717 http_credential_t
*a
, *b
; /* Certificates */
719 for (a
= (http_credential_t
*)cupsArrayFirst(tcreds
), b
= (http_credential_t
*)cupsArrayIndex(credentials
, 1);
721 a
= (http_credential_t
*)cupsArrayNext(tcreds
), b
= (http_credential_t
*)cupsArrayNext(credentials
))
722 if (a
->datalen
!= b
->datalen
|| memcmp(a
->data
, b
->data
, a
->datalen
))
726 trust
= HTTP_TRUST_INVALID
;
729 if (trust
!= HTTP_TRUST_OK
)
730 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Credentials do not validate against site CA certificate."), 1);
734 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Trust on first use is disabled."), 1);
735 trust
= HTTP_TRUST_INVALID
;
739 if (trust
== HTTP_TRUST_OK
&& !cg
->expired_certs
&& !SecCertificateIsValid(secCert
, CFAbsoluteTimeGetCurrent()))
741 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Credentials have expired."), 1);
742 trust
= HTTP_TRUST_EXPIRED
;
745 if (trust
== HTTP_TRUST_OK
&& !cg
->any_root
&& cupsArrayCount(credentials
) == 1)
747 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Self-signed credentials are blocked."), 1);
748 trust
= HTTP_TRUST_INVALID
;
758 * 'httpCredentialsGetExpiration()' - Return the expiration date of the credentials.
760 * @since CUPS 2.0/macOS 10.10@
763 time_t /* O - Expiration date of credentials */
764 httpCredentialsGetExpiration(
765 cups_array_t
*credentials
) /* I - Credentials */
767 SecCertificateRef secCert
; /* Certificate reference */
768 time_t expiration
; /* Expiration date */
771 if ((secCert
= http_cdsa_create_credential((http_credential_t
*)cupsArrayFirst(credentials
))) == NULL
)
774 expiration
= (time_t)(SecCertificateNotValidAfter(secCert
) + kCFAbsoluteTimeIntervalSince1970
);
783 * 'httpCredentialsString()' - Return a string representing the credentials.
785 * @since CUPS 2.0/macOS 10.10@
788 size_t /* O - Total size of credentials string */
789 httpCredentialsString(
790 cups_array_t
*credentials
, /* I - Credentials */
791 char *buffer
, /* I - Buffer or @code NULL@ */
792 size_t bufsize
) /* I - Size of buffer */
794 http_credential_t
*first
; /* First certificate */
795 SecCertificateRef secCert
; /* Certificate reference */
798 DEBUG_printf(("httpCredentialsString(credentials=%p, buffer=%p, bufsize=" CUPS_LLFMT
")", (void *)credentials
, (void *)buffer
, CUPS_LLCAST bufsize
));
803 if (buffer
&& bufsize
> 0)
806 if ((first
= (http_credential_t
*)cupsArrayFirst(credentials
)) != NULL
&&
807 (secCert
= http_cdsa_create_credential(first
)) != NULL
)
809 CFStringRef cf_name
; /* CF common name string */
810 char name
[256]; /* Common name associated with cert */
811 time_t expiration
; /* Expiration date of cert */
812 _cups_md5_state_t md5_state
; /* MD5 state */
813 unsigned char md5_digest
[16]; /* MD5 result */
815 if ((cf_name
= SecCertificateCopySubjectSummary(secCert
)) != NULL
)
817 CFStringGetCString(cf_name
, name
, (CFIndex
)sizeof(name
), kCFStringEncodingUTF8
);
821 strlcpy(name
, "unknown", sizeof(name
));
823 expiration
= (time_t)(SecCertificateNotValidAfter(secCert
) + kCFAbsoluteTimeIntervalSince1970
);
825 _cupsMD5Init(&md5_state
);
826 _cupsMD5Append(&md5_state
, first
->data
, (int)first
->datalen
);
827 _cupsMD5Finish(&md5_state
, md5_digest
);
829 snprintf(buffer
, bufsize
, "%s / %s / %02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X", name
, httpGetDateString(expiration
), md5_digest
[0], md5_digest
[1], md5_digest
[2], md5_digest
[3], md5_digest
[4], md5_digest
[5], md5_digest
[6], md5_digest
[7], md5_digest
[8], md5_digest
[9], md5_digest
[10], md5_digest
[11], md5_digest
[12], md5_digest
[13], md5_digest
[14], md5_digest
[15]);
834 DEBUG_printf(("1httpCredentialsString: Returning \"%s\".", buffer
));
836 return (strlen(buffer
));
841 * '_httpFreeCredentials()' - Free internal credentials.
845 _httpFreeCredentials(
846 http_tls_credentials_t credentials
) /* I - Internal credentials */
851 CFRelease(credentials
);
856 * 'httpLoadCredentials()' - Load X.509 credentials from a keychain file.
858 * @since CUPS 2.0/OS 10.10@
861 int /* O - 0 on success, -1 on error */
863 const char *path
, /* I - Keychain path or @code NULL@ for default */
864 cups_array_t
**credentials
, /* IO - Credentials */
865 const char *common_name
) /* I - Common name for credentials */
867 OSStatus err
; /* Error info */
868 #ifdef HAVE_SECKEYCHAINOPEN
869 char filename
[1024]; /* Filename for keychain */
870 SecKeychainRef keychain
= NULL
,/* Keychain reference */
871 syschain
= NULL
;/* System keychain */
872 CFArrayRef list
; /* Keychain list */
873 #endif /* HAVE_SECKEYCHAINOPEN */
874 SecCertificateRef cert
= NULL
; /* Certificate */
875 CFDataRef data
; /* Certificate data */
876 SecPolicyRef policy
= NULL
; /* Policy ref */
877 CFStringRef cfcommon_name
= NULL
;
879 CFMutableDictionaryRef query
= NULL
; /* Query qualifiers */
882 DEBUG_printf(("httpLoadCredentials(path=\"%s\", credentials=%p, common_name=\"%s\")", path
, (void *)credentials
, common_name
));
889 #ifdef HAVE_SECKEYCHAINOPEN
890 keychain
= http_cdsa_open_keychain(path
, filename
, sizeof(filename
));
895 syschain
= http_cdsa_open_system_keychain();
900 #endif /* HAVE_SECKEYCHAINOPEN */
902 cfcommon_name
= CFStringCreateWithCString(kCFAllocatorDefault
, common_name
, kCFStringEncodingUTF8
);
904 policy
= SecPolicyCreateSSL(1, cfcommon_name
);
907 CFRelease(cfcommon_name
);
912 if (!(query
= CFDictionaryCreateMutable(kCFAllocatorDefault
, 0, &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
)))
915 CFDictionaryAddValue(query
, kSecClass
, kSecClassCertificate
);
916 CFDictionaryAddValue(query
, kSecMatchPolicy
, policy
);
917 CFDictionaryAddValue(query
, kSecReturnRef
, kCFBooleanTrue
);
918 CFDictionaryAddValue(query
, kSecMatchLimit
, kSecMatchLimitOne
);
920 #ifdef HAVE_SECKEYCHAINOPEN
923 const void *values
[2] = { syschain
, keychain
};
925 list
= CFArrayCreate(kCFAllocatorDefault
, (const void **)values
, 2, &kCFTypeArrayCallBacks
);
928 list
= CFArrayCreate(kCFAllocatorDefault
, (const void **)&keychain
, 1, &kCFTypeArrayCallBacks
);
929 CFDictionaryAddValue(query
, kSecMatchSearchList
, list
);
931 #endif /* HAVE_SECKEYCHAINOPEN */
933 err
= SecItemCopyMatching(query
, (CFTypeRef
*)&cert
);
938 if (CFGetTypeID(cert
) != SecCertificateGetTypeID())
941 if ((data
= SecCertificateCopyData(cert
)) != NULL
)
943 DEBUG_printf(("1httpLoadCredentials: Adding %d byte certificate blob.", (int)CFDataGetLength(data
)));
945 *credentials
= cupsArrayNew(NULL
, NULL
);
946 httpAddCredential(*credentials
, CFDataGetBytePtr(data
), (size_t)CFDataGetLength(data
));
952 #ifdef HAVE_SECKEYCHAINOPEN
958 #endif /* HAVE_SECKEYCHAINOPEN */
966 DEBUG_printf(("1httpLoadCredentials: Returning %d.", *credentials
? 0 : -1));
968 return (*credentials
? 0 : -1);
973 * 'httpSaveCredentials()' - Save X.509 credentials to a keychain file.
975 * @since CUPS 2.0/OS 10.10@
978 int /* O - -1 on error, 0 on success */
980 const char *path
, /* I - Keychain path or @code NULL@ for default */
981 cups_array_t
*credentials
, /* I - Credentials */
982 const char *common_name
) /* I - Common name for credentials */
984 int ret
= -1; /* Return value */
985 OSStatus err
; /* Error info */
986 #ifdef HAVE_SECKEYCHAINOPEN
987 char filename
[1024]; /* Filename for keychain */
988 SecKeychainRef keychain
= NULL
;/* Keychain reference */
989 CFArrayRef list
; /* Keychain list */
990 #endif /* HAVE_SECKEYCHAINOPEN */
991 SecCertificateRef cert
= NULL
; /* Certificate */
992 CFMutableDictionaryRef attrs
= NULL
; /* Attributes for add */
995 DEBUG_printf(("httpSaveCredentials(path=\"%s\", credentials=%p, common_name=\"%s\")", path
, (void *)credentials
, common_name
));
999 if (!httpCredentialsAreValidForName(credentials
, common_name
))
1001 DEBUG_puts("1httpSaveCredentials: Common name does not match.");
1005 if ((cert
= http_cdsa_create_credential((http_credential_t
*)cupsArrayFirst(credentials
))) == NULL
)
1007 DEBUG_puts("1httpSaveCredentials: Unable to create certificate.");
1011 #ifdef HAVE_SECKEYCHAINOPEN
1012 keychain
= http_cdsa_open_keychain(path
, filename
, sizeof(filename
));
1020 #endif /* HAVE_SECKEYCHAINOPEN */
1022 if ((attrs
= CFDictionaryCreateMutable(kCFAllocatorDefault
, 0, &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
)) == NULL
)
1024 DEBUG_puts("1httpSaveCredentials: Unable to create dictionary.");
1028 CFDictionaryAddValue(attrs
, kSecClass
, kSecClassCertificate
);
1029 CFDictionaryAddValue(attrs
, kSecValueRef
, cert
);
1031 #ifdef HAVE_SECKEYCHAINOPEN
1032 if ((list
= CFArrayCreate(kCFAllocatorDefault
, (const void **)&keychain
, 1, &kCFTypeArrayCallBacks
)) == NULL
)
1034 DEBUG_puts("1httpSaveCredentials: Unable to create list of keychains.");
1037 CFDictionaryAddValue(attrs
, kSecMatchSearchList
, list
);
1039 #endif /* HAVE_SECKEYCHAINOPEN */
1041 /* Note: SecItemAdd consumes "attrs"... */
1042 err
= SecItemAdd(attrs
, NULL
);
1043 DEBUG_printf(("1httpSaveCredentials: SecItemAdd returned %d.", (int)err
));
1047 #ifdef HAVE_SECKEYCHAINOPEN
1049 CFRelease(keychain
);
1050 #endif /* HAVE_SECKEYCHAINOPEN */
1054 DEBUG_printf(("1httpSaveCredentials: Returning %d.", ret
));
1061 * '_httpTLSInitialize()' - Initialize the TLS stack.
1065 _httpTLSInitialize(void)
1074 * '_httpTLSPending()' - Return the number of pending TLS-encrypted bytes.
1078 _httpTLSPending(http_t
*http
) /* I - HTTP connection */
1080 size_t bytes
; /* Bytes that are available */
1083 if (!SSLGetBufferedReadSize(http
->tls
, &bytes
))
1091 * '_httpTLSRead()' - Read from a SSL/TLS connection.
1094 int /* O - Bytes read */
1095 _httpTLSRead(http_t
*http
, /* I - HTTP connection */
1096 char *buf
, /* I - Buffer to store data */
1097 int len
) /* I - Length of buffer */
1099 int result
; /* Return value */
1100 OSStatus error
; /* Error info */
1101 size_t processed
; /* Number of bytes processed */
1104 error
= SSLRead(http
->tls
, buf
, (size_t)len
, &processed
);
1105 DEBUG_printf(("6_httpTLSRead: error=%d, processed=%d", (int)error
,
1110 result
= (int)processed
;
1113 case errSSLWouldBlock
:
1115 result
= (int)processed
;
1123 case errSSLClosedGraceful
:
1126 result
= (int)processed
;
1140 * '_httpTLSSetOptions()' - Set TLS protocol and cipher suite options.
1144 _httpTLSSetOptions(int options
, /* I - Options */
1145 int min_version
, /* I - Minimum TLS version */
1146 int max_version
) /* I - Maximum TLS version */
1148 if (!(options
& _HTTP_TLS_SET_DEFAULT
) || tls_options
< 0)
1150 tls_options
= options
;
1151 tls_min_version
= min_version
;
1152 tls_max_version
= max_version
;
1158 * '_httpTLSStart()' - Set up SSL/TLS support on a connection.
1161 int /* O - 0 on success, -1 on failure */
1162 _httpTLSStart(http_t
*http
) /* I - HTTP connection */
1164 char hostname
[256], /* Hostname */
1165 *hostptr
; /* Pointer into hostname */
1166 _cups_globals_t
*cg
= _cupsGlobals();
1167 /* Pointer to library globals */
1168 OSStatus error
; /* Error code */
1169 const char *message
= NULL
;/* Error message */
1170 cups_array_t
*credentials
; /* Credentials array */
1171 cups_array_t
*names
; /* CUPS distinguished names */
1172 CFArrayRef dn_array
; /* CF distinguished names array */
1173 CFIndex count
; /* Number of credentials */
1174 CFDataRef data
; /* Certificate data */
1175 int i
; /* Looping var */
1176 http_credential_t
*credential
; /* Credential data */
1179 DEBUG_printf(("3_httpTLSStart(http=%p)", (void *)http
));
1181 if (tls_options
< 0)
1183 DEBUG_puts("4_httpTLSStart: Setting defaults.");
1185 DEBUG_printf(("4_httpTLSStart: tls_options=%x, tls_min_version=%d, tls_max_version=%d", tls_options
, tls_min_version
, tls_max_version
));
1188 #ifdef HAVE_SECKEYCHAINOPEN
1189 if (http
->mode
== _HTTP_MODE_SERVER
&& !tls_keychain
)
1191 DEBUG_puts("4_httpTLSStart: cupsSetServerCredentials not called.");
1192 http
->error
= errno
= EINVAL
;
1193 http
->status
= HTTP_STATUS_ERROR
;
1194 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Server credentials not set."), 1);
1198 #endif /* HAVE_SECKEYCHAINOPEN */
1200 if ((http
->tls
= SSLCreateContext(kCFAllocatorDefault
, http
->mode
== _HTTP_MODE_CLIENT
? kSSLClientSide
: kSSLServerSide
, kSSLStreamType
)) == NULL
)
1202 DEBUG_puts("4_httpTLSStart: SSLCreateContext failed.");
1203 http
->error
= errno
= ENOMEM
;
1204 http
->status
= HTTP_STATUS_ERROR
;
1205 _cupsSetHTTPError(HTTP_STATUS_ERROR
);
1210 error
= SSLSetConnection(http
->tls
, http
);
1211 DEBUG_printf(("4_httpTLSStart: SSLSetConnection, error=%d", (int)error
));
1215 error
= SSLSetIOFuncs(http
->tls
, http_cdsa_read
, http_cdsa_write
);
1216 DEBUG_printf(("4_httpTLSStart: SSLSetIOFuncs, error=%d", (int)error
));
1221 error
= SSLSetSessionOption(http
->tls
, kSSLSessionOptionBreakOnServerAuth
,
1223 DEBUG_printf(("4_httpTLSStart: SSLSetSessionOption, error=%d", (int)error
));
1228 static const SSLProtocol protocols
[] = /* Min/max protocol versions */
1235 kTLSProtocolMaxSupported
1238 error
= SSLSetProtocolVersionMin(http
->tls
, protocols
[tls_min_version
]);
1239 DEBUG_printf(("4_httpTLSStart: SSLSetProtocolVersionMin(%d), error=%d", protocols
[tls_min_version
], (int)error
));
1243 error
= SSLSetProtocolVersionMax(http
->tls
, protocols
[tls_max_version
]);
1244 DEBUG_printf(("4_httpTLSStart: SSLSetProtocolVersionMax(%d), error=%d", protocols
[tls_max_version
], (int)error
));
1248 # if HAVE_SSLSETENABLEDCIPHERS
1251 SSLCipherSuite supported
[100]; /* Supported cipher suites */
1252 size_t num_supported
; /* Number of supported cipher suites */
1253 SSLCipherSuite enabled
[100]; /* Cipher suites to enable */
1254 size_t num_enabled
; /* Number of cipher suites to enable */
1256 num_supported
= sizeof(supported
) / sizeof(supported
[0]);
1257 error
= SSLGetSupportedCiphers(http
->tls
, supported
, &num_supported
);
1261 DEBUG_printf(("4_httpTLSStart: %d cipher suites supported.", (int)num_supported
));
1263 for (i
= 0, num_enabled
= 0; i
< (int)num_supported
&& num_enabled
< (sizeof(enabled
) / sizeof(enabled
[0])); i
++)
1265 switch (supported
[i
])
1267 /* Obviously insecure cipher suites that we never want to use */
1268 case SSL_NULL_WITH_NULL_NULL
:
1269 case SSL_RSA_WITH_NULL_MD5
:
1270 case SSL_RSA_WITH_NULL_SHA
:
1271 case SSL_RSA_EXPORT_WITH_RC4_40_MD5
:
1272 case SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5
:
1273 case SSL_RSA_EXPORT_WITH_DES40_CBC_SHA
:
1274 case SSL_RSA_WITH_DES_CBC_SHA
:
1275 case SSL_DH_DSS_EXPORT_WITH_DES40_CBC_SHA
:
1276 case SSL_DH_DSS_WITH_DES_CBC_SHA
:
1277 case SSL_DH_RSA_EXPORT_WITH_DES40_CBC_SHA
:
1278 case SSL_DH_RSA_WITH_DES_CBC_SHA
:
1279 case SSL_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA
:
1280 case SSL_DHE_DSS_WITH_DES_CBC_SHA
:
1281 case SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA
:
1282 case SSL_DHE_RSA_WITH_DES_CBC_SHA
:
1283 case SSL_DH_anon_EXPORT_WITH_RC4_40_MD5
:
1284 case SSL_DH_anon_WITH_RC4_128_MD5
:
1285 case SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA
:
1286 case SSL_DH_anon_WITH_DES_CBC_SHA
:
1287 case SSL_DH_anon_WITH_3DES_EDE_CBC_SHA
:
1288 case SSL_FORTEZZA_DMS_WITH_NULL_SHA
:
1289 case TLS_DH_anon_WITH_AES_128_CBC_SHA
:
1290 case TLS_DH_anon_WITH_AES_256_CBC_SHA
:
1291 case TLS_ECDH_ECDSA_WITH_NULL_SHA
:
1292 case TLS_ECDHE_RSA_WITH_NULL_SHA
:
1293 case TLS_ECDH_anon_WITH_NULL_SHA
:
1294 case TLS_ECDH_anon_WITH_RC4_128_SHA
:
1295 case TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA
:
1296 case TLS_ECDH_anon_WITH_AES_128_CBC_SHA
:
1297 case TLS_ECDH_anon_WITH_AES_256_CBC_SHA
:
1298 case TLS_RSA_WITH_NULL_SHA256
:
1299 case TLS_DH_anon_WITH_AES_128_CBC_SHA256
:
1300 case TLS_DH_anon_WITH_AES_256_CBC_SHA256
:
1301 case TLS_PSK_WITH_NULL_SHA
:
1302 case TLS_DHE_PSK_WITH_NULL_SHA
:
1303 case TLS_RSA_PSK_WITH_NULL_SHA
:
1304 case TLS_DH_anon_WITH_AES_128_GCM_SHA256
:
1305 case TLS_DH_anon_WITH_AES_256_GCM_SHA384
:
1306 case TLS_PSK_WITH_NULL_SHA256
:
1307 case TLS_PSK_WITH_NULL_SHA384
:
1308 case TLS_DHE_PSK_WITH_NULL_SHA256
:
1309 case TLS_DHE_PSK_WITH_NULL_SHA384
:
1310 case TLS_RSA_PSK_WITH_NULL_SHA256
:
1311 case TLS_RSA_PSK_WITH_NULL_SHA384
:
1312 case SSL_RSA_WITH_DES_CBC_MD5
:
1313 DEBUG_printf(("4_httpTLSStart: Excluding insecure cipher suite %d", supported
[i
]));
1316 /* RC4 cipher suites that should only be used as a last resort */
1317 case SSL_RSA_WITH_RC4_128_MD5
:
1318 case SSL_RSA_WITH_RC4_128_SHA
:
1319 case TLS_ECDH_ECDSA_WITH_RC4_128_SHA
:
1320 case TLS_ECDHE_ECDSA_WITH_RC4_128_SHA
:
1321 case TLS_ECDH_RSA_WITH_RC4_128_SHA
:
1322 case TLS_ECDHE_RSA_WITH_RC4_128_SHA
:
1323 case TLS_PSK_WITH_RC4_128_SHA
:
1324 case TLS_DHE_PSK_WITH_RC4_128_SHA
:
1325 case TLS_RSA_PSK_WITH_RC4_128_SHA
:
1326 if (tls_options
& _HTTP_TLS_ALLOW_RC4
)
1327 enabled
[num_enabled
++] = supported
[i
];
1329 DEBUG_printf(("4_httpTLSStart: Excluding RC4 cipher suite %d", supported
[i
]));
1332 /* DH/DHE cipher suites that are problematic with parameters < 1024 bits */
1333 case TLS_DH_DSS_WITH_AES_128_CBC_SHA
:
1334 case TLS_DH_RSA_WITH_AES_128_CBC_SHA
:
1335 case TLS_DHE_DSS_WITH_AES_128_CBC_SHA
:
1336 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA
:
1337 case TLS_DH_DSS_WITH_AES_256_CBC_SHA
:
1338 case TLS_DH_RSA_WITH_AES_256_CBC_SHA
:
1339 case TLS_DHE_DSS_WITH_AES_256_CBC_SHA
:
1340 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA
:
1341 case TLS_DH_DSS_WITH_3DES_EDE_CBC_SHA
:
1342 case TLS_DH_RSA_WITH_3DES_EDE_CBC_SHA
:
1343 case TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA
:
1344 case TLS_DH_DSS_WITH_AES_128_CBC_SHA256
:
1345 case TLS_DH_RSA_WITH_AES_128_CBC_SHA256
:
1346 case TLS_DHE_DSS_WITH_AES_128_CBC_SHA256
:
1347 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
:
1348 case TLS_DH_DSS_WITH_AES_256_CBC_SHA256
:
1349 case TLS_DH_RSA_WITH_AES_256_CBC_SHA256
:
1350 case TLS_DHE_DSS_WITH_AES_256_CBC_SHA256
:
1351 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
:
1352 case TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA
:
1353 case TLS_DHE_PSK_WITH_AES_128_CBC_SHA
:
1354 case TLS_DHE_PSK_WITH_AES_256_CBC_SHA
:
1355 case TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
:
1356 case TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
:
1357 if (tls_options
& _HTTP_TLS_DENY_CBC
)
1359 DEBUG_printf(("4_httpTLSStart: Excluding CBC cipher suite %d", supported
[i
]));
1363 // case TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 :
1364 // case TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 :
1365 case TLS_DH_RSA_WITH_AES_128_GCM_SHA256
:
1366 case TLS_DH_RSA_WITH_AES_256_GCM_SHA384
:
1367 // case TLS_DHE_DSS_WITH_AES_128_GCM_SHA256 :
1368 // case TLS_DHE_DSS_WITH_AES_256_GCM_SHA384 :
1369 case TLS_DH_DSS_WITH_AES_128_GCM_SHA256
:
1370 case TLS_DH_DSS_WITH_AES_256_GCM_SHA384
:
1371 case TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
:
1372 case TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
:
1373 if (tls_options
& _HTTP_TLS_ALLOW_DH
)
1374 enabled
[num_enabled
++] = supported
[i
];
1376 DEBUG_printf(("4_httpTLSStart: Excluding DH/DHE cipher suite %d", supported
[i
]));
1379 case TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA
:
1380 case TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
:
1381 case TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
:
1382 case TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256
:
1383 case TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384
:
1384 case TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
:
1385 case TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
:
1386 case TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256
:
1387 case TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384
:
1388 case TLS_RSA_WITH_3DES_EDE_CBC_SHA
:
1389 case TLS_RSA_WITH_AES_128_CBC_SHA
:
1390 case TLS_RSA_WITH_AES_256_CBC_SHA
:
1391 if (tls_options
& _HTTP_TLS_DENY_CBC
)
1393 DEBUG_printf(("4_httpTLSStart: Excluding CBC cipher suite %d", supported
[i
]));
1397 /* Anything else we'll assume is "secure" */
1399 enabled
[num_enabled
++] = supported
[i
];
1404 DEBUG_printf(("4_httpTLSStart: %d cipher suites enabled.", (int)num_enabled
));
1405 error
= SSLSetEnabledCiphers(http
->tls
, enabled
, num_enabled
);
1408 #endif /* HAVE_SSLSETENABLEDCIPHERS */
1410 if (!error
&& http
->mode
== _HTTP_MODE_CLIENT
)
1413 * Client: set client-side credentials, if any...
1416 if (cg
->client_cert_cb
)
1418 error
= SSLSetSessionOption(http
->tls
,
1419 kSSLSessionOptionBreakOnCertRequested
, true);
1420 DEBUG_printf(("4_httpTLSStart: kSSLSessionOptionBreakOnCertRequested, "
1421 "error=%d", (int)error
));
1425 error
= http_cdsa_set_credentials(http
);
1426 DEBUG_printf(("4_httpTLSStart: http_cdsa_set_credentials, error=%d",
1433 * Server: find/create a certificate for TLS...
1436 if (http
->fields
[HTTP_FIELD_HOST
][0])
1439 * Use hostname for TLS upgrade...
1442 strlcpy(hostname
, http
->fields
[HTTP_FIELD_HOST
], sizeof(hostname
));
1447 * Resolve hostname from connection address...
1450 http_addr_t addr
; /* Connection address */
1451 socklen_t addrlen
; /* Length of address */
1453 addrlen
= sizeof(addr
);
1454 if (getsockname(http
->fd
, (struct sockaddr
*)&addr
, &addrlen
))
1456 DEBUG_printf(("4_httpTLSStart: Unable to get socket address: %s", strerror(errno
)));
1459 else if (httpAddrLocalhost(&addr
))
1463 httpAddrLookup(&addr
, hostname
, sizeof(hostname
));
1464 DEBUG_printf(("4_httpTLSStart: Resolved socket address to \"%s\".", hostname
));
1468 if (isdigit(hostname
[0] & 255) || hostname
[0] == '[')
1469 hostname
[0] = '\0'; /* Don't allow numeric addresses */
1472 http
->tls_credentials
= http_cdsa_copy_server(hostname
);
1473 else if (tls_common_name
)
1474 http
->tls_credentials
= http_cdsa_copy_server(tls_common_name
);
1476 if (!http
->tls_credentials
&& tls_auto_create
&& (hostname
[0] || tls_common_name
))
1478 DEBUG_printf(("4_httpTLSStart: Auto-create credentials for \"%s\".", hostname
[0] ? hostname
: tls_common_name
));
1480 if (!cupsMakeServerCredentials(tls_keypath
, hostname
[0] ? hostname
: tls_common_name
, 0, NULL
, time(NULL
) + 365 * 86400))
1482 DEBUG_puts("4_httpTLSStart: cupsMakeServerCredentials failed.");
1483 http
->error
= errno
= EINVAL
;
1484 http
->status
= HTTP_STATUS_ERROR
;
1485 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unable to create server credentials."), 1);
1490 http
->tls_credentials
= http_cdsa_copy_server(hostname
[0] ? hostname
: tls_common_name
);
1493 if (!http
->tls_credentials
)
1495 DEBUG_puts("4_httpTLSStart: Unable to find server credentials.");
1496 http
->error
= errno
= EINVAL
;
1497 http
->status
= HTTP_STATUS_ERROR
;
1498 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unable to find server credentials."), 1);
1503 error
= SSLSetCertificate(http
->tls
, http
->tls_credentials
);
1505 DEBUG_printf(("4_httpTLSStart: SSLSetCertificate, error=%d", (int)error
));
1508 DEBUG_printf(("4_httpTLSStart: tls_credentials=%p", (void *)http
->tls_credentials
));
1511 * Let the server know which hostname/domain we are trying to connect to
1512 * in case it wants to serve up a certificate with a matching common name.
1515 if (!error
&& http
->mode
== _HTTP_MODE_CLIENT
)
1518 * Client: get the hostname to use for TLS...
1521 if (httpAddrLocalhost(http
->hostaddr
))
1523 strlcpy(hostname
, "localhost", sizeof(hostname
));
1528 * Otherwise make sure the hostname we have does not end in a trailing dot.
1531 strlcpy(hostname
, http
->hostname
, sizeof(hostname
));
1532 if ((hostptr
= hostname
+ strlen(hostname
) - 1) >= hostname
&&
1537 error
= SSLSetPeerDomainName(http
->tls
, hostname
, strlen(hostname
));
1539 DEBUG_printf(("4_httpTLSStart: SSLSetPeerDomainName, error=%d", (int)error
));
1544 int done
= 0; /* Are we done yet? */
1546 while (!error
&& !done
)
1548 error
= SSLHandshake(http
->tls
);
1550 DEBUG_printf(("4_httpTLSStart: SSLHandshake returned %d.", (int)error
));
1558 case errSSLWouldBlock
:
1559 error
= noErr
; /* Force a retry */
1560 usleep(1000); /* in 1 millisecond */
1563 case errSSLServerAuthCompleted
:
1565 if (cg
->server_cert_cb
)
1567 error
= httpCopyCredentials(http
, &credentials
);
1570 error
= (cg
->server_cert_cb
)(http
, http
->tls
, credentials
,
1571 cg
->server_cert_data
);
1572 httpFreeCredentials(credentials
);
1575 DEBUG_printf(("4_httpTLSStart: Server certificate callback "
1576 "returned %d.", (int)error
));
1580 case errSSLClientCertRequested
:
1583 if (cg
->client_cert_cb
)
1586 if (!(error
= SSLCopyDistinguishedNames(http
->tls
, &dn_array
)) &&
1589 if ((names
= cupsArrayNew(NULL
, NULL
)) != NULL
)
1591 for (i
= 0, count
= CFArrayGetCount(dn_array
); i
< count
; i
++)
1593 data
= (CFDataRef
)CFArrayGetValueAtIndex(dn_array
, i
);
1595 if ((credential
= malloc(sizeof(*credential
))) != NULL
)
1597 credential
->datalen
= (size_t)CFDataGetLength(data
);
1598 if ((credential
->data
= malloc(credential
->datalen
)))
1600 memcpy((void *)credential
->data
, CFDataGetBytePtr(data
),
1601 credential
->datalen
);
1602 cupsArrayAdd(names
, credential
);
1610 CFRelease(dn_array
);
1615 error
= (cg
->client_cert_cb
)(http
, http
->tls
, names
,
1616 cg
->client_cert_data
);
1618 DEBUG_printf(("4_httpTLSStart: Client certificate callback "
1619 "returned %d.", (int)error
));
1622 httpFreeCredentials(names
);
1626 case errSSLUnknownRootCert
:
1627 message
= _("Unable to establish a secure connection to host "
1628 "(untrusted certificate).");
1631 case errSSLNoRootCert
:
1632 message
= _("Unable to establish a secure connection to host "
1633 "(self-signed certificate).");
1636 case errSSLCertExpired
:
1637 message
= _("Unable to establish a secure connection to host "
1638 "(expired certificate).");
1641 case errSSLCertNotYetValid
:
1642 message
= _("Unable to establish a secure connection to host "
1643 "(certificate not yet valid).");
1646 case errSSLHostNameMismatch
:
1647 message
= _("Unable to establish a secure connection to host "
1648 "(host name mismatch).");
1651 case errSSLXCertChainInvalid
:
1652 message
= _("Unable to establish a secure connection to host "
1653 "(certificate chain invalid).");
1656 case errSSLConnectionRefused
:
1657 message
= _("Unable to establish a secure connection to host "
1658 "(peer dropped connection before responding).");
1669 http
->error
= error
;
1670 http
->status
= HTTP_STATUS_ERROR
;
1671 errno
= ECONNREFUSED
;
1673 CFRelease(http
->tls
);
1677 * If an error string wasn't set by the callbacks use a generic one...
1681 #ifdef HAVE_CSSMERRORSTRING
1682 message
= cssmErrorString(error
);
1684 message
= _("Unable to establish a secure connection to host.");
1685 #endif /* HAVE_CSSMERRORSTRING */
1687 _cupsSetError(IPP_STATUS_ERROR_CUPS_PKI
, message
, 1);
1697 * '_httpTLSStop()' - Shut down SSL/TLS on a connection.
1701 _httpTLSStop(http_t
*http
) /* I - HTTP connection */
1703 while (SSLClose(http
->tls
) == errSSLWouldBlock
)
1706 CFRelease(http
->tls
);
1708 if (http
->tls_credentials
)
1709 CFRelease(http
->tls_credentials
);
1712 http
->tls_credentials
= NULL
;
1717 * '_httpTLSWrite()' - Write to a SSL/TLS connection.
1720 int /* O - Bytes written */
1721 _httpTLSWrite(http_t
*http
, /* I - HTTP connection */
1722 const char *buf
, /* I - Buffer holding data */
1723 int len
) /* I - Length of buffer */
1725 ssize_t result
; /* Return value */
1726 OSStatus error
; /* Error info */
1727 size_t processed
; /* Number of bytes processed */
1730 DEBUG_printf(("2_httpTLSWrite(http=%p, buf=%p, len=%d)", (void *)http
, (void *)buf
, len
));
1732 error
= SSLWrite(http
->tls
, buf
, (size_t)len
, &processed
);
1737 result
= (int)processed
;
1740 case errSSLWouldBlock
:
1743 result
= (int)processed
;
1752 case errSSLClosedGraceful
:
1756 result
= (int)processed
;
1766 DEBUG_printf(("3_httpTLSWrite: Returning %d.", (int)result
));
1768 return ((int)result
);
1773 * 'http_cdsa_copy_server()' - Find and copy server credentials from the keychain.
1776 static CFArrayRef
/* O - Array of certificates or NULL */
1777 http_cdsa_copy_server(
1778 const char *common_name
) /* I - Server's hostname */
1780 #ifdef HAVE_SECKEYCHAINOPEN
1781 OSStatus err
; /* Error info */
1782 SecIdentityRef identity
= NULL
;/* Identity */
1783 CFArrayRef certificates
= NULL
;
1784 /* Certificate array */
1785 SecPolicyRef policy
= NULL
; /* Policy ref */
1786 CFStringRef cfcommon_name
= NULL
;
1788 CFMutableDictionaryRef query
= NULL
; /* Query qualifiers */
1789 CFArrayRef list
= NULL
; /* Keychain list */
1790 SecKeychainRef syschain
= NULL
;/* System keychain */
1791 SecKeychainStatus status
= 0; /* Keychain status */
1794 DEBUG_printf(("3http_cdsa_copy_server(common_name=\"%s\")", common_name
));
1796 cfcommon_name
= CFStringCreateWithCString(kCFAllocatorDefault
, common_name
, kCFStringEncodingUTF8
);
1798 policy
= SecPolicyCreateSSL(1, cfcommon_name
);
1802 DEBUG_puts("4http_cdsa_copy_server: Unable to create SSL policy.");
1806 if (!(query
= CFDictionaryCreateMutable(kCFAllocatorDefault
, 0, &kCFTypeDictionaryKeyCallBacks
, &kCFTypeDictionaryValueCallBacks
)))
1808 DEBUG_puts("4http_cdsa_copy_server: Unable to create query dictionary.");
1812 _cupsMutexLock(&tls_mutex
);
1814 err
= SecKeychainGetStatus(tls_keychain
, &status
);
1816 if (err
== noErr
&& !(status
& kSecUnlockStateStatus
) && tls_cups_keychain
)
1817 SecKeychainUnlock(tls_keychain
, _CUPS_CDSA_PASSLEN
, _CUPS_CDSA_PASSWORD
, TRUE
);
1819 CFDictionaryAddValue(query
, kSecClass
, kSecClassIdentity
);
1820 CFDictionaryAddValue(query
, kSecMatchPolicy
, policy
);
1821 CFDictionaryAddValue(query
, kSecReturnRef
, kCFBooleanTrue
);
1822 CFDictionaryAddValue(query
, kSecMatchLimit
, kSecMatchLimitOne
);
1824 syschain
= http_cdsa_open_system_keychain();
1828 const void *values
[2] = { syschain
, tls_keychain
};
1830 list
= CFArrayCreate(kCFAllocatorDefault
, (const void **)values
, 2, &kCFTypeArrayCallBacks
);
1833 list
= CFArrayCreate(kCFAllocatorDefault
, (const void **)&tls_keychain
, 1, &kCFTypeArrayCallBacks
);
1835 CFDictionaryAddValue(query
, kSecMatchSearchList
, list
);
1838 err
= SecItemCopyMatching(query
, (CFTypeRef
*)&identity
);
1840 _cupsMutexUnlock(&tls_mutex
);
1844 DEBUG_printf(("4http_cdsa_copy_server: SecItemCopyMatching failed with status %d.", (int)err
));
1848 if (CFGetTypeID(identity
) != SecIdentityGetTypeID())
1850 DEBUG_puts("4http_cdsa_copy_server: Search returned something that is not an identity.");
1854 if ((certificates
= CFArrayCreate(NULL
, (const void **)&identity
, 1, &kCFTypeArrayCallBacks
)) == NULL
)
1856 DEBUG_puts("4http_cdsa_copy_server: Unable to create array of certificates.");
1863 CFRelease(syschain
);
1865 CFRelease(identity
);
1869 CFRelease(cfcommon_name
);
1873 DEBUG_printf(("4http_cdsa_copy_server: Returning %p.", (void *)certificates
));
1875 return (certificates
);
1878 if (!tls_selfsigned
)
1881 return (CFArrayCreate(NULL
, (const void **)&tls_selfsigned
, 1, &kCFTypeArrayCallBacks
));
1882 #endif /* HAVE_SECKEYCHAINOPEN */
1887 * 'http_cdsa_create_credential()' - Create a single credential in the internal format.
1890 static SecCertificateRef
/* O - Certificate */
1891 http_cdsa_create_credential(
1892 http_credential_t
*credential
) /* I - Credential */
1897 return (SecCertificateCreateWithBytes(kCFAllocatorDefault
, credential
->data
, (CFIndex
)credential
->datalen
));
1901 #ifdef HAVE_SECKEYCHAINOPEN
1903 * 'http_cdsa_default_path()' - Get the default keychain path.
1906 static const char * /* O - Keychain path */
1907 http_cdsa_default_path(char *buffer
, /* I - Path buffer */
1908 size_t bufsize
) /* I - Size of buffer */
1910 const char *home
= getenv("HOME"); /* HOME environment variable */
1914 * Determine the default keychain path. Note that the login and system
1915 * keychains are no longer accessible to user applications starting in macOS
1916 * 10.11.4 (!), so we need to create our own keychain just for CUPS.
1919 if (getuid() && home
)
1920 snprintf(buffer
, bufsize
, "%s/.cups/ssl.keychain", home
);
1922 strlcpy(buffer
, "/etc/cups/ssl.keychain", bufsize
);
1924 DEBUG_printf(("1http_cdsa_default_path: Using default path \"%s\".", buffer
));
1931 * 'http_cdsa_open_keychain()' - Open (or create) a keychain.
1934 static SecKeychainRef
/* O - Keychain or NULL */
1935 http_cdsa_open_keychain(
1936 const char *path
, /* I - Path to keychain */
1937 char *filename
, /* I - Keychain filename */
1938 size_t filesize
) /* I - Size of filename buffer */
1940 SecKeychainRef keychain
= NULL
;/* Temporary keychain */
1941 OSStatus err
; /* Error code */
1942 Boolean interaction
; /* Interaction allowed? */
1943 SecKeychainStatus status
= 0; /* Keychain status */
1947 * Get the keychain filename...
1952 path
= http_cdsa_default_path(filename
, filesize
);
1953 tls_cups_keychain
= 1;
1957 strlcpy(filename
, path
, filesize
);
1958 tls_cups_keychain
= 0;
1962 * Save the interaction setting and disable while we open the keychain...
1965 SecKeychainGetUserInteractionAllowed(&interaction
);
1966 SecKeychainSetUserInteractionAllowed(FALSE
);
1968 if (access(path
, R_OK
) && tls_cups_keychain
)
1971 * Create a new keychain at the given path...
1974 err
= SecKeychainCreate(path
, _CUPS_CDSA_PASSLEN
, _CUPS_CDSA_PASSWORD
, FALSE
, NULL
, &keychain
);
1979 * Open the existing keychain and unlock as needed...
1982 err
= SecKeychainOpen(path
, &keychain
);
1985 err
= SecKeychainGetStatus(keychain
, &status
);
1987 if (err
== noErr
&& !(status
& kSecUnlockStateStatus
) && tls_cups_keychain
)
1988 err
= SecKeychainUnlock(keychain
, _CUPS_CDSA_PASSLEN
, _CUPS_CDSA_PASSWORD
, TRUE
);
1992 * Restore interaction setting...
1995 SecKeychainSetUserInteractionAllowed(interaction
);
1998 * Release the keychain if we had any errors...
2003 /* TODO: Set cups last error string */
2004 DEBUG_printf(("4http_cdsa_open_keychain: Unable to open keychain (%d), returning NULL.", (int)err
));
2008 CFRelease(keychain
);
2014 * Return the keychain or NULL...
2022 * 'http_cdsa_open_system_keychain()' - Open the System keychain.
2025 static SecKeychainRef
2026 http_cdsa_open_system_keychain(void)
2028 SecKeychainRef keychain
= NULL
;/* Temporary keychain */
2029 OSStatus err
; /* Error code */
2030 Boolean interaction
; /* Interaction allowed? */
2031 SecKeychainStatus status
= 0; /* Keychain status */
2035 * Save the interaction setting and disable while we open the keychain...
2038 SecKeychainGetUserInteractionAllowed(&interaction
);
2039 SecKeychainSetUserInteractionAllowed(TRUE
);
2041 err
= SecKeychainOpen("/Library/Keychains/System.keychain", &keychain
);
2044 err
= SecKeychainGetStatus(keychain
, &status
);
2046 if (err
== noErr
&& !(status
& kSecUnlockStateStatus
))
2047 err
= errSecInteractionNotAllowed
;
2050 * Restore interaction setting...
2053 SecKeychainSetUserInteractionAllowed(interaction
);
2056 * Release the keychain if we had any errors...
2061 /* TODO: Set cups last error string */
2062 DEBUG_printf(("4http_cdsa_open_system_keychain: Unable to open keychain (%d), returning NULL.", (int)err
));
2066 CFRelease(keychain
);
2072 * Return the keychain or NULL...
2077 #endif /* HAVE_SECKEYCHAINOPEN */
2081 * 'http_cdsa_read()' - Read function for the CDSA library.
2084 static OSStatus
/* O - -1 on error, 0 on success */
2086 SSLConnectionRef connection
, /* I - SSL/TLS connection */
2087 void *data
, /* I - Data buffer */
2088 size_t *dataLength
) /* IO - Number of bytes */
2090 OSStatus result
; /* Return value */
2091 ssize_t bytes
; /* Number of bytes read */
2092 http_t
*http
; /* HTTP connection */
2095 http
= (http_t
*)connection
;
2097 if (!http
->blocking
)
2100 * Make sure we have data before we read...
2103 while (!_httpWait(http
, http
->wait_value
, 0))
2105 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
2108 http
->error
= ETIMEDOUT
;
2115 bytes
= recv(http
->fd
, data
, *dataLength
, 0);
2117 while (bytes
== -1 && (errno
== EINTR
|| errno
== EAGAIN
));
2119 if ((size_t)bytes
== *dataLength
)
2125 *dataLength
= (size_t)bytes
;
2126 result
= errSSLWouldBlock
;
2133 result
= errSSLClosedGraceful
;
2134 else if (errno
== EAGAIN
)
2135 result
= errSSLWouldBlock
;
2137 result
= errSSLClosedAbort
;
2145 * 'http_cdsa_set_credentials()' - Set the TLS credentials.
2148 static int /* O - Status of connection */
2149 http_cdsa_set_credentials(http_t
*http
) /* I - HTTP connection */
2151 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
2152 OSStatus error
= 0; /* Error code */
2153 http_tls_credentials_t credentials
= NULL
;
2154 /* TLS credentials */
2157 DEBUG_printf(("7http_tls_set_credentials(%p)", (void *)http
));
2160 * Prefer connection specific credentials...
2163 if ((credentials
= http
->tls_credentials
) == NULL
)
2164 credentials
= cg
->tls_credentials
;
2168 error
= SSLSetCertificate(http
->tls
, credentials
);
2169 DEBUG_printf(("4http_tls_set_credentials: SSLSetCertificate, error=%d",
2173 DEBUG_puts("4http_tls_set_credentials: No credentials to set.");
2180 * 'http_cdsa_write()' - Write function for the CDSA library.
2183 static OSStatus
/* O - -1 on error, 0 on success */
2185 SSLConnectionRef connection
, /* I - SSL/TLS connection */
2186 const void *data
, /* I - Data buffer */
2187 size_t *dataLength
) /* IO - Number of bytes */
2189 OSStatus result
; /* Return value */
2190 ssize_t bytes
; /* Number of bytes read */
2191 http_t
*http
; /* HTTP connection */
2194 http
= (http_t
*)connection
;
2198 bytes
= write(http
->fd
, data
, *dataLength
);
2200 while (bytes
== -1 && (errno
== EINTR
|| errno
== EAGAIN
));
2202 if ((size_t)bytes
== *dataLength
)
2206 else if (bytes
>= 0)
2208 *dataLength
= (size_t)bytes
;
2209 result
= errSSLWouldBlock
;
2215 if (errno
== EAGAIN
)
2216 result
= errSSLWouldBlock
;
2218 result
= errSSLClosedAbort
;