> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 安全與隱私

速率限制、金鑰、資料匯出與審計軌跡。

## 初學者演練

先決條件：閱讀下面的兩個初學者指南，完成 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/` 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。

[開始之前](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[終端基礎知識](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

[網路本地設定](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

[座席提示和專案記憶體](https://supastack.dev/zh-tw/docs/web/agents.md)


## 在資料之前解決成員資格

會話選擇身份；伺服器解析活動工作區並驗證成員資格/角色。每個使用者擁有的記錄都使用 `workspaceId`。客戶端欄位、URL ID 或模型選擇的引數無法替代所有權檢查。

平臺營銷資產和平臺管理記錄具有明確的平臺範圍；不要為匿名等候名單條目建立工作空間。


## 通過非同步工作承載邊界

任務、作業、工具上下文、API 金鑰、內容、儲存和出站事件繼承經過身份驗證的工作區。檢查資源 ID 和所有權。允許來自另一個工作區的有效 ID 仍然是授權失敗。


## 首先編寫拒絕測試

將每個成功的突變/讀取與匿名、外部工作空間和角色不足測試配對。診斷禁止結果時切勿洩露秘密。

[工作空間合約](https://supastack.dev/zh-tw/docs/modules/workspaces.md)

[受保護頁配方](https://supastack.dev/zh-tw/docs/web/first-feature.md)

[伺服器注入的工具上下文](https://supastack.dev/zh-tw/docs/web/project-structure.md)


## 安裝與配置

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,驗證審計行出現在應產生它們的變更上,並匯出測試成員的資料。每次釋出探測一次跨工作區讀取 —— 最便宜且最重要的迴歸檢查。


## 下一篇

[垃圾資訊防護](https://supastack.dev/zh-tw/docs/web/captcha.md)