外观
产品授权
ATKONOFFICE 是需要授权(license)的商业产品。授权决策与固化全在服务端完成,集成对接不受阻——未授权也能先跑通集成,只是文档字节被拒发。
两种激活方式
| 方式 | 做法 | 适用 |
|---|---|---|
| 预置 | 把授权码填进 atkonoffice.license.preset-code,后端启动即固化 | 自动化部署 |
| 端点激活 | 终端用户在客户端激活框输入授权码 → POST /atkonoffice/license/activate → 固化 license 文件并立即放行 | 交互式激活 |
机器码与状态查询
GET /atkonoffice/license/fingerprint 返回本机机器码(用于向供应商换取授权码)与当前授权状态。
授权闸门作用在字节缝
未授权时:
- 下载与保存的文档字节被拒发——
AtkonofficeFileSaver.getFileBytes()抛异常、下载端点返回 403; - 而 host-page 照常生成,客户端据此弹激活框引导激活。
这意味着可以先完成全部集成对接(挂路由、接存储、调通前端),把激活留到最后一步,不会因未授权卡住联调。
相关配置
| 属性 | 默认 | 说明 |
|---|---|---|
atkonoffice.license.path | atkonoffice-license.lic | 激活后固化 license 文件的路径(相对路径解析到运行 jar 所在目录)。 |
atkonoffice.license.preset-code | (空) | 管理员预置授权码。 |
授权校验属产品保护机制,其内部(密钥、机器码算法、license 格式)不对外开放,也不可通过配置覆盖。集成方能感知的只有上述激活方式、查询端点与「未授权拒发字节」的行为。