stealth_browser_automation 1.1.34 → 1.2.38

data/lib/browserfactory.rb

@@ -1,4 +1,5 @@
 require 'watir-webdriver'
+require 'selenium-webdriver'
 require "pathname"
 
 # **ABSTRACT**
@@ -30,13 +31,203 @@ require "pathname"
 # Custom Selenium elements to stream the browser windows when some events happen. 
 module Selenium
   module WebDriver
+=begin # TODO: enable this for mouse movement biometrics simulation
+    module PointerActions
+      alias_method :old_move_to_location, :move_to_location
+      alias_method :old_move_to, :move_to
+
+      @@x = 0
+      @@y = 0
+
+      def x()
+        @@x
+      end
+
+      def y()
+        @@y
+      end
+
+      def move_to_location(x, y)
+        # getting noise factor
+        if !BlackStack::BrowserFactory.mouse_hash.nil?
+          actions = []
+          
+          # do a noisy moveent to (x,y)
+          i = { :x=>@@x.to_f, :y=>@@y.to_f } # starting position
+          j = { :x=>x.to_f, :y=>y.to_f } # ending position
+          t = 0.to_f
+          z = BlackStack::BrowserFactory.mouse_hash[:noise].to_f
+          
+          # TODO: validate the step tiene que ser un divisor de 1. O sea: 1/step da un numero entero.
+          step = 0.05 # 20 steps ( 1 / 0.05 = 20 )
+          
+          while t<1.to_f
+            t += step 
+            # noise calculation
+            if t<1.to_f # there is no noise for the last step
+              noise = {
+                :x => ( z.to_f + (rand(10000).to_f / 10000.to_f ) - 1.to_f ) / 10.to_f,
+                :y => ( z.to_f + (rand(10000).to_f / 10000.to_f ) - 1.to_f ) / 10.to_f,
+              }
+            else
+              noise = {
+                :x => 0.to_f,
+                :y => 0.to_f,
+              }
+            end
+            w = {
+              :x => ( i[:x] + t*(j[:x]-i[:x]) + t*(j[:x]-i[:x])*noise[:x] ).round(0).to_i,
+              :y => ( i[:y] + t*(j[:y]-i[:y]) + t*(j[:y]-i[:y])*noise[:y] ).round(0).to_i,
+            }
+            # TODO: fire javascript event? --> the old_move_to_location method will fire such event
+            # peform action
+            a = old_move_to_location(w[:x], w[:y])
+            actions << a
+            a.perform if t<1.to_f
+          end
+          @@x = x
+          @@y = y
+          actions.last
+        else
+          old_move_to_location(x, y)
+        end # if !BlackStack::BrowserFactory.mouse_hash.nil?
+      end # def move_to_location(x, y)
+
+      def move_to(element, right_by = nil, down_by = nil)
+        # getting noise factor
+        if !BlackStack::BrowserFactory.mouse_hash.nil?
+          z = BlackStack::BrowserFactory.mouse_hash[:noise].to_f
+  
+          # select a random position inside the element, and call the move_to_location method.
+          noise = {
+            :x => ( z.to_f + (rand(10000).to_f / 10000.to_f ) ) / 2.to_f,
+            :y => ( z.to_f + (rand(10000).to_f / 10000.to_f ) ) / 2.to_f,
+          }
+  
+          w = {
+            :x => ( element.location.x.to_f + element.size.width.to_f * noise[:x].to_f ).to_i,
+            :y => ( element.location.y.to_f + element.size.height.to_f * noise[:y].to_f ).to_i,
+          }
+          self.move_to_location(w[:x], w[:y])
+        else
+          old_move_to(x, y)
+        end # if !BlackStack::BrowserFactory.mouse_hash.nil?
+      end
+      
+    end # class ActionBuilder
+=end
     class Element
       alias_method :old_click, :click
+      alias_method :old_send_keys, :send_keys
       
       def click()
+=begin # TODO: enable this for mouse movement biometrics simulation
+        # getting noise factor
+        if !BlackStack::BrowserFactory.mouse_hash.nil?
+          # noise move movement to the element, plus click into a random position inside the element.
+          BlackStack::BrowserFactory.browser.driver.action.move_to(self) 
+        end
+=end
+        # 
         old_click 
+        # 
         BlackStack::BrowserFactory.browser.push_screenshot
       end # def click
