librex 0.0.20 → 0.0.21

data/lib/rex/proto/ntlm/constants.rb

@@ -0,0 +1,74 @@
+module Rex
+module Proto
+module NTLM
+class Constants
+
+	SSP_SIGN = "NTLMSSP\0"
+	BLOB_SIGN = 0x00000101
+	LM_MAGIC = "KGS!@\#$%"
+	TIME_OFFSET = 11644473600
+	MAX64 = 0xffffffffffffffff
+    
+	FLAGS = {
+	:UNICODE              => 0x00000001,
+	:OEM                  => 0x00000002,
+	:REQUEST_TARGET       => 0x00000004,
+	#:UNKNOWN              => 0x00000008,
+	:SIGN                 => 0x00000010,
+	:SEAL                 => 0x00000020,
+	#:UNKNOWN              => 0x00000040,
+	:NETWARE              => 0x00000100,
+	:NTLM                 => 0x00000200,
+	#:UNKNOWN              => 0x00000400,
+	#:UNKNOWN              => 0x00000800,
+	:DOMAIN_SUPPLIED      => 0x00001000,
+	:WORKSTATION_SUPPLIED => 0x00002000,
+	:LOCAL_CALL           => 0x00004000,
+	:ALWAYS_SIGN          => 0x00008000,
+	:TARGET_TYPE_DOMAIN   => 0x00010000,
+	:TARGET_INFO          => 0x00800000,
+	:NTLM2_KEY            => 0x00080000,
+	:KEY128               => 0x20000000,
+	:KEY56                => 0x80000000
+	}
+    
+	FLAG_KEYS = FLAGS.keys.sort{|a, b| FLAGS[a] <=> FLAGS[b] }
+
+	DEFAULT_FLAGS = {
+	:TYPE1 => FLAGS[:UNICODE] | FLAGS[:OEM] | FLAGS[:REQUEST_TARGET] | FLAGS[:NTLM] | FLAGS[:ALWAYS_SIGN] | FLAGS[:NTLM2_KEY],
+	:TYPE2 => FLAGS[:UNICODE],
+	:TYPE3 => FLAGS[:UNICODE] | FLAGS[:REQUEST_TARGET] | FLAGS[:NTLM] | FLAGS[:ALWAYS_SIGN] | FLAGS[:NTLM2_KEY]
+	}
+
+	# NTLM Response Type
+	NTLM_V1_RESPONSE =		1
+	NTLM_V2_RESPONSE =		2
+	NTLM_2_SESSION_RESPONSE = 	3
+
+	#the same flags but merged from lib/rex/proto/smb/constants and keeped for compatibility
+	# NTLMSSP Message Flags
+	NEGOTIATE_UNICODE     = 0x00000001  # Only set if Type 1 contains it - this or oem, not both
+	NEGOTIATE_OEM         = 0x00000002  # Only set if Type 1 contains it - this or unicode, not both
+	REQUEST_TARGET        = 0x00000004  # If set in Type 1, must return domain or server
+	NEGOTIATE_SIGN        = 0x00000010  # Session signature required
+	NEGOTIATE_SEAL        = 0x00000020  # Session seal required
+	NEGOTIATE_LMKEY       = 0x00000080  # LM Session Key should be used for signing and sealing
+	NEGOTIATE_NTLM        = 0x00000200  # NTLM auth is supported
+	NEGOTIATE_ANONYMOUS   = 0x00000800  # Anonymous context used
+	NEGOTIATE_DOMAIN      = 0x00001000  # Sent in Type1, client gives domain info
+	NEGOTIATE_WORKSTATION = 0x00002000  # Sent in Type1, client gives workstation info
+	NEGOTIATE_LOCAL_CALL  = 0x00004000  # Server and client are on same machine
+	NEGOTIATE_ALWAYS_SIGN = 0x00008000  # Add signatures to packets
+	TARGET_TYPE_DOMAIN    = 0x00010000  # If REQUEST_TARGET, we're adding the domain name
+	TARGET_TYPE_SERVER    = 0x00020000  # If REQUEST_TARGET, we're adding the server name
+	TARGET_TYPE_SHARE     = 0x00040000  # Supposed to denote "a share" but for a webserver?
+	NEGOTIATE_NTLM2_KEY   = 0x00080000  # NTLMv2 Signature and Key exchanges
+	NEGOTIATE_TARGET_INFO = 0x00800000  # Server set when sending Target Information Block
+	NEGOTIATE_128         = 0x20000000  # 128-bit encryption supported
+	NEGOTIATE_KEY_EXCH    = 0x40000000  # Client will supply encrypted master key in Session Key field of Type3 msg
+	NEGOTIATE_56          = 0x80000000  # 56-bit encryption supported
+
+end
+end
+end
+end

