安全与数据

Dcision 存储哪些数据以及存储多久、你的状态会去往哪里(包括目的地)、密钥、密文和密码如何受到保护、角色与工作区隔离,以及如何避免发送敏感数据。

Dcision 存储的内容

数据保存的内容保存多久
账户电子邮件、姓名、头像(使用 Google 登录时来自 Google)、语言,以及——仅当你设置了密码时——密码哈希(scrypt)账户存在期间
登录验证码仅保存每个 6 位验证码的带密钥哈希;有效期 10 分钟,可尝试 5 次一天后删除
会话浏览器中的一个签名令牌,有效期 30 天。Dcision 只保存你最近一次在所有设备退出或更改密码的时间—
邀请受邀电子邮件、角色、邀请人和邀请时间,以及链接令牌的 SHA-256 哈希——从不保存链接本身工作区存在期间
组织信息法定名称、税号、账单电子邮件、国家、地址和网站——也会保存在你的 Stripe 客户资料中,用于开具发票工作区存在期间
决策草稿和每个已部署的版本(schema)直到你删除该决策
API 密钥密钥的 SHA-256 哈希、遮蔽后的前缀、名称、环境和日期——从不保存密钥本身直到工作区被删除
提供商密钥(BYOK)使用 AES-256-GCM 加密的密钥及其最后 4 个字符直到你移除它
工作区密钥每个值都使用 AES-256-GCM 加密,并保存其最后 4 个字符直到你删除它
签名密钥加密存储;轮换后,旧密钥也会保留 24 小时工作区存在期间
执行记录始终保存:决策、版本、来源、状态、错误、行动和原因、延迟、输入和输出 token、估算成本、模型、请求 ID 以及本次运行的目的地条目。仅当 storeInput 开启时保存状态;仅当 storeOutput 开启时保存回答、置信度、加权级别、复合指标和分布你的日志保留期(见下文)
目的地投递状态、尝试次数、接收方的状态码、延迟及其回答的前 1,024 个字符,以及请求的遮蔽预览——从不保存其请求体。完整请求会加密保存,直到投递成功;失败的投递也会保存,以便重新发送30 天
幂等记录请求的哈希及其返回的响应24 小时
用量计数器每小时的计费决策数量约 400 天,用于计费
计费Stripe 客户和订阅 ID、套餐、状态和周期日期。银行卡数据由 Stripe 处理,从不到达 Dcision工作区存在期间

你的状态会去往哪里

为了回答一个决策,Dcision 会向引擎提供商发送:

  • 状态——它的所有字段,包括 schema 中未声明的字段——以及决策的 context,作为 decision_context;
  • 问题的指令、选项、等级和标准,以文本或 JSON 形式;
  • 模型名称。

复合指标权重、策略和设置保留在 Dcision 中:它们在引擎回答之后才应用。

目的地可以在决策之后继续发送数据——仅限于你配置的地方:

  • Webhook 和工作流发送回答、行动和你映射的参数——从不发送状态本身。
  • API 请求发送你的 URL、请求头和请求体模板中包含的内容。
  • 智能体以 input 的形式接收整个状态;LLM 目的地把状态——或你设置的 input——发送给你的模型提供商,使用你的密钥。
  • 固定回复和函数会返回给调用方;没有任何数据离开 Dcision。

参见目的地的安全与限制。

使用 Dcision 的引擎密钥时,调用以 Dcision 的账户直接发送到 TypeSafe 的 API(Jev);TypeSafe 声明 Jev 不会使用客户的请求或响应进行训练——参见其法律文件。使用你自己的密钥时,调用会发送到你选择的提供商,适用你的账户及其条款——OpenAI Decisions 发送到 OpenAI,Laya 发送到你自己的服务器。参见引擎与 BYOK。 使用 Dcision 密钥的 OpenAI Decisions 会以 Dcision 的账户调用 OpenAI 的 API。

状态中的文件(输入):Dcision 能够解析的文档在 Dcision 内部读取,从不离开 Dcision。音频、用于 Jev 或 Laya 的图片,以及 Dcision 无法解析的文件,会使用工作区的 OpenAI 密钥发送给 OpenAI,进行转写、描述或读取。用于 OpenAI Decisions 的图片随引擎调用一起发送。执行日志会保存每个文件的名称、类型、大小及其文本的前 4,000 个字符——从不保存文件本身。 当工作区没有 OpenAI 密钥时,将使用 Dcision 自己的密钥——此时 OpenAI 成为 Dcision 的子处理方;参见隐私政策。

Dcision 不会把你的状态或密钥写入其应用日志。

