查看某个应用的授权
在后台哪个位置看单个应用解锁了没有,那条「许可证」菜单上的几句话怎么读,它没出现又是为什么。
顶部那颗标记回答的是「这台部署是什么档位」。你手上常常是另一个问题:这台装了七八个应用,这一个买没买、没买会不会哪天用不了。这一页是按应用看的那一层。
每个应用菜单里的「许可证」页,以及它背后那条 GET /app/license/required-apps,此刻只在开发线上,
还没进任何一个已发布的 tag。已发布的后台里能看到的是顶部导航的档位标记与「应用市场 → 授权管理」,
见激活与查看档位。
在哪看
进那个应用
左侧菜单点它,应用控制台的标题栏就是这个应用自己的名字。
点同一条菜单里的「许可证」
这条菜单由宿主注入在每个远程应用的根菜单下(store/modules/permission.ts 的 attachLicenseMenus),页面也住在宿主里。付费应用的仓库不用为此改一行、包也不用重打;这台部署没装 license 应用时,这一页照样打得开,不会出现「菜单是宿主给的、页面却是别人家的」那种悬空状态。
上半看这一个,下半看这台部署
上半是「本应用」的已解锁 / 未解锁,加上「授权编号尾号」;下半「这台部署的授权」给出档位、状态、期限形态、到期时间与剩余天数、版本上限。下半那份明细与顶部导航卡片共用同一个组件,两处不会各写一套。
页面上那几句话是什么意思
档位那句话由服务端拼好送出来(tierLabel),前端不做枚举到中文的映射,所以你看到的措辞和「应用市场 → 授权管理」页是同一套。
| 你看到的 | 它在说什么 |
|---|---|
| 「社区版」 | 这台没有登记凭证,任何需要授权的应用都在名单外 |
| 「专业版」/「企业版」 | 凭证的档位。旁边那行「已解锁 / 未解锁」才说明这个应用在不在名单里,档位字面上看不出来 |
| 「专业版(已过期)」 | 已过到期日并且超出宽限。到期之后怎么办见计费形态与价格 |
| 「未确认(本机未配置授权公钥)」 | 这台没有信任锚,任何凭证都验不过。先让交付方配公钥并重启宿主 |
| 「这个应用不需要授权凭证,社区版即可使用」 | 它的包没声明 licenseRequired,本来就不参与「解锁」这件事 |
| 「清单没取到:这台部署的后端还没有「需要授权的应用」这个出口,或这一次请求失败了」 | 这属于「不知道」。页面不给结论,也不会印成「没买」 |
「授权编号尾号」取凭证编号 lic 的最后四位,页面上那句话是「尾段够核对是不是自己那张单子,不够拿去对账」。完整编号、绑定域名、解锁名单在「应用市场 → 授权管理」,那一页要有 app:license:query 才看得见。
这台部署读不到清单,和这个应用没被解锁,在页面上必须是两种话术。把「不知道」印成「没买」,等于替客户把付费记录抹掉,
他下次来问的是一句系统亲口说过的话。闸门那一侧的口径相反且刻意:凭证为空、公钥没配、验不过、内容解析失败、超出宽限,
这五种失败一律算成空名单(LicensedApps.from),宁可少放行也不多放行。判据保守,话术保守,两边各自成立。
这份清单为什么由服务端给
单查只答「买没买」,答不出「要不要买」。一件本来免费的社区件和一件没解锁的付费件在页面上长得一模一样,于是每个应用都会被挂上一条「许可证」并说成「你没买」。GET /app/license/required-apps 按包内清单 licenseRequired 收窄,没列出来的就是不需要授权;它内部与装载那道闸是同一次计算(都取自 LicenseGuard.unlockedApps()),控制器和前端都不另算一遍。
判据来自包内 app.json 的 licenseRequired,此刻声明了它的有 9 个应用:member、pay、mall、finance、im、exam、enterprise、cms,加上「许可证」应用 license 自己。这个键在包签名的覆盖范围之内,改一个字节就验签失败。各档实际送哪些应用是商业决定,签在凭证的 apps 里,以版本对比和你「授权管理」页上列出的那一份为准。
这条端点还叠了第二个条件:只列本租户已启用的应用。装到某个租户、启停到某个租户,都不改变它要不要授权这件事。
「未解锁」不等于用不了
默认配置下闸门是 app-market.license.mode: warn:只把「这台没解锁这个应用」写进日志(前缀「授权告警(未拦截,mode=warn)」),照常放行。要让它真的拒绝安装和重新加载,得显式改成 enforce,改之前要先确认公钥已配,理由见计费形态与价格。
目录侧那一层不受 mode 影响:凭证覆盖不到的私有条目不下发给这台部署,包下载回 404。所以「页面上说未解锁、应用却装着能用」和「目录里根本找不到这个应用」是两件事。
这两页谁管什么
| 这一页(应用里的「许可证」) | 「应用市场 → 授权管理」 |
|---|---|
| 一个应用解锁了没有,附这台部署的期限明细 | 这台部署登记的那枚凭证的全部字段 |
任何登录用户都打得开(required-apps 与 subscription 都只要求登录) | 要有 app:license:query;激活 / 更换 / 解除要有 app:license:edit |
| 授权编号只给尾号四位 | 完整编号、绑定域名、解锁名单、本机备注 |
| 只读 | 唯一能改本机授权的地方 |
这页上不印凭证原文
页面上出现的只有档位、状态、到期时间、解锁了没有和编号尾号。凭证原文(那串 wjl1. 开头的文本)本身就是授权:谁拿到它,谁就能把那台部署的资格复制到另一台上。所以全仓给原文的出口只有一条,在签发侧的「下载许可证」那一条端点上,台账列表与详情都不带它。
这条口径也管住了后来人:不要在这页加「复制凭证」按钮,也不要在应用页的标签上挂状态。为应用页标签开过的单查端点 GET /app/license/status?appCode= 已经随标签一起删掉了,别再照旧文档去调;按应用读结论只有 required-apps 这一条批量出口。
这条菜单什么时候不出现
- 系统自带的菜单(系统管理、监控那些)没有它:注入只认远程应用的根菜单。
- 「许可证」应用自己也没有。在授权页上再问一遍「这页的授权是什么」没有意义。
- 隐藏的根菜单不注入。
其余每个装了页面的应用都会出现这一条,包括示例、图床、社交互动、报价四个社区件,它们的页面第一行写「这个应用不需要授权凭证,社区版即可使用」。反过来,如果你是从别处进来的(路由 meta.appCode 缺失),页面会显示「这一页没有归属应用:请从左侧应用菜单里的「许可证」进来」。
实现索引
| 位置 | 职责 |
|---|---|
AppLicenseController.requiredApps() | 一次算出哪些应用需要授权、各自解锁了没有;判据取自落位时存下的清单原文(app_version.manifest_json);只要登录,不加权限串 |
wujies-admin 的 store/modules/permission.ts | 给每个远程应用根菜单注入「许可证」子菜单与路由;三棵克隆树都要注入,且要赶在组件解析之前,否则菜单有、路由没有 |
wujies-admin 的 views/appstore/appLicense/index.vue | 每个应用的「许可证」页;下半那份明细与顶部卡片共用 AppLicenseDetail |
PlatformLicenseApi | 插件侧读同一份结论的契约,只有 status() 与 unlocked(appCode) 两个方法;一个能被卖的东西不该同时是拦它的锁 |