+
+      # Masking keystrokes biometrics
+      # This method is also called by Selenium::WebDriver::Element::set, and by the setter Selenium::WebDriver::Element::value
+      def send_keys(*args)
+=begin # TODO: enable this for mouse movement biometrics simulation
+        # click the element before writing, that will move the cursor to the element previously
+        self.click()
+=end  
+        # 
+        pevious_char = nil
+        if BlackStack::BrowserFactory.keystroke_signature.nil?
+          old_send_keys(args)
+        else
+          args.each { |s|
+
+            if s.is_a? Symbol
+              old_send_keys(s)
+            else
+              # convert single quotes string to double using eval() function, so I can replace escaped chars using String::escape_javascript method.
+              # more information here: https://www.ruby-forum.com/t/single-quoted-string-to-become-double-quoted-is-it-possible/214980
+              # TODO: create the method String::to_souble_quotes in blackstack_commons
+              eval("\"#{s.gsub('"','\\"')}\"").split('').each { |c|              
+                # escape string to build a javascript literal string dynamically
+                c2 = c.escape_javascript
+                j = c.ord
+                j = j%256 # considerar caracteres no ascii, fuera del intervalo [0,255]
+  
+                if !pevious_char.nil?
+                  i = pevious_char.ord
+                  i = i%256 # considerar caracteres no ascii, fuera del intervalo [0,255]
+  
+                  # d1 = delay between keys + 10% random
+                  d = BlackStack::BrowserFactory.keystroke_matrix[i][j] # delay between 2 keys
+                  aux1 = 1000000
+                  rnd = ( rand((d.to_f * aux1.to_f).to_i).to_f * 0.1.to_f ) / aux1.to_f
+                  d1 = d + rnd
+  
+                  # apply delay between keys
+                  sleep(d1)
+                end
+  
+                # d2 = delay the relative dwell and flight time
+                # more info here: https://www.keytrac.net/en/technology
+                d2 = BlackStack::BrowserFactory.keystroke_matrix[0][j] # delay between 2 keys
+                # TODO: agregar un random
+  
+                # apply delay between dwell and flight time
+                
+                # TODO: this is not working because key_down only accepts :CTRL, :ALT, :SHIFT
+                # BlackStack::BrowserFactory.browser.driver.action.key_down(self, c).perform
+  
+                # TODO: this is working but when c.ord is outside the range [0,255]
+                # TODO: injected javascript is detectable by websites!
+                script = "arguments[0].dispatchEvent(new KeyboardEvent('keydown',{'key':\"#{c2}\"}));"
+                if c.ord >= 0 && c.ord <= 255
+                  # disable pampa notifications in this case
+                  baux = BlackStack::BrowserFactory.browser.pampa_integration
+                  BlackStack::BrowserFactory.browser.pampa_integration = false
+                  BlackStack::BrowserFactory.browser.execute_script(script, self) 
+                  BlackStack::BrowserFactory.browser.pampa_integration = baux
+                end
+  
+                sleep(d2)
+
+                if c=='\n'
+                  old_send_keys("\n") # TODO: I don't know why old_send_keys("\n") print 2 chars (\n) in the textarea, instead to do the breakline.
+                else
+                  begin
+                    old_send_keys("#{j.chr}")
+                  rescue
+                    # issue #112 ( https://github.com/leandrosardi/blackstack/issues/112 )
+                  end
+                end  
+
+                # TODO: this is not working because key_up only accepts :CTRL, :ALT, :SHIFT
+                # BlackStack::BrowserFactory.browser.driver.action.key_up(self, c).perform
+  
+                # TODO: this is working but when c.ord is outside the range [0,255]
+                # TODO: injected javascript is detectable by websites!
+                script = "arguments[0].dispatchEvent(new KeyboardEvent('keyup',{'key':\"#{c2}\"}));"
+                if c.ord >= 0 && c.ord <= 255
+                  # disable pampa notifications in this case
+                  baux = BlackStack::BrowserFactory.browser.pampa_integration
+                  BlackStack::BrowserFactory.browser.pampa_integration = false
+                  BlackStack::BrowserFactory.browser.execute_script(script, self) 
+                  BlackStack::BrowserFactory.browser.pampa_integration = baux
+                end
+  
+                # update previous char
+                pevious_char = c
+              }
+            end # if s.is_a? Symbol
+          }
+        end
+      end # def send_keys(*args)
       
     end # class Element
   end # module WebDriver
@@ -75,14 +266,14 @@ module BlackStack
     #PAMPA_BROWSER_CHANNEL_LOCK_FILENAME = './browserfactory.channel.%PROFILE_NAME%.lock' # manejo de concurrencia en la creación de browsers
     #attr_accessor  :lockfile
     
-    attr_accessor :proxy, :lnuser, :agent_name, :profile_name
+    attr_accessor :proxy, :lnuser, :agent_name, :profile_name, :pampa_integration, :rquery
 
     def lock_channel()
-      self.lockfile.flock(File::LOCK_EX)
+#      self.lockfile.flock(File::LOCK_EX)
     end
   
     def release_channel()
-      self.lockfile.flock(File::LOCK_UN)
+#      self.lockfile.flock(File::LOCK_UN)
     end
 
     def initialize(driver)
