Class: Arachni::Element::Link
- Includes:
- Capabilities::Analyzable, Capabilities::Auditable, Capabilities::Refreshable, Capabilities::Submittable, Capabilities::WithDOM
- Defined in:
- lib/arachni/element/link.rb,
lib/arachni/element/link/dom.rb,
lib/arachni/element/link/capabilities/with_dom.rb,
lib/arachni/element/link/capabilities/auditable.rb,
lib/arachni/element/link/capabilities/submittable.rb
Overview
Represents an auditable link element
Defined Under Namespace
Modules: Capabilities Classes: DOM
Constant Summary
Constants included from Capabilities::Auditable
Capabilities::Auditable::OPTIONS
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::Analyzable::Differential
Capabilities::Analyzable::Differential::DIFFERENTIAL_OPTIONS
Constants included from Capabilities::Analyzable::Taint
Capabilities::Analyzable::Taint::TAINT_OPTIONS
Instance Attribute Summary
Attributes included from Capabilities::Auditable
Attributes included from Capabilities::WithAuditor
Attributes included from Capabilities::Mutable
#affected_input_name, #format, #seed
Attributes included from Capabilities::Inputtable
Attributes included from Capabilities::WithDOM
Attributes included from Capabilities::Analyzable::Differential
#differential_analysis_options
Attributes included from Capabilities::Analyzable::Timeout
Attributes inherited from Base
#initialization_options, #page
Class Method Summary collapse
- .decode(*args) ⇒ Object
- .encode(*args) ⇒ Object
- .encode_query_params(param) ⇒ Object
-
.from_document(url, document) ⇒ Array<Link>
Extracts links from a document.
-
.from_response(response) ⇒ Array<Link>
Extracts links from an HTTP response.
Instance Method Summary collapse
- #decode(*args) ⇒ Object
- #encode(*args) ⇒ Object
- #encode_query_params(*args) ⇒ Object
- #id ⇒ Object
-
#initialize(options) ⇒ Link
constructor
A new instance of Link.
-
#simple ⇒ Hash
Simple representation of self in the form of ‘{ Capabilities::Submittable#action => Capabilities::Inputtable#inputs }`.
- #to_rpc_data ⇒ Object
-
#to_s ⇒ String
Absolute URL with a merged version of Capabilities::Submittable#action and Capabilities::Inputtable#inputs as a query.
Methods included from Capabilities::Auditable
#audit, #audit_id, #audit_status_message, #audit_status_message_action, #audit_verbose_message, #coverage_hash, #coverage_id, #dup, #matches_skip_like_blocks?, #reset, reset, #skip?, skip_like
Methods included from Capabilities::WithAuditor
#dup, #marshal_dump, #orphan?, #prepare_for_report, #remove_auditor
Methods included from Capabilities::Mutable
#affected_input_value, #affected_input_value=, #dup, #each_mutation, #immutables, #inspect, #mutation?, #mutations, #reset, #switch_method, #to_h
Methods included from Capabilities::Submittable
#action, #action=, #dup, #http, #method, #method=, #platforms, #submit, #to_h
Methods included from Capabilities::Inputtable
#[], #[]=, #changes, #dup, #has_inputs?, #inputtable_id, #reset, #to_h, #try_input, #update, #valid_input_data?, #valid_input_name?, #valid_input_name_data?, #valid_input_value?, #valid_input_value_data?
Methods included from Utilities
#available_port, #caller_name, #caller_path, #cookie_decode, #cookie_encode, #cookies_from_document, #cookies_from_file, #cookies_from_response, #exception_jail, #exclude_path?, #follow_protocol?, #form_decode, #form_encode, #forms_from_document, #forms_from_response, #full_and_absolute_url?, #generate_token, #get_path, #hms_to_seconds, #html_decode, #html_encode, #include_path?, #links_from_document, #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 included from Capabilities::WithDOM
Methods included from Capabilities::Refreshable
Methods included from Capabilities::Analyzable
has_timeout_candidates?, reset, timeout_audit_run
Methods included from Capabilities::Analyzable::Differential
#differential_analysis, #dup, reset
Methods included from Capabilities::Analyzable::Timeout
add_phase_2_candidate, candidates_include?, deduplicate, deduplicate?, do_not_deduplicate, #dup, #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::Taint
Methods inherited from Base
#==, #action, #dup, from_rpc_data, #hash, #marshal_dump, #marshal_load, #persistent_hash, #prepare_for_report, #reset, #to_h, #to_hash, #type, type, #url, #url=
Methods included from Capabilities::WithScope
Constructor Details
#initialize(options) ⇒ Link
Returns a new instance of Link.
40 41 42 43 44 45 |
# File 'lib/arachni/element/link.rb', line 40 def initialize( ) super( ) self.inputs = (self.inputs || {}).merge( [:inputs] || {} ) @default_inputs = self.inputs.dup.freeze end |
Class Method Details
.decode(*args) ⇒ Object
148 149 150 |
# File 'lib/arachni/element/link.rb', line 148 def decode( *args ) ::URI.decode( *args ) end |
.encode(*args) ⇒ Object
144 145 146 |
# File 'lib/arachni/element/link.rb', line 144 def encode( *args ) ::URI.encode( *args ) end |
.encode_query_params(param) ⇒ Object
140 141 142 |
# File 'lib/arachni/element/link.rb', line 140 def encode_query_params( param ) encode( encode( param.recode ), '=' ) end |
.from_document(url, document) ⇒ Array<Link>
Extracts links from a document.
116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 |
# File 'lib/arachni/element/link.rb', line 116 def from_document( url, document ) document = Nokogiri::HTML( document.to_s ) if !document.is_a?( Nokogiri::HTML::Document ) base_url = begin document.search( '//base[@href]' )[0]['href'] rescue url end document.search( '//a' ).map do |link| href = to_absolute( link['href'], base_url ) next if !href if (parsed_url = Arachni::URI( href )) next if parsed_url.scope.out? end new( url: url.freeze, action: href.freeze, source: link.to_html.freeze ) end.compact end |
Instance Method Details
#decode(*args) ⇒ Object
83 84 85 |
# File 'lib/arachni/element/link.rb', line 83 def decode( *args ) self.class.decode( *args ) end |
#encode(*args) ⇒ Object
75 76 77 |
# File 'lib/arachni/element/link.rb', line 75 def encode( *args ) self.class.encode( *args ) end |
#encode_query_params(*args) ⇒ Object
67 68 69 |
# File 'lib/arachni/element/link.rb', line 67 def encode_query_params( *args ) self.class.encode_query_params( *args ) end |
#id ⇒ Object
87 88 89 |
# File 'lib/arachni/element/link.rb', line 87 def id dom_data ? "#{super}:#{dom_data[:inputs].sort_by { |k,_| k }}" : super end |
#simple ⇒ Hash
Returns Simple representation of self in the form of ‘{ Capabilities::Submittable#action => Capabilities::Inputtable#inputs }`.
49 50 51 |
# File 'lib/arachni/element/link.rb', line 49 def simple { self.action => self.inputs } end |
#to_rpc_data ⇒ Object
91 92 93 94 95 |
# File 'lib/arachni/element/link.rb', line 91 def to_rpc_data data = super data.delete 'dom_data' data end |
#to_s ⇒ String
Returns Absolute URL with a merged version of Capabilities::Submittable#action and Capabilities::Inputtable#inputs as a query.
55 56 57 58 59 60 61 |
# File 'lib/arachni/element/link.rb', line 55 def to_s uri = uri_parse( self.action ).dup uri.query = self.inputs. map { |k, v| "#{encode_query_params(k)}=#{encode_query_params(v)}" }. join( '&' ) uri.to_s end |