保留与删除

  • 执行记录会在你套餐的保留期(Genesis 7 天、Developer 14 天、Growth 30 天、Enterprise 365 天)与工作区的执行日志保留期设置两者中较短者到期后删除。
  • 删除决策会立即删除其版本和执行记录。
  • 幂等记录在 24 小时后过期,与决策的存储设置无关。
  • 撤销 API 密钥会立即使其失效;哈希记录会保留,作为你的历史。
  • 重新生成 API 密钥会一步完成撤销,并签发一个名称和环境相同的新密文——永远不会出现同时有两个有效密钥或一个都没有的时刻。
  • 目的地投递在创建 30 天后删除,与日志保留期无关——即使其决策已被删除也是如此。
  • 删除工作区(其 Owner 可以执行)会删除其决策、版本、执行记录、API 密钥、邀请、密钥和投递。Stripe 客户资料会保留,以便过去的发票仍然可用。
  • 账户中的在所有设备退出会立即结束你账户的所有会话。

避免发送敏感数据

  • 在接收个人数据的决策上关闭 storeInput——如果回答也敏感,还要关闭 storeOutput。参见决策设置。
  • 只发送决策需要的内容:未声明的字段也会被转发给引擎。这还能让回答更准确——参见编写好的问题。
  • 不要在指令、选项和 context 中放入个人数据:它们是 schema 的一部分,会随每个版本存储,并随每次调用发送。
  • 当直接标识符(姓名、电子邮件、证件号码)不会改变回答时,用你自己的 ID 替换它们。
  • 在设置中缩短执行日志保留期。
  • 只把每个接收方需要的内容映射到目的地参数中:目的地条目——包括函数参数——即使在 storeInput 和 storeOutput 关闭时也会随执行记录保存。

访问控制

  • 工作区隔离。每个查询都限定在一个工作区内。一个 API 密钥恰好对应一个工作区,只能运行该工作区的决策——其他任何决策都返回 404 DECISION_NOT_FOUND——并且只能列出该工作区的执行记录。
  • 输入保留在应用中。GET /v1/executions 返回回答、行动和指标,但从不返回已存储的状态:输入可能包含个人数据,只会在应用中向工作区成员显示。
  • 密钥与会话相互独立。API 密钥只能用于公共 API(/v1);应用的端点会以 403 FORBIDDEN 拒绝它们,会话令牌在 /v1 上也不被接受。
  • 登录。Google、6 位电子邮件验证码,或可选的密码:至少 10 个字符,包含字母和数字,不能是你的电子邮件或常见密码,以 scrypt 哈希存储。密码错误 5 次后,密码登录会被锁定 15 分钟,对于未知的电子邮件也返回相同的回答。设置或更改密码时会给你发送电子邮件,更改密码会结束你的其他会话。
  • 会话。存放在 httpOnly cookie 中的签名令牌,从不暴露给浏览器的 JavaScript,有效期 30 天。在所有设备退出会撤销所有会话。
  • 角色。每个成员都是 Owner、Admin、Member 或 Viewer。Viewer 只读;Member 构建、部署和运行决策,管理 API 密钥和目的地;Admin 还管理人员、设置、提供商密钥和密钥;只有 Owner 管理计费、转让所有权和删除工作区。拒绝时返回 403 FORBIDDEN。参见团队、角色与账户。
  • 工作区访问。每个应用请求都会根据你在该工作区中的成员身份进行检查;不属于你的工作区返回 403 FORBIDDEN,并带有 details.reason = "workspace_access"。

安全集成检查清单

  • 通过 HTTPS 从你的后端调用 API;永远不要在浏览器、移动应用或代码仓库中暴露 API 密钥。
  • 每个服务使用一个密钥,并撤销不再使用的密钥。在预发布环境和 CI 中使用 test 密钥。
  • 发送 Idempotency-Key,使重试不会重复执行决策——参见幂等性。
  • 需要追踪决策时,记录 execution_id 和 X-Request-ID,而不是状态。
  • 对你从 Dcision 收到的每个 webhook、工作流、智能体和 API 请求验证 Dcision-Signature,拒绝过旧的时间戳,并按投递 ID 去重——参见 Webhooks。
  • 把令牌和秘密 URL 保存在工作区密钥中,并以 {{secrets.NAME}} 引用——永远不要把它们直接输入到目的地的 URL、请求头或请求体中。
  • 让 livemode: false 事件——test 密钥和 Playground——远离生产系统。

负责任地使用

Dcision 返回的是概率,而不是确定性。对于涉及个人的重大决策——信贷、就业、住房、医疗、法律事务——请用它来分流和路由,让人参与其中(例如使用 escalate),并定期审查结果。

本页内容