trusona 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d7dcf565b866754150b98eff9c086093ef77bb1
-  data.tar.gz: 32c9eb74488c07fe534f3c1fc6060bce95c19a19
+  metadata.gz: 5dc92807458496cc372e1677fb0ea1ea0b7de6ac
+  data.tar.gz: 2689baece986ce2b1c29e0b5dc5800132365942d
 SHA512:
-  metadata.gz: 511921672c8a23e8b1d67a58911bfba6329ad9a687e8319eb29a83e380774aedb8a8b4fe00025db150c0412b1fc10dda680511a39d8910966cecb86b02fb14ab
-  data.tar.gz: 3be6d6bee99c64e6b0c2dd2c7a05afca8b0309d27713e4510ad468a0cfb4c7b8faeee71efd83837109529dd9ce004de0dc57e8b20937b0c8c9296087e5d767cf
+  metadata.gz: 0cfb9ab9584badb3eef44d5365facc89a89aa1b0f57ed2159ab209991c5c0e30195da9462fe6069014e4b7833ff8a3bc00c6605d0df7214ab6ede9b8e50c1017
+  data.tar.gz: ebd7c4eff42bd88de0dca65a1f222c829a0e5522ded8a4ebd10f8fd7334275da542b3a9620fb88b987e7b13900eb2b8705d5593b5cbb1dcc08a06bab525c8892

data/.ruby-version

@@ -1 +1 @@
-2.5.1
+2.6.3

data/DEVELOP.md

@@ -54,6 +54,8 @@ TRUSONA_API_HOST=https://api.staging.trusona.net
 INTEGRATION_TEST_EMAIL=<your UAT email>
 ```
 
+The token needs to belong to relying party id `5dfc5568-fbd3-4c1c-80f6-d0cf3d9edc82` to work with the existing tests.
+
 ##### Running the tests
 
 `bundle exec rspec integrations/`

data/README.md

@@ -11,7 +11,7 @@ Easily interact with the Trusona REST API.
 ## Requirements
 The Trusona SDK requires Ruby version 2.4.0 or higher.
 
-## Examples
+## Usage
 
 * [Installation](#installation)
 * [Configuration](#configuration)
@@ -19,6 +19,7 @@ The Trusona SDK requires Ruby version 2.4.0 or higher.
 * [Trusonafications](#trusonafications)
 * [Devices](#devices)
 * [Users](#users)
+* [TruCodes](#trucodes)
 
 ### Installation
 
@@ -231,3 +232,14 @@ Trusona.config do |c|
   c.token          = ENV['TRUSONA_TOKEN']
 end
 ```
+
+### TruCodes
+
+After a user has scanned a TruCode, it's possible to acquire that user's information by getting the 
+scanned TruCode from the server. The code sample below shows how to do that:
+
+```ruby
+tru_code = Trusona::PairedTruCode.find('DB0C0B0B-0DC9-4118-BF73-68AB864E67FF')
+user_id = tru_code.identifier
+```
+

data/integrations/paired_tru_code_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'spec_helper'
+
+RSpec.describe Trusona::PairedTruCode do
+  before do
+    Trusona.config do |config|
+      config.token = 'token'
+      config.secret = 'secret'
+    end
+    body =<<EOF
+      {
+        "id": "myid",
+        "identifier": "myidentifier"
+      }
+EOF
+    signature = 'ODQ1YmVjNTAxNWRhOTFiZTEwMDljOTc4Y2NmOTE4ZDU1YzY0NDQ2YzhkNWJiMjIyMzA0ZjhiYzdlNGI2NjlmNQ=='
+
+    stub_request(:get, 'https://api.trusona.net/api/v2/paired_trucodes/abc123').
+      to_return(status: 200, body: body, headers: {"x-signature" => signature})
+  end
+  context 'a trucode exists and is paired' do
+    it 'loads the trucode' do
+      paired_tru_code = Trusona::PairedTruCode.find('abc123')
+
+      expect(paired_tru_code).not_to be_nil
+      expect(paired_tru_code.id).to eq 'myid'
+      expect(paired_tru_code.identifier).to eq 'myidentifier'
+    end
+  end
+end

data/integrations/spec_helper.rb

@@ -9,6 +9,9 @@ end
 require 'bundler/setup'
 require 'trusona'
 require 'securerandom'
+require 'webmock/rspec'
+
+WebMock.allow_net_connect!
 
 RSpec.configure do |config|
   # Enable flags like --only-failures and --next-failure

data/integrations/tru_code_spec.rb

@@ -5,6 +5,14 @@ require 'tempfile'
 
 # rubocop:disable Metrics/BlockLength
 RSpec.describe 'TruCodes' 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
