码迷,mamicode.com
首页 > 编程语言 > 详细

python-nmap的函数学习

时间:2018-03-13 18:07:40      阅读:653      评论:0      收藏:0      [点我收藏+]

标签:other   time   就是   gre   protocol   pytho   定义   font   prot   

 

简介


python-nmap是一个使用nmap进行端口扫描的python库,它可以很轻易的生成nmap扫描报告,并且可以帮助系统管理员进行自动化扫描任务和生成报告。同时,它也支持nmap脚本输出。

 

可以看到python-nmap只有四个py文件(__init__.py, nmap.py, test.py, test_nmap.py),下面就一一进行解读

技术分享图片

 

 

 __init__.py


 除去几十行的注释外,真正的代码只有四行,基本内容就是从同目录的nmap.py下导入一些基本信息:作者(__author__),版本(__version__),最后修改日期(__last_modification__),这些在nmap.py下都有写

技术分享图片

技术分享图片

 

 

 test.py


 test.py也只有简单的几行,运行时就是打印出本地的Host,猜测是用来测试是否可以利用nmap的扫描功能 技术分享图片

技术分享图片

 

 

nmap.py


nmap.py用于调用nmap的功能进行扫描,主要的扫描函数为PortScanner(object):

 

class PortScanner(object):

PortScanner类的英文注释就写着功能:PortScanner class allows to use nmap from python(PortScanner类允许在python使用nmap)

 

def __init__(self, nmap_search_path=(nmap, /usr/bin/nmap, /usr/local/bin/nmap, /sw/bin/nmap, /opt/local/bin/nmap)):

主要功能就是在nmap_search_path查找nmap的路径(从nmap_search_path可以看出在Windows下使用得自己添加路径)和初始化PortScanner模块,包括本机上nmap的路径(self._nmap_path),扫描的结果(self._scan_result),nmap的主版本(self._nmap_version_number),  nmap的子版本(self._nmap_subversion_number),  nmap输出的版本信息(self._nmap_last_output),是否找到nmap(is_nmap_found)

技术分享图片

技术分享图片

 

def get_nmap_last_output(self):

返回文本输出,可能用于调试,这里有作者的英文注释

 

def nmap_version(self):

如果检查到nmap返回nmap的版本信息

 

def listscan(self, hosts=127.0.0.1):

不进行扫描,但解析目标主机并返回一个主机列表

技术分享图片

 

def scan(self, hosts=127.0.0.1, ports=None, arguments=-sV, sudo=False):

调用nmap的扫描功能进行扫描,以json格式输出

 技术分享图片

 

def analyse_nmap_xml_scan(self, nmap_xml_output=None, nmap_err=‘‘, nmap_err_keep_trace=‘‘, nmap_warn_keep_trace=‘‘):

对nmap的扫描结果进行处理,扫描结果是XML形式,转化为json形式打印出来

 

def __getitem__(self, host):

返回目标ip

 

def all_hosts(self):

以列表形式返回目标ip

 

def command_line(self):

返回输入的命令行

 

def scaninfo(self):

以结构体形式返回扫描信息

 

def scanstats(self):

以结构体形式返回扫描状态

 

def has_host(self, host):

如果目标主机有回应就返回True(检查是否有目标主机)

 

def csv(self):

把csv输出转化为文本返回

 

 

def __scan_progressive__(self, hosts, ports, arguments, callback, sudo):

用于PortScannerAsync的回调

 

 

class PortScannerAsync(object):

允许异步使用python中的nmap,每个主机的扫描结果都会通过回调返回,进行多线程扫描

 

def __init__(self):

调用PortScanner()检查nmap所在的系统和和nmap版本

 

def __del__(self):

用于对self._process清零,self._process用来存放扫描信息

 

def scan(self, hosts=127.0.0.1, ports=None, arguments=-sV, callback=None, sudo=False):

调用多线程扫描,并且结果通过回调函数返回

 

def stop(self):

 停止当前的扫描过程

 

def wait(self, timeout=None):

等待当前扫描进程的结束和超时

 

def still_scanning(self):

检查当前进程是否还在扫描

 

 

class PortScannerYield(PortScannerAsync):

针对主机的扫描结果调用Yield进行处理

 

def __init__(self):

调用PortScanner()检查nmap所在的系统和和nmap版本

 

def scan(self, hosts=127.0.0.1, ports=None, arguments=-sV, sudo=False):

