From bd0551b22076b82a6d49e9f7a2b2e0c90a1b2326 Mon Sep 17 00:00:00 2001
From: Aleksander Machniak <alec@alec.pl>
Date: Fri, 05 Feb 2016 07:25:27 -0500
Subject: [PATCH] Secure also downloads of addressbook exports, managesieve script exports and Enigma keys exports

---
 plugins/enigma/lib/enigma_driver.php |   33 +++++++++++++++++++++++++++++----
 1 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/plugins/enigma/lib/enigma_driver.php b/plugins/enigma/lib/enigma_driver.php
index 4c8340e..7fa3342 100644
--- a/plugins/enigma/lib/enigma_driver.php
+++ b/plugins/enigma/lib/enigma_driver.php
@@ -33,11 +33,16 @@
 
     /**
      * Encryption.
+     *
+     * @param string Message body
+     * @param array  List of key-password mapping
+     *
+     * @return mixed Encrypted message or enigma_error on failure
      */
     abstract function encrypt($text, $keys);
 
     /**
-     * Decryption..
+     * Decryption.
      *
      * @param string Encrypted message
      * @param array  List of key-password mapping
@@ -46,6 +51,13 @@
 
     /**
      * Signing.
+     *
+     * @param string Message body
+     * @param string Key ID
+     * @param string Key password
+     * @param int    Signing mode (enigma_engine::SIGN_*)
+     *
+     * @return mixed True on success or enigma_error on failure
      */
     abstract function sign($text, $key, $passwd, $mode = null);
 
@@ -67,7 +79,16 @@
      *
      * @return mixed Import status array or enigma_error
      */
-    abstract function import($content, $isfile=false);
+    abstract function import($content, $isfile = false);
+
+    /**
+     * Key/Cert export.
+     *
+     * @param string Key ID
+     *
+     * @return mixed Key content or enigma_error
+     */
+    abstract function export($key);
 
     /**
      * Keys listing.
@@ -76,7 +97,7 @@
      *
      * @return mixed Array of enigma_key objects or enigma_error
      */
-    abstract function list_keys($pattern='');
+    abstract function list_keys($pattern = '');
 
     /**
      * Single key information.
@@ -90,7 +111,7 @@
     /**
      * Key pair generation.
      *
-     * @param array Key/User data
+     * @param array Key/User data (name, email, password, size)
      *
      * @return mixed Key (enigma_key) object or enigma_error
      */
@@ -98,6 +119,10 @@
 
     /**
      * Key deletion.
+     *
+     * @param string Key ID
+     *
+     * @return mixed True on success or enigma_error
      */
     abstract function delete_key($keyid);
 }

--
Gitblit v1.9.1