data/lib/rex/proto/ntlm/crypt.rb

@@ -0,0 +1,415 @@
+#
+# An NTLM Authentication Library for Ruby
+#
+# This code is a derivative of "dbf2.rb" written by yrock
+# and Minero Aoki. You can find original code here:
+# http://jp.rubyist.net/magazine/?0013-CodeReview
+# -------------------------------------------------------------
+# Copyright (c) 2005,2006 yrock
+# 
+# This program is free software.
+# You can distribute/modify this program under the terms of the
+# Ruby License.
+#
+# 2011-03-08 improved through a code merge with Metasploit's SMB::Crypt
+# -------------------------------------------------------------
+#
+# 2011-02-23 refactored and improved by Alexandre Maloteaux for Metasploit Project
+# -------------------------------------------------------------
+#
+# 2006-02-11 refactored by Minero Aoki
+# -------------------------------------------------------------
+#
+# All protocol information used to write this code stems from
+# "The NTLM Authentication Protocol" by Eric Glass. The author 
+# would thank to him for this tremendous work and making it 
+# available on the net.
+# http://davenport.sourceforge.net/ntlm.html
+# -------------------------------------------------------------
+# Copyright (c) 2003 Eric Glass
+#
+# Permission to use, copy, modify, and distribute this document
+# for any purpose and without any fee is hereby granted,
+# provided that the above copyright notice and this list of
+# conditions appear in all copies. 
+# -------------------------------------------------------------
+#
+# The author also looked Mozilla-Firefox-1.0.7 source code,
+# namely, security/manager/ssl/src/nsNTLMAuthModule.cpp and
+# Jonathan Bastien-Filiatrault's libntlm-ruby.
+# "http://x2a.org/websvn/filedetails.php?
+# repname=libntlm-ruby&path=%2Ftrunk%2Fntlm.rb&sc=1"
+# The latter has a minor bug in its separate_keys function.
+# The third key has to begin from the 14th character of the 
+# input string instead of 13th:)
+#--
+# $Id: ntlm.rb 11678 2011-01-30 19:26:35Z hdm $
+#++
+
+
+require 'rex/proto/ntlm/constants'
+require 'rex/proto/ntlm/base'
+
+module Rex
+module Proto
+module NTLM
+class Crypt
+
+CONST = Rex::Proto::NTLM::Constants
+BASE = Rex::Proto::NTLM::Base
+
+	@@loaded_openssl = false
+	
+	begin
+		require 'openssl'
+		require 'openssl/digest'
+		@@loaded_openssl = true
+	rescue ::Exception
+	end
+
+	def self.gen_keys(str)
+		str.scan(/.{7}/).map{ |key| des_56_to_64(key) }
+	end
+ 
+	def self.des_56_to_64(ckey56s)
+		ckey64 = []
+		ckey56 = ckey56s.unpack('C*')
+		ckey64[0] = ckey56[0]
+		ckey64[1] = ((ckey56[0] << 7) & 0xFF) | (ckey56[1] >> 1)
+		ckey64[2] = ((ckey56[1] << 6) & 0xFF) | (ckey56[2] >> 2)
+		ckey64[3] = ((ckey56[2] << 5) & 0xFF) | (ckey56[3] >> 3)
+		ckey64[4] = ((ckey56[3] << 4) & 0xFF) | (ckey56[4] >> 4)
+		ckey64[5] = ((ckey56[4] << 3) & 0xFF) | (ckey56[5] >> 5)
+		ckey64[6] = ((ckey56[5] << 2) & 0xFF) | (ckey56[6] >> 6)
+		ckey64[7] =  (ckey56[6] << 1) & 0xFF
+		ckey64.pack('C*')
+	end
+	     
+	def self.apply_des(plain, keys)
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		dec = OpenSSL::Cipher::DES.new
+		keys.map do |k|
+			dec.key = k
+			dec.encrypt.update(plain)
+		end
+	end
+      
+	def self.lm_hash(password, half = false)
+		size = half ? 7 : 14
+		keys = gen_keys(password.upcase.ljust(size, "\0"))
+		apply_des(CONST::LM_MAGIC, keys).join
+	end   
+      
+	def self.ntlm_hash(password, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		pwd = password.dup
+		unless opt[:unicode]
+			pwd = Rex::Text.to_unicode(pwd)
+		end
+		OpenSSL::Digest::MD4.digest(pwd)
+	end
+	
+	# This hash is used for lmv2/ntlmv2 response calculation
+	def self.ntlmv2_hash(user, password, domain, opt={})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		
+		if opt[:pass_is_hash]
+			ntlmhash = password
+		else
+			ntlmhash = ntlm_hash(password, opt)
+		end	
+		# With Win 7 and maybe other OSs we sometimes get the domain not uppercased
+		userdomain = user.upcase  + domain
+		unless opt[:unicode]
+			userdomain = Rex::Text.to_unicode(userdomain)
+		end
+		OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, ntlmhash, userdomain)
+	end
+
+	# Create the LANMAN response
+	def self.lm_response(arg, half = false)
+		begin
+			hash = arg[:lm_hash]
+			chal = arg[:challenge]
+		rescue
+			raise ArgumentError
+		end
+		chal = BASE::pack_int64le(chal) if chal.is_a?(Integer)
+		if half then size = 7 else  size = 21 end
+		keys = gen_keys hash.ljust(size, "\0")
+		apply_des(chal, keys).join
+	end
+
+	# Synonym of lm_response for old compatibility with lib/rex/proto/smb/crypt
+	def self.lanman_des(password, challenge)		
+		lm_response({
+			:lm_hash => self.lm_hash(password),
+			:challenge => challenge
+		})
+	end
+      
+	def self.ntlm_response(arg)
+		hash = arg[:ntlm_hash]
+		chal = arg[:challenge]
+		chal = BASE::pack_int64le(chal) if chal.is_a?(::Integer)
+		keys = gen_keys(hash.ljust(21, "\0"))
+		apply_des(chal, keys).join
+	end
+
+	#synonym of ntlm_response for old compatibility with lib/rex/proto/smb/crypt
+	def self.ntlm_md4(password, challenge)
+		ntlm_response({
+			:ntlm_hash =>  self.ntlm_hash(password), 
+			:challenge => challenge
+		})
+	end
+
+	def self.ntlmv2_response(arg, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		
+		key, chal = arg[:ntlmv2_hash], arg[:challenge]
+		if not (key and chal)
+			raise ArgumentError , 'ntlmv2_hash and challenge are mandatory'
+		end
+
+		chal = BASE::pack_int64le(chal) if chal.is_a?(::Integer)
+		bb   = nil
+		
+		if opt[:nt_client_challenge]
+			if opt[:nt_client_challenge].to_s.length <= 8
+				raise ArgumentError,"nt_client_challenge is not in a correct format " 
+			end
+			bb = opt[:nt_client_challenge]
+		else
+			if not arg[:target_info]
+				raise ArgumentError, "target_info is mandatory in this case"
+			end
+
+			ti = arg[:target_info]
+			cc = opt[:client_challenge] || rand(CONST::MAX64)
+			cc = BASE::pack_int64le(cc) if cc.is_a?(::Integer)
+
+			ts = opt[:timestamp] || Time.now.to_i
+
+			# Convert the unix timestamp to windows format
+			#   epoch -> milsec from Jan 1, 1601
+			ts = 10000000 * (ts + CONST::TIME_OFFSET)
+
+			blob = BASE::Blob.new
+			blob.timestamp = ts
+			blob.challenge = cc
+			blob.target_info = ti
+		
+			bb = blob.serialize
+		end
+
+		OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, key, chal + bb) + bb
+	end
+      
+	def self.lmv2_response(arg, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		key = arg[:ntlmv2_hash]
+		chal = arg[:challenge]
+        
+		chal = BASE::pack_int64le(chal) if chal.is_a?(::Integer)
+		cc   = opt[:client_challenge] || rand(CONST::MAX64)
+		cc   = BASE::pack_int64le(cc) if cc.is_a?(::Integer)
+
+		OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, key, chal + cc) + cc
+	end
+      
+	def self.ntlm2_session(arg, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		passwd_hash,chal = arg[:ntlm_hash],arg[:challenge]
+		if not (passwd_hash and chal)
+			raise RuntimeError, "ntlm_hash and challenge are required"
+		end
+
+		cc = opt[:client_challenge] || rand(CONST::MAX64)
+		cc = BASE::pack_int64le(cc) if cc.is_a?(Integer)
+
+		keys = gen_keys(passwd_hash.ljust(21, "\0"))
+		session_hash = OpenSSL::Digest::MD5.digest(chal + cc)[0,8]
+		response = apply_des(session_hash, keys).join
+		[cc.ljust(24, "\0"), response]
+	end
+
+	#this function will check if the net lm response provided correspond to en empty password 
+	def self.is_hash_from_empty_pwd?(arg)
+		hash_type = arg[:type]
+		raise ArgumentError,"arg[:type] is mandatory" if not hash_type 
+		raise ArgumentError,"arg[:type] must be lm or ntlm" if not hash_type  =~ /^((lm)|(ntlm))$/
+
+		ntlm_ver = arg[:ntlm_ver]
+		raise ArgumentError,"arg[:ntlm_ver] is mandatory" if not ntlm_ver
+ 
+		hash = arg[:hash]
+		raise ArgumentError,"arg[:hash] is mandatory" if not hash
+
+		srv_chall = arg[:srv_challenge] 
+		raise ArgumentError,"arg[:srv_challenge] is mandatory" if not srv_chall		
+		raise ArgumentError,"Server challenge length must be exactly 8 bytes" if srv_chall.length != 8
+
+		#calculate responses for empty pwd
+		case ntlm_ver
+		when CONST::NTLM_V1_RESPONSE 
+			if hash.length != 24
+				raise ArgumentError,"hash length must be exactly 24 bytes "
+			end
+			case hash_type
+			when 'lm'	
+				arglm = { 	:lm_hash => self.lm_hash(''),
+						:challenge => srv_chall}
+				calculatedhash = self.lm_response(arglm)
+			when 'ntlm'
+				argntlm = { 	:ntlm_hash =>  self.ntlm_hash(''), 
+						:challenge => srv_chall }
+				calculatedhash = self.ntlm_response(argntlm)
+			end
+		when CONST::NTLM_V2_RESPONSE
+			raise ArgumentError,"hash length must be exactly 16 bytes " if hash.length != 16
+			cli_chall = arg[:cli_challenge] 
+			raise ArgumentError,"arg[:cli_challenge] is mandatory in this case" if not cli_chall
+			user = arg[:user] 
+			raise ArgumentError,"arg[:user] is mandatory in this case" if not user
+			domain = arg[:domain]
+			raise ArgumentError,"arg[:domain] is mandatory in this case" if not domain
+
+			case hash_type
+			when 'lm'
+				raise ArgumentError,"Client challenge length must be exactly 8 bytes " if cli_chall.length != 8
+				arglm = {	:ntlmv2_hash =>  self.ntlmv2_hash(user,'', domain),
+						:challenge => srv_chall }
+				optlm = {	:client_challenge => cli_chall}
+				calculatedhash = self.lmv2_response(arglm, optlm)[0,16]
+			when 'ntlm'
+				raise ArgumentError,"Client challenge length must be bigger then 8 bytes " if cli_chall.length <= 8
+				argntlm = { 	:ntlmv2_hash =>  self.ntlmv2_hash(user, '', domain),
+						:challenge => srv_chall }
+				optntlm = { 	:nt_client_challenge => cli_chall}
+				calculatedhash = self.ntlmv2_response(argntlm,optntlm)[0,16]
+			end
+		when CONST::NTLM_2_SESSION_RESPONSE
+			raise ArgumentError,"hash length must be exactly 16 bytes " if hash.length != 24
+			cli_chall = arg[:cli_challenge] 
+			raise ArgumentError,"arg[:cli_challenge] is mandatory in this case" if not cli_chall
+			raise ArgumentError,"Client challenge length must be exactly 8 bytes " if cli_chall.length != 8
+			case hash_type
+			when 'lm'
+				raise ArgumentError, "ntlm2_session is incompatible with lm"
+			when 'ntlm'
+				argntlm = { 	:ntlm_hash =>  self.ntlm_hash(''), 
+						:challenge => srv_chall }
+				optntlm = {	:client_challenge => cli_chall}
+			end
+			calculatedhash = self.ntlm2_session(argntlm,optntlm).join[24,24]
+		else
+			raise ArgumentError,"ntlm_ver is of unknow type"
+		end
+		hash == calculatedhash
+	end
+
+
+
+	#
+	# Signing method added for metasploit project
+	#
+	
+	# Used when only the LMv1 response is provided (i.e., with Win9x clients)
+	def self.lmv1_user_session_key(pass, opt = {})
+		if opt[:pass_is_hash]
+			usk = pass[0,8]
+		else
+			usk = self.lm_hash(pass.upcase[0,7],true)
+		end
+		usk.ljust(16,"\x00")
+	end
+		
+	# This variant is used when the client sends the NTLMv1 response
+	def self.ntlmv1_user_session_key(pass, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+
+		if opt[:pass_is_hash]
+			usk = pass
+		else
+			usk = self.ntlm_hash(pass)
+		end
+		OpenSSL::Digest::MD4.digest(usk)
+	end
+
+	# Used when NTLMv1 authentication is employed with NTLM2 session security
+	def self.ntlm2_session_user_session_key(pass, srv_chall, cli_chall, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+
+		ntlm_key = self.ntlmv1_user_session_key(pass, opt )
+		session_chal = srv_chall + cli_chall
+		OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, ntlm_key, session_chal)
+	end
+
+	# Used when the LMv2 response is sent
+	def self.lmv2_user_session_key(user, pass, domain, srv_chall, cli_chall, opt = {})
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+
+		ntlmv2_key = self.ntlmv2_hash(user, pass, domain, opt)
+		hash1 = OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, ntlmv2_key, srv_chall + cli_chall)
+		OpenSSL::HMAC.digest(OpenSSL::Digest::MD5.new, ntlmv2_key, hash1)
+	end
+
+	# Used when the NTLMv2 response is sent
+	class << self; alias_method :ntlmv2_user_session_key, :lmv2_user_session_key; end
+
+	# Used when LanMan Key flag is set
+	def self.lanman_session_key(pass, srvchall, opt = {})
+		if opt[:pass_is_hash]
+			halfhash = pass[0,8]
+		else
+			halfhash = lm_hash(pass.upcase[0,7],true)
+		end
+		plain = self.lm_response({
+			:lm_hash => halfhash[0,7],
+			:challenge => srvchall
+		}, true )
+		key = halfhash  + ["bdbdbdbdbdbd"].pack("H*")
+        keys = self.gen_keys(key)
+       	apply_des(plain, keys).join
+	end
+
+	def self.encrypt_sessionkey(session_key, user_session_key)
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		cipher = OpenSSL::Cipher::Cipher.new('rc4')
+		cipher.encrypt
+		cipher.key = user_session_key
+		cipher.update(session_key) 
+	end
+
+	def self.decrypt_sessionkey(encrypted_session_key, user_session_key)
+		raise RuntimeError, "No OpenSSL support" if not @@loaded_openssl
+		cipher = OpenSSL::Cipher::Cipher.new('rc4')
+		cipher.decrypt
+		cipher.key = user_session_key
+		cipher.update(encrypted_session_key) 
+	end
+
+	def self.make_weak_sessionkey(session_key,key_size,lanman_key = false)
+		case key_size
+		when 40
+			if lanman_key
+				return session_key[0,5] + "\xe5\x38\xb0" 
+			else
+				return session_key[0,5] 
+			end
+		when 56
+			if lanman_key
+				return session_key[0,7]  + "\xa0"
+			else
+				return session_key[0,7]  
+			end
+		else #128 
+			return session_key[0,16]
+		end
+	end
+
+end
+end
+end
+end