把扫描结果放到迭代器里进行回调

 

 

class PortScannerHostDict(dict):

PortScannerHostDict:用于存储和访问主机扫描结果的字典类

 

def hostnames(self):

以列表形式返回主机名

 

 def hostname(self):

返回第一个主机名,为了兼容性问题,不甚理解

 

def state(self):
def uptime(self):

 两个都是返回主机的状态信息

 

def all_protocols(self):

 all_protocols:以列表形式返回扫描的协议

 

def all_tcp(self):
def has_tcp(self, port):
def tcp(self, port):

 三个函数的作用就是列出扫描到的TCP端口的信息

 

def all_udp(self):
def has_udp(self, port):
def udp(self, port):

 三个函数的作用就是列出扫描到的UDP端口的信息

 

def all_ip(self):
def has_ip(self, port):
def ip(self, port):

 三个函数的作用就是列出扫描到的IP端口的信息

 

def all_sctp(self):
def has_sctp(self, port):
def sctp(self, port):

 三个函数的作用就是列出扫描到的SCTP端口的信息

 

 

class PortScannerError(Exception):

为PortScanner检测异常的类

 

返回异常信息

技术分享图片

 

 

 def __get_last_online_version():

 通过查询官网获得最新的python-nmap的版本信息,如0.6.1

 

 def convert_nmap_output_to_encoding(value, code="ascii"):

 对Unicode编码的scan_result对象进行编码的转换,作为字典返回

 

 

test_nmap.py


 test_nmap.py是用来对python-nmap进行测试和对nmap是否正常运行的检查,无论是pdb库还是nose测试框架都经常用于python的测试和调试

 

class Pdb(Plugin):

提供调试选项,如果在程序测试时遇到错误或故障会放到pdb里进行调试

 

def options(self, parser, env):

 定义命令行选项:包括--pdb, --pdb-failures,  --pdb-errors

 

def configure(self, options, conf):

 通过检查异常来匹配哪一个类型的异常触发插件

 

def addError(self, test, err):

 如果配置调试结果是调试错误把错误放入pdb

 

def addFailure(self, test, err):

 如果配置调试结果是调试失败把错误放入pdb

 

def debug(self, err):

 不甚理解,猜测是输出错误信息

 

def setup_module():

 设置扫描模块进行扫描

 

def test_wrong_args():

 测试输入的错误参数

 

def test_host_scan_error():

 测试主机扫描的错误

 

def xmlfile_read_setup():

 测试是否能读取xml文件

 

def test_command_line():

 测试输入命令行的命令是否合法

 

def test_scan_info():

 测试扫描信息是否存在

 

def test_all_hosts():
def test_host():
def test_host_no_hostname():
def test_port():

 45.33.32.156是nmap的官网里的一个机器人,用来测试nmap是否能正确的运行

 

def test_listscan():

测试列表扫描主机的结果

 

def test_csv_output():

 测试输出格式是否为CSV

 

def test_listscan():

 测试列表扫描

 

def test_ipv6():

 测试对IPV6的扫描

 

def test_ipv4_async():

 测试IPV4的异步扫描

 

def test_ipv6_async():

 测试IPV6的异步扫描

 

def scan_localhost_sudo_arg_O():

 扫描本地主机用户的信息

 

def test_sudo():

 测试主机信息

 

def test_parsing_osmap_osclass_and_others():

 测试是否获得主机的信息

 

def test_all_protocols():

 测试本地主机的信息

 

def xmlfile_read_setup_multiple_osmatch():

 读取osmatch_output.xml文件,设置osmatch的xml格式输出

 

def test_multipe_osmatch():

 检查主机的osmatch里是否存在一些信息

 

def test_convert_nmap_output_to_encoding():

 测试是否对nmap扫描结果进行了编码

 

def test_WARNING_case_sensitive():

 测试warning的警告信息是否存在

 

def test_scan_progressive():

 测试异步扫描的情况

 

总结


 总的来说,就是写一个python脚本来调用nmap工具里的功能,不过里面的思路还是值得我们去了解和学习的,可能分析的内容不是很全面和存在一些问题,存在疑问的可以和我交流,最后给出我在源码处的一些笔记和注释,结合博客一起看。

https://github.com/QKSword/python-nmap-analyse

 

python-nmap的函数学习

标签:other   time   就是   gre   protocol   pytho   定义   font   prot   

原文地址:https://www.cnblogs.com/QKSword/p/8508638.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!