跳转到主要内容
加密密钥用于加密数据流中标记为加密的字段。每个密钥都是 32 字节的 AES-256-GCM 密钥。MoleSignal 使用 MS_CIPHER_KEY 提供的根密钥包装密钥材料,并且从不返回它。参见安全。 新写入的加密值始终使用默认密钥 __field_default__ 的最新版本,该密钥在数据流首次需要时由 MoleSignal 创建。其他具名密钥以及每个密钥的早期版本,继续负责解密用它们写入的值。

密钥元数据

列表、读取、创建和轮换调用返回密钥版本的元数据。列表返回每个密钥的所有版本,同一名称下最新版本在前。
从未轮换过的密钥,rotated_at_micros 为 null。读取调用返回最新版本。

创建密钥

响应是上文所示的密钥元数据。

轮换密钥

请求体与创建调用一样包含 key_material_b64。调用会用新的材料增加一个版本,并保留早期版本用于解密。轮换一个不存在的名称会返回 404。请先用创建调用新建密钥。

删除密钥

删除该名称下的所有版本,并返回 {"deleted": true}。名称不存在时返回 404。调用不会检查已存储的数据是否仍依赖该密钥。
用已删除的密钥加密的值无法再解密。删除密钥之前,请先检查依赖它的加密字段。

轮换默认密钥

在服务端生成新的密钥材料,为 __field_default__ 增加一个新版本,并立即刷新解密缓存。新的写入使用新版本,已有的值保持可读。组织还没有默认密钥时,调用会把它创建为版本 1。请求体为空,响应包含新密钥的标识符与版本:
错误
最后修改于 2026年10月9日