add plugins for key and attributes escrow

7 files changed, 512 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index b337cc058..e65a8cfdb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -72,3 +72,5 @@ cmake/
 build
 CMakeLists.txt
 CMakeFiles.txt
+
+.vscode/settings.json
diff --git a/src/include/gnunet_reclaim_lib.h b/src/include/gnunet_reclaim_lib.h
index 54d284f3c..d7d1eb938 100644
--- a/src/include/gnunet_reclaim_lib.h
+++ b/src/include/gnunet_reclaim_lib.h
@@ -66,6 +66,22 @@ extern "C" {
 #define GNUNET_RECLAIM_ID_LENGTH (256 / 8)
 
 /**
+ * Enum for the different key escrow methods
+ */
+enum GNUNET_RECLAIM_Key_Escrow_Method {
+  GNUNET_RECLAIM_KE_PLAINTEXT,
+  GNUNET_RECLAIM_KE_GNS,
+  GNUNET_RECLAIM_KE_ANASTASIS
+};
+
+/**
+ * Enum for the different attribute escrow methods
+ */
+enum GNUNET_RECLAIM_Attribute_Escrow_Method {
+  GNUNET_RECLAIM_AE_PLAINTEXT
+};
+
+/**
  * A reclaim identifier
  * FIXME maybe put this in a different namespace
  */
diff --git a/src/include/gnunet_reclaim_plugin.h b/src/include/gnunet_reclaim_plugin.h
index 992ad0cc3..c9875e87c 100644
--- a/src/include/gnunet_reclaim_plugin.h
+++ b/src/include/gnunet_reclaim_plugin.h
@@ -32,6 +32,7 @@
 
 #include "gnunet_util_lib.h"
 #include "gnunet_reclaim_lib.h"
+#include "gnunet_identity_service.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -200,6 +201,50 @@ typedef int (*GNUNET_RECLAIM_AttestationGetExpirationFunction) (
   const struct GNUNET_RECLAIM_Attestation *attest,
   struct GNUNET_TIME_Absolute *expiration);
 
+/**
+ * Function called to start the escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+typedef int (*GNUNET_RECLAIM_EscrowStartKeyEscrowFunction) (
+  struct GNUNET_IDENTITY_Ego *ego,
+  void *escrowAnchor);
+
+/**
+ * Function called to renew the escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+typedef int (*GNUNET_RECLAIM_EscrowRenewKeyEscrowFunction) (
+  struct GNUNET_IDENTITY_Ego *ego,
+  void *escrowAnchor);
+
+/**
+ * Function called to start the escrow of the attributes
+ * 
+ * @param identity the private key of the identity
+ * @param escrowAnchor the anchor needed to restore the attributes
+ * @return GNUNET_OK if successful
+ */
+typedef int (*GNUNET_RECLAIM_EscrowStartAttributesEscrowFunction) (
+  const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity,
+  void *escrowAnchor);
+
+/**
+ * Function called to renew the escrow of the attributes
+ * 
+ * @param identity the private key of the identity
+ * @param escrowAnchor the anchor needed to restore the attributes
+ * @return GNUNET_OK if successful
+ */
+typedef int (*GNUNET_RECLAIM_EscrowRenewAttributesEscrowFunction) (
+  const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity,
+  void *escrowAnchor);
+
 
 
 /**
@@ -282,6 +327,49 @@ struct GNUNET_RECLAIM_AttestationPluginFunctions
   GNUNET_RECLAIM_AttestationGetExpirationFunction get_expiration;
 };
 
+/**
+ * Each plugin is required to return a pointer to a struct of this
+ * type as the return value from its entry point.
+ */
+struct GNUNET_RECLAIM_EscrowKeyPluginFunctions
+{
+  /**
+   * Closure for all of the callbacks.
+   */
+  void *cls;
+
+  /**
+   * Start key escrow
+   */
+  GNUNET_RECLAIM_EscrowStartKeyEscrowFunction start_key_escrow;
+
+  /**
+   * Renew key escrow
+   */
+  GNUNET_RECLAIM_EscrowRenewKeyEscrowFunction renew_key_escrow;
+};
+
+/**
+ * Each plugin is required to return a pointer to a struct of this
+ * type as the return value from its entry point.
+ */
+struct GNUNET_RECLAIM_EscrowAttributesPluginFunctions
+{
+  /**
+   * Closure for all of the callbacks.
+   */
+  void *cls;
+
+  /**
+   * Start attributes escrow
+   */
+  GNUNET_RECLAIM_EscrowStartAttributesEscrowFunction start_attributes_escrow;
+
+  /**
+   * Renew attributes escrow
+   */
+  GNUNET_RECLAIM_EscrowRenewAttributesEscrowFunction renew_attributes_escrow;
+};
 
 
 #if 0 /* keep Emacsens' auto-indent happy */
