ZLicense 1.1.7

ZLicense

通用许可证验证 SDK — 闭源商业软件 · 需授权文件 · Native 安全层 · Obfuscar 混淆

概述

ZLicense 是一套面向 .NET 应用程序的许可证验证 SDK，采用 ECDSA P-256 数字签名 + AES-256-CBC 加密 + 机器指纹绑定 三位一体的授权体系，关键验证逻辑下沉至 C++ Native DLL 执行，配合反调试、防篡改、Authenticode 签名验证等多层安全机制，为闭源商业软件提供可靠的授权保护。

授权说明：本 SDK 为闭源商业软件，使用前需获取授权文件 zlicense.auth.dll，放置于项目根目录或 licenses/ 子目录下。编译时 SDK 会自动验证授权文件的合法性。

特性

安装

dotnet add package ZLicense

安装后需将授权文件 zlicense.auth.dll 放置于项目根目录或 licenses/ 子目录下。

快速开始

1. 注册服务

using ZLicense.SDK;

// 基础注册（默认 1 小时周期性验证）
services.AddLicensingSdk(publicKey, storagePath);

// 自定义周期性验证间隔
services.AddLicensingSdk(publicKey, storagePath, TimeSpan.FromMinutes(30));

// 完整配置（自定义注册表路径和存储目录名）
services.AddLicensingSdk(
    publicKey,                // 91 字节 SPKI 格式 ECDSA P-256 公钥
    storagePath,              // 许可证文件存储目录
    periodicCheckInterval,    // 周期性验证间隔
    registryKeyPath,          // Windows 注册表键路径（篡改检测 + 试用期备份）
    storageDirName            // 本地应用数据目录下的存储子目录名
);

2. 验证许可证

using ZLicense.Core.Contracts;
using ZLicense.Core.Models;

public class MyService
{
    private readonly ILicenseManager _licenseManager;

    public MyService(ILicenseManager licenseManager)
    {
        _licenseManager = licenseManager;
    }

    public async Task DoWorkAsync()
    {
        var result = await _licenseManager.ValidateAsync();

        if (result.IsValid)
        {
            var license = result.License!;
            Console.WriteLine($"许可证有效: {license.ProductName} - {license.CustomerName}");
            Console.WriteLine($"到期时间: {license.ExpireAt:yyyy-MM-dd}");
            Console.WriteLine($"剩余天数: {license.DaysRemaining}");
        }
        else
        {
            Console.WriteLine($"许可证无效: {result.ErrorCode.GetDescription()}");
        }
    }
}

3. 导入许可证

// 从服务端获取的许可证字节数据
await _licenseManager.ImportLicenseAsync(licenseData);

4. 导出许可证请求

using ZLicense.Core.Enums;

// 导出首次激活请求
var requestData = await _licenseManager.ExportRequestAsync(RequestType.InitialActivation);
// 将 requestData 发送至授权服务端

5. 试用期管理

var trialInfo = await _licenseManager.GetTrialInfoAsync();
Console.WriteLine($"试用期: {(trialInfo.IsTrial ? "是" : "否")}");
Console.WriteLine($"剩余天数: {trialInfo.DaysRemaining}");

var isExpired = await _licenseManager.IsTrialExpiredAsync();

6. 验证指定文件

var result = await _licenseManager.ValidateLicenseFileAsync(@"C:\path\to\license.lic");

颁发端用法

生成许可证

using ZLicense.Cryptography;
using ZLicense.Core.Models;
using ZLicense.SDK.Codec;

// 创建加密服务
var signer = CryptographyServices.CreateSigner(privateKeyBytes);
var serializer = CryptographyServices.CreateSerializer();
var fingerprintProvider = new MachineFingerprintProvider();
var codec = new LicenseCodec(serializer, fingerprintProvider);

// 构建许可证
var license = new License
{
    LicenseID = Guid.NewGuid().ToString(),
    CustomerID = "CUST-001",
    CustomerName = "示例客户",
    ProductCode = "PROD-001",
    ProductName = "示例产品",
    Edition = "Professional",
    MachineFingerprint = fingerprintProvider.Generate(),
    IssuedAt = DateTimeOffset.UtcNow,
    ExpireAt = DateTimeOffset.UtcNow.AddYears(1),
    Type = LicenseType.Subscription,
    IsUniversal = false,
    Features = new List<string> { "ModuleA", "ModuleB" }
};

// 签名
var signedLicense = signer.Sign(license);

// 写入加密文件
codec.WriteLicense(signedLicense, "license.lic", encrypt: true);

验证许可证文件

var verifier = CryptographyServices.CreateSignatureVerifier(publicKeyBytes);
var result = verifier.Verify(license, signature);

API 参考

核心接口

核心模型

License

LicenseValidationResult

TrialInfo

LicenseRequest

枚举

LicenseType

RequestType

异常层次

LicenseException                          许可证基础异常
├── SignatureVerificationException        签名验证失败
├── MachineMismatchException              机器码不匹配
├── LicenseExpiredException               许可证已过期
├── TamperDetectedException               篡改检测
└── FeatureNotAvailableException          功能不可用

CryptographyServices 工厂

// 创建签名器（颁发端）
ILicenseSigner signer = CryptographyServices.CreateSigner(privateKeyBytes);

// 创建签名验证器
ISignatureVerifier verifier = CryptographyServices.CreateSignatureVerifier(publicKeyBytes);

// 创建序列化器
ILicenseSerializer serializer = CryptographyServices.CreateSerializer();

错误码

分类编码规则

三位编码：百位 = 类别，十位 + 个位 = 序号

