pwn 0.4.463 → 0.4.466

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a39a74b8bc26847795f54fdcbd7f48eb5a38c2587da0d233e74bd96a8267c9a9
-  data.tar.gz: fa37dda7a5e16dc6743da3930b5278d83077e2ba100d65566eef9fd39c373967
+  metadata.gz: b22a31f1952951d9c3bd1a8dd912b58e1b6ccf39d93a55327b10e285729e67de
+  data.tar.gz: a15ab49fbf548031599248380aca04bb05e9220357d771d27de63d477af33038
 SHA512:
-  metadata.gz: e08cddc2558b06ed364a65dd058f94d75f2b02241a8adf613818c992ad038e8bb5f23b30d59e8f9061a3d1538a817697eabf4985f484f4076827e4fbbbe28ddc
-  data.tar.gz: 2b098194d45038d7cc85ba1653a3aa85bb432de6049fcebbcc58575a982eb02b31c4757d425c984e60c88a07a6a62868c411ed52043d79dff649052e65a3c27f
+  metadata.gz: 360eab449207970607c8052dfd3ee9beae9026ed19c41f690f2874cdc932eb8981c341792d37316bc202a5feb2332cdf86686f39416dd001b0338d8b19dbad72
+  data.tar.gz: d85c5f1785095b00c058727366896774a47afcb107aa69d0115aa4d501b83daa71df4699983f51acafdc46fa91fc9bcba52bdd7cb770fade67ac5ba85e3ecf9d

data/.rubocop_todo.yml

@@ -1,47 +1,47 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2022-05-08 06:06:43 UTC using RuboCop version 1.29.0.
+# on 2022-05-27 23:04:56 UTC using RuboCop version 1.30.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 227
+# Offense count: 234
 Lint/UselessAssignment:
   Enabled: false
 
-# Offense count: 246
+# Offense count: 253
 # Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
   Max: 328
 
-# Offense count: 60
+# Offense count: 63
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 # IgnoredMethods: refine
 Metrics/BlockLength:
-  Max: 194
+  Max: 196
 
 # Offense count: 45
 # Configuration parameters: CountBlocks.
 Metrics/BlockNesting:
   Max: 5
 
-# Offense count: 83
+# Offense count: 89
 # Configuration parameters: IgnoredMethods.
 Metrics/CyclomaticComplexity:
   Max: 231
 
-# Offense count: 440
+# Offense count: 459
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 Metrics/MethodLength:
   Max: 466
 
-# Offense count: 33
+# Offense count: 34
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
   Max: 1186
 
-# Offense count: 75
+# Offense count: 81
 # Configuration parameters: IgnoredMethods.
 Metrics/PerceivedComplexity:
   Max: 51
@@ -50,33 +50,33 @@ Metrics/PerceivedComplexity:
 Style/ClassVars:
   Enabled: false
 
-# Offense count: 281
-# This cop supports safe auto-correction (--auto-correct).
+# Offense count: 285
+# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, SingleLineConditionsOnly, IncludeTernaryExpressions.
 # SupportedStyles: assign_to_condition, assign_inside_condition
 Style/ConditionalAssignment:
   Enabled: false
 
 # Offense count: 2
-# This cop supports safe auto-correction (--auto-correct).
+# This cop supports safe autocorrection (--autocorrect).
 Style/ExplicitBlockArgument:
   Exclude:
     - 'lib/pwn/plugins/nmap_it.rb'
 
 # Offense count: 95
-# This cop supports safe auto-correction (--auto-correct).
+# This cop supports safe autocorrection (--autocorrect).
 Style/RedundantCondition:
   Exclude:
     - 'bin/pwn_simple_http_server'
     - 'lib/pwn/plugins/packet.rb'
 
 # Offense count: 44
-# This cop supports unsafe auto-correction (--auto-correct-all).
+# This cop supports unsafe autocorrection (--autocorrect-all).
 Style/SlicingWithRange:
   Enabled: false
 
