]>
Commit | Line | Data |
---|---|---|
b1ab9ed8 | 1 | /* |
d8f41ccd | 2 | * Copyright (c) 2006-2014 Apple Inc. All Rights Reserved. |
b1ab9ed8 A |
3 | * |
4 | * @APPLE_LICENSE_HEADER_START@ | |
5 | * | |
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 | |
11 | * file. | |
12 | * | |
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. | |
20 | * | |
21 | * @APPLE_LICENSE_HEADER_END@ | |
22 | */ | |
23 | ||
24 | // | |
25 | // resource directory construction and verification | |
26 | // | |
27 | #include "resources.h" | |
28 | #include "csutilities.h" | |
427c49bc A |
29 | #include <security_utilities/unix++.h> |
30 | #include <security_utilities/debugging.h> | |
b1ab9ed8 A |
31 | #include <Security/CSCommon.h> |
32 | #include <security_utilities/unix++.h> | |
33 | #include <security_utilities/cfmunge.h> | |
34 | ||
e3d3b979 A |
35 | // These are pretty nasty, but are a quick safe fix |
36 | // to pass information down to the gatekeeper collection tool | |
37 | extern "C" { | |
38 | int GKBIS_DS_Store_Present; | |
39 | int GKBIS_Dot_underbar_Present; | |
40 | int GKBIS_Num_localizations; | |
41 | int GKBIS_Num_files; | |
42 | int GKBIS_Num_dirs; | |
43 | int GKBIS_Num_symlinks; | |
44 | } | |
45 | ||
b1ab9ed8 A |
46 | namespace Security { |
47 | namespace CodeSigning { | |
48 | ||
49 | ||
80e23899 A |
50 | static string removeTrailingSlash(string path) |
51 | { | |
52 | if (path.substr(path.length()-2, 2) == "/.") | |
53 | return path.substr(0, path.length()-2); | |
54 | else if (path.substr(path.length()-1, 1) == "/") | |
55 | return path.substr(0, path.length()-1); | |
56 | else | |
57 | return path; | |
58 | } | |
59 | ||
b1ab9ed8 A |
60 | // |
61 | // Construction and maintainance | |
62 | // | |
80e23899 | 63 | ResourceBuilder::ResourceBuilder(const std::string &root, const std::string &relBase, |
e3d460c9 A |
64 | CFDictionaryRef rulesDict, bool strict, const MacOSErrorSet& toleratedErrors) |
65 | : mCheckUnreadable(strict && toleratedErrors.find(errSecCSSignatureNotVerifiable) == toleratedErrors.end()), | |
80e23899 | 66 | mCheckUnknownType(strict && toleratedErrors.find(errSecCSResourceNotSupported) == toleratedErrors.end()) |
b1ab9ed8 | 67 | { |
80e23899 | 68 | assert(!root.empty()); |
5c19dc3a A |
69 | char realroot[PATH_MAX]; |
70 | if (realpath(root.c_str(), realroot) == NULL) | |
71 | UnixError::throwMe(); | |
72 | mRoot = realroot; | |
73 | if (realpath(removeTrailingSlash(relBase).c_str(), realroot) == NULL) | |
74 | UnixError::throwMe(); | |
75 | mRelBase = realroot; | |
80e23899 | 76 | if (mRoot != mRelBase && mRelBase != mRoot + "/Contents") |
fa7225c8 | 77 | MacOSError::throwMe(errSecCSBadBundleFormat); |
427c49bc A |
78 | const char * paths[2] = { mRoot.c_str(), NULL }; |
79 | mFTS = fts_open((char * const *)paths, FTS_PHYSICAL | FTS_COMFOLLOW | FTS_NOCHDIR, NULL); | |
80 | if (!mFTS) | |
81 | UnixError::throwMe(); | |
82 | mRawRules = rulesDict; | |
b1ab9ed8 A |
83 | CFDictionary rules(rulesDict, errSecCSResourceRulesInvalid); |
84 | rules.apply(this, &ResourceBuilder::addRule); | |
b1ab9ed8 A |
85 | } |
86 | ||
87 | ResourceBuilder::~ResourceBuilder() | |
88 | { | |
89 | for (Rules::iterator it = mRules.begin(); it != mRules.end(); ++it) | |
90 | delete *it; | |
d8f41ccd | 91 | fts_close(mFTS); // do not check error - it's not worth aborting over (double fault etc.) |
b1ab9ed8 A |
92 | } |
93 | ||
94 | ||
95 | // | |
96 | // Parse and add one matching rule | |
97 | // | |
98 | void ResourceBuilder::addRule(CFTypeRef key, CFTypeRef value) | |
99 | { | |
100 | string pattern = cfString(key, errSecCSResourceRulesInvalid); | |
101 | unsigned weight = 1; | |
102 | uint32_t flags = 0; | |
103 | if (CFGetTypeID(value) == CFBooleanGetTypeID()) { | |
104 | if (value == kCFBooleanFalse) | |
105 | flags |= omitted; | |
106 | } else { | |
107 | CFDictionary rule(value, errSecCSResourceRulesInvalid); | |
108 | if (CFNumberRef weightRef = rule.get<CFNumberRef>("weight")) | |
109 | weight = cfNumber<unsigned int>(weightRef); | |
110 | if (CFBooleanRef omitRef = rule.get<CFBooleanRef>("omit")) | |
111 | if (omitRef == kCFBooleanTrue) | |
112 | flags |= omitted; | |
113 | if (CFBooleanRef optRef = rule.get<CFBooleanRef>("optional")) | |
114 | if (optRef == kCFBooleanTrue) | |
115 | flags |= optional; | |
427c49bc A |
116 | if (CFBooleanRef nestRef = rule.get<CFBooleanRef>("nested")) |
117 | if (nestRef == kCFBooleanTrue) | |
118 | flags |= nested; | |
b1ab9ed8 A |
119 | } |
120 | addRule(new Rule(pattern, weight, flags)); | |
121 | } | |
122 | ||
e3d3b979 A |
123 | static bool findStringEndingNoCase(const char *path, const char * end) |
124 | { | |
125 | size_t len_path = strlen(path); | |
126 | size_t len_end = strlen(end); | |
127 | ||
128 | if (len_path >= len_end) { | |
129 | return strcasecmp(path + (len_path - len_end), end) == 0; | |
130 | } else | |
131 | return false; | |
132 | } | |
b1ab9ed8 A |
133 | |
134 | // | |
135 | // Locate the next non-ignored file, look up its rule, and return it. | |
136 | // Returns NULL when we're out of files. | |
137 | // | |
427c49bc | 138 | void ResourceBuilder::scan(Scanner next) |
b1ab9ed8 | 139 | { |
427c49bc | 140 | bool first = true; |
e3d3b979 | 141 | |
427c49bc | 142 | while (FTSENT *ent = fts_read(mFTS)) { |
d8f41ccd | 143 | static const char ds_store[] = ".DS_Store"; |
427c49bc | 144 | const char *relpath = ent->fts_path + mRoot.size() + 1; // skip prefix + "/" |
80e23899 A |
145 | std::string rp; |
146 | if (mRelBase != mRoot) { | |
147 | assert(mRelBase == mRoot + "/Contents"); | |
148 | rp = "../" + string(relpath); | |
149 | if (rp.substr(0, 12) == "../Contents/") | |
150 | rp = rp.substr(12); | |
151 | relpath = rp.c_str(); | |
152 | } | |
427c49bc A |
153 | switch (ent->fts_info) { |
154 | case FTS_F: | |
fa7225c8 | 155 | secinfo("rdirenum", "file %s", ent->fts_path); |
e3d3b979 A |
156 | GKBIS_Num_files++; |
157 | ||
158 | // These are checks for the gatekeeper collection | |
159 | static const char underbar[] = "._"; | |
160 | if (strncasecmp(ent->fts_name, underbar, strlen(underbar)) == 0) | |
161 | GKBIS_Dot_underbar_Present++; | |
162 | ||
e3d3b979 A |
163 | if (strcasecmp(ent->fts_name, ds_store) == 0) |
164 | GKBIS_DS_Store_Present++; | |
165 | ||
427c49bc A |
166 | if (Rule *rule = findRule(relpath)) |
167 | if (!(rule->flags & (omitted | exclusion))) | |
d87e1158 | 168 | next(ent, rule->flags, string(relpath), rule); |
427c49bc A |
169 | break; |
170 | case FTS_SL: | |
171 | // symlinks cannot ever be nested code, so quietly convert to resource file | |
fa7225c8 | 172 | secinfo("rdirenum", "symlink %s", ent->fts_path); |
e3d3b979 | 173 | GKBIS_Num_symlinks++; |
d8f41ccd A |
174 | |
175 | if (strcasecmp(ent->fts_name, ds_store) == 0) | |
176 | MacOSError::throwMe(errSecCSDSStoreSymlink); | |
e3d3b979 | 177 | |
427c49bc A |
178 | if (Rule *rule = findRule(relpath)) |
179 | if (!(rule->flags & (omitted | exclusion))) | |
d87e1158 | 180 | next(ent, rule->flags & ~nested, string(relpath), rule); |
427c49bc A |
181 | break; |
182 | case FTS_D: | |
fa7225c8 | 183 | secinfo("rdirenum", "entering %s", ent->fts_path); |
e3d3b979 A |
184 | GKBIS_Num_dirs++; |
185 | ||
427c49bc A |
186 | if (!first) { // skip root directory (relpath invalid) |
187 | if (Rule *rule = findRule(relpath)) { | |
188 | if (rule->flags & nested) { | |
189 | if (strchr(ent->fts_name, '.')) { // nested, has extension -> treat as nested bundle | |
d87e1158 | 190 | next(ent, rule->flags, string(relpath), rule); |
427c49bc A |
191 | fts_set(mFTS, ent, FTS_SKIP); |
192 | } | |
193 | } else if (rule->flags & exclusion) { // exclude the whole directory | |
194 | fts_set(mFTS, ent, FTS_SKIP); | |
195 | } | |
196 | // else treat as normal directory and descend into it | |
b1ab9ed8 | 197 | } |
427c49bc | 198 | } |
e3d3b979 A |
199 | // Report the number of localizations |
200 | if (findStringEndingNoCase(ent->fts_name, ".lproj")) | |
201 | GKBIS_Num_localizations++; | |
427c49bc | 202 | first = false; |
e3d3b979 | 203 | |
427c49bc A |
204 | break; |
205 | case FTS_DP: | |
fa7225c8 | 206 | secinfo("rdirenum", "leaving %s", ent->fts_path); |
427c49bc | 207 | break; |
80e23899 | 208 | case FTS_DNR: |
fa7225c8 | 209 | secinfo("rdirenum", "cannot read directory %s", ent->fts_path); |
80e23899 A |
210 | if (mCheckUnreadable) |
211 | MacOSError::throwMe(errSecCSSignatureNotVerifiable); | |
212 | break; | |
427c49bc | 213 | default: |
fa7225c8 | 214 | secinfo("rdirenum", "type %d (errno %d): %s", |
427c49bc | 215 | ent->fts_info, ent->fts_errno, ent->fts_path); |
80e23899 A |
216 | if (mCheckUnknownType) |
217 | MacOSError::throwMe(errSecCSResourceNotSupported); | |
427c49bc | 218 | break; |
b1ab9ed8 | 219 | } |
b1ab9ed8 | 220 | } |
b1ab9ed8 A |
221 | } |
222 | ||
223 | ||
224 | // | |
427c49bc A |
225 | // Check a single for for inclusion in the resource envelope |
226 | // | |
227 | bool ResourceBuilder::includes(string path) const | |
228 | { | |
5c19dc3a A |
229 | // process first-directory exclusions |
230 | size_t firstslash = path.find('/'); | |
231 | if (firstslash != string::npos) | |
232 | if (Rule *rule = findRule(path.substr(0, firstslash))) | |
233 | if (rule->flags & exclusion) | |
234 | return rule->flags & softTarget; | |
235 | ||
236 | // process full match | |
427c49bc | 237 | if (Rule *rule = findRule(path)) |
5c19dc3a | 238 | return !(rule->flags & (omitted | exclusion)) || (rule->flags & softTarget); |
427c49bc A |
239 | else |
240 | return false; | |
241 | } | |
242 | ||
243 | ||
244 | // | |
245 | // Find the best-matching resource rule for an alleged resource file. | |
246 | // Returns NULL if no rule matches, or an exclusion rule applies. | |
b1ab9ed8 | 247 | // |
427c49bc | 248 | ResourceBuilder::Rule *ResourceBuilder::findRule(string path) const |
b1ab9ed8 | 249 | { |
427c49bc | 250 | Rule *bestRule = NULL; |
fa7225c8 | 251 | secinfo("rscan", "test %s", path.c_str()); |
427c49bc A |
252 | for (Rules::const_iterator it = mRules.begin(); it != mRules.end(); ++it) { |
253 | Rule *rule = *it; | |
fa7225c8 | 254 | secinfo("rscan", "try %s", rule->source.c_str()); |
427c49bc | 255 | if (rule->match(path.c_str())) { |
fa7225c8 | 256 | secinfo("rscan", "match"); |
427c49bc | 257 | if (rule->flags & exclusion) { |
fa7225c8 | 258 | secinfo("rscan", "excluded"); |
427c49bc A |
259 | return rule; |
260 | } | |
261 | if (!bestRule || rule->weight > bestRule->weight) | |
262 | bestRule = rule; | |
866f8763 A |
263 | |
264 | ||
265 | #if TARGET_OS_WATCH | |
266 | /* rdar://problem/30517969 */ | |
267 | if (bestRule && bestRule->weight == rule->weight && !(bestRule->flags & omitted) && (rule->flags & omitted)) | |
268 | bestRule = rule; | |
269 | #endif | |
b1ab9ed8 A |
270 | } |
271 | } | |
fa7225c8 | 272 | secinfo("rscan", "choosing %s (%d,0x%x)", |
427c49bc A |
273 | bestRule ? bestRule->source.c_str() : "NOTHING", |
274 | bestRule ? bestRule->weight : 0, | |
275 | bestRule ? bestRule->flags : 0); | |
276 | return bestRule; | |
b1ab9ed8 A |
277 | } |
278 | ||
279 | ||
280 | // | |
281 | // Hash a file and return a CFDataRef with the hash | |
282 | // | |
e3d460c9 | 283 | CFDataRef ResourceBuilder::hashFile(const char *path, CodeDirectory::HashAlgorithm type) |
b1ab9ed8 A |
284 | { |
285 | UnixPlusPlus::AutoFileDesc fd(path); | |
286 | fd.fcntl(F_NOCACHE, true); // turn off page caching (one-pass) | |
e3d460c9 | 287 | RefPointer<DynamicHash> hasher(CodeDirectory::hashFor(type)); |
b1ab9ed8 | 288 | hashFileData(fd, hasher.get()); |
0e1db9d1 A |
289 | vector<Hashing::Byte> digest_vector(hasher->digestLength()); |
290 | hasher->finish(digest_vector.data()); | |
291 | return CFDataCreate(NULL, digest_vector.data(), | |
292 | digest_vector.size() * sizeof(Hashing::Byte)); | |
b1ab9ed8 A |
293 | } |
294 | ||
295 | ||
e3d460c9 A |
296 | // |
297 | // Hash a file to multiple hash types and return a dictionary suitable to form a resource seal | |
298 | // | |
fa7225c8 | 299 | CFMutableDictionaryRef ResourceBuilder::hashFile(const char *path, CodeDirectory::HashAlgorithms types, bool strictCheck) |
e3d460c9 A |
300 | { |
301 | UnixPlusPlus::AutoFileDesc fd(path); | |
302 | fd.fcntl(F_NOCACHE, true); // turn off page caching (one-pass) | |
fa7225c8 A |
303 | if (strictCheck) |
304 | if (fd.hasExtendedAttribute(XATTR_RESOURCEFORK_NAME) || fd.hasExtendedAttribute(XATTR_FINDERINFO_NAME)) | |
305 | MacOSError::throwMe(errSecCSInvalidAssociatedFileData); | |
e3d460c9 A |
306 | CFRef<CFMutableDictionaryRef> result = makeCFMutableDictionary(); |
307 | CFMutableDictionaryRef resultRef = result; | |
308 | CodeDirectory::multipleHashFileData(fd, 0, types, ^(CodeDirectory::HashAlgorithm type, Security::DynamicHash *hasher) { | |
309 | size_t length = hasher->digestLength(); | |
0e1db9d1 A |
310 | vector<Hashing::Byte> digest_vector(length); |
311 | hasher->finish(digest_vector.data()); | |
312 | CFDictionaryAddValue(resultRef, CFTempString(hashName(type)), CFTempData(digest_vector.data(), length)); | |
e3d460c9 A |
313 | }); |
314 | return result.yield(); | |
315 | } | |
316 | ||
317 | ||
318 | std::string ResourceBuilder::hashName(CodeDirectory::HashAlgorithm type) | |
319 | { | |
320 | switch (type) { | |
321 | case kSecCodeSignatureHashSHA1: | |
322 | return "hash"; | |
323 | default: | |
324 | char name[20]; | |
325 | snprintf(name, sizeof(name), "hash%d", int(type)); | |
326 | return name; | |
327 | } | |
328 | } | |
329 | ||
330 | ||
b1ab9ed8 A |
331 | // |
332 | // Regex matching objects | |
333 | // | |
334 | ResourceBuilder::Rule::Rule(const std::string &pattern, unsigned w, uint32_t f) | |
427c49bc | 335 | : weight(w), flags(f), source(pattern) |
b1ab9ed8 A |
336 | { |
337 | if (::regcomp(this, pattern.c_str(), REG_EXTENDED | REG_NOSUB)) //@@@ REG_ICASE? | |
338 | MacOSError::throwMe(errSecCSResourceRulesInvalid); | |
fa7225c8 | 339 | secinfo("csresource", "%p rule %s added (weight %d, flags 0x%x)", |
b1ab9ed8 A |
340 | this, pattern.c_str(), w, f); |
341 | } | |
342 | ||
343 | ResourceBuilder::Rule::~Rule() | |
344 | { | |
345 | ::regfree(this); | |
346 | } | |
347 | ||
348 | bool ResourceBuilder::Rule::match(const char *s) const | |
349 | { | |
350 | switch (::regexec(this, s, 0, NULL, 0)) { | |
351 | case 0: | |
352 | return true; | |
353 | case REG_NOMATCH: | |
354 | return false; | |
355 | default: | |
356 | MacOSError::throwMe(errSecCSResourceRulesInvalid); | |
357 | } | |
358 | } | |
359 | ||
360 | ||
361 | std::string ResourceBuilder::escapeRE(const std::string &s) | |
362 | { | |
363 | string r; | |
364 | for (string::const_iterator it = s.begin(); it != s.end(); ++it) { | |
365 | char c = *it; | |
fa7225c8 | 366 | if (strchr("\\[]{}().+*?^$|", c)) |
b1ab9ed8 A |
367 | r.push_back('\\'); |
368 | r.push_back(c); | |
369 | } | |
370 | return r; | |
371 | } | |
372 | ||
373 | ||
374 | // | |
375 | // Resource Seals | |
376 | // | |
377 | ResourceSeal::ResourceSeal(CFTypeRef it) | |
e3d460c9 | 378 | : mDict(NULL), mRequirement(NULL), mLink(NULL), mFlags(0) |
b1ab9ed8 A |
379 | { |
380 | if (it == NULL) | |
381 | MacOSError::throwMe(errSecCSResourcesInvalid); | |
e3d460c9 A |
382 | if (CFGetTypeID(it) == CFDataGetTypeID()) // old-style form with just a hash |
383 | mDict.take(cfmake<CFDictionaryRef>("{hash=%O}", it)); | |
384 | else if (CFGetTypeID(it) == CFDictionaryGetTypeID()) | |
427c49bc | 385 | mDict = CFDictionaryRef(it); |
e3d460c9 A |
386 | else |
387 | MacOSError::throwMe(errSecCSResourcesInvalid); | |
388 | ||
389 | int optional = 0; | |
390 | bool err; | |
391 | if (CFDictionaryGetValue(mDict, CFSTR("requirement"))) | |
392 | err = !cfscan(mDict, "{requirement=%SO,?optional=%B}", &mRequirement, &optional); | |
393 | else if (CFDictionaryGetValue(mDict, CFSTR("symlink"))) | |
394 | err = !cfscan(mDict, "{symlink=%SO,?optional=%B}", &mLink, &optional); | |
395 | else | |
396 | err = !cfscan(mDict, "{?optional=%B}", &optional); | |
397 | if (err) | |
398 | MacOSError::throwMe(errSecCSResourcesInvalid); | |
399 | if (optional) | |
400 | mFlags |= ResourceBuilder::optional; | |
401 | if (mRequirement) | |
402 | mFlags |= ResourceBuilder::nested; | |
403 | } | |
404 | ||
405 | ||
406 | const Hashing::Byte *ResourceSeal::hash(CodeDirectory::HashAlgorithm type) const | |
407 | { | |
408 | std::string name = ResourceBuilder::hashName(type); | |
409 | CFTypeRef hash = CFDictionaryGetValue(mDict, CFTempString(name)); | |
641423b6 A |
410 | if (hash == NULL) // pre-agility fallback |
411 | hash = CFDictionaryGetValue(mDict, CFSTR("hash")); | |
e3d460c9 A |
412 | if (hash == NULL || CFGetTypeID(hash) != CFDataGetTypeID()) |
413 | MacOSError::throwMe(errSecCSResourcesInvalid); | |
414 | return CFDataGetBytePtr(CFDataRef(hash)); | |
b1ab9ed8 A |
415 | } |
416 | ||
417 | ||
418 | } // end namespace CodeSigning | |
419 | } // end namespace Security |