@@ -90,9 +281,16 @@ module BlackStack
       #fname = PAMPA_BROWSER_CHANNEL_LOCK_FILENAME.gsub('%PROFILE_NAME%', self.profile_name.to_s)
       #self.lockfile = File.open(fname,"w")
       
+      self.pampa_integration = true
+      
       #
       super(driver)
 
+      # TODO: activate it when develop the RQuery (Render Query) feature
+=begin
+      self.rquery = BlackStack::StealthBrowserAutomation::RQuery::FixedMatching(self)
+=end
+
       # TODO: enable this when you move to the "frequency-based-streaming" model
 =begin
       # Can't operate the same browser from more than 1 thread.
@@ -134,21 +332,23 @@ module BlackStack
     end # def initialize 
 
     def notify(method)
-      url = "#{BlackStack::Pampa::api_protocol}://#{PROCESS.ws_url}:#{PROCESS.ws_port}/api1.3/pampa/browser/notify.json"
-      res = BlackStack::Netting::call_post(url, {
-        :api_key => BlackStack::Pampa::api_key,
-        :filename => $0,
-        :method => method,
-        :worker_name => PROCESS.fullWorkerName,
-        :id_proxy => self.proxy.nil? ? nil : self.proxy.id,
-        :id_lnuser => self.lnuser.nil? ? nil : self.lnuser.id,
-        :worker_assigned_process => PROCESS.worker.assigned_process,
-        :profile_name => self.profile_name,
-        :agent_name => self.agent_name,
-      })        
-      parsed = JSON.parse(res.body)
-      if parsed['status'] != "success"
-        raise "Error Tracing BrowserActivity: #{parsed['status']}"
+      if self.pampa_integration
+        url = "#{BlackStack::Pampa::api_protocol}://#{PROCESS.ws_url}:#{PROCESS.ws_port}/api1.3/pampa/browser/notify.json"
+        res = BlackStack::Netting::call_post(url, {
+          :api_key => BlackStack::Pampa::api_key,
+          :filename => $0,
+          :method => method,
+          :worker_name => PROCESS.fullWorkerName,
+          :id_proxy => self.proxy.nil? ? nil : self.proxy.id,
+          :id_lnuser => self.lnuser.nil? ? nil : self.lnuser.id,
+          :worker_assigned_process => PROCESS.worker.assigned_process,
+          :profile_name => self.profile_name,
+          :agent_name => self.agent_name,
+        })        
+        parsed = JSON.parse(res.body)
+        if parsed['status'] != "success"
+          raise "Error Tracing BrowserActivity: #{parsed['status']}"
+        end
       end
     end
 
@@ -201,7 +401,7 @@ module BlackStack
       BlackStack::BrowserFactory.browser.push_screenshot
       super
     end
-      
+
     def execute_script(script, *args)
       self.notify("execute_script")
       BlackStack::BrowserFactory.browser.push_screenshot
@@ -331,6 +531,14 @@ module BlackStack
     # Only TYPE_CHROME or TYPE_MIMIC are supported at this moment.
     @@type = nil
   
+    # Masking keystroke biometric signature
+    @@keystroke_signature = nil
+    @@keystroke_matrix = nil
+
+    # Masking keystroke biometric signature
+    @@mouse_signature = nil
+    @@mouse_hash = nil
+  
     # Returns the PampaBrowser object
     def self.browser
       @@browser
@@ -341,6 +549,148 @@ module BlackStack
       [BlackStack::BrowserFactory::TYPE_CHROME, BlackStack::BrowserFactory::TYPE_MIMIC]
     end
 
