Wujies 无界平台
授权与版本

激活与查看档位

在本机后台粘贴凭证激活授权、确认解锁真的生效,以及换机器与改数据库时的边界。

凭证已经到手,这一页处理怎么让它在这台部署上生效。凭证怎么产生、期限形态与价格见计费形态与价格;签发那一侧(私钥、签发端点、兑换码)见许可证插件。

激活之前先确认三件事

  1. 这台部署配了验签公钥,并且与签发方的私钥是同一对。键是 app-market.license.public-key,容器与面板部署通常用环境变量 WUJIES_LICENSE_PUBLIC_KEY 注入。配置由 LicenseProperties 在启动期绑定,改了公钥要重启宿主。
  2. 你的账号持有 app:license:edit。激活与解除都要它;只有 app:license:query 的账号能打开授权管理页,但按钮不会出现。
  3. 手上是完整一段以 wjl1. 开头的文本。它是三段点分格式,粘贴时被编辑器换行截断是最常见的一次失败。

公钥没配也进得去页面,激活只会得到一句「本机未配置授权验签公钥」。这一条是刻意的:留空公钥时任何凭证都判无效并把原因说出来,绝不安静地按社区版处理。客户买了授权、因为交付方漏配而看不到功能,是最难查的一类问题,报错必须替他说话。

还没拿到凭证时,工单里把这四件事说清楚,能少一轮来回:这台部署的用途(自用还是交付给客户)、要解锁哪些应用编码、期限形态(永久 / 订阅 / 版本买断,见计费形态与价格)、有没有公网域名要写进绑定域名字段(内网就明说留空)。多套环境各要一枚,因为它们是不同的部署。

激活

打开「应用市场 → 授权管理」

后台左侧「应用市场」下的授权管理。这台从没登记过授权时顶部显示「社区版」,右上按钮是激活授权;已经有凭证时按钮变成更换授权。

看不到这条菜单的账号(没被授予应用市场相关权限)不影响档位可见性,看档位用顶部导航那颗标记,见「在哪看当前档位」一节。

粘贴整段凭证

对话框里「授权凭证」粘整段文本,「备注」可以留一句只记在本机的话。备注不进凭证、不影响验签,留空时沿用上一次写的那句。

点「验签并激活」

本机用内置公钥重新验签、重新解析名单,验过才写记录。失败时报错的几种原文列在下面,旧凭证不会被静默替换成坏的那一枚。

激活覆盖 app_license 那一行,不插第二行;已安装的应用与数据不受影响。

装应用

名单生效后,「应用市场」里凭证覆盖到的应用可以按租户正常安装。跨档安装要连依赖一起装,见版本对比的依赖表。

做到什么现象算激活成功

  • 页面提示「授权已激活」,「当前档位」变成凭证里的档位,右上按钮变成更换授权。
  • 顶部导航那颗标记同步换掉(宿主在激活成功后会主动刷新各处档位状态;如果它停在你粘之前的结论上,刷新一次页面)。颜色随状态走:有效绿、宽限期黄、已过期或凭证无效红。
  • 「该授权解锁的应用」列出名单原文,条数与工单上写的对得上。
  • 装一个名单里的付费应用不再报「需要授权解锁」。反过来,装一个名单外的应用时日志出现「授权告警(未拦截,mode=warn)」,说明确实命中了闸门而默认没拦(app-market.license.mode 默认 warn)。
  • 「到期时间」与「签发时间」和凭证一致;永久授权那行显示「永久」。

凭证已经有效,应用却还看不见:三层归属

激活只解决「这台部署能不能装它」。从「能装」到「某个账号点得开」还有两层,症状很像授权没生效,做法完全不同:

这一层管什么判据在哪症状
能不能装 / 能不能加载本机凭证的 apps 名单 + app-market.license.mode报「需要授权解锁」;默认 warn 下这句只进日志、不拦
哪个租户装了它该租户的安装记录与启用状态名单里有它、市场里能搜到,但这个租户的左侧没有它的菜单。换租户看一次就知道了
谁能进这条菜单角色授权,以及后台准入 system:console:access应用装着、租户也装了,普通会员账号点进去被挡在后台门外

「按应用那一层」读的是本租户已启用的应用清单,所以上面第二层会直接影响应用里那条「许可证」页有没有内容,见查看某个应用的授权。第三层的口径见菜单范围与后台准入。

在哪看当前档位

