Class: Mihari::Analyzers::SecurityTrails

Inherits:
Base show all
Includes:
Concerns::Refangable
Defined in:
lib/mihari/analyzers/securitytrails.rb

Overview

SecurityTrails

Constant Summary

Constants included from Concerns::Retriable

Concerns::Retriable::DEFAULT_CONDITION, Concerns::Retriable::RETRIABLE_ERRORS

Instance Attribute Summary collapse

Attributes inherited from Mihari::Actor

#options

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Concerns::Refangable

#refang

Methods inherited from Base

#call, from_params, #ignore_error?, inherited, #normalized_artifacts, #pagination_interval, #pagination_limit, #parallel?, #result, #truncated_query

Methods inherited from Mihari::Actor

#call, configuration_keys, key, keys, #result, #retry_exponential_backoff, #retry_interval, #retry_times, #timeout, type, #validate_configuration!

Methods included from Concerns::Retriable

#retry_on_error

Methods included from Concerns::Configurable

#configuration_keys?, #configured?

Constructor Details

#initialize(query, options: nil, api_key: nil) ⇒ SecurityTrails

Returns a new instance of SecurityTrails.

Parameters:

  • query (String)
  • options (Hash, nil) (defaults to: nil)
  • api_key (String, nil) (defaults to: nil) 


25
26
27
28
29
30
31
 
# File 'lib/mihari/analyzers/securitytrails.rb', line 25

def initialize(query, options: nil, api_key: nil)
  super(refang(query), options:)

  @type = DataType.type(query)

  @api_key = api_key || Mihari.config.securitytrails_api_key
end

Instance Attribute Details

#api_key ⇒ String? (readonly)

Returns:

  • (String, nil) 


15
16
17
 
# File 'lib/mihari/analyzers/securitytrails.rb', line 15

def api_key
  @api_key
end

#query ⇒ String (readonly)

Returns:

  • (String) 


18
19
20
 
# File 'lib/mihari/analyzers/securitytrails.rb', line 18

def query
  @query
end

#type ⇒ String? (readonly)

Returns:

  • (String, nil) 


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

def type
  @type
end

Class Method Details

.key_aliases ⇒ Array<String>?

Returns:

  • (Array<String>, nil) 


50
51
52
 
# File 'lib/mihari/analyzers/securitytrails.rb', line 50

def key_aliases
  ["st"]
end

Instance Method Details

#artifacts ⇒ Object 



33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/mihari/analyzers/securitytrails.rb', line 33

def artifacts
  case type
  when "domain"
    domain_search
  when "ip"
    ip_search
  when "mail"
    mail_search
  else
    raise ValueError, "#{query}(type: #{type || "unknown"}) is not supported." unless valid_type?
  end
end