Cyntrisec Cli

🚀 Cyntrisec CLI

Cyntrisec CLIは、AWSインフラストラクチャのセキュリティ分析を行うためのコマンドラインツールです。このツールは、AWS環境の攻撃パスを発見し、セキュリティ上の問題を特定し、最適な対策を提案します。

Cyntrisec Labsのプロジェクトです。 Cyntrisecの主要な製品はEphemeralMLで、暗号化されたレシートを用いた機密性の高いAI推論を行います（AIR v1）。このCLIは、独立したLabsツールです。PyPIパッケージ名のcyntrisecとMCPサーバーIDのio.github.cyntrisec/cyntrisecは安定しており、変更されることはありません。

⚠️ 重要提示

このツールは現在BETA版です。「現状のまま」提供され、いかなる保証もありません。 Cyntrisecはデフォルトで読み取り専用の分析ツールですが、ユーザーはその結果に基づいて行われるすべてのアクションについて責任を負います。 生成された対策計画とTerraformコードは、適用する前に必ず確認してください。

このツールは、AWSの機能グラフ分析と攻撃パスの発見を行います。

この読み取り専用のCLIツールは以下の機能を持ちます。

• AssumeRoleを介してAWSインフラストラクチャをスキャンします。
• 機能グラフ（IAM、ネットワーク、依存関係）を構築します。
• インターネットから機密ターゲットへの攻撃パスを発見します。
• ROI（セキュリティへの影響 + コスト削減）に基づいて修正策を優先順位付けします。
• 未使用の機能を特定し（影響範囲を縮小）、
• 証明チェーン付きの決定論的なJSONを出力します。

🚀 クイックスタート

前提条件: AWS CLIがインストールされ、資格情報が設定されていることを確認してください（例: aws configure）、または環境変数が設定されていることを確認してください。セットアップ手順ではterraformが必要です。

# 1. アカウントに読み取り専用のIAMロールを作成します
cyntrisec setup iam 123456789012 --output role.tf

# 2. Terraformを適用します
cd your-infra && terraform apply

# 3. スキャンを実行します
cyntrisec scan --role-arn arn:aws:iam::123456789012:role/CyntrisecReadOnly

# 4. 攻撃パスを表示します
cyntrisec analyze paths --min-risk 0.5

# 5. 最小限の修正策を見つけます（ROIで優先順位付けされます）
cyntrisec cuts --format json

# 6. HTMLレポートを生成します
cyntrisec report --output report.html

✨ 主な機能

• AWSインフラストラクチャのスキャンと機能グラフの構築
• 攻撃パスの発見と優先順位付け
• 未使用のIAMパーミッションの特定
• JSONやHTMLレポートの生成
• MCPサーバーモードでのAIエージェントとの統合

📦 インストール

pip install cyntrisec

Windows PATHの修正

「cyntrisecが認識されません」と表示される場合は、ScriptsフォルダがPATHに含まれていない可能性があります。

# オプション1: python -mで実行する
python -m cyntrisec --help

# オプション2: 現在のセッションのPATHに追加する
$env:PATH += ";$env:APPDATA\Python\Python311\Scripts"

💻 使用例

基本的な使用法

# AWSインフラストラクチャのスキャン
cyntrisec scan --role-arn arn:aws:iam::123456789012:role/CyntrisecReadOnly

# 攻撃パスの表示
cyntrisec analyze paths --min-risk 0.5

高度な使用法

# 最小限の修正策をJSON形式で取得
cyntrisec cuts --format json

# HTMLレポートの生成
cyntrisec report --output report.html

📚 ドキュメント

コマンド一覧

コア分析

セットアップと検証

対策

ポリシーテスト

エージェントインターフェイス

MCPサーバーモード

CyntrisecをAIエージェントとの統合のためのMCPサーバーとして実行します。

# MCPサポート付きでインストールする（現在はデフォルトで含まれています）
pip install cyntrisec

cyntrisec serve              # 標準入出力サーバーを起動します
cyntrisec serve --list-tools # 利用可能なツールを一覧表示します

MCPツール（15個）

Claude Desktop

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cyntrisec": {
      "command": "python",
      "args": ["-m", "cyntrisec", "serve"]
    }
  }
}

Claude Code (CLI)

サーバーを構成するには、以下のコマンドを実行します。

claude mcp add cyntrisec -- python -m cyntrisec serve

Google Gemini / Antigravity

エージェントの設定ファイル（例: ~/.gemini/antigravity/mcp_config.json）を見つけて、以下を追加します。

{
  "mcpServers": {
    "cyntrisec": {
      "command": "python",
      "args": ["-m", "cyntrisec", "serve"]
    }
  }
}

🔧 技術詳細

アーキテクチャ

+----------------------------------------------------------------------------------+
|                                   CYNTRISEC CLI                                   |
+----------------------------------------------------------------------------------+
| CLI Layer (Typer)                                                                 |
|   scan   analyze   cuts   waste   report   comply   can   diff   serve   ...      |
+-----------------------------+----------------------------------------------------+
| Core Engine                 | Storage (local)                                     |
|  - AWS collectors           |  ~/.cyntrisec/scans/<scan_id>/                      |
|  - Normalization/schema     |    snapshot.json, assets.json, relationships.json   |
|  - GraphBuilder -> AwsGraph |    findings.json, attack_paths.json                 |
|  - Path search -> paths     |  ~/.cyntrisec/scans/latest -> <scan_id>             |
|  - Min-cut + Cost (ROI)     |  (Windows fallback: latest is a file)               |
+-----------------------------+----------------------------------------------------+
| Outputs: JSON/agent, HTML report, remediation plan + Terraform hints              |
+----------------------------------------------------------------------------------+

データフロー

CLI (scan) --AssumeRole--> AWS Session --Describe/Get/List--> AWS APIs (read-only)
     |
     v
Collectors -> normalize -> Assets + Relationships -> AwsGraph
                                                |
                                                v
                                   Attack path search (BFS/DFS)
                                                |
                                                v
                                   Min-cut (remediation cuts)
                                                |
                                                v
                                      Cost engine (ROI)

Local artifacts: ~/.cyntrisec/scans/<scan_id>/*.json

📄 ライセンス

このプロジェクトはApache-2.0ライセンスの下で公開されています。

リンク

• PyPIパッケージ
• Webサイト
• Twitter/X