certificate

验证说明：本文档是 certificate 组件构建与测试的唯一指导文档，验证流程请严格按本文档执行。docs/ 目录下的文档为特性说明文档，不涉及构建流程。原始 README 内容已移至 docs/功能简介.md。本组件仅支持 Ubuntu 24.04 LTS，openEuler、CentOS、Debian 等其他系统均不支持，不要尝试使用其他镜像替代。

certificate组件是BMC安全管理子系统的核心组件，汇总BMC中所有的证书数据，为其他组件提供基础的证书服务，支持业务使用证书来校验对端、认证BMC、认证用户等。

---

目录

• certificate
  • 目录
  • 仓库地址
  • 系统要求
  • 环境依赖
  • 编译构建
    • 获取组件代码
    • 组件级构建
    • 构建参数说明
  • 测试
  • 项目结构
  • 许可证
  • 变更日志

---

仓库地址

openUBMC/certificate

---

系统要求

项目	要求
操作系统	Ubuntu 24.04 LTS（仅支持此版本）
芯片架构	x86-64（amd64）
Python	>= 3.10（init.py 运行依赖）

---

环境依赖

构建 certificate 前需完成 openUBMC 开发环境初始化（安装 bingo、Conan、Node.js、配置 Conan 远程仓库等）。完整初始化步骤和常见问题排查请参阅 openUBMC 构建指导书，该文档包含容器环境搭建、init.py 执行、Conan 登录验证等全部操作说明。

禁止手动安装 bingo 和 Conan：手动安装（如 pip install conan）会导致 Conan 远程仓库认证失败，bingo build 无法拉取依赖包。所有构建工具必须通过 manifest 仓库的 init.py 流程一键安装。

---

编译构建

获取组件代码

前提：已完成 环境依赖 中的 init.py 初始化流程，bingo 和 conan 命令可用。

cd /home/workspace
git clone https://gitcode.com/openUBMC/certificate.git

组件级构建

进入 certificate 组件目录后，使用 bingo 执行构建：

cd /home/workspace/certificate

# 默认 dev 阶段构建
bingo build --stage=dev

# 构建并发布到 stable 阶段
bingo build --stage=stable

# Release 类型构建
bingo build --stage=dev -bt release

构建参数说明

bingo build [-h] [-bt BUILD_TYPE] [--stage STAGE] [-u] [-r REMOTE] [--conan2] [-nc] [-o OPTIONS] [--user USER] [-wb] [--ccache]

参数	说明	默认值
-bt / --build_type	构建类型，可选 debug、release	debug
--stage	包发布阶段，可选 dev、pre、rc、stable	dev
-u / --upload	上传组件包到 Conan 仓库	—
-r / --remote	Conan 仓库别名	—
--conan2	强制使用 Conan2 构建组件	—
-nc / --no_cache	强制更新 Conan 缓存依赖	—
-o / --options	定义组件选项值	—
--user	指定 Conan 包的 user 字段	openubmc
-wb / --without_build	不强制源码构建组件自身	—
--ccache	使用 ccache 加速 C/C++ 编译	—

---

测试

使用 bingo test 运行各类测试，需加 -jit 参数，否则测试会失败：

# 运行单元测试
bingo test -ut -jit

# 运行集成测试
bingo test -it -jit

# 运行 mock 测试
bingo test -mt -jit

# 运行 fuzz 测试
bingo test -ft -jit

# 运行单元测试并指定过滤
bingo test -ut -jit -f <filter>

# 运行单元测试并启用 ASAN
bingo test -ut -jit -as

常用测试参数：

参数	说明
-ut	启用单元测试
-it	启用集成测试
-mt	启用 mock 测试
-ft	启用 fuzz 测试
-f	测试过滤
-jit	需加此参数，否则测试会失败
-as	启用 AddressSanitizer

---

项目结构

certificate/
├ CHANGELOG
├ CMakeLists.txt
├ LICENSE
├ Makefile
├ README.md
├ conanfile.py
├ customization/    # 定制化配置
├ dist/             # 编译输出
├ docs/             # API文档
├ manufacture/      # 装备配置
├ mds/              # MDS 模型定义
├ proto/            # 协议定义
├ src/              # 源码实现
├ test/             # 测试相关
├ vendor/           # 第三方代码
└ whitelist/        # 白名单配置

---

许可证

本项目基于 Mulan PSL v2 许可证开源。详情请参阅项目根目录下的 LICENSE 文件

---

变更日志

详细的版本历史请参阅项目根目录下的 CHANGELOG 文件。