For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/web/security.md (or send Accept: text/markdown).
安全與隱私
速率限制、金鑰、資料匯出與審計軌跡。
初學者演練
先決條件：閱讀下面的兩個初學者指南，完成 Web 本地設定，並在編輯器的根目錄中開啟此 monorepo。網頁設定屬於apps/web/.env.local； Next.js不讀取根.env。預設fake模式下的/dashboard是無資料庫演示； /auth 需要遷移資料庫。
簡而言之：工作區是一個團隊的單獨使用者、資料和設定。伺服器是可信後端；讓提供商金鑰遠離瀏覽器和電話程式碼。遷移是建立或更新表的版本化資料庫更改。人工智慧模型是回答的引擎；型號目錄是伺服器上可用型號 ID 和價格的列表。提供商是一種外部服務，例如人工智慧、電子郵件或計費服務。權利是允許工作區使用某項功能的授權。 Webhook 是一個服務傳送到另一個服務的 URL 的訊息。
1. 在讀取使用者擁有的記錄的伺服器操作或路由中，在查詢之前解析登入使用者的成員資格和活動 workspaceId。
2. 要求您的代理新增 1 個允許成員案例和 1 個外國工作空間拒絕案例，以獲取準確的記錄路徑；提供涉及的角色和領域。
3. 第一個請求應成功，第二個請求應返回無記錄/訪問被拒絕。如果僅更改按鈕隱藏訪問，但直接請求仍然有效，則伺服器邊界丟失。
對於自定義程式碼，請從提供的 prompts/README.md 開始，然後複製最接近的提示：對於應用程式螢幕為 prompts/new-app-screen.md，對於公共頁面為 prompts/new-landing-page.md。對於伺服器、資料庫或提供商工作，請為您的編碼代理提供本指南的任務，並要求其讀取 AGENTS.md、.ai/PROJECT_CONTEXT.md 和匹配的 .ai/ 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。
在資料之前解決成員資格
會話選擇身份；伺服器解析活動工作區並驗證成員資格/角色。每個使用者擁有的記錄都使用 workspaceId。客戶端欄位、URL ID 或模型選擇的引數無法替代所有權檢查。
平臺營銷資產和平臺管理記錄具有明確的平臺範圍；不要為匿名等候名單條目建立工作空間。
通過非同步工作承載邊界
任務、作業、工具上下文、API 金鑰、內容、儲存和出站事件繼承經過身份驗證的工作區。檢查資源 ID 和所有權。允許來自另一個工作區的有效 ID 仍然是授權失敗。
首先編寫拒絕測試
將每個成功的突變/讀取與匿名、外部工作空間和角色不足測試配對。診斷禁止結果時切勿洩露秘密。
安裝與配置
rate-limit-runtime 提供連線到 auth、checkout、API 和提交路由的共享限流器 —— 將它擴充套件到新的易被濫用端點,而不是為每個路由發明計數器。會話配置、僅 HTTPS 的 Cookie 和提供商金鑰保持在伺服器端。
工作區審計記錄(audit-runtime.ts)捕獲與安全相關的變更 —— 提供商配置、成員和角色更新 —— 並可在 /settings/audit 中讀取。
# Data subject export
src/data-export.ts — assembles a member's
workspace-owned records for account export實現流程
讓憑據遠離日誌、錯誤負載、分析屬性和審計值 —— 可觀測性層會脫敏已知金鑰,但自由文本是作者的責任。每次讀寫都在伺服器上解析授權;介面狀態是呈現,不是證據。
賬戶資料匯出和刪除請求通過賬戶邊界,因此適用相同的所有權規則。只儲存產品需要的資料。
驗證與排障
施壓限流器直到返回可重試的 429,驗證審計行出現在應產生它們的變更上,並匯出測試成員的資料。每次釋出探測一次跨工作區讀取 —— 最便宜且最重要的迴歸檢查。