Class: Rex::Proto::Http::Request
- Defined in:
- lib/rex/proto/http/request.rb
Overview
HTTP request class.
Direct Known Subclasses
Defined Under Namespace
Constant Summary collapse
- PostRequests =
['POST', 'SEARCH']
Instance Attribute Summary collapse
-
#conn_id ⇒ Object
An identifier associated with the incoming request, can be used to match requests with sessions.
-
#junk_directories ⇒ Object
add junk directories.
-
#junk_end_of_uri ⇒ Object
add junk end of URI.
-
#junk_param_start ⇒ Object
add junk start of params.
-
#junk_params ⇒ Object
add junk params.
-
#junk_pipeline ⇒ Object
add junk pipeline requests.
-
#junk_self_referring_directories ⇒ Object
add junk self referring directories (aka /././././).
-
#junk_slashes ⇒ Object
add junk slashes.
-
#method ⇒ Object
The method being used for the request (e.g. GET).
-
#proto ⇒ Object
The protocol to be sent with the request.
-
#raw_uri ⇒ Object
The raw URI being requested, before any mucking gets to it.
-
#relative_resource ⇒ Object
The resource path relative to the root of a server mount point.
-
#uri_encode_mode ⇒ Object
encoding uri.
-
#uri_parts ⇒ Object
The split up parts of the URI.
Attributes inherited from Packet
#auto_cl, #body_bytes_left, #bufq, #chunk_max_size, #chunk_min_size, #compress, #error, #headers, #incomplete, #inside_chunk, #keepalive, #max_data, #state, #transfer_chunked
Instance Method Summary collapse
-
#body ⇒ Object
Returns a hijacked version of the body that shoves the request's query string in as a replacement in cases where there is no body.
-
#cmd_string ⇒ Object
Returns the command string derived from the three values.
-
#initialize(method = 'GET', uri = '/', proto = DefaultProtocol) ⇒ Request
constructor
Initializes an instance of an HTTP request with the supplied method, URI, and protocol.
-
#meta_vars ⇒ Object
Returns a hash of variables that contain information about the request, such as the remote host information.
-
#normalize!(str) ⇒ Integer
Normalize repeated slashes, /./, and /word/../ in place.
- #param_string ⇒ Object
-
#parse_cgi_qstring(str) ⇒ Object
Parses a CGI query string into the var/val combinations.
-
#qstring ⇒ Object
If there were CGI parameters in the URI, this will hold a hash of each variable to value.
-
#resource ⇒ Object
Returns the resource that is being requested.
-
#resource=(rsrc) ⇒ Object
Changes the resource URI.
-
#to_s ⇒ Object
Returns a request packet.
-
#update_cmd_parts(str) ⇒ Object
Updates the command parts for this specific packet type.
-
#update_uri_parts ⇒ Object
Split the URI into the resource being requested and its query string.
-
#uri ⇒ Object
Puts a URI back together based on the URI parts.
-
#uri=(str) ⇒ Object
Updates the underlying URI structure.
Methods inherited from Packet
#[], #[]=, #body=, #check_100, #chunk, #completed?, #from_s, #output_packet, #parse, #parse_body, #parse_header, #reset, #reset_except_queue, #to_terminal_output
Constructor Details
#initialize(method = 'GET', uri = '/', proto = DefaultProtocol) ⇒ Request
Initializes an instance of an HTTP request with the supplied method, URI, and protocol.
57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
# File 'lib/rex/proto/http/request.rb', line 57 def initialize(method = 'GET', uri = '/', proto = DefaultProtocol) super() self.method = method self.raw_uri = uri self.uri_parts = {} self.proto = proto || DefaultProtocol self.chunk_min_size = 1 self.chunk_max_size = 10 self.uri_encode_mode = 'hex-normal' if self.method == 'GET' || self.method == 'CONNECT' self.auto_cl = false end update_uri_parts end |
Instance Attribute Details
#conn_id ⇒ Object
An identifier associated with the incoming request, can be used to match requests with sessions.
328 329 330 |
# File 'lib/rex/proto/http/request.rb', line 328 def conn_id @conn_id end |
#junk_directories ⇒ Object
add junk directories
354 355 356 |
# File 'lib/rex/proto/http/request.rb', line 354 def junk_directories @junk_directories end |
#junk_end_of_uri ⇒ Object
add junk end of URI
372 373 374 |
# File 'lib/rex/proto/http/request.rb', line 372 def junk_end_of_uri @junk_end_of_uri end |
#junk_param_start ⇒ Object
add junk start of params
369 370 371 |
# File 'lib/rex/proto/http/request.rb', line 369 def junk_param_start @junk_param_start end |
#junk_params ⇒ Object
add junk params
363 364 365 |
# File 'lib/rex/proto/http/request.rb', line 363 def junk_params @junk_params end |
#junk_pipeline ⇒ Object
add junk pipeline requests
366 367 368 |
# File 'lib/rex/proto/http/request.rb', line 366 def junk_pipeline @junk_pipeline end |
#junk_self_referring_directories ⇒ Object
add junk self referring directories (aka /././././)
360 361 362 |
# File 'lib/rex/proto/http/request.rb', line 360 def junk_self_referring_directories @junk_self_referring_directories end |
#junk_slashes ⇒ Object
add junk slashes
357 358 359 |
# File 'lib/rex/proto/http/request.rb', line 357 def junk_slashes @junk_slashes end |
#method ⇒ Object
The method being used for the request (e.g. GET).
333 334 335 |
# File 'lib/rex/proto/http/request.rb', line 333 def method @method end |
#proto ⇒ Object
The protocol to be sent with the request.
346 347 348 |
# File 'lib/rex/proto/http/request.rb', line 346 def proto @proto end |
#raw_uri ⇒ Object
The raw URI being requested, before any mucking gets to it
337 338 339 |
# File 'lib/rex/proto/http/request.rb', line 337 def raw_uri @raw_uri end |
#relative_resource ⇒ Object
The resource path relative to the root of a server mount point.
351 352 353 |
# File 'lib/rex/proto/http/request.rb', line 351 def relative_resource @relative_resource end |
#uri_encode_mode ⇒ Object
encoding uri
375 376 377 |
# File 'lib/rex/proto/http/request.rb', line 375 def uri_encode_mode @uri_encode_mode end |
#uri_parts ⇒ Object
The split up parts of the URI.
342 343 344 |
# File 'lib/rex/proto/http/request.rb', line 342 def uri_parts @uri_parts end |
Instance Method Details
#body ⇒ Object
Returns a hijacked version of the body that shoves the request's query string in as a replacement in cases where there is no body. YOLO! (shrug)
275 276 277 278 279 280 281 |
# File 'lib/rex/proto/http/request.rb', line 275 def body str = super || '' if str.length == 0 && PostRequests.include?(self.method) str = param_string end str end |
#cmd_string ⇒ Object
Returns the command string derived from the three values.
286 287 288 289 290 |
# File 'lib/rex/proto/http/request.rb', line 286 def cmd_string proto_str = (self.proto =~ /^\d/) ? "HTTP/#{self.proto}" : self.proto "#{self.method} #{self.uri} #{proto_str}\r\n" end |
#meta_vars ⇒ Object
Returns a hash of variables that contain information about the request, such as the remote host information.
TODO
322 323 |
# File 'lib/rex/proto/http/request.rb', line 322 def end |
#normalize!(str) ⇒ Integer
Normalize repeated slashes, /./, and /word/../ in place.
120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 |
# File 'lib/rex/proto/http/request.rb', line 120 def normalize!(str) return 0 unless str.gsub!(NORMALIZE_PATTERN, '/') return 1 unless str.match?(NORMALIZE_PATTERN) result = str.byteslice(0, 0).b # UTF-8 and binary strings cannot contain a slash byte inside a character. # Track character boundaries for other non-ASCII multibyte encodings. separators = [] unless str.ascii_only? || str.encoding == ::Encoding::UTF_8 || str.encoding == ::Encoding::BINARY cursor = 0 str.scan(SPECIAL_SEGMENT_PATTERN) do match = Regexp.last_match start, finish = match.byteoffset(1) segment = match[1] append_normalized_chunk(result, str.byteslice(cursor, start - cursor), separators) if segment == '/../' slash = separators ? separators.last : result.rindex('/') if slash && result.byteslice(slash + 1, result.bytesize - slash - 1).match?(/\A\w+\z/) result.slice!(slash..) separators.pop if separators else separators << result.bytesize if separators result << '/..' end end # The lookahead allows the trailing slash to begin another match. cursor = finish - 1 end result << str.byteslice(cursor, str.bytesize - cursor).b str.replace(result.force_encoding(str.encoding)) 1 end |
#param_string ⇒ Object
220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 |
# File 'lib/rex/proto/http/request.rb', line 220 def param_string params=[] self.uri_parts['QueryString'].each_pair { |param, value| # inject a random number of params in between each param if self.junk_params rand(10)+5.times { params.push(Rex::Text.rand_text_alpha(rand(16) + 5) + '=' + Rex::Text.rand_text_alpha(rand(10) + 1)) } end if value.kind_of?(Array) value.each { |subvalue| params.push(Rex::Text.uri_encode(param, self.uri_encode_mode) + '=' + Rex::Text.uri_encode(subvalue, self.uri_encode_mode)) } else if !value.nil? params.push(Rex::Text.uri_encode(param, self.uri_encode_mode) + '=' + Rex::Text.uri_encode(value, self.uri_encode_mode)) else params.push(Rex::Text.uri_encode(param, self.uri_encode_mode)) end end } # inject some junk params at the end of the param list, just to be sure :P if self.junk_params rand(10)+5.times { params.push(Rex::Text.rand_text_alpha(rand(32) + 5) + '=' + Rex::Text.rand_text_alpha(rand(64) + 5)) } end params.join('&') end |
#parse_cgi_qstring(str) ⇒ Object
Parses a CGI query string into the var/val combinations.
380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 |
# File 'lib/rex/proto/http/request.rb', line 380 def parse_cgi_qstring(str) qstring = {} # Delimit on each variable str.split(/[;&]/).each { |vv| var = vv val = '' if (md = vv.match(/(.+?)=(.*)/)) var = md[1] val = md[2] end # Add the item to the hash with logic to convert values to an array # if so desired. if (qstring.include?(var)) if (qstring[var].kind_of?(Array)) qstring[var] << val else curr = self.qstring[var] qstring[var] = [ curr, val ] end else qstring[var] = val end } return qstring end |
#qstring ⇒ Object
If there were CGI parameters in the URI, this will hold a hash of each variable to value. If there is more than one value for a given variable, an array of each value is returned.
312 313 314 |
# File 'lib/rex/proto/http/request.rb', line 312 def qstring self.uri_parts['QueryString'] end |
#resource ⇒ Object
Returns the resource that is being requested.
295 296 297 |
# File 'lib/rex/proto/http/request.rb', line 295 def resource self.uri_parts['Resource'] end |
#resource=(rsrc) ⇒ Object
Changes the resource URI. This is used when making a request relative to a given mount point.
303 304 305 |
# File 'lib/rex/proto/http/request.rb', line 303 def resource=(rsrc) self.uri_parts['Resource'] = rsrc end |
#to_s ⇒ Object
Returns a request packet
258 259 260 261 262 263 264 265 266 267 268 269 |
# File 'lib/rex/proto/http/request.rb', line 258 def to_s str = '' if self.junk_pipeline host = '' if self.headers['Host'] host = "Host: #{self.headers['Host']}\r\n" end str << "GET / HTTP/1.1\r\n#{host}Connection: Keep-Alive\r\n\r\n" * self.junk_pipeline self.headers['Connection'] = 'Closed' end str + super end |
#update_cmd_parts(str) ⇒ Object
Updates the command parts for this specific packet type.
78 79 80 81 82 83 84 85 86 87 88 |
# File 'lib/rex/proto/http/request.rb', line 78 def update_cmd_parts(str) if (md = str.match(/^(.+?)\s+(.+?)\s+HTTP\/(.+?)\r?\n?$/i)) self.method = md[1] self.raw_uri = CGI.unescape(md[2]) self.proto = md[3] update_uri_parts else raise RuntimeError, "Invalid request command string", caller end end |
#update_uri_parts ⇒ Object
Split the URI into the resource being requested and its query string.
93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 |
# File 'lib/rex/proto/http/request.rb', line 93 def update_uri_parts # If it has a query string, get the parts. if ((self.raw_uri) and (md = self.raw_uri.match(/(.+?)\?(.*)$/))) self.uri_parts['QueryString'] = parse_cgi_qstring(md[2]) self.uri_parts['Resource'] = md[1] # Otherwise, just assume that the URI is equal to the resource being # requested. else self.uri_parts['QueryString'] = {} self.uri_parts['Resource'] = self.raw_uri end self.normalize!(resource) # Set the relative resource to the actual resource. self.relative_resource = resource end |
#uri ⇒ Object
Puts a URI back together based on the URI parts
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 |
# File 'lib/rex/proto/http/request.rb', line 167 def uri str = self.uri_parts['Resource'].dup || '/' # /././././ if self.junk_self_referring_directories str.gsub!('/') { '/.' * (rand(3) + 1) + '/' } end # /%3faaa=bbbbb # which could possibly decode to "/?aaa=bbbbb", which if the IDS normalizes first, then splits the URI on ?, then it can be bypassed if self.junk_param_start str.sub!('/', '/%3f' + Rex::Text.rand_text_alpha(rand(5) + 1) + '=' + Rex::Text.rand_text_alpha(rand(10) + 1) + '/../') end # /RAND/../RAND../ if self.junk_directories str.gsub!('/') { dirs = '' (rand(5)+5).times { dirs << '/' + Rex::Text.rand_text_alpha(rand(5) + 1) + '/..' } dirs + '/' } end # //// # # NOTE: this must be done after all other odd directory junk, since they would cancel this out, except junk_end_of_uri, since that a specific slash in a specific place if self.junk_slashes str.gsub!('/') { '/' * (rand(3) + 2) } str.sub!(/^[\/]+/, '/') # only one beginning slash! end # /%20HTTP/1.0%0d%0a/../../ # which decodes to "/ HTTP/1.0\r\n" if self.junk_end_of_uri str.sub!(/^\//, '/%20HTTP/1.0%0d%0a/../../') end Rex::Text.uri_encode(str, self.uri_encode_mode) if !PostRequests.include?(self.method) if param_string.size > 0 str << '?' + param_string end end str end |
#uri=(str) ⇒ Object
Updates the underlying URI structure
252 253 254 255 |
# File 'lib/rex/proto/http/request.rb', line 252 def uri=(str) self.raw_uri = str update_uri_parts end |