Class: Mihari::Analyzers::Urlscan

Inherits:
Base
  • Object
show all
Defined in:
lib/mihari/analyzers/urlscan.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Base

inherited, #run, #run_emitter, #source

Methods included from Retriable

#retry_on_error

Methods included from Configurable

#config_keys, #configuration_status, #configured?

Constructor Details

#initialize(query, title: nil, description: nil, tags: [], target_type: "url") ⇒ Urlscan

Returns a new instance of Urlscan.

Raises:



14
15
16
17
18
19
20
21
22
23
24
 
# File 'lib/mihari/analyzers/urlscan.rb', line 14

def initialize(query, title: nil, description: nil, tags: [], target_type: "url")
  super()

  @query = query
  @title = title || "urlscan lookup"
  @description = description || "query = #{query}"
  @tags = tags
  @target_type = target_type

  raise InvalidInputError, "type should be url, domain or ip." unless valid_target_type?
end

Instance Attribute Details

#description ⇒ Object (readonly)

Returns the value of attribute description.



9
10
11
 
# File 'lib/mihari/analyzers/urlscan.rb', line 9

def description
  @description
end

#query ⇒ Object (readonly)

Returns the value of attribute query.



10
11
12
 
# File 'lib/mihari/analyzers/urlscan.rb', line 10

def query
  @query
end

#tags ⇒ Object (readonly)

Returns the value of attribute tags.



11
12
13
 
# File 'lib/mihari/analyzers/urlscan.rb', line 11

def tags
  @tags
end

#target_type ⇒ Object (readonly)

Returns the value of attribute target_type.



12
13
14
 
# File 'lib/mihari/analyzers/urlscan.rb', line 12

def target_type
  @target_type
end

#title ⇒ Object (readonly)

Returns the value of attribute title.



8
9
10
 
# File 'lib/mihari/analyzers/urlscan.rb', line 8

def title
  @title
end

Instance Method Details

#artifacts ⇒ Object 



26
27
28
29
30
31
32
33
34
 
# File 'lib/mihari/analyzers/urlscan.rb', line 26

def artifacts
  result = search
  return [] unless result

  results = result.dig("results") || []
  results.map do |match|
    match.dig "page", target_type
  end.compact.uniq
end