+    # Returns the @@keystroke_signature attribute
+    def self.keystroke_signature
+      @@keystroke_signature
+    end
+
+    # Returns the @@keystroke_matrix attribute
+    def self.keystroke_matrix
+      @@keystroke_matrix
+    end
+
+    # Returns the @@mouse_signature attribute
+    def self.mouse_signature
+      @@mouse_signature
+    end
+
+    # Returns the @@keystroke_matrix attribute
+    def self.mouse_hash
+      @@mouse_hash
+    end
+
+    # Set the @@keystroke_signature attribute
+    def self.set_keystroke_signature(s)
+      return if s.nil?
+
+      raise 'The keystroke signature must be a GUID' if !s.guid?
+
+      # guid normalization
+      s = s.to_guid
+
+      # initializing class attributes
+      @@keystroke_signature = s
+      @@keystroke_matrix = []
+
+      # calculating the average writing speed
+      writing_speed = 0
+      s.split('').each { |c| 
+        writing_speed += c.ord if c.ord != '-'.ord 
+      }
+      writing_speed = writing_speed.to_f / 100000.to_f
+
+      # calculating average delay between each pair of keys
+      delays = s.split('') #.delete('-')
+      i = 0
+      while i<256
+        j = 0
+        k = 0
+        @@keystroke_matrix[i] = []
+        while j<256
+          k = 0 if k>=delays.size
+          @@keystroke_matrix[i][j] = writing_speed.to_f 
+          @@keystroke_matrix[i][j] += delays[k-0].to_f / 100.to_f
+          @@keystroke_matrix[i][j] += delays[k-1].to_f / 100.to_f if k>0
+          @@keystroke_matrix[i][j] += delays[k-2].to_f / 100.to_f if k>1
+          @@keystroke_matrix[i][j] += delays[k-3].to_f / 100.to_f if k>2
+          @@keystroke_matrix[i][j] += delays[k-4].to_f / 100.to_f if k>3
+          k+=1
+          j+=1
+        end
+        i+=1
+      end
+    end
+
+    # Set the @@mouse_signature attribute
+    def self.set_mouse_signature(s)
+      return if s.nil?
+
+      raise 'The mouse signature must be a GUID' if !s.guid?
+
+      # guid normalization
+      s = s.to_guid
+
+      # initializing class attributes
+      @@mouse_signature = s
+      
+      # initialize mouse hash
+      max = 16*32-1 # it is the sum of all the hex number from the max GUID: FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF
+      sum = 0 # it is the sum of all the hex number from the GUID in the `s` parameter
+      s.gsub('-', '').upcase.split('').each { |c|
+        i = "0x#{c}".to_i(16)
+        sum += i
+      }
+      rate = sum.to_f / max.to_f
+      @@mouse_hash = {
+        :noise => rate,
+      }
+    end
+    
+    # kill both multilogin.exe and headless.exe processes.
+    def self.mla_kill()
+      # this is to run many mlalisteners in paralell
+      # for more information refer to #166:doc:
+      # https://github.com/leandrosardi/blackstack/issues/166
+      f = File.open('mlalistener.lock', File::CREAT)
+
+      # kill tasks
+      system("taskkill /F /T /IM headless.exe 1>nul 2>nul")
+      system("taskkill /F /T /IM multilogin.exe 1>nul 2>nul")
+      
+      # this is to run many mlalisteners in paralell
+      # for more information refer to #166:doc:
+      # https://github.com/leandrosardi/blackstack/issues/166
+      f.flock(File::LOCK_UN)
+    end
+
+    # start headliness.exe, and relaunch it if it shuts down.
+    def self.mla_listener(h)
+      port = h[:port]
+      verbose = h[:verbose]
+      
+      port = 45000 if port.nil?
+      verbose = true if verbose.nil?
+      begin
+        while (true) 
+          puts 'verbose mode is active.' if verbose
+          puts "listening port #{port.to_s}." if verbose
+          start_time = Time.now
+          BlackStack::BrowserFactory::mla_kill
+          if (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil
+  	    system("headless.exe -port #{port} 1>nul 2>nul")
+	  else
+        # TODO: parametrizar la ruta de headless.sh
+  	    system("~/code/multilogin/headless.sh -port #{port}") # multilogin folder is uncompressed in the ~/code/ folder
+	  end
+          #system("headless.exe -port #{port} 1>nul 2>nul")
+          end_time = Time.now
+          enlapsed_seconds = end_time - start_time
+          poll_seconds = 5 # parser.value('min_cycle_seconds')
+          sleep( poll_seconds - enlapsed_seconds ) if poll_seconds > enlapsed_seconds
+        end        
+      rescue Interrupt => e
+        puts 'process interruption' if verbose
+        # stop this while(true) loop
+      rescue => e
+        puts "unexpected error: #{e.to_s}" if verbose
+        # nothing to do here. 
+        # just restart the while
+      ensure
+        BlackStack::BrowserFactory::mla_kill
+      end
+    end
+
+
     # Returns the description string from a browser type code 
     def self.typeDesc(type)
       return 'Chrome' if @@type == BlackStack::BrowserFactory::TYPE_CHROME
@@ -386,23 +736,29 @@ module BlackStack
     # For more information, read documentations about PROFILE_PID_LIST_FILENAME.
     # This method is used for chrome browsers only.
     def self.readPidToProfileList(profile_name)
-      if profile_name != nil
-        fname = PROFILE_PID_LIST_FILENAME.gsub('%PROFILE_NAME%', profile_name)
-        s = File.read(fname)
-        return s.split(",")
+      if @@browser.pampa_integration
+        if profile_name != nil
+          fname = PROFILE_PID_LIST_FILENAME.gsub('%PROFILE_NAME%', profile_name)
+          s = File.read(fname)
+          return s.split(",")
+        else
+          return []
+        end
       else
         return []
-      end
+      end # if @@browser.pampa_integration
     end
   
     # Add the PID of this browser; and the PID of all the child processes of this, with name like /chrome\.exe/.
     # For more information, read documentations about PROFILE_PID_LIST_FILENAME.
     # This method is used for chrome browsers only.
     def self.updateProfileList
-      addPidToProfileList(@@profile_name, @@pid)
-      PROCESS.list().select { |p| p[:ppid] == @@pid && p[:executablepath] =~ /chrome\.exe/ }.each { |p2|
-        addPidToProfileList(@@profile_name, p2[:pid])                  
-      }
+      if @@browser.pampa_integration
+        addPidToProfileList(@@profile_name, @@pid)
+        PROCESS.list().select { |p| p[:ppid] == @@pid && p[:executablepath] =~ /chrome\.exe/ }.each { |p2|
+          addPidToProfileList(@@profile_name, p2[:pid])                  
+        }
+      end # if @@browser.pampa_integration
     end
 
     # Returns true if @@browser is not nil, or @@profile_name is not nil.
@@ -426,21 +782,25 @@ module BlackStack
 
     # Retorna true si el perfil en @@profile_name esta siendo trabajado por este proceso
     def self.itIsMe?
-      # el archivo tiene una unica primera linea de ancho fijo
-      line_chars = 100
-      # obtengo el id de este proceso que esta corriendo
-      my_pid = PROCESS.pid
-      # bloqueo el archivo de este perfil
-      @@fd_profile_lock.flock(File::LOCK_EX) if !@@fd_profile_lock.nil?
-      # valido que my_pid no tenga mas caracteres que al ancho fijo
-      raise 'Cannot work browser profile lockfile because the lenght if the id of this process is larger than the max number of chars allowed (#{line_chars.to_s})' if line_chars < my_pid.size 
-      # obtengo el id del proceso que se reservo este perfil
-      @@fd_profile_lock.seek(-line_chars, IO::SEEK_CUR) if !@@fd_profile_lock.nil?
-      lock_pid = @@fd_profile_lock.read.to_s      
-      # libero el archivo de este perfil
-      @@fd_profile_lock.flock(File::LOCK_UN) if !@@fd_profile_lock.nil?
-      # return
-      my_pid.strip.upcase == lock_pid.strip.upcase
+      if @@browser.pampa_integration
+        # el archivo tiene una unica primera linea de ancho fijo
+        line_chars = 100
+        # obtengo el id de este proceso que esta corriendo
+        my_pid = PROCESS.pid
+        # bloqueo el archivo de este perfil
+        @@fd_profile_lock.flock(File::LOCK_EX) if !@@fd_profile_lock.nil?
+        # valido que my_pid no tenga mas caracteres que al ancho fijo
+        raise 'Cannot work browser profile lockfile because the lenght if the id of this process is larger than the max number of chars allowed (#{line_chars.to_s})' if line_chars < my_pid.size 
+        # obtengo el id del proceso que se reservo este perfil
+        @@fd_profile_lock.seek(-line_chars, IO::SEEK_CUR) if !@@fd_profile_lock.nil?
+        lock_pid = @@fd_profile_lock.read.to_s      
+        # libero el archivo de este perfil
+        @@fd_profile_lock.flock(File::LOCK_UN) if !@@fd_profile_lock.nil?
+        # return
+        return my_pid.strip.upcase == lock_pid.strip.upcase
+      else
+        return false
+      end
     end
 
     # This method is to open no more than one browser of the same profile at time.
@@ -449,41 +809,43 @@ module BlackStack
     # If the content of the file is different than the PID of this process, but such content is not equal to the PID of any other process alive, so this process is good to start the browser.
     # If the content of the file is different than the PID of this process, and such content is equal to the PID of another process alive, this method unlock the file and will raise an exception.
     def self.lockProfile
-      # el archivo tiene una unica primera linea de ancho fijo
-      line_chars = 100
-      # bloqueo el archivo de este perfil
-      @@fd_profile_lock.flock(File::LOCK_EX)
-      # obtengo el id de este proceso que esta corriendo
-      my_pid = PROCESS.pid
-      # valido que my_pid no tenga mas caracteres que al ancho fijo
-      raise 'Cannot work browser profile lockfile because the lenght if the id of this process is larger than the max number of chars allowed (#{line_chars.to_s})' if line_chars < my_pid.size 
-      # obtengo el id del proceso que se reservo este perfil
-      lock_pid = @@fd_profile_lock.read.to_s
-      # 
-      if lock_pid.size == 0
-        @@fd_profile_lock.write my_pid
-        @@fd_profile_lock.write ' ' * (line_chars - my_pid.size)
-        @@fd_profile_lock.flush
-      elsif lock_pid.strip.upcase != my_pid.strip.upcase
-        # verifico si el proceso que reservo este perfil esta activo
-        p = PROCESS.list().select { |h| h[:pid].strip.upcase == lock_pid.strip.upcase }.first
-        lock_process_is_alive = !p.nil?
-        # levanto una excepcion de bloqueo si este perfil fue reservado por otro proceso y el proceso sigue activo
-        if lock_process_is_alive
-          # libero el archivo de este perfil
-          @@fd_profile_lock.flock(File::LOCK_UN)
-          # 
-          raise 'Profile is locked'
-        # me reservo este perfil si fue reservado por un proceso que ya no esta activo
-        else # if lock_process_is_alive
-          @@fd_profile_lock.seek(-line_chars, IO::SEEK_CUR)
+      if @@browser.pampa_integration
+        # el archivo tiene una unica primera linea de ancho fijo
+        line_chars = 100
+        # bloqueo el archivo de este perfil
+        @@fd_profile_lock.flock(File::LOCK_EX)
+        # obtengo el id de este proceso que esta corriendo
+        my_pid = PROCESS.pid
+        # valido que my_pid no tenga mas caracteres que al ancho fijo
+        raise 'Cannot work browser profile lockfile because the lenght if the id of this process is larger than the max number of chars allowed (#{line_chars.to_s})' if line_chars < my_pid.size 
+        # obtengo el id del proceso que se reservo este perfil
+        lock_pid = @@fd_profile_lock.read.to_s
+        # 
+        if lock_pid.size == 0
           @@fd_profile_lock.write my_pid
           @@fd_profile_lock.write ' ' * (line_chars - my_pid.size)
           @@fd_profile_lock.flush
-        end # if lock_process_is_alive
-      else # lock_pid.strip.upcase == my_pid.strip.upcase
-        # go ahead
-      end # if lock_pid.size == 0
+        elsif lock_pid.strip.upcase != my_pid.strip.upcase
+          # verifico si el proceso que reservo este perfil esta activo
+          p = PROCESS.list().select { |h| h[:pid].strip.upcase == lock_pid.strip.upcase }.first
+          lock_process_is_alive = !p.nil?
+          # levanto una excepcion de bloqueo si este perfil fue reservado por otro proceso y el proceso sigue activo
+          if lock_process_is_alive
+            # libero el archivo de este perfil
+            @@fd_profile_lock.flock(File::LOCK_UN)
+            # 
+            raise 'Profile is locked'
+          # me reservo este perfil si fue reservado por un proceso que ya no esta activo
+          else # if lock_process_is_alive
+            @@fd_profile_lock.seek(-line_chars, IO::SEEK_CUR)
+            @@fd_profile_lock.write my_pid
+            @@fd_profile_lock.write ' ' * (line_chars - my_pid.size)
+            @@fd_profile_lock.flush
+          end # if lock_process_is_alive
+        else # lock_pid.strip.upcase == my_pid.strip.upcase
+          # go ahead
+        end # if lock_pid.size == 0
+      end # if @@browser.pampa_integration
     end # def self.lockProfile()
   
     # This method is to open no more than one browser of the same profile at time.
@@ -541,101 +903,82 @@ module BlackStack
     
     # Close the browser only if itIsMe? returns true.
     # Set nil to @@browser, @@pid, @@profile_name, @@driver, @@type.
-    def self.destroy
-      #if self.itIsMe?
-        begin        
-          # borro el contenido de PROFILE_LOCK_FILENAME 
-          #if !@@profile_name.nil?
-          #  fname = PROFILE_LOCK_FILENAME.gsub('%PROFILE_NAME%', @@profile_name) 
-          #  File.open(fname,'w')
-          #end
+    def self.destroy(clear_variables=true)
+      begin        
+        # borro el contenido de PROFILE_LOCK_FILENAME 
+        #if !@@profile_name.nil?
+        #  fname = PROFILE_LOCK_FILENAME.gsub('%PROFILE_NAME%', @@profile_name) 
+        #  File.open(fname,'w')
+        #end
           
-          # 
-          if @@type == BlackStack::BrowserFactory::TYPE_CHROME
-            # kill all child process
-            self.lockProfileList()
-            self.readPidToProfileList(@@profile_name).each { |pid|
-              MyProcess.kill(pid)
-              self.removePidToProfileList(@@profile_name, pid)      
-            }
-            self.releaseProfileList()
+        # 
+        if @@type == BlackStack::BrowserFactory::TYPE_CHROME
+          # kill all child process
+          self.lockProfileList()
+          self.readPidToProfileList(@@profile_name).each { |pid|
+            MyProcess.kill(pid)
+            self.removePidToProfileList(@@profile_name, pid)      
+          }
+          self.releaseProfileList()
             
-            begin
-              @@browser.close if !@@browser.nil?
-            rescue
-            end
+          begin
+            @@browser.close if !@@browser.nil?
+          rescue
+          end
             
-          elsif @@type == BlackStack::BrowserFactory::TYPE_MIMIC
-=begin
-puts ''
-            begin
-print 'Close browser?... '
-              if !@@browser.nil?
-puts 'yes'
-print 'Close browser... '
-								@@browser.close 
-puts 'done'
-							else
-puts 'no'							
-							end
-            rescue => e
-puts "error: #{e.to_s}"
+        elsif @@type == BlackStack::BrowserFactory::TYPE_MIMIC
+          i = 0
+          body = nil
+          max = 90
+          success = 0 # I have to call this access point many times to get the browser closed.
+					max_success_required = 30
+          while i<max && success<max_success_required
+            i+=1
+            # cierro el perfil por si estaba corriendo
+            if BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_4
+              url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
+              ssl = true
+            elsif BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_5
+              url = "http://localhost.multiloginapp.com:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
+              ssl = false
+            else
+              raise 'Invalid Multilogin Version'
             end
-=end
+            uri = URI.parse(url)
 =begin
-            begin
-              # TODO: entender porque debo hacer esta llamada a start para que el perfil se cierre cuando ya estaba iniciado
-puts ''
-print 'Close browser?... '
-							if !@@profile_name.nil?
-puts 'yes'
-print 'Close browser... '
-								BlackStack::BrowserFactory.mimic(@@profile_name)
-puts 'done'
-print 'Close browser (2)... '
-								@@browser.close 
-puts 'done'
-							else
-puts 'no'
-							end
-            rescue
-              # nothing here
+            Net::HTTP.start(uri.host, uri.port, :use_ssl => ssl, :verify_mode => OpenSSL::SSL::VERIFY_NONE) do |http|
+              req = Net::HTTP::Get.new(uri)
+              req['Content-Type'] = 'application/json'
+              if http.request(req).body
+                body = http.request(req).body
+              end
             end
 =end
-
-            i = 0
-            max = 90
-            success = 0 # I have to call this access point many times to get the browser closed.
-						max_success_required = 30
-            while i<max && success<max_success_required
-#puts ''
-              i+=1
-             url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
-#print "Api Call ##{i.to_s} to: #{url}... "
-              uri = URI.parse(url)
-              body = Net::HTTP.get(uri)
-              res = JSON.parse(body)
-              success += 1 if res['status'].to_s == 'OK'
-#puts "response: #{res['status'].to_s}"
-            end # while i<max &&  && success<max_success_required
-            raise "Error requesting Mimic to stop (tried #{i.to_s} times)" if success<max_success_required
-
-          else
-            raise 'Cannot destroy browser due unknown browser type'
-          end
-        rescue => e
-          self.release
-          raise e
+            body = Net::HTTP.get(uri)
+            res = JSON.parse(body)
+            success += 1 if res['status'].to_s == 'OK'
+#puts "i:#{i.to_s}:."
+#puts "body:#{body.to_s}:."
+#puts "res.status:#{res['status'].to_s}:."
+          end # while i<max &&  && success<max_success_required
+          raise "Error requesting Mimic to stop (tried #{i.to_s} times)" if success<max_success_required
+        else
+          # unknown browser type
         end
-      #end # if self.isItMe?
+      rescue => e
+        self.release
+        raise e
+      end
       
-      # reseteo las variables    
-      @@browser = nil
-      @@pid = nil
-      @@profile_name = nil
-      @@driver = nil
-      @@type = nil
-    end
+      # reseteo las variables   
+      if clear_variables 
+        @@browser = nil
+        @@pid = nil
+        @@profile_name = nil
+        @@driver = nil
+        @@type = nil
+      end
+    end # if self.destroy
     
     # Returns the version of the availalble chrome browser.
     def self.chrome_version
@@ -660,7 +1003,7 @@ puts 'no'
     end
     
     # Launch a Mimic browser.
-    def self.mimic(mimic_profile_id)
+    def self.mimic(mimic_profile_id, load_timeout=DEFAULT_LOAD_TIMEOUT)
       # 
       @@type = BlackStack::BrowserFactory::TYPE_MIMIC
       @@profile_name = mimic_profile_id
@@ -684,13 +1027,29 @@ puts 'no'
           i += 1
 
           # cierro el perfil por si estaba corriendo
-          url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
-          uri = URI.parse(url)
+          if BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_4
+            url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
+            ssl = true
+          elsif BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_5
+            url = "http://localhost.multiloginapp.com:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/stop?profileId=#{@@profile_name}"
+            ssl = false
+          else
+            raise 'Invalid Multilogin Version'
+          end
+	        uri = URI.parse(url)
           body = Net::HTTP.get(uri)
           res = JSON.parse(body)
 
-          url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/start?automation=true&profileId=#{@@profile_name}"
-          uri = URI.parse(url)
+          if BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_4
+            url = "http://127.0.0.1:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/start?automation=true&profileId=#{@@profile_name}"
+            ssl = true
+          elsif BlackStack::StealthBrowserAutomation::Multilogin::mla_version == BlackStack::StealthBrowserAutomation::Multilogin::VERSION_5
+            url = "http://localhost.multiloginapp.com:#{BlackStack::StealthBrowserAutomation::Multilogin::mla_local_port}/api/v1/profile/start?automation=true&profileId=#{@@profile_name}"
+            ssl = false
+          else
+            raise 'Invalid Multilogin Version'
+          end
+	        uri = URI.parse(url)
           body = Net::HTTP.get(uri)
           res = JSON.parse(body)
 
@@ -714,6 +1073,7 @@ puts 'no'
                 #  http.request(req_2)
                 #}        
                 @@driver = Selenium::WebDriver.for(:remote, :url => url_2)
+								@@driver.manage.timeouts.page_load = load_timeout
                 #bridge = @@driver.instance_variable_get(:@bridge)
                 #service = bridge.instance_variable_get(:@service)
                 #process = service.instance_variable_get(:@process)
@@ -761,17 +1121,22 @@ puts 'no'
         h[:load_timeout].nil? ? DEFAULT_LOAD_TIMEOUT : h[:load_timeout], 
         h[:user_agent],
         h[:profile_name],
-        h[:chromedriver_path]
+        h[:chromedriver_path],
+        h[:pampa_integration],
+        h[:keystroke_signature],
+        h[:mouse_signature]
       )
     end
 
     # Launch a chrome browser.
