把授权接进你的软件

用约 15 分钟完成一个受授权保护的导出功能：取得配置、运行示例、接入自己的应用，再验证权限拒绝。前提是已安装对应语言的开发环境。

SDK 负责请求、设备识别、验签、凭证保存、缓存和心跳。你提供客户输入的授权码和业务函数，无需自己组装 HTTP 请求或保存 activation_id。

1. 准备接入包控制台生成产品设置
2. 生成导出文件检查授权与业务结果
3. 接到软件启动、业务入口、退出

1. 在控制台准备接入包

打开 快速接入，填写软件名称，选择绑定设备或浮动席位，点击“创建产品，下一步”。系统会准备产品、策略、测试许可证、公钥和 1.0.0 版本。选择语言，下载并解压已配置的接入包。

包里有两个配置：sdk-demo.json 含测试授权码，留给你自己测试；product.json 只含产品设置和公钥，可以随软件分发。

首次接入建议选择绑定设备。默认示例有 export 功能，先不配置次数限制；已有产品需要在策略和许可证中允许同名功能。

2. 检查环境并导出一个文件

在解压根目录打开终端，保留 product.json、sdk-demo.json、start.ps1、start.sh 和 sdk 目录。选择语言和系统后执行下列命令；环境检查不发送激活请求。

成功标志：退出码为 0，出现下列输出，并生成 licensed-report.txt。去掉测试参数后再运行，SDK 会恢复本机凭证，绑定设备不会重复占用名额。

License OK: export is available
Export completed: licensed-report.txt

缺少工具时先安装对应开发环境；C/C++ 还需 libcurl 开发文件。Windows MinGW 可传入 -CurlRoot。浏览器接受证书警告不会让 SDK 信任证书，测试服务器的证书也必须被运行环境信任。

3. 接到客户的软件里

在现有项目目录运行官网安装器。九种语言共用版本 0.10.0，安装器先校验 SHA-256，再安装依赖或解压构建包。仅将 product.json 加入应用资源。

当前语言的可运行文件：。复制其业务入口到自己的项目，查看完整代码 →

4. 验证没有权限时无法导出

确认策略未包含 licentivo_denied_probe，然后运行以下命令。应返回非零退出码，且不创建 denied-report.txt；请使用尚不存在的输出文件检查。

5. 需要按次数收费时

将业务函数传给 RunMeteredFeature，并提供稳定的任务编号。SDK 自动预留次数、成功后确认、失败时取消，并记录待确认任务。查看计次接入和重试 →

先分清这三个名字

心跳间隔与允许离线时长在 授权策略分别设置；许可证有效期从首次激活开始。功能次数、浮动席位和离线文件激活可以在基础接入完成后添加。

暂时不注册也可以打开 在线体验查看请求与返回。需要自动签发许可证时，继续读 管理 API Key。

客户端 SDK

将业务函数交给 SDK：普通功能用 RunFeature，计次功能用 RunMeteredFeature。请求、验签、缓存和心跳由 SDK 处理。

运行前准备

在控制台 快速接入下载已配置的接入包。演示使用私有的 sdk-demo.json；放进实际软件时使用 product.json，客户授权码作为启动参数传入。下方“下载 SDK”是通用源码包，尚未填写你的产品设置。

{
  "base_url": "https://www.licentivo.com",
  "product_id": "PRODUCT_UUID",
  "license_key": "",
  "device_name": "Customer app",
  "app_version": "1.0.0",
  "trusted_keys": {
    "SIGNING_KEY_UUID": "BASE64URL_PUBLIC_KEY"
  },
  "timeout_seconds": 10,
  "allow_http": false
}

选择你的语言

以下代码与下载包中的文件一致，会实际生成导出文件。示例以环境变量代替激活输入框；接入时换成自己的界面输入，并保留应用生命周期内的 client。

用 SDK 执行受保护的业务，退出时关闭 client。

正在加载代码…

运行一个真正的应用示例

示例包含激活输入、授权状态、导出文件和主动解绑。Java、Python、C# 有窗口，其余语言使用终端菜单。首次输入授权码，以后留空恢复。