-# Offense count: 531
-# This cop supports safe auto-correction (--auto-correct).
+# Offense count: 555
+# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, IgnoredPatterns.
 # URISchemes: http, https
 Layout/LineLength:

data/Gemfile

@@ -13,12 +13,12 @@ gemspec
 # to review these custom flags (e.g. pg, serialport, etc).
 gem 'activesupport', '7.0.3'
 gem 'anemone', '0.7.2'
-gem 'authy', '3.0.0'
+gem 'authy', '3.0.1'
 gem 'aws-sdk', '3.1.0'
 gem 'bettercap', '1.6.2'
 gem 'brakeman', '5.2.3'
 gem 'bson', '4.15.0'
-gem 'bundler', '>=2.3.14'
+gem 'bundler', '>=2.3.15'
 gem 'bundler-audit', '0.9.1'
 gem 'bunny', '2.19.0'
 gem 'colorize', '0.8.1'
@@ -80,4 +80,4 @@ gem 'watir', '7.1.0'
 gem 'waveform', '0.1.2'
 gem 'webrick', '1.7.0'
 gem 'wicked_pdf', '2.6.3'
-gem 'yard', '0.9.27'
+gem 'yard', '0.9.28'

data/README.md

@@ -37,7 +37,7 @@ $ rvm use ruby-3.1.2@pwn
 $ rvm list gemsets
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.463]:001 >>> PWN.help
+pwn[v0.4.466]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.1.2@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.463]:001 >>> PWN.help
+pwn[v0.4.466]:001 >>> PWN.help
 ```
 
 

data/bin/pwn_serial_msr206

@@ -14,24 +14,24 @@ OptionParser.new do |options|
     opts[:block_dev] = d
   end
 
-  options.on('-bBAUD', '--baud=DEV', '<Optional - (defaults to 9600)>') do |d|
-    opts[:block_dev] = d
+  options.on('-bBAUD', '--baud=BAUD', '<Optional - (defaults to 9600)>') do |b|
+    opts[:baud] = b
   end
 
-  options.on('-DDATABITS', '--data-bits=DATABITS', '<Optional - (defaults to 7)>') do |d|
-    opts[:block_dev] = d
+  options.on('-DDATABITS', '--data-bits=DATABITS', '<Optional - (defaults to 8)>') do |d|
+    opts[:data_bits] = d
   end
 
-  options.on('-sSTOPBITS', '--stop-bits=STOPBITS', '<Optional - (defaults to 1)>') do |d|
-    opts[:block_dev] = d
+  options.on('-sSTOPBITS', '--stop-bits=STOPBITS', '<Optional - (defaults to 1)>') do |s|
+    opts[:stop_bits] = s
   end
 
-  options.on('-pPARITY', '--parity=PARITY', '<Optional - :even|:mark|:odd|:space|:none (defaults to :odd)>') do |d|
-    opts[:block_dev] = d
+  options.on('-pPARITY', '--parity=PARITY', '<Optional - even|mark|odd|space|none (defaults to none)>') do |p|
+    opts[:parity] = p
   end
 
-  options.on('-fFLOW', '--flow-control=FLOW', '<Optional - :none||:hard||:soft (defaults to :none)>') do |d|
-    opts[:block_dev] = d
+  options.on('-fFLOWCTRL', '--flow-control=FLOWCTRL', '<Optional - none||hard||soft (defaults to none)>') do |f|
+    opts[:flow_control] = f
   end
 end.parse!
 
@@ -41,7 +41,7 @@ if opts.empty?
 end
 
 begin
-  block_dev = opts[:block_dev]
+  block_dev = opts[:block_dev] if File.exist?(opts[:block_dev])
   baud = opts[:baud]
   data_bits = opts[:data_bits]
   stop_bits = opts[:stop_bits]
@@ -57,10 +57,143 @@ begin
     flow_control: flow_control
   )
 
-  serial_resp = PWN::Plugins::MSR206.exec(
+  puts "- Welcome to #{File.basename($PROGRAM_NAME)} -"
+  puts "Connected via: #{block_dev} @ #{msr206_obj[:serial_conn].modem_params}"
+  puts "Flow Control: #{msr206_obj[:serial_conn].flow_control}"
+  puts "Signals: #{msr206_obj[:serial_conn].signals}"
+
+  exec_resp = PWN::Plugins::MSR206.exec(
     msr206_obj: msr206_obj,
     cmd: :simulate_power_cycle_warm_reset
   )
+
+  # TODO: Parse Binary Bits to Derive Readable Configuration
+  # e.g. 'Read & Write All Three Tracks' if binary_resp == '11101111'
+  # Probably better to split each bit and then evaluate
+  # binary_resp_arr = binary_resp.chars
+  # --------------------------------------------------
+  # Bit|Bit = 0                  |Bit = 1
+  # --------------------------------------------------
+  # 0  |Track 1 Read not present |Track 1 Read present
+  # 1  |Track 2 Read not present |Track 2 Read present
+  # 2  |Track 3 Read not present |Track 3 Read present
+  # 3  |not used – should be 0   |not used
+  # 4  |Track 3 Write not present|Track 3 Write present
+  # 5  |Track 2 Write not present|Track 2 Write present
+  # 6  |Track 1 Write not present|Track 1 Write present
+  # 7  |parity bit**             |parity bit** 
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :configuration_request
+  )
+  puts "Configuration Bits: #{exec_resp[:binary].first}"
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :version_report
+  )
+  puts "Firmware Version: #{exec_resp[:decoded]}"
+
+  # Main Menu
+  menu_msg = ''
+  loop do
+    unless menu_msg.include?('ERROR')
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :yellow_on
+      )
+    end
+
+    puts "\n>> MAIN MENU OPTIONS:"
+    puts '[(R)ead Card]'
+    puts '[(C)opy Card]'
+    puts '[(E)dit Card]'
+    puts '[(B)ackup Card]'
+    puts '[(W)arm Reset]'
+    puts '[(Q)uit]'
+    puts menu_msg
+    print 'MAIN MENU OPTION >>> '
+    menu_msg = ''
+    option = gets.scrub.chomp.strip.upcase.to_sym
+
+    case option
+    when :R
+      menu_msg = 'READY TO READ - PLEASE SWIPE CARD'
+      # Read Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+    when :C
+      menu_msg = 'READY TO COPY - PLEASE SWIPE ORIGINAL CARD'
+      # Read Original Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+
+      # TODO: Save Original Card Contents
+      # arm_to_write card to clone
+      # read cloned card to verify successful write
+    when :E
+      menu_msg = 'READY TO EDIT - PLEASE SWIPE TARGET CARD'
+      # Read Target Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+
+      # TODO: Save Original Card Contents
+      # arm_to_write card to edit
+      # read edited card to verify successful write
+    when :B
+      menu_msg = 'READY TO BACKUP - PLEASE SWIPE CARD'
+      # Read Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+    when :W
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :simulate_power_cycle_warm_reset
+      )
+      puts exec_resp.inspect
+    when :Q
+      exit
+    else
+      menu_msg = '****** ERROR: Invalid Menu Option Selected ******'
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :yellow_off
+      )
+
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :red_flash
+      )
+    end
+  end
+rescue StandardError => e
+  raise e
 rescue SystemExit, Interrupt
   puts "\nGoodbye."
+ensure
+  # Lights Off
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :green_off
+  )
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :yellow_off
+  )
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :red_off
+  )
+
+  msr206_obj = PWN::Plugins::MSR206.disconnect(msr206_obj: msr206_obj) if msr206_obj
 end

data/lib/pwn/plugins/msr206.rb

@@ -9,9 +9,9 @@ module PWN
       # msr206_obj = PWN::Plugins::MSR206.connect(
       #   block_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)',
       #   baud: 'optional - (defaults to 9600)',
-      #   data_bits: 'optional - (defaults to 7)',
+      #   data_bits: 'optional - (defaults to 8)',
       #   stop_bits: 'optional - (defaults to 1)',
-      #   parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd),'
+      #   parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none),'
       #   flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
       # )
 
@@ -19,9 +19,9 @@ module PWN
         # Default Baud Rate for this Device is 19200
         opts[:block_dev] = '/dev/ttyUSB0' unless opts[:block_dev]
         opts[:baud] = 9_600 unless opts[:baud]
-        opts[:data_bits] = 7 unless opts[:data_bits]
+        opts[:data_bits] = 8 unless opts[:data_bits]
         opts[:stop_bits] = 1 unless opts[:stop_bits]
-        opts[:parity] = :odd unless opts[:parity]
+        opts[:parity] = :none unless opts[:parity]
         opts[:flow_control] = :none unless opts[:flow_control]
         msr206_obj = PWN::Plugins::Serial.connect(opts)
       rescue StandardError => e
@@ -93,6 +93,241 @@ module PWN
         raise e
       end
 
+      # Supported Method Parameters::
+      # parsed_cmd_resp_arr = decode(
+      #   raw_byte_arr: 'required - raw_byte_arr produced in #parse_responses'
+      # )
+
+      private_class_method def self.decode(opts = {})
+        raw_byte_arr = opts[:raw_byte_arr]
+
+        decoded_data_str = ''
+        if raw_byte_arr
+          raw_byte_arr.first.split.each do |byte_str|
+            case byte_str
+            when '1B'
+              decoded_data_str += ''
+            when '20'
+              decoded_data_str += ' '
+            when '21'
+              decoded_data_str += '!'
+            when '22'
+              decoded_data_str += '"'
+            when '23'
+              decoded_data_str += '#'
+            when '24'
+              decoded_data_str += '$'
+            when '25'
+              decoded_data_str += '%'
+            when '26'
+              decoded_data_str += '&'
+            when '27'
+              decoded_data_str += "'"
+            when '28'
+              decoded_data_str += '('
+            when '29'
+              decoded_data_str += ')'
+            when '2A', 'AA'
+              decoded_data_str += '*'
+            when '2B', 'AB'
+              decoded_data_str += '+'
+            when '2C', 'AC'
+              decoded_data_str += ','
+            when '2D', 'AD'
+              decoded_data_str += '-'
+            when '2E', 'AE'
+              decoded_data_str += '.'
+            when '2F', 'AF'
+              decoded_data_str += '/'
+            when '30', 'B0'
+              decoded_data_str += '0'
+            when '31', 'B1'
+              decoded_data_str += '1'
+            when '32', 'B2'
+              decoded_data_str += '2'
+            when '33', 'B3'
+              decoded_data_str += '3'
+            when '34', 'B4'
+              decoded_data_str += '4'
+            when '35', 'B5'
+              decoded_data_str += '5'
+            when '36', 'B6'
+              decoded_data_str += '6'
+            when '37', 'B7'
+              decoded_data_str += '7'
+            when '38', 'B8'
+              decoded_data_str += '8'
+            when '39', 'B9'
+              decoded_data_str += '9'
+            when '3A', 'BA'
+              decoded_data_str += ':'
+            when '3B', 'BB'
+              decoded_data_str += ';'
+            when '3C', 'BC'
+              decoded_data_str += '<'
+            when '3D', 'BD'
+              decoded_data_str += '='
+            when '3E', 'BE'
+              decoded_data_str += '>'
+            when '3F', 'BF'
+              decoded_data_str += '?'
+            when '40', 'C0'
+              decoded_data_str += '@'
+            when '41', 'C1'
+              decoded_data_str += 'A'
+            when '42', 'C2'
+              decoded_data_str += 'B'
+            when '43', 'C3'
+              decoded_data_str += 'C'
+            when '44', 'C4'
+              decoded_data_str += 'D'
+            when '45', 'C5'
+              decoded_data_str += 'E'
+            when '46', 'C6'
+              decoded_data_str += 'F'
+            when '47', 'C7'
+              decoded_data_str += 'G'
+            when '48', 'C8'
+              decoded_data_str += 'H'
+            when '49', 'C9'
+              decoded_data_str += 'I'
+            when '4A', 'CA'
+              decoded_data_str += 'J'
+            when '4B', 'CB'
+              decoded_data_str += 'K'
+            when '4C', 'CC'
+              decoded_data_str += 'L'
+            when '4D', 'CD'
+              decoded_data_str += 'M'
+            when '4E', 'CE'
+              decoded_data_str += 'N'
+            when '4F', 'CF'
+              decoded_data_str += 'O'
+            when '50', 'D0'
+              decoded_data_str += 'P'
+            when '51', 'D1'
+              decoded_data_str += 'Q'
+            when '52', 'D2'
+              decoded_data_str += 'R'
+            when '53', 'D3'
+              decoded_data_str += 'S'
+            when '54', 'D4'
+              decoded_data_str += 'T'
+            when '55', 'D5'
+              decoded_data_str += 'U'
+            when '56', 'D6'
+              decoded_data_str += 'V'
+            when '57', 'D7'
+              decoded_data_str += 'W'
+            when '58', 'D8'
+              decoded_data_str += 'X'
+            when '59', 'D9'
+              decoded_data_str += 'Y'
+            when '5A', 'DA'
+              decoded_data_str += 'Z'
+            when '5B', 'DB'
+              decoded_data_str += '['
+            when '5C', 'DC'
+              decoded_data_str += '\\'
+            when '5D', 'DD'
+              decoded_data_str += ']'
+            when '5E', 'DE'
+              decoded_data_str += '^'
+            when '5F', 'DF'
+              decoded_data_str += '_'
+            when '60', 'E0'
+              decoded_data_str += '`'
+            when '61', 'E1'
+              decoded_data_str += 'a'
+            when '62', 'E2'
+              decoded_data_str += 'b'
+            when '63', 'E3'
+              decoded_data_str += 'c'
+            when '64', 'E4'
+              decoded_data_str += 'd'
+            when '65', 'E5'
+              decoded_data_str += 'e'
+            when '66', 'E6'
+              decoded_data_str += 'f'
+            when '67', 'E7'
+              decoded_data_str += 'g'
+            when '68', 'E8'
+              decoded_data_str += 'h'
+            when '69', 'E9'
+              decoded_data_str += 'i'
+            when '6A', 'EA'
+              decoded_data_str += 'j'
+            when '6B', 'EB'
+              decoded_data_str += 'k'
+            when '6C', 'EC'
+              decoded_data_str += 'l'
+            when '6D', 'ED'
+              decoded_data_str += 'm'
+            when '6E', 'EE'
+              decoded_data_str += 'n'
+            when '6F', 'EF'
+              decoded_data_str += 'o'
+            when '70', 'F0'
+              decoded_data_str += 'p'
+            when '71', 'F1'
+              decoded_data_str += 'q'
+            when '72', 'F2'
+              decoded_data_str += 'r'
+            when '73', 'F3'
+              decoded_data_str += 's'
+            when '74', 'F4'
+              decoded_data_str += 't'
+            when '75', 'F5'
+              decoded_data_str += 'u'
+            when '76', 'F6'
+              decoded_data_str += 'v'
+            when '77', 'F7'
+              decoded_data_str += 'w'
+            when '78', 'F8'
+              decoded_data_str += 'x'
+            when '79', 'F9'
+              decoded_data_str += 'y'
+            when '7A', 'FA'
+              decoded_data_str += 'z'
+            when '7B', 'FB'
+              decoded_data_str += '{'
+            when '7C', 'FC'
+              decoded_data_str += '|'
+            when '7D', 'FD'
+              decoded_data_str += '}'
+            when '7E', 'FE'
+              decoded_data_str += '~'
+            else
+              decoded_data_str += "\u00BF"
+            end
+          end
+        end
+
+        decoded_data_str
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # parsed_cmd_resp_arr = binary(
+      #   raw_byte_arr: 'required - raw_byte_arr produced in #parse_responses'
+      # )
+
+      private_class_method def self.binary(opts = {})
+        raw_byte_arr = opts[:raw_byte_arr]
+
+        binary_byte_arr = []
+        if raw_byte_arr
+          raw_byte_arr.first.split.each do |byte_str|
+            binary_byte_arr.push([byte_str].pack('H*').unpack('B*').first.reverse)
+          end
+        end
+
+        binary_byte_arr
+      rescue StandardError => e
+        raise e
+      end
+
       # Supported Method Parameters::
       # parsed_cmd_resp_arr = parse_responses(
       #   cmd_resp: 'required - command response string'
