开发者API 密钥与认证

最小权限,而不是一把万能令牌。

一把无所不能的 API 密钥,一旦泄露就是隐患。CMSHub 的机器凭证带有明确的按集合操作权限——查看、创建、更新或删除——集成只持有它真正需要的权限,即便密钥泄露,影响范围也小而明确。

01 / 机器凭证

限定范围的 API 密钥,而非主密钥

按工作区创建、轮换和吊销 API 密钥,每把密钥只限于特定集合及其特定操作——与你对任何生产凭证采用的最小权限原则一致。

按集合、按操作限定范围

只在集成涉及的集合上,精确授予查看、创建、更新或删除权限——没有任何隐式授权。

创建、轮换、吊销

在工作区中管理密钥的生命周期——按计划轮换,或在泄露时立即吊销。

默认拒绝

没有获得某个集合明确授权的密钥无法访问它——不存在隐式回退到更大权限的情况。

02 / 用户会话

加固的凭证,可撤销的会话

用户登录采用 Argon2id 派生的凭证——一种现代的内存困难型哈希算法——服务端会话以 JWT 封装,可以立即撤销,而不只是等它过期。

基于 Argon2id 派生的凭证

密码使用 Argon2id 哈希,能抵御 GPU 和 ASIC 加速的破解尝试。

可撤销的会话

采用服务端会话,被盗用的会话可以立即撤销,无需等待令牌过期。

可审计的认证事件

登录、会话撤销和密钥变更都有记录,你可以回答谁在何时访问了什么。

创建限定范围的密钥

签发一把仅限一个集合的 API 密钥。

打开一个工作区,创建一把权限恰好满足集成需要的密钥。