ronin-support 1.0.0.beta3 → 1.0.1

data/lib/ronin/support/encoding/xml.rb

@@ -163,7 +163,7 @@ module Ronin
               if zero_pad then "&#x%.7x;" % byte
               else             "&#x%.2x;" % byte
               end
-            when
+            else
               raise(ArgumentError,"case (#{kwargs[:case].inspect}) keyword argument must be either :lower, :upper, or nil")
             end
           else
@@ -320,7 +320,7 @@ module Ronin
                            ESCAPED_CHARS.fetch(named_char.downcase)
                          elsif (decimal_char = scanner.scan(/&#\d+;/))
                            decimal_char[2..-2].to_i.chr(Encoding::UTF_8)
-                         elsif (hex_char = scanner.scan(/&#x[a-f0-9]+;/i))
+                         elsif (hex_char     = scanner.scan(/&#x[a-f0-9]+;/i))
                            hex_char[3..-2].to_i(16).chr(Encoding::UTF_8)
                          else
                            scanner.getch

data/lib/ronin/support/encoding.rb

@@ -38,6 +38,101 @@ module Ronin
     #
     # Contains additional encoding/decoding modules.
     #
+    # ## Core-Ext Methods
+    #
+    # * {Integer#c_encode}
+    # * {Integer#c_escape}
+    # * {Integer#hex_encode}
+    # * {Integer#hex_escape}
+    # * {Integer#hex_int}
+    # * {Integer#html_encode}
+    # * {Integer#html_escape}
+    # * {Integer#http_encode}
+    # * {Integer#http_escape}
+    # * {Integer#js_encode}
+    # * {Integer#js_escape}
+    # * {Integer#powershell_encode}
+    # * {Integer#powershell_escape}
+    # * {Integer#shell_encode}
+    # * {Integer#shell_escape}
+    # * {Integer#uri_encode}
+    # * {Integer#uri_escape}
+    # * {Integer#uri_form_encode}
+    # * {Integer#uri_form_escape}
+    # * {Integer#xml_encode}
+    # * {Integer#xml_escape}
+    # * {String#base16_decode}
+    # * {String#base16_encode}
+    # * {String#base32_decode}
+    # * {String#base32_encode}
+    # * {String#base64_decode}
+    # * {String#base64_encode}
+    # * {String#c_encode}
+    # * {String#c_escape}
+    # * {String#c_string}
+    # * {String#c_unescape}
+    # * {String#c_unquote}
+    # * {String#hex_decode}
+    # * {String#hex_encode}
+    # * {String#hex_escape}
+    # * {String#hex_string}
+    # * {String#hex_unescape}
+    # * {String#hex_unquote}
+    # * {String#html_decode}
+    # * {String#html_encode}
+    # * {String#html_escape}
+    # * {String#html_unescape}
+    # * {String#http_decode}
+    # * {String#http_encode}
+    # * {String#http_escape}
+    # * {String#http_unescape}
+    # * {String#js_decode}
+    # * {String#js_encode}
+    # * {String#js_escape}
+    # * {String#js_string}
+    # * {String#js_unescape}
+    # * {String#js_unquote}
+    # * {String#powershell_decode}
+    # * {String#powershell_encode}
+    # * {String#powershell_escape}
+    # * {String#powershell_string}
+    # * {String#powershell_unescape}
+    # * {String#powershell_unquote}
+    # * {String#punycode_decode}
+    # * {String#punycode_encode}
+    # * {String#quoted_printable_escape}
+    # * {String#quoted_printable_unescape}
+    # * {String#ruby_decode}
+    # * {String#ruby_encode}
+    # * {String#ruby_escape}
+    # * {String#ruby_string}
+    # * {String#ruby_unescape}
+    # * {String#ruby_unquote}
+    # * {String#shell_decode}
+    # * {String#shell_encode}
+    # * {String#shell_escape}
+    # * {String#shell_string}
+    # * {String#shell_unescape}
+    # * {String#shell_unquote}
+    # * {String#sql_decode}
+    # * {String#sql_encode}
+    # * {String#sql_escape}
+    # * {String#sql_unescape}
+    # * {String#uri_decode}
+    # * {String#uri_encode}
+    # * {String#uri_escape}
+    # * {String#uri_form_decode}
+    # * {String#uri_form_encode}
+    # * {String#uri_form_escape}
+    # * {String#uri_form_unescape}
+    # * {String#uri_unescape}
+    # * {String#uu_decode}
+    # * {String#uu_encode}
+    # * {String#xml_decode}
+    # * {String#xml_encode}
+    # * {String#xml_escape}
+    # * {String#xml_unescape}
+    #
     # @since 1.0.0
     #
     class Encoding < ::Encoding

data/lib/ronin/support/network/asn/list.rb

@@ -145,6 +145,7 @@ module Ronin
               begin
                 download(url: url, path: path)
               rescue
+                # ignore any network failures
               end
             end
           end
@@ -176,8 +177,10 @@ module Ronin
               line.chomp!
 
               first, last, number, country_code, name = line.split("\t",5)
+
               range  = IPRange::Range.new(first,last)
               number = number.to_i
+
               country_code = nil if country_code == 'None'
               name         = nil if name         == 'Not routed'
 
@@ -219,7 +222,9 @@ module Ronin
             prefixes = if record.range.ipv6? then @ipv6_prefixes
                        else                       @ipv4_prefixes
                        end
-            (prefixes[record.range.prefix] ||= []) << record
+
+            records = (prefixes[record.range.prefix] ||= [])
+            records << record
             return self
           end
 

data/lib/ronin/support/network/asn/record.rb

@@ -20,6 +20,9 @@ module Ronin
   module Support
     module Network
       module ASN
+        #
+        # Represents an individual ASN record.
+        #
         class Record
 
           # The ASN number.

data/lib/ronin/support/network/asn/record_set.rb

@@ -22,6 +22,9 @@ module Ronin
   module Support
     module Network
       module ASN
+        #
+        # A sub-set of ASN records.
+        #
         class RecordSet
 
           include Enumerable

data/lib/ronin/support/network/asn.rb

@@ -27,6 +27,83 @@ module Ronin
       #
       # Handles Autonomous System Numbers (ASN).
       #
+      # ## Example
+      #
+      # Query the ASN record for a given IP address:
+      #
+      #     Network::ASN.query('4.2.2.1')
+      #     # =>
+      #     # #<Ronin::Support::Network::ASN::DNSRecord:0x00007f34424f4ac0
+      #     #  @country_code="US",
+      #     #  @name=nil,
+      #     #  @number=3356,
+      #     #  @range=#<Ronin::Support::Network::IPRange::CIDR: 4.0.0.0/9>>
+      #
+      # Query all ASN records for the given ISP name:
+      #
+      #     Network::ASN.list.name('LEVEL3').to_a
+      #     # => [#<Ronin::Support::Network::ASN::Record:0x00007f344164ed18
+      #     #      @country_code="US",
+      #     #      @name="LEVEL3",
+      #     #      @number=3356,
+      #     #      @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>,
+      #     #     #<Ronin::Support::Network::ASN::Record:0x00007f344164d828
+      #     #      @country_code="US",
+      #     #      @name="LEVEL3",
+      #     #      @number=3356,
+      #     #      @range=#<Ronin::Support::Network::IPRange::Range: 4.23.90.0 - 4.23.91.255>>,
+      #     #     ...]
+      #
+      # Query all IPv6 ASN records for a given company:
+      #
+      #     Network::ASN.list.name('GOOGLE').ipv6
+      #     # =>
+      #     # [#<Ronin::Support::Network::ASN::Record:0x00007fc45b411500
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:: - 2001:4860:1024:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b428d68
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:1026:: - 2001:4860:4804:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b44be08
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4806:: - 2001:4860:4864:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b4562e0
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4865:: - 2001:4860:ffff:ffff:ffff:ffff:ffff:ffff>>]
+      #
+      # Return all ASN numbers for a country:
+      #
+      #     Network::ASN.list.country('NZ').numbers
+      #     # => #<Set:
+      #     #     {45177,
+      #     #      55759,
+      #     #      55850,
+      #     #      9500,
+      #     #      ...}>
+      #
+      # Return all ASN names for a country:
+      #
+      #     Network::ASN.list.country_code('NZ').names
+      #     # Network::ASN.list.country('NZ').names
+      #     # =>
+      #     # #<Set:
+      #     #  {"DEVOLI-AS-AP Devoli",
+      #     #   "MFAT-NET-NZ 195 Lambton Quay",
+      #     #   "MERCURYNZ-AS-AP Mercury NZ Limited",
+      #     #   ...}>
+      #
       # @api public
       #
       # @since 1.0.0
@@ -45,6 +122,15 @@ module Ronin
         #   Performs rDNS queries using `*.nmap.asn.cymru.com` for IPv4
         #   addresses and `*.nmap6.asn.cymru.com` for IPv6 addresses.
         #
+        # @example
+        #   Network::ASN.query('4.2.2.1')
+        #   # =>
+        #   # #<Ronin::Support::Network::ASN::DNSRecord:0x00007f34424f4ac0
+        #   #  @country_code="US",
+        #   #  @name=nil,
+        #   #  @number=3356,
+        #   #  @range=#<Ronin::Support::Network::IPRange::CIDR: 4.0.0.0/9>>
+        #
         def self.query(ip)
           ip = IPAddr.new(ip) unless ip.kind_of?(IPAddr)
 
@@ -62,8 +148,9 @@ module Ronin
             return nil
           end
 
-          asn, cidr_range, country_code, *rest = string.split(' | ',5)
-          asn = asn.to_i
+          asn, cidr_range, country_code, *_rest = string.split(' | ',5)
+
+          asn        = asn.to_i
           cidr_range = IPRange::CIDR.new(cidr_range)
 
           return DNSRecord.new(asn,cidr_range,country_code)
@@ -76,11 +163,85 @@ module Ronin
         # @return [List]
         #   The loaded list file.
         #
+        # @note
+        #   The first access of {list} will take a while, as the entire ASN
+        #   list will need to be downloaded and parsed.
+        #
+        # @example Query the ASN record for the given IP address:
+        #   Network::ASN.list.ip('4.2.2.1')
+        #   # =>
+        #   # #<Ronin::Support::Network::ASN::Record:0x00007fc46207f818
+        #   #  @country_code="US",
+        #   #  @name="LEVEL3",
+        #   #  @number=3356,
+        #   #  @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>
+        #
+        # @example Query all ASN records for the given ISP name:
+        #   Network::ASN.list.name('LEVEL3').to_a
+        #   # => [#<Ronin::Support::Network::ASN::Record:0x00007f344164ed18
+        #   #      @country_code="US",
+        #   #      @name="LEVEL3",
+        #   #      @number=3356,
+        #   #      @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>,
+        #   #     #<Ronin::Support::Network::ASN::Record:0x00007f344164d828
+        #   #      @country_code="US",
+        #   #      @name="LEVEL3",
+        #   #      @number=3356,
+        #   #      @range=#<Ronin::Support::Network::IPRange::Range: 4.23.90.0 - 4.23.91.255>>,
+        #   #     ...]
+        #
+        # @example Query all IPv6 ASN records for a given company:
+        #   Network::ASN.list.name('GOOGLE').ipv6
+        #   # =>
+        #   # [#<Ronin::Support::Network::ASN::Record:0x00007fc45b411500
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:: - 2001:4860:1024:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b428d68
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:1026:: - 2001:4860:4804:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b44be08
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4806:: - 2001:4860:4864:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b4562e0
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4865:: - 2001:4860:ffff:ffff:ffff:ffff:ffff:ffff>>]
+        #
+        # @example Return all ASN numbers for a country:
+        #   Network::ASN.list.country('NZ').numbers
+        #   # => #<Set:
+        #   #     {45177,
+        #   #      55759,
+        #   #      55850,
+        #   #      9500,
+        #   #      ...}>
+        #
+        # @example Return all ASN names for a country:
+        #   Network::ASN.list.country_code('NZ').names
+        #   # Network::ASN.list.country('NZ').names
+        #   # =>
+        #   # #<Set:
+        #   #  {"DEVOLI-AS-AP Devoli",
+        #   #   "MFAT-NET-NZ 195 Lambton Quay",
+        #   #   "MERCURYNZ-AS-AP Mercury NZ Limited",
+        #   #   ...}>
+        #
         def self.list
-          @list ||= (
-            List.update
-            List.load_file
-          )
+          @list ||= begin
+                      List.update
+                      List.load_file
+                    end
         end
       end
     end

data/lib/ronin/support/network/dns/resolver.rb

@@ -90,6 +90,7 @@ module Ronin
             begin
               @resolver.getaddress(host).to_s
             rescue Resolv::ResolvError
+              # ignore any Resolv failures
             end
           end
 
@@ -123,6 +124,7 @@ module Ronin
           def get_name(ip)
             @resolver.getname(ip).to_s
           rescue Resolv::ResolvError
+            # ignore any Resolv failures
           end
 
           #
@@ -189,6 +191,7 @@ module Ronin
             begin
               @resolver.getresource(name,record_class)
             rescue Resolv::ResolvError
+              # ignore any Resolv failures
             end
           end
 

data/lib/ronin/support/network/domain.rb

@@ -33,31 +33,31 @@ module Ronin
       #     # => #<Ronin::Support::Network::IP: 192.30.255.113>
       #     domain.mailservers
       #     # => ["aspmx.l.google.com",
-      #           "alt3.aspmx.l.google.com",
-      #           "alt4.aspmx.l.google.com",
-      #           "alt1.aspmx.l.google.com",
-      #           "alt2.aspmx.l.google.com"]
+      #     #     "alt3.aspmx.l.google.com",
+      #     #     "alt4.aspmx.l.google.com",
+      #     #     "alt1.aspmx.l.google.com",
+      #     #     "alt2.aspmx.l.google.com"]
       #     domain.nameservers
       #     # => ["dns1.p08.nsone.net",
-      #           "dns2.p08.nsone.net",
-      #           "dns3.p08.nsone.net",
-      #           "dns4.p08.nsone.net",
-      #           "ns-1283.awsdns-32.org",
-      #           "ns-1707.awsdns-21.co.uk",
-      #           "ns-421.awsdns-52.com",
-      #           "ns-520.awsdns-01.net"]
+      #     #     "dns2.p08.nsone.net",
+      #     #     "dns3.p08.nsone.net",
+      #     #     "dns4.p08.nsone.net",
+      #     #     "ns-1283.awsdns-32.org",
+      #     #     "ns-1707.awsdns-21.co.uk",
+      #     #     "ns-421.awsdns-52.com",
+      #     #     "ns-520.awsdns-01.net"]
       #     domain.txt_strings
       #     # => ["v=spf1 ip4:192.30.252.0/22 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:spf.protection.outlook.com include:mail.zendesk.com include:_spf.salesforce.com include:servers.mcsv.net ip4:166.78.69.169 ip4:1",
-      #           "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
-      #           "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
-      #           "MS=ms44452932",
-      #           "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
-      #           "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
-      #           "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
-      #           "MS=ms58704441",
-      #           "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
-      #           "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
-      #           "apple-domain-verification=RyQhdzTl6Z6x8ZP4"]
+      #     #     "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
+      #     #     "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
+      #     #     "MS=ms44452932",
+      #     #     "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
+      #     #     "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
+      #     #     "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
+      #     #     "MS=ms58704441",
+      #     #     "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
+      #     #     "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
+      #     #     "apple-domain-verification=RyQhdzTl6Z6x8ZP4"]
       #
       # @api public
       #

data/lib/ronin/support/network/email_address.rb

@@ -232,8 +232,6 @@ module Ronin
           return new(name: name, **parse_address(address))
         end
 
-        private
-
         #
         # Parses the address portion of an email address.
         #
@@ -326,8 +324,6 @@ module Ronin
           return {domain: domain, address: address}
         end
 
-        public
-
         # Email address de-obfuscation rules.
         DEOBFUSCATIONS = {
           /\s+@\s+/                 => '@',
@@ -425,7 +421,7 @@ module Ronin
 
         # Email address obfuscation rules.
         OBFUSCATIONS = [
-          [/\@/, {'@' => ' @ '  }],
+          [/\@/, {'@' => ' @ '   }],
           [/\@/, {'@' => ' AT '  }],
           [/\@/, {'@' => ' at '  }],
           [/\@/, {'@' => '[AT]'  }],

data/lib/ronin/support/network/esmtp/mixin.rb

@@ -104,6 +104,7 @@ module Ronin
               end
             else
               smtp = smtp_connect(host,**kwargs)
+
               smtp.esmtp = true
               return smtp
             end

data/lib/ronin/support/network/ftp/mixin.rb

@@ -86,8 +86,8 @@ module Ronin
                                 account:  nil,
                                 passive:  true)
             host = DNS::IDN.to_ascii(host)
+            ftp  = Net::FTP.new
 
-            ftp = Net::FTP.new
             ftp.connect(host,port)
             ftp.login(user,password,account)
             ftp.passive = passive