/ OSX / sec / Security / SecOTRDHKey.h
SecOTRDHKey.h
 1  /*
 2   * Copyright (c) 2011-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  #ifndef _SECOTRDHKEY_H_
25  #define _SECOTRDHKEY_H_
26  
27  #include <CoreFoundation/CFBase.h>
28  #include <CoreFoundation/CFData.h>
29  #include <corecrypto/ccn.h>
30  #include <corecrypto/ccsha1.h>
31  
32  __BEGIN_DECLS
33  
34  typedef struct _SecOTRFullDHKey* SecOTRFullDHKeyRef;
35  typedef struct _SecOTRPublicDHKey* SecOTRPublicDHKeyRef;
36  
37  SecOTRFullDHKeyRef SecOTRFullDHKCreate(CFAllocatorRef allocator);
38  SecOTRFullDHKeyRef SecOTRFullDHKCreateFromBytes(CFAllocatorRef allocator, const uint8_t**bytes, size_t*size);
39  
40  OSStatus SecFDHKNewKey(SecOTRFullDHKeyRef key);
41  void SecFDHKAppendSerialization(SecOTRFullDHKeyRef fullKey, CFMutableDataRef appendTo);
42  void SecFDHKAppendPublicSerialization(SecOTRFullDHKeyRef fullKey, CFMutableDataRef appendTo);
43  void SecFDHKAppendCompactPublicSerialization(SecOTRFullDHKeyRef fullKey, CFMutableDataRef appendTo);
44  
45  static const size_t kSecDHKHashSize = CCSHA1_OUTPUT_SIZE;
46  
47  uint8_t* SecFDHKGetHash(SecOTRFullDHKeyRef pubKey);
48  
49  
50  SecOTRPublicDHKeyRef SecOTRPublicDHKCreateFromFullKey(CFAllocatorRef allocator, SecOTRFullDHKeyRef full);
51  SecOTRPublicDHKeyRef SecOTRPublicDHKCreateFromSerialization(CFAllocatorRef allocator, const uint8_t**bytes, size_t*size);
52  SecOTRPublicDHKeyRef SecOTRPublicDHKCreateFromCompactSerialization(CFAllocatorRef allocator, const uint8_t** bytes, size_t *size);
53  SecOTRPublicDHKeyRef SecOTRPublicDHKCreateFromBytes(CFAllocatorRef allocator, const uint8_t** bytes, size_t *size);
54  
55  void SecPDHKAppendSerialization(SecOTRPublicDHKeyRef pubKey, CFMutableDataRef appendTo);
56  void SecPDHKAppendCompactSerialization(SecOTRPublicDHKeyRef pubKey, CFMutableDataRef appendTo);
57  uint8_t* SecPDHKGetHash(SecOTRPublicDHKeyRef pubKey);
58  
59  void SecPDHKeyGenerateS(SecOTRFullDHKeyRef myKey, SecOTRPublicDHKeyRef theirKey, cc_unit* s);
60  
61  bool SecDHKIsGreater(SecOTRFullDHKeyRef myKey, SecOTRPublicDHKeyRef theirKey);
62  
63  void SecOTRDHKGenerateOTRKeys(SecOTRFullDHKeyRef myKey, SecOTRPublicDHKeyRef theirKey,
64                             uint8_t* sendMessageKey, uint8_t* sendMacKey,
65                             uint8_t* receiveMessageKey, uint8_t* receiveMacKey);
66  
67  __END_DECLS
68  
69  #endif