跳到主要内容

离线短码激活

在军工、航空航天、国防科研等对文件导入导出有严格保密要求的涉密场景中，软件授权始终是行业痛点：传统授权依赖网络传输易引发数据泄露，涉及文件拷贝又不符合涉密管理规范，轻则影响项目推进，重则触犯保密条例。Virbox 针对性推出离线场景下授权管控方案，从技术底层构建安全屏障，完美解决涉密场景的授权难题。

典型使用场景​

  1. 激活环境下不允许插入 USB 设备。
  2. 激活环境下导入导出文件需要申请；文件传输只可以使用光盘刻盘；刻盘需要专人操作。
  3. 激活环境为涉密环境，不允许携带电子设备进入。

环境要求​

  1. 安装最新的 Virbox 用户工具，版本号不低于：2.7.5.xxxxx
  2. SDK 版本号不低于： 2.6.0.68851

名词介绍​

名词介绍
预置许可模板在开发者中心创建，创建对应产品的许可信息，生成 预置许可模板，后续生成对应的 预置许可包 和 授权码。
预置许可包（.D2C）从开发者中心 预置许可模板 导出，包中包含完整的许可信息，以文件形式跟随开发商产品预先发布。
授权码在云平台生成，通过 预置许可模板 发布授权码，开发商将 授权码 发给用户，用户通过该码去兑换 离线激活码 。
离线激活码在 用户许可中心 生成，最终用户登录 对应授权码 后，输入设备的 预置许可请求短码 后生成，使用该码可以激活授权。
预置许可请求短码在最终激活环境下生成，包含绑定设备的硬件信息，在 用户许可中心 上传该信息即可兑换出对应设备的 离线激活码 。
预置许可请求二维码预置许可请求短码 的二维码形式，通过扫码可兑换出对应的 离线激活码。
离线激活请求码在最终激活环境下生成，二维码形式。如果有支持扫码的联网设备，可以在输入 授权码 之后，通过扫码的方式直接获取 离线激活码 ，避免手抄的过程。
离线解绑码在最终激活环境下生成，在解绑授权后生成，在 用户许可中心 上传该信息可以清除云平台的绑定记录，释放同时绑定数。
离线解绑请求码在最终激活环境生成，离线解绑码 的二维码形式。通过扫码的方式可以上传，避免手抄过程。

使用流程​

开发商授权发布流程​

方式一：OpenAPI 发布流程​

开发商可通过 OpenAPI 使用模板管理预置许可包，主要流程分为三步：

  1. 创建预置许可模板： 创建后各类许可条件不可修改，如需修改需重新创建模板；
  2. 导出预置许可包： 获取预置包文件中的内容，将数据写入预置包文件，并集成到软件中。该接口不支持并发调用，每10秒可调用该接口获取至多一个预置包，每个模板多次调用获取的预置包内容完全一致；导出的预置包以文件形式集成到开发商软件中，可在安装过程中放在指定目录下，后续激活时会在指定目录下查找预置许可包。
  3. 发布预置授权码：授权码发布后，用户可在许可中心使用授权码兑换离线激活码。该授权码的许可条款也无法修改，许可条款以模板内容为准。

OpenAPI 接口参数参考：OpenAPI文档--预置许可管理接口

方式二：界面发布流程​

1.创建授权码模板：详细步骤参考模板管理

2.下载预置许可包：进入授权码详情页面，点击“下载预置许可”，输入名称后下载。下载预置许可包后模板各类许可条件不可修改，如需修改请复制为标准模板后再修改。

预置许可-下载预置许可包

3.发布预置许可：使用预置许可模板发布预置许可授权码，该授权码的许可条款也无法修改，许可条款以模板内容为准。

预置许可-发布预置许可

用户激活授权​

方式一：LCC 激活​

  1. 打开 Virbox用户工具（Web）。
  2. 点击 添加许可 → 软锁预置许可激活 。

预置许可激活-添加许可 3.点击 设置预置许可包目录 添加开发商预置许可包存放目录，用户工具默认查找路径，如果开发商存放在自己目录下，需要添加对应目录。

系统默认查找路径
WindowsC:\ProgramData\senseshield\preset_lic_pkg
Linux/opt/senseshield/etc/preset_lic_pkg
MacOS/Library/SCP/etc/preset_lic_pkg
UOS/opt/apps/com.virbox.senseshield/files/etc/preset_lic_pkg

预置许可激活-设置预置许可包目录

4.输入 授权码。

预置许可激活-输入授权码

5.上传预置许可请求短码兑换离线激活码

  • 扫码激活，通过可联网设备扫描二维码获取激活码

预置许可激活-扫码

预置许可激活-兑换激活码

  • 网页兑换
  • 预置许可激活-网页兑换

预置许可激活-用户许可中心

预置许可激活-兑换预置许可激活码

6.输入 激活码 → 激活。 预置许可激活-激活

方式二：SDK（RuntimeV2） 激活：​

  1. 获取预置许可包完整路径。

  2. 生成预置许可请求短码。

  3. 平台兑换离线激活码。（非 SDK 功能，需要用户完成）

  4. 离线激活预置许可包。

    具体接口说明参考 runtimeV2 接口声明。完整示例代码参考：Windows SDK ：0000000000000000_2_2.6.0.68851\API\C\SampleV2\sample_offline_bind_preset_pkg

用户解绑授权​

方式一：LCC 解绑：​

  1. 打开 Virbox用户工具（Web）。
  2. 选择对应授权，点击 离线解绑 → 确定解绑。 预置许可解绑-解绑
  3. 用户许可中心上传解绑信息，释放平台记录的同时绑定数；
    1. 方式一：扫码上传 预置许可解绑-扫码上传预置许可解绑-解绑成功
    2. 方式二：用户许可中心抄码上传解绑信息 预置许可解绑-用户许可中心-上传解绑信息预置许可解绑-用户许可中心-解绑成功

方式二：SDK（RuntimeV2）解绑：​

  1. 枚举容器信息。

  2. 生成解绑信息。

    具体接口说明参考 runtimeV2 接口声明。完整示例代码参考：Windows SDK ：0000000000000000_2_2.6.0.68851\API\C\SampleV2\sample_offline_bind_preset_pkg