密钥存储
密钥是一组具名的键值条目,每个引用都恰好指向其中一个条目:在 MCP 服务器的标头或环境变量中写作 ${secret:name/key},在代理技能上则是一个名称加一个键。引用按名称保存,只在使用时才解析,因此需要凭据的内容从不存储凭据本身。
| 本地 | HashiCorp Vault | |
|---|---|---|
| 存储什么 | 条目本身,每个值都已加密 | 只有一个 KV v2 引用,即挂载点和路径 |
| 值从哪里来 | 加密存储 | Vault,在解析的那一刻读取 |
| 如何列出键 | 从已存储的映射中列出,无需解密任何内容 | 在那一刻从 Vault 读取 |
| 客户端能读回什么 | 只有键,绝不返回值,无论明文还是密文 | 只有键 |
本地密钥
值使用属于该部署的单个加密密钥进行加密。条目的键以明文保存在值的旁边,因此选择器无需解密任何内容就能列出它们;而值绝不会以任何形式返回给客户端,这也是本地密钥的详情页只显示键、值留空的原因。
加密密钥在每个进程中只解析一次:如果环境变量中已设置,就从那里获取;否则从密钥文件读取;再否则在首次使用时生成,写入该文件,并在日志中给出警告。
请备份这个加密密钥。 一旦丢失,所有已存储的本地密钥都将无法解密;而且由于同一个加密密钥还保护着签发工具证书的证书颁发机构的签名密钥,丢失它也会导致证书无法签发或验证,进而使所有 MCP 工具调用都无法进行。两者都在配置参考中说明。
HashiCorp Vault 密钥
对于由 Vault 支持的密钥,A2Flow 完全不存储值,只存储读取它们所用的挂载点和路径。值和键列表都在每次需要时实时获取,因此在 Vault 中轮换某个值后,无需改动 A2Flow 即可生效。
密钥始终通过其所属租户的 Vault 读取。如果租户管理员已在管理员设置下连接了租户自有的 Vault,就使用它;否则使用超级管理员设置的全局 Vault,并使用该租户自有的凭据登录。两者都可以通过静态令牌或 AppRole 凭据进行认证;AppRole 令牌会一直复用到租约快要到期,然后重新登录以刷新。在全局 Vault 上,每个租户都有自己的凭据,因此租户之间通过附加在这些凭据上的 Vault 策略相互隔离。两者都没有时,租户的 vault 类型密钥将完全无法解析。
解析发生的位置
| 使用方 | 解析时机 |
|---|---|
| MCP 服务器的标头和环境变量值 | 网关为 MCP 代理服务器与该服务器建立的连接展开这些值时 |
| 代理技能的仓库密码 | 克隆或拉取仓库时 |
由于解析是延迟进行的,重命名或删除仍被引用的密钥不会在编辑时失败,而是在下次使用时失败,并指出找不到的密钥名称;根本原因则保留在服务器日志中,不会返回给调用方。