信任

Gateway 在呼叫當下轉送請求,寫入後無法讀取已封存的稽核內容。

已儲存的稽核內容(工具參數、上游請求與回應、交回給 Agent 的結果)採零存取加密:以 AES-256-GCM 封存,並用 ML-KEM-1024 將資料金鑰封給 Eisoptric 不持有的公鑰後即刪除資料金鑰。

cipher    AES-256-GCM
wrap      ML-KEM-1024
kdf        HKDF-SHA384

sealed    參數
sealed    上游請求
sealed    上游回應
sealed    下游結果

封存寫入時,這些欄位以零存取加密(ML-KEM-1024-HKDF-SHA384-AES-256-GCM)一起封存;等待核准與執行中的處理中內容則另以伺服器端金鑰加密保存 7 天。

三層保護,彼此分開。

密碼、成員私鑰與已封存的稽核內容不共用同一把秘密。

01

登入

瀏覽器先把密碼雜湊再送出。Eisoptric 再用 PBKDF2 雜湊一次,不保存密碼本身。

02

成員私鑰

另一把只在瀏覽器衍生的金鑰包住 ML-KEM 私鑰。登入用的雜湊解不開它。

03

工具 Payload

Gateway 在轉送呼叫時處理明文;寫入稽核紀錄前,以隨機 AES-256-GCM 資料金鑰加密並用 ML-KEM-1024 封給組織與每位成員公鑰,隨即刪除資料金鑰。

04

上游憑證

Access token 與 client secret 用 Gateway 自己的 ML-KEM-1024 金鑰封存,已授權的呼叫才能完成。Agent 拿不到密鑰。

一整筆呼叫,一個信封。

封存寫入時,這些欄位以零存取加密(ML-KEM-1024-HKDF-SHA384-AES-256-GCM)一起封存;等待核准與執行中的處理中內容則另以伺服器端金鑰加密保存 7 天。

參數

Agent 隨工具呼叫送出的參數。

上游請求

Eisoptric 轉送給工具的請求。

上游回應

工具回來的原始內容。

下游結果

Eisoptric 交回給 Agent 的結果。

Eisoptric 打得開與打不開的東西。

Eisoptric 打不開

  • 組織或成員的私鑰
  • 復原金鑰
  • 密碼,以及用來包成員私鑰的那把金鑰
  • 刪除資料金鑰後的已儲存稽核內容

Eisoptric 打得開

  • 誰呼叫、哪個工具、政策版本,以及決策
  • 轉送工具呼叫當下的明文,以及等待核准與執行中、以伺服器端金鑰加密保存 7 天的處理中內容
  • 上游憑證,且只在一筆已授權呼叫進行的期間
  • 主控台 API 只回報密鑰是否存在,不回報內容

常見問題

Eisoptric 能解密審計 Payload 嗎?
封存寫入稽核紀錄後不能。Gateway 在轉送工具呼叫當下會處理明文;寫入稽核紀錄前,資料金鑰以 ML-KEM-1024 封給組織與成員公鑰後即刪除,僅授權成員可於瀏覽器解密。等待核准與執行中的處理中內容則另以伺服器端金鑰加密保存 7 天。
登入密碼會在伺服器上解開私鑰嗎?
不會。登入送出的是雜湊。私鑰用另一把從不離開瀏覽器的金鑰包裝。
Agent 看得到 API Key 或 OAuth Token 嗎?
看不到。這些密鑰留在憑證金庫。Agent 只拿得到一筆經授權呼叫的結果。
組織還沒有 Payload 金鑰呢?
新的工具內容不會被保存。審計列只標示尚未加密,不寫入明文。

白皮書

Eisoptric MCP Gateway 系統白皮書

2026 年 10 月 18 日

狀態以 2026 年 10 月 18 日(台北時間)的產品為準。本文不是認證,也不是第三方稽核。白皮書和行銷文案說法不一致時,以本文為準。第二部分每個狀態只用四個標籤之一:【現況】(產品今天的實際行為)、【已修正】(之前發現的問題,修正已部署並複驗)、【未解決】(已知、還沒修好的問題)、【規劃中】(打算做、但還沒上線的改變;未列時程代表尚未承諾時程)。

第一部分:產品與架構 — 1. 摘要

AI 代理人開始直接呼叫真實系統:付款、寄信、改資料庫、開工單。問題不在代理人「能不能」做,而是誰允許它做、做了什麼、出事時能不能追回。

Eisoptric MCP Gateway 站在代理人和 MCP 伺服器之間。每一次工具呼叫都會經過四步:

  1. 認證:確認是哪個代理人在呼叫,每個代理人有自己的 OAuth 身分。
  2. 判定:依照適用於這個代理人的 policy,決定允許、拒絕,還是要人審批。
  3. 執行:只轉送已獲授權的呼叫;上游憑證留在 gateway,代理人拿不到。
  4. 稽核:每次呼叫都寫一筆稽核紀錄,已儲存的稽核內容採零存取加密封存。

設計原則只有一條:審批是許可,不是命令。人按下核准,不會讓工具直接執行;代理人必須用同一個 action ID 重新送出,gateway 會重新檢查期限、當下的 policy 和參數,全部吻合才執行。

2. 適用範圍與讀者

本文寫給要評估 Eisoptric 的技術負責人、資安和工程團隊。內容涵蓋:系統架構、代理人身分、policy、審批、上游憑證、金鑰階層與加密設計、資料分級與第三方資料流向、稽核、部署與營運,以及目前已知的邊界。

本文描述的是上述版本的產品行為。本文不是認證,也不是第三方稽核。每次重大變更都會更新本文並標上版本。

3. 產品方案

項目所有帳號
適用對象個人(Personal)與組織(Organization)
Eisoptric Workbench(AI 研究工作台)Apache 2.0 開源免費
MCP Gateway 與工具集(Tool sets)有(工具集數量無上限)
逐工具呼叫模式(Call/Approval)有
參數層級 Policy 規則與版本控制有
簽章 Webhooks有
群組(Groups)與多人審批門檻(Quorum)有
成員邀請、角色與逐員工 MCP 對應有(組織帳號)
稽核紀錄保存與零存取內容加密無限期(具備組織金鑰時零存取加密)
價格$0(完全免費,由贊助支持)

