AuthNexus

简体中文

English

简体中文

English

外观

C/C++ SDK 对接 ​

客户端 SDK 用于把你的软件接入 AuthNexus 节点服务。对接前请先完成：

  1. 控制面板已启动并完成管理后台初始化。
  2. 至少一个节点服务已创建、部署并在线。
  3. 已在管理后台创建应用。

连接目标

SDK 中配置的主机和端口应指向节点服务地址，不是管理后台地址，也不是 Admin API 地址。

创建应用 ​

在管理后台进入应用管理，创建你的软件应用。

创建应用

保存应用密钥 ​

创建应用后，复制并妥善保存应用密钥。

复制应用密钥

如果后续忘记应用密钥，可以在应用操作中重新查看。

重新查看应用密钥

密钥保护

应用密钥用于解压接入包，并参与客户端接入流程。不要把密钥提交到公开仓库，也不要把包含密钥的头文件分发给不可信人员。

下载接入包 ​

在应用操作中选择接入包并下载。

下载接入包入口

接入包压缩文件的解压密码就是应用密钥。

接入包解压密码

运行 SDK Demo ​

你可以先在 SDK Demo 中验证接入效果，再迁移到自己的项目。将接入包中的文件复制到 Demo 对应目录。

复制接入文件到 SDK Demo

修改 sdk_demo.cpp 中的节点连接地址：

cpp
constexpr const char* kHost = "127.0.0.1";
constexpr uint16_t kPort = 8080;

改为你的节点服务地址和端口，例如：

cpp
constexpr const char* kHost = "node.example.com";
constexpr uint16_t kPort = 9091;

编译并运行 Demo，确认能够连接节点并完成登录、心跳等基础流程。

头文件 ​

验证相关头文件：

text
license_secrets.h       # 需要妥善保护的应用密钥文件
authnexus_sdk_types.h   # SDK 类型与辅助定义
authnexus_sdk.h         # SDK 主头文件

保护标记相关头文件：

text
QvmSDK.h          # QVM SDK 标记
qvm_markers.h     # QVM 便捷封装
VMProtectSDK.h    # VMProtect SDK 标记
vmp_markers.h     # VMProtect 便捷封装

头文件使用

如果项目暂时不使用 QVM、CloudGate 或 VMP 标记，只接入验证能力时，优先关注验证相关头文件即可。

库文件 ​

Windows 验证库：

text
authnexus_sdk_full.lib
authnexus_sdk_protected_full.lib

Linux 验证库：

text
libauthnexus_sdk_full.a
libauthnexus_sdk_protected_full.a

QVM 相关库：

text
qvm_sdk.lib

protected_full 库

authnexus_sdk_protected_full 版本对 SDK 内部关键函数使用了保护标记。通常推荐使用该库，但最终成品也应按保护流程进行 VMP 或对应壳处理，否则保护标记不会发挥完整效果。

对接检查清单 ​

  • SDK 连接的是节点服务地址。
  • 节点端口已对客户端网络放行。
  • 应用密钥和 license_secrets.h 已妥善保护。
  • Debug Demo 跑通后，再迁移到正式项目。
  • 如使用 QVM/CloudGate 标记，继续阅读 QVM 与 CloudGate 文档。