diff --git a/src/reclaim/plugin_reclaim_escrow_attributes_plaintext.c b/src/reclaim/plugin_reclaim_escrow_attributes_plaintext.c
new file mode 100644
index 000000000..3000bae13
--- /dev/null
+++ b/src/reclaim/plugin_reclaim_escrow_attributes_plaintext.c
@@ -0,0 +1,99 @@
+/*
+     This file is part of GNUnet
+     Copyright (C) 2013, 2014, 2016 GNUnet e.V.
+
+     GNUnet is free software: you can redistribute it and/or modify it
+     under the terms of the GNU Affero General Public License as published
+     by the Free Software Foundation, either version 3 of the License,
+     or (at your option) any later version.
+
+     GNUnet is distributed in the hope that it will be useful, but
+     WITHOUT ANY WARRANTY; without even the implied warranty of
+     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+     Affero General Public License for more details.
+
+     You should have received a copy of the GNU Affero General Public License
+     along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+     SPDX-License-Identifier: AGPL3.0-or-later
+ */
+
+/**
+ * @file reclaim-escrow/plugin_reclaim_escrow_attributes_plaintext.c
+ * @brief reclaim-escrow-plugin-attributes-plaintext escrow plugin for
+ *        plaintext escrow of the attributes
+ *
+ * @author Johannes Späth
+ */
+#include "platform.h"
+#include "gnunet_util_lib.h"
+#include "gnunet_reclaim_plugin.h"
+#include <inttypes.h>
+
+
+/**
+ * Start the plaintext escrow of the attributes, i.e. simply hand them out
+ * 
+ * @param identity the private key of the identity
+ * @param escrowAnchor the anchor needed to restore the attributes
+ * @return GNUNET_OK if successful
+ */
+int
+start_plaintext_attributes_escrow (const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity,
+                                   void *escrowAnchor)
+{
+  // TODO: implement
+  return GNUNET_NO;
+}
+
+
+/**
+ * Renew the plaintext escrow of the attributes, i.e. simply hand them out
+ * 
+ * @param identity the private key of the identity
+ * @param escrowAnchor the anchor needed to restore the attributes
+ * @return GNUNET_OK if successful
+ */
+int
+renew_plaintext_attributes_escrow (const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity,
+                                   void *escrowAnchor)
+{
+  return start_plaintext_attributes_escrow(identity, escrowAnchor);
+}
+
+
+/**
+ * Entry point for the plugin.
+ *
+ * @param cls NULL
+ * @return the exported block API
+ */
+void *
+libgnunet_plugin_reclaim_escrow_plaintext_init (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowAttributesPluginFunctions *api;
+
+  api = GNUNET_new (struct GNUNET_RECLAIM_EscrowAttributesPluginFunctions);
+  api->start_attributes_escrow = &start_plaintext_attributes_escrow;
+  api->renew_attributes_escrow = &renew_plaintext_attributes_escrow;
+  return api;
+}
+
+
+/**
+ * Exit point from the plugin.
+ *
+ * @param cls the return value from #libgnunet_plugin_block_test_init()
+ * @return NULL
+ */
+void *
+libgnunet_plugin_reclaim_escrow_plaintext_done (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowAttributesPluginFunctions *api = cls;
+
+  GNUNET_free (api);
+  return NULL;
+}
+
+
+/* end of plugin_reclaim_escrow_attributes_plaintext.c */
diff --git a/src/reclaim/plugin_reclaim_escrow_key_anastasis.c b/src/reclaim/plugin_reclaim_escrow_key_anastasis.c
new file mode 100644
index 000000000..5de07761e
--- /dev/null
+++ b/src/reclaim/plugin_reclaim_escrow_key_anastasis.c
@@ -0,0 +1,100 @@
+/*
+     This file is part of GNUnet
+     Copyright (C) 2013, 2014, 2016 GNUnet e.V.
+
+     GNUnet is free software: you can redistribute it and/or modify it
+     under the terms of the GNU Affero General Public License as published
+     by the Free Software Foundation, either version 3 of the License,
+     or (at your option) any later version.
+
+     GNUnet is distributed in the hope that it will be useful, but
+     WITHOUT ANY WARRANTY; without even the implied warranty of
+     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+     Affero General Public License for more details.
+
+     You should have received a copy of the GNU Affero General Public License
+     along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+     SPDX-License-Identifier: AGPL3.0-or-later
+ */
+
+/**
+ * @file reclaim-escrow/plugin_reclaim_escrow_key_anastasis.c
+ * @brief reclaim-escrow-plugin-key-anastasis escrow plugin for
+ *        escrow of the key using Anastasis
+ *
+ * @author Johannes Späth
+ */
+#include "platform.h"
+#include "gnunet_util_lib.h"
+#include "gnunet_reclaim_plugin.h"
+#include <inttypes.h>
+
+
+/**
+ * Start the Anastasis escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+start_anastasis_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                            void *escrowAnchor)
+{
+  // TODO: implement
+  return GNUNET_NO;
+}
+
+
+/**
+ * Renew the Anastasis escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+renew_anastasis_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                            void *escrowAnchor)
+{
+  // TODO: implement
+  return GNUNET_NO;
+}
+
+
+/**
+ * Entry point for the plugin.
+ *
+ * @param cls NULL
+ * @return the exported block API
+ */
+void *
+libgnunet_plugin_reclaim_escrow_anastasis_init (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api;
+
+  api = GNUNET_new (struct GNUNET_RECLAIM_EscrowKeyPluginFunctions);
+  api->start_key_escrow = &start_anastasis_key_escrow;
+  api->renew_key_escrow = &renew_anastasis_key_escrow;
+  return api;
+}
+
+
+/**
+ * Exit point from the plugin.
+ *
+ * @param cls the return value from #libgnunet_plugin_block_test_init()
+ * @return NULL
+ */
+void *
+libgnunet_plugin_reclaim_escrow_anastasis_done (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api = cls;
+
+  GNUNET_free (api);
+  return NULL;
+}
+
+
+/* end of plugin_reclaim_escrow_key_anastasis.c */
diff --git a/src/reclaim/plugin_reclaim_escrow_key_gns.c b/src/reclaim/plugin_reclaim_escrow_key_gns.c
new file mode 100644
index 000000000..75784b121
--- /dev/null
+++ b/src/reclaim/plugin_reclaim_escrow_key_gns.c
@@ -0,0 +1,100 @@
+/*
+     This file is part of GNUnet
+     Copyright (C) 2013, 2014, 2016 GNUnet e.V.
+
+     GNUnet is free software: you can redistribute it and/or modify it
+     under the terms of the GNU Affero General Public License as published
+     by the Free Software Foundation, either version 3 of the License,
+     or (at your option) any later version.
+
+     GNUnet is distributed in the hope that it will be useful, but
+     WITHOUT ANY WARRANTY; without even the implied warranty of
+     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+     Affero General Public License for more details.
+
+     You should have received a copy of the GNU Affero General Public License
+     along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+     SPDX-License-Identifier: AGPL3.0-or-later
+ */
+
+/**
+ * @file reclaim-escrow/plugin_reclaim_escrow_key_gns.c
+ * @brief reclaim-escrow-plugin-key-gns escrow plugin for
+ *        the escrow of the key using GNS and escrow identities
+ *
+ * @author Johannes Späth
+ */
+#include "platform.h"
+#include "gnunet_util_lib.h"
+#include "gnunet_reclaim_plugin.h"
+#include <inttypes.h>
+
+
+/**
+ * Start the GNS escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+start_gns_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                      void *escrowAnchor)
+{
+  // TODO: implement
+  return GNUNET_NO;
+}
+
+
+/**
+ * Renew the GNS escrow of the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+renew_gns_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                      void *escrowAnchor)
+{
+  // TODO: implement
+  return GNUNET_NO;
+}
+
+
+/**
+ * Entry point for the plugin.
+ *
+ * @param cls NULL
+ * @return the exported block API
+ */
+void *
+libgnunet_plugin_reclaim_escrow_gns_init (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api;
+
+  api = GNUNET_new (struct GNUNET_RECLAIM_EscrowKeyPluginFunctions);
+  api->start_key_escrow = &start_gns_key_escrow;
+  api->renew_key_escrow = &renew_gns_key_escrow;
+  return api;
+}
+
+
+/**
+ * Exit point from the plugin.
+ *
+ * @param cls the return value from #libgnunet_plugin_block_test_init()
+ * @return NULL
+ */
+void *
+libgnunet_plugin_reclaim_escrow_gns_done (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api = cls;
+
+  GNUNET_free (api);
+  return NULL;
+}
+
+
+/* end of plugin_reclaim_escrow_key_gns.c */
diff --git a/src/reclaim/plugin_reclaim_escrow_key_plaintext.c b/src/reclaim/plugin_reclaim_escrow_key_plaintext.c
new file mode 100644
index 000000000..3971136d7
--- /dev/null
+++ b/src/reclaim/plugin_reclaim_escrow_key_plaintext.c
@@ -0,0 +1,107 @@
+/*
+     This file is part of GNUnet
+     Copyright (C) 2013, 2014, 2016 GNUnet e.V.
+
+     GNUnet is free software: you can redistribute it and/or modify it
+     under the terms of the GNU Affero General Public License as published
+     by the Free Software Foundation, either version 3 of the License,
+     or (at your option) any later version.
+
+     GNUnet is distributed in the hope that it will be useful, but
+     WITHOUT ANY WARRANTY; without even the implied warranty of
+     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+     Affero General Public License for more details.
+
+     You should have received a copy of the GNU Affero General Public License
+     along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+     SPDX-License-Identifier: AGPL3.0-or-later
+ */
+
+/**
+ * @file reclaim-escrow/plugin_reclaim_escrow_key_plaintext.c
+ * @brief reclaim-escrow-plugin-key-plaintext escrow plugin for
+ *        plaintext escrow of the key
+ *
+ * @author Johannes Späth
+ */
+#include "platform.h"
+#include "gnunet_util_lib.h"
+#include "gnunet_identity_service.h"
+#include "gnunet_reclaim_plugin.h"
+#include <inttypes.h>
+
+
+/**
+ * Start the plaintext escrow of the key, i.e. simply hand out the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+start_plaintext_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                            void *escrowAnchor)
+{
+  struct GNUNET_CRYPTO_EcdsaPrivateKey *pk;
+
+  if (NULL == ego)
+  {
+    return GNUNET_NO;
+  }
+  pk = GNUNET_IDENTITY_ego_get_private_key (ego);
+  escrowAnchor = GNUNET_CRYPTO_ecdsa_private_key_to_string (pk);
+  return GNUNET_OK;
+}
+
+
+/**
+ * Renew the plaintext escrow of the key, i.e. simply hand out the key
+ * 
+ * @param ego the identity ego containing the private key
+ * @param escrowAnchor the anchor needed to restore the key
+ * @return GNUNET_OK if successful
+ */
+int
+renew_plaintext_key_escrow (struct GNUNET_IDENTITY_Ego *ego,
+                            void *escrowAnchor)
+{
+  return start_plaintext_key_escrow (ego, escrowAnchor);
+}
+
+
+/**
+ * Entry point for the plugin.
+ *
+ * @param cls NULL
+ * @return the exported block API
+ */
+void *
+libgnunet_plugin_reclaim_escrow_plaintext_init (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api;
+
+  api = GNUNET_new (struct GNUNET_RECLAIM_EscrowKeyPluginFunctions);
+  api->start_key_escrow = &start_plaintext_key_escrow;
+  api->renew_key_escrow = &renew_plaintext_key_escrow;
+  return api;
+}
+
+
+/**
+ * Exit point from the plugin.
+ *
+ * @param cls the return value from #libgnunet_plugin_block_test_init()
+ * @return NULL
+ */
+void *
+libgnunet_plugin_reclaim_escrow_plaintext_done (void *cls)
+{
+  struct GNUNET_RECLAIM_EscrowKeyPluginFunctions *api = cls;
+
+  GNUNET_free (api);
+  return NULL;
+}
+
+
+/* end of plugin_reclaim_escrow_key_plaintext.c */