1  /*
 2   * Copyright (c) 2000-2001,2011,2014 Apple Inc. All Rights Reserved.
 3   * 
 4   * The contents of this file constitute Original Code as defined in and are
 5   * subject to the Apple Public Source License Version 1.2 (the 'License').
 6   * You may not use this file except in compliance with the License. Please obtain
 7   * a copy of the License at http://www.apple.com/publicsource and read it before
 8   * using this file.
 9   * 
10   * This Original Code and all software distributed under the License are
11   * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
12   * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
13   * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
14   * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
15   * specific language governing rights and limitations under the License.
16   */
17  
18  
19  //
20  // keychainacl - Keychain-related ACL and credential forms
21  //
22  #ifndef _KEYCHAINACL
23  #define _KEYCHAINACL
24  
25  #include <Security/cssm.h>
26  #include <security_cdsa_utilities/cssmaclpod.h>
27  #include <security_cdsa_utilities/cssmcred.h>
28  #include <security_cdsa_utilities/cssmalloc.h>
29  
30  #ifdef _CPP_KEYCHAINACL
31  # pragma export on
32  #endif
33  
34  
35  namespace Security
36  {
37  
38  namespace CssmClient
39  {
40  
41  class KeychainAclFactory
42  {
43  public:
44  	KeychainAclFactory(Allocator &alloc);
45  	~KeychainAclFactory();
46  	
47  	Allocator &allocator;
48  	
49  public:
50  	//
51  	// Create credentials. These functions return AccessCredentials pointers.
52  	//
53  	const AccessCredentials *nullCredentials();
54  	const AccessCredentials *keychainPromptCredentials();
55  	const AccessCredentials *keychainPromptUnlockCredentials();
56  	const AutoCredentials *passwordChangeCredentials(const CssmData &password);
57  	const AutoCredentials *passwordUnlockCredentials(const CssmData &password);
58  
59  public:
60  	//
61  	// Create initial ACLs. Pass those to resource creation functions.
62  	//
63  	AclEntryInput *keychainPromptOwner(const CssmData &description);
64  	AclEntryInput *anyOwner();
65  	void release(AclEntryInput *input);
66  	
67  private:
68  	AutoCredentials nullCred;
69  	AutoCredentials kcCred;
70  	AutoCredentials kcUnlockCred;
71  };
72  
73  
74  } // end namespace CssmClient
75  
76  } // end namespace Security
77  
78  #ifdef _CPP_KEYCHAINACL
79  # pragma export off
80  #endif
81  
82  #endif //_KEYCHAINACL