导出成功会生成 licensed-report.txt。按次数导出前，请在策略里配置 export 的次数规则。

窗口和菜单演示展示了底层预留接口。新接入建议用下方源码中的 RunMeteredFeature，九种语言均会保存待确认记录；业务执行中途崩溃时，仍需从自己的业务结果核对是否完成。

如何显示授权状态？

Status 和 FeatureStatus 只读本地状态，不发送请求，也不等待后台网络验证。状态变化通知可以用来刷新界面。

allowed 表示本机授权是否有效；按次数的功能仍需请求额度。lease_valid_until 是签名缓存截止时间，不是许可证最终到期时间。code、request_id 和 retryable 分别说明错误、日志编号和能否重试。

各语言的方法名、通知回调和安装包用法见下载包的 sdk/README.md。官网提供版本安装包与统一安装器，公共包仓库发布仍暂缓。

接到实际应用时，放在哪些位置？

表中的名称表示对应操作，不同语言的实际方法名以示例为准。心跳、离线缓存和联网刷新的详细行为见 心跳与离线设置。

管理 API Key

当你希望自己的订单系统自动签发许可证，或从服务器读取授权数据时，使用管理 API Key。它代表你的厂商工作空间。

客户端需要的是哪一种密钥？

如果你只接入客户软件的授权验证，使用许可证密钥就够了。管理 API Key 可以操作整个工作空间，不能放进客户软件或公开网页。

创建一个 Key

1. 用工作空间 Owner（所有者）账号登录，打开 API Key，点击“创建 API Key”。
2. 名称填它的用途，例如“订单系统”。只查询时选“只读”；要创建或修改许可证时选“读写”。有效期可设为 1–365 天。
3. 保存后立即复制完整 Key，它只显示一次。把它放在你服务器的私有配置或环境变量中。

发送第一个管理请求

示例读取产品列表。将 LICENTIVO_URL 设置为授权服务器地址，将 LICENTIVO_API_KEY 设置为刚创建的完整 Key，再执行：

curl "$LICENTIVO_URL/api/v1/products?limit=25" \
  -H "Authorization: Bearer $LICENTIVO_API_KEY"

这是 Bash / macOS / Linux 的写法。Windows PowerShell 请使用 curl.exe，环境变量用 $env:LICENTIVO_URL 和 $env:LICENTIVO_API_KEY。九种语言的完整请求代码也放在 SDK 页的“服务端管理 API Key”选项中。

成功时返回 HTTP 200，正文包含 data.items。使用 Bearer Key 的管理请求不需要登录 Cookie 或 CSRF Token。

权限和失效处理

只读 Key 能查看资源；读写 Key 还能创建和修改产品、策略、许可证。管理 Key 不用于账号、团队、系统设置或收款操作，这些操作需要相应账号登录。

Key 泄漏或不再使用时，在控制台吊销；需要更换时点击“轮换”。旧 Key 会立即失效，随后更新你服务器上的配置。

套餐中的 API 调用额度统计激活、验证、心跳和释放。这里的管理请求不计入这项额度。

产品与许可证 API

把下单后的签发工作接到你自己的服务器：先建立产品和策略，再为每位客户创建许可证。前两项通常只需配置一次。

先在控制台创建有写权限的 管理 API Key。以下示例使用 Authorization: Bearer 你的管理Key；这个 Key 保留在厂商服务器中。

尚未激活的限期许可证，expires_at 和 first_activated_at 都是 null。首次成功激活后才开始计时；换机不会重新获得有效天数。

后续管理

列表分页使用 limit=25&offset=0，limit 最大为 100。其他接口的参数和结构见 OpenAPI 文件；不同授权方式的接入步骤见左侧对应主题。

SDK 授权调用

选择你的语言和操作，直接调用 SDK。激活、设备识别、验签、缓存、心跳，以及计次的预留、确认和取消都由 SDK 处理。

业务示例中的 client 来自启动授权，path 是你的导出路径，exportReport / export_report 是你自己的业务函数。计次的 jobID 是由应用保存的稳定任务编号。

