Virbox SDK  2.1
Virbox SDK 文档

概述

本文档是 Virbox SDK 的接口说明文档。Virbox SDK 主要包含三类开发库:Virobx Runtime APIVirbox Control APIVirbox D2C API

本文档将详细介绍 Virbox SDK 各个 API 的定义、说明和使用方式,帮助软件开发商深入使用 Virbox 系列产品。

Runtime API

Runtime API 又称“Virbox 用户运行时库”,是 Virbox 许可管理体系中最为关键的接口,开发商可通过此套接口来访问软件许可(包括硬件锁许可,云许可,软许可),实现软件加密,实现软件反调试等功能。是开发商开发过程中必须使用的接口。

接口定义文件:ss_lm_runtime.h

接口名称描述
slm_initRuntime API 库初始化接口,在其他接口之前调用
slm_login许可登录接口,根据参数中的许可类型,访问硬件锁许可、云许可、软许可
slm_encrypt许可加密接口,通过许可秘钥对软件数据进行加密,提升安全强度
slm_get_info获取信息,可以获取许可信息,会话信息,加密锁信息等
... ...其他接口,详细参考内容 Runtime API 接口说明

Control 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

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 接口说明