跳到主要内容

密钥

密钥是一组带名称的键值条目,形式与 HashiCorp Vault 的 KV 引擎相同:一个路径保存一个由键到值的映射。相互关联的凭据(例如 AWS 访问密钥 ID 及其秘密访问密钥)应作为两个条目放在同一个密钥中,而不是分成两个密钥。

在管理侧边栏中打开密钥即可进行管理。每条记录都有名称、可选的描述、标签和类型。

密钥的使用位置​

  • MCP 服务器:任何标头值或环境变量值都可以嵌入 ${secret:name/key},在连接时展开。
  • 代理技能:技能的认证密码是对某个条目的引用,从下拉列表中选择,而不是手动输入。

单个条目始终以 name/key 表示。即使密钥只有一个条目,键也是必需的,因为单独的名称标识的是映射,而不是值。因此不带键的 ${secret:name} 会解析失败,而不会作为字面字符串传递。

两种类型​

本地(已加密)HashiCorp Vault
存储内容条目本身,每个值都经过加密仅 KV v2 引用,即 Vault 挂载点和 Vault 路径
值的来源加密存储每次解析时实时从 Vault 读取
详情页显示所有已存储的键,值为空挂载点和路径
编辑条目值留空则保留,重新输入则替换,移除该行则删除条目在 Vault 中进行

两种类型的值都绝不会返回,无论明文还是密文,所以本地类型的详情页只显示键、值留空。只有键是可读的,因此选择器可以列出它们:本地密钥的键来自存储的映射,Vault 密钥的键则在当时从 Vault 读取。

Vault 密钥从其所属租户的 Vault 读取,由租户管理员在管理员设置中连接。没有自有 Vault 的租户使用其自有凭据从全局 Vault 读取,该凭据的 Vault 策略决定可读取的内容。两者都没有时,Vault 类型的密钥无法解析。本地密钥所用的加密密钥只需设置一次,详见配置参考。

重命名和删除​

密钥按名称引用,并在使用时才解析。重命名或删除仍被引用的密钥不会在编辑时失败,而是在下次使用时失败,并指明找不到的密钥。引用已失效的代理技能会在下次拉取时把原因记录到自己的记录中。

不过,保存引用时会做检查。保存标头或环境变量中指定了密钥的 MCP 服务器、对脚本执行测试运行,或保存技能的认证密码时,该密钥必须存在,并且是您能打开的。被访问控制标签向您隐藏的密钥,会与不存在的密钥一样被拒绝。编辑已引用此类密钥的记录时也是如此,即使您只更改了其他字段。