查看完整代码 → · 快速开始 · 查看计次接入和重试 →

心跳与离线设置

这两个设置都在“授权策略”中，但解决的是两件事：有网时多久联系服务器，以及联系不上时还能使用多久。

心跳间隔：多久验证一次

在“心跳请求间隔（秒）”中填写 600，SDK 就会在运行期间大约每 10 分钟发送一次心跳。每次成功都会取得最新的运行规则，并刷新本机授权缓存。

可填写 600–86400 秒。填写 0 会关闭定时心跳，应用仍可以主动调用验证或刷新。定时请求会增加 0–10% 的随机延迟，实际间隔不会低于 600 秒。

绑定设备且缓存有效时，启动会先恢复授权，再在后台联网刷新，关闭定时心跳时也会刷新。不允许离线或使用浮动席位时，启动必须等服务器确认。

离线时间：服务器联系不上时能用多久

“允许离线方式”有三种选择。它不会替你修改心跳间隔。

允许指定时长

例如填写 24 小时：从最近一次成功联网验证开始，签名缓存最多有效 24 小时。期间断网或服务器临时故障，软件可以继续用；超过这个时间后，需要成功联网验证。

不允许离线回退

启动必须成功联系服务器，请求失败时不会靠磁盘缓存放行。运行中取得的短期签名最多有效 max(10, 心跳间隔) 秒；应用需要持续验证并检查功能权限。

允许永久离线

已经取得的本机签名可以长期使用，网络失败时仍能检查权限。如果许可证本身只有 30 天，仍会在 30 天到期；永久离线不会把期限授权变成永久授权。

接口用 offline_mode 表示这三种选择，依次为 limited、none、permanent。指定时长时，offline_seconds 为 1–31536000 秒；另外两种方式填 0。

这几个组合会怎样运行？

建议离线时间长于心跳间隔。如果设成“每小时心跳，但只允许离线 1 分钟”，签名会在下一次定时心跳前过期，应用必须另行验证。

修改策略后，旧许可证会更新吗？

会。修改心跳或离线设置后，关联的旧许可证和新许可证都在下一次成功激活、验证或心跳时采用新规则，SDK 用新签名替换缓存。相同 Idempotency-Key 的重试仍会返回原来那次请求的结果。

持续断网的设备暂时不知道规则变了，仍按已有签名使用。仅仅接上网络也不会自动改写缓存，要有一次成功的请求。应用可以在网络恢复时主动刷新。

主动联网刷新

下面的方法始终尝试联系服务器，包括“永久离线 + 关闭心跳”的情况。成功后更新签名；网络失败会报刷新失败，同时保留仍允许使用的旧缓存；明确被吊销或释放时清除缓存。

刷新成功计一次激活 API 请求。如果刚更新的策略开启了原来关闭的心跳，再调用对应语言的 StartHeartbeat 启动调度。持续离线时，设备也无法收到吊销或释放通知。

设备绑定

一份许可证设置为单设备后，客户把软件和缓存复制到另一台普通电脑，不能直接继续使用原电脑的授权。

SDK 怎么知道是哪一台电脑？

每次启动时，SDK 读取操作系统的机器身份，结合产品 ID 计算设备哈希。服务器签名中包含这个哈希，本地检查也会核对它。

Windows 读取 MachineGuid，Linux 读取 machine-id，macOS 读取 IOPlatformUUID。原始机器身份不会上传，只发送计算出的哈希；配置文件中的旧 device_id 不会覆盖实际读取的本机身份。

把机器 A 的文件复制到 B 会怎样？

1. A 激活后，拿到的签名绑定 A 的设备哈希。
2. B 读取自己的系统身份，得到不同的哈希，因此拒绝 A 的缓存。
3. B 必须联网重新激活。如果设备上限为 1，且 A 还没释放，服务器会拒绝增加 B。

客户要换电脑，怎么处理？

让客户在旧电脑上主动解绑，再在新电脑激活。如果旧电脑损坏，你也可以在控制台的“设备激活”页面释放旧绑定。换电脑不会重置许可证的到期时间。