Eisoptric 完全免費,沒有付費方案。本文提到的參數層級 policy、簽章 webhook、群組與多人審批門檻,每個帳號都能使用;成員邀請與角色管理用於組織帳號。

4. 系統元件

參與方與信任邊界見第二部分 S2.1。Eisoptric 系統由下列十二個元件組成:

  • Cloudflare 邊緣:提供 WAF、機器人防護、邊緣速率限制與 TLS 終端(僅接受 TLS 1.2 與 1.3),並在轉送至原始服務時注入來源驗證標頭。
  • Gateway 服務(Cloud Run):處理 MCP 協定流量(initialize、tools/list、tools/call)、OAuth 2.1 認證、policy 判定、審批佇列、零存取稽核封存與主控台 API。
  • Webhook worker(獨立服務):負責發送 HMAC-SHA256 簽章的審批事件通知(核准、駁回、過期)與失敗重試,與主服務分離,互不拖累。
  • Session 與速率限制共用儲存(Redis):儲存跨實例的 MCP session 狀態、pub/sub 通知與應用層速率限制計數器。啟動時無法連線則服務拒絕啟動;執行期無法連線時,登入與註冊等驗證端點直接拒絕請求。
  • 資料庫:儲存組織、成員、代理人、工具目錄、版本化 policy、加密後的上游憑證、處理中內容密文與零存取稽核紀錄。
  • Cloud KMS:保管不離開硬體安全邊界的 HMAC 根金鑰,透過 MAC 運算依租戶推導上游憑證金鑰,並依組織推導處理中內容(7 天期效)的對稱加密金鑰。
  • Secret Manager:僅存放應用程式執行期非讀出明文不可的設定值(例如資料庫連線字串、來源驗證密鑰、系統鹽值),不存放任何組織或成員的 ML-KEM 私鑰。
  • 寄信服務:僅用於發送帳號驗證、密碼重設、成員邀請與審批通知信件,不傳送工具呼叫的原始回應內容。
  • Policy 草擬用的 LLM:供成員在主控台以自然語言輔助草擬或最佳化 policy 規則;產出的規則草案必須由成員人工確認並儲存後才會生效(傳送欄位見第 8 章)。
  • 主控台(瀏覽器端解密):成員登入、管理代理人與工具集、撰寫 policy、核准或駁回敏感呼叫,並在瀏覽器記憶體內解鎖成員 ML-KEM-1024 私鑰以解密零存取稽核內容。
  • Eisoptric Workbench(Apache 2.0 開源桌面應用):在本機運行、內含程式 Agent 的 AI 研究工作台(含獨立的本機 Runtime,只監聽本機迴路位址),可離線搭配本機模型運作,亦可連上 Eisoptric MCP Gateway 納入治理。
  • 客戶自己的 MCP 上游伺服器:客戶實際提供工具能力的外部或內部 MCP 伺服器(如帳務、CRM、資料庫、部署系統),只接收經 Eisoptric 授權並轉送的請求。

5. 一次工具呼叫的完整流程

從代理人連線到工具執行、封存與通知,一次完整的工具呼叫依序經過以下十二個步驟:

  1. OAuth 2.1 + PKCE 認證:代理人透過 OAuth 2.1 授權碼流程(強制 PKCE S256)取得綁定至該代理人與組織(或個人 profile)的存取權杖。未帶有效權杖呼叫 MCP 端點時回傳 401 與 RFC 9728 資源中繼資料。
  2. initialize 交握:代理人向 Eisoptric MCP 端點發送 initialize,建立綁定至該代理人身分的 MCP session(狀態寫入共用 Redis)。
  3. tools/list(依 tool set 過濾):代理人請求工具清單時,gateway 僅回傳該代理人獲派工具集(tool set)內、且該成員獲准存取之 MCP 伺服器上的有效工具;不在工具集內的工具對代理人而言不存在。
  4. tools/call 送出呼叫:代理人針對某個工具送出 tools/call 與參數。若代理人處於暫停狀態,呼叫立即被擋下。
  5. Policy 判定:gateway 取出適用於該代理人的有效 policy(依規則順序比對工具名稱與參數條件)以及工具本身的預設模式(Call 或 Approval),給出「允許(allow)」、「拒絕(deny)」或「需審批(approval required)」三種判定之一;若代理人完全沒有任何適用的 policy,預設判定為拒絕。
  6. 分流處理(允許/拒絕/需審批):若判定為「允許」,直接進入第 9 步轉送上游;若判定為「拒絕」,呼叫絕不送往上流,立即寫入拒絕稽核紀錄,並回傳結構化錯誤(含 reason、policy_id、how_to_allow)。
  7. 進入審批佇列(含群組 quorum):若判定為「需審批」,gateway 產生唯一的 action ID(即 gatewayRunId),將當下參數計算正規化 SHA-256 摘要,並將待審參數以每組織 KMS 推導金鑰加密保存(7 天到期)。呼叫進入審批佇列等待單一審核者核准,或等待所有必要審核群組(groups)達到法定門檻人數(quorum),同時回傳含審批連結與原因的結構化回應給代理人。
  8. 以同一 action ID 重送並重新檢查:審核者按下核准不會直接觸發工具執行(「審批是許可,不是命令」)。代理人必須帶上同一個 gatewayRunId 重新呼叫同一工具;gateway 會重新檢查三件事:核准與重送視窗是否尚未過期、重送當下的有效 policy 是否仍允許、以及重送的參數摘要是否與核准時綁定的參數完全一致。任一項不符即拒絕。
  9. 以 vault 憑證轉送上游:通過檢查後,gateway 從後量子憑證庫(vault)解密該上游 MCP 伺服器的憑證(僅在此次呼叫期間於記憶體中開啟),代代理人向上游發送工具呼叫並取得回應;若上游回傳 401 且具備 refresh token,gateway 自動完成續期後重試一次。
  10. 零存取封存:寫入長期稽核紀錄前,gateway 抽取一次性隨機 32-byte AES-256-GCM 資料金鑰,將工具參數、上游請求、上游回應、伺服器結果與代理人結果一起加密,再用 ML-KEM-1024 + HKDF-SHA384 將資料金鑰分別包裝給組織公鑰與每位有效成員的公鑰,寫入完成後立即刪除資料金鑰。若組織尚無可用的 ML-KEM 金鑰,內容不寫入,僅標記「加密不可用」。
  11. 寫入稽核紀錄:gateway 以原子計數器取得該組織遞增序號,將明文中繼資料(呼叫者、工具、policy 版本、判定結果、加密狀態、內容雜湊)與零存取密文信封寫入稽核表。
  12. 發送簽章 webhook:若審批狀態變更為核准、駁回或過期,獨立的 webhook worker 會將事件以 HMAC-SHA256 簽章送往客戶設定的 HTTPS 端點。Webhook 僅負責通知,其回應不會觸發工具執行。

