返回文档中心

技能验签

技能验签用于对已签名 Skill 包进行核验，确认签名是否有效、内容是否完整、发布来源是否可信。本文介绍如何在 VeriAgent 控制台中上传已签名 Skill 包并查看验签结果；完成后，你可以判断该 Skill 包是否可继续安装、分发、上架或交付。

技能验签通常发生在 Skill 签名完成后，也可以发生在接收第三方 Skill 包、下载技能商店 Skill、Agent 安装或关键调用前。

前置条件

开始前，请确认你已满足以下条件：

  • 已拥有 VeriAgent 平台账号。
  • 已具备 Skill 管理相关操作权限。
  • 已获取需要验签的已签名 Skill 包。
  • 目标 Skill 包中应包含签名文件 META-INF/SKILL_VERIFY.MF 和 META-INF/SKILL_VERIFY.P7S。
  • 如需对照平台签名记录，请确认该 Skill 已在 VeriAgent 中完成技能签名。

注意：验签对象是 Skill 包，不是 Agent。请上传已签名的 Skill 压缩包，不要上传未签名包、源代码目录或 Agent 安装包。

上传 Skill 包并验签

若要在 VeriAgent 控制台中对 Skill 包执行验签，请按照以下步骤操作：

  1. 登录 VeriAgent 控制台。

  2. 在左侧导航栏中，选择 技能管理 > 技能签名。

  3. 在签名列表中，找到需要核验的 Skill 签名记录。

  4. 打开目标记录，进入 签名详情 页面。

  5. 在 签名包验签 区域，选择需要验签的已签名 Skill 包。

  6. 单击 上传并验签。

  7. 等待系统完成验签处理。

  8. 在页面中查看验签结果。

验签入口路径为：技能管理 > 技能签名 > 找到指定记录 > 详情 > 上传已签名技能包 > 验签。

注意：如果上传的 Skill 包不是该签名记录对应的签名包，或包内容在签名后被修改，验签可能失败。请优先确认 Skill 名称、版本和签名记录是否匹配。

查看验签结果

验签完成后，你可以在验签结果区域查看以下信息：

信息说明
上传文件显示本次上传并验签的已签名 Skill 包名称。
校验结果显示本次验签是否通过。
匹配文件显示签名清单中成功匹配的文件数量，例如 4 / 4。
篡改文件显示摘要不一致的文件数量。
缺失文件显示签名清单中缺失的文件数量。

验签通过时，结果区域中的 校验结果 为 通过。同时，匹配文件 应与签名清单中的文件总数一致，篡改文件 和 缺失文件 均为 0。

验证结果

完成操作后，你可以通过以下方式确认验签是否完成：

  1. 返回 VeriAgent 控制台。
  2. 进入 技能管理 > 技能签名。
  3. 打开目标 Skill 的签名详情页。
  4. 在 签名包验签 区域查看最近一次验签结果。
  5. 确认 校验结果 是否为 通过，并检查匹配文件、篡改文件和缺失文件数量是否符合预期。
状态说明
通过签名文件有效，Skill 包内容与签名时一致。
不通过签名文件、文件摘要或文件清单存在异常。

下一步

验签通过后，你可以根据业务需要继续执行以下操作：

  • 安装或导入该 Skill 到 Agent。
  • 将已验签 Skill 包交付给接收方。
  • 进入 技能管理 > 上架管理，维护 Skill 的上架状态和展示信息。
  • 如需在本地、Agent 或自动化流程中验签，可使用验签工具包执行离线核验。