CoWitness

CoWitness は、HTTP、HTTPS、DNS サーバーとして機能するように設計されたツールです。Web ページの配信、HTTP リクエストのログ記録、DNS レスポンスのカスタマイズが可能です。この README では、CoWitness ツールの機能概要と、コンパイル方法および使用方法について説明します。

機能

• HTTP サーバー: CoWitness には、ポート 80 で待ち受ける HTTP サーバーが含まれています。カレントディレクトリから静的ファイルを配信できます。各 HTTP リクエストは、クライアントの IP アドレス、要求されたリソース、ユーザーエージェントを含めてログに記録されます。

• HTTPS サーバー: HTTP サーバーに加えて、CoWitness はポート 443 で待ち受ける HTTPS サーバーも提供します。HTTP サーバーと同様に、静的ファイルを配信し、各リクエストをログに記録します。

• DNS サーバー: CoWitness は、ポート 53 で待ち受ける DNS サーバーとして機能します。NS レコードや A レコードを含む DNS レスポンスをカスタマイズできます。DNS リクエストは、クライアントの IP アドレスと要求されたドメインを含めてログに記録されます。

• ロギング: CoWitness は、HTTP および DNS リクエストのログファイルを作成します。ログは既存のファイルに追記されるため、サーバーアクティビティを追跡および分析できます。

• クワイエットモード: CoWitness は、-q コマンドライン引数を渡すことでクワイエットモードで実行できます。このモードでは、ASCII アートのバナーは表示されません。

前提条件 📝

CoWitness を使用する前に、次の要件を満たしていることを確認してください:

• システムに Go プログラミング言語がインストールされていること。入手は こちら 。ソースからビルドする場合は go 1.21 が必要です。
• Go の依存関係をダウンロードするためのインターネットアクセス。
• パブリック IP アドレスを持つリモートサーバー。

ビルド 👨🏼‍🔧

CoWitness をインストールおよびコンパイルするには、次の手順に従います:

1. GitHub から CoWitness リポジトリをクローンします:

git clone https://github.com/your-username/CoWitness.git

2. CoWitness ディレクトリに移動します:

cd CoWitness

3. CoWitness 実行可能ファイルをビルドします:

make -f Makefile build

このコマンドは CoWitness のソースコードをコンパイルし、amd64 および arm64 用の実行可能ファイルを作成します。

インストール 👨🏻‍💻

リモートサーバーで CoWitness を使用するには、次の手順に従います:

1. テスト環境用のドメイン名を選択します。
2. リモートサーバーをセットアップし、そのパブリック IP アドレスを取得します。
3. ネームサーバーがパブリック IP アドレスを指すように登録します。(ネームサーバーの設定方法については、ドメインレジストラのドキュメントを参照してください。)
4. IP アドレスをリモートサーバーに関連付けるグルーレコードを作成します。この手順は DNS プロバイダーによって異なる場合があります。グルーレコードの作成に関するガイダンスについては、プロバイダーのドキュメントを参照してください。
5. リモートサーバーでポート 80 および 53 が利用可能であることを確認します。これらのポートへの着信接続を許可するように、ファイアウォールまたはネットワーク設定を構成します。
6. SCP や SFTP などの安全な方法を使用して、CoWitness 実行可能ファイルをリモートサーバーに転送します。

SSH 経由でリモートサーバーに接続します:

ssh username@your-server-ip

CoWitness を簡単にインストールするには、ここ から自動パッケージビルドを取得する方法があります。 これを curl または wget でシステムにダウンロードするか、scp でシステムからファイルを転送できます。

cowitness

カスタマイズ ⚒️

CoWitness は、特定のニーズに合わせてカスタマイズできます。可能な変更の例をいくつか示します:

• デフォルトポートの変更: デフォルトポートを変更するには、CLI フラグの使用法ヘルプを参照してください。

• ログファイルパスの変更: ソースコード内の os.OpenFile 呼び出しを更新することで、HTTP および DNS ログファイル (http.log および dns.log) のパスを変更できます。

コミュニティとコントリビューション

コミュニティからのコントリビューションとフィードバックを歓迎します。問題が発生した場合や改善の提案がある場合は、GitHub リポジトリで issue を開くか、プルリクエストを送信してください!

ライセンス

CoWitness は MIT ライセンス の下でリリースされています。