burp_history: Burp用HTTPトラフィック履歴レコーダー

Security

概要

burp_historyは、Burp Suiteで得られたHTTPトラフィックを記録・管理するための補助ツール群を収めたリポジトリです。README(英中併記)では「HTTP Traffic Recorder」として紹介され、セキュリティテストでのトラフィック保存、検索、後続分析のためのワークフローを想定しています。データベースへの格納をサポートするスクリプト(MySQL/Postgres用)が含まれており、侵入試験や検証作業で大量のリクエスト・レスポンスを扱う際に、履歴の永続化と管理を簡便に行えるように設計されています。利用にあたってはREADMEにある注意書き(学習・合法的利用限定)を順守する必要があります。

GitHub

リポジトリの統計情報

  • スター数: 10
  • フォーク数: 0
  • ウォッチャー数: 10
  • コミット数: 2
  • ファイル数: 5
  • メインの言語: Shell

主な特徴

  • Burp Suiteで取得したHTTPトラフィックをデータベースに格納するためのスクリプトを提供(MySQL / Postgres)。
  • 多言語README(英語・簡体中文)でインストールや使用方法を案内。
  • 軽量なシェルベース構成により、既存環境へ容易に組み込み可能。
  • 学習・テスト用途を重視した設計と法的注意喚起を明示。

技術的なポイント

READMEと含まれるスクリプト群から読み取れる技術的ポイントを整理します。burp_historyは「HTTP Traffic Recorder」として、Burpから出力されるトラフィック(おそらくログやエクスポートされたHTTPアイテム)を永続化することを目的にしており、永続化先としてMySQLおよびPostgresをサポートするShellスクリプトが用意されています。これにより、以下のワークフローが想定されます:Burpでトラフィックをエクスポート → スクリプトでパース・正規化 → SQLでDBに挿入、という流れです。

スクリプトがShellで提供されている点は導入の敷居を下げますが、大量データや複雑なパース処理を行う場合は性能やエラーハンドリングに注意が必要です。例えば、バルクインサートやトランザクション処理、エスケープ処理(SQLインジェクションの防止)を適切に行う構成が重要になります。Postgres/MySQL双方に対応したテンプレートを分けていることは、DB固有の型や機能(JSON列の扱い、全文検索、インデックス設計など)を活かした運用が可能であることを示唆します。

セキュリティ面では、機密性の高いHTTPヘッダやボディを格納する点から、保存先DBのアクセス制限、TLS接続、暗号化、ログローテーション/保持ポリシーの設計が推奨されます。READMEに法的注意が記載されているとおり、収集対象や利用目的を明確にし、正当な権限の下で運用することが前提です。

運用面の利点としては、DBに格納することでクエリによる高速検索、期間やホスト単位の絞り込み、他ツールとの統合(SIEM、分析パイプライン)などが容易になります。一方、設計時にはスキーマ(リクエストID、タイムスタンプ、メソッド、URL、ヘッダ、ボディ、レスポンスステータス等)やインデックス、UTF-8/バイナリデータの取り扱い、ストレージ容量管理を検討する必要があります。

拡張や改善案としては:

  • バルク挿入/バッチ処理の導入でパフォーマンス向上。
  • JSON/LOB列の適切な扱いと圧縮保存(例:PGでのTOAST、MySQLのCOMPRESSEDストレージ)。
  • 認証付きAPIでの取り込みを想定した小さな中間サービス(Go/Python)を挟むことで入力検証やメタデータ付与を行う設計。
  • ダッシュボードや簡易検索UIを追加して、非技術者でもトラフィック履歴を参照できるようにする改良。

以上を踏まえ、burp_historyは軽量かつ実用的な出発点を提供しており、セキュリティテスターのワークフローに合わせてスキーマや投入処理を強化していくことで、実務での有用性が高まります。

プロジェクトの構成

主要なファイルとディレクトリ:

  • Mysql.sh: file
    • MySQL向けのインサート処理/スキーマ操作を行うシェルスクリプト。Burpから出力されたデータの取り込みテンプレートを含む想定。
  • Postgres.sh: file
    • PostgreSQL向けの取り込みスクリプト。行指向の挿入や型定義、検索最適化のための設定サンプルが含まれることを想定。
  • README.md: file
    • 簡体中文の説明。導入手順、利用上の注意、機能の解説等を記載。
  • README_EN.md: file
    • 英語版README。英語でのインストール/使用ガイドが含まれる。
  • imgs: dir
    • ロゴや使用例スクリーンショット等の画像資産を格納。

(各スクリプトはリポジトリの性質上テンプレート的な実装である可能性が高く、本番運用前に安全性・性能・エラーハンドリング等の確認とカスタマイズが必要です。)

まとめ

BurpのHTTPトラフィックをDBに蓄積し、検索・管理するための軽量なツール群。実務導入にはカスタマイズが必要。

リポジトリ情報:

READMEの抜粋:

HTTP Traffic Recorder

English | 简体中文

⚠️ 郑重声明

文中所涉及的技术、思路和工具仅供以安全为目的的学习交流使用,任何人不得将其用于非法用途以及盈利等目的,否则后果自行承担。

📋 目录

介绍

  • 作者小洲

  • 团队横戈安全团队,未来一段时间将陆续开源工具,欢迎关注微信公众号:

    logo

  • 定位:面向安全测试人员的 Burp Suite H…