castle-rb 3.3.1 → 3.4.0.pre.rc.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d0999873fc06348f78e4663a5bf653fe64f62f8432af21a7596dca3ed935ee3
-  data.tar.gz: a3e523ef2862b8f2928c180d70242aac5afda8594f5d48f0fc2647186a107fb5
+  metadata.gz: 1ccb1875a2285b0243e021b7af9c65d9e85ca3339a9a9545a005cb7647d1c947
+  data.tar.gz: 050dc35cdcea679018cdd5d590e05a12248544c7f6de90651134d6ab1348baad
 SHA512:
-  metadata.gz: 876a90d7bf0ceebefbd0ee2243f533cd520a91b8415fbbcb9b85eb2df5aa58dcc52717d267bb9edf89debd5a9e7f94f793b3564b34aaf6502a81885025ad6c08
-  data.tar.gz: 97f910519f2e67c9737219e4f7fe5c91f08bb817942bccc14dc534d67ec0a71db0d408d75454e4c67d148ca9aa60c30f3f9252a279321783d79ea07fd5cc43f6
+  metadata.gz: 35e8261649b45f2a60cc39c0e8e2824d23d5f42aeee081c85c2f009588c3e127e767610d6c7ed39cfeed932009c213f85c42c1f95072df4588d93937d61d32a6
+  data.tar.gz: 1a88b649dc9b80208e26368f41fe28d19e84b9614b6ca87f36c960e3c83199061e341d77fe7a58946927080f753008a654ef915108d41691d109fb254f7b9cd8

data/lib/castle.rb

@@ -19,6 +19,7 @@ require 'castle/commands/identify'
 require 'castle/commands/authenticate'
 require 'castle/commands/track'
 require 'castle/commands/review'
+require 'castle/commands/impersonate'
 require 'castle/configuration'
 require 'castle/failover_auth_response'
 require 'castle/client'

data/lib/castle/client.rb

@@ -66,6 +66,14 @@ module Castle
       @api.request(command)
     end
 
+    def impersonate(options = {})
+      options = Castle::Utils.deep_symbolize_keys(options || {})
+
+      return unless tracked?
+      command = Castle::Commands::Impersonate.new(@context).build(options)
+      @api.request(command)
+    end
+
     def disable_tracking
       @do_not_track = true
     end

data/lib/castle/commands/impersonate.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Castle
+  module Commands
+    # builder for impersonate command
+    class Impersonate
+      def initialize(context)
+        @context = context
+      end
+
+      def build(options = {})
+        validate!(options)
+        context = ContextMerger.call(@context, options[:context])
+        context = ContextSanitizer.call(context)
+
+        validate_context!(context)
+
+        Castle::Command.new('impersonate',
+                            options.merge(context: context),
+                            :post)
+      end
+
+      private
+
+      def validate!(options)
+        %i[user_id].each do |key|
+          next unless options[key].to_s.empty?
+          raise Castle::InvalidParametersError, "#{key} is missing or empty"
+        end
+      end
+
+      def validate_context!(context)
+        %i[user_agent ip].each do |key|
+          next unless context[key].to_s.empty?
+          raise Castle::InvalidParametersError, "#{key} is missing or empty"
+        end
+      end
+    end
+  end
+end

data/lib/castle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Castle
-  VERSION = '3.3.1'
+  VERSION = '3.4.0-rc.0'
 end

data/spec/lib/castle/client_spec.rb

@@ -3,9 +3,11 @@
 describe Castle::Client do
   let(:ip) { '1.2.3.4' }
   let(:cookie_id) { 'abcd' }
+  let(:ua) { 'Chrome' }
   let(:env) do
     Rack::MockRequest.env_for(
       '/',
+      'HTTP_USER_AGENT' => ua,
       'HTTP_X_FORWARDED_FOR' => ip,
       'HTTP_COOKIE' => "__cid=#{cookie_id};other=efgh"
     )
@@ -18,13 +20,14 @@ describe Castle::Client do
   end
   let(:client_with_no_timestamp) { described_class.new(request_to_context) }
 
-  let(:headers) { { 'X-Forwarded-For' => ip.to_s } }
+  let(:headers) { { 'X-Forwarded-For' => ip.to_s, 'User-Agent' => ua } }
   let(:context) do
     {
       client_id: 'abcd',
       active: true,
       origin: 'web',
-      headers: { 'X-Forwarded-For': ip.to_s },
+      user_agent: ua,
+      headers: { 'X-Forwarded-For': ip.to_s, 'User-Agent': ua },
       ip: ip,
       library: { name: 'castle-rb', version: '2.2.0' }
     }
@@ -42,9 +45,7 @@ describe Castle::Client do
     ).to_return(status: 200, body: '{}', headers: {})
   end
 
-  after do
-    Timecop.return
-  end
+  after { Timecop.return }
 
   describe 'parses the request' do
     before do
@@ -72,6 +73,24 @@ describe Castle::Client do
     end
   end
 
