身份 API

创建一个身份

调用 POST /v1/identities,提供名称、担保人邮箱,以及该身份可能请求的权限范围上限。响应会返回身份 ID、其状态,以及已确认的担保人。

名称是给人类看的,不必唯一;ID 才是在其他地方都会用到的稳定权威引用。

检索与列出

GET /v1/identities/{id} 返回单个身份及其担保人、权限范围上限与状态。GET /v1/identities 以游标分页的方式列出身份,并支持按担保人和状态筛选。

列表操作是只读的,可安全轮询;它会立即反映撤销与担保人变更。

更新担保人

PATCH /v1/identities/{id} 用于变更担保人或调整权限范围上限。此前的值会保留在审计日志中,因此记录始终能显示任意时间点上谁负有责任、被允许做什么。

撤销

POST /v1/identities/{id}/revoke 会同步地使该身份在所有已连接系统中的每一个凭证与权限范围失效。该调用在遏制完成后返回,相应事件会写入审计日志。