跳到正文
LLicentivo
进入控制台
LICENTIVO / INTEGRATION

Rust 软件授权：许可证激活与功能校验

把 Rust crate 加入 Cargo 应用，通过类型化回调保护真实导出。内置原生核心处理签名授权、设备凭据、心跳与浮动席位。

Rust 1.77+更新日期

1. 准备产品与许可证

先使用设备绑定许可证和普通导出功能，确认授权流程正常后再增加功能次数计量。

设备额度按当前激活设备计算，释放后返还；普通授权离线仍占用，浮动授权租约到期后自动返还。

  1. 在控制台“产品”复制产品 ID，点击同一产品的“签名公钥”，将每一组密钥 ID、公钥填进初始化代码，替换 YOUR_PRODUCT_ID、YOUR_KEY_ID 和 YOUR_PUBLIC_KEY。快速接入也可以直接复制已填好的代码。无需配置文件；SDK 默认连接 https://www.licentivo.com。
  2. 在「快速接入」创建或选择产品，在策略中启用名为 export 的功能，并准备测试许可证。

2. 安装 SDK

在自己的应用项目中运行下方安装命令或加入构建依赖，安装 SDK 0.11.6。包管理器负责获取 SDK，无需下载解压源码包或设置本地源码路径。

原生构建失败通常由缺少 C11 或 libcurl 头文件、架构不匹配、Windows 目标错误引起。当前 Windows 原生核心要求 GNU/MinGW，MSVC 验收尚未完成。

Terminal · new Cargo application
cargo new licensed_app
cd licensed_app
cargo add licentivo@=0.11.6
Ubuntu / Debian · native dependencies
sudo apt-get update
sudo apt-get install build-essential libcurl4-openssl-dev libssl-dev pkg-config
Windows x64 · PowerShell · GNU/MinGW
rustup toolchain install stable-x86_64-pc-windows-gnu --profile minimal
$env:LICENTIVO_CURL_ROOT = "C:/path/to/curl-mingw"
$env:PATH = "$env:LICENTIVO_CURL_ROOT/bin;$env:PATH"
cargo +stable-x86_64-pc-windows-gnu build

SDK 文档

3. 保护一次实际导出

将 SDK 初始化接到自己软件的启动或激活入口，从激活窗口读取客户授权码，传入自己的产品 ID、受信公钥并保持客户端存活。把 run_feature 放在真实业务入口，将导出示例函数替换成自己的实际功能。

Rust 1.77+ · src/main.rs
use licentivo::{Client, Error};
use std::{env, fs};

// BEGIN LICENTIVO PRODUCT
// Copy Product ID and all key ID/public key pairs from Console > Products > Signing public keys.
const PRODUCT_ID: &str = "YOUR_PRODUCT_ID";
const TRUSTED_KEYS_JSON: &str = r#"{"YOUR_KEY_ID":"YOUR_PUBLIC_KEY"}"#;
// END LICENTIVO PRODUCT

fn setting(name: &str, fallback: &str) -> String {
    env::var(name).ok().filter(|value| !value.is_empty()).unwrap_or_else(|| fallback.into())
}

fn export_report(path: &str) -> Result<(), Error> {
    // Replace this write with your existing export operation.
    fs::write(path, "A report generated by the licensed application.\n")?;
    Ok(())
}

fn run() -> Result<(), Error> {
    // A GUI supplies the activation input. Later starts use an empty key.
    let mut client = Client::open_product(
        PRODUCT_ID, TRUSTED_KEYS_JSON,
        &setting("LICENTIVO_LICENSE_KEY", ""),
    )?;
    let feature = setting("LICENTIVO_FEATURE", "export");
    let path = setting("LICENTIVO_OUTPUT", "licensed-report.txt");
    if setting("LICENTIVO_METERED", "0") == "1" {
        client.run_metered_feature(&feature, 1, &setting("LICENTIVO_OPERATION_ID", ""), || export_report(&path))?;
    } else {
        client.run_feature(&feature, || export_report(&path))?;
    }
    println!("License OK: {feature} is available\nExport completed: {path}");
    // Real app: keep client alive until shutdown. Drop returns floating seats;
    // do not deactivate a device on a normal application exit.
    Ok(())
}

fn main() {
    if let Err(error) = run() { eprintln!("{error}"); std::process::exit(2); }
}

4. 在应用退出时关闭客户端

本命令行示例执行一次操作后退出。接入桌面应用时，在启动时创建一个客户端，在导出按钮或命令中调用功能回调，直到应用退出才关闭客户端。

首次激活后，后续启动可将 LICENTIVO_LICENSE_KEY 留空，在相同用户及缓存位置恢复私有设备凭据。凭据保存在用户应用数据目录，不随安装包分发。关闭客户端会停止心跳并归还浮动席位；普通退出不应注销设备绑定。

只有策略允许、签名授权仍有效时才能离线使用。许可证过期或功能被拒绝时继续阻止业务操作；功能次数计量需要联网。

把可变 Client 保存在应用状态中。它支持 Send，但不支持 Sync；可移动到一个工作线程，避免并发共享调用。Drop 会停止后台工作并归还浮动席位，close 会消耗客户端；正常退出保留设备绑定。

桌面软件浮动授权：共享席位、并发限制与超时回收

5. 运行并核对结果

在控制台“产品”复制产品 ID，点击同一产品的“签名公钥”，将每一组密钥 ID、公钥填进初始化代码，替换 YOUR_PRODUCT_ID、YOUR_KEY_ID 和 YOUR_PUBLIC_KEY。快速接入也可以直接复制已填好的代码。无需配置文件；SDK 默认连接 https://www.licentivo.com。

  1. 使用允许 export 的有效许可证运行，确认生成 licensed-report.txt。
  2. 清空 LICENTIVO_LICENSE_KEY，以相同用户再次运行，确认可恢复已保存的设备凭据。
  3. 把 LICENTIVO_FEATURE 改为许可证没有的功能，并将 LICENTIVO_OUTPUT 改为新文件名。程序应提示拒绝，且不生成新文件。
  4. 仅在策略允许且签名授权未到期时测试离线重启。后台刷新报错后，也不能绕过失败的功能检查。
Windows · PowerShell
$env:LICENTIVO_LICENSE_KEY = 'YOUR_LICENSE_KEY'
cargo +stable-x86_64-pc-windows-gnu run
Linux · Bash
LICENTIVO_LICENSE_KEY=YOUR_LICENSE_KEY cargo run

常见接入问题

检查产品 ID、每组密钥 ID 和公钥、客户输入的授权码。公钥属于产品；客户许可证和本机凭证分别管理。开发测试授权码和厂商管理 API Key 不进入客户安装包。

功能被拒绝、设备数已满或许可证过期：在控制台核对许可证及策略，并向客户显示 SDK 错误。授权失败时不能调用导出函数。

普通功能接口只检查权限；计次接口负责预留和结算已配置的用量。每项真实业务使用独立且稳定的操作编号；中断恢复前先核对持久化业务结果。

原生构建失败通常由缺少 C11 或 libcurl 头文件、架构不匹配、Windows 目标错误引起。当前 Windows 原生核心要求 GNU/MinGW，MSVC 验收尚未完成。

SDK 参考: Rust 1.77+ SDK →

继续接入