lindi2/samlraiderSAML2 Burp 拡張機能
SAML Raider は、SAML インフラストラクチャをテストするための Burp Suite 拡張機能です。SAML メッセージの操作と X.509 証明書の管理という 2 つのコア機能を備えています。
このソフトウェアは、Hochschule für Technik Rapperswil (HSR) での学士論文の一環として、Roland Bischofberger と Emanuel Duss によって作成されました。私たちのプロジェクトパートナーでありアドバイザーでもあったのは、Compass Security Schweiz AG です。学士論文の期間中の素晴らしい協力とサポートに Compass に感謝します。
この拡張機能は 2 つの部分に分かれています。SAML メッセージエディタと証明書管理ツールです。
SAML Raider メッセージエディタの機能:
SAML Raider 証明書管理の機能:
ダウンロード: saml-raider-1.2.1.jar
Burp Suite を起動し、Extender タブの Add をクリックします。SAML Raider JAR ファイルを選択して拡張機能をインストールします。
SAML Raider をインストールする簡単な方法は BApp Store を使用することです。Burp を開き、Extender タブの BApp Store タブをクリックします。SAML Raider を選択し、Install ボタンをクリックして拡張機能をインストールします。
私たちの拡張機能を、お好みの数の星で評価するのをお忘れなく 😄。
SAML 環境をより快適にテストするには、プロキシ設定にインターセプトルールを追加できます。リクエストにパラメータ名 SAMLResponse が含まれているかどうかをチェックする新しいルールを追加してください。私たちの拡張機能の使用方法はほぼ自明であることを願っています 😄。質問があれば、遠慮なくお問い合わせください。
Burp Extender API はこちらにあります: https://portswigger.net/burp/extender/api/index.html。
プロジェクトを作業領域にクローンします:
git clone https://github.com/SAMLRaider/SAMLRaider.git
既存のプロジェクトを Eclipse ワークスペースにインポートします: File → Import... → Existing Projects into Workspace。クローンしたフォルダを選択し、Finish を押します。
最新版の Burp Suite を JAR ファイルとしてダウンロードし、lib フォルダに配置します。
Burp Suite JAR ファイルをライブラリに追加します: プロジェクトを右クリック → Properties → Java Build Path → Libraries で JAR ファイルを追加します。
ビルド自動化ツール Maven を使用して SAMLRaider をビルドできるように、maven をインストールします:
$ mvn install
Burp 拡張機能を Burp に読み込みます: Extender → Add → プロジェクトの ./target ディレクトリ内の (依存関係を含む) JAR ファイルを選択します。例: ./target/saml-raider-$VERSION-SNAPSHOT-jar-with-dependencies.jar。
その後、拡張機能をテストし、変更後に再ビルドできます。
ヒント: Burp を再起動せずに拡張機能を再読み込みするには、Ctrl キーを押しながら Extender タブの拡張機能の横にあるチェックボックスをクリックします。
拡張機能を Eclipse から直接起動するには、リポジトリを Eclipse にインポートします。既存の Maven プロジェクトを直接インポートできます。Eclipse Maven プラグイン m2e が必要であることに注意してください。これは最新の「Eclipse IDE for Java Developers」に含まれています。
Burp Suite JAR ファイルを lib フォルダに配置し、Burp JAR を Eclipse プロジェクトのライブラリとして追加します (Properties → Build Path → Libraries)。
パッケージエクスプローラーの Referenced Libraries の下で Burp JAR を開き、パッケージ burp 内の StartBurp.class を右クリックして Run As... → Java Application を選択すると、Burp が起動し、拡張機能が自動的に読み込まれます。(または Eclipse で: Run → Debug As → Java Application → StartBurp - burp → OK。)
デバッグモードを有効にするには、パッケージ helpers のクラス Flags の DEBUG フラグを true に設定します。これにより、すべての出力が SAMLRaiderDebug.log ログファイルに書き込まれ、テスト用のサンプル証明書が読み込まれます。
SAML レスポンスを Burp に送信するには、scripts/samltest ディレクトリ内のスクリプト samltest を使用できます。このスクリプトは saml_response からの SAML レスポンスを Burp (localhost:8080) に送信し、私たちのプラグインによって変更されたレスポンスを出力します。awk として gawk (GNU awk) と、xmllint コマンド用の libxml2-utils をインストールする必要があります。
フィードバックは大歓迎です! お問い合わせいただくか、GitHub で新しい issue を作成してください。
私たちの学士論文はオンラインで公開されており、こちらから入手できます: eprints_BA_SAML2_Burp_Plugin_SAML_Raider_eduss_rbischof.pdf。
ライセンスの権利と制限については、LICENSE ファイル (MIT ライセンス) を参照してください。