OSX/sec/Security/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 void 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