+  end
+  
   describe 'creating a TruCode to show on your website' do
     before do
       @reference_id = SecureRandom.uuid
@@ -23,43 +31,6 @@ RSpec.describe 'TruCodes' do
       expect(result.id).to be
       expect(result.payload).to be
     end
-
-    xdescribe '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/user_identifiers_spec.rb

@@ -4,10 +4,13 @@ require_relative 'spec_helper'
 
 RSpec.describe 'Trusona User Identifiers' do
   before do
+    # this depends on existing data in staging. if it fails, try running this:
+    # insert into user_identifiers (identifier, trusona_id, created_at, updated_at, account_handle, relying_party_id)
+    # values ('am9uZXNAdGFjb3MubmV0Cg==', '264683802', now(), now(), uuid_generate_v4(), '5dfc5568-fbd3-4c1c-80f6-d0cf3d9edc82')
     @identifier = Trusona::Resources::UserIdentifier.new(identifier: 'am9uZXNAdGFjb3MubmV0Cg==', trusona_id: '264683802')
   end
 
-  describe 'retreiving a user identifier' do
+  describe 'retrieving 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(
@@ -16,7 +19,7 @@ RSpec.describe 'Trusona User Identifiers' do
       end
     end
 
-    xcontext 'when a valid identifier exists' do
+    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

data/lib/trusona.rb

@@ -16,6 +16,7 @@ require 'trusona/device_user_binding'
 require 'trusona/identity_document'
 require 'trusona/device'
 require 'trusona/user'
+require 'trusona/paired_tru_code'
 
 require 'trusona/api/signed_request'
 require 'trusona/api/verified_response'
@@ -34,6 +35,7 @@ require 'trusona/workers/trusonafication_finder'
 require 'trusona/workers/identity_document_finder'
 require 'trusona/workers/device_finder'
 require 'trusona/workers/user_deactivator'
+require 'trusona/workers/paired_tru_code_finder'
 
 require 'trusona/services/base_service'
 require 'trusona/services/user_accounts_service'
@@ -46,6 +48,7 @@ require 'trusona/services/device_user_bindings_service'
 require 'trusona/services/identity_documents_service'
 require 'trusona/services/devices_service'
 require 'trusona/services/users_service'
+require 'trusona/services/paired_tru_code_service'
 
 require 'trusona/mappers/base_mapper'
 require 'trusona/mappers/tru_code_mapper'
@@ -58,6 +61,7 @@ require 'trusona/mappers/device_user_binding_mapper'
 require 'trusona/mappers/identity_document_mapper'
 require 'trusona/mappers/device_mapper'
 require 'trusona/mappers/user_mapper'
+require 'trusona/mappers/paired_tru_code_mapper'
 
 require 'trusona/resources/validators'
 require 'trusona/resources/base_resource'
@@ -70,6 +74,7 @@ require 'trusona/resources/device_user_binding_activation'
 require 'trusona/resources/identity_document'
 require 'trusona/resources/device'
 require 'trusona/resources/user'
+require 'trusona/resources/paired_tru_code'
 
 # Trusona
 module Trusona
@@ -112,6 +117,7 @@ module Trusona
       yield(@config)
     end
 
+    raise Trusona::ConfigurationError unless @config
     @config
   end
 

data/lib/trusona/mappers/paired_tru_code_mapper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Trusona
+  module Mappers
+    class PairedTruCodeMapper < BaseMapper
+      def resource
+        Trusona::Resources::PairedTruCode
+      end
+    end
+  end
+end

data/lib/trusona/paired_tru_code.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Trusona
+  ##
+  # A TruCode that has already been paired by a device.
+  class PairedTruCode
+    def self.find(trucode_id)
+      Trusona::Workers::PairedTruCodeFinder.new.find(trucode_id)
+    end
+  end
+end

data/lib/trusona/resources/paired_tru_code.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Trusona
+  module Resources
+    class PairedTruCode < BaseResource
+      attr_reader :identifier
+
+      def initialize(params = {})
+        super(params)
+        @identifier = params[:identifier]
+      end
+    end
+  end
+end

data/lib/trusona/services/paired_tru_code_service.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Trusona
+  module Services
+    class PairedTruCodeService < BaseService
+      def initialize(client: Trusona::Api::HTTPClient.new)
+        super(client: client, mapper: Trusona::Mappers::PairedTruCodeMapper.new)
+        @resource_path = '/api/v2/paired_trucodes'
+      end
+    end
+  end
+end

data/lib/trusona/tru_code.rb