6. 連接上游 MCP

客戶將外部或內部的 MCP 伺服器接入 Eisoptric 時,gateway 負責網路邊界檢查、工具探索與上游 OAuth 生命週期管理:

  • 註冊與網路邊界檢查:以 URL 註冊上游 MCP 伺服器時,gateway 強制要求 HTTPS(僅本機開發允許 localhost 的 HTTP),並解析主機名稱以封鎖私有網段、迴路位址、link-local 與雲端 metadata 位址,防止伺服器端請求偽造(SSRF)。
  • 自動工具探索:連線建立或手動重新整理時,gateway 對上游依序發送 MCP 標準的 initialize 與 tools/list,擷取每個工具的名稱、描述與 JSON inputSchema。若不同伺服器有同名工具,gateway 會自動加上伺服器名稱前綴以防命名衝突;上游已移除的工具則自動停用。
  • 代管上游 OAuth(動態註冊與自動續期):若上游 MCP 伺服器需要 OAuth 授權,Eisoptric 會自動探索上游的 OAuth 授權伺服器中繼資料,在支援時執行 Dynamic Client Registration(DCR),並透過帶 PKCE 的授權流程取得權杖。取得的 access token、refresh token 與 client secret 會個別以每租戶 ML-KEM-1024 金鑰封存入庫;當上游在呼叫或探索期間回傳 401 時,gateway 會自動使用 refresh token 更新權杖並重新封存。

7. 金鑰階層

Eisoptric 的密碼學設計分為兩棵彼此獨立的金鑰樹:一棵是由 Cloud KMS 根金鑰推導的「伺服器端金鑰樹」(用於上游憑證與 7 天處理中內容),另一棵是由瀏覽器端產生並保護的「零存取金鑰樹」(用於長期封存的稽核內容與成員私鑰)。兩棵樹不共用任何秘密。

金鑰層級演算法與推導方式產生與持有位置用途與保護範圍
Cloud KMS 根金鑰HMAC-SHA256 硬體保護金鑰Google Cloud KMS(永不離開 KMS)作為伺服器端推導每租戶與每組織金鑰的唯一根信任點
每租戶憑證金鑰(pq2.)KMS MAC 依組織與建立者推導種子 → ML-KEM-1024 → HKDF-SHA384 → AES-256-GCM執行期由 Gateway 向 KMS 請求推導,不寫入資料庫加密上游 MCP 伺服器的 access token、refresh token 與 client secret
每組織處理中內容金鑰(s2.)KMS MAC 依組織 ID 推導 32-byte 對稱金鑰 → AES-256-GCM(記憶體快取 300 秒)執行期由 Gateway 向 KMS 請求推導,不寫入資料庫加密等待核准的參數與執行中 run 的狀態(保存 7 天後到期)
組織 ML-KEM 金鑰對ML-KEM-1024(FIPS 203),公鑰 1,568 bytes、私鑰種子 64 bytes瀏覽器端產生;Gateway 僅存公鑰與加密備份接收零存取稽核紀錄的資料金鑰封裝,並供新成員加入或密碼重設後重包金鑰
成員 ML-KEM 金鑰對ML-KEM-1024(FIPS 203),私鑰種子以密碼衍生金鑰(PBKDF2 600,000 次 + AES-256-GCM)包裝瀏覽器端產生與解鎖(僅駐留頁面記憶體)成員在瀏覽器內解開零存取稽核內容與組織金鑰副本
組織 Recovery Key256-bit 隨機金鑰 → HKDF-SHA256(eisoptric-recovery-v1)→ AES-256-GCM建立組織金鑰時於瀏覽器顯示一次,永不上傳至伺服器管理員或全體成員遺失密碼備份時,於瀏覽器離線解開組織金鑰備份密文

這種分離確保了:即使攻擊者取得完整的資料庫傾印,沒有 KMS 呼叫權限就無法解開任何上游憑證或處理中內容;即使攻擊者能操作執行中的 gateway,也無法回頭解開已刪除資料金鑰的歷史零存取稽核紀錄,或解開成員的私鑰。

8. 資料分級與第三方資料流向

8.1 資料分級表

資料分級包含欄位儲存與加密方式Gateway 寫入後能否讀取保存期限
明文中繼資料呼叫者身分、代理人 ID、工具名稱、policy ID 與版本、判定結果、時間戳、原子序號、加密狀態、內容 SHA-256 雜湊資料庫明文儲存(供主控台搜尋、篩選與治理統計)能長期保存
處理中內容(Gateway 可讀 7 天)等待人工核准的工具參數、核准佇列脈絡、執行中(active run)的暫存狀態AES-256-GCM(前綴 s2.),金鑰由 Cloud KMS MAC 依組織推導能(為了在核准期間展示脈絡、比對重送摘要並接續轉送)7 天後到期
零存取稽核內容已封存的工具參數(arguments)、上游原始請求(raw_request)、上游原始回應(raw_response)、伺服器結果(server_result)、代理人結果(agent_result)隨機 32-byte AES-256-GCM 資料金鑰加密(org-mlkem1024-v1),再以 ML-KEM-1024 + HKDF-SHA384 包裝給組織金鑰與每位有效成員公鑰,寫完即刪除資料金鑰不能(僅授權成員可於瀏覽器內解密)長期保存
上游憑證(Vault)上游 MCP 伺服器的 OAuth access token、refresh token、client secret 與靜態授權標頭ML-KEM-1024 + HKDF-SHA384 + AES-256-GCM(前綴 pq2.),金鑰由 Cloud KMS MAC 依租戶推導只在完成一次已授權呼叫的期間於記憶體開啟長期保存(直到撤銷或重新連線)

