def __init__(self, db): self.db = db self.BaseDomain = BaseDomainRepository(db, self.name) self.Domain = DomainRepository(db, self.name) self.IPAddress = IPRepository(db, self.name) self.Port = PortRepository(db, self.name) self.Vulnerability = VulnRepository(db, self.name) self.CVE = CVERepository(db, self.name)
class Module(ModuleTemplate):
name = "Nessus"
def __init__(self, db):
self.db = db
self.BaseDomain = BaseDomainRepository(db, self.name)
self.Domain = DomainRepository(db, self.name)
self.IPAddress = IPRepository(db, self.name)
self.Port = PortRepository(db, self.name)
self.Vulnerability = VulnRepository(db, self.name)
self.CVE = CVERepository(db, self.name)
self.ScopeCIDR = ScopeCIDRRepository(db, self.name)
def set_options(self):
super(Module, self).set_options()
self.options.add_argument(
"--import_file",
help="Import separated Nessus files separated by a space. DO NOT USE QUOTES OR COMMAS",
nargs="+",
)
self.options.add_argument(
"--interactive",
help="Prompt to store domains not in Base Domains already",
action="store_true",
)
self.options.add_argument(
"--internal",
help="Store domains not in Base Domains already",
action="store_true",
)
self.options.add_argument(
"--launch",
help="Launch Nessus scan using Actively scoped IPs and domains in the database",
action="store_true",
)
self.options.add_argument(
"--job_name", help="Job name inside Nessus", default="Armory Job"
)
self.options.add_argument("--username", help="Nessus Username")
self.options.add_argument("--password", help="Nessus Password")
self.options.add_argument(
"--host", help="Hostname:Port of Nessus web interface (ie localhost:8835"
)
self.options.add_argument("--uuid", help="UUID of Nessus Policy to run")
self.options.add_argument("--policy_id", help="Policy ID to use")
self.options.add_argument("--folder_id", help="ID for folder to store job in")
self.options.add_argument(
"--download",
help="Download Nessus job from server and import",
action="store_true",
)
self.options.add_argument("--job_id", help="Job ID to download and import")
self.options.add_argument(
"--output_path",
help="Path to store downloaded file (Default: Nessus)",
default=self.name,
)
def run(self, args):
if args.import_file:
for nFile in args.import_file:
self.process_data(nFile, args)
elif args.launch:
if (
not args.username
and not args.password
and not args.host
and not args.uuid
and not args.policy_id
and not args.folder_id
):
display_error(
"You must supply a username, password, and host to launch a Nessus job"
)
else:
n = NessusRequest(
args.username,
args.password,
args.host,
uuid=args.uuid,
policy_id=args.policy_id,
folder_id=args.folder_id,
)
ips = [
ip.ip_address
for ip in self.IPAddress.all(scope_type="active", tool=self.name)
]
cidrs = [cidr.cidr for cidr in self.ScopeCIDR.all(tool=self.name)]
domains = [
domain.domain
for domain in self.Domain.all(scope_type="active", tool=self.name)
]
targets = ", ".join(merge_ranges(ips + cidrs) + domains)
res = n.launch_job(targets, args.job_name)
display("New Nessus job launched with ID {}".format(res))
display(
"Remember this number! You'll need it to download the job once it is done."
)
elif args.download:
if (
not args.username
and not args.password
and not args.host
and not args.job_id
):
display_error(
"You must supply host, username, password and job_id to download a report to import"
)
else:
n = NessusRequest(
args.username,
args.password,
args.host,
proxies={"https": "127.0.0.1:8080"},
)
if args.output_path[0] == "/":
output_path = os.path.join(
self.base_config["PROJECT"]["base_path"], args.output_path[1:]
)
else:
output_path = os.path.join(
self.base_config["PROJECT"]["base_path"], args.output_path
)
if not os.path.exists(output_path):
os.makedirs(output_path)
output_path = os.path.join(
output_path, "Nessus-export-{}.nessus".format(int(time.time()))
)
n.export_file(args.job_id, output_path)
self.process_data(output_path, args)
def nessCheckPlugin(self, tag):
nessPlugins = [
"10759",
"77026",
"20089",
"56984",
"71049",
"70658",
"40984",
"11411",
]
pluginID = tag.get("pluginID")
if pluginID in nessPlugins:
# print pluginID + " is in the list"
if pluginID == "10759":
if tag.find("plugin_output") is not None:
return (
tag.find("plugin_output").text.split("\n\n")[3].strip()
) # returns IP for Web Server HTTP Header INternal IP disclosure
else:
return ""
if pluginID == "77026":
if tag.find("plugin_output") is not None:
return (
tag.find("plugin_output").text.split("\n\n")[3].strip()
) # Microsoft Exchange Client Access Server Information Disclosure (IP addy)
else:
return ""
if pluginID == "71049" or pluginID == "70658":
output = ""
if tag.find("plugin_output") is not None:
tmp = tag.find("plugin_output").text.split(":")[
1
] # SSH Weak MAC & CBC Algorithms Enabled
# print "#"*5
tmp = tmp.split("\n\n")[1].replace(" ", "")
# print "#"*5
output = tmp.split("\n")
# print ", ".join(output)
return ", ".join(output)
if pluginID == "56984":
if tag.find("plugin_output") is not None:
tmp = (
tag.find("plugin_output")
.text.split("This port supports ")[1]
.strip()
) # SSL / TLS Versions Supported
tmp = tmp.split("/")
bad = []
for i in tmp:
# print i
if "SSLv" in i:
bad.append(i)
elif "TLSv1.0" in i:
bad.append(i)
if bad != []:
return ", ".join(bad).rstrip(".")
else:
return ""
else:
return ""
if pluginID == "40984": # browsable web dirs
if tag.find("plugin_output") is not None:
tmp = (
tag.find("plugin_output")
.text.split("The following directories are browsable :")[1]
.strip()
)
directories = tmp.split("\n")
return "\n".join(directories)
if pluginID == "11411": # Backup Files Disclosure
if tag.find("plugin_output") is not None:
urls = []
tmp = (
tag.find("plugin_output")
.text.split(
"It is possible to read the following backup files :"
)[1]
.strip()
)
tmpUrls = tmp.split("\n")
for url in tmpUrls:
if "URL" in url:
urls.append(url.split(":")[1].lstrip())
if urls:
return "\n".join(urls)
else:
return ""
if pluginID == "20089": # F5 cookie
if tag.find("plugin_output") is not None:
f5Output = []
cookieVal = []
output = tag.find("plugin_output").text.strip().split("\n")
for line in output:
# print line
line = line.split(":")
for i, item in enumerate(line):
item = item.strip()
if "Cookie" in item:
cabbage = line.pop(i)
tmp = line.pop(i)
tmp.strip()
cookieVal.append(tmp)
else:
item = "".join(item)
f5Output.append(item)
f5Output = " : ".join(f5Output)
f5Output = f5Output.replace(" : : ", ", ")
f5Output += " [" + ", ".join(cookieVal) + "]"
c = 0
tmpF5Output = f5Output.split()
for i, letter in enumerate(tmpF5Output):
if letter == ":":
c += 1
if (c % 2) == 0:
tmpF5Output[i] = " "
return "".join(tmpF5Output).replace("[", " [")
else:
return ""
else:
return False
def getVulns(self, ip, ReportHost):
"""Gets vulns and associated services"""
for tag in ReportHost.iter("ReportItem"):
exploitable = False
cves = []
vuln_refs = {}
proto = tag.get("protocol")
port = tag.get("port")
svc_name = tag.get("svc_name").replace("?", "")
tmpPort = proto + "/" + port
if tmpPort.lower() == "tcp/443":
portName = "https"
elif tmpPort.lower() == "tcp/80":
portName = "http"
elif svc_name == "www":
plugin_name = tag.get("pluginName")
if "tls" in plugin_name.lower() or "ssl" in plugin_name.lower():
portName = "https"
else:
portName = "http"
else:
portName = svc_name
if "general" not in portName:
created, db_port = self.Port.find_or_create(
port_number=port, status="open", proto=proto, ip_address_id=ip.id
)
if db_port.service_name == "http":
if portName == "https":
db_port.service_name = portName
elif db_port.service_name == "https":
pass
else:
db_port.service_name = portName
db_port.save()
if tag.get("pluginID") == "56984":
severity = 1
elif tag.get("pluginID") == "11411":
severity = 3
else:
severity = int(tag.get("severity"))
findingName = tag.get("pluginName")
description = tag.find("description").text
if tag.find("solution") is not None and tag.find("solution") != "n/a":
solution = tag.find("solution").text
else:
solution = "No Remediation From Nessus"
nessCheck = self.nessCheckPlugin(tag)
if nessCheck:
if not db_port.info:
db_port.info = {findingName: nessCheck}
else:
db_port.info[findingName] = nessCheck
db_port.save()
if tag.find("exploit_available") is not None:
# print "\nexploit avalable for", findingName
exploitable = True
metasploits = tag.findall("metasploit_name")
if metasploits:
vuln_refs["metasploit"] = []
for tmp in metasploits:
vuln_refs["metasploit"].append(tmp.text)
edb_id = tag.findall("edb-id")
if edb_id:
vuln_refs["edb-id"] = []
for tmp in edb_id:
vuln_refs["edb-id"].append(tmp.text)
tmpcves = tag.findall("cve")
for c in tmpcves:
if c.text not in cves:
cves.append(c.text)
if not self.Vulnerability.find(name=findingName):
created, db_vuln = self.Vulnerability.find_or_create(
name=findingName,
severity=severity,
description=description,
remediation=solution,
)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if exploitable == True:
print("\nexploit avalable for", findingName)
print()
if vuln_refs:
db_vuln.exploit_reference = vuln_refs
else:
db_vuln = self.Vulnerability.find(name=findingName)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
if db_vuln.exploit_reference is not None:
for key in vuln_refs.keys():
if key not in db_vuln.exploit_reference.keys():
db_vuln.exploit_reference[key] = vuln_refs[key]
else:
for ref in vuln_refs[key]:
if ref not in db_vuln.exploit_reference[key]:
db_vuln.exploit_reference[key].append(ref)
else:
db_vuln.exploit_reference = vuln_refs
for cve in cves:
if not self.CVE.find(name=cve):
# print "Gathering CVE information for", cve
try:
res = json.loads(
requests.get(
"http://cve.circl.lu/api/cve/%s" % cve
).text
)
cveDescription = res["summary"]
cvss = float(res["cvss"])
except:
cveDescription = None
cvss = None
if not self.CVE.find(name=cve):
created, db_cve = self.CVE.find_or_create(
name=cve,
description=cveDescription,
temporal_score=cvss,
)
db_cve.vulnerabilities.append(db_vuln)
else:
db_cve = self.CVE.find(name=cve)
if (
db_cve.description is None
and cveDescription is not None
):
db_cve.description = cveDescription
if db_cve.temporal_score is None and cvss is not None:
db_cve.temporal_score = cvss
db_cve.vulnerabilities.append(db_vuln)
def process_data(self, nFile, args):
print("Reading", nFile)
tree = ET.parse(nFile)
root = tree.getroot()
skip = []
for ReportHost in root.iter("ReportHost"):
os = []
hostname = ""
hostIP = ""
for HostProperties in ReportHost.iter("HostProperties"):
for tag in HostProperties:
if tag.get("name") == "host-ip":
hostIP = tag.text
if tag.get("name") == "host-fqdn":
hostname = tag.text.lower()
hostname = hostname.replace("www.", "")
if tag.get("name") == "operating-system":
os = tag.text.split("\n")
if hostIP: # apparently nessus doesn't always have an IP to work with...
if hostname:
display(
"Gathering Nessus info for {} ( {} )".format(hostIP, hostname)
)
else:
display("Gathering Nessus info for {}".format(hostIP))
created, ip = self.IPAddress.find_or_create(ip_address=hostIP)
if hostname:
if not args.internal:
created, domain = self.Domain.find_or_create(domain=hostname)
if ip not in domain.ip_addresses:
ip.save()
domain.ip_addresses.append(ip)
domain.save()
else:
created, domain = self.Domain.find_or_create(domain=hostname)
if ip not in domain.ip_addresses:
domain.ip_addresses.append(ip)
domain.update()
if os:
for o in os:
if not ip.OS:
ip.OS = o
else:
if o not in ip.OS.split(" OR "):
ip.OS += " OR " + o
self.getVulns(ip, ReportHost)
self.IPAddress.commit()
return
class Module(ModuleTemplate):
name = "Nessus"
def __init__(self, db):
self.db = db
self.BaseDomain = BaseDomainRepository(db, self.name)
self.Domain = DomainRepository(db, self.name)
self.IPAddress = IPRepository(db, self.name)
self.Port = PortRepository(db, self.name)
self.Vulnerability = VulnRepository(db, self.name)
self.CVE = CVERepository(db, self.name)
def set_options(self):
super(Module, self).set_options()
self.options.add_argument('--import_file', help="Import separated Nessus files separated by a space. DO NOT USE QUOTES OR COMMAS", nargs='+')
self.options.add_argument('--interactive', help="Prompt to store domains not in Base Domains already", action="store_true")
self.options.add_argument('--internal', help="Store domains not in Base Domains already", action="store_true")
def run(self, args):
if not args.import_file:
print("You need to supply some options to do something.")
else:
for nFile in args.import_file:
self.process_data(nFile, args)
def nessCheckPlugin(self, tag):
nessPlugins = ["10759","77026", "20089", "56984", "71049", "70658", "40984", "11411"]
pluginID = tag.get("pluginID")
if pluginID in nessPlugins:
#print pluginID + " is in the list"
if pluginID == "10759":
if tag.find("plugin_output") is not None:
return tag.find("plugin_output").text.split("\n\n")[3].strip() #returns IP for Web Server HTTP Header INternal IP disclosure
else:
return ""
if pluginID == "77026":
if tag.find("plugin_output") is not None:
return tag.find("plugin_output").text.split("\n\n")[3].strip() #Microsoft Exchange Client Access Server Information Disclosure (IP addy)
else:
return ""
if pluginID == "71049" or pluginID == "70658":
output = ""
if tag.find("plugin_output") is not None:
tmp = tag.find("plugin_output").text.split(":")[1] #SSH Weak MAC & CBC Algorithms Enabled
#print "#"*5
tmp = tmp.split("\n\n")[1].replace(" ","")
#print "#"*5
output = tmp.split("\n")
#print ", ".join(output)
return ", ".join(output)
if pluginID == "56984":
if tag.find("plugin_output") is not None:
tmp = tag.find("plugin_output").text.split("This port supports ")[1].strip() # SSL / TLS Versions Supported
tmp = tmp.split("/")
bad = []
for i in tmp:
#print i
if "SSLv" in i:
bad.append(i)
elif "TLSv1.0" in i:
bad.append(i)
if bad != []:
return ", ".join(bad).rstrip(".")
else:
return ""
else:
return ""
if pluginID == "40984": #broswable web dirs
if tag.find("plugin_output") is not None:
tmp = tag.find("plugin_output").text.split("The following directories are browsable :")[1].strip()
directories = tmp.split("\n")
return "\n".join(directories)
if pluginID == "11411": #Backup Files Disclosure
if tag.find("plugin_output") is not None:
urls = []
tmp = tag.find("plugin_output").text.split("It is possible to read the following backup files :")[1].strip()
tmpUrls = tmp.split("\n")
for url in tmpUrls:
if "URL" in url:
urls.append(url.split(":")[1].lstrip())
if urls:
return "\n".join(urls)
else:
return ""
if pluginID == "20089": #F5 cookie
if tag.find("plugin_output") is not None:
f5Output = []
cookieVal = []
output = tag.find("plugin_output").text.strip().split("\n")
for line in output:
#print line
line = line.split(":")
for i, item in enumerate(line):
item = item.strip()
if "Cookie" in item:
cabbage = line.pop(i)
tmp = line.pop(i)
tmp.strip()
cookieVal.append(tmp)
else:
item = "".join(item)
f5Output.append(item)
f5Output = " : ".join(f5Output)
f5Output = f5Output.replace(" : : ", ", ")
f5Output += " [" + ", ".join(cookieVal) + "]"
c = 0
tmpF5Output = f5Output.split()
for i, letter in enumerate(tmpF5Output):
if letter == ":":
c += 1
if (c%2) == 0:
tmpF5Output[i] = " "
return "".join(tmpF5Output).replace("["," [")
else:
return ""
else:
return False
def getVulns(self, ip, ReportHost):
'''Gets vulns and associated services'''
for tag in ReportHost.iter("ReportItem"):
exploitable = False
cves = []
vuln_refs = {}
proto = tag.get("protocol")
port = tag.get("port")
svc_name = tag.get("svc_name").replace("?","")
tmpPort = proto+"/"+port
if tmpPort.lower() == "tcp/443":
portName = "https"
elif tmpPort.lower() == "tcp/80":
portName = "http"
elif svc_name == "www":
plugin_name = tag.get("pluginName")
if "tls" in plugin_name.lower() or "ssl" in plugin_name.lower():
portName = "https"
else:
portName = "http"
else:
portName = svc_name
if "general" not in portName:
created, db_port = self.Port.find_or_create(port_number=port, status='open', proto=proto, ip_address_id=ip.id)
if db_port.service_name == "http":
if portName == "https":
db_port.service_name = portName
elif db_port.service_name == "https":
pass
else:
db_port.service_name = portName
db_port.save()
if tag.get("pluginID") == "56984":
severity = 1
elif tag.get("pluginID") == "11411":
severity = 3
else:
severity = int(tag.get("severity"))
findingName = tag.get("pluginName")
description = tag.find("description").text
if tag.find("solution") is not None and tag.find("solution") != "n/a":
solution = tag.find("solution").text
else:
solution = "No Remediation From Nessus"
nessCheck = self.nessCheckPlugin(tag)
if nessCheck:
if not db_port.info:
db_port.info = {findingName:nessCheck}
else:
db_port.info[findingName] = nessCheck
db_port.save()
if tag.find("exploit_available") is not None:
#print "\nexploit avalable for", findingName
exploitable = True
metasploits = tag.findall("metasploit_name")
if metasploits:
vuln_refs['metasploit'] = []
for tmp in metasploits:
vuln_refs['metasploit'].append(tmp.text)
edb_id = tag.findall("edb-id")
if edb_id:
vuln_refs['edb-id'] = []
for tmp in edb_id:
vuln_refs['edb-id'].append(tmp.text)
tmpcves = tag.findall("cve")
for c in tmpcves:
if c.text not in cves:
cves.append(c.text)
if not self.Vulnerability.find(name=findingName):
created, db_vuln = self.Vulnerability.find_or_create(name=findingName, severity=severity, description=description, remediation=solution)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if exploitable == True:
print "\nexploit avalable for", findingName
print
if vuln_refs:
db_vuln.exploit_reference = vuln_refs
else:
db_vuln = self.Vulnerability.find(name=findingName)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
if db_vuln.exploit_reference is not None:
for key in vuln_refs.keys():
if key not in db_vuln.exploit_reference.keys():
db_vuln.exploit_reference[key] = vuln_refs[key]
else:
for ref in vuln_refs[key]:
if ref not in db_vuln.exploit_reference[key]:
db_vuln.exploit_reference[key].append(ref)
else:
db_vuln.exploit_reference = vuln_refs
for cve in cves:
if not self.CVE.find(name=cve):
#print "Gathering CVE information for", cve
try:
res = json.loads(requests.get('http://cve.circl.lu/api/cve/%s' % cve).text)
cveDescription = res['summary']
cvss = float(res['cvss'])
except:
cveDescription = None
cvss = None
if not self.CVE.find(name=cve):
created, db_cve = self.CVE.find_or_create(name=cve, description=cveDescription, temporal_score=cvss)
db_cve.vulnerabilities.append(db_vuln)
else:
db_cve = self.CVE.find(name=cve)
if db_cve.description is None and cveDescription is not None:
db_cve.description = cveDescription
if db_cve.temporal_score is None and cvss is not None:
db_cve.temporal_score = cvss
db_cve.vulnerabilities.append(db_vuln)
def process_data(self, nFile, args):
print "Reading",nFile
tree = ET.parse(nFile)
root = tree.getroot()
skip = []
for ReportHost in root.iter('ReportHost'):
os = []
hostname = ""
hostIP = ""
for HostProperties in ReportHost.iter("HostProperties"):
for tag in HostProperties:
if tag.get('name') == "host-ip":
hostIP = tag.text
if tag.get('name') == "host-fqdn":
hostname = tag.text.lower()
hostname = hostname.replace("www.","")
if tag.get('name') == "operating-system":
os = tag.text.split("\n")
if hostIP: #apparently nessus doesn't always have an IP to work with...
if hostname:
print "Gathering Nessus info for {} ( {} )".format(hostIP,hostname)
else:
print "Gathering Nessus info for",hostIP
created, ip = self.IPAddress.find_or_create(ip_address=hostIP)
if hostname:
if not args.internal:
created, domain = self.Domain.find_or_create(domain=hostname)
if ip not in domain.ip_addresses:
ip.save()
domain.ip_addresses.append(ip)
domain.save()
else:
created, domain = self.Domain.find_or_create(domain=hostname)
if ip not in domain.ip_addresses:
domain.ip_addresses.append(ip)
domain.update()
if os:
for o in os:
if not ip.OS:
ip.OS = o
else:
if o not in ip.OS.split(" OR "):
ip.OS += " OR "+o
self.getVulns(ip, ReportHost)
self.IPAddress.commit()
return
class Module(ToolTemplate):
"""
Module for running nmap. Make sure to pass all nmap-specific arguments at the end, after --tool_args
"""
name = "Nmap"
binary_name = "nmap"
def __init__(self, db):
self.db = db
self.BaseDomain = BaseDomainRepository(db, self.name)
self.Domain = DomainRepository(db, self.name)
self.IPAddress = IPRepository(db, self.name)
self.Port = PortRepository(db, self.name)
self.Vulnerability = VulnRepository(db, self.name)
self.CVE = CVERepository(db, self.name)
self.ScopeCIDR = ScopeCIDRRepository(db, self.name)
def set_options(self):
super(Module, self).set_options()
self.options.add_argument(
"--hosts",
help=
"Things to scan separated by a space. DO NOT USE QUOTES OR COMMAS",
nargs="+",
)
self.options.add_argument("--hosts_file", help="File containing hosts")
self.options.add_argument(
"-i",
"--hosts_database",
help="Use unscanned hosts from the database",
action="store_true",
)
self.options.add_argument("--rescan",
help="Overwrite files without asking",
action="store_true")
self.options.add_argument(
"--filename",
help="Output filename. By default will use the current timestamp.",
)
self.options.set_defaults(timeout=None)
def get_targets(self, args):
targets = []
if args.hosts:
if type(args.hosts) == list:
targets += args.hosts
else:
targets += [args.hosts]
if args.hosts_database:
if args.rescan:
targets += [
h.ip_address
for h in self.IPAddress.all(scope_type="active")
]
targets += [h.cidr for h in self.ScopeCIDR.all()]
else:
targets += [
h.ip_address
for h in self.IPAddress.all(tool=self.name,
scope_type="active")
]
targets += [h.cidr for h in self.ScopeCIDR.all(tool=self.name)]
if args.hosts_file:
targets += [
l for l in open(args.hosts_file).read().split("\n") if l
]
# Here we should deduplicate the targets, and ensure that we don't have IPs listed that also exist inside CIDRs
data = []
for t in targets:
ips = [str(i) for i in list(IPNetwork(t))]
data += ips
_, file_name = tempfile.mkstemp()
open(file_name, "w").write("\n".join(list(set(data))))
if args.output_path[0] == "/":
self.path = os.path.join(self.base_config["PROJECT"]["base_path"],
args.output_path[1:])
else:
self.path = os.path.join(self.base_config["PROJECT"]["base_path"],
args.output_path)
if not os.path.exists(self.path):
os.makedirs(self.path)
if args.filename:
output_path = os.path.join(self.path, args.filename)
else:
output_path = os.path.join(
self.path,
"nmap-scan-%s.xml" %
datetime.datetime.now().strftime("%Y.%m.%d-%H.%M.%S"),
)
return [{"target": file_name, "output": output_path}]
def build_cmd(self, args):
command = "sudo " + self.binary + " -oX {output} -iL {target} "
if args.tool_args:
command += args.tool_args
return command
def process_output(self, cmds):
self.import_nmap(cmds[0]["output"])
os.unlink(cmds[0]["target"])
def parseHeaders(self, httpHeaders):
bsHeaders = [
"Pragma",
"Expires",
"Date",
"Transfer-Encoding",
"Connection",
"X-Content-Type-Options",
"Cache-Control",
"X-Frame-Options",
"Content-Type",
"Content-Length",
"(Request type",
]
keepHeaders = {}
for i in range(0, len(httpHeaders)):
if httpHeaders[i].strip() != "" and httpHeaders[i].split(
":")[0].strip() not in " ".join(bsHeaders):
hName = httpHeaders[i].split(":")[0].strip()
hValue = "".join(httpHeaders[i].split(":")[1:]).strip()
keepHeaders[hName] = hValue
if keepHeaders == {}:
keepHeaders = ""
return keepHeaders
def import_nmap(
self,
filename): # domains={}, ips={}, rejects=[] == temp while no db
nFile = filename
try:
tree = ET.parse(nFile)
root = tree.getroot()
hosts = root.findall("host")
except:
print(nFile + " doesn't exist somehow...skipping")
return
tmpNames = []
tmpIPs = (
{}
) # tmpIps = {'127.0.0.1':['domain.com']} -- not really used; decided to just let nslookup take care of IP info
skip = []
for host in hosts:
hostIP = host.find("address").get("addr")
created, ip = self.IPAddress.find_or_create(ip_address=hostIP)
for hostname in host.findall("hostnames/hostname"):
hostname = hostname.get("name")
hostname = hostname.lower().replace("www.", "")
reHostname = re.search(
r"\d{1,3}\-\d{1,3}\-\d{1,3}\-\d{1,3}",
hostname) # attempt to not get PTR record
if not reHostname:
created, domain = self.Domain.find_or_create(
domain=hostname)
if ip not in domain.ip_addresses:
domain.ip_addresses.append(ip)
domain.save()
for port in host.findall("ports/port"):
if port.find("state").get("state"):
portState = port.find("state").get("state")
hostPort = port.get("portid")
portProto = port.get("protocol")
created, db_port = self.Port.find_or_create(
port_number=hostPort,
status=portState,
proto=portProto,
ip_address=ip,
)
if port.find("service") != None:
portName = port.find("service").get("name")
if portName == "http" and hostPort == "443":
portName = "https"
else:
portName = "Unknown"
if created:
db_port.service_name = portName
info = db_port.info
if not info:
info = {}
for script in port.findall(
"script"): # just getting commonName from cert
if script.get("id") == "ssl-cert":
db_port.cert = script.get("output")
cert_domains = self.get_domains_from_cert(
script.get("output"))
for hostname in cert_domains:
hostname = hostname.lower().replace("www.", "")
created, domain = self.Domain.find_or_create(
domain=hostname)
if created:
print("New domain found: %s" % hostname)
elif script.get("id") == "vulners":
print(
"Gathering vuln info for {} : {}/{}\n".format(
hostIP, portProto, hostPort))
self.parseVulners(script.get("output"), db_port)
elif script.get("id") == "banner":
info["banner"] = script.get("output")
elif script.get("id") == "http-headers":
httpHeaders = script.get("output")
httpHeaders = httpHeaders.strip().split("\n")
keepHeaders = self.parseHeaders(httpHeaders)
info["http-headers"] = keepHeaders
elif script.get("id") == "http-auth":
info["http-auth"] = script.get("output")
elif script.get("id") == "http-title":
info["http-title"] = script.get("output")
db_port.info = info
db_port.save()
self.IPAddress.commit()
def parseVulners(self, scriptOutput, db_port):
urls = re.findall("(https://vulners.com/cve/CVE-\d*-\d*)",
scriptOutput)
for url in urls:
vuln_refs = []
exploitable = False
cve = url.split("/cve/")[1]
vulners = requests.get("https://vulners.com/cve/%s" % cve).text
exploitdb = re.findall(
"https://www.exploit-db.com/exploits/\d{,7}", vulners)
for edb in exploitdb:
exploitable = True
if edb.split("/exploits/")[1] not in vuln_refs:
vuln_refs.append(edb.split("/exploits/")[1])
if not self.CVE.find(name=cve):
# print "Gathering CVE info for", cve
try:
res = json.loads(
requests.get("http://cve.circl.lu/api/cve/%s" %
cve).text)
cveDescription = res["summary"]
cvss = float(res["cvss"])
findingName = res["oval"][0]["title"]
if int(cvss) <= 3:
severity = 1
elif (int(cvss) / 2) == 5:
severity = 4
else:
severity = int(cvss) / 2
if not self.Vulnerability.find(name=findingName):
# print "Creating", findingName
created, db_vuln = self.Vulnerability.find_or_create(
name=findingName,
severity=severity,
description=cveDescription,
)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
db_vuln.exploit_reference = {"edb-id": vuln_refs}
db_vuln.save()
else:
# print "modifying",findingName
db_vuln = self.Vulnerability.find(name=findingName)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
db_vuln.exploitable = exploitable
if db_vuln.exploit_reference is not None:
if "edb-id" in db_vuln.exploit_reference:
for ref in vuln_refs:
if (ref not in db_vuln.
exploit_reference["edb-id"]):
db_vuln.exploit_reference[
"edb-id"].append(ref)
else:
db_vuln.exploit_reference[
"edb-id"] = vuln_refs
else:
db_vuln.exploit_reference = {
"edb-id": vuln_refs
}
db_vuln.save()
if not self.CVE.find(name=cve):
created, db_cve = self.CVE.find_or_create(
name=cve,
description=cveDescription,
temporal_score=cvss)
db_cve.vulnerabilities.append(db_vuln)
db_cve.save()
else:
db_cve = self.CVE.find(name=cve)
db_cve.vulnerabilities.append(db_vuln)
db_cve.save()
self.Vulnerability.commit()
self.CVE.commit()
except:
print(
"something went wrong with the vuln/cve info gathering"
)
if vulners:
print(
"Vulners report was found but no exploit-db was discovered"
)
# "Affected vulners items"
# print vulners
print("Affected CVE")
print(cve)
pass
else:
db_cve = self.CVE.find(name=cve)
for db_vulns in db_cve.vulnerabilities:
if db_port not in db_vulns.ports:
db_vulns.ports.append(db_port)
return
def get_domains_from_cert(self, cert):
# Shamelessly lifted regex from stack overflow
regex = r"(?:[a-zA-Z0-9](?:[a-zA-Z0-9\-]{,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,6}"
domains = list(
set([d for d in re.findall(regex, cert) if "*" not in d]))
return domains
def __init__(self, db):
self.db = db
self.Vulnerability = VulnRepository(db, self.name)
class Report(ReportTemplate):
'''
This report pulls out any Nessus/nmap vulnerability findings,
looks for public exploits, and points to the exploits.
'''
name = "Exploitable"
def __init__(self, db):
self.db = db
self.Vulnerability = VulnRepository(db, self.name)
def set_options(self):
super(Report, self).set_options()
def run(self, args):
vulns = self.Vulnerability.all()
res = self.writePlain(vulns, args)
self.process_output(res, args)
def getEDB(self, thing):
searchsploit = json.loads(
subprocess.check_output("searchsploit -j {}".format(thing),
shell=True))
return searchsploit
def vulnInfo(self, findings, file):
res = []
if len(findings) > 0:
for finding in findings:
if finding.exploit_reference is not None:
res.append(finding.name)
vulnServices = finding.ports
res.append("Affected Hosts and Services:")
for service in vulnServices:
res.append("\t{} : {}/{}".format(
service.ip_address.ip_address, service.proto,
service.port_number))
res.append('')
for key in finding.exploit_reference.keys():
if key == 'metasploit':
res.append("Metasploit:")
for thing in finding.exploit_reference[key]:
res.append("\t" +
'msf> search name:"{}" type:exploit'
.format(thing))
res += ['', '']
if key == 'edb-id':
res.append("exploit-database:")
for thing in finding.exploit_reference[key]:
edb = self.getEDB(thing)
if edb['RESULTS_SHELLCODE']:
while i < len(edb['RESULTS_SHELLCODE']):
res.append(edb['RESULTS_SHELLCODE'][i])
res.append('')
i += 1
if edb['RESULTS_EXPLOIT']:
i = 0
while i < len(edb['RESULTS_EXPLOIT']):
res.append("\tExploit-DB Title:")
res.append(
"\t\t" +
edb['RESULTS_EXPLOIT'][i]['Title'])
res.append("\tLocal Path to Exploit:")
res.append(
"\t\t" +
edb['RESULTS_EXPLOIT'][i]['Path'])
url = "https://exploit-db.com/exploits/"
url += edb['RESULTS_EXPLOIT'][i][
'EDB-ID']
res.append(
"\tPossible url for exploit:")
res.append("\t\t" + url)
i += 1
res.append('')
res.append("#" * 20)
return res
def writePlain(self, vulns, args):
res = []
# if os.path.isfile(fileName):
# print (fileName,"exists.")
# answered = False
# while answered == False:
# rerun = raw_input("Would you like to [o]verwrite the file, or change the file [n]ame? ")
# if rerun.lower() == 'o':
# with open(fileName,"w") as file:
# answered = True
# elif rerun.lower() == 'n':
# new = False
# while new == False:
# newFile = raw_input("enter a new file name: ")
# if not os.path.isfile(newFile):
# fileName = newFile
# answered = True
# new = True
# else:
# print "That file exists as well"
# else:
# "Please enter \'o\' to overwrite the file, \'n\' to change the file name"
high = []
medium = []
low = []
info = []
for vuln in vulns:
if vuln.exploit_reference is not None:
if vuln.severity >= 4:
#if vuln not in high:
high.append(vuln)
if vuln.severity == 3:
#if vuln not in medium:
medium.append(vuln)
if vuln.severity == 2:
#if vuln not in low:
low.append(vuln)
if vuln.severity <= 1:
#if vuln not in info:
info.append(vuln)
if high:
res.append("High Severity Findings:")
res += self.vulnInfo(high)
if medium:
res.append("Medium Severity Findings:")
res += self.vulnInfo(medium)
if low:
res.append("Low Severity Findings:")
res += self.vulnInfo(low)
if info:
res.append("Info Severity Findings:")
res += self.vulnInfo(info)
return res
class Module(ModuleTemplate):
name = "Nmap"
def __init__(self, db):
self.db = db
self.BaseDomain = BaseDomainRepository(db, self.name)
self.Domain = DomainRepository(db, self.name)
self.IPAddress = IPRepository(db, self.name)
self.Port = PortRepository(db, self.name)
self.Vulnerability = VulnRepository(db, self.name)
self.CVE = CVERepository(db, self.name)
self.ScopeCIDR = ScopeCIDRRepository(db, self.name)
def set_options(self):
super(Module, self).set_options()
self.options.add_argument(
'--hosts',
help=
"Things to scan separated by a space. DO NOT USE QUOTES OR COMMAS",
nargs='+')
self.options.add_argument('--hosts_file', help="File containing hosts")
self.options.add_argument('--hosts_database',
help="Use unscanned hosts from the database",
action="store_true")
self.options.add_argument('--import_file', help="Import nmap XML file")
self.options.add_argument('-A',
help="OS and service info",
action="store_true")
self.options.add_argument(
'-o',
'--output_path',
help="Relative directory to store Nmap XML output name",
default="nmap")
self.options.add_argument('-nf',
'--nFile',
help="Nmap XML output name")
self.options.add_argument(
'-T',
'--timing',
help="Set timing template (higher is faster)",
default="4",
type=str)
self.options.add_argument(
'--scripts',
help="Nmap scripts",
default=
'ssl-cert,http-headers,http-methods,http-auth,http-title,http-robots.txt,banner'
)
self.options.add_argument(
'-p',
help="Comma separate ports to scan",
default=
"21,22,23,25,80,110,443,467,587,8000,8080,8081,8082,8443,8008,1099,5005,9080,8880,8887,7001,7002,16200"
)
self.options.add_argument('-Pn',
help="Disable ping",
action="store_true",
default=False)
self.options.add_argument('-sS',
help='Syn scan (default)',
action="store_true",
default=True)
self.options.add_argument('-sT',
help='TCP scan',
action="store_true",
default=False)
self.options.add_argument('-sU',
help='UDP scan',
action="store_true",
default=False)
self.options.add_argument('-OS',
help='Enable OS detection',
action="store_true",
default=False)
self.options.add_argument("--open",
help="Only show open ports",
action="store_true",
default=False)
self.options.add_argument("--top_ports", help="Only check X top ports")
self.options.add_argument("--force",
help="Overwrite files without asking",
action="store_true")
self.options.add_argument(
'--interactive',
help="Prompt to store domains not in Base Domains already",
default=False,
action="store_true")
self.options.add_argument(
'--internal',
help="Store domains not in Base Domains already",
action="store_true")
def run(self, args):
if args.binary:
if os.path.exists(args.binary):
command = args.binary + " "
else:
exit("Specified binary doesn't exist. Quitting now")
else:
if not which.run('nmap'):
exit("Nmap is not globally accessible. Quitting now")
else:
command = "nmap "
if args.output_path[0] == "/":
self.path = os.path.join(self.base_config['PROJECT']['base_path'],
args.output_path[1:])
else:
self.path = os.path.join(self.base_config['PROJECT']['base_path'],
args.output_path)
if not os.path.exists(self.path):
os.makedirs(self.path)
file_name = ""
if args.hosts:
if type(args.hosts) == list:
hosts = args.hosts
else:
hosts = [args.hosts]
_, file_name = tempfile.mkstemp()
open(file_name, 'w').write('\n'.join(hosts))
elif args.hosts_database:
hosts = [h.ip_address for h in self.IPAddress.all(tool=self.name)]
hosts += [h.cidr for h in self.ScopeCIDR.all(tool=self.name)]
_, file_name = tempfile.mkstemp()
open(file_name, 'w').write('\n'.join(hosts))
elif args.hosts_file:
file_name = args.hosts_file
if file_name:
self.execute_nmap(args, file_name, command)
elif args.import_file:
self.import_nmap(args.import_file, args)
def execute_nmap(self, args, host_file, command):
if args.nFile:
nFile = os.path.join(self.path, args.nFile)
else:
nFile = os.path.join(self.path, "nmap-scan.xml")
# if type(hosts) == list:
# nFile = os.path.join(self.path,"nmaped_"+",".join(hosts).replace("/","_"))
# else:
# nFile = os.path.join(self.path,"nmaped_"+hosts.replace("/","_").replace(" ",","))
if os.path.isfile(nFile) and not args.force:
print(nFile, "exists.")
answered = False
while answered == False:
rerun = raw_input(
"Would you like to [r]un nmap again and overwrite the file, [p]arse the file, or change the file [n]ame? "
)
if rerun.lower() == 'r':
answered = True
elif rerun.lower() == 'p':
answered = True
return nFile
elif rerun.lower() == 'n':
new = False
while new == False:
newFile = raw_input("enter a new file name: ")
if not os.path.exists(path + newFile):
nFile = path + newFile
answered = True
new = True
else:
print("That file exists as well")
else:
"Please enter \'r\' to run nmap, \'p\' to parse the file"
if args.sS and args.sT:
technique = "-sT "
else:
technique = "-sS "
if args.sU:
technique += "-sU "
if args.A:
technique += "-A "
command += technique
command += "-T" + str(args.timing) + " "
if args.Pn:
command += "-Pn "
if args.open:
command += "--open "
if args.top_ports:
command += "--top-ports %s " % args.top_ports
if args.OS:
command += "-O "
command += "--script " + args.scripts + " "
command += "-p " + args.p + " "
command += " -iL %s " % host_file
command += "-oX " + nFile
if (args.sS and not args.sT) or args.OS:
if os.geteuid() != 0:
#exit("You need to have root privileges to run a Syn scan and OS detection.\nPlease try again, this time using 'sudo'. Exiting.")
command = "sudo " + command
scan = subprocess.Popen(command, shell=True).wait()
self.import_nmap(nFile, args)
return nFile
def parseHeaders(self, httpHeaders):
bsHeaders = [
'Pragma', 'Expires', 'Date', 'Transfer-Encoding', 'Connection',
'X-Content-Type-Options', 'Cache-Control', 'X-Frame-Options',
'Content-Type', 'Content-Length', '(Request type'
]
keepHeaders = {}
for i in range(0, len(httpHeaders)):
if httpHeaders[i].strip() != '' and httpHeaders[i].split(
":")[0].strip() not in " ".join(bsHeaders):
hName = httpHeaders[i].split(":")[0].strip()
hValue = "".join(httpHeaders[i].split(":")[1:]).strip()
keepHeaders[hName] = hValue
if keepHeaders == {}:
keepHeaders = ""
return keepHeaders
def import_nmap(self, filename,
args): #domains={}, ips={}, rejects=[] == temp while no db
nFile = filename
try:
tree = ET.parse(nFile)
root = tree.getroot()
hosts = root.findall("host")
except:
print(nFile + " doesn't exist somehow...skipping")
return domains, ips, rejects #needs to be changed for db
tmpNames = []
tmpIPs = {
} #tmpIps = {'127.0.0.1':['domain.com']} -- not really used; decided to just let nslookup take care of IP info
skip = []
for host in hosts:
hostIP = host.find("address").get("addr")
created, ip = self.IPAddress.find_or_create(ip_address=hostIP)
for hostname in host.findall("hostnames/hostname"):
hostname = hostname.get("name")
hostname = hostname.lower().replace("www.", "")
reHostname = re.search(
r"\d{1,3}\-\d{1,3}\-\d{1,3}\-\d{1,3}",
hostname) #attempt to not get PTR record
if not reHostname and not args.internal:
created, domain = self.Domain.find_or_create(
domain=hostname)
if ip not in domain.ip_addresses:
domain.ip_addresses.append(ip)
domain.save()
elif not reHostname and args.internal:
created, domain = self.Domain.find_or_create(
domain=hostname)
if ip not in domain.ip_addresses:
domain.ip_addresses.append(ip)
domain.save()
#else:
# print("IP hostname found? %s" % hostname)
for port in host.findall("ports/port"):
if port.find("state").get("state"):
portState = port.find("state").get("state")
hostPort = port.get("portid")
portProto = port.get("protocol")
created, db_port = self.Port.find_or_create(
port_number=hostPort,
status=portState,
proto=portProto,
ip_address=ip)
if port.find("service") != None:
portName = port.find("service").get("name")
if portName == "http" and hostPort == "443":
portName = "https"
else:
portName = "Unknown"
if created:
db_port.service_name = portName
info = db_port.info
if not info:
info = {}
for script in port.findall(
"script"): #just getting commonName from cert
if script.get("id") == "ssl-cert":
db_port.cert = script.get('output')
cert_domains = self.get_domains_from_cert(
script.get('output'))
for hostname in cert_domains:
hostname = hostname.lower().replace("www.", "")
created, domain = self.Domain.find_or_create(
domain=hostname)
if created:
print("New domain found: %s" % hostname)
elif script.get("id") == "vulners":
print(
"Gathering vuln info for {} : {}/{}\n".format(
hostIP, portProto, hostPort))
self.parseVulners(script.get("output"), db_port)
elif script.get("id") == "banner":
info["banner"] = script.get("output")
elif script.get("id") == "http-headers":
httpHeaders = script.get("output")
httpHeaders = httpHeaders.strip().split("\n")
keepHeaders = self.parseHeaders(httpHeaders)
info["http-headers"] = keepHeaders
elif script.get("id") == "http-auth":
info['http-auth'] = script.get("output")
elif script.get("id") == "http-title":
info['http-title'] = script.get("output")
db_port.info = info
db_port.save()
self.IPAddress.commit()
def parseVulners(self, scriptOutput, db_port):
urls = re.findall('(https://vulners.com/cve/CVE-\d*-\d*)',
scriptOutput)
for url in urls:
vuln_refs = []
exploitable = False
cve = url.split("/cve/")[1]
vulners = requests.get("https://vulners.com/cve/%s" % cve).text
exploitdb = re.findall(
'https://www.exploit-db.com/exploits/\d{,7}', vulners)
for edb in exploitdb:
exploitable = True
if edb.split("/exploits/")[1] not in vuln_refs:
vuln_refs.append(edb.split("/exploits/")[1])
if not self.CVE.find(name=cve):
#print "Gathering CVE info for", cve
try:
res = json.loads(
requests.get('http://cve.circl.lu/api/cve/%s' %
cve).text)
cveDescription = res['summary']
cvss = float(res['cvss'])
findingName = res['oval'][0]['title']
if int(cvss) <= 3:
severity = 1
elif (int(cvss) / 2) == 5:
severity = 4
else:
severity = int(cvss) / 2
if not self.Vulnerability.find(name=findingName):
#print "Creating", findingName
created, db_vuln = self.Vulnerability.find_or_create(
name=findingName,
severity=severity,
description=cveDescription)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
db_vuln.exploit_reference = {'edb-id': vuln_refs}
db_vuln.save()
else:
#print "modifying",findingName
db_vuln = self.Vulnerability.find(name=findingName)
db_vuln.ports.append(db_port)
db_vuln.exploitable = exploitable
if vuln_refs:
db_vuln.exploitable = exploitable
if db_vuln.exploit_reference is not None:
if 'edb-id' in db_vuln.exploit_reference:
for ref in vuln_refs:
if ref not in db_vuln.exploit_reference[
'edb-id']:
db_vuln.exploit_reference[
'edb-id'].append(ref)
else:
db_vuln.exploit_reference[
'edb-id'] = vuln_refs
else:
db_vuln.exploit_reference = {
'edb-id': vuln_refs
}
db_vuln.save()
if not self.CVE.find(name=cve):
created, db_cve = self.CVE.find_or_create(
name=cve,
description=cveDescription,
temporal_score=cvss)
db_cve.vulnerabilities.append(db_vuln)
db_cve.save()
else:
db_cve = self.CVE.find(name=cve)
db_cve.vulnerabilities.append(db_vuln)
db_cve.save()
self.Vulnerability.commit()
self.CVE.commit()
except:
print(
"something went wrong with the vuln/cve info gathering"
)
if vulners:
print(
"Vulners report was found but no exploit-db was discovered"
)
#"Affected vulners items"
#print vulners
print("Affected CVE")
print(cve)
pass
else:
db_cve = self.CVE.find(name=cve)
for db_vulns in db_cve.vulnerabilities:
if db_port not in db_vulns.ports:
db_vulns.ports.append(db_port)
return
def get_domains_from_cert(self, cert):
# Shamelessly lifted regex from stack overflow
regex = r'(?:[a-zA-Z0-9](?:[a-zA-Z0-9\-]{,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,6}'
domains = list(
set([d for d in re.findall(regex, cert) if '*' not in d]))
return domains
#!/usr/bin/python
from armory import initialize_database
from armory import get_config_options
from database.repositories import BaseDomainRepository, DomainRepository, IPRepository, CIDRRepository, UserRepository, CredRepository, VulnRepository, PortRepository, UrlRepository, ScopeCIDRRepository
config = get_config_options()
db = initialize_database(config)
Domains = DomainRepository(db, "Shell Client")
BaseDomains = BaseDomainRepository(db, "Shell Client")
IPAddresses = IPRepository(db, "Shell Client")
CIDRs = CIDRRepository(db, "Shell Client")
Users = UserRepository(db, "Shell Client")
Creds = CredRepository(db, "Shell Client")
Vulns = VulnRepository(db, "Shell Client")
Ports = PortRepository(db, "Shell Client")
Urls = UrlRepository(db, "Shell Client")
ScopeCIDRs = ScopeCIDRRepository(db, "Shell Client")
print("Make sure to use this script with ipython and -i")
print(" ipython -i shell.py")
print("Available database modules: Domains, BaseDomains, IPAddresses,")
print(" CIDRs, Users, Creds, Vulns, Services, Ports, Urls, ScopeCIDRs")