シンプルなYAMLベースのDSLに基づく高速でカスタマイズ可能な脆弱性スキャナー

Nucleiを使用した脆弱性スキャン

仕組み

• このプラグインは、ビルド実行環境のオペレーティングシステムとアーキテクチャに基づいて、GitHubからNucleiの最新リリースをダウンロードします。
• ダウンロードしたアーティファクトは解凍されます。
  • 既に実行中のビルドのワークスペースにNucleiバイナリが存在する場合、最初の2つのステップはスキップされます。
• Nucleiテンプレートがダウンロード/更新されます。
• ユーザーが指定した入力に基づいてスキャンが実行されます。

使用方法

• フリースタイルプロジェクトを作成または編集します。
• Nuclei脆弱性スキャナービルドステップを追加します。
• テストするターゲットWebアプリケーションのURLを入力します。
• オプション:
  • JiraやGitHubなどのプラットフォームで自動的に課題を作成できるレポート設定を追加します。以下の追加フラグを使用すると、ログレベルを上げてイシュートラッカー統合の潜在的な問題をデバッグできます。
  • 追加のCLI引数（例: -v、-debug）を追加します。
• デフォルトでは、このプラグインはNucleiの最新リリースバージョンを使用します。新しいメジャーバージョンがプラグインで使用されているCLIインターフェースと後方互換性がない稀なケースでは、古いバージョンを手動で選択して一時的に問題を回避できます。プラグインの更新をリクエストするにはチケットを作成してください。

手動ビルド

1. pom.xmlがあるルートディレクトリでMavenを使用してコードをビルドできます。
   • mvn clean package -DskipTests
2. ビルドされたアーティファクトは ./target/nuclei.hpi にあります。
3. mvn hpi:run を使用して、プラグインがプリインストールされたJenkinsデプロイメントを起動できます。
   • デバッグを有効にするには mvnDebug hpi:run を使用し、実行構成に次のパラメータを追加してリモートデバッガをアタッチします: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000

プルリクエストを作成する前に、以下の手順を必ず実行してください:

1. プロジェクト内でテストを実行します（-DskipTestsフラグを削除）。
2. 完全なJenkinsインスタンスでプラグインをテストします:
   • <jenkins_install_dir>/plugins（例: /var/lib/jenkins/plugins/nuclei.hpi）内のnuclei.hpiファイルをコピー/上書きしてプラグインを「インストール」できます。
   • Jenkinsサービスを再起動してください（sudo service jenkins restart）。
3. プライマリ（マスター）ノードとリモートエージェントでもプラグインの実行をテストします。

最初からやり直す

1. targetフォルダ内のコンパイル済みクラスと生成されたアーティファクトを削除します: mvn clean
2. 現在のユーザーからNuclei設定を削除します（存在する場合）: rm -rf ~/.config/nuclei
3. _jenkins_ユーザーからNuclei設定を削除します（存在する場合）: sudo rm -rf <jenkins_install_dir>/.config/nuclei（例: /var/lib/jenkins/.config/nuclei）
4. Nucleiバイナリ、そのテンプレート、生成された出力を削除します: sudo rm -rf <jenkins_install_dir>/workspace/<build_name>/nuclei*
5. リモートエージェントに接続して同じことを行います。

制限事項

• フリースタイルプロジェクトのみサポート（パイプラインなし）
• スキャナーバイナリはバンドルされておらず、エージェントはインターネットアクセスが必要です。

Nucleiドキュメント

• https://nuclei.projectdiscovery.io
• https://github.com/projectdiscovery/nuclei