From efadbf79e9c864578bfd1277d824e69b2989aac5 Mon Sep 17 00:00:00 2001
From: Martin Willi <martin@strongswan.org>
Date: Thu, 30 Mar 2006 07:22:01 +0000
Subject: - rewrote a lot of RSA stuff - done major work for ASN1/decoder -
 allow loading of ASN1 der encoded private keys, public keys and certificates
 - extracting public key from certificates - passing certificates from stroke
 to charon

=> basic authentication with RSA certificates works!
---
 Source/charon/transforms/rsa/rsa_private_key.h | 85 +++++++++++++++-----------
 1 file changed, 51 insertions(+), 34 deletions(-)

(limited to 'Source/charon/transforms/rsa/rsa_private_key.h')

diff --git a/Source/charon/transforms/rsa/rsa_private_key.h b/Source/charon/transforms/rsa/rsa_private_key.h
index 094c3e249..ffbe419f5 100644
--- a/Source/charon/transforms/rsa/rsa_private_key.h
+++ b/Source/charon/transforms/rsa/rsa_private_key.h
@@ -38,10 +38,12 @@ typedef struct rsa_private_key_t rsa_private_key_t;
  * 
  * @b Constructors:
  *  - rsa_private_key_create()
+ *  - rsa_private_key_create_from_chunk()
+ *  - rsa_private_key_create_from_file()
  * 
  * @see rsa_public_key_t
  * 
- * @todo Implement proper key set/get load/save methods using ASN1.
+ * @todo Implement get_key(), save_key(), get_public_key()
  *
  * @ingroup rsa
  */
@@ -65,27 +67,10 @@ struct rsa_private_key_t {
 	 */
 	status_t (*build_emsa_pkcs1_signature) (rsa_private_key_t *this, hash_algorithm_t hash_algorithm, chunk_t data, chunk_t *signature);
 	
-	/**
-	 * @brief Set the key.
-	 * 
-	 * Currently uses a proprietary format which is only inteded
-	 * for testing. This should be replaced with a proper
-	 * ASN1 encoded key format, when charon gets the ASN1 
-	 * capabilities.
-	 * 
-	 * @param this				calling object
-	 * @param key				key (in a propriarity format)
-	 * @return					currently SUCCESS in any case
-	 */
-	status_t (*set_key) (rsa_private_key_t *this, chunk_t key);
-	
 	/**
 	 * @brief Gets the key.
 	 * 
-	 * Currently uses a proprietary format which is only inteded
-	 * for testing. This should be replaced with a proper
-	 * ASN1 encoded key format, when charon gets the ASN1 
-	 * capabilities.
+	 * UNIMPLEMENTED!
 	 * 
 	 * @param this				calling object
 	 * @param key				key (in a propriarity format)
@@ -95,17 +80,6 @@ struct rsa_private_key_t {
 	 */
 	status_t (*get_key) (rsa_private_key_t *this, chunk_t *key);
 	
-	/**
-	 * @brief Loads a key from a file.
-	 * 
-	 * Not implemented!
-	 * 
-	 * @param this				calling object
-	 * @param file				file from which key should be read
-	 * @return					NOT_SUPPORTED
-	 */
-	status_t (*load_key) (rsa_private_key_t *this, char *file);
-	
 	/**
 	 * @brief Saves a key to a file.
 	 * 
@@ -139,6 +113,18 @@ struct rsa_private_key_t {
 	 */
 	rsa_public_key_t *(*get_public_key) (rsa_private_key_t *this);
 	
+	/**
+	 * @brief Check if a private key belongs to a public key.
+	 * 
+	 * Compares the public part of the private key with the
+	 * public key, return TRUE if it equals.
+	 * 
+	 * @param this				private key
+	 * @param public			public key
+	 * @return					TRUE, if keys belong together
+	 */
+	bool (*belongs_to) (rsa_private_key_t *this, rsa_public_key_t *public);
+	
 	/**
 	 * @brief Destroys the private key.
 	 * 
@@ -148,13 +134,44 @@ struct rsa_private_key_t {
 };
 
 /**
- * @brief Create a new rsa_private_key without
- * any key inside.
+ * @brief Generate a new RSA key with specified key lenght.
+ * 
+ * @param key_size			size of the key in bits
+ * @return 					generated rsa_private_key_t.
+ * 
+ * @ingroup rsa
+ */
+rsa_private_key_t *rsa_private_key_create(size_t key_size);
+
+/**
+ * @brief Load an RSA private key from a chunk.
+ * 
+ * Load a key from a chunk, encoded as described in PKCS#1
+ * (ASN1 DER encoded).
+ * 
+ * @param chunk				chunk containing the DER encoded key
+ * @return 					loaded rsa_private_key_t, or NULL
+ * 
+ * @ingroup rsa
+ */
+rsa_private_key_t *rsa_private_key_create_from_chunk(chunk_t chunk);
+
+/**
+ * @brief Load an RSA private key from a file.
+ * 
+ * Load a key from a file, which is either in a unencrypted binary
+ * format (DER), or in a (encrypted) PEM format. The supplied 
+ * passphrase is used to decrypt an ecrypted key.
+ * 
+ * @param filename			filename which holds the key
+ * @param passphrase		optional passphase for decryption
+ * @return 					loaded rsa_private_key_t, or NULL
  * 
- * @return created rsa_private_key_t.
+ * @todo Implement PEM file loading
+ * @todo Implement key decryption
  * 
  * @ingroup rsa
  */
-rsa_private_key_t *rsa_private_key_create();
+rsa_private_key_t *rsa_private_key_create_from_file(char *filename, char *passphrase);
 
 #endif /*RSA_PRIVATE_KEY_H_*/
-- 
cgit v1.2.3