8.2 Policy LLM 與第三方資料流向

當成員在主控台主動使用「AI 輔助草擬」或「最佳化 policy」功能時,gateway 會將產生規則所需的最小欄位送往由 Eisoptric 設定的 LLM 服務供應商(透過相容於 OpenAI Chat Completions 的 HTTPS API 呼叫):

  • 草擬 policy 時送出的欄位:組織內候選工具的名稱(name)、上游伺服器名稱(server)、工具描述(description,截斷至最多 500 字元)、參數結構摘要(inputSchema.properties,最多 30 個屬性,含型別、最多 12 個列舉值與最多 160 字元的屬性描述),以及成員輸入的自然語言需求說明(request,截斷至最多 4,000 字元)。
  • 最佳化現有 policy 時額外送出的欄位:該條 policy 目前綁定的工具名稱、決策(allow/require_approval/deny)與條件清單(field、operator、value)。
  • 絕不送往 Policy LLM 的資料:歷史工具呼叫的實際參數、上游回應內容、稽核紀錄、上游憑證、成員密碼雜湊或任何加密金鑰,均不會送往 LLM 服務供應商。若成員不使用 AI 草擬功能,則不會發起任何 LLM 呼叫。
  • 其他外部資料流向:除上述按需觸發的 Policy LLM 外,請求流量經由 Cloudflare 邊緣轉送;帳號與審批通知信件經由寄信服務發送(僅含通知連結與基本事件中繼資料);已授權的工具呼叫送往客戶自己註冊的上游 MCP 伺服器;審批事件簽章通知送往客戶自己設定的 webhook URL。

第二部分:安全架構 — S1. 概述與設計原則

S1.1 Eisoptric 保護什麼

AI 代理人開始直接呼叫真實系統:付款、寄信、改資料、開工單。Eisoptric 站在代理人和 MCP 上游伺服器之間,每一次工具呼叫都要經過四步:

  1. 認證:確認是哪一個代理人在呼叫。每個代理人有自己的 OAuth 身分。
  2. 判定:依照適用於這個代理人的 policy,決定允許、拒絕,或送人審批。
  3. 執行:只轉送已授權的呼叫。上游憑證留在 gateway 裡,代理人拿不到。
  4. 稽核:每次呼叫都寫一筆紀錄,已儲存的敏感內容採零存取加密封存。

S1.2 核心承諾

  • 代理人拿到的是結果,不是秘密。上游的 access token 和 client secret 不會交給代理人。
  • 代理人不被信任。Eisoptric 預設代理人可能被操控,或本身就是惡意的。它不能自己挑工具、不能持有上游憑證,也不能核准自己的呼叫。
  • 審批是許可,不是命令。人按下核准不會讓工具直接執行。代理人要用同一個 action ID 重送,gateway 重新檢查期限、當下的 policy 和參數,全部符合才執行。
  • 讀不到金鑰就不運作(fail-closed)。讀不到所需的金鑰材料時,gateway 不會啟動,也不會用明文寫入內容。

S1.3 誠實的限制

Eisoptric 限制的是代理人做得到什麼,不是代理人怎麼想。Eisoptric 看不到代理人的推理,也不檢查參數內容的語意。Eisoptric 的部分保證要靠平台營運方誠實運作,以及成員的瀏覽器沒有被入侵。這些前提和目前還沒修好的問題,第 S2 節和第 S10 節會逐條列出。

S2. 威脅模型與信任邊界

S2.1 參與方

參與方信任它做什麼不信任它做什麼
代理人(Agent)不信任。視為可能被操控或惡意。自己挑工具、持有上游憑證、核准自己的呼叫
MCP 上游伺服器回應已授權的呼叫看到被轉送的請求以外的任何東西,包括 Eisoptric 的憑證庫
Gateway(Eisoptric 服務)認證呼叫者、執行 policy、完成已授權的呼叫、寫稽核紀錄讀取成員私鑰,或解密已刪除資料金鑰的零存取稽核內容
平台營運方(有基礎設施存取權的人)誠實運行服務見 S2.3。實際上,營運方目前被信任的範圍包括:KMS 簽章權限的管理、呼叫當下轉送環境的完整性、稽核紀錄的保存和順序。
成員的瀏覽器執行未被竄改的 Eisoptric 程式,持有成員私鑰其他一律不信任。瀏覽器被入侵時,該成員的金鑰會外洩。
Eisoptric 網域與建置流程提供未被竄改的前端程式這是隱性信任方,見第 S7 節

S2.2 範圍內:Eisoptric 設計上要防的

  • 被入侵或惡意的代理人。防線有四道:每個代理人只看得到組織替它挑的工具(curated tool set);policy 規則(可以對參數設條件);需要人判斷的呼叫進入審批佇列;每個代理人有獨立的 OAuth 身分,每次呼叫都記在它名下,也可以單獨撤銷。
  • 不可信的 MCP 上游。上游憑證封存在 gateway 的憑證庫裡。代理人和上游都拿不到憑證庫的內容。
  • 資料庫副本外洩。上游憑證、處理中內容與已儲存的稽核內容在資料庫裡都是密文。上游憑證與處理中內容的金鑰由 KMS 依租戶/組織推導,KMS 金鑰不在資料庫裡;已儲存的稽核內容則以零存取加密封給組織與成員公鑰,連 gateway 也無法解密歷史紀錄。
  • 跨租戶存取。我們內部紅隊的已認證測試(不是第三方稽核)沒有找到跨租戶存取、IDOR 或權限提升:組織一律由 session 決定,無法用參數覆寫;偽造其他組織的物件 ID 只會得到 403 或 404。