-    def self.launch_chrome(proxy=nil, load_timeout=DEFAULT_LOAD_TIMEOUT, user_agent=nil, profile_name=nil, chromedriver_path=nil)
+    def self.launch_chrome(proxy=nil, load_timeout=DEFAULT_LOAD_TIMEOUT, user_agent=nil, profile_name=nil, chromedriver_path=nil, pampa_integration=true, keystroke_signature=nil, mouse_signature=nil)
       #
       @@browser = nil
       @@driver = nil
       @@type = BlackStack::BrowserFactory::TYPE_CHROME
       @@profile_name = profile_name
+      self.set_keystroke_signature(keystroke_signature)
+      self.set_mouse_signature(mouse_signature)
 
       #
       #fname = PROFILE_LOCK_FILENAME.gsub('%PROFILE_NAME%', @@profile_name)
@@ -789,14 +1154,16 @@ puts 'no'
       while (@@browser == nil)            
         
         begin
-          # Levantar el flag de reserva a mi favor
-          self.lock()
-  
-          # 
-          #self.lockProfile()
-  
-          # 
-          self.lockProfileList()
+          if pampa_integration
+            # Levantar el flag de reserva a mi favor
+            self.lock()
+    
+            # 
+            #self.lockProfile()
+    
+            # 
+            self.lockProfileList()
+          end # pampa_integration
 
           #
           client = Selenium::WebDriver::Remote::Http::Default.new