@@ -100,11 +335,15 @@ module PWN
 
       private_class_method def self.parse_responses(opts = {})
         msr206_obj = opts[:msr206_obj]
-        cmd = opts[:cmd].to_s.scrub.strip.chomp
+        cmd = opts[:cmd]
 
         keep_parsing_responses = true
         next_response_detected = false
-        all_cmd_responses = []
+        response = {}
+        response[:cmd] = cmd
+        response[:cmd] ||= :na
+
+        raw_byte_arr = []
         a_cmd_r_len = 0
         last_a_cmd_r_len = 0
 
@@ -114,26 +353,58 @@ module PWN
 
         while keep_parsing_responses
           until next_response_detected
-            all_cmd_responses = PWN::Plugins::Serial.response(serial_obj: msr206_obj)
-            cmd_resp = all_cmd_responses.last
+            raw_byte_arr = PWN::Plugins::Serial.response(serial_obj: msr206_obj)
+            cmd_resp = raw_byte_arr.last
             bytes_in_cmd_resp = cmd_resp.split.length if cmd_resp
-            a_cmd_r_len = all_cmd_responses.length
+            a_cmd_r_len = raw_byte_arr.length
 
             next_response_detected = true if a_cmd_r_len > last_a_cmd_r_len
           end
 
-          #   cmd_resp = all_cmd_responses.last
-          #   case cmd_resp
-          #   when '21', '28', '29', '2A', '2B', '2D', '2F', '3A', '31', '32', '33', '3E', '3F', '5E', '7E', '98 FE'
-          #     next_response_detected = true
-          #   end
+          case cmd_resp
+          when '21', 'A1'
+            response[:msg] = :invalid_command
+          when '28', 'A8'
+            response[:msg] = :card_speed_measurement_start
+          when '29', 'A9'
+            response[:msg] = :card_speed_measurement_end
+          when '2A', 'AA'
+            response[:msg] = :error
+          when '2B', 'AB'
+            response[:msg] = :no_data_found
+          when '2D', 'AD'
+            response[:msg] = :insufficient_leading_zeros_for_custom_writing
+          when '2F', 'AF'
+            response[:msg] = :first_lsb_char_not_one_for_custom_writing
+          when '31', 'B1'
+            response[:msg] = :unsuccessful_read_after_write_track1
+          when '32', 'B2'
+            response[:msg] = :unsuccessful_read_after_write_track2
+          when '33', 'B3'
+            response[:msg] = :unsuccessful_read_after_write_track3
+          when '3A', 'BA'
+            response[:msg] = :power_on_report
+          when '3E', 'BE'
+            response[:msg] = :card_edge_detected
+          when '3F', 'BF'
+            response[:msg] = :communications_error
+          when '5E'
+            response[:msg] = :ack_command_completed
+          when '7E'
+            response[:msg] = :command_not_supported_by_hardware
+          else
+            response[:msg] = :na
+          end
+
           next_response_detected = false
           last_a_cmd_r_len = a_cmd_r_len
