README

   1 == Description
   2    A libary for sharing secrets in an information-theoretically secure way.
   3    It uses Shamir's secret sharing to enable sharing a (random) secret between
   4    n persons where k <= n persons are enough to recover the secret. k-1 secret
   5    share holders learn nothing about the secret when they combine their shares.
   6
   7    This library is based on the OpenXPKI::Crypto::Secret::Split Perl module used
   8    in the open source PKI software OpenXPKI, which was written by Alexander Klink
   9    for the OpenXPKI project in 2006.
  10
  11 == Prerequisites
  12    This package requires Ruby 1.8 or later.
  13
  14 == Installation instructions
  15    rake test (optional)
  16    rake install (non-gem) or rake install_gem (gem)
  17
  18 == Synopsis
  19    require 'secretsharing'
  20
  21    # create an object for 3 out of 5 secret sharing
  22    s = SecretSharing::Shamir.new(5,3)
  23
  24    # create a random secret (returns the secret)
  25    s.create_random_secret()
  26
  27    # show secret
  28    puts s.secret
  29
  30    # show shares
  31    s.shares.each { |share| puts share }
  32
  33    # recover secret from shares
  34
  35    s2 = SecretSharing::Shamir.new(3)
  36    # accepts SecretSharing::Shamir::Share objects or
  37    # string representations thereof
  38    s2 << s.shares[0]
  39    s2 << s.shares[2]
  40    s2 << s.shares[4]
  41    puts s2.secret
  42
  43 == Future Plans
  44    Add support for using your own instead of a random secret.
  45
  46 == Copyright
  47    (c) 2010 Alexander Klink
  48
  49 == License
  50    Licensed under the Apache License, Version 2.0 (the "License");
  51    you may not use this file except in compliance with the License.
  52    You may obtain a copy of the License at
  53
  54    http://www.apache.org/licenses/LICENSE-2.0
  55
  56 == Warranty
  57    Unless required by applicable law or agreed to in writing, software
  58    distributed under the License is distributed on an "AS IS" BASIS,
  59    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  60    See the License for the specific language governing permissions and
  61    limitations under the License.
  62
  63 == Author
  64    Alexander Klink
  65    secretsharing@alech.de
  66    http://www.alech.de
  67    @alech on Twitter