威步软件保护防盗版硬件加密狗Wibukey WUPI Samples说明For C++.pdf

WUPI Samples For C 说明文档说明文档 2 8 文档说明文档说明 1 C 的 例 子 当 安 装 完 后 已 经 安 装 在 您 的 电 脑 上 首 先 打 开 始 所 有 程 序 AxProtector Samples 可进入目录 Software Protection C WupiCalculatorIndex 下查找到 2 该例子的加密原理是由外壳工具 AXPROTECTOR 和 WUPI 函数功能组成 用户除了可以用 自动外壳工具保护程序外 还可以对源程序的函数段进行自定义加密 并且可以通过 WUPI 函数来控制该函数段在内存中什么时候解密运行 什么时候再次加密保护起来 3 首 先 我 们 打 开 外 壳 配 置 文 件 如 果 您 是 CodeMeter 用 户 请 打 开 该 目 录 下 WupiCalculator CodeMeter WibuAxProject 文 件 如 果 您 是 Wibukey 用 户 则 打 开 WupiCalculator WibuKey WibuAxProject 文件 以下我们以 Wibukey 为例 4 双击该外壳配置文件后 外壳程序 AxProtector 也会被自动启动 如下图 首先要选择需要加密的应用程序 exe 或者 dll 然后下一步如下图 3 8 该步骤和后面一些步骤的说明都可以参考外壳的操作说明 这里不一一介绍说明了 一直 下 一 步 到 Advanced options 选 项 通 常 单 纯 的 自 动 外 壳 加 密 的 时 候 Activate IxProtector WUPI 默认是不激活的 而这里我们需要让外壳和我们的 WUPI 函数功能组 合在一起使用时 必须打上勾激活 接着我们就可以进入下一步进行细节的配置 该例子是一个计算器例子 并且对计算器 里的计算功能进行模块许可分配 如下图 在许可列表里为每个不同的模块功能分配 不同的许可 这些都针对希望对程序中多个功能进行分开授权管理而设定的 否则的 话用户默认即可不用设置 4 8 然后在下一步里如下图 用户可以把希望做加密的函数名称添加到以下列表中 按添加函数按钮会出现如下图 在 Name 中填入函数名称 该函数名称必须和程序中一 致 否则外壳程序会无法查找到该函数 还可以通过 Length 来设定加密字节多少 而 在 license list 里如果需要对该函数功能进行模块分授权管理 即可选择上一步已经设定 的许可列表里的许可 则会自动绑定到该函数 5 8 然后就可以一直 next 到最后一步 按 finish 来完成加密工作 如下图 5 以上的步骤是外壳程序自动对 WUPI 函数进行处理 但是在这之前其实我们必须要程序 中定义好 WUPI 函数并且编译生成后 才可以用以上外壳加密工具进行 然后下面我们 看一下程序 这里请注意 所有在前面外壳加密时设定的加密函数段 必须在程序中做 如下处理才可以进行加密 必须先调用 WupiDecryptCode 函数进行解密操作 然后才能 运行那些加密的函数段如下面的 CalcSimpleOperation 否则将会出错 在运行完以后再 调用 WupiEncryptCode 函数进行加密 来保证内存中不要长时间暴露解密的函数程序 在这里用户可以自行调节 什么时候再加密 比如有些经常会被调用到的大运算量函 数考虑到运行效率问题可以延后再进行加密 降低了一些安全性而保证运行效率 另外可看到 WupiDecryptCode 的参数为 1 2 3 这个参数对应的是前面外壳加密时定义 的加密函数段的 ID 如下图 6 8 其他一些函数如 WupiDecreaseUnitCounter 只有当设定了计数器时 可以使用该函数来对计 数器进行减数操作 另外一些 WUPI 函数 WupiCheckLicense 可以用来检测加密锁上是否存 在相应的许可单元 请注意该函数后的参数对应的是 license lists 中的许可列表中的 ID 而不 是上面的函数定义 ID 还有一个比较关键的函数 WupiCheckDebugger 可以在程序中进行定 义 它会自动对侦测进程中是否有 debugger 破解工具 用户可以在程序中多出添加来防止 别人尝试破解您的软件 6 Wupi函 数 必 须 引 用 到 头 文 件wibuixap h 在 目 录C Program Files WIBU SYSTEMS AxProtector Devkit include 和 lib 文件 WupiEngine32 lib 在目录 7 8 C Program Files WIBU SYSTEMS AxProtector Devkit lib 在编译完后用上述外壳工具进 行加密 另外请注意所有需要被加密处理的函数头文件中必须以 declspec dllexport 申 请 这样外壳加密时才能认出该函数并进行加密 另外请注意 编译完程序后 在外壳工具加密前运 行的话会要求WupiEngine32 dll 动态库 用户不必担心动态库是否暴露在外面的问题 因 为外壳加密后 动态库会自动以静态库形式组合到程序中 7 上述就完成了所有的加密工作 接下来就是加密锁的授权了 例子中定义了基本模块公 司码 10 产品码 401000 这组许可 并且对各个功能进行分模块授权 比如基本功能模 块的许可为 10 401000 1 其中最后的 1 是模块分配码 记忆功能授权为 10 401000 2 等 等 见下面列表 所以我们必须在空的加密锁上也授权相应许可即可运行相应的功能 关于如何授权的操作 可以参看另外 Wibukey 使用手册里的授权章节 8