操作系统重装后机器身份可能变化，需要按新设备处理。完整克隆操作系统、伪造系统身份或修改客户端程序属于更强的攻击，单靠这个设备哈希不能保证防住。

允许长期离线时，A 已持有的旧签名无法马上得知它被释放了；它要再次成功联系服务器，才能更新这个状态。离线时间越长，远程限制越难立即生效。

SHA256(UTF8(
  "LicenovaDevice/v2\n"
  + lower(product_id) + "\n"
  + lower(trim(OS_machine_identity))
))

额度与计费

设备额度统计用了多少台设备，API 额度统计向服务器成功请求了多少次。两者分别计算，不能用设备数推算 API 次数。

哪些操作会用掉一次 API 额度？

一个设备很多次请求，设备额度会重复扣吗？

不会。同一计费周期内，同一产品的同一台设备只计一次设备用量，但它的每次成功心跳都计 API 用量。释放设备不会减掉已经产生的用量。

例如 100 台设备，每天运行 8 小时，每月 22 天，每 10 分钟心跳一次，仅心跳就有 105,600 次。再加上 100 次激活和每天每台一次额外验证，总共是 107,900 次。

这些额外验证是例子里的假设，实际次数取决于你的程序。可在 在线用量估算中修改设备数、运行时间和请求间隔。

超过套餐额度以后怎么收钱？

以“包含 10 万次 API，超出每次 0.0001 USD”为例：周期内成功调用了 12 万次，超出 2 万次，API 超额费是 2 USD。

允许超额的套餐按管理员设置的单价，从余额扣除。系统把累计金额四舍五入到分，只扣新增的差额，因此很小的单次价格不会因每次舍入而被重复收费。

设备超额费另算：超额设备数 × 设备单价。某一项设成硬上限时，用完后拒绝该项超额请求；需要扣款但余额不足时，也会拒绝下一次请求。该失败请求不增加用量。

API 标为“不限次”时不产生 API 超额费。额度为 0 则没有免费调用，从首次成功请求开始按超额规则处理。具体包含额度、单价和限制请看 当前套餐，这里的数字只是计算示例。

套餐期限和额度从哪天算？

可以购买 1、3、6 或 12 个月。付款成功后立即生效，一次支付所选期限的总价。

设备与 API 额度按月重新计算，从套餐生效时刻开始。1 月 31 日生效，下一次重置在 2 月最后一天，再下一次在 3 月 31 日；未用完的额度不累积。

没有购买套餐时，使用管理员设置的默认规则，按 UTC 自然月统计。默认设备费用沿用月结账单；默认 API 超额费即时扣余额。购买后使用购买周期的额度，不与默认额度叠加。

运行请求因额度或余额不足被拒绝后，已有的离线签名仍按它原来的规则有效。厂商可以在控制台释放设备，不需要占用客户的运行 API 额度。

浮动席位

浮动授权限制同时运行的程序数量。它适合多人轮流使用同一款软件，不要求为每台电脑单独买授权。

一个例子

客户有 100 台电脑，你签发 10 个浮动席位。前 10 个程序可以启动，第 11 个收到“席位已满”。其中一个正常退出并关闭 SDK 后，其他程序就能取得这个席位。同一台电脑启动两个程序，也占两个席位。

在策略里设置

选择“浮动席位”，把设备 / 席位上限设为 10。心跳间隔最低 600 秒；席位租约必须比心跳间隔长，例如 1200 秒。每次心跳续租，崩溃或断网后，租约到期会回收席位。

浮动授权可以在租约内短暂断网。离线使用时间会同时受到席位租约约束，不能允许永久离线，也不能用文件完成完全离线首次激活。

代码需要额外处理什么？

使用 Open / Start 和正常关闭方法即可。SDK 为每个 client 生成独立会话 ID；不要为一次导出操作创建一个新 client。把一个 client 保留到整个程序退出。

客户端的旧浮动缓存不会在下一次进程启动时自动恢复席位。租约已经过期时，先重新激活，取得席位后再恢复业务。

