Class: Arachni::Element::XML

Inherits:
Base show all
Includes:
Capabilities::Analyzable, Capabilities::Auditable, Capabilities::Auditable::Buffered, Capabilities::Auditable::LineBuffered, Capabilities::Submittable, Capabilities::WithSource, Capabilities::Inputtable, Capabilities::Mutable
Defined in:
lib/arachni/element/xml.rb,
lib/arachni/element/xml/capabilities/mutable.rb,
lib/arachni/element/xml/capabilities/inputtable.rb

Overview

Represents an auditable XML element

Author:

  • Tasos “Zapotek” Laskos <tasos.laskos@arachni-scanner.com>

Defined Under Namespace

Modules: Capabilities

Constant Summary

Constants included from Capabilities::Mutable

Capabilities::Mutable::EXTRA_NAME, Capabilities::Mutable::FUZZ_NAME, Capabilities::Mutable::FUZZ_NAME_VALUE, Capabilities::Mutable::MUTATION_OPTIONS

Constants included from Capabilities::Inputtable

Capabilities::Inputtable::INVALID_INPUT_DATA

Constants included from Capabilities::Inputtable

Capabilities::Inputtable::INPUTTABLE_CACHE

Constants included from Capabilities::Analyzable::Differential

Capabilities::Analyzable::Differential::DIFFERENTIAL_ALLOWED_STATUS, Capabilities::Analyzable::Differential::DIFFERENTIAL_OPTIONS

Constants included from Capabilities::Analyzable::Timeout

Capabilities::Analyzable::Timeout::TIMEOUT_OPTIONS

Constants included from Capabilities::Analyzable::Signature

Capabilities::Analyzable::Signature::FILE_SIGNATURES, Capabilities::Analyzable::Signature::FILE_SIGNATURES_PER_PLATFORM, Capabilities::Analyzable::Signature::LINE_BUFFER_SIZE, Capabilities::Analyzable::Signature::SIGNATURE_CACHE, Capabilities::Analyzable::Signature::SIGNATURE_OPTIONS, Capabilities::Analyzable::Signature::SOURCE_CODE_SIGNATURES_PER_PLATFORM

Constants included from Capabilities::Auditable::LineBuffered

Capabilities::Auditable::LineBuffered::DEFAULT_LINE_BUFFER_SIZE

Constants included from Capabilities::Auditable::Buffered

Capabilities::Auditable::Buffered::DEFAULT_BUFFER_SIZE

Constants included from Capabilities::Auditable

Capabilities::Auditable::OPTIONS

Constants inherited from Base

Base::MAX_SIZE

Instance Attribute Summary

Attributes included from Capabilities::Mutable

#affected_input_name, #format, #seed

Attributes included from Capabilities::Inputtable

#default_inputs, #inputs, #raw_inputs

Attributes included from Capabilities::WithSource

#source

Attributes included from Capabilities::Analyzable::Differential

#differential_analysis_options

Attributes included from Capabilities::Analyzable::Timeout

#timing_attack_remark_data

Attributes included from Capabilities::Auditable

#audit_options

Attributes included from Capabilities::WithAuditor

#auditor

Attributes inherited from Base

#initialization_options, #page

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Capabilities::Mutable

#affected_input_value, #affected_input_value=, #each_mutation, #immutables, #inspect, #mutation?, #mutations, #parameter_name_audit?, #reset, #switch_method, #to_h, #with_raw_payload, #with_raw_payload?

Methods included from Capabilities::Inputtable

#valid_input_data?, #valid_input_name?

Methods included from Capabilities::Inputtable

#[], #[]=, #changes, #has_inputs?, #inputtable_id, inputtable_id, #raw_input?, #reset, #to_h, #try_input, #update, #updated?, #valid_input_data?, #valid_input_name?, #valid_input_name_data?, #valid_input_value?, #valid_input_value_data?

Methods included from Capabilities::WithSource

#to_h

Methods included from Capabilities::Analyzable

has_timeout_candidates?, reset, timeout_audit_run

Methods included from Capabilities::Analyzable::Differential

#differential_analysis, reset

Methods included from Capabilities::Analyzable::Timeout

add_phase_2_candidate, candidates_include?, deduplicate, deduplicate?, do_not_deduplicate, #ensure_responsiveness, has_candidates?, payload_delay_from_options, reset, run, #timeout_analysis, timeout_from_options, #timeout_id, #timing_attack_probe, #timing_attack_verify

Methods included from Capabilities::Analyzable::Signature

#get_matches, #signature_analysis

Methods included from Capabilities::Submittable

#action, #action=, #http, #id, #method, #method=, #platforms, #submit, #to_h

Methods included from Capabilities::Auditable::LineBuffered

#line_buffered_audit

Methods included from Capabilities::Auditable::Buffered

#buffered_audit

Methods included from Capabilities::Auditable

#audit, #audit_id, #audit_status_message, #audit_status_message_action, #audit_verbose_message, #coverage_hash, #coverage_id, #matches_skip_like_blocks?, reset, #reset, #skip?, skip_like

Methods included from Capabilities::WithAuditor

#orphan?, #prepare_for_report, #remove_auditor

Methods included from Utilities

