> ## 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/docs/web/before-you-start.md)

[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)

[网络本地设置](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)

[座席提示和项目内存](https://supastack.dev/zh/docs/web/agents.md)


## 在数据之前解决成员资格

会话选择身份；服务器解析活动工作区并验证成员资格/角色。每个用户拥有的记录都使用 `workspaceId`。客户端字段、URL ID 或模型选择的参数无法替代所有权检查。

平台营销资产和平台管理记录具有明确的平台范围；不要为匿名等候名单条目创建工作空间。


## 通过异步工作承载边界

任务、作业、工具上下文、API 密钥、内容、存储和出站事件继承经过身份验证的工作区。检查资源 ID 和所有权。允许来自另一个工作区的有效 ID 仍然是授权失败。


## 首先编写拒绝测试

将每个成功的突变/读取与匿名、外部工作空间和角色不足测试配对。诊断禁止结果时切勿泄露秘密。

[工作空间合约](https://supastack.dev/zh/docs/modules/workspaces.md)

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

[服务器注入的工具上下文](https://supastack.dev/zh/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/docs/web/captcha.md)