完整错误码

错误码扩展方法

var description = result.ErrorCode.GetDescription();  // 获取中文描述
var description = LicenseErrorCode.Exception.GetDescription("详情");  // 异常类错误码可传入详情

架构

ZLicense
├── Core/               领域模型、接口契约、枚举、异常
│   ├── Contracts/      接口定义（ILicenseManager, ILicenseCodec, ...）
│   ├── Models/         领域模型（License, LicensePayload, LicenseValidationResult, ...）
│   ├── Enums/          枚举（LicenseType, RequestType, LicenseErrorCode）
│   └── Exceptions/     异常层次（LicenseException 及其子类）
├── Cryptography/       加密原语
│   ├── ECDSA/          ECDSA 签名器（EcdsaSigner）
│   ├── Signatures/     签名验证适配器（SignatureVerifierAdapter）
│   └── CryptographyServices  加密服务门面（工厂方法）
├── Infrastructure/     基础设施（密钥辅助、加密辅助、Native DLL 哈希）
├── SDK/                业务入口
│   ├── SdkServiceRegistration  DI 服务注册扩展
│   ├── Runtime/        LicenseManager 实现
│   ├── Codec/          LicenseCodec 编解码器
│   ├── Fingerprint/    MachineFingerprintProvider
│   ├── Validation/     LicenseValidator
│   ├── Storage/        SecureStorage（DPAPI 加密）
│   ├── Tamper/         TamperDetector（时间回滚 + 哈希校验）
│   ├── Trial/          TrialManager（试用期管理）
│   ├── AuthGuard/      SDK 授权守卫（编译时 + 运行时验证）
│   ├── Native/         NativeLicenseBridge（P/Invoke 桥接层）
│   │   └── Wrappers/   Native 包装类（Native 优先 + 托管回退）
│   └── Guard/          ZLicenseGuardKeys（公钥与包 ID）
├── Native/             C++ 原生安全层
│   ├── Business/       业务逻辑（指纹、编解码、验证、注册表、安全存储、试用期）
│   ├── Crypto/         加密原语（AES、DPAPI、ECDSA、SHA-256）
│   ├── Security/       安全机制（反调试、Authenticode、防篡改）
│   └── Export/         导出函数（序号导出 #2 ~ #45）
├── build/              NuGet 包 MSBuild targets
│   └── ZLicense.targets  编译时授权验证 + Native DLL 复制
└── Polyfills/          netstandard2.0 兼容层

Native 安全层

NativeLicenseValidator.dll 是 ZLicense 的原生安全层，将关键验证逻辑下沉到 C++/Win32 层执行，避免 .NET 托管层被轻易反编译和篡改。

构建配置

导出函数概览

指纹匹配权重

完全匹配快速返回 1.0，否则按组件逐项加权计算。

防篡改检测位掩码

安全机制

反调试保护

所有关键导出函数入口均调用 AntiDebugCheck()，通过 IsDebuggerPresent() 和 CheckRemoteDebuggerPresent() 检测调试器附加，一旦检测到立即调用 TerminateProcess 终止进程。C# 桥接层额外实现了 IAT/EAT Hooking 检测（VerifyExportAddresses()）。

SPKI 公钥完整性校验

VerifySpkiIntegrity() 对传入的 SPKI 公钥执行字节级结构验证：

• 长度必须为 91 字节
• 偏移 [0..2] 必须为 0x30 0x59（SEQUENCE）
• 偏移 [2..4] 必须为 0x30 0x13（内层 SEQUENCE）
• 偏移 [23..25] 必须为 0x03 0x42（BIT STRING）
• 偏移 [25..27] 必须为 0x00 0x04（未压缩点标记）

DLL 自校验

构建时通过 inject-self-hash.ps1 将 DLL 的 SHA-256 哈希注入到 PE 文件的专用槽中，运行时 NL_SelfVerify() 重新计算哈希并与存储值比对，检测 DLL 是否被篡改。

链接器保护

Release 构建启用 /NOEXP 禁止导出导入库，GenerateDebugInformation 设为 false，防止通过导入库或 PDB 泄露符号信息。

与 C# 层的集成

• C# 侧通过 NativeLicenseBridge 类使用 DllImport P/Invoke 调用本 DLL
• 构建流程：ZLicense.csproj 在 BuildNativeValidator Target 中通过 vswhere 定位 MSBuild 编译本项目
• 产出物 NativeLicenseValidator.dll 通过 NuGet 包的 build\ZLicense.targets 在消费项目构建时自动复制到输出目录
• 所有 Native 包装类采用 Native 优先 + 托管回退 策略，当 Native DLL 不可用时自动降级到托管实现

SDK 授权守卫

ZLicense 使用 SDKGuard 授权体系，确保只有获得授权的开发者才能使用本 SDK：

1. 编译时验证：ZLicense.targets 在 CoreCompile 之前检查 zlicense.auth.dll 的存在性、大小（224 字节）、魔数（ZLOG）、版本号和 PackageId
2. 运行时验证：SdkServiceRegistration.AddLicensingSdk() 调用 GuardValidator.Initialize() 验证授权 DLL 的 ECDSA 签名

授权文件搜索路径（按优先级）：

1. 项目根目录
2. licenses/ 子目录
3. License/ 子目录

混淆策略

Release 构建自动执行 Obfuscar 混淆，混淆后替换原始 DLL：

保留的公共 API

以下命名空间和类型不参与混淆，确保消费者正常使用：

运行要求

• Windows x64
• .NET 8.0+ 或 .NET Framework 4.6.2+（通过 netstandard2.0）