S2.3 範圍外:Eisoptric 不防的

  • 代理人自身推理被提示注入(prompt injection)。被注入的內容說服代理人送出一個 policy 允許的呼叫,Eisoptric 會放行。Eisoptric 能限制被操控的代理人做到什麼,但不能阻止它被操控。
  • 內容層檢查與 DLP。policy 只檢查你宣告的條件。Eisoptric 不做 DLP,不辨識機密或個資,也不檢查參數內容的語意。
  • 能讀取 gateway 金鑰材料、或能用 KMS 金鑰做簽章運算的營運方。擁有 KMS MAC 簽章權限的服務身分,可以推導任何一個租戶的上游憑證金鑰與 7 天處理中內容金鑰(見第 S4 節與第 S6 節)。這樣的人也能刪除或重排稽核紀錄而不被發現(見第 S6.3 節)。
  • 成員的電腦或瀏覽器被入侵。惡意程式、惡意擴充功能或被劫持的 session,可以讀到該成員能解開的所有東西,包括私鑰解鎖後的內容。

S3. 身分與登入

S3.1 代理人身分

  • 【現況】代理人透過 OAuth 2.1 的 authorization code 流程取得身分,強制使用 PKCE S256。沒有 code_challenge 的請求,或想降級成 plain 的請求,都會被拒絕。redirect_uri 必須完全相符,帶前綴延伸的變形也會被拒,所以不會形成開放重新導向。
  • 【現況】支援 MCP 標準的 Dynamic Client Registration(DCR)。MCP 端點未認證時回 401,並依 RFC 9728 附上 resource metadata。
  • 【現況】代理人的 OAuth token 和成員的網頁 session 是兩個分開的認證平面。網頁 session token 不能用來呼叫 MCP gateway。
  • 【已修正】依 MCP 慣例,DCR 不需要認證,因此註冊端點已加上應用層速率限制(依真實客戶端 IP 跨實例計數),防止大量註冊濫用。
  • 【規劃中】對動態註冊的 OAuth client 加入異常監控,並定期清除長期閒置未使用的 client。

S3.2 成員登入與多因素驗證(MFA)

【現況】瀏覽器端:v2. 登入值。送出前,瀏覽器先用 Argon2id 處理密碼(salt 由 email 推導),再做 HKDF,然後送出 v2. 加十六進位字串。我們要講清楚這一步能做到什麼、不能做到什麼:

  • 它只是傳輸混淆,不是傳輸保護。送出的 v2. 值等同密碼:攔到它的人,不需要知道密碼就能登入。登入路徑真正的保護是 TLS,加上伺服器端的 Argon2id。
  • salt 由 email 推導,可以預測,也不是每次註冊隨機產生,所以有人能針對已知 email 預先計算。不要因為有這一步就高估客戶端雜湊的價值。
  • 它的價值有兩個:正常登入時,原始密碼不會離開瀏覽器;登入值和成員私鑰的包裝材料分開(domain separation),所以登入值解不開成員私鑰。

【現況】伺服器端:真正的保護。伺服器收到登入值後,用每個帳號各自隨機的 salt 再做一次 Argon2id,才寫入儲存。Eisoptric 不儲存密碼。登入後拿到的是伺服器端不透明的 session token,不是 JWT,所以沒有離線竄改或 alg=none 的攻擊面。登出會讓 token 立刻失效。成員私鑰解開後只放在頁面記憶體,token 也不寫進 localStorage。

【現況】舊帳號遷移的明確例外。舊格式的帳號(早期的 SHA-256 登入值或 PBKDF2 雜湊)在遷移截止前登入時,會經 TLS 送出一次原始密碼,讓伺服器驗證舊雜湊,再改寫成 Argon2id。這是「伺服器看不到密碼」的例外;系統已有遷移截止機制,截止後舊格式登入不再接受,未遷移的帳號必須重設密碼。

  • 【已修正】登入不再洩漏帳號是否存在。之前,已註冊和未註冊的 email 收到的錯誤回應不同,回應裡還帶有帳號的遷移狀態。現在兩者收到的 401 回應逐位元組完全相同,狀態碼、長度、內容都一樣,已經複驗。
  • 【已修正】一般登入端點、OAuth 登入端點與舊帳號遷移登入端點均已加上應用層速率限制。
  • 【已修正】管理員帳號強制設定 MFA。平台管理員與組織管理員必須完成啟用 TOTP 多因素驗證,否則管理與組織寫入操作會被拒絕。
  • 【已修正】TOTP 安全強化:TOTP secret 在資料庫中加密封存(不以明文存放);每個 30 秒時間步長(含前後時間窗共 90 秒有效範圍)內已驗證過的步長會被記錄,同一組驗證碼不可重複使用;連續輸入錯誤達 5 次即鎖定拒絕,防止暴力猜測。
  • 【規劃中】確保登入值不會寫進任何外部錯誤回報,並持續評估改用 augmented PAKE(例如 OPAQUE),讓登入值不再等同密碼(此項仍在評估,尚未承諾時程)。

S4. 上游憑證保管與成員私鑰

S4.1 上游憑證庫(Vault)現況

  • 【已修正】每個租戶各自一把金鑰。先前的共用 gateway 金鑰已汰換為每租戶 KMS 推導金鑰:現在每個租戶的憑證金鑰,由 Cloud KMS 的 MAC 運算依租戶推導。KMS 金鑰本身不離開 KMS,所以一個租戶的金鑰打不開其他租戶的憑證。只拿到資料庫副本的人,也推導不出任何租戶的金鑰。
  • 【現況】加密流程。每筆憑證密文的前綴是 pq2.。流程是 ML-KEM-1024(FIPS 203)封裝,接著 HKDF-SHA384,最後用 AES-256-GCM 加密。
  • 【現況】只在呼叫期間開啟。gateway 只在完成一次已授權的呼叫時,打開對應的那個憑證。代理人拿到的是呼叫結果,永遠拿不到憑證本身。
  • 【現況】fail-closed。gateway 取不到金鑰材料時不會啟動。