+  describe 'impersonate' do
+    let(:impersonator) { 'test@castle.io' }
+    let(:request_body) do
+      { user_id: '1234', impersonator: impersonator, context: context }
+    end
+    let(:options) { { user_id: '1234', impersonator: impersonator } }
+
+    before { client.impersonate(options) }
+
+    context 'when used with symbol keys' do
+      it do
+        assert_requested :post, 'https://api.castle.io/v1/impersonate', times: 1 do |req|
+          JSON.parse(req.body) == JSON.parse(request_body.to_json)
+        end
+      end
+    end
+  end
+
   describe 'identify' do
     let(:request_body) do
       { user_id: '1234', timestamp: time_auto,
@@ -80,7 +99,7 @@ describe Castle::Client do
 
     before { client.identify(options) }
 
-    context 'symbol keys' do
+    context 'when used with symbol keys' do
       let(:options) { { user_id: '1234', traits: { name: 'Jo' } } }
 
       it do
@@ -119,7 +138,7 @@ describe Castle::Client do
       end
     end
 
-    context 'string keys' do
+    context 'when used with string keys' do
       let(:options) { { 'user_id' => '1234', 'traits' => { 'name' => 'Jo' } } }
 
       it do
@@ -138,7 +157,7 @@ describe Castle::Client do
         timestamp: time_auto, sent_at: time_auto }
     end
 
-    context 'symbol keys' do
+    context 'when used with symbol keys' do
       before { request_response }
 
       it do
@@ -177,7 +196,7 @@ describe Castle::Client do
       end
     end
 
-    context 'string keys' do
+    context 'when used with string keys' do
       let(:options) { { 'event' => '$login.succeeded', 'user_id' => '1234' } }
 
       before { request_response }
@@ -189,7 +208,7 @@ describe Castle::Client do
       end
     end
 
-    context 'tracking enabled' do
+    context 'when tracking enabled' do
       before { request_response }
 
       it do
@@ -202,7 +221,7 @@ describe Castle::Client do
       it { expect(request_response[:failover_reason]).to be_nil }
     end
 
-    context 'tracking disabled' do
+    context 'when tracking disabled' do
       before do
         client.disable_tracking
         request_response
@@ -260,7 +279,7 @@ describe Castle::Client do
 
     before { client.track(options) }
 
-    context 'symbol keys' do
+    context 'when used with symbol keys' do
       let(:options) { { event: '$login.succeeded', user_id: '1234' } }
 
       it do
@@ -299,7 +318,7 @@ describe Castle::Client do
       end
     end
 
-    context 'string keys' do
+    context 'when used with string keys' do
       let(:options) { { 'event' => '$login.succeeded', 'user_id' => '1234' } }
 
       it do
@@ -311,13 +330,13 @@ describe Castle::Client do
   end
 
   describe 'tracked?' do
-    context 'off' do
+    context 'when off' do
       before { client.disable_tracking }
 
       it { expect(client).not_to be_tracked }
     end
 
-    context 'on' do
+    context 'when on' do
       before { client.enable_tracking }
 
       it { expect(client).to be_tracked }

data/spec/lib/castle/commands/authenticate_spec.rb

@@ -9,13 +9,8 @@ describe Castle::Commands::Authenticate do
   let(:time_now) { Time.now }
   let(:time_auto) { time_now.utc.iso8601(3) }
 
-  before do
-    Timecop.freeze(time_now)
-  end
-
-  after do
-    Timecop.return
-  end
+  before { Timecop.freeze(time_now) }
+  after { Timecop.return }
 
   describe '.build' do
     subject(:command) { instance.build(payload) }

data/spec/lib/castle/commands/identify_spec.rb

@@ -9,13 +9,8 @@ describe Castle::Commands::Identify do
   let(:time_now) { Time.now }
   let(:time_auto) { time_now.utc.iso8601(3) }
 
-  before do
-    Timecop.freeze(time_now)
-  end
-
-  after do
-    Timecop.return
-  end
+  before { Timecop.freeze(time_now) }
+  after { Timecop.return }
 
   describe '.build' do
     subject(:command) { instance.build(payload) }