-          print "\n"
           keep_parsing_responses = false
         end
 
-        all_cmd_responses
+        response[:raw] = raw_byte_arr
+        response[:binary] = binary(raw_byte_arr: raw_byte_arr)
+        response[:decoded] = decode(raw_byte_arr: raw_byte_arr)
+        response
       rescue StandardError => e
         raise e
       ensure
@@ -281,6 +552,123 @@ module PWN
         PWN::Plugins::Serial.flush_session_data
       end
 
+      # Supported Method Parameters::
+      # PWN::Plugins::MSR206.wait_for_swipe(
+      #   msr206_obj: 'required - msr206_obj returned from #connect method'
+      # )
+
+      public_class_method def self.wait_for_swipe(opts = {})
+        msr206_obj = opts[:msr206_obj]
+        type = opts[:type].to_s.scrub.strip.chomp.to_sym
+        types_arr = %i[
+          arm_to_read
+          arm_to_read_w_speed_prompts
+          arm_to_write_no_raw
+          arm_to_write_with_raw
+          arm_to_write_with_raw_speed_prompts
+        ]
+
+        raise "ERROR Unsupported type in #wait_for_swipe - #{type}. Valid types:\n#{types_arr}" unless types_arr.include?(type)
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :red_off
+        )
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :yellow_off
+        )
+
+        exec_resp = PWN::Plugins::MSR206.exec(
+          msr206_obj: msr206_obj,
+          cmd: type
+        )
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :green_on
+        )
+
+        exec_resp = PWN::Plugins::MSR206.exec(
+          msr206_obj: msr206_obj,
+          cmd: :card_edge_detect
+        )
+
+        print 'Ready.  Please Swipe Card Now:'
+        loop do
+          exec_resp = parse_responses(
+            msr206_obj: msr206_obj,
+            cmd: :card_edge_detect
+          )
+
+          break if exec_resp[:msg] == :ack_command_completed
+        end
+
+        puts "\n*** ISO Track Format: Standard #{'*' * 17}"
+        print 'TRACK 1 >>> '
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track1
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # (1..3).each do |n|
+        #   print ">> Track 1 (ALT DATA) ISO Track Format: #{n}\n"
+        #   exec_resp = exec(
+        #     msr206_obj: msr206_obj,
+        #     cmd: :alt_tx_iso_std_data_track1,
+        #     params: [n.to_s]
+        #   )
+        #   puts exec_resp.inspect
+        # end
+
+        print "\nTRACK 2 >>> "
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track2
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # (1..3).each do |n|
+        #   print ">> Track 2 (ALT DATA) ISO Track Format: #{n}\n"
+        #   exec_resp = exec(
+        #     msr206_obj: msr206_obj,
+        #     cmd: :alt_tx_iso_std_data_track2,
+        #     params: [n.to_s]
+        #   )
+        #   puts exec_resp.inspect
+        # end
+
+        print "\nTRACK 3 >>> "
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track3
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # (1..3).each do |n|
+        #   print ">> Track 3 (ALT DATA) ISO Track Format: #{n}\n"
+        #   exec_resp = exec(
+        #     msr206_obj: msr206_obj,
+        #     cmd: :alt_tx_iso_std_data_track3,
+        #     params: [n.to_s]
+        #   )
+        #   puts exec_resp.inspect
+        # end
+
+      rescue StandardError => e
+        raise e
+      ensure
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :green_off
+        )
+      end
+
       # Supported Method Parameters::
       # PWN::Plugins::MSR206.disconnect(
       #   msr206_obj: 'required - msr206_obj returned from #connect method'
@@ -309,9 +697,9 @@ module PWN
           msr206_obj = #{self}.connect(
             block_dev: 'optional serial block device path (defaults to /dev/ttyUSB0)',
             baud: 'optional (defaults to 9600)',
-            data_bits: 'optional (defaults to 7)',
+            data_bits: 'optional (defaults to 8)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd),'
+            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none),'
             flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
           )
 

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.4.463'
+  VERSION = '0.4.466'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.4.463
+  version: 0.4.466
 platform: ruby
 authors:
 - 0day Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-26 00:00:00.000000000 Z
+date: 2022-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.0.1
 - !ruby/object:Gem::Dependency
   name: aws-sdk
   requirement: !ruby/object:Gem::Requirement
@@ -114,14 +114,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.14
+        version: 2.3.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.14
+        version: 2.3.15
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -968,14 +968,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.9.27
+        version: 0.9.28
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.9.27
+        version: 0.9.28
 description: https://github.com/0dayinc/pwn/README.md
 email:
 - request.pentest@0dayinc.com