Forerunner：一款支持多线程、Ping探测和数据提取的快速可扩展网络扫描库

作者：血梦日期：2020-07-02 浏览：391分类：神兵利器已提交百度收录

Forerunner

Forerunner是一个快速的、轻量级的并且可扩展的网络库，它可以帮助研究人员开发一个以网络为中心的健壮的应用程序，比如说IP扫描器、端口扫描器、客户端以及服务器等等。当前版本的Forerunner，能够支持针对端口和IP地址进行同步或异步扫描，并收集关于目标设备的地理位置信息和终端信息，比如说IP地址是否在线以及设备的物理MAC地址等等。这个库是一个完全面向对象和基于事件的库，这意味着扫描数据都将包含在精心编制的“scan”对象之中，而这些对象旨在处理涵盖从结果到异常的所有数据。

工具依赖

1、.NET Framework v4.6.1

功能介绍

方法名	描述	使用样例
Scan	扫描单个IP地址并收集信息	Scan("192.168.1.1");
ScanRange	扫描IP地址范围并收集信息	ScanRange("192.168.1.1", "192.168.1.255")
ScanList	扫描IP地址列表并收集信息	ScanList("192.168.1.1, 192.168.1.2, 192.168.1.3")
PortKnock	扫描单个IP地址的所有端口	PortKnock("192.168.1.1");
PortKnockRange	扫描IP地址范围内的所有端口	PortKnockRange("192.168.1.1", "192.168.1.255");
PortKnockList	扫描IP地址列表中的所有端口	PortKnockList("192.198.1.1, 192.168.1.2, 192.168.1.3");
IsHostAlive	每多少毫秒扫描一台主机N次	IsHostAlive("192.168.1.1", 5, 1000);
GetAveragePingResponse	获取目标主机的平均ping响应	GetAveragePingResponse("192.168.1.1", 5, 1000);
IsPortOpen	通过TCP&UDP来ping单个端口	IsPortOpen("192.168.1.1", 45000, new TimeSpan(1000), false);

工具下载

广大研究人员可以使用下列命令将项目源码克隆至本地：

git clone https://github.com/jasondrawdy/Forerunner.git

工具使用样例

IP扫描

在网络安全研究过程中，扫描一个网络是一种非常常见的任务了，因此我们应该通过尽可能简单的方法来实现这个目标，以方便未来的安全研究人员去做同样的事情。Forerunner是一个完全面向对象的功能库，因此非常适合所谓“即插即用”的情况。其中，用于IP扫描的对象被称之为IPScanObject，这个对象包含了下列几种参数属性：

Address (String)

IP (IPAddress)

Ping (Long)

Hostname (String)

MAC (String)

isOnline (Bool)

Errors (Exception)

有了对象的概念之后，我们可以尝试创建一个新的对象，并使用它来执行一次扫描任务。最简单的方法就是先创建一个新的Scanner对象，并通过它来访问我们的扫描方法。接下来，创建一个IPScanObject对象，并使用目标IP地址来设置其Scan方法。

同步扫描：



	using System;



	using Forerunner; // Remember to import our library.



	namespace Example



	{



	    class Program



	    {



	        static void Main(string[] args)



	        {



	            // Our IP we would like to scan.



	            string ip = "192.168.1.1";



	            // Create a new scanner object.



	            Scanner s = new Scanner();



	            // Create a new scan object and perform a scan.



	            IPScanObject result = s.Scan(ip);



	            // Output that we have finished the scan.



	            if (result.Errors != null)



	                Console.WriteLine("[x] An error occurred during the scan.");



	            else



	                Console.WriteLine("[+] " + ip + " has been successfully scanned!")



	            // Allow the user to exit at any time.



	            Console.Read();



	        }



	    }



	}

另一种方法是创建Scanner对象并订阅ScanAsyncProgressChanged或ScanAsyncComplete之类的事件处理程序，这样我可以完全控制异步方法，我可以控制它们影响应用程序的进度状态等等。

异步扫描：



	using System;



	using System.Threading.Tasks;



	using Forerunner; // Remember to import our library.



	namespace Example



	{



	    class Program



	    {



	        static void Main(string[] args)



	        {



	            // Our IP we would like to scan.



	            string ip = "192.168.1.1";



	            // Setup our scanner object.



	            Scanner s = new Scanner();



	            s.ScanAsyncProgressChanged += new ScanAsyncProgressChangedHandler(ScanAsyncProgressChanged);



	            s.ScanAsyncComplete += new ScanAsyncCompleteHandler(ScanAsyncComplete);



	            // Start a new scan task with our ip.



	            TaskFactory task = new TaskFactory();



	            task.StartNew(() => s.ScanAsync(ip));



	            // Allow the user to exit at any time.



	            Console.Read();



	        }



	        static void ScanAsyncProgressChanged(object sender, ScanAsyncProgressChangedEventArgs e)



	        {



	            // Do something here with e.Progress, or you could leave this event



	            // unsubscribed so you wouldn't have to do anything.



	        }



	        static void ScanAsyncComplete(object sender, ScanAsyncCompleteEventArgs e)



	        {



	           // Do something with the IPScanObject aka e.Result.



	            if (e.Result.Errors != null)



	                Console.WriteLine("[x] An error occurred during the scan.");



	            else



	                Console.WriteLine("[+] " + e.Result.IP + " has been successfully scanned!")



	        }



	    }



	}

