trusona 0.16.0

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,21 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'dotenv'
+Dotenv.load
+require 'bundler/setup'
+require 'trusona'
+
+# 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.
+
+Trusona.config do |c|
+  c.beacons_host = ENV['BEACONS_HOST']
+  c.api_host = ENV['TRUSONA_API_HOST']
+  c.secret = ENV['TRUSONA_SECRET']
+  c.token  = ENV['TRUSONA_TOKEN']
+end
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require 'pry'
+Pry.start

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/trusona.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIETTCCArWgAwIBAgIBATANBgkqhkiG9w0BAQsFADAoMSYwJAYDVQQDDB1lbmdp
+bmVlcmluZy9EQz10cnVzb25hL0RDPWNvbTAeFw0xODA3MDUxNjQyNTVaFw0xOTA3
+MDUxNjQyNTVaMCgxJjAkBgNVBAMMHWVuZ2luZWVyaW5nL0RDPXRydXNvbmEvREM9
+Y29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAtZt82g/ZeiJshGdi
+twfXgueVDyMEsV+h7mRwDqOhwwwJ9/EBwu2Ma56LQHKMqDsVaSljTUo4WNSm9M7r
+H6c/IW6O07X/2YA29jwUveauKjkBmmEpECr7hTe0UHoOm9jV5DHeoBsgpMSFqC3C
+myBP8ik/A+xEQPo8F43TMX2YP3EFQw8ievUdCvwgjapFoyFoBlmrbfHMyYH1XTfF
+hth9YAZoYYSaVHKYleEWz73ZPZyYqXUm2G56eAOAu6+Ghi3G9F2FtxwGVpjAnKc6
+r37RRWG5b6Sfuj9ojds9sn8EExUTroti5Jb6RpJI54+IKuarfEe7ygn6PBsianbF
+b9FJ/PQgUNOrCkEum8iBrJW2eBgNKsC39kX7luUeot6aBpO16E8exrNwia7aWVn1
+lOW2DpjLWpyQDC3iCmV5JZD3Ffg1uGaMg1ln1BAtLH9StDqi8EPL3lmXQM2uvi9f
+KXCrw0eSiDGD1PUdKJ0RE/hByKLtGn7UygIKsV8v7R/L+PwNAgMBAAGjgYEwfzAJ
+BgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU82ZI29Yn4SX0EuOrfvkc
+Fs2cy2wwIgYDVR0RBBswGYEXZW5naW5lZXJpbmdAdHJ1c29uYS5jb20wIgYDVR0S
+BBswGYEXZW5naW5lZXJpbmdAdHJ1c29uYS5jb20wDQYJKoZIhvcNAQELBQADggGB
+AC3rcLcSs4JCMfVNJxx2ugAqxagKV9Hbpl9hLMDCv2M4rc4kWKwuSyihhaetq+2U
+hzWaqX0yUzBC1KCOxuZOxpC0KscsYGeLiGRILZetUl6Kj/4H/Xjaj1gkW4mtCfeh
+5QC/1FM/C3AExN5oWNQUTBQ2XFain5RxR/SJVidJt+6DOePhqY2zAp7lweIIcjit
+bJNU+hSx7iO750Wnn969yQDRNKnNIULAmpvgGpErv8kx5FELDypEZtRWK4wmPkyz
+vDcXXHq4276Zr5idZbx/uxeRuS05rL+o/LmN1KNvxxJCoqAv+meGhMQ645WKs5La
+oeFOElmMyJfOJcYAp5KP5Rvn/llhVYYaGtOsoY7+6U0fN0DzucZmtfwtp4r9foVY
+5dMuMQ9V7c0EWtZm8J+tcQh9dPPC4Va/FnYWw+x6CDmVU/nijUAI1UOxSSuekJXb
+vbhUT8kOS+bZTalorEol37DD/P4Bbv0fMpw+ozetR2RmwhwTKPKJ5r0oQP6tiqHn
+hQ==
+-----END CERTIFICATE-----

data/checksum/trusona-0.16.0.gem.sha512

@@ -0,0 +1 @@
+236cc89e2bd9c15c00c2f1b3d31d6b82fda85e46bcd3ea615ca3461020b3f56a889fdfbd0bdd2b2e3cc2e48aa92e0bebfdd8f373d59a0a72126efe0c2d8bbc08

data/integrations/device_user_binding_integration_spec.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal:true
+
+require 'spec_helper'
+
+RSpec.describe 'DeviceUserBindings' do
+end