data/spec/lib/castle/commands/impersonate_spec.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+describe Castle::Commands::Impersonate do
+  subject(:instance) { described_class.new(context) }
+
+  let(:context) { { user_agent: 'test', ip: '127.0.0.1', client_id: 'test' } }
+  let(:impersonator) { 'test@castle.io' }
+  let(:default_payload) { { user_id: '1234' } }
+
+  let(:time_now) { Time.now }
+  let(:time_auto) { time_now.utc.iso8601(3) }
+
+  before { Timecop.freeze(time_now) }
+  after { Timecop.return }
+
+  describe '.build' do
+    subject(:command) { instance.build(payload) }
+
+    context 'with simple merger' do
+      let(:payload) { default_payload.merge(context: { test: { test2: '1' } }) }
+      let(:command_data) do
+        default_payload.merge(
+          context: {
+            test: { test2: '1' },
+            user_agent: 'test',
+            ip: '127.0.0.1',
+            client_id: 'test'
+          }
+        )
+      end
+
+      it { expect(command.method).to be_eql(:post) }
+      it { expect(command.path).to be_eql('impersonate') }
+      it { expect(command.data).to be_eql(command_data) }
+    end
+
+    context 'with impersonator' do
+      let(:payload) { default_payload.merge(impersonator: impersonator) }
+      let(:command_data) do
+        default_payload.merge(impersonator: impersonator, context: context)
+      end
+
+      it { expect(command.method).to be_eql(:post) }
+      it { expect(command.path).to be_eql('impersonate') }
+      it { expect(command.data).to be_eql(command_data) }
+    end
+
+    context 'when active true' do
+      let(:payload) { default_payload.merge(context: { active: true }) }
+      let(:command_data) do
+        default_payload.merge(context: context.merge(active: true))
+      end
+
+      it { expect(command.method).to be_eql(:post) }
+      it { expect(command.path).to be_eql('impersonate') }
+      it { expect(command.data).to be_eql(command_data) }
+    end
+
+    context 'when active false' do
+      let(:payload) { default_payload.merge(context: { active: false }) }
+      let(:command_data) do
+        default_payload.merge(context: context.merge(active: false))
+      end
+
+      it { expect(command.method).to be_eql(:post) }
+      it { expect(command.path).to be_eql('impersonate') }
+      it { expect(command.data).to be_eql(command_data) }
+    end
+
+    context 'when active string' do
+      let(:payload) { default_payload.merge(context: { active: 'string' }) }
+      let(:command_data) { default_payload.merge(context: context) }
+
+      it { expect(command.method).to be_eql(:post) }
+      it { expect(command.path).to be_eql('impersonate') }
+      it { expect(command.data).to be_eql(command_data) }
+    end
+  end
+
+  describe '#validate!' do
+    subject(:validate!) { instance.build(payload) }
+
+    context 'when user_id not present' do
+      let(:payload) { {} }
+
+      it do
+        expect do
+          validate!
+        end.to raise_error(Castle::InvalidParametersError, 'user_id is missing or empty')
+      end
+    end
+
+    context 'when user_id present' do
+      let(:payload) { { user_id: '1234' } }
+
+      it { expect { validate! }.not_to raise_error }
+    end
+  end
+end

data/spec/lib/castle/commands/track_spec.rb

@@ -9,13 +9,8 @@ describe Castle::Commands::Track do
   let(:time_now) { Time.now }
   let(:time_auto) { time_now.utc.iso8601(3) }
 
-  before do
-    Timecop.freeze(time_now)
-  end
-
-  after do
-    Timecop.return
-  end
+  before { Timecop.freeze(time_now) }
+  after { Timecop.return }
 
   describe '#build' do
     subject(:command) { instance.build(payload) }

data/spec/lib/castle/utils/timestamp_spec.rb

@@ -6,13 +6,8 @@ describe Castle::Utils::Timestamp do
   let(:time_string) { '2018-01-10T14:14:24.407Z' }
   let(:time) { Time.parse(time_string) }
 
-  before do
-    Timecop.freeze(time)
-  end
-
-  after do
-    Timecop.return
-  end
+  before { Timecop.freeze(time) }
+  after { Timecop.return }
 
   describe '#call' do
     it do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: castle-rb
 version: !ruby/object:Gem::Version
-  version: 3.3.1
+  version: 3.4.0.pre.rc.0
 platform: ruby
 authors:
 - Johan Brissmyr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-01-22 00:00:00.000000000 Z
+date: 2018-01-27 00:00:00.000000000 Z
 dependencies: []
 description: Castle protects your users from account compromise
 email: johan@castle.io
@@ -24,6 +24,7 @@ files:
 - lib/castle/command.rb
 - lib/castle/commands/authenticate.rb
 - lib/castle/commands/identify.rb
+- lib/castle/commands/impersonate.rb
 - lib/castle/commands/review.rb
 - lib/castle/commands/track.rb
 - lib/castle/configuration.rb
@@ -54,6 +55,7 @@ files:
 - spec/lib/castle/command_spec.rb
 - spec/lib/castle/commands/authenticate_spec.rb
 - spec/lib/castle/commands/identify_spec.rb
+- spec/lib/castle/commands/impersonate_spec.rb
 - spec/lib/castle/commands/review_spec.rb
 - spec/lib/castle/commands/track_spec.rb
 - spec/lib/castle/configuration_spec.rb
@@ -90,9 +92,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.7.4
@@ -119,6 +121,7 @@ test_files:
 - spec/lib/castle/commands/review_spec.rb
 - spec/lib/castle/commands/authenticate_spec.rb
 - spec/lib/castle/commands/track_spec.rb
+- spec/lib/castle/commands/impersonate_spec.rb
 - spec/lib/castle/commands/identify_spec.rb
 - spec/lib/castle/context_merger_spec.rb
 - spec/lib/castle/extractors/ip_spec.rb