izokatu 0.1.1

data/lib/izokatu/openssl/public_key/rsa/encrypter.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Openssl
+    module PublicKey
+      module RSA
+        # OpenSSL public key RSA encrypter
+        class Encrypter < Izokatu::Encrypter
+          # @return [String] public key string for decryption
+          attr_reader :public_key
+
+          Contract Contracts::HashOf[Symbol, String] => Any
+          # Initialize options for OpenSSL RSA encryption
+          #
+          # @param clear_data (#clear_data)
+          # @param public_key (#public_key)
+          #
+          # @since 0.1.0
+          def initialize(clear_data:, public_key:)
+            super(clear_data: clear_data)
+            initialize_public_key!(public_key)
+          end
+
+          Contract String => OpenSSL::PKey::RSA
+          # Initialize RSA public key from public key string
+          #
+          # @param public_key (#public_key)
+          #
+          # @return [OpenSSL:PKey::RSA] OpenSSL public key instance
+          #
+          # @since 0.1.0
+          def initialize_public_key!(public_key)
+            raise 'ERROR: No public key!' unless public_key
+
+            @public_key = OpenSSL::PKey::RSA.new(public_key)
+          end
+
+          private
+
+          Contract None => Contracts::ArrayOf[Contracts::HashOf[Symbol, String]]
+          # Encrypting data
+          #
+          # @return [Array] encrypted data with empty hash in place of params
+          #
+          # @since 0.1.0
+          def encrypt_data!
+            raise 'ERROR: No public key!' unless public_key
+
+            [{ encrypted_data_string: public_key.public_encrypt(clear_data) }, {}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/openssl/public_key/rsa/keys_generator.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Openssl
+    module PublicKey
+      # Namespace for OpenSSL public key RSA classes
+      module RSA
+        # OpenSSL RSA keys generator
+        class KeysGenerator < Izokatu::KeysGenerator
+          # @return [Integer] bit number for OpenSSL RSA encryption/decryption
+          attr_reader :bit_number
+
+          # Default options for OpenSSL RSA keys generation
+          DEFAULT_OPTIONS = {
+            bit_number: 4096
+          }.freeze
+
+          Contract Contracts::HashOf[Symbol, Pos] => Any
+          # Initialize option for OpenSSL RSA keys generation
+          #
+          # @param bit_number (#bit_number)
+          #
+          # @since 0.1.0
+          def initialize(bit_number:)
+            super()
+            @bit_number = bit_number || DEFAULT_OPTIONS[:bit_number]
+          end
+
+          Contract None => Contracts::HashOf[Or[*KEYS_SYMBOLS], String]
+          # Performing generation of OpenSSL RSA private and public keys
+          #
+          # @return [Hash] OpenSSL RSA public and private keys
+          #
+          # @since 0.1.0
+          def perform
+            super.transform_values(&:to_pem)
+          end
+
+          private
+
+          Contract None => OpenSSL::PKey::RSA
+          # Performing generation of OpenSSL RSA private key
+          #
+          # @return [OpenSSL::PKey::RSA] OpenSSL private key
+          #
+          # @since 0.1.0
+          def generate_private_key
+            OpenSSL::PKey::RSA.new(bit_number)
+          end
+
+          Contract OpenSSL::PKey::RSA => OpenSSL::PKey::RSA
+          # Performing generation of OpenSSL RSA private key
+          #
+          # @return [OpenSSL::PKey::RSA] OpenSSL private key
+          #
+          # @since 0.1.0
+          def generate_public_key(private_key)
+            private_key.public_key
+          end
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/decrypter.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Izokatu
+  # Namespace for RbNaCl classes
+  module Rbnacl
+    # Abstract class for Rbnacl decrypters
+    #
+    # @abstract Subclasses are containing implementation of {#create_decrypter!}
+    class Decrypter < Izokatu::Decrypter
+      # @return [String] initialization vector for one-time use
+      attr_reader :nonce
+
+      # Classes of RbNaCl keys
+      RBNACL_KEY_CLASSES = [
+        RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey,
+        RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey
+      ].freeze
+
+      Contract Contracts::HashOf[Symbol, String] => Any
+      # Initializing option for decryption
+      #
+      # @param encrypted_data (#encrypted_data)
+      # @param nonce (#nonce)
+      #
+      # @since 0.1.0
+      def initialize(encrypted_data:, nonce:)
+        super(encrypted_data: encrypted_data)
+        @nonce = nonce
+        create_decrypter!
+      end
+
+      # Creating decrypter instance
+      #
+      # @raise RuntimeError
+      #
+      # @since 0.1.0
+      def create_decrypter!
+        raise 'Not implemented!'
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/encrypter.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Izokatu
+  # Namespace for RbNaCl classes
+  module Rbnacl
+    # Abstract class for Rbnacl encrypters
+    #
+    # @abstract Subclasses are containing implementation of {#create_encrypter!}
+    class Encrypter < Izokatu::Encrypter
+      # @return [String] initialization vector for one-time use
+      attr_reader :nonce
+
+      Contract Contracts::HashOf[Symbol, String] => Any
+      # Initializing option for encryption
+      #
+      # @param clear_data (#clear_data)
+      #
+      # @since 0.1.0
+      def initialize(clear_data:)
+        super
+        create_encrypter!
+        generate_nonce!
+      end
+
+      # Creating encrypter instance
+      #
+      # @raise RuntimeError
+      #
+      # @since 0.1.0
+      def create_encrypter!
+        raise 'Not implemented!'
+      end
+
+      Contract None => String
+      # Generating nonce from encrypter instance
+      #
+      # @return [String] initialization vector for one-time use
+      #
+      # @since 0.1.0
+      def generate_nonce!
+        @nonce = RbNaCl::Random.random_bytes(encrypter.nonce_bytes)
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/private_key/decrypter.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Rbnacl
+    # Namespace for RbNaCl private key classes
+    module PrivateKey
+      # RbNaCl private key decrypter
+      class Decrypter < Izokatu::Rbnacl::Decrypter
+        # @return [String] key for private key encryption/decryption
+        attr_reader :key
+        # @return [String] authenticated data
+        attr_reader :auth_data
+
+        # Default options for Izokatu::Rbnacl::Decrypter
+        DEFAULT_OPTIONS = {
+          auth_data: ''
+        }.freeze
+
+        Contract Contracts::HashOf[Symbol, Or[Or[*RBNACL_KEY_CLASSES], Maybe[String]]] => Any
+        # Initializing option for decryption
+        #
+        # @param encrypted_data (#encrypted_data)
+        # @param nonce (#nonce)
+        # @param key (#key)
+        # @param auth_data (#auth_data)
+        #
+        # @since 0.1.0
+        def initialize(key:, encrypted_data:, nonce:, auth_data:)
+          @key = key
+          super(encrypted_data: encrypted_data, nonce: nonce)
+          @auth_data = auth_data || DEFAULT_OPTIONS[:auth_data]
+        end
+
+        Contract None => RbNaCl::AEAD::XChaCha20Poly1305IETF
+        # Creating decrypter instance
+        #
+        # @return [RbNaCl::AEAD::XChaCha20Poly1305IETF] decrypter instance
+        #
+        # @since 0.1.0
+        def create_decrypter!
+          @decrypter = RbNaCl::AEAD::XChaCha20Poly1305IETF.new(key)
+        end
+
+        Contract None => Contracts::HashOf[Symbol, String]
+        # Decrypting data
+        #
+        # @return [Hash] decrypted data
+        #
+        # @since 0.1.0
+        def decrypt_data!
+          { decrypted_data_string: decrypter.decrypt(nonce, encrypted_data, auth_data) }
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/private_key/encrypter.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Rbnacl
+    module PrivateKey
+      # RbNaCl private key encrypter
+      class Encrypter < Izokatu::Rbnacl::Encrypter
+        # @return [String] key for private key encryption/decryption
+        attr_reader :key
+        # @return [String] authenticated data
+        attr_reader :auth_data
+
+        Contract Contracts::HashOf[Symbol, Maybe[String]] => Any
+        # Initializing option for encryption
+        #
+        # @param clear_data (#clear_data)
+        # @param auth_data (#auth_data)
+        #
+        # @since 0.1.0
+        def initialize(clear_data:, auth_data:)
+          generate_key!
+          super(clear_data: clear_data)
+          @auth_data = auth_data
+        end
+
+        Contract None => String
+        # Generating key
+        #
+        # @since 0.1.0
+        def generate_key!
+          @key = RbNaCl::Random.random_bytes(RbNaCl::SecretBox.key_bytes)
+        end
+
+        Contract None => RbNaCl::AEAD::XChaCha20Poly1305IETF
+        # Generating encrypter instance from key
+        #
+        # @since 0.1.0
+        def create_encrypter!
+          @encrypter = RbNaCl::AEAD::XChaCha20Poly1305IETF.new(key)
+        end
+
+        Contract None => Contracts::ArrayOf[Contracts::HashOf[Symbol, Maybe[String]]]
+        # Encrypting data
+        #
+        # @return (Array) encrypted data with decrypter params
+        #
+        # @since 0.1.0
+        def encrypt_data!
+          [
+            { encrypted_data_string: encrypter.encrypt(nonce, clear_data, auth_data) },
+            {
+              auth_data: auth_data,
+              key: key,
+              nonce: nonce
+            }
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/public_key/decrypter.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Rbnacl
+    # Namespace for RbNaCl public key classes
+    module PublicKey
+      # RbNaCl public key decrypter
+      class Decrypter < Izokatu::Rbnacl::Decrypter
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey] public key
+        attr_reader :public_key
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey] private key
+        attr_reader :private_key
+
+        Contract Contracts::HashOf[Symbol, Or[Or[*RBNACL_KEY_CLASSES], String]] => Any
+        # Initializing option for decryption
+        #
+        # @param encrypted_data (#encrypted_data)
+        # @param nonce (#nonce)
+        # @param public_key (#public_key)
+        # @param private_key (#private_key)
+        #
+        # @since 0.1.0
+        def initialize(public_key:, private_key:, encrypted_data:, nonce:)
+          @public_key = public_key
+          @private_key = private_key
+          super(encrypted_data: encrypted_data, nonce: nonce)
+        end
+
+        Contract None => RbNaCl::Boxes::Curve25519XSalsa20Poly1305
+        # Initializing decrypter instance
+        #
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305] decrypter instance
+        #
+        # @since 0.1.0
+        def create_decrypter!
+          @decrypter = RbNaCl::Box.new(public_key, private_key)
+        end
+
+        Contract None => Contracts::HashOf[Symbol, String]
+        # Decrypting data
+        #
+        # @return [Hash] decrypted data
+        #
+        # @since 0.1.0
+        def decrypt_data!
+          { decrypted_data_string: decrypter.decrypt(nonce, encrypted_data) }
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/public_key/encrypter.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Rbnacl
+    module PublicKey
+      # RbNaCl public key encrypter
+      class Encrypter < Izokatu::Rbnacl::Encrypter
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey] public key
+        attr_reader :public_key
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey] private key
+        attr_reader :private_key
+
+        # RbNaCl public and private key classes
+        RBNACL_KEY_CLASSES = [
+          RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey,
+          RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey
+        ].freeze
+
+        Contract Contracts::HashOf[Symbol, Or[String, Or[*RBNACL_KEY_CLASSES]]] => Any
+        # Initializing option for encryption
+        #
+        # @param clear_data (#clear_data)
+        # @param public_key (#public_key)
+        # @param private_key (#private_key)
+        #
+        # @since 0.1.0
+        def initialize(public_key:, private_key:, clear_data:)
+          @public_key = public_key
+          @private_key = private_key
+          super(clear_data: clear_data)
+        end
+
+        Contract None => RbNaCl::Boxes::Curve25519XSalsa20Poly1305
+        # Initializing option for encryption
+        #
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305] encrypter instance
+        #
+        # @since 0.1.0
+        def create_encrypter!
+          raise 'ERROR: No public key!' unless public_key
+          raise 'ERROR: No private key!' unless private_key
+
+          @encrypter = RbNaCl::Box.new(public_key, private_key)
+        end
+
+        Contract None => Contracts::ArrayOf[Contracts::HashOf[Symbol, String]]
+        # Encrypting data
+        #
+        # @return [Array] encrypted data with decrypter params
+        #
+        # @since 0.1.0
+        def encrypt_data!
+          [
+            { encrypted_data_string: encrypter.encrypt(nonce, clear_data) },
+            { nonce: nonce }
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/izokatu/rbnacl/public_key/keys_generator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Izokatu
+  module Rbnacl
+    module PublicKey
+      # RbNaCl keys generator
+      class KeysGenerator < Izokatu::KeysGenerator
+        private
+
+        Contract None => RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey
+        # Performing generation of RbNaCl private key
+        #
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey] RbNaCl private key
+        #
+        # @since 0.1.0
+        def generate_private_key
+          RbNaCl::PrivateKey.generate
+        end
+
+        Contract RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PrivateKey =>
+                 RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey
+        # Performing generation of RbNaCl public key
+        #
+        # @return [RbNaCl::Boxes::Curve25519XSalsa20Poly1305::PublicKey] RbNaCl public key
+        #
+        # @since 0.1.0
+        def generate_public_key(private_key)
+          private_key.public_key
+        end
+      end
+    end
+  end
+end