lib/policydb.h

   1 /*
   2  * Copyright (c) 2011 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 #ifndef _H_POLICYDB
  24 #define _H_POLICYDB
  25
  26 #include <security_utilities/globalizer.h>
  27 #include <security_utilities/hashing.h>
  28 #include <security_utilities/sqlite++.h>
  29 #include <CoreFoundation/CoreFoundation.h>
  30
  31 namespace Security {
  32 namespace CodeSigning {
  33
  34
  35 namespace SQLite = SQLite3;
  36
  37
  38 static const char defaultDatabase[] = "/var/db/SystemPolicy";
  39 static const char visibleSecurityFlagFile[] = "/var/db/.sp_visible";
  40
  41 static const double never = 5000000;    // expires never (i.e. in the year 8977)
  42
  43
  44 typedef SHA1::SDigest ObjectHash;
  45
  46
  47 typedef uint AuthorityType;
  48 enum {
  49         kAuthorityInvalid = 0,                          // not a valid authority type
  50         kAuthorityExecute = 1,                          // authorizes launch and execution
  51         kAuthorityInstall = 2,                          // authorizes installation
  52         kAuthorityOpenDoc = 3,                          // authorizes opening of documents
  53 };
  54
  55
  56 //
  57 // Defined flags for authority flags column
  58 //
  59 enum {
  60         kAuthorityFlagVirtual = 0x0001, // virtual rule (anchoring object records)
  61         kAuthorityFlagDefault = 0x0002, // rule is part of the original default set
  62         kAuthorityFlagInhibitCache = 0x0004, // never cache outcome of this rule
  63 };
  64
  65
  66 //
  67 // Mapping/translation to/from API space
  68 //
  69 AuthorityType typeFor(CFDictionaryRef context, AuthorityType type = kAuthorityInvalid);
  70
  71
  72 //
  73 // An open policy database.
  74 // Usually read-only, but can be opened for write by privileged callers.
  75 // This is a translucent wrapper around SQLite::Database; the caller
  76 // is expected to work with statement rows.
  77 //
  78 class PolicyDatabase : public SQLite::Database {
  79 public:
  80         PolicyDatabase(const char *path = NULL, int flags = SQLITE_OPEN_READONLY);
  81         virtual ~PolicyDatabase();
  82
  83 public:
  84         bool checkCache(CFURLRef path, AuthorityType type, CFMutableDictionaryRef result);
  85
  86 public:
  87         void purgeAuthority();
  88         void purgeObjects();
  89         void purgeObjects(double priority);
  90 };
  91
  92
  93 //
  94 // Check the system-wide overriding flag file
  95 //
  96 bool overrideAssessment();
  97
  98
  99 } // end namespace CodeSigning
 100 } // end namespace Security
 101
 102 #endif //_H_POLICYDB