S4.2 邊界

  • KMS 簽章權限就是控制點。每租戶金鑰防的是資料庫外洩,防不了持有權限的人。凡是有 KMS MAC 簽章權限的服務身分,都能推導出任何一個租戶的金鑰。所以真正的防線是 IAM:只有 gateway 的執行身分有這項權限,而且要嚴格控管、記錄每一次存取。
  • 「只在呼叫期間開啟」是軟體在限制,不是密碼學在限制。這條規則靠程式邏輯和存取控制執行。密碼學本身沒有限制 gateway 什麼時候能打開憑證。
  • 等待審批的參數。等待審批的參數在儲存時是封存的(見第 S6 節的處理中內容)。核准後,gateway 要用明文參數才能完成呼叫。gateway 只在完成這次已核准的呼叫時處理明文,這一點同樣是軟體限制。
  • 建議客戶的作法。存進 Eisoptric 的上游憑證,請只給它需要的最小權限。

S4.3 舊格式憑證與金鑰輪替

  • 【已修正】舊格式憑證處理。早期格式的憑證密文不會被當成空值或靜默失敗,系統會明確標記為需要重新驗證,主控台介面也會顯示提示要求重新連線授權。
  • 【規劃中】KMS 金鑰版本目前是固定的,目前不支援金鑰輪替,請勿假設支援(見第 S8 節)。

S4.4 成員私鑰與組織金鑰備份

  • 【現況】每個成員在每個組織裡有自己的 ML-KEM-1024 私鑰。私鑰在瀏覽器裡用密碼推導的金鑰包裝後才上傳,Eisoptric 伺服器不保存能解開它的金鑰。
  • 【現況】包裝金鑰和登入值用不同的材料推導,所以登入值解不開私鑰。解開後的私鑰只放在頁面記憶體,分頁關掉就消失。
  • 【現況】可以用 256-bit 的 recovery key 救回組織金鑰。成員備份和 recovery key 都遺失時,私鑰與封存內容就救不回來,包括 Eisoptric 在內沒有人打得開。這是刻意的設計。
  • 【已修正】成員協助重設後重包組織金鑰時,瀏覽器會先重新向伺服器取得目標成員的公鑰並比對 SHA-256 公鑰指紋,指紋不符即拒絕封裝,防止替換公鑰的中間人攻擊。
  • 【現況】限制:成員被移除後,不會再有新內容包給他的金鑰。但已經包給他的舊內容,持有他私鑰和備份的人仍然打得開。移除成員能阻止未來的存取,收不回過去的存取。
  • 【未解決】目前一般成員也能透過 API 下載組織金鑰備份的密文(不是明文)。如果包裝用的密碼或備份保護不足,這會擴大離線攻擊面。
  • 【規劃中】將組織金鑰備份密文的下載權限改為僅限組織管理員。

S5. 政策引擎

S5.1 判定方式

  • 【現況】每次工具呼叫,都用適用於這個代理人的 policy 判定。規則可以設成允許、拒絕或需要審批。
  • 【現況】兩層控制:工具層級決定工具能否呼叫、設為自動執行或需人工審批;參數層級條件可以限制已允許呼叫的參數(例如 amount > 5000 時要審批,審批也會綁定這組參數)。每個帳號都能使用兩者。
  • 【現況】policy 有版本,每筆稽核紀錄都會記下當時用的 policy 版本。用 LLM 起草的 policy 不會自動生效,必須由人確認。

S5.2 審批流程與結構化錯誤

  1. policy 判定為需要審批時,代理人會拿到一個 action ID(gatewayRunId),呼叫進入審批佇列。
  2. 成員在主控台看到的是這一次、這組參數。
  3. 核准不會直接執行工具。代理人要用同一個 action ID 重送,gateway 會重新檢查三件事:核准是否已過期、當下的 policy 是否還允許、參數是否和核准的那組一致。參數不一致就拒絕。
  4. 審批結果用簽章 webhook 通知。webhook 只負責通知,不會觸發執行。

例子:代理人送出一筆 $5,800 的付款,主管核准了。代理人重送時把金額改成 $58,000,gateway 會拒絕,因為參數和核准的那組不一樣。

【已修正】被擋下的呼叫回傳結構化錯誤:`reason`、`policy_id`、`how_to_allow`。不回傳核准時的參數或摘要;`how_to_allow` 只指引送出核准請求,不能用來修改 policy。

S5.3 預設行為

  • 【已修正】工具層級:沒有規則的工具會被拒絕。代理人呼叫的工具如果沒有對應的規則,判定結果是拒絕。上游新增了現有規則沒提到的工具時,這個修正特別重要。
  • 【已修正】沒有適用 policy 時判定為拒絕。過去若代理人沒有任何適用的 policy 會被放行;現在當代理人沒有任何適用的 policy 時,政策引擎預設判定為拒絕(fail-closed),並在建立組織與連接上游時自動維護預設 policy。

S6. 稽核與零存取加密

Eisoptric 對已儲存的稽核內容採用零存取加密(zero-access encryption)。Gateway 在轉送工具呼叫時會處理明文;寫入稽核紀錄前,內容以 ML-KEM-1024 包裝至組織金鑰與各成員公鑰,資料金鑰隨即刪除。此後,Eisoptric 伺服器無法解密已儲存的內容,僅成員可於瀏覽器內開啟。

零存取加密不等同端對端加密。Gateway 在呼叫當下可讀取內容;若 gateway 遭入侵,其後的呼叫內容可能外洩,已封存的紀錄則不受影響。等待核准與執行中的內容另以伺服器端金鑰加密,保存 7 天,不在零存取範圍內。

資料加密gateway 寫入後能否讀保存
已儲存的稽核內容AES-256-GCM 資料金鑰,再以 ML-KEM-1024 + HKDF-SHA384 包裝給組織金鑰與每位有效成員的金鑰;寫完即刪資料金鑰不能長期
處理中內容(等待核准的參數、執行中的 run)AES-256-GCM,金鑰由 Cloud KMS MAC 依組織推導能(為了接續核准與轉送)7 天後到期
上游憑證ML-KEM-1024 + HKDF-SHA384 + AES-256-GCM,金鑰由 KMS MAC 依租戶推導只在完成已授權呼叫時開啟長期

S6.1 記錄什麼

  • 【現況】每次呼叫都寫一筆紀錄。可讀欄位包括:呼叫者、工具、policy 版本、判定結果、加密狀態與內容雜湊。
  • 【現況】已儲存的呼叫參數、上游請求、上游回應、伺服器結果與代理人結果,會以零存取信封(org-mlkem1024-v1)加密封存。
  • 【現況】當組織沒有任何可用的 ML-KEM 金鑰時,稽核內容不寫入,稽核列僅記錄「加密不可用(unavailable)」,絕不退回明文儲存。

