Tenable MCP (Management Control Panel)

Tenable MCP（Management Control Panel）

Tenable.io のセキュリティデータを管理、可視化するための包括的なインターフェースを提供する Spring Boot アプリケーションです。

機能

• 設定管理

  • Tenable.io API 認証情報を簡単に設定できます
  • カスタム API エンドポイントに対応しています
  • タイムアウトと再試行ポリシーを設定できます

• セキュリティの可視化

  • 深刻度別の脆弱性分布
  • アセットの脆弱性トレンド
  • 脆弱性の多いアセットの分析
  • 脆弱性の経過期間の分布
  • 修復の進捗状況の追跡
  • アセットのリスクスコア分布
  • 脆弱性カテゴリの分析

• レポート

  • 包括的な CSV エクスポート
  • 詳細なセキュリティ態勢の概要
  • 期間をカスタマイズできるフィルタリング

前提条件

• Java 17 以降
• Gradle 7.x 以降（プロジェクトに含まれています）
• Docker（任意。コンテナ化されたデプロイに使用）
• Tenable.io API 認証情報

クイックスタート

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/tenablemcp.git
   cd tenablemcp
   

2. セットアップスクリプトを実行します：

   chmod +x setup.sh
   ./setup.sh
   

3. 設定を更新します： src/main/resources/application.yml を編集して Tenable.io の認証情報を設定します：

   tenable:
     apiKey: "your-api-key"
     accessKey: "your-access-key"
     secretKey: "your-secret-key"
     baseUrl: "https://cloud.tenable.com"
   

4. アプリケーションを実行します：

   ./gradlew bootRun
   

Docker での実行

1. Docker イメージをビルドします：

   docker build -t tenable-mcp .
   

2. コンテナを実行します：

   docker run -p 8080:8080 tenable-mcp
   

API エンドポイント

設定

• GET /api/config

  • 現在の設定を取得します
  • レスポンス：現在の設定

• POST /api/config

  • 設定を更新します
  • リクエストボディ：設定パラメーターを含む JSON
  • 例：

    {
      "accessKey": "your-access-key",
      "secretKey": "your-secret-key",
      "baseUrl": "https://cloud.tenable.com"
    }
    

可視化

• GET /api/v1/visualizations/report

  • 包括的なセキュリティレポートを取得します
  • クエリパラメーター：
    • startTime（任意）：ISO-8601 形式の開始時刻
    • endTime（任意）：ISO-8601 形式の終了時刻
  • レスポンス：複数の可視化データを含む JSON

• GET /api/v1/visualizations/export/vulnerabilities

  • レポートを CSV としてエクスポートします
  • クエリパラメーター：
    • startTime（任意）：ISO-8601 形式の開始時刻
    • endTime（任意）：ISO-8601 形式の終了時刻
  • レスポンス：CSV ファイルのダウンロード

可視化の種類

1. 脆弱性分布

   • 深刻度別の分布を示す円グラフ
   • 見やすいように色分けされています

2. アセットの脆弱性トレンド

   • 時間の経過に伴う脆弱性のトレンドを示す折れ線グラフ
   • セキュリティ態勢の改善状況を追跡できます

3. 脆弱性の多いアセット

   • 最も脆弱性の多いアセットを示す棒グラフ
   • 修復作業の優先順位付けに役立ちます

4. 脆弱性の経過期間の分布

   • 脆弱性の経過期間を示す円グラフ
   • 長期間未解決の脆弱性を特定できます

5. 修復の進捗状況

   • 修正済みと未解決の脆弱性を示すドーナツグラフ
   • 修復の有効性を追跡します

6. アセットのリスクスコア分布

   • アセットのリスクスコアの分布を示す棒グラフ
   • リスクの高いアセットを特定できます

開発

プロジェクト構成

src/main/kotlin/com/tenable/mcp/
├── config/         # Configuration classes
├── controller/     # REST controllers
├── service/        # Business logic
├── client/         # Tenable.io API client
└── model/          # Data models

ビルド

./gradlew clean build

テストの実行

./gradlew test

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. Pull Request を作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

サポート

サポートが必要な場合は、GitHub リポジトリで issue を作成するか、メンテナーにお問い合わせください。