激活与查看档位
在本机后台粘贴凭证激活授权、确认解锁真的生效,以及换机器与改数据库时的边界。
凭证已经到手,这一页处理怎么让它在这台部署上生效。凭证怎么产生、期限形态与价格见计费形态与价格;签发那一侧(私钥、签发端点、兑换码)见许可证插件。
激活之前先确认三件事
- 这台部署配了验签公钥,并且与签发方的私钥是同一对。键是
app-market.license.public-key,容器与面板部署通常用环境变量WUJIES_LICENSE_PUBLIC_KEY注入。配置由LicenseProperties在启动期绑定,改了公钥要重启宿主。 - 你的账号持有
app:license:edit。激活与解除都要它;只有app:license:query的账号能打开授权管理页,但按钮不会出现。 - 手上是完整一段以
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挡着;本机后台只接受整段凭证。