离线文件激活

目标电脑完全不能联网时，用申请文件和签名响应完成首次激活。申请文件可以通过 U 盘带到另一台联网电脑。

操作步骤

1. 在目标电脑加载 SDK 配置，调用 OfflineRequest("activate")，保存申请文件。生成申请不需要访问服务器。
2. 在联网电脑打开控制台的“离线文件激活”，上传申请并下载响应。终端客户也可以在自己的客户门户中办理。
3. 把响应带回目标电脑，调用 ImportOffline，传入原申请和响应。SDK 检查签名、申请编号、版本以及本机身份，通过后保存缓存。
4. 用 CheckFeature 检查授权。离线电脑无需启动在线心跳；允许离线多久，由授权策略决定。

文件激活只支持允许离线的绑定设备授权。申请有效期 30 天。限时许可证从服务器批准申请时开始计时，因为服务器无法知道响应文件什么时候被导入。

如何离线解绑？

在原电脑生成 OfflineRequest("deactivate")。SDK 会先删除本地缓存，再把申请交给厂商或客户门户办理释放。删除原电脑缓存不能证明没有其他历史副本；需要立即阻止旧授权时，应使用需要定期联网的策略。

各语言的名字

C 返回的文本由调用方使用 ln_free_string 释放。响应文件传入的是文件本身的内容，不是网页 API 外层的 data 包装。

功能次数

“允许导出”与“每月允许导出 500 次”是两条不同的规则。RunFeature 只检查权限；RunMeteredFeature 在业务成功后确认次数。

设置每月 500 次导出

在策略的功能列表中添加 export，再增加一条功能额度：功能 export、额度 500、周期“每月”。默认用完就拒绝。允许额外使用时，填写最多额外次数；系统会记录超出量，供你的订单系统处理。

每天和每月额度按 UTC 零点重置；累计额度不重置。修改额度不会删除已经使用的次数。

导出成功后，才确认扣次

把自己的业务函数传给对应 SDK 方法。新任务使用新编号，同一任务重试使用原编号、功能和数量；不同进程不要同时执行同一编号。

先设置 export 的功能额度，再用快速开始的脚本加上 -Metered -OperationID export-job-001（Windows），或 --metered --operation-id export-job-001（Linux / macOS）。

返回字段怎么读？

发送什么、返回什么和每个字段的类型，见授权验证接口中的预留、确认和取消。

Consume 仍可用于直接记账，但会立即扣次。需要避免业务失败仍扣次时，请用预留流程。所有计次接口都需要联网，不计入平台四类 API 调用额度。

版本与维护期

买断软件可以永久使用，但不一定永久免费升级。维护期用来决定客户可以使用哪些发布时间的版本。

买断当前版本，免费更新一年

策略设为永久授权，维护天数设为 365。客户首次激活时开始计算维护期。打开“软件版本”发布 1.0.0、1.1.0 等版本，填写实际发布时间。

维护期内发布的版本可以继续使用；维护期结束后发布的新版本会被拒绝，旧版本仍可使用。客户续维护后，再到许可证“权益与客户”中延长维护期。

软件如何传自己的版本？

在 sdk-demo.json 中填写 app_version，例如 1.1.0。使用维护期时，这个版本必须先在控制台发布。版本格式暂时只接受三个数字，例如 1.2.3。版本记录不能改发布时间，避免改日期改变已经售出的权益。

只想限制 1.x 版本时，也可以设置最小 1.0.0 和最大 1.999.999，不启用维护期。软件更新后重新联网取得新版本的签名授权，旧版本缓存不能直接用于新版本。

提供下载

版本记录可以附上 HTTPS 下载地址和 SHA-256 校验值。客户门户只展示这份授权有资格使用的版本。当前记录提供下载链接，不代你上传安装包，也不会自动给客户安装更新。

客户门户

客户可以自己查授权、查看设备和解绑，不用进入厂商控制台。

厂商先关联客户邮箱

签发许可证时填写客户邮箱，或打开许可证的“权益与客户”补填。把 客户门户链接发给客户。客户输入这个邮箱，邮件中会收到一次性登录链接，15 分钟内有效；登录状态保留 24 小时。

