内容提要
Vercel Connect 现支持为每个代理或任务创建受限的 Stripe API 密钥。创建 Stripe 连接器时可选择“托管 API 密钥”方式,由 Vercel 在用户的 Stripe 账户中生成仅含所选权限的密钥,避免使用拥有完全访问权限的默认密钥。密钥由 Vercel 创建和存储,无需手动粘贴,可在连接器设置中轮换而无需重新部署,旧密钥最多保留 24 小时。现有 MCP 和自带密钥方式保持不变。
延伸解读
从全权限密钥到按需授权
文章指出,多数应用和代理使用 Stripe 默认密钥,该密钥拥有账户完全访问权限。Vercel Connect 的托管密钥允许为每个代理或任务单独创建密钥,并仅授予所选权限。例如,日报代理可限制为只读访问 charges,入职代理可限制为写访问 customers。这种按需授权降低了密钥泄露后的影响范围。
密钥轮换无需重新部署
由于 Vercel 创建并存储密钥,用户无需手动粘贴。轮换可在连接器设置中完成,且无需重新部署应用。旧密钥在切换期间最多保留 24 小时有效,这为过渡提供了缓冲,但也意味着旧密钥不会立即失效,需注意轮换窗口内的安全风险。
现有连接方式不受影响
文章明确,现有的 MCP 和自带 API 密钥方式保持不变。这意味着已使用这些方式的用户无需调整现有集成。新增的托管 API 密钥方式为可选方案,适合希望减少手动管理密钥、并按代理或任务细化权限的场景。
Q&A
Vercel Connect 新增的托管 Stripe API 密钥是什么?
Vercel Connect 现在支持为每个代理或任务创建受限的 Stripe API 密钥。创建 Stripe 连接器时,可以选择“托管 API 密钥”方式,由 Vercel 在用户的 Stripe 账户中生成仅包含所选权限的密钥,避免使用拥有完全访问权限的默认密钥。
使用托管 API 密钥有什么好处?
每个代理只能获得其任务所需的权限,例如每日收入报告代理可以限制为只读访问费用,而入职代理可以限制为写入访问客户。这避免了使用拥有完全访问权限的默认密钥,提高了安全性。
如何创建和附加 Stripe 连接器?
可以从连接器目录创建 Stripe 连接器,选择“托管 API 密钥”,挑选权限,然后附加到项目。也可以使用 CLI 命令:`vercel connect create stripe --connection-method managed-api-key --name acme-stripe` 和 `vercel connect attach stripe/acme-stripe --project my-app --environment production`。
如何在代码中获取受限的 Stripe API 密钥?
在运行时,使用 `getToken` 函数并传入连接器的 UID 来获取受限密钥。示例代码:`const key = await getToken('stripe/acme-stripe', { subject: { type: 'app' } });` 然后使用该密钥初始化 Stripe 客户端。
托管 API 密钥如何轮换?旧密钥会立即失效吗?
可以在连接器设置中轮换密钥,无需重新部署。旧密钥在切换期间最多保留 24 小时的有效期。
现有的 MCP 和自带 API 密钥方式是否受影响?
不受影响,现有的 MCP 和自带 API 密钥方式保持不变。