端口扫描

跟IP地址扫描一样，端口扫描可以通过一组预定义的端口来尝试进行端口连接，并检查目标端口是否真正开启。它将尝试通过与每个端口进行连接并发送数据包来进行端口探测。这个功能同样是通过一个自定义对象来实现的，即"Port Knock Scan Object"，简称为“PKScanObject”。 PKScanObject对象实际上包含一个PKServiceObjects列表，该列表将保存返回的全部端口数据，该服务对象包含下列参数属性：

IP (String)

Port (Int)

Protocol (PortType)

Status (Bool)

首先，我们需要创建一个Scanner对象，然后创建一个新的PKScanObject对象并使用目标IP来设置PortKnock方法，然后工具将显示扫描结果给我们。

同步扫描：



	using System;



	using Forerunner; // Remember to import our library.



	namespace Example



	{



	    class Program



	    {



	        static void Main(string[] args)



	        {



	            // Our IP we would like to scan.



	            string ip = "192.168.1.1";



	            // Create a new scanner object.



	            Scanner s = new Scanner();



	            // Create a new scan object and perform a scan.



	            PKScanObject result = s.PortKnock(ip);



	            // Output that we have finished the scan.



	            if (result.Errors != null)



	                Console.WriteLine("[x] An error occurred during the scan.");



	            else



	                Console.WriteLine("[+] " + ip + " has been successfully scanned!")



	           // Display our results.



	           foreach (PKServiceObject port in result.Services)



	           {



	                Console.WriteLine("[+] IP: " + port.IP + " | " +



	                                  "Port: " + port.Port.ToString() + " | " +



	                                  "Protocol: " + port.Protocol.ToString() + " | " +



	                                  "Status: " + port.Status.ToString());



	           }



	           // Allow the user to exit at any time.



	           Console.Read();



	        }



	    }



	}

异步扫描：



	using System;



	using System.Threading.Tasks;



	using Forerunner; // Remember to import our library.



	namespace Example



	{



	    class Program



	    {



	        static void Main(string[] args)



	        {



	            // Our IP we would like to scan.



	            string ip = "192.168.1.1";



	            // Setup our scanner object.



	            Scanner s = new Scanner();



	            s.PortKnockAsyncProgressChanged += new PortKnockAsyncProgressChangedHandler(PortKnockAsyncProgressChanged);



	            s.PortKnockAsyncComplete += new PortKnockAsyncCompleteHandler(PortKnockAsyncComplete);



	            // Start a new scan task with our ip.



	            TaskFactory task = new TaskFactory();



	            task.StartNew(() => s.PortKnockAsync(ip));



	            // Allow the user to exit at any time.



	            Console.Read();



	        }



	        static void PortKnockAsyncProgressChanged(object sender, PortKnockAsyncProgressChangedEventArgs e)



	        {



	            // Display our progress so we know the ETA.



	            if (e.Progress == 99)



	            {



	                Console.Write(e.Progress.ToString() + "%...");



	                Console.WriteLine("100%!");



	            }



	            else



	                Console.Write(e.Progress.ToString() + "%...");



	        }



	        static void PortKnockAsyncComplete(object sender, PortKnockAsyncCompleteEventArgs e)



	        {



	            // Tell the user that the port knock was complete.



	            Console.WriteLine("[+] Port Knock Complete!");



	            // Check if we resolved an error.



	            if (e.Result == null)



	                Console.WriteLine("[X] The port knock did not return any data!");



	            else



	            {



	                // Check if we have any ports recorded.



	                if (e.Result.Services.Count == 0)



	                    Console.WriteLine("[!] No ports were open during the knock.");



	                else



	                {



	                    // Display our ports and their details.



	                    foreach (PKServiceObject port in e.Result.Services)



	                    { 



	                        Console.WriteLine("[+] IP: " + port.IP + " | " +



	                                          "Port: " + port.Port.ToString() + " | " +



	                                          "Protocol: " + port.Protocol.ToString() + " | " +



	                                          "Status: " + port.Status.ToString());



	                    }



	                }



	            }



	        }



	    }



	}