porky_lib 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 073de134fa0c5a3b836f975475ecd1373488cc7a1549f1d5d363a3f1363c6488
-  data.tar.gz: 0e03c14d1d9251f9ce5caa4b47d172c9c09991040aebc7a36e28513edddeccac
+  metadata.gz: c98aaa41950874c7b37f159230db8356e526dec8f35a2a7d9c5fbe9d1f484a21
+  data.tar.gz: 5997f378160b2b05cd176c44b25570374159cbaafa7d8f83e1eb8c52014d7ca6
 SHA512:
-  metadata.gz: 774a7f3448d8dacc59dbd8302b9edbe70a5e6b28ee6d7bb95edd9e7b3e3a1b050a125ed7c31027358849adb3a9bf7fdf592ba19f78e1bb6a76eb9bbe978dfdc1
-  data.tar.gz: f7f67d35b7ad9624addee071af67b94c9def18aff469f62636ee92b781342cd98caedd44ac4ad3a7216fb5b95d2adaee6dbd6a7bfa5242f7d47e41cd76ad043c
+  metadata.gz: 2bbcd43825926a03d5382cefad9ff6053a83117aaf163a12bd6e5a0502d595ce4b2167be745e1417e4d019e88df9f1a8c6e0e2a9266c5273245534c34d83cac2
+  data.tar.gz: 93dbfb9406f2773017fac22946eba097405945181cc3bf26762f222dff1c1a27538c04eec9006aecb626a201357df11fe7073bd4a023a39fc97e458caec8d13d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    porky_lib (0.6.2)
+    porky_lib (0.7.0)
       aws-sdk-kms
       aws-sdk-s3
       msgpack
@@ -22,7 +22,7 @@ GEM
     aws-sdk-kms (1.24.0)
       aws-sdk-core (~> 3, >= 3.61.1)
       aws-sigv4 (~> 1.1)
-    aws-sdk-s3 (1.47.0)
+    aws-sdk-s3 (1.48.0)
       aws-sdk-core (~> 3, >= 3.61.1)
       aws-sdk-kms (~> 1)
       aws-sigv4 (~> 1.1)

data/README.md

@@ -76,6 +76,16 @@ To encrypt data:
 [ciphertext_dek, ciphertext, nonce] = PorkyLib::Symmetric.instance.encrypt(data, cmk_key_id, ciphertext_dek, encryption_context)
 ```
 
+To encrypt data with a known plaintext key:
+```ruby
+# Where plaintext is the data to encrypt
+# plaintext_key is the encryption key to use
+# encryption_info is the structure returned that contains:
+#   ciphertext: plaintext encrypted under plaintext_key
+#   nonce: The generated nonce 
+encryption_info = PorkyLib::Symmetric.instance.encrypt_with_key(plaintext, plaintext_key)
+```
+
 ### Decrypting Data
 To decrypt data:
 ```ruby
@@ -86,6 +96,16 @@ To decrypt data:
 plaintext_data = PorkyLib::Symmetric.instance.decrypt(ciphertext_dek, ciphertext, nonce, encryption_context)
 ```
 
+To decrypt data with a known plaintext key:
+```ruby
+# Where ciphertext is the encrypted data to be decrypted
+# plaintext_key is the decryption key to use
+# nonce is the nonce to use 
+# decryption_info is the structured returned that contains:
+#   plaintext: ciphertext decrypted under plaintext_key
+decryption_info = PorkyLib::Symmetric.instance.decrypt_with_key(ciphertext, plaintext_key, nonce)
+```
+
 ### Generating Data Encryption Keys
 To generate a new data encryption key:
 ```ruby

data/lib/porky_lib/symmetric.rb

@@ -191,6 +191,40 @@ class PorkyLib::Symmetric
     "\0" * length
   end
 
+  def encrypt_with_key(plaintext, plaintext_key)
+    # Initialize the box
+    secret_box = RbNaCl::SecretBox.new(plaintext_key)
+
+    # First, make a nonce: A single-use value never repeated under the same key
+    # The nonce isn't secret, and can be sent with the ciphertext.
+    # The cipher instance has a nonce_bytes method for determining how many bytes should be in a nonce
+    nonce = RbNaCl::Random.random_bytes(secret_box.nonce_bytes)
+
+    # Encrypt a message with SecretBox
+    ciphertext = secret_box.encrypt(nonce, plaintext)
+
+    result = OpenStruct.new
+
+    result.ciphertext = ciphertext
+    result.nonce = nonce
+
+    result
+  end
+
+  def decrypt_with_key(ciphertext, plaintext_key, nonce)
+    # Initialize the box
+    secret_box = RbNaCl::SecretBox.new(plaintext_key)
+
+    # Decrypt the message
+    plaintext = secret_box.decrypt(nonce, ciphertext)
+
+    result = OpenStruct.new
+
+    result.plaintext = plaintext
+
+    result
+  end
+
   def encrypt_with_key_with_benchmark(plaintext, plaintext_key)
     encryption_statistics = {}
 

data/lib/porky_lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PorkyLib
-  VERSION = "0.6.2"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: porky_lib
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Greg Fletcher
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-29 00:00:00.000000000 Z
+date: 2019-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-kms