diff --git a/scripts/cics-enum.nse b/scripts/cics-enum.nse
index b46d1eee0..8517bb950 100644
--- a/scripts/cics-enum.nse
+++ b/scripts/cics-enum.nse
@@ -28,6 +28,8 @@ found for CICS transaction IDs.
-- to access CICS. Defaults to CICS.
-- @args cics-enum.path Folder used to store valid transaction id 'screenshots'
-- Defaults to None and doesn't store anything.
+-- @args cics-enum.user Username to use for authenticated enumeration
+-- @args cics-enum.pass Password to use for authenticated enumeration
--
-- @usage
-- nmap --script=cics-enum -p 23
@@ -53,6 +55,7 @@ found for CICS transaction IDs.
-- @changelog
-- 2015-07-04 - v0.1 - created by Soldier of Fortran
-- 2015-11-14 - v0.2 - rewrote iterator
+-- 2017-01-22 - v0.3 - added authenticated CICS ID enumeration
--
-- @author Philip Young
-- @copyright Same as Nmap--See https://nmap.org/book/man-legal.html
@@ -105,6 +108,8 @@ Driver = {
login = function (self, user, pass) -- pass is actually the CICS transaction we want to try
local commands = self.options['key1']
local path = self.options['key2']
+ local cics_user = self.options['user']
+ local cics_pass = self.options['pass']
local timeout = 300
local max_blank = 1
local loop = 1
@@ -143,8 +148,31 @@ Driver = {
-- something is wrong but we can still try transactions. Print error to debug.
stdnse.debug('Error. Failed to get to a blank screen under CICS (sending F3 followed by CLEAR). Try lowering maxthreads to fix.')
end
+ -- If username/password provided try to authenticate first
+ if not (cics_user == nil and cics_pass == nil) then -- We're doing authenticated CICS testing now baby!
+ stdnse.debug(2,'Logging in with %s / %s for auth testing', cics_user, cics_pass)
+ self.tn3270:send_cursor('CESN')
+ self.tn3270:get_all_data()
+ self.tn3270:get_screen_debug(2)
+ local fields = self.tn3270:writeable() -- Get the writeable field areas
+ local user_loc = {fields[1][1],cics_user} -- This is the 'UserID:' field
+ local pass_loc = {fields[3][1],cics_pass} -- This is the 'Password:' field ([2] is a group ID)
+ stdnse.debug(2,'Trying CICS: %s : %s', user, pass)
+ self.tn3270:send_locations({user_loc,pass_loc})
+ self.tn3270:get_all_data()
+ stdnse.debug(2,"Screen Recieved for User ID: %s / %s", user, pass)
+ self.tn3270:get_screen_debug(2)
+ local count = 1
+ while not self.tn3270:find('DFHCE3549') and count < 6 do -- some systems show a message for a bit before we get to CICS again
+ self.tn3270:get_all_data(1000) -- loop for 6 seconds
+ count = count + 1
+ end
+ end
+ self.tn3270:get_screen_debug(2)
+ self.tn3270:send_clear()
+ self.tn3270:get_all_data()
+ self.tn3270:get_screen_debug(2)
stdnse.verbose("Trying Transaction ID: %s", pass)
- stdnse.debug(2,"Sending Transaction ID: %s", pass)
self.tn3270:send_cursor(pass)
self.tn3270:get_all_data()
@@ -158,7 +186,7 @@ Driver = {
stdnse.debug(2,"Screen Recieved for Transaction ID: %s", pass)
self.tn3270:get_screen_debug(2)
- if self.tn3270:find('not recognized') then -- known invalid command
+ if self.tn3270:find('not recognized') or self.tn3270:find('DFHAC2002') then -- known invalid command
stdnse.debug("Invalid CICS Transaction ID: %s", string.upper(pass))
return false, brute.Error:new( "Incorrect CICS Transaction ID" )
elseif self.tn3270:isClear() then
@@ -172,6 +200,41 @@ Driver = {
-- This will be the same screen for each so we dont bother saving it either
stdnse.verbose("Valid CICS Transaction ID [requires auth]: %s", string.upper(pass))
return true, creds.Account:new("CICS ID [requires auth]", string.upper(pass), creds.State.VALID)
+ elseif self.tn3270:find('DFHAC2008') or self.tn3270:find('DFHAC2206') or self.tn3270:find('DFHAC2028') or
+ self.tn3270:find('DFHRT4415') or self.tn3270:find('DFHRT4480') or self.tn3270:find('TSS7254E') then
+ -- these are technically valid CICS transactions
+ -- but they are of little/no value. If verbosity is turned way up we'll return these/save a screenshot
+ -- otherwise there's no point
+ -- DFHAC2008 -- TranID has been Disabled
+ -- DFHAC2206 -- Abend
+ -- DFHRT4415 -- Cannot access through terminal
+ -- DFHRT4480 -- No Longer Supported
+ -- DFHAC2028 -- cannot be used
+ -- TSS7254E -- Access not available through this facility
+ stdnse.verbose("Valid CICS Transaction ID [Abbend or ID Disabled]: %s", string.upper(pass))
+ if nmap.verbosity() > 3 then
+ if path ~= nil then
+ stdnse.verbose(2,"Writting screen to: %s", path..string.upper(pass)..".txt")
+ status, err = save_screens(path..string.upper(pass)..".txt",self.tn3270:get_screen())
+ if not status then
+ stdnse.verbose(2,"Failed writting screen to: %s", path..string.upper(pass)..".txt")
+ end
+ end
+ return true, creds.Account:new("CICS ID [Abbend]", string.upper(pass), creds.State.VALID)
+ else
+ return false, brute.Error:new( "Correct Transaction ID - Access Denied" )
+ end
+ elseif not (cics_user == nil and cics_pass == nil) and
+ (self.tn3270:find('TSS7251E') or self.tn3270:find('DFHAC2033')) then
+ -- We've logged on but we don't have access to this transaction
+ -- TSS7251E : Access Denied to PROGRAM
+ -- DFHAC2033 : You are not authorized to use transaction
+ stdnse.verbose("Valid CICS Transaction ID [Access Denied]: %s", string.upper(pass))
+ if nmap.verbosity() > 3 then
+ return true, creds.Account:new("CICS ID [Access Denied]", string.upper(pass), creds.State.VALID)
+ else
+ return false, brute.Error:new( "Correct Transaction ID - Access Denied" )
+ end
else
stdnse.verbose("Valid CICS Transaction ID: %s", string.upper(pass))
if path ~= nil then
@@ -191,13 +254,16 @@ Driver = {
--
-- @param host host NSE object
-- @param port port NSE object
+-- @param user CICS userID
+-- @param pass CICS userID password
-- @param commands optional script-args of commands to use to get to CICS
-- @return status true on success, false on failure
-local function cics_test( host, port, commands )
+local function cics_test( host, port, commands, user, pass )
stdnse.debug("Checking for CICS")
local tn = tn3270.Telnet:new()
local status, err = tn:initiate(host,port)
+ local msg = 'Unable to get to CICS'
local cics = false -- initially we're not at CICS
if not status then
stdnse.debug("Could not initiate TN3270: %s", err )
@@ -251,11 +317,42 @@ local function cics_test( host, port, commands )
tn:get_screen_debug(2)
if tn:find('Sign-off is complete.') then
- tn:disconnect()
- cics = true
+ cics = true
end
+
+ if not (user == nil and pass == nil) then -- We're doing authenticated CICS testing now baby!
+ stdnse.verbose(2,'Logging in with %s / %s for auth testing', user, pass)
+ tn:send_clear()
+ tn:get_all_data()
+ tn:get_screen_debug(2)
+ tn:send_cursor('CESN')
+ tn:get_all_data()
+ tn:get_screen_debug(2)
+ local fields = tn:writeable() -- Get the writeable field areas
+ local user_loc = {fields[1][1],user} -- This is the 'UserID:' field
+ local pass_loc = {fields[3][1],pass} -- This is the 'Password:' field ([2] is a group ID)
+ stdnse.verbose('Trying CICS: %s : %s', user, pass)
+ tn:send_locations({user_loc,pass_loc})
+ tn:get_all_data()
+ stdnse.debug(2,"Screen Recieved for User ID: %s / %s", user, pass)
+ tn:get_screen_debug(2)
+ count = 1
+ while not tn:find('DFHCE3549') and count < 6 do
+ tn:get_all_data(1000) -- loop for 6 seconds
+ tn:get_screen_debug(2)
+ count = count + 1
+ end
+ if not tn:find('DFHCE3549') then
+ cics = false
+ msg = 'Unable to access CICS with User: '..user..' / Pass: '..pass
+ else
+ tn:send_cursor('CESF')
+ tn:get_all_data()
+ end
+ end
+
tn:disconnect()
- return cics
+ return cics,msg
end
-- Filter iterator for unpwdb
@@ -276,6 +373,8 @@ action = function(host, port)
local cics_id_file = stdnse.get_script_args("idlist")
local path = stdnse.get_script_args(SCRIPT_NAME .. '.path') -- Folder for screenshots
local commands = stdnse.get_script_args(SCRIPT_NAME .. '.commands') or 'cics'-- VTAM commands/macros to get to CICS
+ local username = stdnse.get_script_args(SCRIPT_NAME .. '.user') or nil
+ local password = stdnse.get_script_args(SCRIPT_NAME .. '.pass') or nil
local cics_ids = {"CADP", "CATA", "CATD", "CATR", "CBAM", "CCIN", "CCRL", "CDBC", "CDBD",
"CDBF", "CDBI", "CDBM", "CDBN", "CDBO", "CDBQ", "CDBT", "CDFS", "CDST",
"CDTS", "CEBR", "CEBT", "CECI", "CECS", "CEDA", "CEDB", "CEDC", "CEDF",
@@ -296,7 +395,7 @@ action = function(host, port)
"CSPG", "CSPK", "CSPP", "CSPQ", "CSPS", "CSQC", "CSRK", "CSRS", "CSSF",
"CSSY", "CSTE", "CSTP", "CSXM", "CSZI", "CTIN", "CTSD", "CVMI", "CWBA",
"CWBG", "CWTO", "CWWU", "CWXN", "CWXU", "CW2A", "CXCU", "CXRE", "CXRT",
- "DSNC"} -- Default CICS from https://www-01.ibm.com/support/knowledgecenter/SSGMCP_5.2.0/com.ibm.cics.ts.systemprogramming.doc/topics/dfha726.html
+ "DSNC"} -- Default CICS from https://www-01.ibm.com/support/knowledgecenter/SSGMCP_5.2.0/com.ibm.cics.ts.systemprogramming.doc/topics/dfha726.html
cics_id_file = ( (cics_id_file and nmap.fetchfile(cics_id_file)) or cics_id_file )
@@ -307,19 +406,21 @@ action = function(host, port)
end
end
end
-
- if cics_test(host, port, commands) then
- local options = { key1 = commands, key2 = path }
+ local cicstst,msg = cics_test(host, port, commands, username, password)
+ if cicstst then
+ local title = 'CICS Transaction IDs'
+ if not(username == nil and password == nil) then title = 'CICS Transaction IDs for User: '.. username end
+ local options = { key1 = commands, key2 = path, user = username, pass = password }
stdnse.debug("Starting CICS Transaction ID Enumeration")
if path ~= nil then stdnse.verbose(2,"Saving Screenshots to: %s", path) end
local engine = brute.Engine:new(Driver, host, port, options)
engine.options.script_name = SCRIPT_NAME
engine:setPasswordIterator(unpwdb.filter_iterator(iter(cics_ids), valid_cics))
engine.options.passonly = true
- engine.options:setTitle("CICS Transaction ID")
+ engine.options:setTitle(title)
local status, result = engine:start()
return result
else
- return "Could not get to CICS. Aborting."
+ return msg
end
end