Profile 庫：把掃描依據搬進後台管理

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    autonumber
    participant U as 管理者 (FE 管理頁)
    participant BE as BE
    participant TS as 平台儲存
(local/minio/remote_agent)
    participant DB as config.detection_tool_profiles

    Note over U: 選工具 (inspec | gcb, P7 必選)
選 source_type (file | url, P5)
    alt source_type = file
        U->>BE: 上傳 tar.gz + name/description
        BE->>BE: 驗證：副檔名/大小上限 (D4)
tar 結構含 inspec.yml (D8)
streaming 防 slip/bomb 不落地解壓
        BE->>BE: 計算 sha256（信任根）
        alt scope = SYSTEM（root 維護公版）
            BE->>TS: upload_system_file()（root 儲存）
        else scope = TENANT（租戶自有）
            BE->>TS: upload_files_for_tenant()
        end
        BE->>DB: INSERT profile（file_id + sha256, version=1, is_current=TRUE）
    else source_type = url
        U->>BE: 登記 URL + name/description
        BE->>DB: INSERT profile（url 字串, 平台不經手檔案・不驗可達性 P5）
    end
    BE-->>U: 列表更新（任務抽屜下拉即刻可選）
    Note over U,DB: 版更＝同名 INSERT 新 version + 舊版 is_current=FALSE（P4）
fork＝公版複製成 scope='TENANT' 自有副本

圖 1 · 管理面：上傳 / 登記 / 版更流程（FE → BE → 儲存 → profile 表）

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    autonumber
    participant U as 使用者 (FE)
    participant BE as BE
    participant AG as agent
    participant TGT as 掃描目標主機
(SSH/WinRM)

    U->>BE: 發起執行（params.profile = 庫內參照）
    BE->>BE: start_execution() 建 agent_tasks(pending)
    AG->>BE: 心跳 POST /api/1.0/agents/heartbeat（mTLS）
    BE->>BE: _collect_pending_tasks() 偵測庫參照
展開 _profile {uid, version, sha256, source_type, ...}
    BE-->>AG: pending_tasks payload（夾 _profile）
    AG->>BE: ack
    alt file 型：cache 判斷
        AG->>AG: 查 /data/content/cache/<uid>/v<version>/
sha256 命中 → 直接用
        opt cache miss
            AG->>BE: GET /api/1.0/agents/files/<uid>
（mTLS，FR-058.7 通道，profile_ref 授權 D6）
            BE-->>AG: 串流回傳 tar.gz（BE 不落地）
            AG->>AG: 重算 sha256 對帳（不符即 fail）
存入 cache
        end
        AG->>AG: cinc-auditor exec <cache 內 tarball>
（CINC 原生吃 tarball 不解壓）
    else url 型 / 手填值
        AG->>AG: cinc-auditor exec <url 或原樣字串>（現行為）
    end
    AG->>TGT: SSH/WinRM 連線掃描（profile 不送目標主機）
    TGT-->>AG: 掃描結果
    AG->>BE: 回報 result（既有 mTLS 通道，報告走 blob 回收）
    BE-->>U: 執行紀錄顯示結果

圖 2 · 執行面：派工 → 心跳夾參照 → agent cache 判斷 → miss 拉檔 → sha256 對帳 → cinc-auditor 執行

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
    subgraph LIB["config.detection_tool_profiles（雙軌）"]
      SYS["SYSTEM 公用版
root 維護・全租戶可見不可改
（8 支 TWGCB 搬遷 P3）"]
      TEN["TENANT 自有版
各租戶上傳・自管
（fork 公版亦落此軌）"]
    end
    subgraph SRC["任務抽屜 profile 三層取值來源（P6）"]
      F1["庫內 file 型
agent 走通道拉檔＋cache"]
      F2["庫內 url 型
agent 原樣交 cinc-auditor"]
      F3["現場手填
不進庫・單次執行用"]
    end
    subgraph CH["agent 取檔通道（FR-058.7 建，本案復用 P2）"]
      EP["GET /api/1.0/agents/files/<uid>
純 mTLS＋授權 resolver"]
      R1["source_file resolver
（058.7：一次性輸入檔）"]
      R2["profile_ref resolver
（本案新增：任務引用的 profile, D6）"]
    end
    AG["agent
cache /data/content/cache/<uid>/v<version>/
sha256 對帳"]
    FE["任務抽屜下拉
options_source=profile_library
帶 detection_tool_id 過濾（P7）"]

    SYS --> FE
    TEN --> FE
    FE --> F1
    FE --> F2
    FE --> F3
    F1 -->|"派工展開 _profile"| EP
    EP --> R1
    EP --> R2
    R2 --> AG
    F2 -.->|"url 原樣下發"| AG
    F3 -.->|"原樣下發（現行為）"| AG

圖 3 · 架構關係：公版 / 自有雙軌 ＋ 三層取值來源 ＋ 與 FR-058.7 通道（雙 resolver）的關係