izokatu 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 25af5e139e29b57289ca4efc801f8206f75dc31cab2389fec01f4ca0ff101e70
+  data.tar.gz: '08ff6be0312ec52aa45ff284e8690234b207e6661c16561681dca9fbebd2eafb'
+SHA512:
+  metadata.gz: b082f9d58d12e380ad5d8af4672dc442f52e8d27129420841391c615340b7d6f822859214789901af8fa11a4be4214abeacd2398f88ae6ac179e9d33fabd793f
+  data.tar.gz: 056f597f4ec9b07bd02f32626ed5c76920738569a20798721d43962f6b4a9bb18ec64ca50da30d19a7bf834101b2699b760caa5bf8d67c15c66a4331eb2b63cb

checksums.yaml.gz.sig

@@ -0,0 +1,3 @@
+r��b��?�p�騗�D8/*G�_e����?
+
+���8x�RF�������zp��0�

data.tar.gz.sig

@@ -0,0 +1,2 @@
+���wI�����ܸ������ӱvr�h��]�q��y7d=G D|Qxcw:͸�%�UK�
+���r>�!�ؿ�)��Cg��¦��]����G��qj����P���Wng���澤B��=KP���+@:�cG�2��d�n�p�]r��'��p%��.��}���;�˝C(���<��**�V4���	�)�g�oq<��R���L�`�Q�uI���	>C��Ø�X�Nl�|	��Q��8)*2�U!*ք\���H>
P�}����'_��\^tK踡�c�2�-�K�VK@'ý_��$8F�I\�?t���a��-Z�G�m�n��� Q��u�ë���x��{P]��>��"�S���'|5Y��]3�d�^ё����$~:�^

data/.gitignore

@@ -0,0 +1,19 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# rvm
+.ruby-version
+
+class_schema
+tasks
+
+izokatu-*

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,42 @@
+# The behavior of RuboCop can be controlled via the .rubocop.yml
+# configuration file. It makes it possible to enable/disable
+# certain cops (checks) and to alter their behavior if they accept
+# any parameters. The file can be placed either in your home
+# directory or in some project directory.
+#
+# RuboCop will start looking for the configuration file in the directory
+# where the inspected file is and continue its way up to the root directory.
+#
+# See https://docs.rubocop.org/rubocop/configuration
+require:
+  - rubocop-rspec
+  - rubocop-performance
+
+AllCops:
+  Exclude:
+    - '.git/**/*'
+    - 'spec/spec_helper.rb'
+  NewCops: enable
+
+# A little extending of default value 3 -> 5
+RSpec/NestedGroups:
+  Max: 5
+
+# A little extending of default value 5 -> 7
+RSpec/MultipleMemoizedHelpers:
+  Max: 7
+
+# A little extending of default value 120 -> 160
+Layout/LineLength:
+  Max: 160
+
+# A little extending of default value 5 -> 6
+Metrics/ParameterLists:
+  Max: 6
+
+Layout/ClassStructure:
+  Enabled: true
+
+Metrics/BlockLength:
+  Enabled: false
+

data/.yardopts

