2 * Copyright (c) 2006-2013 Apple Inc. All Rights Reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
21 * @APPLE_LICENSE_HEADER_END@
25 // csutilities - miscellaneous utilities for the code signing implementation
27 #include "csutilities.h"
28 #include <Security/SecCertificatePriv.h>
29 #include <utilities/SecAppleAnchorPriv.h>
30 #include <utilities/SecInternalReleasePriv.h>
31 #include "requirement.h"
32 #include <security_utilities/hashing.h>
33 #include <security_utilities/debugging.h>
34 #include <security_utilities/errors.h>
35 #include <sys/utsname.h>
38 namespace CodeSigning
{
42 // Test for the canonical Apple CA certificate
44 bool isAppleCA(SecCertificateRef cert
)
46 SecAppleTrustAnchorFlags flags
= 0;
47 if (SecIsInternalRelease())
48 flags
|= kSecAppleTrustAnchorFlagsIncludeTestAnchors
;
49 return SecIsAppleTrustAnchor(cert
, flags
);
54 // Calculate the canonical hash of a certificate, given its raw (DER) data.
56 void hashOfCertificate(const void *certData
, size_t certLength
, SHA1::Digest digest
)
59 hasher(certData
, certLength
);
60 hasher
.finish(digest
);
65 // Ditto, given a SecCertificateRef
67 void hashOfCertificate(SecCertificateRef cert
, SHA1::Digest digest
)
72 MacOSError::check(SecCertificateGetData(cert
, &certData
));
73 hashOfCertificate(certData
.Data
, certData
.Length
, digest
);
75 hashOfCertificate(SecCertificateGetBytePtr(cert
), SecCertificateGetLength(cert
), digest
);
81 // One-stop hash-certificate-and-compare
83 bool verifyHash(SecCertificateRef cert
, const Hashing::Byte
*digest
)
86 hashOfCertificate(cert
, dig
);
87 return !memcmp(dig
, digest
, SHA1::digestLength
);
92 // Check to see if a certificate contains a particular field, by OID. This works for extensions,
93 // even ones not recognized by the local CL. It does not return any value, only presence.
95 bool certificateHasField(SecCertificateRef cert
, const CSSM_OID
&oid
)
99 switch (OSStatus rc
= SecCertificateCopyFirstFieldValue(cert
, &oid
, &value
)) {
101 MacOSError::check(SecCertificateReleaseFirstFieldValue(cert
, &oid
, value
));
102 return true; // extension found by oid
103 case errSecUnknownTag
:
104 break; // oid not recognized by CL - continue below
106 MacOSError::throwMe(rc
); // error: fail
109 // check the CL's bag of unrecognized extensions
112 if (SecCertificateCopyFieldValues(cert
, &CSSMOID_X509V3CertificateExtensionCStruct
, &values
))
113 return false; // no unrecognized extensions - no match
115 for (CSSM_DATA
**p
= values
; *p
; p
++) {
116 const CSSM_X509_EXTENSION
*ext
= (const CSSM_X509_EXTENSION
*)(*p
)->Data
;
117 if (oid
== ext
->extnId
) {
122 MacOSError::check(SecCertificateReleaseFieldValues(cert
, &CSSMOID_X509V3CertificateExtensionCStruct
, values
));
128 // Retrieve X.509 policy extension OIDs, if any.
129 // This currently ignores policy qualifiers.
131 bool certificateHasPolicy(SecCertificateRef cert
, const CSSM_OID
&policyOid
)
133 bool matched
= false;
136 if (OSStatus rc
= SecCertificateCopyFirstFieldValue(cert
, &CSSMOID_CertificatePolicies
, &data
))
137 MacOSError::throwMe(rc
);
138 if (data
&& data
->Data
&& data
->Length
== sizeof(CSSM_X509_EXTENSION
)) {
139 const CSSM_X509_EXTENSION
*ext
= (const CSSM_X509_EXTENSION
*)data
->Data
;
140 assert(ext
->format
== CSSM_X509_DATAFORMAT_PARSED
);
141 const CE_CertPolicies
*policies
= (const CE_CertPolicies
*)ext
->value
.parsedValue
;
143 for (unsigned int n
= 0; n
< policies
->numPolicies
; n
++) {
144 const CE_PolicyInformation
&cp
= policies
->policies
[n
];
145 if (cp
.certPolicyId
== policyOid
) {
151 SecCertificateReleaseFirstFieldValue(cert
, &CSSMOID_PolicyConstraints
, data
);
161 if (!(mState
= copyfile_state_alloc()))
162 UnixError::throwMe();
165 void Copyfile::set(uint32_t flag
, const void *value
)
167 check(::copyfile_state_set(mState
, flag
, value
));
170 void Copyfile::get(uint32_t flag
, void *value
)
172 check(::copyfile_state_set(mState
, flag
, value
));
175 void Copyfile::operator () (const char *src
, const char *dst
, copyfile_flags_t flags
)
177 check(::copyfile(src
, dst
, mState
, flags
));
180 void Copyfile::check(int rc
)
183 UnixError::throwMe();
188 // MessageTracer support
190 MessageTrace::MessageTrace(const char *domain
, const char *signature
)
192 mAsl
= asl_new(ASL_TYPE_MSG
);
194 asl_set(mAsl
, "com.apple.message.domain", domain
);
196 asl_set(mAsl
, "com.apple.message.signature", signature
);
199 void MessageTrace::add(const char *key
, const char *format
, ...)
202 va_start(args
, format
);
204 vsnprintf(value
, sizeof(value
), format
, args
);
206 asl_set(mAsl
, (string("com.apple.message.") + key
).c_str(), value
);
209 void MessageTrace::send(const char *format
, ...)
212 va_start(args
, format
);
213 asl_vlog(NULL
, mAsl
, ASL_LEVEL_NOTICE
, format
, args
);
219 // Resource limited async workers for doing work on nested bundles
220 LimitedAsync::LimitedAsync(bool async
)
222 // validate multiple resources concurrently if bundle resides on solid-state media
224 // How many async workers to spin off. If zero, validating only happens synchronously.
225 long async_workers
= 0;
227 long ncpu
= sysconf(_SC_NPROCESSORS_ONLN
);
229 if (async
&& ncpu
> 0)
230 async_workers
= ncpu
- 1; // one less because this thread also validates
232 mResourceSemaphore
= new Dispatch::Semaphore(async_workers
);
235 LimitedAsync::LimitedAsync(LimitedAsync
&limitedAsync
)
237 mResourceSemaphore
= new Dispatch::Semaphore(*limitedAsync
.mResourceSemaphore
);
240 LimitedAsync::~LimitedAsync()
242 delete mResourceSemaphore
;
245 bool LimitedAsync::perform(Dispatch::Group
&groupRef
, void (^block
)()) {
246 __block
Dispatch::SemaphoreWait
wait(*mResourceSemaphore
, DISPATCH_TIME_NOW
);
248 if (wait
.acquired()) {
249 dispatch_queue_t defaultQueue
= dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT
, 0);
251 groupRef
.enqueue(defaultQueue
, ^{
252 // Hold the semaphore count until the worker is done validating.
253 Dispatch::SemaphoreWait
innerWait(wait
);
263 } // end namespace CodeSigning
264 } // end namespace Security