Skip to content

产品授权

ATKONOFFICE 是需要授权(license)的商业产品。授权决策与固化全在服务端完成,集成对接不受阻——未授权也能先跑通集成,只是文档字节被拒发。

两种激活方式

方式做法适用
预置把授权码填进 atkonoffice.license.preset-code,后端启动即固化自动化部署
端点激活终端用户在客户端激活框输入授权码 → POST /atkonoffice/license/activate → 固化 license 文件并立即放行交互式激活

机器码与状态查询

GET /atkonoffice/license/fingerprint 返回本机机器码(用于向供应商换取授权码)与当前授权状态

授权闸门作用在字节缝

未授权时:

  • 下载与保存的文档字节被拒发——AtkonofficeFileSaver.getFileBytes() 抛异常、下载端点返回 403;
  • 而 host-page 照常生成,客户端据此弹激活框引导激活。

这意味着可以先完成全部集成对接(挂路由、接存储、调通前端),把激活留到最后一步,不会因未授权卡住联调。

相关配置

属性默认说明
atkonoffice.license.pathatkonoffice-license.lic激活后固化 license 文件的路径(相对路径解析到运行 jar 所在目录)。
atkonoffice.license.preset-code(空)管理员预置授权码。

授权校验属产品保护机制,其内部(密钥、机器码算法、license 格式)不对外开放,也不可通过配置覆盖。集成方能感知的只有上述激活方式、查询端点与「未授权拒发字节」的行为。

面向集成方的产品技术文档 · 不含实现细节