Security/sec/SOSCircle/CKBridge/SOSCloudKeychainClient.h

   1 /*
   2  * Copyright (c) 2012-2014 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
  24
  25 /*
  26  * SOSCloudKeychainClient.h -  Implementation of the transport layer from CKBridge to SOSAccount/SOSCircle
  27  */
  28
  29 /*!
  30     @header SOSCloudKeychainClient
  31     The functions provided in SOSCloudTransport.h provide an interface
  32     from CKBridge to SOSAccount/SOSCircle
  33  */
  34
  35 #ifndef _SOSCLOUDKEYCHAINCLIENT_H_
  36 #define _SOSCLOUDKEYCHAINCLIENT_H_
  37
  38 #include <CoreFoundation/CFArray.h>
  39 #include <CoreFoundation/CFDictionary.h>
  40 #include <CoreFoundation/CFError.h>
  41 #include <dispatch/dispatch.h>
  42
  43 __BEGIN_DECLS
  44
  45
  46 // MARK: ---------- SOSCloudTransport ----------
  47
  48 enum
  49 {
  50     kSOSObjectMallocFailed = 1,
  51     kAddDuplicateEntry,
  52     kSOSObjectNotFoundError = 1,
  53     kSOSObjectCantBeConvertedToXPCObject,
  54     kSOSOUnexpectedConnectionEvent,
  55     kSOSOXPCErrorEvent,
  56     kSOSOUnexpectedXPCEvent,
  57     kSOSConnectionNotOpen
  58 };
  59
  60 typedef CFArrayRef (^CloudItemsChangedBlock)(CFDictionaryRef values);
  61 typedef void (^CloudKeychainReplyBlock)(CFDictionaryRef returnedValues, CFErrorRef error);
  62
  63 /* SOSCloudTransport protocol.  */
  64 typedef struct SOSCloudTransport *SOSCloudTransportRef;
  65 struct SOSCloudTransport
  66 {
  67     void (*put)(SOSCloudTransportRef transport, CFDictionaryRef valuesToPut, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  68     bool (*updateKeys)(SOSCloudTransportRef transport, CFDictionaryRef keys, CFErrorRef *error);
  69
  70
  71     // Debug calls
  72     void (*get)(SOSCloudTransportRef transport, CFArrayRef keysToGet, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  73     void (*getAll)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  74     void (*synchronize)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  75     void (*synchronizeAndWait)(SOSCloudTransportRef transport, CFArrayRef keysToGet, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  76
  77     void (*clearAll)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  78     void (*removeObjectForKey)(SOSCloudTransportRef transport, CFStringRef keyToRemove, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  79     void (*localNotification)(SOSCloudTransportRef transport, CFStringRef messageToUser, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  80     void (*requestSyncWithAllPeers)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  81     void (*requestEnsurePeerRegistration)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  82     void (*flush)(SOSCloudTransportRef transport, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  83
  84     const void *itemsChangedBlock;
  85 };
  86
  87 /* Call this function before calling any other function in this header to provide
  88    an alternate transport, the default transport talks to CloudKeychainProxy via xpc. */
  89 void SOSCloudKeychainSetTransport(SOSCloudTransportRef transport);
  90
  91
  92 bool SOSCloudKeychainUpdateKeys(CFDictionaryRef keys,
  93                                 CFErrorRef *error);
  94 void SOSCloudKeychainUnRegisterKeys(CFArrayRef keysToUnregister, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  95
  96 void SOSCloudKeychainPutObjectsInCloud(CFDictionaryRef objects, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
  97
  98 void SOSCloudKeychainSetItemsChangedBlock(CloudItemsChangedBlock itemsChangedBlock);
  99
 100 CF_RETURNS_RETAINED CFArrayRef SOSCloudKeychainHandleUpdateKeyParameter(CFDictionaryRef updates);
 101 CF_RETURNS_RETAINED CFArrayRef SOSCloudKeychainHandleUpdateCircle(CFDictionaryRef updates);
 102 CF_RETURNS_RETAINED CFArrayRef SOSCloudKeychainHandleUpdateMessage(CFDictionaryRef updates);
 103 void SOSCloudKeychainSynchronizeAndWait(CFArrayRef keysToGet, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 104
 105 // Debug only?
 106
 107 void SOSCloudKeychainGetObjectsFromCloud(CFArrayRef keysToGet, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 108 void SOSCloudKeychainSynchronize(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 109 void SOSCloudKeychainClearAll(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 110 void SOSCloudKeychainRemoveObjectForKey(CFStringRef keyToRemove, dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 111 void SOSCloudKeychainGetAllObjectsFromCloud(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 112
 113 void SOSCloudKeychainRequestSyncWithAllPeers(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 114 void SOSCloudKeychainRequestEnsurePeerRegistration(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 115
 116 void SOSCloudKeychainFlush(dispatch_queue_t processQueue, CloudKeychainReplyBlock replyBlock);
 117
 118
 119 __END_DECLS
 120
 121 #endif /* !_SOSCLOUDKEYCHAINCLIENT_H_ */
 122