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 * DH_utils.h 21 */ 22#ifndef _DH_UTILS_H_ 23#define _DH_UTILS_H_ 24 25#include <openssl/dh.h> 26#include <AppleCSPSession.h> 27#include <security_cdsa_utilities/context.h> 28 29#ifdef __cplusplus 30extern "C" { 31#endif 32 33void throwDh( 34 const char *op); 35 36/* 37 * Given a Context: 38 * -- obtain CSSM key (there must only be one) 39 * -- validate keyClass - MUST be private! (DH public keys are never found 40 * in contexts.) 41 * -- validate keyUsage 42 * -- convert to DH *, allocating the DH key if necessary 43 */ 44DH *contextToDhKey( 45 const Context &context, 46 AppleCSPSession &session, 47 CSSM_ATTRIBUTE_TYPE attr, // CSSM_ATTRIBUTE_KEY for normal private key 48 // CSSM_ATTRIBUTE_PUBLIC_KEY for public key 49 CSSM_KEYCLASS keyClass, // CSSM_KEYCLASS_{PUBLIC,PRIVATE}_KEY 50 CSSM_KEYUSE usage, // CSSM_KEYUSE_ENCRYPT, 51 // CSSM_KEYUSE_SIGN, etc. 52 bool &mallocdKey); // RETURNED 53 54/* 55 * Convert a CssmKey to an DH * key. May result in the creation of a new 56 * DH (when cssmKey is a raw key); allocdKey is true in that case 57 * in which case the caller generally has to free the allocd key). 58 */ 59DH *cssmKeyToDh( 60 const CssmKey &cssmKey, 61 AppleCSPSession &session, 62 bool &allocdKey); // RETURNED 63 64/* 65 * Convert a raw CssmKey to a newly alloc'd DH *. 66 */ 67DH *rawCssmKeyToDh( 68 const CssmKey &cssmKey); 69 70 71#ifdef __cplusplus 72} 73#endif 74 75#endif /*_DH_UTILS_H_ */ 76