亮点
API key 现已支持重新查看。在控制台中生成一个 key,离开,下周再回来,只需点击一下即可再次查看。我们还优化了 API playground 中的三处体验细节,让生成的 curl 复现命令可以直接运行。
最新更新
支持再次查看的 API key
大多数 SaaS API 只展示一次 key。一旦遗失,就必须重新生成,随之更新所有使用旧 key 的服务并重新部署。大家对这套繁琐的流程都很熟悉。
我们并不认可这种模式,因此我们做出了改变。
从现在开始创建的 key 都会附带一份可查看的副本。打开控制台,点击任意 key 旁边的眼睛图标,确认后即可看到完整的 pk_live_... 值。15 秒后它会自动隐藏并从页面中清除。每次查看操作都会记录在审计日志中。
我们在意的一些技术细节:
- 用于验证请求的路径依然是单向哈希,保持不变。可查看的副本是与其共存的第二份独立加密产物 (AES-256-GCM)。即使我们轮换加密密钥,身份验证也会正常工作。
- 在此变更之前创建的 key 无法被查看,因为它们没有可供读取的加密副本。它们将继续通过哈希路径永久有效。控制台会显示一个小锁图标以及“重新生成以启用”提示,方便你区分哪些 key 具备这项新功能。
- 权限控制与 keys API 的其他部分保持一致。你可以查看自己的 key;组织管理员可以查看组织内的任意 key;拥有团队写入权限的成员可以查看团队 key;只读角色则无法查看。
- 组织管理员代表团队成员创建的 key 同样支持查看,遵循相同的权限规则。这项能力绑定在 key 本身,而不是取决于创建它的操作入口。
如果你以前总是在密码管理器中堆积保存 FourA 的 key,现在可以停手了。
curl 复现命令现在可以直接运行
你在 playground 中构建的每个 request,侧边都会提供一条可直接复制粘贴的 curl 命令。设计逻辑非常直接:在 UI 中配置好请求,复制 curl,然后直接粘贴到脚本、同事的终端或 bug 反馈中。
在本周之前,curl 中 key 的位置使用的是占位符 (PASTE_PLAINTEXT_FOR_my-key),在运行前必须手动填入。这种复现命令根本算不上真正的复现工具,充其量只是个模板。
这种情况已成为历史。对于任何可查看的 key,playground 的 curl 面板上都提供了一个 Reveal 按钮。点击它,真实的明文就会填入 curl 中,复制整条命令并粘贴到终端即可直接运行。再次点击即可隐藏。明文查看仅在当前会话的内存中生效,绝不会写入磁盘;同时 curl 面板会与 key 下拉选框联动,切换 key 绝对不会导致凭证串用。对于早期不可查看的 key,由于我们无法还原明文,因此仍会显示占位符。
进行中请求的 Cancel 按钮
如果您在 playground 中向响应缓慢的目标网站发起 request,过去唯一的选择就是等待超时。我们在加载面板中添加了“取消”按钮。点击该按钮,request 会干净利落地中止,response 区域会恢复到空闲状态并显示“Request canceled.”,而不是令人不安的错误提示。
改动不大。但现在的 playground 更像一个实用的工具,而不再只是个 demo。您可以探测不稳定的站点、中止、调整 request、重试,无需干等。
底层细节
首次发布后针对 cURL“显示”按钮的三个小优化:错误提示条会显示友好的信息而非机器错误代码,如果其他地方抛出异常,按钮不会卡在“正在显示…”,并且修复了导致不支持显示的密钥上依然展示该按钮的 CSS 优先级问题。
如果您之前遇到过这些问题,现在应该已经修复。如果没有遇到,也没错过什么。
生成、复制、粘贴、抛在脑后。稍后再回来看,Dashboard 会替您记下。