位置谁看得见看到什么
顶部导航的档位标记任何登录用户档位名,点开是明细卡:状态、期限形态、到期时间与剩余天数、版本上限。数据走 GET /app/license/subscription,只要登录
会员中心 → 许可证装了 license 应用的部署凭证列表与明细、激活记录。这一屏由该应用渲染,没装它时顶部卡片底部那个入口也不会出现
应用市场 → 授权管理持有 app:license:query 的管理员完整字段:授权编号、绑定域名、解锁名单、本机备注,以及激活 / 更换 / 解除

档位标记摆在全局导航,理由是「我这台是什么版本」属于部署级事实,不该要求用户先找到一个菜单才知道;它对没被授予应用市场权限的角色同样要说出来。读这一条只需要登录,也是同一个理由。

授权管理页每个字段是什么意思

字段含义
当前档位凭证里的档位标签,只影响显示
状态社区版 / 有效 / 宽限期 / 已过期 / 版本超出 / 凭证无效
授权编号签发方给的对账编号,形如 WJ-PRO-XXXX-XXXX,展示与工单用
期限形态永久授权 / 订阅(带宽限天数)/ 版本买断
绑定域名凭证里写的域名;为空时页面显示「未绑定域名(内网部署按本机判断)」
到期时间永久授权显示「永久」;订阅显示日期与剩余 / 已到期天数
签发时间 / 本机激活时间前者来自凭证的 iat,后者是本机第一次成功激活的时刻,换凭证不会把它推到今天
版本上限凭证的 to;不填显示「不限」。当前只做展示,不参与判断
验签公钥本机有没有配置授权公钥。显示「未配置」时任何凭证都验不过
备注管理员在本机写的一句话,只进这台库、不受签名保护
该授权解锁的应用凭证 apps 名单原文;社区版这里是空的,内置功能照常使用

报错说什么,下一步做什么

报错原文(节选)原因怎么办
本机未配置授权验签公钥(app-market.license.public-key),无法验证凭证,请先配公钥这台部署没有信任锚让交付方把公钥填进配置或环境变量,然后重启宿主
这不是一枚授权凭证(应以 wjl1. 开头)粘的是兑换码、半截文本或别的东西重新取完整一段;确认没被换行截断。兑换码在客户部署上用不了,见下面「这些动作不会发生」最后一条
授权凭证无效:签名不匹配(内容被改动,或不是这把公钥签发的)内容被改过,或两边密钥不是一对按原文重取一次凭证再粘;仍不过就带着这句报错联系签发方,先确认对方有没有轮换过密钥而你这台还是旧公钥
授权凭证无效:不是合法格式的授权凭证(应以 wjl1. 开头)看着像凭证但分段或编码不对(少一段、含空格)从邮件或文件里整段复制,别手抄
激活成功,应用还是装不上名单里没有它,或者 mode: enforce 且这台没解锁对一下「该授权解锁的应用」与包内 licenseRequired;名单确实缺就找签发方补签

后几行不会被静默处理成「你还没买」:付了钱而东西没生效,页面必须把原因说出来。同一件事在闸门那一侧口径刻意相反(验不过就当名单为空,宁可少放行也不放行),见计费形态与价格的收回那一节。

这些动作不会发生

  • 解除授权不删数据。它只删本机那一行记录,已装的应用、它们的菜单与数据表一个都不动;重新粘一枚有效凭证,全部回来。
  • 换凭证不会换设备标识。app_license.device_id 在本机第一次激活时生成一个 UUID,之后一直复用,包括更换授权档位与重签。签发方那侧的「激活信息」按它认机器,每次激活新生成一个号会让同一台服务器在客户台账上变成 N 台新机器。配了 report-url 时每次成功激活都带着这个号回报一次,口径见许可证插件。
  • 手工改数据库不会多解锁任何东西。本机读取时按 credential 原文重新验签并重算名单,其它列只是投影。把 tier 改成 enterprise 只会让显示跑偏;改 credential 那一段则直接验签失败,判为凭证无效。
  • 换域名不影响已激活的凭证。dom 字段当前只用于展示与对账,激活与读取都不比对它;换域名、加子域名、从 HTTP 切到 HTTPS,都无需重新签发。
  • 判档不联网。验签用本机内置公钥,激活之后这台部署不需要能访问中心;只有从中心装应用时才要求目录可达。
  • 换一台部署要重新签发。新机器、新容器、新的一套库都属于新部署,联系平台方办理。整份迁库时那一行会跟着走,但别依赖这条路径。
  • 凭证丢了先在本机找。credential 列存的就是原文;本机库没了再找签发方按授权编号重发,凭证本身不落在文档、工单标题或日志里。
  • 在线兑换这条路在客户部署上不通。兑换端点在签发侧,默认被 app-market.license.issuer-enabled: false 挡着;本机后台只接受整段凭证。

下一步

目录