S6.2 兩層內容封存的運作方式

  • 【現況】第一層(已儲存的稽核內容,零存取加密):gateway 對每筆稽核紀錄抽取隨機 32-byte 資料金鑰,以 AES-256-GCM 加密正規化 JSON(附加驗證資料 AAD 為組織 ID、紀錄 ID、欄位類型與格式版本 1),接著以 ML-KEM-1024 封裝並透過 HKDF-SHA384(info 為 eisoptric-payload-mlkem1024-v1)衍生包裝金鑰,將資料金鑰分別包給組織公鑰與每位有效成員公鑰,寫入後立即刪除資料金鑰。平台管理員 API 亦會過濾掉所有密文信封。
  • 【現況】第二層(等待核准與執行中的處理中內容,7 天伺服器端加密):等待人工審批的參數與執行中 run 的狀態,因為 gateway 在核准後必須讀取參數並轉送上游,所以使用由 Cloud KMS MAC 依組織推導的對稱金鑰進行 AES-256-GCM 加密(前綴 s2.),保存 7 天後自動到期失效。

S6.3 完整性

  • 【現況】逐筆雜湊。每筆紀錄都存一個 SHA-256 內容雜湊,成員在瀏覽器解密後可核對該筆內容有沒有被改。
  • 【已修正】序號原子產生。之前序號是用「目前筆數加一」算出來的,併發寫入時可能撞號,紀錄被刪除後也可能出現重複或藏住缺口。現在序號由一張原子計數表產生,併發寫入也不會重複。
  • 【未解決】沒有雜湊鏈,也沒有外部錨定。紀錄之間沒有密碼學上的串連。能直接存取資料庫的人,可以刪除、重排或截斷紀錄而不被發現。所以 Eisoptric 的稽核日誌目前不是防竄改的:完整性只保護到每一筆,不保護整份日誌。
  • 【未解決】內容雜湊沒有加金鑰。這個雜湊是不加鹽、不加金鑰的 SHA-256。能讀資料庫的人可以拿它比對猜測,對低熵內容(固定金額、是或否、簡短列舉值)特別有效。
  • 【規劃中】加上防竄改的雜湊鏈,讓每一筆都承諾前一筆的雜湊,並定期把鏈頭錨定到營運方控制不了的外部儲存;同時把內容雜湊改成帶金鑰的 MAC,或改由 AES-GCM 驗證標籤負責,不再另存明文摘要。

S7. 部署邊界與速率限制

S7.1 現況

  • 【現況】服務跑在 Google Cloud Run,對外的公開網域前面是 Cloudflare(WAF、機器人防護、邊緣速率限制)。只開放 HTTPS,TLS 只接受 1.2 和 1.3。
  • 【現況】API 和 dashboard 的每個回應都帶完整的安全標頭:嚴格的 CSP、HSTS、X-Frame-Options: DENY、鎖死的 Permissions-Policy、X-Content-Type-Options。API 的 CORS 只允許 Eisoptric 自己的 dashboard 來源。互動式 API 文件沒有對外開放。

S7.2 已修正項目

  • 【已修正】行銷網站安全標頭。之前行銷網站缺少 HSTS、CSP、防點擊劫持和 Permissions-Policy,現在全部補上。CSP 限制 script-src 'self',禁止 object-src,也禁止被嵌入框架。
  • 【已修正】密碼學程式自行託管。之前部分密碼學程式從外部 CDN 載入,而且沒有 Subresource Integrity。現在外部 CDN 已完全移除,密碼學程式和應用程式碼都由 Eisoptric 自己的網域打包提供,CSP 也不允許載入遠端腳本。OAuth 登入頁的雜湊程式同樣改成自行託管,載入失敗時直接擋下登入,不會退回舊格式。
  • 【已修正】應用層驗證 Cloudflare 來源標頭。過去若直接連線 Cloud Run 原始服務(origin)可跳過 Cloudflare WAF;現在後端與前端都在應用層以常數時間驗證 Cloudflare 邊緣注入的來源驗證 header,缺少或不符就立即回傳 403 拒絕。精確地說:origin 在網路層仍可連線,只是未經 Cloudflare 邊緣的請求會在應用層被拒絕。
  • 【已修正】速率限制以 Cloudflare 提供的真實客戶端 IP 計算,並透過 Redis 跨實例共用計數;當共用儲存(Redis)無法連線時,登入、遷移登入、註冊與動態用戶端註冊等驗證端點會直接拒絕請求(fail-closed),不會退回單機記憶體放行。
  • 【已修正】部署流程必須等待自動化測試與檢查工作流程通過後才會觸發上線。

S7.3 尚存邊界與規劃中項目

密碼學程式改為自行託管後,我們假設 Eisoptric 自己網域提供的打包程式是可信的。剩下的邊界是 Eisoptric 建置與發布流程的供應鏈完整性。

  • 【規劃中】移除 OAuth 登入頁 CSP 目前仍允許的內聯腳本(inline script)。
  • 【規劃中】在網路層進一步限制 Cloud Run 入口(例如透過負載平衡器或驗證過的 origin pull),與現有的應用層來源標頭驗證構成雙重防線。

S8. 加密技術附註