客户只看到关联到这个邮箱的许可证，不会看到你的产品管理、账单或其他客户的数据。邮件服务需要先在管理员设置中接好。

客户换了电脑，但找不到原来的密钥，怎么办？

1. 客户输入许可证关联的邮箱，打开邮件里的登录链接。链接只负责登录，不会直接解绑。
2. 在“我的设备 / 会话”找到旧电脑，点击“解绑并换机”，核对设备后确认。
3. 页面显示临时激活码，有效期最长 15 分钟，只能成功激活一次。客户可以复制，也可以勾选发送到自己的邮箱。
4. 在新电脑打开你的软件，在激活界面输入临时码。SDK 会识别新电脑，绑定原许可证并保存设备凭证。此后重启和心跳使用设备凭证，临时码到期不影响已激活的新电脑。

这一步更换的是设备绑定。许可证编号、原到期时间、功能、客户归属和已用次数都保留；不会另外签发一份许可证。新设备必须符合原授权策略，也必须有空余设备名额。

软件厂商需要改哪里？

升级到当前 SDK。原来接受许可证密钥的输入框，也可以接受 lv_tmp_ 开头的临时码；传入配置的 license_key 即可，后面的 Start、验证和心跳接口照常使用。SDK 会在私有缓存目录保存设备凭证文件；cache_path 可留空。这个文件要保存在当前用户的应用数据目录，不要跟安装包分发。

成功兑换后，软件可以把 license_key 留空；保持同一产品、公钥和 cache_path，重启时 SDK 会恢复设备凭证。客户不用保存或反复输入临时码。兑换尚未成功时，软件应保留输入，以便断线重试。

激活码过期，或关闭了这个页面

再次登录门户，可以看到尚未使用的临时码。未使用的码过期后，在对应的已释放设备旁点击“查看 / 获取激活码”重新取得；这不会再扣一次换机次数。已经成功使用的码无法再次兑换，也不能从旧设备记录反复领取来绕过次数限制。再次换机请解绑当前的新设备。

新电脑完全离线时

在新电脑的软件里填入临时码，用 SDK 导出激活申请。在临时码过期前，把文件带到联网电脑并通过门户生成响应，再带回新电脑导入。策略必须允许设备绑定模式的离线激活；期限仍按原许可证计算。响应文件包含这台机器的授权与凭证，需要妥善保管。

解绑次数和旧电脑的状态

自助释放次数可以在授权策略中设置，按每份许可证每个 UTC 月计数；设置为 0 表示关闭新的门户自助解绑。重复点击、查看已有码、过期后重发未用码不会多扣次数。此限制覆盖客户门户及客户离线释放申请，厂商手工释放和软件直接使用原许可证密钥调用释放接口不受它限制。

远程解绑会阻止旧设备下一次联网验证；旧电脑上已有的离线缓存仍需等联网或到期才会失效。永久离线缓存无法立即远程停用，需要及时撤销授权的产品应选择定期联网策略。正常复制配置、凭证和缓存到另一台电脑，SDK 会因机器身份不同拒绝使用。

客户门户管理授权使用，厂商的订单和软件销售收款仍由厂商自己的系统完成。

授权事件通知

当许可证激活、续期或被吊销时，Licentivo 可以向你的服务器发一条通知，用来同步订单、客户和售后系统。

设置接收地址

打开“授权事件通知”，添加你服务器的 HTTPS 地址，选择需要的事件。保存时会显示一次签名密钥，把它保存在接收通知的服务器上。正式环境不允许请求本机或内网地址。

接收后检查签名

读取 X-Licentivo-Timestamp、X-Licentivo-Event 和原始请求正文。拼接为“时间戳 + 点号 + 事件 ID + 点号 + 正文”，用签名密钥计算 HMAC-SHA256。加上 sha256= 前缀后，与 X-Licentivo-Signature 做恒定时间比较。时间戳与当前时间相差超过 5 分钟时拒绝。

