Module: Msf::Exploit::Git::PktLine

Included in:
SmartHttp, SmartHttp::Request, SmartHttp::Response
Defined in:
lib/msf/core/exploit/git/pkt_line.rb

Overview

This module implements the pkt-line format used by Git.

Constant Summary collapse

FLUSH_PKT =
"0000"
DELIM_PKT =
"0001"
RESPONSE_END_PKT =
"0002"

Class Method Summary collapse

Class Method Details

.generate_data_pkt(data) ⇒ Object


36
37
38
39
40
41
42
43
44
45
46
47
48
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 36

def self.generate_data_pkt(data)
  return nil unless data

  return nil if data.empty?

  # The length should include the length
  # of pkt-payload plus four characters for
  # pkt-len plus another for the terminating LF
  pkt_line_len = data.length + 4 + 1
  pkt_line_len = pkt_line_len.to_s(16).rjust(4, '0')

  "#{pkt_line_len}#{data}\n"
end

.generate_pkt_line(data, type: 'data-pkt') ⇒ Object

pkt-line format pkt-line = data-pkt / flush-pkt data-pkt = pkt-len pkt-payload pkt-len = 4*(HEXDIG) pkt-payload = (pkt-len - 4)*(OCTET) source: git-scm.com/docs/protocol-common


27
28
29
30
31
32
33
34
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 27

def self.generate_pkt_line(data, type: 'data-pkt')
  case type
  when 'data-pkt'
    generate_data_pkt(data)
  when 'flush-pkt'
    FLUSH_PKT 
  end
end

.get_pkt_line_data(pkt_line) ⇒ String

Reads a single pkt-line and returns the data

Parameters:

  • a (String)

    single pkt-line

Returns:

  • (String)

    the pkt-line data


59
60
61
62
63
64
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 59

def self.get_pkt_line_data(pkt_line)
  return '' unless pkt_line.kind_of?(String)

  line_len = pkt_line.length - 4
  pkt_line[4, line_len - 1]
end

.get_pkt_lines(data) ⇒ Array

Retrieves pkt-lines from argument supplied

Parameters:

  • data (String)

    that possibly contains pkt-lines

Returns:

  • (Array)

    pkt-lines


71
72
73
74
75
76
77
78
79
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 71

def self.get_pkt_lines(data)
  return [] if data.empty?

  pkt_lines = data.split("\n")
  pkt_lines.each { |line| line.gsub!(FLUSH_PKT, '') }
  pkt_lines.delete('')

  pkt_lines
end

.has_pkt_line_data?(data) ⇒ Boolean

Determine if data contains any pkt-lines

Parameters:

  • the (String)

    data to check for pkt-lines

Returns:

  • (Boolean)

86
87
88
89
90
91
92
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 86

def self.has_pkt_line_data?(data)
  return false unless data.kind_of?(String)

  return false if data.empty?

  get_pkt_lines(data).empty? ? false : true
end

.request_endsObject


50
51
52
# File 'lib/msf/core/exploit/git/pkt_line.rb', line 50

def self.request_ends
  [ "#{FLUSH_PKT}0009done", "#{FLUSH_PKT}0009#{FLUSH_PKT}" ]
end