证书金库

这个包提供了一种代理工具,用于存储,检索,列表,旋转,并按平台和密钥导入所标注的证书. 它使用节点.js crypto 页:1 AES-256-GCM 加密并保存证书为内存.

安装

npm install @framers/agentos-ext-credential-vault

同伴依赖 : @framers/agentos 有范围 >=0.10.40。 。 。 .

使用量

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-credential-vault',
        options: {
          passphrase: process.env.CREDENTIAL_VAULT_PASSPHRASE,
        },
      },
    ],
  },
});

配置

密码句解析检查 options.passphrase,选择的秘密地图 credential-vault.passphrase,以及 CREDENTIAL_VAULT_PASSPHRASE,然后使用默认值. options.secrets 优先于上下文 secrets;地图没有合并。 解析使用无效的联结,所以接受空字符串密码句.

工具

credentialsSet

credentialsGet

credentialsList

credentialsRotate

credentialsImport

页:1

• 激活金库初始化. 启动前和停用后,工具返回 success: false 与“证书证书服务未初始化”。 解禁清除存储的证书.
• 密码句通过加密密钥 scryptSync 用固定的盐 agentos-credential-vault-salt。每个存储值使用随机初始化向量。 缺少的密码句配置使用了上面显示的默认值.
• 设置或导入一个已存在的平台, 并密钥覆盖其值, 保存 createdAt,并更新 updatedAt。 。 。 .
• credentialsGet 返回纯文本值 data.value。缺少证书返回 success: false。列出按平台和按键排序的被遮盖的值和时间戳;被遮盖的值可以显示前缀.
• credentialsRotate 需要现有证书和存储 refreshToken 作为它的新价值。 它回来了 rotatedAt 在结果中,但不将时间戳写入存储条目。 它不会发出外部令牌刷新请求 .
• JSON 导入接受数组或对象 platform, (中文(简体) ), key,以及 value。缺漏或空字段的条目被跳过并报告为出错.
• CSV 导入读取 platform, (中文(简体) ), key,以及 value 从每行中,剪切这些值,忽略空行,并跳过第一个包含"平面"的非平面行,忽略大小写. 它的行解析手柄引用了逗号并逃脱了双引号.
• 导入结果报告 imported, (中文(简体) ), skipped,以及任意 errors。解析出错和跳出条目可以以 success: true。 。 。 .
• 导出 CredentialVaultService 还揭露 deleteCredential 财务报告和审定财务报表 exportCredentials导出纯文本值。 包记录没有删除或导出工具 .

许可证

阿帕奇 - 2.0