@@ -0,0 +1 @@
+--private --protected - README.md

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in izokatu.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,86 @@
+PATH
+  remote: .
+  specs:
+    izokatu (0.1.0)
+      ecies (~> 0.3.0)
+      openssl (~> 2.2)
+      rake (~> 13.0, >= 13.0.1)
+      rbnacl (~> 7.1, >= 7.1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.1)
+    bundler-audit (0.7.0.1)
+      bundler (>= 1.2.0, < 3)
+      thor (>= 0.18, < 2)
+    contracts (0.14.0)
+    diff-lcs (1.4.4)
+    docile (1.3.2)
+    ecies (0.3.0)
+    ffi (1.13.1)
+    openssl (2.2.0)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    rbnacl (7.1.1)
+      ffi
+    regexp_parser (1.8.2)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (0.89.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.3.0, < 1.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.8.0)
+      parser (>= 2.7.1.5)
+    rubocop-performance (1.8.1)
+      rubocop (>= 0.87.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rspec (1.44.1)
+      rubocop (~> 0.87)
+      rubocop-ast (>= 0.7.1)
+    ruby-progressbar (1.10.1)
+    simplecov (0.19.1)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.3)
+    thor (1.0.1)
+    unicode-display_width (1.7.0)
+    yard (0.9.25)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler-audit (~> 0.7.0.1)
+  contracts (~> 0.14.0)
+  izokatu!
+  rspec (~> 3.9)
+  rubocop (~> 0.89.1)
+  rubocop-performance (~> 1.7, >= 1.7.1)
+  rubocop-rspec (~> 1.43, >= 1.43.1)
+  simplecov (~> 0.19.1)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Yevhenii Maiorov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,152 @@
+# Izokatu
+
+Izokatu is Ruby library that provides abstact interface for private-key and public-key cryptography using RbNaCl and OpenSSL.
+
+## Features
+ - Unified interaction with RbNaCL and OpenSSL via `Izokatu#call`
+ - Strong defaults:
+   - RbNaCl private-key cryptography - `XChaCha20Poly1305IETF`
+   - RbNaCl public-key cryptography - `Curve25519XSalsa20Poly1305`
+   - OpenSSL private-key cryptography - `AES-256-GCM`
+   - OpenSSL public-key RSA cryptography - `4096 bit key`
+   - OpenSSL hybrid EC (ECIES) cryptography:
+     - Public-key part - `secp521r1`
+     - Private-key part - `AES-256-CTR`
+ - 2 Import modes: `:function`(default, gets data from options), `:file`
+ - 3 Export modes: `:function`(default, just returns result), `:file`, `:stdout`
+
+## Installation
+
+`gem install izokatu`
+
+If you have trouble installing the gem
+- try adding izokatu to your Gemfile and bundling.
+- file a ticket on the issues page.
+
+Izokatu is [cryptographically signed](http://guides.rubygems.org/security/).
+To be sure the gem you install hasn't been tampered with:
+- Add my public key (if you haven't already) as a trusted certificate `gem cert --add <(curl -Ls https://gitlab.com/mongalless/izokatu/-/raw/master/certs/izokatu_public_cert.pem)`
+- `gem install izokatu -P MediumSecurity`
+
+The MediumSecurity trust profile will verify signed gems, but allow the installation of unsigned dependencies.
+
+This is necessary because not all of Izokatu’s dependencies are signed, so we cannot use HighSecurity.
+
+## Usage
+
+RbNaCl private key cryptography
+```ruby
+encrypted_data = Izokatu.call(clear_data_string: 'Some data')
+Izokatu.call(action: :decryption, **encrypted_data)
+=> {:decrypted_data_string=>"Some data"}
+```
+
+RbNaCl public key cryptography
+```ruby
+keypair1 = Izokatu.call(action: :keys_generation, mode: :public_key)
+keypair2 = Izokatu.call(action: :keys_generation, mode: :public_key)
+encrypted_data = Izokatu.call(
+  clear_data_string: 'Some data',
+  mode: :public_key,
+  public_key: keypair1[:public_key],
+  private_key: keypair2[:private_key]
+)
+Izokatu.call(
+  action: :decryption,
+  mode: :public_key,
+  **encrypted_data,
+  public_key: keypair2[:public_key],
+  private_key: keypair1[:private_key]
+)
+=> {:decrypted_data_string=>"Some data"}
+  ```
+
+OpenSSL private key cryptography
+```ruby
+encrypted_data = Izokatu.call(
+  clear_data_string: 'Some data',
+  via: :openssl,
+  cipher: 'AES-256-GCM'
+)
+Izokatu.call(
+  action: :decryption,
+  **encrypted_data,
+  via: :openssl,
+  cipher: 'AES-256-GCM'
+)
+=> {:decrypted_data_string=>"Some data"}
+```
+
+OpenSSL EC public key cryptography
+```ruby
+keypair_options = {
+  action: :keys_generation,
+  mode: :public_key,
+  via: :openssl
+}
+keypair1 = Izokatu.call(keypair_options)
+keypair2 = Izokatu.call(keypair_options)
+encrypted_data = Izokatu.call(
+  clear_data_string: 'Some data',
+  mode: :public_key,
+  via: :openssl,
+  public_key:
+  keypair1[:public_key],
+  private_key: keypair2[:private_key]
+)
+Izokatu.call(
+  action: :decryption,
+  mode: :public_key,
+  via: :openssl,
+  **encrypted_data,
+  public_key: keypair2[:public_key],
+  private_key: keypair1[:private_key]
+)
+=> {:decrypted_data_string=>"Some data"}
+```
+
+OpenSSL RSA public key cryptography
+```ruby
+keypair_options = {
+  action: :keys_generation,
+  mode: :public_key,
+  via: :openssl,
+  asym_cipher_type: :rsa,
+  bit_number: 4096
+}
+keypair1 = Izokatu.call(keypair_options)
+keypair2 = Izokatu.call(keypair_options)
+encrypted_data = Izokatu.call(
+  clear_data_string: 'Some data',
+  mode: :public_key,
+  via: :openssl,
+  public_key: keypair1[:public_key],
+  private_key: keypair2[:private_key],
+  asym_cipher_type: :rsa
+)
+Izokatu.call(
+  action: :decryption,
+  mode: :public_key,
+  via: :openssl,
+  **encrypted_data,
+  public_key: keypair2[:public_key],
+  private_key: keypair1[:private_key],
+  asym_cipher_type: :rsa
+)
+=> {:decrypted_data_string=>"Some data"}
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://gitlab.com/mongalless/izokatu.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'izokatu'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/certs/mongalless.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIEWjCCAsKgAwIBAgIBATANBgkqhkiG9w0BAQsFADArMSkwJwYDVQQDDCBoaXRz
+dGFsa2VyNy9EQz1wcm90b25tYWlsL0RDPWNvbTAeFw0yMDExMjkxMjE5MzJaFw0y
+MTExMjkxMjE5MzJaMCsxKTAnBgNVBAMMIGhpdHN0YWxrZXI3L0RDPXByb3Rvbm1h
+aWwvREM9Y29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAuDgvPY+H
+5a3R819tNshtIMrOxLjVZSXNrMz3e6ocBzWNnwbikPf+ykZI71/Z2AMANRl3h2dm
+jxlOtw0LwgUVg/9kXFJdSkKW1ahUYk4TDifTLsc+m9zhEO4HaqXNAQWdlB7xFKpO
+REw0qvFOayXPDxFOdJhYgSJ3GyhmV2sbyCyqL8+eDzE2Y9p/XpAKv4MgLKzF8dEM
+4RQlKZgZNmcaTYKrfvXBLRNv3G3/mUlu8xuiKMEjX74z1+5go0haKSz51UxekckR
+VD1iKU7bjQXkOoucPwre5wTqXWppH80tPO4N4J0XKUSWX0QJt2obGZlBXhgF0BsR
+Wd9HxYqdkeVm9aFf58g2XOtpIOpV13IJ253mrftxhpgRVP0dOHXy/C+W/F+At75O
+7OfUUjU/1DoMNL3kbtNThtuwE/gp87/+PttPlIVUA+ejaELQlb1bvUtRaOW/4ZJj
+XdHeCpJKvhRPOLffmW4e/oEWq7L+PxaBypKRdV4S0ij4AKVCrJ2epN7zAgMBAAGj
+gYgwgYUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEsBiliinio0
+zcL8dE5paoSgYHRwMCUGA1UdEQQeMByBGmhpdHN0YWxrZXI3QHByb3Rvbm1haWwu
+Y29tMCUGA1UdEgQeMByBGmhpdHN0YWxrZXI3QHByb3Rvbm1haWwuY29tMA0GCSqG
+SIb3DQEBCwUAA4IBgQCAnqQbkqY6AwlMUesfX9++CsqmU+Q1lKwvZSjeSjfCFU4p
+TpNay96jd/7hRD+kydh0ghmLauSJwYml5lN4d1USaMbejPCYGUZHL5zOFuL8MRRY
+aaozl5mdyHwPzNdzn5tDgT7553MTFDt7n4luSis+V1d4ycKL5gbpYslmDjtJzOi6
+Y1v0NUc7m2A2MOJgzVuRsDjnWJaRF7xzawbGJBchU48jQ4hu6a5kq9gjOg8ybPiq
+OX4qrBOJfNT0EG/2+TuRFU+8IsXvLNmrBVeaUa3CFEA4hrWQLQU2/SNxdvpuXal5
+Kc0vOe/EBftWGcQtPCEyE14uImM5gc5JOKJu1nHJkpfoUPbZmDzzObQHQ22GDuwR
+kgsSHaCAYaBtkQ9Lkk1ccZwb1WwpucXBRd2NZrO7c7DJQLAuI3CWS/Iljhow0quq
+rhxIlERIpUf5MM1tTlt/k9LnjYlvAqiDHgIXWKcxJaZ0/fLq9lYgi/FTZhL07L2j
+5MF2YkFP1yWl6vQ9biw=
+-----END CERTIFICATE-----

data/izokatu.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'lib/izokatu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'izokatu'
+  spec.version       = Izokatu::VERSION
+  spec.authors       = ['mongalless']
+
+  spec.summary       = 'Ruby library that provides abstact interface for private-key and public-key cryptography using RbNaCl and OpenSSL'
+  spec.homepage      = 'https://gitlab.com/mongalless/izokatu'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.7.1')
+
+  spec.metadata = {
+    "documentation_uri" => "https://www.rubydoc.info/gems/izokatu",
+    "homepage_uri"      => spec.homepage,
+    "source_code_uri"   => spec.homepage,
+  }
+
+  spec.cert_chain  = ['certs/mongalless.pem']
+  spec.signing_key = File.expand_path("~/.ssh/mongalless_private_key.pem") if $0 =~ /gem\z/
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.extra_rdoc_files = ['README.md']
+
+  spec.add_dependency 'ecies', '~> 0.3.0'
+  spec.add_dependency 'openssl', '~> 2.2'
+  spec.add_dependency 'rake', '~> 13.0', '>= 13.0.1'
+  spec.add_dependency 'rbnacl', '~> 7.1', '>= 7.1.1'
+  spec.add_dependency 'contracts', '~> 0.14.0'
+  spec.add_development_dependency 'bundler-audit', '~> 0.7.0.1'
+  spec.add_development_dependency 'rspec', '~> 3.9'
+  spec.add_development_dependency 'rubocop', '~> 0.89.1'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.7', '>= 1.7.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.43', '>= 1.43.1'
+  spec.add_development_dependency 'simplecov', '~> 0.19.1'
+  spec.add_development_dependency 'yard', '~> 0.9'
+end