事件 ID 是去重依据。先检查签名，再把事件放入自己的事务或队列，持久化成功后返回 2xx。重复事件返回 2xx 即可，不重复执行订单操作。

失败会怎样？

系统最多自动尝试 8 次，逐步延长重试间隔。控制台能查看每次 HTTP 状态、尝试时间和错误，也可以手动重新投递。事件与授权操作在同一个数据库事务里记录，服务重启后会继续投递。

支持创建、更新、续期、吊销、激活、释放、功能消耗、即将到期、到期和维护期变化事件。通知只带授权前缀，不包含完整许可证密钥。

批量与策略变更

同一批客户需要相同授权时，可以一次签发、续期或吊销。需要改变旧许可证权益时，先预览影响。

批量签发或导入

打开“许可证”页面，点击“批量签发 / 导入”，选择产品和策略。每行填写客户名称、邮箱，或者上传带 customer,customer_email 表头的 CSV。每批最多 100 条。成功后下载签发结果，保存完整授权码。

一个批次中的任意一条失败，整批都不会生效。网络超时后保持当前内容重试；系统按这次操作的请求编号返回原结果，不会再次签发。

批量续期或吊销

在许可证列表左侧勾选记录，再点击“批量续期”或“批量吊销”。表头的复选框选择当前页，翻页后已选记录会保留，每批最多 100 份。更换筛选条件、离开许可证页面或刷新页面会清空选择。

续期时填写增加的天数；尚未激活的许可证增加有效天数，已激活的延长原到期时间，已经过期的从当前时间延长。吊销前请展开所选记录核对客户，吊销无法恢复。只读成员不能执行这些操作。

把新策略应用到已有许可证

1. 在“授权策略”中保存新规则。
2. 在“许可证”页面勾选同一产品的旧许可证，点击“应用策略”并指定新策略。
3. 检查有效期、设备或席位数、功能、次数和维护期的变化。已经占用的席位多于新上限，或切换绑定方式时还有活跃设备，系统会要求先处理设备。
4. 确认后应用。客户端下一次联网验证取得新的签名授权；当前完全离线缓存不会被远程修改。

预览在 10 分钟内有效。预览之后许可证或策略有变化，需要重新预览。应用新有效天数会按原首次激活时间重新计算到期日，请先检查预览中的日期。

常见问题

先看返回的错误码，再核对对应设置。响应里的 request_id 可以帮助你从服务器日志中找到这次操作，不要把完整密钥贴进日志或截图。

激活失败，先检查什么？

检查服务器地址能否访问、产品 ID 是否正确、授权码是否完整，以及许可证是否属于这个产品。如果服务器还没部署，客户电脑不能用你的 127.0.0.1 地址连接，它表示客户自己的电脑。

断网后还能用，是否没有验证？

允许离线时，SDK 仍会在本机检查服务器签名、产品、设备、功能和到期时间。它只是没有联系服务器。签名缓存过期，或已联网收到吊销、释放等明确拒绝后，就不能继续使用。

为什么验签或设备检查不通过？

公钥不匹配、使用了其他产品的缓存、把缓存复制到另一台电脑，都可能导致失败。核对 trusted_keys 的密钥 ID 和公钥是否来自当前产品，再检查是否更换或重装了系统。

SDK 报 clock rollback 时，检查系统时间是否被调回。修正时间后，尝试主动联网刷新授权。

完整的错误响应

{
  "error": {
    "code": "LICENSE_REVOKED",
    "message": "License was revoked"
  },
  "request_id": "99999999-9999-4999-8999-999999999999"
}

400 / 415 先修正字段或 Content-Type；401 检查管理 Key；403 按具体错误码处理授权；409 检查额度、会话或幂等冲突；429 按 Retry-After 等待。超时或 5xx 可以有间隔地重试，写操作必须沿用原幂等编号和正文，避免重复计次。

请求返回的 JSON 怎么看？

成功返回 data 和 request_id；失败返回 error.code、error.message 和 request_id。保留错误码和 request_id 就能定位多数问题。

需要检查邮件、支付或部署设置时，继续看 支持与排查。