源码地址: https://github.com/sixj0/license

解决的问题:

将项目卖给其他公司,需要将jar包在客户的服务器上部署,为了避免客户将项目jar包进行二次售卖,或者我们需要控制项目的使用期限,比如控制项目只能运行一年,这个是时候,需要使用License认证,生成一个License证书,该证书中包含客户服务器信息(IP地址、MAC地址、CPU序列号、主板序列号),同时可以设置生效时间与失效时间,控制项目到期之后项目不可用。

license授权机制的原理

(1)生成密钥对,包含私钥和公钥。

(2)授权者保留私钥,使用私钥对授权信息诸如使用截止日期,mac 地址等内容生成 license 签名证书。

(3)公钥给使用者,放在代码中使用,用于验证 license 签名证书是否符合使用条件。

使用KeyTool生成密匙库:

  1. 生成私钥库

    keytool-genkeypair-keysize1024-validity3650-aliasSYSHLANG-keystoreprivateKeys.keystore-storepass12345678A-keypass12345678A-dname"CN=sixj,OU=runlion,O=redlion,L=HZ,ST=ZJ,C=CN"

参数说明:

  • keysize 密钥长度

  • validity 私钥的有效期(单位:天)

  • alias 私钥别称

  • keystore 指定私钥库文件的名称 (生成在当前目录)

  • storepass 指定私钥库的密码 (keystore 文件存储密码)

  • keypass 指定别名条目的密码 (私钥加解密密码)

  • dname 证书个人信息

  • CN 为你的姓名

  • OU 为你的组织单位名称

  • O 为你的组织名称

  • L 为你所在的城市名称

  • ST 为你所在的省份名称

  • C 为你的国家名称

  1. 生成证书文件

    keytool-exportcert-aliasSYSHLANG-keystoreprivateKeys.keystore-storepass12345678A-filecertfile.cer

参数说明:

  • alias 私钥别称

  • keystore 指定私钥库文件的名称 (如果没有带路径,在当前目录查找)

  • storepass 指定私钥库的密码

  • file 导出证书文件名称

  1. 生成公钥库

    keytool-import-aliasSYSHLANG-filecertfile.cer-keystorepublicCerts.keystore-storepass12345678A

参数说明:

  • alias 公钥别称

  • file 证书文件名称

  • keystore 公钥文件名称

  • storepass 指定私钥库的密码

看到以下三个文件:

  • privateKeys.keystore(私钥)提供给生成证书使用

  • publicCerts. keystore(公钥)提供给证书认证使用

  • certfile.cer后续步骤用不到,可以删除。

License证书:

根据客户服务器硬件信息(MAC地址、IP地址、CPU序列号、主板序列号)生成授权证书,同时可以给授权证书设置生效时间与失效时间。

整个授权过程分为三步:

  1. 获取客户端服务器信息(license-server-info服务)

将license-server-info服务部署到客户服务器上

请求接口/license/getServerInfo

得到硬件信息:

{"ipAddress":[//授权的ip列表"172.17.0.8"],"macAddress":[//授权的mac地址列表"52-54-00-74-0B-D9"],"cpuSerial":"55060500FFFB8B0F",//cpu序列号"mainBoardSerial":"afb14aac-eccb-4a37-9c31-e7951ce73e0d"//主板序列号}
  1. 生成授权证书(license-creator服务)

我们自己部署生成证书的服务(license-creator)

请求接口/license/generateLicense

传入授权信息:

{"expiryTime":"2021-05-2519:07:59",//生效时间"issuedTime":"2021-04-2519:07:00",//失效时间"keyPass":"12345678A",//密钥的密码"privateAlias":"SYSHLANG","licensePath":"/Users/sixj/Desktop/license/license.lic",//证书生成地址"privateKeysStorePath":"/Users/sixj/Desktop/license/privateKeys.keystore",//密钥文件地址"storePass":"12345678A",//密钥库的密码"subject":"pushi-kn-graph","licenseCheckModel":{//授权验证信息"cpuSerial":"47A8E193-23D4-5B93-92AB-4A96FBC0346F",//cpu序列号"ipAddress":[//ip"192.168.174.107"],"macAddress":[//mac地址"F8-FF-C2-6A-3E-73"],"mainBoardSerial":"C02C31HZMD6P"//主板序列号}}

会生成一个license.lic授权文件到执行目录

  1. 授权验证(license-verify-starter)

需要添加授权功能的服务需要依赖license-verify-starter

配置证书信息

license.subject:pushi-kn-graphlicense.publicAlias:SYSHLANGlicense.storePass:12345678Alicense.licensePath:/Users/sixj/Desktop/license/license.liclicense.publicKeysStorePath:/Users/sixj/Desktop/license/publicCerts.keystore

项目启动的时候,会去验证授权证书的有效性,是否在有效期内,硬件信息是否匹配,如果授权证书无效,项目启动失败。

另外可以在一些核心接口,比如登陆接口,添加@License注解,请求该接口的时候,也会去验证授权证书的有效性,比如验证证书是否到期,如果失效,该接口将会拒绝访问。