用途演算法是否後量子
已儲存的稽核內容(org-mlkem1024-v1)隨機 32-byte AES-256-GCM 資料金鑰,以 ML-KEM-1024 + HKDF-SHA384 包裝給組織與成員公鑰,寫完即刪資料金鑰是
處理中內容(s2.,等待核准與執行中)AES-256-GCM,金鑰由 Cloud KMS MAC 依組織推導(7 天到期)否
上游憑證庫(pq2.)ML-KEM-1024 → HKDF-SHA384 → AES-256-GCM,金鑰依租戶由 KMS MAC 推導是
成員私鑰備份ML-KEM-1024,在瀏覽器裡用密碼推導的金鑰(PBKDF2-HMAC-SHA256 600,000 次 + AES-256-GCM)包裝是
組織金鑰復原備份ML-KEM-1024,以 256-bit recovery key 經 HKDF-SHA256 + AES-256-GCM 包裝是
TOTP 秘密封存伺服器端對稱封存(加密存放於資料庫,不存明文)否
成員登入瀏覽器端 Argon2id + HKDF(v2.);伺服器端每個帳號隨機 salt 的 Argon2id不適用
稽核逐筆完整性SHA-256(正規化 JSON 摘要)不適用
  • FIPS 203 不等於 FIPS 140。我們使用 FIPS 203 標準化的 ML-KEM-1024,代表我們實作了這個演算法,不代表 Eisoptric 或它的密碼模組通過了 FIPS 140 驗證。
  • 還不支援金鑰輪替。推導租戶與組織金鑰的 KMS 金鑰版本目前是固定的,而且還沒有輪替後把現有密文重新包裝的自動化流程。在流程完成並寫進本章之前,目前不支援 KMS 金鑰輪替,請勿假設支援。
  • 記憶體清除。執行環境不保證敏感資料用完後一定會從記憶體清掉。所以我們的說法是「用完就丟棄、不保存」,不是「保證硬體抹除」。
  • 舊信封。早期用 X25519 包裝的稽核內容維持原狀,不會自動轉成 ML-KEM。

S9. 合規現況

  • 本章是 Eisoptric 對自身設計與限制的說明,不是認證,也不是第三方稽核。
  • Eisoptric 目前沒有任何認證。我們沒有 SOC 2 報告,也不聲稱符合 ISO 27001、HIPAA、FedRAMP 或其他框架。
  • SOC 2 與 ISO 27001 目前處於準備階段,尚未簽訂稽核機構。在簽約之前,不對外聲稱「SOC 2 進行中」或放置任何徽章。我們已備妥就緒路線圖,第一個目標是定點式的 Type I 報告,待補救項目完成後啟動。
  • 本章提到的紅隊測試都是 Eisoptric 內部進行的,不能拿來代替獨立的第三方評估。
  • 請不要從本章推論出任何合規聲明。使用 FIPS 203 演算法,不代表通過 FIPS 140 驗證(見第 S8 節)。

S10. 我們目前刻意不做的事

下面這些,Eisoptric 今天沒有做。有的是刻意的設計選擇,有的是還沒完成的工作,我們分開標示。

刻意不做(設計上的非目標)

  • 不防代理人自身推理被提示注入。Eisoptric 限制的是呼叫,不是想法。
  • 不做內容檢查或 DLP。只檢查你宣告的 policy 條件。
  • 不防成員的電腦或瀏覽器被入侵。
  • 不防持有 KMS 簽章權限的營運方。這一層靠 IAM 控管,不靠密碼學。
  • 轉送當下與等待核准期間不做端對端加密。已封存的稽核紀錄採零存取加密(寫入並刪除資料金鑰後 gateway 無法解密),但 gateway 在轉送工具呼叫當下必須讀取明文,且等待核准與執行中的處理中內容需以伺服器端金鑰加密保存 7 天以供續行,因此不等同於全程端對端加密。

還沒做到(已列入規劃或修正中)

  • 【未解決】沒有防竄改的稽核雜湊鏈,也沒有外部錨定;內容雜湊尚未加金鑰。完整性目前只到逐筆。
  • 【未解決】一般成員仍可下載組織金鑰備份的密文(非明文);限制僅管理員可下載已列入【規劃中】。
  • 【規劃中】origin 在應用層已驗證 Cloudflare 來源標頭(缺少即拒絕),但網路層尚未鎖定僅允許內部負載平衡器連線。
  • 【規劃中】目前不支援 KMS 金鑰輪替與現有密文重新包裝流程。
  • 【規劃中】登入值仍等同密碼。我們靠 TLS、伺服器端 Argon2id 與遷移截止機制保護登入,PAKE 方案仍在評估階段。
  • 【現況】沒有任何認證或第三方稽核。

S11. 營運與事件回應

  • 【已修正】CI secret 掃描:後端與前端的持續整合與部署工作流程均已加入自動 secret 掃描(Gitleaks),一旦偵測到憑證或高熵密鑰即直接中斷並失敗。
  • 【已修正】部署閘門:Cloud Run 部署工作流程已綁定測試與型別檢查結果,必須全數通過才會執行部署。
  • 【已修正】金鑰架構演進:先前的共用 gateway 金鑰已汰換為每租戶 KMS 推導金鑰,確保單一租戶的憑證金鑰與其他租戶隔離,且根金鑰不離開 Cloud KMS。
  • 【現況】KMS 金鑰輪替現況:目前 KMS 金鑰版本固定,尚不支援自動輪替與歷史密文重包(請勿假設支援)。
  • 【現況】漏洞通報與事件處理:外部資安研究人員與客戶可透過公開的 security.txt 與專用信箱通報漏洞,由資安與工程團隊依嚴重度進行修補、複驗並更新本白皮書狀態。

附錄 A. 漏洞通報

若您在 Eisoptric MCP Gateway、主控台或 Eisoptric Workbench 發現潛在的資安漏洞,請透過以下管道通報:

  • 通報信箱:security@eisoptric.com
  • 標準 security.txt:https://eisoptric.com/.well-known/security.txt
  • 公開說明段落:Trust 頁面的 #disclosure 段落(https://eisoptric.com/trust#disclosure)

來信請附上重現步驟、受影響的網域或端點,以及可能的影響範圍。請勿在問題修補前公開揭露漏洞細節,也請勿存取或修改不屬於您測試帳號的租戶資料。

附錄 B. 版本紀錄

日期版本變更
2026-10-16v1從加密白皮書擴寫成全系統白皮書
2026-10-16v2併入安全架構章節;區分各元件狀態標籤;移除內部識別資訊
2026-10-18v3擴寫為全系統架構;稽核改為零存取加密並區分處理中內容;更新 10/18 已修正項目

漏洞回報

漏洞回報方式會寫在這裡。在正式說明公布前,請寄到 security@eisoptric.com。

用你自己的工具看一次。

接上一台 MCP Server,再到瀏覽器打開一筆加密的審計紀錄。