@@ -838,29 +1205,34 @@ puts 'no'
     
           Selenium::WebDriver::Chrome.driver_path = chromedriver_path if !chromedriver_path.nil?
           Selenium::WebDriver::Chrome.driver_path = DEFAULT_CHROMEDRIVER_PATH if chromedriver_path.nil?
-            
+          
           @@driver = Selenium::WebDriver.for :chrome, :switches => switches
           bridge = @@driver.instance_variable_get(:@bridge)
           service = bridge.instance_variable_get(:@service)
           process = service.instance_variable_get(:@process)
-          @@pid = process.pid.to_s # es el PID del chromedriver
+#          @@pid = process.pid.to_s # es el PID del chromedriver # TODO: hacer andar esto con selenium 3.14.1
           @@driver.manage.window().maximize()
           @@browser = PampaBrowser.new(@@driver)
           @@browser.proxy = proxy.clone if !proxy.nil?    
           @@browser.agent_name = agent
           @@browser.profile_name = profile_name
+          @@browser.pampa_integration = pampa_integration
           self.updateProfileList              
-  
+          
         # 
-        rescue => e # TODO: Se atrapa una expecion porque sigue ocurreiendo el error reportado en el issue #134 y #129
-          # 
-          p1 = PROCESS.list().select { |p| p[:ppid] == PROCESS.pid && p[:executablepath] =~ /chromedriver\.exe/ }.first
-          if (p1 != nil)
-            @@pid = p1[:pid]
-            self.updateProfileList              
-          end              
-          self.releaseProfileList()
-
+        rescue => e 
+          # TODO: Se atrapa una expecion porque sigue ocurreiendo el error reportado en el issue #134 y #129
+          if !@@browser.nil?
+            if @@browser.pampa_integration
+              p1 = PROCESS.list().select { |p| p[:ppid] == PROCESS.pid && p[:executablepath] =~ /chromedriver\.exe/ }.first
+              if (p1 != nil)
+                @@pid = p1[:pid]
+                self.updateProfileList              
+              end              
+              self.releaseProfileList()
+            end
+          end
+          
           #
           #self.releaseProfile()