Cyntrisec Cli

🚀 Cyntrisec CLI

Cyntrisec CLI 是一個只讀的命令行工具，主要用於 AWS 基礎設施的能力圖分析和攻擊路徑發現。它可以掃描 AWS 基礎設施，構建能力圖，發現從互聯網到敏感目標的攻擊路徑，並根據投資回報率（ROI）對修復措施進行優先級排序。

Cyntrisec Labs 項目。Cyntrisec 的主要產品是 EphemeralML，這是一個具有加密收據的機密 AI 推理工具（AIR v1）。此 CLI 是一個獨立的 Labs 工具。PyPI 包名 cyntrisec 和 MCP 服務器 ID io.github.cyntrisec/cyntrisec 是穩定的，不會改變。

⚠️ 重要提示

測試版軟件聲明：此工具目前處於 測試版。它按“原樣”提供，不提供任何形式的保證。雖然 Cyntrisec 默認是一個只讀分析工具，但用戶需對基於其發現所採取的任何行動承擔全部責任。在應用之前，請始終審查 生成的修復計劃和 Terraform 代碼。

🚀 快速開始

前提條件：確保你已經安裝並配置了 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 基礎設施：通過 AssumeRole 掃描 AWS 基礎設施。
• 構建能力圖：構建能力圖（包括 IAM、網絡和依賴關係）。
• 發現攻擊路徑：發現從互聯網到敏感目標的攻擊路徑。
• 優先級排序：根據投資回報率（ROI）對修復措施進行優先級排序。
• 識別未使用的能力：識別未使用的能力，以減少影響範圍。
• 輸出確定性 JSON：輸出帶有證明鏈的確定性 JSON。

📦 安裝指南

pip install cyntrisec

Windows PATH 修復

如果你看到 “cyntrisec 未被識別” 的錯誤，說明 Scripts 文件夾未添加到 PATH 中：

# 選項 1：使用 python -m 運行
python -m cyntrisec --help

# 選項 2：在當前會話中添加到 PATH
$env:PATH += ";$env:APPDATA\Python\Python311\Scripts"

💻 使用示例

基礎用法

以下是一個簡單的掃描示例：

cyntrisec scan --role-arn arn:aws:iam::123456789012:role/CyntrisecReadOnly

高級用法

查看攻擊路徑並篩選出風險評分大於 0.7 的路徑：

cyntrisec analyze paths --format json | jq '.paths[] | select(.risk_score > 0.7)'

📚 詳細文檔

命令說明

核心分析

設置與驗證

修復措施

策略測試

代理接口

MCP 服務器模式

將 Cyntrisec 作為 MCP 服務器運行，以便與 AI 代理集成：

# 安裝支持 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 包
• 網站
• Twitter/X