> 本文整理自平台文档 docs/wujies/5.x/plugins/license.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-9ebe21e06b12-cover.svg)
应用编码 license,本页对应应用版本 1.0.3(引擎要求 >=5.6.2 <6.0.0),商业授权(app.json 里写 UNLICENSED),仓库 wujies-license-plugin(闭源,公开访问取不到源码)。
这个应用把「凭证怎么产生」收在一处:签发与运营台账、兑换码、激活记录、凭证下载。平台本体只留验证那一半(app_license 那一行、激活与解除、LicenseGuard.evaluate,以及 application.yml 的 app-market.license.*)。三档授权本身的区别见 [授权档位](/docs/wujies/5.x/license/editions),按应用解锁的口径见 [按应用授权](/docs/wujies/5.x/license/per-app)。
两把钥匙,各管一件事
| 钥匙 | 回答的问题 | 私钥在哪 | 公钥配在哪个键 |
|---|---|---|---|
| 包签名密钥 | 这个应用包是谁打的、上传后有没有被改过 | 每个应用仓库的 keys/private.pem | app-market.security.public-key |
| 授权签发密钥 | 这台部署买了什么、这枚凭证是不是签发方给的 | 签发方那台机器的仓库外路径 | app-market.license.public-key |
两把必须是不同的钥匙。共用一把时,给某个应用重新签包会连带影响所有已发出的凭证,轮换其中一把要同时重签另一件事的全部产物。包签名那对的生成与同步在 [密钥与签名](/docs/wujies/5.x/platform/package/signing),本页只管授权这一把。
装它
签发与台账这一半装在签发方自己那台(官网)。客户那台不需要装这个应用,它靠平台自带的验证代码读凭证。
装之前两件事按顺序确认,配反了签发接口只会回一句"没配私钥":
1. 签发私钥落盘。绝不把私钥明文写进任何 yml、文档示例或环境变量。推荐给一个仓库外的绝对路径,权限收到运行账号:
``bash # Linux 签发方 chmod 600 /etc/wujies/license-private.pem ``
喂值有三条路,优先级从高到低:后台「参数设置」里 wujies.license.private-key-file 那一行(运行期可改、每次签发重读文件,换钥不必重启)> JVM 参数 -Dwujies.license.private-key-file=… > 环境变量 WUJIES_LICENSE_PRIVATE_KEY_FILE。后两条要在起宿主之前设好,改了必须重启。
2. 验签公钥配对。WUJIES_LICENSE_PUBLIC_KEY 必须与上面那把私钥同一对,否则每一枚签出来的凭证都会在客户部署被判「签名不匹配」。客户那台忘配公钥时的表现是「任何凭证都判为 invalid,并明确报本机未配置公钥」,不会静默降级成社区版,这是刻意的:买了授权却因为运维漏配而看不到功能最难查。
生成这一对(生成到仓库之外;keygen 遇到目录里已有 private.pem 或 public.pem 会直接拒绝覆盖):
cd wujies-platform
mvn -o -q -pl wujies-modules/wujies-market-core compile
# <KEY_DIR> 换成一个仓库外的目录,Windows 下形如某个非项目盘的路径
java -cp wujies-modules/wujies-market-core/target/classes ^
cn.wujies.appmarket.security.PackageSignerMain keygen <KEY_DIR>
签发一枚凭证(payload 是一个 JSON 文件,档位与应用名单写在里面):
java -cp wujies-modules/wujies-market-core/target/classes ^
cn.wujies.appmarket.security.LicenseSignerMain issue payload.json <KEY_DIR>\private.pem
命令行这条路适合离线补签;日常签发走后台那屏。私钥路径只写进配置项,不要出现在提交、文档示例或截图里。私钥丢了只能把每一枚已售凭证重签,所以正式对外发授权前先把它备份到仓库之外的另一处。
配它
签发方那台要动的只有两个键,都在 application.yml 的 app-market.license 段:
| 键 | 默认 | 说明 |
|---|---|---|
issuer-enabled | false | 这台是不是签发方。改成 true 的那台才允许签发、看台账、生成兑换码;false 时这些端点当场报「这台部署不是授权签发方」,读侧不受影响 |
private-key-file | 空 | 指向仓库外的私钥文件。与 private-key(直接放 PEM 文本)同时配了以前者为准 |
issuer-enabled 这道闸挡的是误用与角色边界,挡不住机器主人:那台机器上的人当然能把开关改成 true。真正决定「能不能拿到付费包」的是包下发那一条路(中心按凭证发私有包,并断掉公开直链)。把这一页当成安全边界来读会得出错误结论。
客户那台要动的也是两个键,口径与上面一致:WUJIES_LICENSE_PUBLIC_KEY(验签公钥)与 app-market.license.mode(off / warn / enforce,默认 warn 放行并记日志)。mode 的值是 @Value 注入的字符串,写成空串或拼错都不报错,一律按 warn 处理,所以别指望「改错了会当场起不来」帮你发现笔误。到期宽限天数 grace-days 默认 7。
report-url(激活回报地址)只在客户那台配:配了签发方官网地址后,本机激活成功会回报一次设备信息(设备 ID、主机名、来源 IP),客户才能在「我的许可证 → 激活信息」里看到自己跑在哪几台。留空是内网与离线部署该有的样子,那张表空着是预期结果而不是故障;回报失败只记一行日志,不回滚已经成功的本机激活。生产上必须配 https,回报原文里是授权凭据。
用它
运营侧在「许可证签发」这一组菜单里做四件事,五个权限点逐条挂在角色上(license:ledger:list / query / issue / revoke / redeem-code),不要授给客户账号:签发一枚、看台账分页、撤销、批量生成兑换码、查兑换码状态。
台账分页按 state 筛(valid / grace / expired / revoked,空为不筛),四格状态与行上那句 stateLabel 出自同一份算法(LicenseState.filterBounds(graceDays, now)),SQL 里不重算,避免出现「这行写着有效、筛『有效』查不到它」。两个边界是 now - 1 天(valid 用它做严格大于,因为剩余天数走整数除法向零截断,刚过期不足一天仍判 valid)与 now - grace-days × 1 天(grace 的下界),调用方不许自己拼 86400000 或按 graceDays 算日期,等号方向一漂开就再造一次分歧。state 传那四个码值以外的东西会直接报错并列出合法值,不静默返回空表。下拉选项由 GET /app/issuer/license/ledger/options 一次给全(含「哪些档位能签」,community 不在里面),前端因此不必自己抄一份码值到中文的映射。
签发时 tier 与 grant 必填,apps 留空会被拒签(空名单等于白送),tier=community 签不出来:社区版是一台部署没有凭证时的默认状态,不是一种凭证。userId 可以留空,线下成交先有证、客户之后才注册账号;没绑定账号的行在客户侧任何一屏都查不到,只有台账列表看得见(AppLicenseLedgerQueryBo.unbound 那一格筛的就是它)。补一个「给已签发的凭证改绑账号」的端点本轮没做:改归属是敏感操作,得和操作留痕一起做,现在只有直接改库这一条路。签发入参里没有凭证字段:凭证只能服务端签出来,收现成凭证等于允许任何人往台账里插一枚别人签的授权。subscription 最长 36 个月(兑换码上以天数表达,上限 1095 天);version_lock 必须给版本上限 versionTo,它是签发与台账口径里的约束,部署侧当前只按签名与到期判定,别把它当成已经硬性的收口。apps 选项带的 minTier 只用于让签发页算默认勾选,服务端从不按档位推导名单,解锁什么只看签进凭证的 apps。
兑换码:POST …/redeem-code 批量生成、GET …/redeem-codes 查状态。授权内容在生成时逐行定死在码上(档位、名单、期限形态、域名、有效天数、版本上限),兑换端点只收 code,接受任何授权参数等于让三十块的码兑出企业版。抢码是一条带条件的 UPDATE … WHERE code = ? AND status = 'unused' 加影响行数判定,不是先查后写
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-9ebe21e06b12-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。