![]() |
Virbox SDK
2.1
|
本文档是 Virbox SDK 的接口说明文档。Virbox SDK 主要包含三类开发库:Virobx Runtime API 、Virbox Control API、Virbox D2C API。
本文档将详细介绍 Virbox SDK 各个 API 的定义、说明和使用方式,帮助软件开发商深入使用 Virbox 系列产品。
Runtime API 又称“Virbox 用户运行时库”,是 Virbox 许可管理体系中最为关键的接口,开发商可通过此套接口来访问软件许可(包括硬件锁许可,云许可,软许可),实现软件加密,实现软件反调试等功能。是开发商开发过程中必须使用的接口。
接口定义文件:ss_lm_runtime.h
接口名称 | 描述 |
---|---|
slm_init | Runtime API 库初始化接口,在其他接口之前调用 |
slm_login | 许可登录接口,根据参数中的许可类型,访问硬件锁许可、云许可、软许可 |
slm_encrypt | 许可加密接口,通过许可秘钥对软件数据进行加密,提升安全强度 |
slm_get_info | 获取信息,可以获取许可信息,会话信息,加密锁信息等 |
... ... | 其他接口,详细参考内容 Runtime API 接口说明 |
Control API 是 Virobx 许可体系的管理接口,开发者可以通过 Control API 来查询硬件加密锁、云锁、软锁的相关信息,可以查看许可内容、状态,可以查看许可会话等。
接口定义文件:ss_lm_control.h
接口名称 | 描述 |
---|---|
slm_ctrl_client_open | 与 Virbox 许可服务创建连接,在其他接口之前调用 |
slm_ctrl_get_all_description | 获取所有设备描述,是指硬件锁设备描述信息 |
slm_ctrl_read_brief_license_context | 获取当前设备描述下的,所有许可内容 |
slm_ctrl_bind_license_key | 将授权码软许可绑定到本地 |
... ... | 其他接口,详细参考内容 [Control API 接口说明](ref ControlAPI) |
D2C API 主要功能是制作硬件锁的 “软件许可升级包”,许可不可以凭空产生,必须有软件开发商颁发,颁发过程必须是严格安全的,Virbox 许可管理体系提供的 “控制锁签发,用户锁升级” 流程,严格保护了开发商许可的安全性,只有通过签名加密后的许可,方能在用户锁中升级使用。
接口定义文件:d2c.h
接口名称 | 描述 |
---|---|
master_open | 打开控制锁,许可和文件必须有控制锁签发生成 |
master_get_info | 获取控制锁信息,包括锁号、开发商号等信息 |
master_pin_verify | 控制锁必须验证 PIN 码后才能正常使用 |
d2c_lic_new | 创建 D2C 句柄 |
d2c_add_lic | 添加许可条款内容 |
d2c_get | 获取控制锁加密和签包后的 D2C 许可升级包 |
... ... | 其他接口,详细参考内容 D2C API 接口说明 |