@@ -20,17 +20,6 @@ module Trusona
       Trusona::Workers::TruCodeFinder.new.find(id)
     end
 
-    ##
-    # Finds a TruCode using its ID
-    #
-    # @param id [String] The id of the TruCode we're looking for
-    # @return [Trusona::Resources::TruCode] The found TruCode
-    # @raise (see .find)
-    #
-    def self.status(id)
-      Trusona::Workers::TruCodeStatus.new.status(id)
-    end
-
     def self.create(code)
       Trusona::Workers::TruCodeCreator.new.create(code)
     end

data/lib/trusona/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Trusona
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/lib/trusona/workers/paired_tru_code_finder.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Trusona
+  module Workers
+    class PairedTruCodeFinder
+      def initialize(service: Trusona::Services::PairedTruCodeService.new)
+        @service = service
+      end
+
+      def find(trucode_id)
+        raise 'A TruCode ID is required' unless trucode_id
+
+        @service.get(Trusona::Resources::PairedTruCode.new(id: trucode_id))
+      end
+    end
+  end
+end

data/trusona.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
   spec.metadata['yard.run'] = 'yri' # use "yard" to build full HTML docs.
 
   spec.add_development_dependency 'bump', '~> 0.5'
-  spec.add_development_dependency 'bundler', '~> 1.15'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'dotenv', '~> 2.2'
   spec.add_development_dependency 'guard', '~> 2.14'
   spec.add_development_dependency 'guard-rspec', '~> 4.7'
@@ -40,4 +40,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop', '~> 0.49'
   spec.add_development_dependency 'simplecov', '~> 0.14'
   spec.add_development_dependency 'yard', '~> 0.9'
+  spec.add_development_dependency 'webmock'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trusona
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Trusona
@@ -35,7 +35,7 @@ cert_chain:
   vbhUT8kOS+bZTalorEol37DD/P4Bbv0fMpw+ozetR2RmwhwTKPKJ5r0oQP6tiqHn
   hQ==
   -----END CERTIFICATE-----
-date: 2018-12-21 00:00:00.000000000 Z
+date: 2019-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -69,16 +69,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -219,6 +219,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Easily interact with the Trusona REST API
 email:
 - engineering@trusona.com
@@ -243,6 +257,7 @@ files:
 - checksum/trusona-0.16.0.gem.sha512
 - integrations/device_user_binding_integration_spec.rb
 - integrations/identity_documents_spec.rb
+- integrations/paired_tru_code_spec.rb
 - integrations/spec_helper.rb
 - integrations/tru_code_spec.rb
 - integrations/trusonafication_spec.rb
@@ -264,16 +279,19 @@ files:
 - lib/trusona/mappers/device_user_binding_mapper.rb
 - lib/trusona/mappers/identity_document_mapper.rb
 - lib/trusona/mappers/nil_mapper.rb
+- lib/trusona/mappers/paired_tru_code_mapper.rb
 - lib/trusona/mappers/tru_code_mapper.rb
 - lib/trusona/mappers/trusonafication_mapper.rb
 - lib/trusona/mappers/user_account_mapper.rb
 - lib/trusona/mappers/user_identifier_mapper.rb
 - lib/trusona/mappers/user_mapper.rb
+- lib/trusona/paired_tru_code.rb
 - lib/trusona/resources/base_resource.rb
 - lib/trusona/resources/device.rb
 - lib/trusona/resources/device_user_binding.rb
 - lib/trusona/resources/device_user_binding_activation.rb
 - lib/trusona/resources/identity_document.rb
+- lib/trusona/resources/paired_tru_code.rb
 - lib/trusona/resources/tru_code.rb
 - lib/trusona/resources/trusonafication.rb
 - lib/trusona/resources/user.rb
@@ -285,6 +303,7 @@ files:
 - lib/trusona/services/device_user_bindings_service.rb
 - lib/trusona/services/devices_service.rb
 - lib/trusona/services/identity_documents_service.rb
+- lib/trusona/services/paired_tru_code_service.rb
 - lib/trusona/services/tru_codes_service.rb
 - lib/trusona/services/trusonafication_service.rb
 - lib/trusona/services/user_accounts_service.rb
@@ -301,6 +320,7 @@ files:
 - lib/trusona/workers/device_user_binding_activator.rb
 - lib/trusona/workers/device_user_binding_creator.rb
 - lib/trusona/workers/identity_document_finder.rb
+- lib/trusona/workers/paired_tru_code_finder.rb
 - lib/trusona/workers/tru_code_creator.rb
 - lib/trusona/workers/tru_code_finder.rb
 - lib/trusona/workers/trusonafication_creator.rb