跳至主要内容
版本:PrivStation 4.0.0
Markdown 原文

Tenant Scope 與資料隔離

在 PrivAI 中,系統會依據呼叫請求所使用的 API Key,自動判斷可存取的資料範圍(Tenant Scope)。

Tenant Scope 說明​

  • 使用租戶 Key 時,系統僅允許存取該 API Key 所建立(所屬)的資源。

  • 使用 Master Key 時,系統可跨租戶檢視與管理所有資源。

  • 所有受租戶隔離保護的資源,其讀取、查詢、下載、更新與刪除操作,皆會套用相同的範圍限制。

受影響的資源類型​

Tenant Scope 會套用於以下資源:

  • File(檔案)

  • Fileset(知識版本),以及知識版本與檔案的關聯

  • Prompt(提示詞)

  • Report Template(報告模板,Beta)

  • Report(報告,Beta)

  • Chat Completions / 資料參考搜尋 / 問答集生成等功能所引用的上述資源

存取規則​

使用情境行為
租戶 Key 查詢檔案、知識版本、提示詞列表僅回傳該租戶的資源
租戶 Key 取得單一檔案 / Fileset / Prompt只能取得該租戶可見的資源
租戶 Key 指定其他租戶的資源 ID系統拒絕存取,視同該資源不存在,回傳對應的「找不到資源」錯誤
租戶 Key 呼叫 API Key 管理 API系統拒絕存取(AUTH_002)
Master Key 呼叫 PrivAI API可跨租戶檢視所有資料

資源歸屬原則​

  • 使用租戶 Key 建立的資源(例如上傳檔案、新增知識版本、新增提示詞),會自動歸屬於該租戶 Key。

  • 使用 Master Key 建立的資源不屬於任何租戶,僅 Master Key 可存取。

  • 在導入多 API Key 機制前已存在的資料,同樣不屬於任何租戶,僅提供 Master Key 存取。若需讓既有資料納入特定租戶範圍,應由系統管理者另行處理資料歸屬。

相關說明詳見「API 串接 & API 列表」章節。