metasploit-framework/lib/rex/sslscan/scanner.rb

require 'rex/socket'
require 'rex/sslscan/result'

module Rex::SSLScan

class Scanner

	attr_accessor :context
	attr_accessor :host
	attr_accessor :port
	attr_accessor :timeout
	
	attr_reader :supported_versions

	# Initializes the scanner object
	# @param host [String] IP address or hostname to scan
	# @param port [Fixnum] Port number to scan, default: 443
	# @param timeout [Fixnum] Timeout for connections, in seconds. default: 2
	# @raise [StandardError] Raised when the configuration is invalid
	def initialize(host,port = 443,context = {},timeout=2)
		@host       = host
		@port       = port
		@timeout    = timeout
		@context    = context
		@supported_versions = [:SSLv2, :SSLv3, :TLSv1]
		raise StandardError, "The scanner configuration is invalid" unless valid?
	end

	# Checks whether the scanner option has a valid configuration
	# @return [Boolean] True or False, the configuration is valid.
	def valid?
		begin
			@host = Rex::Socket.getaddress(@host, true)
		rescue
			return false
		end
		return false unless @port.kind_of? Fixnum
		return false unless @port >= 0 and @port <= 65535
		return false unless @timeout.kind_of? Fixnum
		return true
	end

	# Initiate the Scan against the target. Will test each cipher one at a time.
	# @return [Result] object containing the details of the scan
	def scan
		scan_result = Rex::SSLScan::Result.new
		@supported_versions.each do |ssl_version|
			sslctx = OpenSSL::SSL::SSLContext.new(ssl_version)
			sslctx.ciphers.each do |cipher_name, ssl_ver, key_length, alg_length|
				status = test_cipher(ssl_version, cipher_name)
				scan_result.add_cipher(ssl_version, cipher_name, key_length, status)
				if status == :accepted and scan_result.cert.nil?
					scan_result.cert = get_cert(ssl_version, cipher_name)
				end
			end
		end
		scan_result
	end

	# Tests the specified SSL Version and Cipher against the configured target
	# @param ssl_version [Symbol] The SSL version to use (:SSLv2,  :SSLv3, :TLSv1)
	# @param cipher [String] The SSL Cipher to use
	# @return [Symbol] Either :accepted or :rejected
	def test_cipher(ssl_version, cipher)
		validate_params(ssl_version,cipher)
		begin
			scan_client = Rex::Socket::Tcp.create(
				'Context'    => @context,
				'PeerHost'   => @host,
				'PeerPort'   => @port,
				'SSL'        => true,
				'SSLVersion' => ssl_version,
				'SSLCipher'  => cipher,
				'Timeout'    => @timeout
			)
		rescue ::Exception => e 
			return :rejected
		end
		return :accepted
	end

	# Retrieve the X509 Cert from the target service,
	# @param ssl_version [Symbol] The SSL version to use (:SSLv2,  :SSLv3, :TLSv1)
	# @param cipher [String] The SSL Cipher to use
	# @return [OpenSSL::X509::Certificate] if the certificate was retrieved
	# @return [Nil] if the cert couldn't be retrieved
	def get_cert(ssl_version, cipher)
		validate_params(ssl_version,cipher)
		begin
			scan_client = Rex::Socket::Tcp.create(
				'PeerHost'   => @host,
				'PeerPort'   => @port,
				'SSL'        => true,
				'SSLVersion' => ssl_version,
				'SSLCipher'  => cipher,
				'Timeout'    => @timeout
			)
			cert = scan_client.peer_cert
			if cert.kind_of? OpenSSL::X509::Certificate
				return cert
			else
				return nil
			end
		rescue ::Exception => e 
			return nil
		end
	end


	protected

	# Validates that the SSL Version and Cipher are valid both seperately and 
	# together as part of an SSL Context.
	# @param ssl_version [Symbol] The SSL version to use (:SSLv2,  :SSLv3, :TLSv1)
	# @param cipher [String] The SSL Cipher to use
	# @raise [StandardError] If an invalid or unsupported SSL Version was supplied
	# @raise [StandardError] If the cipher is not valid for that version of SSL
	def validate_params(ssl_version, cipher)
		raise StandardError, "The scanner configuration is invalid" unless valid?
		unless @supported_versions.include? ssl_version
			raise StandardError, "SSL Version must be one of: #{@supported_versions.to_s}"
		end
		unless OpenSSL::SSL::SSLContext.new(ssl_version).ciphers.flatten.include? cipher
			raise StandardError, "Must be a valid SSL Cipher for #{version}!"
		end
	end

end
end