X-Git-Url: https://git.saurik.com/apple/security.git/blobdiff_plain/5dd5f9ec28f304ca377c42fd7f711d6cf12b90e1..5c19dc3ae3bd8e40a9c028b0deddd50ff337692c:/OSX/libsecurity_apple_csp/lib/DH_utils.h

diff --git a/OSX/libsecurity_apple_csp/lib/DH_utils.h b/OSX/libsecurity_apple_csp/lib/DH_utils.h
new file mode 100644
index 00000000..bdf10f6f
--- /dev/null
+++ b/OSX/libsecurity_apple_csp/lib/DH_utils.h
@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2000-2001,2011,2014 Apple Inc. All Rights Reserved.
+ * 
+ * The contents of this file constitute Original Code as defined in and are
+ * subject to the Apple Public Source License Version 1.2 (the 'License').
+ * You may not use this file except in compliance with the License. Please obtain
+ * a copy of the License at http://www.apple.com/publicsource and read it before
+ * using this file.
+ * 
+ * This Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
+ * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
+ * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
+ * specific language governing rights and limitations under the License.
+ */
+
+
+/*
+ * DH_utils.h
+ */
+#ifndef	_DH_UTILS_H_
+#define _DH_UTILS_H_
+
+#include <openssl/dh.h>
+#include <AppleCSPSession.h>
+#include <security_cdsa_utilities/context.h>
+
+#ifdef	__cplusplus
+extern "C" {
+#endif
+
+void throwDh(
+	const char *op);
+	
+/* 
+ * Given a Context:
+ * -- obtain CSSM key (there must only be one)
+ * -- validate keyClass - MUST be private! (DH public keys are never found
+ *    in contexts.)
+ * -- validate keyUsage
+ * -- convert to DH *, allocating the DH key if necessary
+ */
+DH *contextToDhKey(
+	const Context 		&context,
+	AppleCSPSession	 	&session,
+	CSSM_ATTRIBUTE_TYPE	attr,		  // CSSM_ATTRIBUTE_KEY for normal private key
+									  // CSSM_ATTRIBUTE_PUBLIC_KEY for public key
+	CSSM_KEYCLASS		keyClass,	  // CSSM_KEYCLASS_{PUBLIC,PRIVATE}_KEY	
+	CSSM_KEYUSE			usage,		  // CSSM_KEYUSE_ENCRYPT, 
+									  //    CSSM_KEYUSE_SIGN, etc.
+	bool				&mallocdKey); // RETURNED
+
+/* 
+ * Convert a CssmKey to an DH * key. May result in the creation of a new
+ * DH (when cssmKey is a raw key); allocdKey is true in that case
+ * in which case the caller generally has to free the allocd key).
+ */
+DH *cssmKeyToDh(
+	const CssmKey	&cssmKey,
+	AppleCSPSession	&session,
+	bool			&allocdKey);	// RETURNED
+
+/* 
+ * Convert a raw CssmKey to a newly alloc'd DH *.
+ */
+DH *rawCssmKeyToDh(
+	const CssmKey	&cssmKey);
+
+
+#ifdef	__cplusplus
+}
+#endif
+
+#endif	/*_DH_UTILS_H_ */