aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2012-04-19 21:59:28 -0300
committerSilvio Rhatto <rhatto@riseup.net>2012-04-19 21:59:28 -0300
commit00ff99c2eb1ef21a3965e5abb9aecd908d47024f (patch)
treefa3cd6c9afad6a8960a61bf253a6ed35541699c2
parent705317bfb57c9a452cba8a9c859b378ab6fd141c (diff)
downloadkeyringer-00ff99c2eb1ef21a3965e5abb9aecd908d47024f.tar.gz
keyringer-00ff99c2eb1ef21a3965e5abb9aecd908d47024f.tar.bz2
Changing ssss recipients scheme design
-rw-r--r--README40
1 files changed, 25 insertions, 15 deletions
diff --git a/README b/README
index a202ead..0063a08 100644
--- a/README
+++ b/README
@@ -79,28 +79,38 @@ it will use it instead of the global recipients file.
SSSS Support
------------
-Say you have the following recipients:
+SSSS support comes with "ssss group" files where each file (say
+config/ssss/ssss-groupA) has one recipient file per line.
- - admins-1
- - admins-2
- - admins-3
- - admins-4
+Command line syntax is:
-And you want to split a secret among these groups.
+ keyringer <keyring> ssss-split <secret-name> [ssss-group] [ssss-options]
- keyringer <keyring> ssss-split <secret-name> <threshold> 4 [options]
+So if we have:
-This will generate 4 files in you keyringer:
+ config/recipients/recipientsA:
- keys/admins-1/secret-name.asc
- keys/admins-2/secret-name.asc
- keys/admins-3/secret-name.asc
- keys/admins-4/secret-name.asc
+ user1@domain
+ user2@domain
-Each of them has one different ssss share. Decryption of one sharing
-is straightforward. Say you're on admins-1 group:
+ config/recipients/recipientsB
- keyringer <keyring> decrypt admins-1/secret-name
+ user3@domain
+ user4@domain
+
+ config/ssss/ssss-groupA:
+
+ recipientsA
+ recipientsB
+
+Then the following command
+
+ keyringer <keyring> ssss-split secret-data ssss-groupA
+
+would split some data into distinct files:
+
+ keys/recipientsA/secret-data.asc: encrypted to user{1,2}@domain
+ keys/recipientsB/secret-data.asc: encrypted to user{3,4}@domain
Managing keys
----------------