Recon-Scan

ReconScanは、FastAPIバックエンド、非同期ワーカーパイプライン、シングルページフロントエンドを備えたオープンソースのパッシブ偵察スキャナーです。デプロイされたサイトは https://recon-scan.vercel.app/ で確認できます。

狙いは迅速なシグナルです。スキャンを実行し、モジュールごとの検出結果を取得し、洗練されたPDFレポートとしてエクスポート可能なAIサマリーを取得できます。

注: AIトークンを使い果たしたため、デモは公開されていません。セルフホストは可能です。

このプロジェクトとは何か（そして何ではないか）

• これはパッシブ偵察です。エンドポイントのブルートフォース、ファジング、アクティブなエクスプロイトロジックの実行は行いません。
• 態勢のスナップショット、トリアージ、レポート作成に適しています。
• 完全なペネトレーションテストの代替ではありません。

機能

• 13のパッシブモジュール:
  • セキュリティヘッダー
  • SSL/TLS
  • DNS + メール認証 (SPF/DMARC/MX)
  • WHOIS
  • Robots/sitemap
  • サブドメイン列挙
  • 技術フィンガープリンティング
  • WAF検出
  • CORSチェック
  • Cookieセキュリティチェック
  • JS露出チェック
  • ディレクトリ露出チェック
  • レピュテーションチェック
• Redis + ARQワーカーによる非同期実行。
• キューへのエンキューが失敗した場合、インプロセスのバックグラウンド実行にフォールバック。
• OpenRouter / Anthropic / OpenAIによるオプションのAIサマリー。
• スキャン + AIサマリーからのPDFレポート生成。
• FastAPIが直接提供するフロントエンド（1つのURL、1つのアプリ）。

ワンコマンド起動（ローカル開発）

すぐに動かしたい場合:

./start.sh

これが行うこと:

• .env が存在しない場合、.env.example から作成します。
• 必要に応じて .venv を作成します。
• requirements.txt から依存関係をインストールします。
• http://localhost:8000 でホットリロード付きのFastAPIを起動します。
• Redis不要のローカル起動を容易にするため、USE_ARQ_QUEUE=false を強制します。

Ctrl+C で停止します。

ワンコマンド起動（Docker）

./start-docker.sh

これが行うこと:

• .env が存在しない場合、.env.example から作成します。
• Docker ComposeでAPI + ワーカー + Redisを起動します。

Docker起動（手動）

cp .env.example .env
docker compose up --build

ローカル開発（Dockerなし）

1. 依存関係をインストール:

pip install -r requirements.txt

2. envファイルを作成:

cp .env.example .env

3. APIを起動:

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

4. 別のターミナルでワーカーを起動（推奨）:

arq app.worker.WorkerSettings

5. 開く:

http://localhost:8000

テストの実行

テスト依存関係をインストール:

pip install -r requirements-dev.txt

全スイートを実行:

pytest -q

PDFレポート

スキャンが完了したら、UIで Download PDF をクリックします。

バックエンドエンドポイント:

• GET /scans/{scan_id}/report.pdf

レポートに含まれるもの:

• ターゲットとスキャンのメタデータ
• AIエグゼクティブサマリー（利用可能な場合はショート + フルナラティブ）
• 重大度スナップショットテーブル
• モジュールごとの詳細な検出結果

API

• GET /health
• POST /scans
  • bodyの例:
    • { "target": "example.com" }
    • { "target": "example.com", "byoapi_key": "...", "byoapi_provider": "your_provider" }
  • 注意:
    • byoapi_key は ALLOW_BYO_API_KEY=true でない限り拒否されます
    • プライベート / ループバック / 予約済みターゲットはブロックされます
    • user_id はオプションで、互換性のために保持されています
• GET /scans/{scan_id}
• GET /scans/{scan_id}/report.pdf

設定

.env.example より:

• DATABASE_URL (デフォルト: sqlite:///./reconscan.db)
• REDIS_URL (デフォルト: redis://localhost:6379)
• USE_ARQ_QUEUE (デフォルト: true)
• RATE_LIMIT_PER_MINUTE (デフォルト: 10)
• RATE_LIMIT_PER_DAY (デフォルト: 200)
• ALLOWED_HOSTS (デフォルト: localhost,127.0.0.1)
• CORS_ALLOWED_ORIGINS (デフォルト: ローカル開発オリジン)
• ALLOW_BYO_API_KEY (デフォルト: false)
• OPENROUTER_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY (オプション)
• VIRUSTOTAL_API_KEY, GOOGLE_SAFE_BROWSING_API_KEY (オプション)

コントリビューション

コントリビューションを歓迎します。特にパッシブ偵察モジュール、レポート、フロントエンドUX、テストカバレッジに関するものを歓迎します。

プルリクエストを開く前に、完全なコントリビューションガイドラインをお読みください:

Contributing Guide

注意

• 外部AIキーが設定されていない場合、ReconScanはローカルのフォールバックサマリーを保存します。
• SQLiteは、ローカルでの利用を容易にするためのデフォルトのストレージエンジンです。
• このリポジトリは意図的に軽量で、セルフホストに適しています。

ライセンス

MIT。LICENSE を参照してください。