data/integrations/identity_documents_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Identity Documents' do
+  before do
+    Trusona.config do |c|
+      c.tru_codes_host = ENV['TRUCODES_HOST']
+      c.api_host       = ENV['TRUSONA_API_HOST']
+      c.secret         = ENV['TRUSONA_SECRET']
+      c.token          = ENV['TRUSONA_TOKEN']
+    end
+  end
+
+  describe 'finding all documents for a user identifier' do
+    it 'should work' do
+      result = Trusona::IdentityDocument.all(user_identifier: SecureRandom.uuid)
+      expect(result).to eq([])
+    end
+  end
+
+  describe 'finding a single identity document' do
+    it 'should work' do
+      result = Trusona::IdentityDocument.find(id: SecureRandom.uuid)
+      expect(result).to eq(nil)
+    end
+  end
+end

data/integrations/spec_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'dotenv/load'
+require 'simplecov'
+SimpleCov.start do
+  add_filter '/spec/'
+end
+
+require 'bundler/setup'
+require 'trusona'
+require 'securerandom'
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = '.rspec_status'
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/integrations/tru_code_spec.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal:true
+
+require 'spec_helper'
+require 'tempfile'
+
+# rubocop:disable Metrics/BlockLength
+RSpec.describe 'TruCodes' do
+  before do
+    Trusona.config do |c|
+      c.tru_codes_host = ENV['TRUCODES_HOST']
+      c.api_host       = ENV['TRUSONA_API_HOST']
+      c.secret         = ENV['TRUSONA_SECRET']
+      c.token          = ENV['TRUSONA_TOKEN']
+    end
+  end
+
+  describe 'creating a TruCode to show on your website' do
+    before do
+      @reference_id = SecureRandom.uuid
+    end
+    it 'just works' do
+      code = Trusona::Resources::TruCode.new(
+        reference_id: @reference_id,
+        action: 'verify',
+        resource: 'integration-test',
+        level: 1
+      )
+
+      result = Trusona::TruCode.create(code)
+
+      expect(result.tru_code).to be
+      expect(result.signature).to be
+      expect(result.relying_party_id).to be
+      expect(result.tru_code).to be
+      expect(result.tru_code.id).to be
+      expect(result.tru_code.payload).to be
+      expect(result.tru_code.image).to be
+      expect(result.tru_code.id).to be
+      expect(result.tru_code.reference_id).to eq(@reference_id)
+    end
+
+    describe 'and when you want to check the status of that TruCode' do
+      before do
+        @qr = Tempfile.new('tru_code')
+        code = Trusona::Resources::TruCode.new(
+          reference_id: @reference_id,
+          action: 'verify',
+          resource: 'integration-test',
+          level: 1
+        )
+
+        @created = Trusona::TruCode.create(code)
+      end
+
+      after do
+        @qr.close
+        @qr.unlink
+      end
+
+      it 'can be checked by using the tru code resource' do
+        expect { Trusona::TruCode.status(@created) }.to(
+          raise_error(Trusona::ResourceNotFoundError)
+        )
+      end
+
+      it 'can be checked by using the tru_code resource' do
+        expect { Trusona::TruCode.status(@created.tru_code) }.to(
+          raise_error(Trusona::ResourceNotFoundError)
+        )
+      end
+
+      it 'can be checked by using the tru_code id' do
+        expect { Trusona::TruCode.status(tru_code_id: @created.tru_code.id) }.to(
+          raise_error(Trusona::ResourceNotFoundError)
+        )
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/BlockLength

