jasondrawdy/forerunner高速で拡張可能なネットワークスキャンライブラリ。マルチスレッド、pingプローブ、スキャンフェッチャーを備えています。
Forerunnerライブラリは、高速・軽量・拡張可能なネットワーキングライブラリであり、IPスキャナ、ポートノッカー、クライアント、サーバーなどの堅牢なネットワーク中心のアプリケーション開発を支援するために作成されました。現在の状態では、Forerunnerライブラリは同期および非同期の両方でIPアドレスをスキャンおよびポートノックし、そのエンドポイントにあるデバイスに関する情報（IPがオンラインかどうか、物理MACアドレスなど）を取得できます。このライブラリは完全にオブジェクト指向かつイベントベースであり、スキャンデータは特別に設計された「スキャン」オブジェクトに格納され、結果から例外までのすべてのデータを処理するようになっています。
| メソッド | 説明 | 使用法 |
|---|---|---|
| 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のすべてのポートにpingを送信 | PortKnock("192.168.1.1"); |
| PortKnockRange | IPの範囲内のすべてのポートにpingを送信 | PortKnockRange("192.168.1.1", "192.168.1.255"); |
| PortKnockList | IPのリストを使用してすべてのポートにpingを送信 | PortKnockList("192.198.1.1, 192.168.1.2, 192.168.1.3"); |
| IsHostAlive | ホストにN回、Xミリ秒間pingを送信 | 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); |
ネットワークのスキャンはデジタル時代において一般的なタスクであり、将来のプログラマが簡単に実行できるように、私はこれを可能な限りシンプルにしました。Forerunnerライブラリは完全にオブジェクト指向であるため、プラグアンドプレイの状況に最適です。IPスキャン用のオブジェクトはIPScanObjectと呼ばれ、実際にはかなりの数のプロパティを含んでいます：
このオブジェクトを念頭に置いて、新しいオブジェクトを作成し、それを使ってスキャンを実行してみましょう。これには複数の方法がありますが、最も簡単な開始方法は、まず新しいScannerオブジェクトを作成してスキャンメソッドにアクセスできるようにすることです。次に、IPScanObjectを作成し、列挙したいIPを指定してScanメソッドに設定します。例：
using System;
using Forerunner; // ライブラリをインポートするのを忘れずに。
namespace Example
{
class Program
{
static void Main(string[] args)
{
// スキャンしたいIP。
string ip = "192.168.1.1";
// 新しいスキャナーオブジェクトを作成。
Scanner s = new Scanner();
// 新しいスキャンオブジェクトを作成してスキャンを実行。
IPScanObject result = s.Scan(ip);
// スキャンが完了したことを出力。
if (result.Errors != null)
Console.WriteLine("[x] スキャン中にエラーが発生しました。");
else
Console.WriteLine("[+] " + ip + " のスキャンに成功しました！")
// ユーザーがいつでも終了できるようにする。
Console.Read();
}
}
}
もう一つの方法は、私が好んで使う方法ですが、Scannerオブジェクトを作成し、ScanAsyncProgressChangedやScanAsyncCompleteなどのイベントハンドラにサブスクライブすることです。そうすることで、非同期メソッドを完全に制御でき、それらの進行状況がアプリケーションにどのように影響するかを制御できます。例：
using System;
using System.Threading.Tasks;
using Forerunner; // ライブラリをインポートするのを忘れずに。
namespace Example
{
class Program
{
static void Main(string[] args)
{
// スキャンしたいIP。
string ip = "192.168.1.1";
// スキャナーオブジェクトを設定。
Scanner s = new Scanner();
s.ScanAsyncProgressChanged += new ScanAsyncProgressChangedHandler(ScanAsyncProgressChanged);
s.ScanAsyncComplete += new ScanAsyncCompleteHandler(ScanAsyncComplete);
// 新しいスキャンタスクを開始。
TaskFactory task = new TaskFactory();
task.StartNew(() => s.ScanAsync(ip));
// ユーザーがいつでも終了できるようにする。
Console.Read();
}
static void ScanAsyncProgressChanged(object sender, ScanAsyncProgressChangedEventArgs e)
{
// e.Progressを使って何かを行うか、このイベントを購読せずに何もしないこともできます。
}
static void ScanAsyncComplete(object sender, ScanAsyncCompleteEventArgs e)
{
// IPScanObject（e.Result）を使って何かを行う。
if (e.Result.Errors != null)
Console.WriteLine("[x] スキャン中にエラーが発生しました。");
else
Console.WriteLine("[+] " + e.Result.IP + " のスキャンに成功しました！")
}
}
}
あなたが何を考えているか分かっています。ポートノッキング？はい、でもいいえ。この用語は、事前に定義された一連のポートを介して接続するという従来の意味でのポートノッキングではなく、単にポートが実際に開いているかどうかをチェックすることです。各ポートに接続してデータを送信することで、文字通りの「ノッキング」を行います。IPスキャンと同様に、ポートノッキングでは「Port Knock Scan Object」、略してPKScanObjectというカスタムオブジェクトを使用します。PKScanObjectは実際にはPKServiceObjectのリストを含んでおり、これらがポートデータを保持します。サービスオブジェクトには次のプロパティがあります：
ポートノッキングはIPスキャンと同様の方法です。まず、Scannerオブジェクトを作成します。次に、新しいPKScanObjectを作成し、選択したIPを指定してPortKnockメソッドに設定し、結果を表示します。例：
using System;
using Forerunner; // ライブラリをインポートするのを忘れずに。
namespace Example
{
class Program
{
static void Main(string[] args)
{
// スキャンしたいIP。
string ip = "192.168.1.1";
// 新しいスキャナーオブジェクトを作成。
Scanner s = new Scanner();
// 新しいスキャンオブジェクトを作成してスキャンを実行。
PKScanObject result = s.PortKnock(ip);
// スキャンが完了したことを出力。
if (result.Errors != null)
Console.WriteLine("[x] スキャン中にエラーが発生しました。");
else
Console.WriteLine("[+] " + ip + " のスキャンに成功しました！")
// 結果を表示。
foreach (PKServiceObject port in result.Services)
{
Console.WriteLine("[+] IP: " + port.IP + " | " +
"Port: " + port.Port.ToString() + " | " +
"Protocol: " + port.Protocol.ToString() + " | " +
"Status: " + port.Status.ToString());
}
// ユーザーがいつでも終了できるようにする。
Console.Read();
}
}
}
最後に、ポートノッキングを非同期で行う簡単な例を示します。本質的には同期の場合と同じですが、イベントを活用できる点が異なります。UIのクラッシュやシステムのロック状態を心配することなく、進行状況を取得できます。例：
using System;
using System.Threading.Tasks;
using Forerunner; // ライブラリをインポートするのを忘れずに。
namespace Example
{
class Program
{
static void Main(string[] args)
{
// スキャンしたいIP。
string ip = "192.168.1.1";
// スキャナーオブジェクトを設定。
Scanner s = new Scanner();
s.PortKnockAsyncProgressChanged += new PortKnockAsyncProgressChangedHandler(PortKnockAsyncProgressChanged);
s.PortKnockAsyncComplete += new PortKnockAsyncCompleteHandler(PortKnockAsyncComplete);
// 新しいスキャンタスクを開始。
TaskFactory task = new TaskFactory();
task.StartNew(() => s.PortKnockAsync(ip));
// ユーザーがいつでも終了できるようにする。
Console.Read();
}
static void PortKnockAsyncProgressChanged(object sender, PortKnockAsyncProgressChangedEventArgs e)
{
// 進行状況を表示して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)
{
// ポートノックが完了したことをユーザーに通知。
Console.WriteLine("[+] ポートノック完了！");