AppleCSPDL/SSKey.h

   1 /*
   2  * Copyright (c) 2000-2001 Apple Computer, 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 // SSKey.h - CSP-wide SSKey base class
  21 //
  22 #ifndef _H_SSKEY_
  23 #define _H_SSKEY_
  24
  25 #include <Security/CSPsession.h>
  26
  27 #include "SSDatabase.h"
  28
  29 #include <Security/dlclient.h>
  30 #include <Security/SecurityServerClient.h>
  31
  32 namespace Security
  33 {
  34
  35 class CssmKey;
  36
  37 } // end namespace Security
  38
  39 class SSCSPSession;
  40 class SSCSPDLSession;
  41 class SSDLSession;
  42
  43 class SSKey : public ReferencedKey
  44 {
  45 public:
  46         SSKey(SSCSPSession &session, SecurityServer::KeyHandle keyHandle,
  47                   CssmKey &ioKey, SSDatabase &inSSDatabase, uint32 inKeyAttr,
  48                   const CssmData *inKeyLabel);
  49         SSKey(SSDLSession &session, CssmKey &ioKey, SSDatabase &inSSDatabase,
  50                   const SSUniqueRecord &uniqueId, CSSM_DB_RECORDTYPE recordType,
  51                   CssmData &keyBlob);
  52
  53         virtual ~SSKey();
  54         void free(const AccessCredentials *accessCred, CssmKey &ioKey,
  55                           CSSM_BOOL deleteKey);
  56
  57         SecurityServer::ClientSession &clientSession();
  58         SecurityServer::KeyHandle keyHandle();
  59
  60     // ACL retrieval and change operations
  61         void getOwner(CSSM_ACL_OWNER_PROTOTYPE &owner, CssmAllocator &allocator);
  62         void changeOwner(const AccessCredentials &accessCred,
  63                                          const AclOwnerPrototype &newOwner);
  64         void getAcl(const char *selectionTag, uint32 &numberOfAclInfos,
  65                                 AclEntryInfo *&aclInfos, CssmAllocator &allocator);
  66         void changeAcl(const AccessCredentials &accessCred,
  67                                    const AclEdit &aclEdit);
  68
  69 private:
  70         CssmAllocator &mAllocator;
  71         SecurityServer::KeyHandle mKeyHandle;
  72         SSDatabase mSSDatabase;
  73         SSUniqueRecord mUniqueId;
  74         CSSM_DB_RECORDTYPE mRecordType;
  75 };
  76
  77
  78 #endif  // _H_SSKEY_