data/integrations/trusonafication_spec.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+# rubocop:disable Metrics/BlockLength
+RSpec.describe 'Trusonafications' do
+  before do
+    Trusona.config do |c|
+      c.tru_codes_host = ENV['TRUCODES_HOST']
+      c.api_host       = ENV['TRUSONA_API_HOST']
+      c.secret         = ENV['TRUSONA_SECRET']
+      c.token          = ENV['TRUSONA_TOKEN']
+    end
+
+    @parameters = {
+      resource: 'integration test suite',
+      action: 'verify',
+      user_identifier: 'claytonhauz@gmail.com'
+    }
+
+    @timeout = 5
+  end
+  describe 'creating a trusonafication for a known trusona user' do
+    before do
+      @trusonafication = Trusona::EssentialTrusonafication.create(
+        params: @parameters, timeout: @timeout
+      )
+    end
+
+    it 'just works' do
+      expect(@trusonafication.status).to eq(:in_progress)
+      expect(@trusonafication.user_identifier).to eq('claytonhauz@gmail.com')
+      expect(@trusonafication.resource).to eq('integration test suite')
+      expect(@trusonafication.action).to eq('verify')
+      expect(@trusonafication.level).to eq(2)
+      expect(@trusonafication.expires_at).to be
+    end
+
+    context 'and when you try to find that same trusonafication' do
+      it 'that just works too' do
+        @found = Trusona::Trusonafication.find(@trusonafication.id)
+        expect(@found.trusona_id).to eq(@trusonafication.trusona_id)
+        expect(@found.status).to eq(@trusonafication.status)
+        expect(@found.resource).to eq(@trusonafication.resource)
+        expect(@found.action).to eq(@trusonafication.action)
+        expect(@found.level).to eq(@trusonafication.level)
+      end
+    end
+  end
+  describe 'creating a trusonafication for an unknown trusona user' do
+    it 'as expected, does not work' do
+      @parameters[:user_identifier] = "#{Time.now.to_i}@example.com"
+      trusonafication = Trusona::Trusonafication.create(
+        params: @parameters, timeout: @timeout
+      )
+
+      expect(trusonafication.trusona_id).to_not be
+    end
+  end
+end
+# rubocop:enable Metrics/BlockLength

data/integrations/user_accounts_spec.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+# rubocop:disable Metrics/BlockLength
+RSpec.describe 'Trusona User Accounts' do
+  before do
+    Trusona.config do |c|
+      c.tru_codes_host = ENV['TRUCODES_HOST']
+      c.api_host       = ENV['TRUSONA_API_HOST']
+      c.secret         = ENV['TRUSONA_SECRET']
+      c.token          = ENV['TRUSONA_TOKEN']
+    end
+
+    @account_lookup = { trusona_id: '167791378' }
+    @email_lookup   = { email: 'claytonhauz@gmail.com' }
+  end
+
+  describe 'retrieving a user account with their Trusona ID' do
+    context 'when the user account exists and can be found' do
+    end
+
+    context 'when no user account exists for the given Trusona ID' do
+      it 'then we should see a Trusona::ResourceNotFound error raised' do
+        expect { Trusona::UserAccounts.find_by(@account_lookup) }.to(
+          raise_error(Trusona::ResourceNotFoundError)
+        )
+      end
+    end
+  end
+
+  describe 'searching for a user account using their email' do
+    context 'when a user account exists with the given email' do
+    end
+
+    context 'when no user accounts exist with the given email' do
+    end
+  end
+end

data/integrations/user_identifiers_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Trusona User Identifiers' do
+  before do
+    Trusona.config do |c|
+      c.api_host      = ENV['TRUSONA_API_HOST']
+      c.secret        = ENV['TRUSONA_SECRET']
+      c.token         = ENV['TRUSONA_TOKEN']
+    end
+
+    @identifier = Trusona::Resources::UserIdentifier.new(identifier: 'am9uZXNAdGFjb3MubmV0Cg==', trusona_id: '264683802')
+  end
+
+  describe 'retreiving a user identifier' do
+    context 'when no identifier exists' do
+      it 'then we should see a Trusona::ResourceNotFound error raised' do
+        expect { Trusona::UserIdentifier.find_by(identifier: 'asdf') }.to(
+          raise_error(Trusona::ResourceNotFoundError)
+        )
+      end
+    end
+
+    context 'when a valid identifier exists' do
+      it 'should be successful' do
+        res = Trusona::UserIdentifier.find_by(identifier: @identifier.identifier)
+        expect(res.trusona_id).to eq @identifier.trusona_id
+      end
+    end
+  end
+end

