OSX/libsecurity_codesigning/lib/policydb.cpp

   1 /*
   2  * Copyright (c) 2011-2013 Apple Inc. All Rights Reserved.
   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 #include "cs.h"
  24 #include "policydb.h"
  25 #include "policyengine.h"
  26 #include <Security/CodeSigning.h>
  27 #include <security_utilities/cfutilities.h>
  28 #include <security_utilities/cfmunge.h>
  29 #include <security_utilities/blob.h>
  30 #include <security_utilities/logging.h>
  31 #include <security_utilities/simpleprefs.h>
  32 #include <security_utilities/logging.h>
  33 #include "csdatabase.h"
  34
  35 #include <dispatch/dispatch.h>
  36 #include <sys/types.h>
  37 #include <sys/stat.h>
  38 #include <notify.h>
  39
  40 namespace Security {
  41 namespace CodeSigning {
  42
  43
  44 using namespace SQLite;
  45
  46
  47 //
  48 // Determine the database path
  49 //
  50 static const char *dbPath()
  51 {
  52         if (const char *s = getenv("SYSPOLICYDATABASE"))
  53                 return s;
  54         return defaultDatabase;
  55 }
  56
  57
  58 //
  59 // Help mapping API-ish CFString keys to more convenient internal enumerations
  60 //
  61 typedef struct {
  62         const CFStringRef &cstring;
  63         uint enumeration;
  64 } StringMap;
  65
  66 static uint mapEnum(CFDictionaryRef context, CFStringRef attr, const StringMap *map, uint value = 0)
  67 {
  68         if (context)
  69                 if (CFTypeRef value = CFDictionaryGetValue(context, attr))
  70                         for (const StringMap *mp = map; mp->cstring; ++mp)
  71                                 if (CFEqual(mp->cstring, value))
  72                                         return mp->enumeration;
  73         return value;
  74 }
  75
  76 static const StringMap mapType[] = {
  77         { kSecAssessmentOperationTypeExecute, kAuthorityExecute },
  78         { kSecAssessmentOperationTypeInstall, kAuthorityInstall },
  79         { kSecAssessmentOperationTypeOpenDocument, kAuthorityOpenDoc },
  80         { NULL }
  81 };
  82
  83 AuthorityType typeFor(CFDictionaryRef context, AuthorityType type /* = kAuthorityInvalid */)
  84 {
  85         return mapEnum(context, kSecAssessmentContextKeyOperation, mapType, type);
  86 }
  87
  88 CFStringRef typeNameFor(AuthorityType type)
  89 {
  90         for (const StringMap *mp = mapType; mp->cstring; ++mp)
  91                 if (type == mp->enumeration)
  92                         return mp->cstring;
  93         return CFStringCreateWithFormat(NULL, NULL, CFSTR("type %d"), type);
  94 }
  95
  96
  97 //
  98 // Open the database
  99 //
 100 PolicyDatabase::PolicyDatabase(const char *path, int flags)
 101         : SQLite::Database(path ? path : dbPath(), flags),
 102           mLastExplicitCheck(0)
 103 {
 104         // sqlite3 doesn't do foreign key support by default, have to turn this on per connection
 105         SQLite::Statement foreign(*this, "PRAGMA foreign_keys = true");
 106         foreign.execute();
 107
 108         // Try upgrade processing if we may be open for write.
 109         // Ignore any errors (we may have been downgraded to read-only)
 110         // and try again later.
 111         if (openFlags() & SQLITE_OPEN_READWRITE)
 112                 try {
 113                         upgradeDatabase();
 114                         installExplicitSet(gkeAuthFile, gkeSigsFile);
 115                 } catch(...) {
 116                 }
 117 }
 118
 119 PolicyDatabase::~PolicyDatabase()
 120 { /* virtual */ }
 121
 122
 123 //
 124 // Quick-check the cache for a match.
 125 // Return true on a cache hit, false on failure to confirm a hit for any reason.
 126 //
 127 bool PolicyDatabase::checkCache(CFURLRef path, AuthorityType type, SecAssessmentFlags flags, CFMutableDictionaryRef result)
 128 {
 129         // we currently don't use the cache for anything but execution rules
 130         if (type != kAuthorityExecute)
 131                 return false;
 132
 133         CFRef<SecStaticCodeRef> code;
 134         MacOSError::check(SecStaticCodeCreateWithPath(path, kSecCSDefaultFlags, &code.aref()));
 135         if (SecStaticCodeCheckValidity(code, kSecCSBasicValidateOnly, NULL) != errSecSuccess)
 136                 return false;   // quick pass - any error is a cache miss
 137         CFRef<CFDictionaryRef> info;
 138         MacOSError::check(SecCodeCopySigningInformation(code, kSecCSDefaultFlags, &info.aref()));
 139         CFDataRef cdHash = CFDataRef(CFDictionaryGetValue(info, kSecCodeInfoUnique));
 140
 141         // check the cache table for a fast match
 142         SQLite::Statement cached(*this, "SELECT object.allow, authority.label, authority FROM object, authority"
 143                 " WHERE object.authority = authority.id AND object.type = :type AND object.hash = :hash AND authority.disabled = 0"
 144                 " AND JULIANDAY('now') < object.expires;");
 145         cached.bind(":type").integer(type);
 146         cached.bind(":hash") = cdHash;
 147         if (cached.nextRow()) {
 148                 bool allow = int(cached[0]);
 149                 const char *label = cached[1];
 150                 SQLite::int64 auth = cached[2];
 151                 SYSPOLICY_ASSESS_CACHE_HIT();
 152
 153                 // If its allowed, lets do a full validation unless if
 154                 // we are overriding the assessement, since that force
 155                 // the verdict to 'pass' at the end
 156
 157                 if (allow && !overrideAssessment(flags))
 158                     MacOSError::check(SecStaticCodeCheckValidity(code, kSecCSDefaultFlags, NULL));
 159
 160                 cfadd(result, "{%O=%B}", kSecAssessmentAssessmentVerdict, allow);
 161                 PolicyEngine::addAuthority(flags, result, label, auth, kCFBooleanTrue);
 162                 return true;
 163         }
 164         return false;
 165 }
 166
 167
 168 //
 169 // Purge the object cache of all expired entries.
 170 // These are meant to run within the caller's transaction.
 171 //
 172 void PolicyDatabase::purgeAuthority()
 173 {
 174         SQLite::Statement cleaner(*this,
 175                 "DELETE FROM authority WHERE expires <= JULIANDAY('now');");
 176         cleaner.execute();
 177 }
 178
 179 void PolicyDatabase::purgeObjects()
 180 {
 181         SQLite::Statement cleaner(*this,
 182                 "DELETE FROM object WHERE expires <= JULIANDAY('now');");
 183         cleaner.execute();
 184 }
 185
 186 void PolicyDatabase::purgeObjects(double priority)
 187 {
 188         SQLite::Statement cleaner(*this,
 189                 "DELETE FROM object WHERE expires <= JULIANDAY('now') OR (SELECT priority FROM authority WHERE id = object.authority) <= :priority;");
 190         cleaner.bind(":priority") = priority;
 191         cleaner.execute();
 192 }
 193
 194
 195 //
 196 // Database migration
 197 //
 198 std::string PolicyDatabase::featureLevel(const char *name)
 199 {
 200         SQLite::Statement feature(*this, "SELECT value FROM feature WHERE name=:name");
 201         feature.bind(":name") = name;
 202         if (feature.nextRow()) {
 203                 if (const char *value = feature[0])
 204                         return value;
 205                 else
 206                         return "default";       // old engineering versions may have NULL values; tolerate this
 207         }
 208         return "";              // new feature (no level)
 209 }
 210
 211 void PolicyDatabase::addFeature(const char *name, const char *value, const char *remarks)
 212 {
 213         SQLite::Statement feature(*this, "INSERT OR REPLACE INTO feature (name,value,remarks) VALUES(:name, :value, :remarks)");
 214         feature.bind(":name") = name;
 215         feature.bind(":value") = value;
 216         feature.bind(":remarks") = remarks;
 217         feature.execute();
 218 }
 219
 220 void PolicyDatabase::simpleFeature(const char *feature, void (^perform)())
 221 {
 222         if (!hasFeature(feature)) {
 223                 SQLite::Transaction update(*this);
 224                 perform();
 225                 addFeature(feature, "upgraded", "upgraded");
 226                 update.commit();
 227         }
 228 }
 229
 230 void PolicyDatabase::simpleFeature(const char *feature, const char *sql)
 231 {
 232         simpleFeature(feature, ^{
 233                 SQLite::Statement perform(*this, sql);
 234                 perform.execute();
 235         });
 236 }
 237
 238
 239 void PolicyDatabase::upgradeDatabase()
 240 {
 241         simpleFeature("bookmarkhints",
 242                 "CREATE TABLE bookmarkhints ("
 243                         "  id INTEGER PRIMARY KEY AUTOINCREMENT, "
 244                         "  bookmark BLOB,"
 245                         "  authority INTEGER NOT NULL"
 246                         "     REFERENCES authority(id) ON DELETE CASCADE"
 247                         ")");
 248
 249         simpleFeature("codesignedpackages", ^{
 250                 SQLite::Statement update(*this,
 251                         "UPDATE authority"
 252                         " SET requirement = 'anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] exists and "
 253                                 "(certificate leaf[field.1.2.840.113635.100.6.1.14] or certificate leaf[field.1.2.840.113635.100.6.1.13])'"
 254                         " WHERE type = 2 and label = 'Developer ID' and flags & :flag");
 255                 update.bind(":flag") = kAuthorityFlagDefault;
 256                 update.execute();
 257         });
 258
 259         simpleFeature("filter_unsigned",
 260                 "ALTER TABLE authority ADD COLUMN filter_unsigned TEXT NULL"
 261                 );
 262
 263         simpleFeature("strict_apple_installer", ^{
 264                 SQLite::Statement update(*this,
 265                         "UPDATE authority"
 266                         " SET requirement = 'anchor apple generic and certificate 1[subject.CN] = \"Apple Software Update Certification Authority\"'"
 267                         " WHERE flags & :flag AND label = 'Apple Installer'");
 268                 update.bind(":flag") = kAuthorityFlagDefault;
 269                 update.execute();
 270                 SQLite::Statement add(*this,
 271                         "INSERT INTO authority (type, label, flags, requirement)"
 272                         " VALUES (2, 'Mac App Store', :flags, 'anchor apple generic and certificate leaf[field.1.2.840.113635.100.6.1.10] exists')");
 273                 add.bind(":flags") = kAuthorityFlagDefault;
 274                 add.execute();
 275         });
 276
 277         simpleFeature("document rules", ^{
 278                 SQLite::Statement addApple(*this,
 279                         "INSERT INTO authority (type, allow, flags, label, requirement) VALUES (3, 1, 2, 'Apple System', 'anchor apple')");
 280                 addApple.execute();
 281                 SQLite::Statement addDevID(*this,
 282                         "INSERT INTO authority (type, allow, flags, label, requirement) VALUES (3, 1, 2, 'Developer ID', 'anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] exists and certificate leaf[field.1.2.840.113635.100.6.1.13] exists')");
 283                 addDevID.execute();
 284         });
 285
 286     simpleFeature("root_only", ^{
 287         UnixError::check(::chmod(dbPath(), S_IRUSR | S_IWUSR));
 288     });
 289
 290         simpleFeature("notarized_apps", ^{
 291
 292                 // Insert a set of notarization requirements for notarized applications and installers, with a priority that will be higher than developer id priorities
 293                 // so they are guaranteed to match first.
 294                 SQLite::Statement addNotarizedExecutables(*this,
 295                         "INSERT INTO authority (type, allow, flags, priority, label, requirement) VALUES (1, 1, 2, 5.0, 'Notarized Developer ID', 'anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] exists and certificate leaf[field.1.2.840.113635.100.6.1.13] exists and notarized')");
 296                 addNotarizedExecutables.execute();
 297
 298                 SQLite::Statement addNotarizedInstallers(*this,
 299                         "INSERT INTO authority (type, allow, flags, priority, label, requirement) VALUES (2, 1, 2, 5.0, 'Notarized Developer ID', 'anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] exists and (certificate leaf[field.1.2.840.113635.100.6.1.14] or certificate leaf[field.1.2.840.113635.100.6.1.13]) and notarized')");
 300                 addNotarizedInstallers.execute();
 301
 302                 // Bump the priority on apple system, apple installer, and mac app store entries so they are evaluated before Developer ID variants.
 303                 // This is important because notarized variants meet the requirement of the Developer ID variant and would could match that too.
 304                 SQLite::Statement bumpAppleSystemPriority(*this,
 305                           "UPDATE authority SET priority = 20.0 WHERE label = 'Apple System'");
 306                 bumpAppleSystemPriority.execute();
 307
 308                 SQLite::Statement bumpAppleInstallerPriority(*this,
 309                           "UPDATE authority SET priority = 20.0 WHERE label = 'Apple Installer'");
 310                 bumpAppleInstallerPriority.execute();
 311
 312                 SQLite::Statement bumpMacAppStorePriority(*this,
 313                           "UPDATE authority SET priority = 10.0 WHERE label = 'Mac App Store'");
 314                 bumpMacAppStorePriority.execute();
 315         });
 316 }
 317
 318
 319 //
 320 // Install Gatekeeper override (GKE) data.
 321 // The arguments are paths to the authority and signature files.
 322 //
 323 void PolicyDatabase::installExplicitSet(const char *authfile, const char *sigfile)
 324 {
 325         // only try this every gkeCheckInterval seconds
 326         time_t now = time(NULL);
 327         if (mLastExplicitCheck + gkeCheckInterval > now)
 328                 return;
 329         mLastExplicitCheck = now;
 330
 331         try {
 332                 if (CFRef<CFDataRef> authData = cfLoadFile(authfile)) {
 333                         CFDictionary auth(CFRef<CFDictionaryRef>(makeCFDictionaryFrom(authData)), errSecCSDbCorrupt);
 334                         CFDictionaryRef content = auth.get<CFDictionaryRef>(CFSTR("authority"));
 335                         std::string authUUID = cfString(auth.get<CFStringRef>(CFSTR("uuid")));
 336                         if (authUUID.empty()) {
 337                                 secinfo("gkupgrade", "no uuid in auth file; ignoring gke.auth");
 338                                 return;
 339                         }
 340                         std::string dbUUID;
 341                         SQLite::Statement uuidQuery(*this, "SELECT value FROM feature WHERE name='gke'");
 342                         if (uuidQuery.nextRow())
 343                                 dbUUID = (const char *)uuidQuery[0];
 344                         if (dbUUID == authUUID) {
 345                                 secinfo("gkupgrade", "gke.auth already present, ignoring");
 346                                 return;
 347                         }
 348                         Syslog::notice("loading GKE %s (replacing %s)", authUUID.c_str(), dbUUID.empty() ? "nothing" : dbUUID.c_str());
 349
 350                         // first, load code signatures. This is pretty much idempotent
 351                         if (sigfile)
 352                                 if (FILE *sigs = fopen(sigfile, "r")) {
 353                                         unsigned count = 0;
 354                                     SignatureDatabaseWriter db;
 355                                         while (const BlobCore *blob = BlobCore::readBlob(sigs)) {
 356                                                 db.storeCode(blob, "<remote>");
 357                                                 count++;
 358                                         }
 359                                         secinfo("gkupgrade", "%d detached signature(s) loaded from override data", count);
 360                                         fclose(sigs);
 361                                 }
 362
 363                         // start transaction (atomic from here on out)
 364                         SQLite::Transaction loadAuth(*this, SQLite::Transaction::exclusive, "GKE_Upgrade");
 365
 366                         // purge prior authority data
 367                         SQLite::Statement purge(*this, "DELETE FROM authority WHERE flags & :flag");
 368                         purge.bind(":flag") = kAuthorityFlagWhitelist;
 369                         purge();
 370
 371                         // load new data
 372                         CFIndex count = CFDictionaryGetCount(content);
 373                         vector<CFStringRef> keys_vector(count, NULL);
 374                         vector<CFDictionaryRef> values_vector(count, NULL);
 375                         CFDictionaryGetKeysAndValues(content, (const void **)keys_vector.data(), (const void **)values_vector.data());
 376
 377                         SQLite::Statement insert(*this, "INSERT INTO authority (type, allow, requirement, label, filter_unsigned, flags, remarks)"
 378                                 " VALUES (:type, 1, :requirement, 'GKE', :filter, :flags, :path)");
 379                         for (CFIndex n = 0; n < count; n++) {
 380                                 CFDictionary info(values_vector[n], errSecCSDbCorrupt);
 381                                 uint32_t flags = kAuthorityFlagWhitelist;
 382                                 if (CFNumberRef versionRef = info.get<CFNumberRef>("version")) {
 383                                         int version = cfNumber<int>(versionRef);
 384                                         if (version >= 2) {
 385                                                 flags |= kAuthorityFlagWhitelistV2;
 386                                                 if (version >= 3) {
 387                                                         flags |= kAuthorityFlagWhitelistSHA256;
 388                                                 }
 389                                         }
 390                                 }
 391                                 insert.reset();
 392                                 insert.bind(":type") = cfString(info.get<CFStringRef>(CFSTR("type")));
 393                                 insert.bind(":path") = cfString(info.get<CFStringRef>(CFSTR("path")));
 394                                 insert.bind(":requirement") = "cdhash H\"" + cfString(info.get<CFStringRef>(CFSTR("cdhash"))) + "\"";
 395                                 insert.bind(":filter") = cfString(info.get<CFStringRef>(CFSTR("screen")));
 396                                 insert.bind(":flags").integer(flags);
 397                                 insert();
 398                         }
 399
 400                         // we just changed the authority configuration at priority zero
 401                         this->purgeObjects(0);
 402
 403                         // update version and commit
 404                         addFeature("gke", authUUID.c_str(), "gke loaded");
 405                         loadAuth.commit();
 406             /* now that we have moved to a bundle for gke files, delete any old style files we find
 407                This is really just a best effort cleanup, so we don't care about errors. */
 408             if (access(gkeAuthFile_old, F_OK) == 0)
 409             {
 410                 if (unlink(gkeAuthFile_old) == 0)
 411                 {
 412                     Syslog::notice("Deleted old style gke file (%s)", gkeAuthFile_old);
 413                 }
 414             }
 415             if (access(gkeSigsFile_old, F_OK) == 0)
 416             {
 417                 if (unlink(gkeSigsFile_old) == 0)
 418                 {
 419                     Syslog::notice("Deleted old style gke file (%s)", gkeSigsFile_old);
 420                 }
 421             }
 422                 }
 423         } catch (...) {
 424                 secinfo("gkupgrade", "exception during GKE upgrade");
 425         }
 426 }
 427
 428
 429 //
 430 // Check the override-enable master flag
 431 //
 432 #define SP_ENABLE_KEY CFSTR("enabled")
 433 #define SP_ENABLED CFSTR("yes")
 434 #define SP_DISABLED CFSTR("no")
 435
 436 bool overrideAssessment(SecAssessmentFlags flags /* = 0 */)
 437 {
 438         static bool enabled = true;
 439         static dispatch_once_t once;
 440         static int token = -1;
 441         static int have_token = 0;
 442         static dispatch_queue_t queue;
 443         int check;
 444
 445         if (flags & kSecAssessmentFlagEnforce)  // explicitly disregard disables (force on)
 446                 return false;
 447
 448         if (have_token && notify_check(token, &check) == NOTIFY_STATUS_OK && !check)
 449                 return !enabled;
 450
 451         dispatch_once(&once, ^{
 452                 if (notify_register_check(kNotifySecAssessmentMasterSwitch, &token) == NOTIFY_STATUS_OK)
 453                         have_token = 1;
 454                 queue = dispatch_queue_create("com.apple.SecAssessment.assessment", NULL);
 455              });
 456
 457         dispatch_sync(queue, ^{
 458                 /* upgrade configuration from emir, ignore all error since we might not be able to write to */
 459                 if (::access(visibleSecurityFlagFile, F_OK) == 0) {
 460                         try {
 461                                 setAssessment(true);
 462                                 ::unlink(visibleSecurityFlagFile);
 463                         } catch (...) {
 464                         }
 465                         enabled = true;
 466                         return;
 467                 }
 468
 469                 try {
 470                         Dictionary * prefsDict = Dictionary::CreateDictionary(prefsFile);
 471                         if (prefsDict == NULL)
 472                                 return;
 473
 474                         CFStringRef value = prefsDict->getStringValue(SP_ENABLE_KEY);
 475                         if (value && CFStringCompare(value, SP_DISABLED, 0) == 0)
 476                                 enabled = false;
 477                         else
 478                                 enabled = true;
 479                         delete prefsDict;
 480                 } catch(...) {
 481                 }
 482         });
 483
 484         return !enabled;
 485 }
 486
 487 void setAssessment(bool masterSwitch)
 488 {
 489         MutableDictionary *prefsDict = MutableDictionary::CreateMutableDictionary(prefsFile);
 490         if (prefsDict == NULL)
 491                 prefsDict = new MutableDictionary();
 492         prefsDict->setValue(SP_ENABLE_KEY, masterSwitch ? SP_ENABLED : SP_DISABLED);
 493         prefsDict->writePlistToFile(prefsFile);
 494         delete prefsDict;
 495
 496         /* make sure permissions is right */
 497         ::chmod(prefsFile, S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH);
 498
 499         notify_post(kNotifySecAssessmentMasterSwitch);
 500
 501         /* reset the automatic rearm timer */
 502         resetRearmTimer("masterswitch");
 503 }
 504
 505
 506 //
 507 // Reset or query the automatic rearm timer
 508 //
 509 void resetRearmTimer(const char *event)
 510 {
 511         CFRef<CFDateRef> now = CFDateCreate(NULL, CFAbsoluteTimeGetCurrent());
 512         CFTemp<CFDictionaryRef> info("{event=%s, timestamp=%O}", event, now.get());
 513         CFRef<CFDataRef> infoData = makeCFData(info.get());
 514         UnixPlusPlus::AutoFileDesc fd(rearmTimerFile, O_WRONLY | O_CREAT | O_TRUNC, 0644);
 515         fd.write(CFDataGetBytePtr(infoData), CFDataGetLength(infoData));
 516 }
 517
 518 bool queryRearmTimer(CFTimeInterval &delta)
 519 {
 520         if (CFRef<CFDataRef> infoData = cfLoadFile(rearmTimerFile)) {
 521                 if (CFRef<CFDictionaryRef> info = makeCFDictionaryFrom(infoData)) {
 522                         CFDateRef timestamp = (CFDateRef)CFDictionaryGetValue(info, CFSTR("timestamp"));
 523                         if (timestamp && CFGetTypeID(timestamp) == CFDateGetTypeID()) {
 524                                 delta = CFAbsoluteTimeGetCurrent() - CFDateGetAbsoluteTime(timestamp);
 525                                 return true;
 526                         }
 527                 }
 528                 MacOSError::throwMe(errSecCSDbCorrupt);
 529         }
 530         return false;
 531 }
 532
 533
 534 } // end namespace CodeSigning
 535 } // end namespace Security