passivetotal 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: d1844555714450cff7c7fdf042d3bd9888e300eb
4
- data.tar.gz: a1b743c9a386b12981e533cbbcdfcd60568bcede
3
+ metadata.gz: 3a5c4295b8d9ad1670b868891fe25e1bdefd0b49
4
+ data.tar.gz: 1900ed9a136ea09cf7756f7119a4a59338ddc729
5
5
  SHA512:
6
- metadata.gz: b154abc61be44ad6be8b96afcdaff311022d18722f26192d6cb498a31f872be038c7ffec72a5a8b1255ca378d30271b32419ea89282a3c514e9dc47c89cb92ba
7
- data.tar.gz: 51432b063381d9169e6694577ff42eec84b7f58ca5dddfebcb767fdb4958fa715663193e7e162cfd477f3cc31f7f53a9981c113b29ddee9fcb0b157c448b294d
6
+ metadata.gz: 7aa3c8d247c8388b3f7b0c46b88cacc10110af9418b59937e850c6442db1990ee16f6a02fdcee9d561e37af989164a01aacb9205c12d7c4a3df0bd371c3ad74a
7
+ data.tar.gz: 06de2d45b2f0ad06af9ec828ec5029fe75900635084124ab0d5d069b16e5edb9b07435b073ac4b1753a8e2045943df9fedd3359fb1c677dd40ba94866ee10602
data/README.md CHANGED
@@ -41,11 +41,13 @@ Included in the gem is a command-line tool, passivetotal, with the following usa
41
41
  -H <ip or hash> Queries for SSL certificate history associated with a given IP or SHA-1 hash
42
42
  -T <ip or dom> Queries for Tracker information associated with a given IP or domain
43
43
  -o <ip or dom> Queries for OSINT on a given IP or domain
44
+ -M <ip or dom> Queries for Malware sample records for a given IP or domain
44
45
  SETTING VALUES -i <value> Sets the value, used in conjuntion with -c, -t, -e, -w, -d, or -x
45
46
  Valid values for -i depend on what it's used with:
46
47
  -c : malicious, non-malicious, suspicious, unknown
47
48
  -t : <a tag name consisting of characters: [a-zA-Z_]>
48
49
  -e, -w, -d, -x: true, false
50
+
49
51
  ## Usage
50
52
 
51
53
  # Initialize the API wrapper with an apikey (using the default endpoint URL of https://api.passivetotal.org/v2/)
@@ -61,7 +63,7 @@ Included in the gem is a command-line tool, passivetotal, with the following usa
61
63
  # query passive DNS results for the ipv4 address, 107.170.89.121
62
64
  res << @pt.passive('107.170.89.121')
63
65
  # query for subdomains of passivetotal.org
64
- #res << @pt.subdomains('passivetotal.org')
66
+ res << @pt.subdomains('*.passivetotal.org')
65
67
  # query for unique IPv4 resolutions of passivetotal.org
66
68
  res << @pt.unique('passivetotal.org')
67
69
  # query for the classification of www.passivetotal.org
@@ -98,6 +100,10 @@ Included in the gem is a command-line tool, passivetotal, with the following usa
98
100
  res << @pt.ssl_certificate_history('e9a6647d6aba52dc47b3838c920c9ee59bad7034')
99
101
  # retrieve certificate history from IPv4 address of 52.8.228.23
100
102
  res << @pt.ssl_certificate_history('52.8.228.23')
103
+ # query for malware sample records by the domain "noorno.com"
104
+ res << @pt.malware("noorno.com")
105
+ # query for malware sample records by the ip addres 98.124.243.47
106
+ res << @pt.malware("98.124.243.47")
101
107
  # dump all this glorious information to feast your eyes upon
102
108
  pp res
103
109
 
@@ -330,7 +330,17 @@ module PassiveTotal # :nodoc:
330
330
  get('trackers/search', {'query' => query, 'type' => type})
331
331
  end
332
332
  end
333
-
333
+
334
+ # malware: get sample information based from domain
335
+ # query: ip or domain
336
+ def malware(query)
337
+ is_valid_with_error(__method__, [:ipv4, :domain], query)
338
+ if domain?(query)
339
+ query = normalize_domain(query)
340
+ end
341
+ get('enrichment/malware', {'query' => query})
342
+ end
343
+
334
344
  private
335
345
 
336
346
  # returns true if the given string is a dotted quad IPv4 address
@@ -35,6 +35,7 @@ module PassiveTotal # :nodoc:
35
35
  [ '--ssl_history', '-H', GetoptLong::REQUIRED_ARGUMENT ],
36
36
  [ '--trackers', '-T', GetoptLong::REQUIRED_ARGUMENT ],
37
37
  [ '--osint', '-o', GetoptLong::REQUIRED_ARGUMENT ],
38
+ [ '--malware', '-M', GetoptLong::REQUIRED_ARGUMENT ],
38
39
  [ '--set', '-i', GetoptLong::REQUIRED_ARGUMENT ]
39
40
  )
40
41
 
@@ -96,6 +97,9 @@ module PassiveTotal # :nodoc:
96
97
  when '--osint'
97
98
  options[:method] = :osint
98
99
  options[:query] = arg
100
+ when '--malware'
101
+ options[:method] = :malware
102
+ options[:query] = arg
99
103
  when '--set'
100
104
  options[:set] = arg.dup
101
105
  else
@@ -149,6 +153,7 @@ module PassiveTotal # :nodoc:
149
153
  help_text << " -H <ip or hash> Queries for SSL certificate history associated with a given IP or SHA-1 hash\n"
150
154
  help_text << " -T <ip or dom> Queries for Tracker information associated with a given IP or domain\n"
151
155
  help_text << " -o <ip or dom> Queries for OSINT on a given IP or domain\n"
156
+ help_text << " -M <ip or dom> Queries for Malware sample records for a given IP or domain\n"
152
157
  help_text << "SETTING VALUES"
153
158
  help_text << " -i <value> Sets the value, used in conjuntion with -c, -t, -e, -w, -d, or -x\n"
154
159
  help_text << " Valid values for -i depend on what it's used with:\n"
@@ -1,3 +1,3 @@
1
1
  module PassiveTotal
2
- VERSION = "1.0.0"
2
+ VERSION = "1.0.1"
3
3
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: passivetotal
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.0
4
+ version: 1.0.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - chrislee35