fix(mcp): address PR #15 review — aud validation, OAUTH_KV auto-inject, TTL/sunset docs, drift test
leo review 5 條逐條處理: 1. RFC 8707 aud 驗證(真缺口):partner-auth OAuth 路徑補「at.aud === resourceUri(originOf(url))」, 不符回 401 invalid_token(防別的 arcrun-mcp 部署簽的 token passthrough)。加 aud 不符→401 測試。 2. deploy.ts injectWranglerConfig 涵蓋 OAUTH_KV(在 PR 內補):OAUTH_KV 納入 REQUIRED_KV_NAMESPACES → acr init/update 自動建 namespace + 注入用戶帳號真 id(比照 SUBMISSIONS_KV 家族)。wrangler.toml 註解 更新(CLI 路徑自動、手動直推才需手建)。注入 regex 已驗證命中。 3. MCP_TOKEN_TTL 預設維持 30 天(leo 拍板不改):OAUTH.md 明寫為有意取捨(無 refresh token → 到期重走 OAuth=再輸 owner secret),MCP_TOKEN_TTL 可調、7 天為更保守選項。per-owner 可調另開 issue #19(非阻塞)。 4. ALLOW_PLAINTEXT_NAMESPACE 逃生門標 SUNSET(code + wrangler.toml + OAUTH.md),開 issue #18 追蹤 「遷移完成後移除整段 code path + Env 欄位」。 5. 防 drift 測試:spy KV 攔所有 put,斷言對 OAUTH_KV 的每一次 put 都帶 expirationTtl>0(完整流程 + store 層兩道),防未來往這顆短效 KV 塞長效資料。 驗證:mcp tsc exit 0、vitest 45/45(+aud +drift×2);cli tsc exit 0。 Refs #15 #18 #19 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
This commit is contained in:
+9
-6
@@ -33,13 +33,15 @@ service = "arcrun-kbdb"
|
||||
|
||||
# ── OAuth 2.1 server(claude.ai 遠端 connector 安全登入,見 mcp/OAUTH.md)──────────────
|
||||
# 短效認證儲存(authorization code + access token,皆帶 TTL、key 用 SHA-256 hash)。
|
||||
# ⚠️ 部署前 leo/mira 需先建立此 KV namespace 並填入真實 id:
|
||||
# wrangler kv namespace create OAUTH_MCP
|
||||
# 把回傳的 id 貼到下面(self-hosted 自動注入路徑尚未涵蓋此 binding → 需手動或補 deploy.ts injectWranglerConfig)。
|
||||
# id 是占位:
|
||||
# • CLI 路徑(acr init / acr update)→ deploy.ts 已把 OAUTH_KV 納入 REQUIRED_KV_NAMESPACES,
|
||||
# 自動建 namespace + injectWranglerConfig 換成用戶帳號真 id(零手動)。
|
||||
# • 手動直推(leo21c wrangler deploy,mistakes #23 codeload 陷阱下的路徑)→ 需自己先建並填 id:
|
||||
# wrangler kv namespace create OAUTH_MCP → 把 id 貼到下面。
|
||||
# 未設此 binding → OAuth /authorize、/token 回 503(誠實拒絕,不假綠),既有 MCP 路徑不受影響。
|
||||
[[kv_namespaces]]
|
||||
binding = "OAUTH_KV"
|
||||
id = "REPLACE_WITH_REAL_KV_ID" # ← 部署前必填(wrangler kv namespace create OAUTH_MCP)
|
||||
id = "REPLACE_WITH_REAL_KV_ID" # CLI 部署會自動換;手動直推才需填(wrangler kv namespace create OAUTH_MCP)
|
||||
|
||||
# ── OAuth 相關機密與設定 ───────────────────────────────────────────────────────────
|
||||
# 機密走 CF Secrets(wrangler secret put,不進 toml、非 KV、非明碼 var):
|
||||
@@ -47,9 +49,10 @@ id = "REPLACE_WITH_REAL_KV_ID" # ← 部署前必填(wrangler kv namespace cr
|
||||
# wrangler secret put MCP_STATIC_TOKEN # (選配)本機 CLI/GUI/Claude Code 相容用的真祕密 token
|
||||
# 非機密設定可放 [vars](下方 [vars] table):
|
||||
# MCP_OWNER_NAMESPACE access_token 綁定的資料分區,預設 "leo"
|
||||
# MCP_TOKEN_TTL access_token 存活秒數,預設 2592000(30 天)
|
||||
# MCP_TOKEN_TTL access_token 存活秒數,預設 2592000(30 天,有意取捨見 OAUTH.md §5;7 天為更保守選項)
|
||||
# MCP_ALLOWED_REDIRECT_HOSTS 逗號分隔 redirect host 白名單,預設 claude.ai/claude.com/anthropic.com+localhost
|
||||
# ALLOW_PLAINTEXT_NAMESPACE 【不安全】="true" 恢復舊明碼 namespace 漏洞路徑,僅遷移期用,正式勿開
|
||||
# ALLOW_PLAINTEXT_NAMESPACE 【不安全,SUNSET】="true" 恢復舊明碼 namespace 漏洞路徑,僅遷移期,驗收完即刪
|
||||
# (追蹤移除的 issue 見 OAUTH.md §5)
|
||||
|
||||
# Route — MCP 搬進 arcrun 主庫後改用 arcrun.dev zone(與其他 worker 一致)。
|
||||
# 舊的 studio.finally.click 是 inkstone 平台 zone,arcrun 帳號沒有該 zone → 部署 route 失敗。
|
||||
|
||||
Reference in New Issue
Block a user