#available_port, available_port_mutex, #bytes_to_kilobytes, #bytes_to_megabytes, #caller_name, #caller_path, #cookie_decode, #cookie_encode, #cookies_from_file, #cookies_from_parser, #cookies_from_response, #exception_jail, #exclude_path?, #follow_protocol?, #form_decode, #form_encode, #forms_from_parser, #forms_from_response, #full_and_absolute_url?, #generate_token, #get_path, #hms_to_seconds, #html_decode, #html_encode, #include_path?, #links_from_parser, #links_from_response, #normalize_url, #page_from_response, #page_from_url, #parse_set_cookie, #path_in_domain?, #path_too_deep?, #port_available?, #rand_port, #random_seed, #redundant_path?, #regexp_array_match, #remove_constants, #request_parse_body, #seconds_to_hms, #skip_page?, #skip_path?, #skip_resource?, #skip_response?, #to_absolute, #uri_decode, #uri_encode, #uri_parse, #uri_parse_query, #uri_parser, #uri_rewrite

Methods inherited from Base

#==, #action, from_rpc_data, #hash, #id, #marshal_load, #persistent_hash, #prepare_for_report, #reset, #to_h, #to_hash, too_big?, #type, type, #url, #url=

Methods included from Capabilities::WithScope

#scope

Constructor Details

#initialize(options) ⇒ XML

Returns a new instance of XML.

Parameters:

Options Hash (options):

  • :url (String) —

    URL of the page which includes the link.

  • :action (String) —

    Link URL – defaults to `:url`.

  • :source (String) —

    XML data, to be parsed into inputs.

Raises:

  • (Error::MissingSource) —

    On missing `:source`.



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/arachni/element/xml.rb', line 42

def initialize( options )
    self.http_method = options[:method] || :post

    super( options )

    fail Arachni::Element::Capabilities::WithSource::Error::MissingSource if !@source

    @inputs = options[:inputs] || {}
    if @inputs.empty?
        # The ivar needs to be set first because it's used as an input name
        # validator by the setter later on.
        @inputs = self.class.parse_inputs( @source )
        self.inputs = @inputs
    end

    @default_inputs = self.inputs.dup.freeze
end

Class Method Details

.decode(v) ⇒ Object

No-op



126
127
128
 
# File 'lib/arachni/element/xml.rb', line 126

def decode( v )
    v
end

.encode(v) ⇒ Object

No-op



121
122
123
 
# File 'lib/arachni/element/xml.rb', line 121

def encode( v )
    v
end

.from_request(url, request) ⇒ XML?

Extracts XML elements from an HTTP request.

Parameters:

Returns:



135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/arachni/element/xml.rb', line 135

def from_request( url, request )
    return if !request.body.is_a?( String ) || request.body.empty?
    return if too_big?( request.body )

    data = parse_inputs( request.body )
    return if data.empty?

    new(
        url:    url,
        action: request.url,
        method: request.method,
        inputs: data,
        source: request.body
    )
end

.parse_inputs(doc) ⇒ Object 



151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
 
# File 'lib/arachni/element/xml.rb', line 151

def parse_inputs( doc )
    doc = doc.is_a?( Nokogiri::XML ) ? doc : Arachni::Parser.parse_xml( doc )

    inputs = {}
    doc.traverse do |node|
        if node.is_a?( Nokogiri::XML::Text ) && node.children.empty? &&
            node.parent.children.size == 1

            inputs[node.css_path] = node.content
        end

        if node.respond_to? :attributes
            node.attributes.each do |_, attribute|
                inputs[attribute.css_path] = attribute.content
            end
        end
    end

    inputs
end

Instance Method Details

#decode(*args) ⇒ Object

See Also:



98
99
100
 
# File 'lib/arachni/element/xml.rb', line 98

def decode( *args )
    self.class.decode( *args )
end

#dup ⇒ Object 



102
103
104
 
# File 'lib/arachni/element/xml.rb', line 102

def dup
    super.tap { |e| e.source = @source }
end

#encode(*args) ⇒ Object

See Also:



93
94
95
 
# File 'lib/arachni/element/xml.rb', line 93

def encode( *args )
    self.class.encode( *args )
end

#marshal_dump ⇒ Object 



112
113
114
115
116
 
# File 'lib/arachni/element/xml.rb', line 112

def marshal_dump
    d = super
    d.delete :@transform_xml
    d
end

#simple ⇒ Hash

Returns Simple representation of self in the form of `{ Capabilities::Submittable#action => Capabilities::Inputtable#inputs }`.

Returns:



88
89
90
 
# File 'lib/arachni/element/xml.rb', line 88

def simple
    { self.action => self.inputs }
end

#to_rpc_data ⇒ Object 



106
107
108
109
110
 
# File 'lib/arachni/element/xml.rb', line 106

def to_rpc_data
    d = super
    d.delete 'transform_xml'
    d
end

#to_s ⇒ Object 



82
83
84
 
# File 'lib/arachni/element/xml.rb', line 82

def to_s
    to_xml
end

#to_xml ⇒ String

Returns XML formatted Capabilities::Inputtable#inputs.

If a #transform_xml callback has been set, it will return its value.

Returns:



64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/arachni/element/xml.rb', line 64

def to_xml
    doc = Arachni::Parser.parse_xml( source ).dup

    inputs.each do |path, content|
        doc.css( path ).each do |node|
            node.content = content
        end
    end

    @transform_xml ? @transform_xml.call( doc.to_xml ) : doc.to_xml
end

#transform_xml(&block) ⇒ Object

Parameters:

  • block (Block) —

    Callback to intercept #to_xml's return value.



78
79
80
 
# File 'lib/arachni/element/xml.rb', line 78

def transform_xml( &block )
    @transform_xml = block
end