白皮書
Eisoptric MCP Gateway 系統白皮書
2026 年 10 月 18 日
狀態以 2026 年 10 月 18 日(台北時間)的產品為準。本文不是認證,也不是第三方稽核。白皮書和行銷文案說法不一致時,以本文為準。第二部分每個狀態只用四個標籤之一:【現況】(產品今天的實際行為)、【已修正】(之前發現的問題,修正已部署並複驗)、【未解決】(已知、還沒修好的問題)、【規劃中】(打算做、但還沒上線的改變;未列時程代表尚未承諾時程)。
第一部分:產品與架構 — 1. 摘要
AI 代理人開始直接呼叫真實系統:付款、寄信、改資料庫、開工單。問題不在代理人「能不能」做,而是誰允許它做、做了什麼、出事時能不能追回。
Eisoptric MCP Gateway 站在代理人和 MCP 伺服器之間。每一次工具呼叫都會經過四步:
- 認證:確認是哪個代理人在呼叫,每個代理人有自己的 OAuth 身分。
- 判定:依照適用於這個代理人的 policy,決定允許、拒絕,還是要人審批。
- 執行:只轉送已獲授權的呼叫;上游憑證留在 gateway,代理人拿不到。
- 稽核:每次呼叫都寫一筆稽核紀錄,已儲存的稽核內容採零存取加密封存。
設計原則只有一條:審批是許可,不是命令。人按下核准,不會讓工具直接執行;代理人必須用同一個 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. 一次工具呼叫的完整流程
從代理人連線到工具執行、封存與通知,一次完整的工具呼叫依序經過以下十二個步驟:
- OAuth 2.1 + PKCE 認證:代理人透過 OAuth 2.1 授權碼流程(強制 PKCE S256)取得綁定至該代理人與組織(或個人 profile)的存取權杖。未帶有效權杖呼叫 MCP 端點時回傳 401 與 RFC 9728 資源中繼資料。
- initialize 交握:代理人向 Eisoptric MCP 端點發送 initialize,建立綁定至該代理人身分的 MCP session(狀態寫入共用 Redis)。
- tools/list(依 tool set 過濾):代理人請求工具清單時,gateway 僅回傳該代理人獲派工具集(tool set)內、且該成員獲准存取之 MCP 伺服器上的有效工具;不在工具集內的工具對代理人而言不存在。
- tools/call 送出呼叫:代理人針對某個工具送出 tools/call 與參數。若代理人處於暫停狀態,呼叫立即被擋下。
- Policy 判定:gateway 取出適用於該代理人的有效 policy(依規則順序比對工具名稱與參數條件)以及工具本身的預設模式(Call 或 Approval),給出「允許(allow)」、「拒絕(deny)」或「需審批(approval required)」三種判定之一;若代理人完全沒有任何適用的 policy,預設判定為拒絕。
- 分流處理(允許/拒絕/需審批):若判定為「允許」,直接進入第 9 步轉送上游;若判定為「拒絕」,呼叫絕不送往上流,立即寫入拒絕稽核紀錄,並回傳結構化錯誤(含 reason、policy_id、how_to_allow)。
- 進入審批佇列(含群組 quorum):若判定為「需審批」,gateway 產生唯一的 action ID(即 gatewayRunId),將當下參數計算正規化 SHA-256 摘要,並將待審參數以每組織 KMS 推導金鑰加密保存(7 天到期)。呼叫進入審批佇列等待單一審核者核准,或等待所有必要審核群組(groups)達到法定門檻人數(quorum),同時回傳含審批連結與原因的結構化回應給代理人。
- 以同一 action ID 重送並重新檢查:審核者按下核准不會直接觸發工具執行(「審批是許可,不是命令」)。代理人必須帶上同一個 gatewayRunId 重新呼叫同一工具;gateway 會重新檢查三件事:核准與重送視窗是否尚未過期、重送當下的有效 policy 是否仍允許、以及重送的參數摘要是否與核准時綁定的參數完全一致。任一項不符即拒絕。
- 以 vault 憑證轉送上游:通過檢查後,gateway 從後量子憑證庫(vault)解密該上游 MCP 伺服器的憑證(僅在此次呼叫期間於記憶體中開啟),代代理人向上游發送工具呼叫並取得回應;若上游回傳 401 且具備 refresh token,gateway 自動完成續期後重試一次。
- 零存取封存:寫入長期稽核紀錄前,gateway 抽取一次性隨機 32-byte AES-256-GCM 資料金鑰,將工具參數、上游請求、上游回應、伺服器結果與代理人結果一起加密,再用 ML-KEM-1024 + HKDF-SHA384 將資料金鑰分別包裝給組織公鑰與每位有效成員的公鑰,寫入完成後立即刪除資料金鑰。若組織尚無可用的 ML-KEM 金鑰,內容不寫入,僅標記「加密不可用」。
- 寫入稽核紀錄:gateway 以原子計數器取得該組織遞增序號,將明文中繼資料(呼叫者、工具、policy 版本、判定結果、加密狀態、內容雜湊)與零存取密文信封寫入稽核表。
- 發送簽章 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 Key | 256-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 上游伺服器之間,每一次工具呼叫都要經過四步:
- 認證:確認是哪一個代理人在呼叫。每個代理人有自己的 OAuth 身分。
- 判定:依照適用於這個代理人的 policy,決定允許、拒絕,或送人審批。
- 執行:只轉送已授權的呼叫。上游憑證留在 gateway 裡,代理人拿不到。
- 稽核:每次呼叫都寫一筆紀錄,已儲存的敏感內容採零存取加密封存。
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 審批流程與結構化錯誤
- policy 判定為需要審批時,代理人會拿到一個 action ID(gatewayRunId),呼叫進入審批佇列。
- 成員在主控台看到的是這一次、這組參數。
- 核准不會直接執行工具。代理人要用同一個 action ID 重送,gateway 會重新檢查三件事:核准是否已過期、當下的 policy 是否還允許、參數是否和核准的那組一致。參數不一致就拒絕。
- 審批結果用簽章 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-16 | v1 | 從加密白皮書擴寫成全系統白皮書 |
| 2026-10-16 | v2 | 併入安全架構章節;區分各元件狀態標籤;移除內部識別資訊 |
| 2026-10-18 | v3 | 擴寫為全系統架構;稽核改為零存取加密並區分處理中內容;更新 10/18 已修正項目 |