data/lib/trusona.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require 'httparty'
+
+require 'trusona/helpers/key_normalizer'
+require 'trusona/helpers/time_normalizer'
+
+require 'trusona/version'
+require 'trusona/errors'
+require 'trusona/trusonafication'
+require 'trusona/tru_code'
+require 'trusona/tru_code_config'
+require 'trusona/user_account'
+require 'trusona/user_identifier'
+require 'trusona/device_user_binding'
+require 'trusona/identity_document'
+require 'trusona/device'
+
+require 'trusona/api/signed_request'
+require 'trusona/api/verified_response'
+require 'trusona/api/hashed_message'
+require 'trusona/api/client'
+
+require 'trusona/workers/tru_code_creator'
+require 'trusona/workers/tru_code_finder'
+require 'trusona/workers/user_account_finder'
+require 'trusona/workers/user_identifier_finder'
+require 'trusona/workers/user_identifier_creator'
+require 'trusona/workers/device_user_binding_creator'
+require 'trusona/workers/device_user_binding_activator'
+require 'trusona/workers/trusonafication_creator'
+require 'trusona/workers/trusonafication_finder'
+require 'trusona/workers/identity_document_finder'
+require 'trusona/workers/device_finder'
+
+require 'trusona/services/base_service'
+require 'trusona/services/user_accounts_service'
+require 'trusona/services/account_lookups_service'
+require 'trusona/services/tru_codes_service'
+require 'trusona/services/trusonafication_service'
+require 'trusona/services/tru_codes_service'
+require 'trusona/services/user_identifiers_service'
+require 'trusona/services/device_user_bindings_service'
+require 'trusona/services/identity_documents_service'
+require 'trusona/services/devices_service'
+
+require 'trusona/mappers/base_mapper'
+require 'trusona/mappers/tru_code_mapper'
+require 'trusona/mappers/nil_mapper'
+require 'trusona/mappers/trusonafication_mapper'
+require 'trusona/mappers/tru_code_mapper'
+require 'trusona/mappers/user_account_mapper'
+require 'trusona/mappers/user_identifier_mapper'
+require 'trusona/mappers/device_user_binding_mapper'
+require 'trusona/mappers/identity_document_mapper'
+require 'trusona/mappers/device_mapper'
+
+require 'trusona/resources/validators'
+require 'trusona/resources/base_resource'
+require 'trusona/resources/trusonafication'
+require 'trusona/resources/tru_code'
+require 'trusona/resources/user_account'
+require 'trusona/resources/user_identifier'
+require 'trusona/resources/device_user_binding'
+require 'trusona/resources/device_user_binding_activation'
+require 'trusona/resources/identity_document'
+require 'trusona/resources/device'
+
+# Trusona
+module Trusona
+  #
+  ## Organizing HTTP and HMAC related items
+  module Api; end
+  #
+  ## Organizes Resources
+  module Resources; end
+
+  #
+  ## Organizes Services and related behavior
+  module Services; end
+
+  #
+  ## Organizes Mappers
+  module Mappers; end
+
+  #
+  ## Organizes Workers
+  module Workers; end
+
+  #
+  ## Organizes Helpers
+  module Helpers; end
+
+  ##
+  # Configures the Trusona SDK with the required parameters by creating and
+  # using an instance of +Trusona::Configuration+.
+  #
+  #   Trusona.config do |c|
+  #     c.tru_codes_host = ENV['TRUCODES_HOST']
+  #     c.api_host       = ENV['TRUSONA_API_HOST']
+  #     c.secret         = ENV['TRUSONA_SECRET']
+  #     c.token          = ENV['TRUSONA_TOKEN']
+  #   end
+  #
+  def self.config
+    yield(@config ||= Configuration.new) if block_given?
+
+    @config ||= Configuration.new
+  end
+
+  ##
+  # Represents Trusona configuration
+  #
+  # @attr token [String] The JWT token supplied by Trusona for interacting
+  #                      with the Trusona API
+  #
+  # @attr secret [String] The secret supplied by Trusona for interacting with
+  #                       the Trusona API
+  #
+  # @attr_reader api_host [String] The full URL of the Trusona API
+  #                                (e.g. +https://api.trusona.net+)
+  #
+  # @attr_reader tru_codes_host [String] The full URL of the host responsible
+  #                                    for managing TruCode tru_codes
+  #                                    (e.g. +https://tru_codes.trusona.net+)
+  class Configuration
+    attr_accessor :token, :secret
+    attr_reader :api_host, :tru_codes_host
+
+    ##
+    # sets the API host by first ensuring the proper format
+    # @param host [String] The full URL of the Trusona API
+    def api_host=(host)
+      @api_host = parse_host(host)
+    end
+
+    ##
+    # sets the TruCodes host by first ensuring the proper format
+    # @param host [String] The full URL of the TruCodes API
+    def tru_codes_host=(host)
+      @tru_codes_host = parse_host(host)
+    end
+
+    private
+
+    def parse_host(maybe_host)
+      parsed = URI('')
+      begin
+        parsed = URI(maybe_host).host
+      rescue StandardError
+        parsed = URI('')
+      end
+
+      parsed
+    end
+  end
+end