1、首先需要生成密钥对,常用的方法为JDK自带的KeyTool工具生成;

2、创建licenseServer项目,使用TrueLicense和私钥生成License许可文件,注意服务端代码和私钥需要我们自己留存;

3、使用公钥和License许可文件为客户端代码添加License校验

KeyTool生成密钥对

密钥对命令

cmd.exe下运行下列命令

keytool -genkeypair -keysize 1024 -validity 3650 -alias "privateKey" -keystore "privateKeys.keystore" -storepass "public_password1234" -keypass "private_password1234" -dname "CN=localhost, OU=localhost, O=localhost, L=SH, ST=SH, C=CN"
 
# 导出命令
keytool -exportcert -alias "privateKey" -keystore "privateKeys.keystore" -storepass "public_password1234" -file "certfile.cer"
 
#导入命令
keytool -import -alias "publicCert" -file "certfile.cer" -keystore "publicCerts.keystore" -storepass "public_password1234"

命令执行完之后,会生成三个文件:privateKeys.keystore,publicCerts.keystore,certfile.cer

其中certfile.cer是暂存文件,删除即可; 

privateKeys.keystore:用于服务端生成license文件

publicCerts.key

参数释义

参数释义
alias别名
validity证书有效期,单位:天
keystore指定密钥库名称
storepass指定密钥库密码
keypass指定别名对应密码(私钥密码)

服务端生成license文件

引用依赖

创建一个SpringBoot项目,maven引用truelicense的依赖

<dependency>
    <groupId>de.schlichtherle.truelicense</groupId>
    <artifactId>truelicense-core</artifactId>
    <version>1.33</version>
</dependency>

配置文件

server:
  port: 8080
 
license:
  licensePath: E:/LicenseDemo/license.lic

生成license证书代码

获取客户服务器的基本信息,如:IP、Mac地址、CPU序列号、主板序列号等

public abstract class AbstractServerInfos {
 
    private static Logger logger = LogManager.getLogger(AbstractServerInfos.class);
 
    /**
     * 组装需要额外校验的License参数
     * @return entity.vo.LicenseCheckModel
     */
    public LicenseCheckModel getServerInfos(){
        LicenseCheckModel result = new LicenseCheckModel();
 
        try {
            result.setIpAddress(this.getIpAddress());
            result.setMacAddress(this.getMacAddress());
            result.setCpuSerial(this.getCPUSerial());
            result.setMainBoardSerial(this.getMainBoardSerial());
        }catch (Exception e){
            logger.error("获取服务器硬件信息失败",e);
        }
 
        return result;
    }
 
    /**
     * 获取IP地址
     * @return java.util.List<java.lang.String>
     */
    protected abstract List<String> getIpAddress() throws Exception;
 
    /**
     * 获取Mac地址
     * @return java.util.List<java.lang.String>
     */
    protected abstract List<String> getMacAddress() throws Exception;
 
    /**
     * 获取CPU序列号
     * @return java.lang.String
     */
    protected abstract String getCPUSerial() throws Exception;
 
    /**
     * 获取主板序列号
     * @return java.lang.String
     */
    protected abstract String getMainBoardSerial() throws Exception;
 
    /**
     * 获取当前服务器所有符合条件的InetAddress
     * @return java.util.List<java.net.InetAddress>
     */
    protected List<InetAddress> getLocalAllInetAddress() throws Exception {
        List<InetAddress> result = new ArrayList<>(4);
 
        // 遍历所有的网络接口
        for (Enumeration networkInterfaces = NetworkInterface.getNetworkInterfaces(); networkInterfaces.hasMoreElements(); ) {
            NetworkInterface iface = (NetworkInterface) networkInterfaces.nextElement();
            // 在所有的接口下再遍历IP
            for (Enumeration inetAddresses = iface.getInetAddresses(); inetAddresses.hasMoreElements(); ) {
                InetAddress inetAddr = (InetAddress) inetAddresses.nextElement();
 
                //排除LoopbackAddress、SiteLocalAddress、LinkLocalAddress、MulticastAddress类型的IP地址
                if(!inetAddr.isLoopbackAddress() /*&& !inetAddr.isSiteLocalAddress()*/
                        && !inetAddr.isLinkLocalAddress() && !inetAddr.isMulticastAddress()){
                    result.add(inetAddr);
                }
            }
        }
 
        return result;
    }
 
    /**
     * 获取某个网络接口的Mac地址
     * @return void
     */
    protected String getMacByInetAddress(InetAddress inetAddr){
        try {
            byte[] mac = NetworkInterface.getByInetAddress(inetAddr).getHardwareAddress();
            StringBuffer stringBuffer = new StringBuffer();
 
            for(int i=0;i<mac.length;i++){
                if(i != 0) {
                    stringBuffer.append("-");
                }
 
                //将十六进制byte转化为字符串
                String temp = Integer.toHexString(mac[i] & 0xff);
                if(temp.length() == 1){
                    stringBuffer.append("0" + temp);
                }else{
                    stringBuffer.append(temp);
                }
            }
 
            return stringBuffer.toString().toUpperCase();
        } catch (SocketException e) {
            e.printStackTrace();
        }
 
        return null;
    }
}

获取客户Linux服务器的基本信息

public class LinuxServerInfos extends AbstractServerInfos{
 
    @Override
    protected List<String> getIpAddress() throws Exception {
        List<String> result = null;
 
        //获取所有网络接口
        List<InetAddress> inetAddresses = getLocalAllInetAddress();
 
        if(inetAddresses != null && inetAddresses.size() > 0){
            result = inetAddresses.stream().map(InetAddress::getHostAddress).distinct().map(String::toLowerCase).collect(Collectors.toList());
        }
 
        return result;
    }
 
    @Override
    protected List<String> getMacAddress() throws Exception {
        List<String> result = null;
 
        //1. 获取所有网络接口
        List<InetAddress> inetAddresses = getLocalAllInetAddress();
 
        if(inetAddresses != null && inetAddresses.size() > 0){
            //2. 获取所有网络接口的Mac地址
            result = inetAddresses.stream().map(this::getMacByInetAddress).distinct().collect(Collectors.toList());
        }
 
        return result;
    }
 
    @Override
    protected String getCPUSerial() throws Exception {
        //序列号
        String serialNumber = "";
 
        //使用dmidecode命令获取CPU序列号
        String[] shell = {"/bin/bash","-c","dmidecode -t processor | grep 'ID' | awk -F ':' '{print $2}' | head -n 1"};
        Process process = Runtime.getRuntime().exec(shell);
        process.getOutputStream().close();
 
        BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()));
 
        String line = reader.readLine().trim();
        if(StringUtils.isNotBlank(line)){
            serialNumber = line;
        }
 
        reader.close();
        return serialNumber;
    }
 
    @Override
    protected String getMainBoardSerial() throws Exception {
        //序列号
        String serialNumber = "";
 
        //使用dmidecode命令获取主板序列号
        String[] shell = {"/bin/bash","-c","dmidecode | grep 'Serial Number' | awk -F ':' '{print $2}' | head -n 1"};
        Process process = Runtime.getRuntime().exec(shell);
        process.getOutputStream().close();
 
        BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()));
 
        String line = reader.readLine().trim();
        if(StringUtils.isNotBlank(line)){
            serialNumber = line;
        }
 
        reader.close();
        return serialNumber;
    }
}

获取客户Windows服务器的基本信息

public class WindowsServerInfos extends AbstractServerInfos{
 
    @Override
    protected List<String> getIpAddress() throws Exception {
        List<String> result = null;
 
        //获取所有网络接口
        List<InetAddress> inetAddresses = getLocalAllInetAddress();
 
        if(inetAddresses != null && inetAddresses.size() > 0){
            result = inetAddresses.stream().map(InetAddress::getHostAddress).distinct().map(String::toLowerCase).collect(Collectors.toList());
        }
 
        return result;
    }
 
    @Override
    protected List<String> getMacAddress() throws Exception {
        List<String> result = null;
 
        //1. 获取所有网络接口
        List<InetAddress> inetAddresses = getLocalAllInetAddress();
 
        if(inetAddresses != null && inetAddresses.size() > 0){
            //2. 获取所有网络接口的Mac地址
            result = inetAddresses.stream().map(this::getMacByInetAddress).distinct().collect(Collectors.toList());
        }
 
        return result;
    }
 
    @Override
    protected String getCPUSerial() throws Exception {
        //序列号
        String serialNumber = "";
 
        //使用WMIC获取CPU序列号
        Process process = Runtime.getRuntime().exec("wmic cpu get processorid");
        process.getOutputStream().close();
        Scanner scanner = new Scanner(process.getInputStream());
 
        if(scanner.hasNext()){
            scanner.next();
        }
 
        if(scanner.hasNext()){
            serialNumber = scanner.next().trim();
        }
 
        scanner.close();
        return serialNumber;
    }
 
    @Override
    protected String getMainBoardSerial() throws Exception {
        //序列号
        String serialNumber = "";
 
        //使用WMIC获取主板序列号
        Process process = Runtime.getRuntime().exec("wmic baseboard get serialnumber");
        process.getOutputStream().close();
        Scanner scanner = new Scanner(process.getInputStream());
 
        if(scanner.hasNext()){
            scanner.next();
        }
 
        if(scanner.hasNext()){
            serialNumber = scanner.next().trim();
        }
 
        scanner.close();
        return serialNumber;
    }
}

添加一个自定义的可被允许的服务器硬件信息的实体类(如果校验其他参数,可自行补充)

@Data
public class LicenseCheckModel implements Serializable {
 
 
    private static final long serialVersionUID = -2314678441082223148L;
    /**
     * 可被允许的IP地址
     */
    private List<String> ipAddress;
 
    /**
     * 可被允许的MAC地址
     */
    private List<String> macAddress;
 
    /**
     * 可被允许的CPU序列号
     */
    private String cpuSerial;
 
    /**
     * 可被允许的主板序列号
     */
    private String mainBoardSerial;
}

添加一个License生成需要的参数的实体类

@Data
public class LicenseCreatorParam implements Serializable {
 
    private static final long serialVersionUID = 2832129012982731724L;
    /**
     * 证书subject
     */
    private String subject;
 
    /**
     * 密钥别称
     */
    private String privateAlias;
 
    /**
     * 密钥密码(需要妥善保管,不能让使用者知道)
     */
    private String keyPass;
 
    /**
     * 访问秘钥库的密码
     */
    private String storePass;
 
    /**
     * 证书生成路径
     */
    private String licensePath;
 
    /**
     * 密钥库存储路径
     */
    private String privateKeysStorePath;
 
    /**
     * 证书生效时间
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date issuedTime = new Date();
 
    /**
     * 证书失效时间
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date expiryTime;
 
    /**
     * 用户类型
     */
    private String consumerType = "user";
 
    /**
     * 用户数量
     */
    private Integer consumerAmount = 1;
 
    /**
     * 描述信息
     */
    private String description = "";
 
    /**
     * 额外的服务器硬件校验信息
     */
    private LicenseCheckModel licenseCheckModel;
}

自定义LicenseManager,用于增加额外的服务器硬件信息校验

public class CustomLicenseManager extends LicenseManager {
 
    private static Logger logger = LogManager.getLogger(CustomLicenseManager.class);
 
    //XML编码
    private static final String XML_CHARSET = "UTF-8";
    //默认BUFSIZE
    private static final int DEFAULT_BUFSIZE = 8 * 1024;
 
    public CustomLicenseManager() {
 
    }
 
    public CustomLicenseManager(LicenseParam param) {
        super(param);
    }
 
    /**
     * 复写create方法
     * @param
     * @return byte[]
     */
    @Override
    protected synchronized byte[] create(
            LicenseContent content,
            LicenseNotary notary)
            throws Exception {
        initialize(content);
        this.validateCreate(content);
        final GenericCertificate certificate = notary.sign(content);
        return getPrivacyGuard().cert2key(certificate);
    }
 
    /**
     * 复写install方法,其中validate方法调用本类中的validate方法,校验IP地址、Mac地址等其他信息
     * @param
     * @return de.schlichtherle.license.LicenseContent
     */
    @Override
    protected synchronized LicenseContent install(
            final byte[] key,
            final LicenseNotary notary)
            throws Exception {
        final GenericCertificate certificate = getPrivacyGuard().key2cert(key);
 
        notary.verify(certificate);
        final LicenseContent content = (LicenseContent)this.load(certificate.getEncoded());
        this.validate(content);
        setLicenseKey(key);
        setCertificate(certificate);
 
        return content;
    }
 
    /**
     * 复写verify方法,调用本类中的validate方法,校验IP地址、Mac地址等其他信息
     * @param
     * @return de.schlichtherle.license.LicenseContent
     */
    @Override
    protected synchronized LicenseContent verify(final LicenseNotary notary)
            throws Exception {
        GenericCertificate certificate = getCertificate();
 
        // Load license key from preferences,
        final byte[] key = getLicenseKey();
        if (null == key){
            throw new NoLicenseInstalledException(getLicenseParam().getSubject());
        }
 
        certificate = getPrivacyGuard().key2cert(key);
        notary.verify(certificate);
        final LicenseContent content = (LicenseContent)this.load(certificate.getEncoded());
        this.validate(content);
        setCertificate(certificate);
 
        return content;
    }
 
    /**
     * 校验生成证书的参数信息
     * @param content 证书正文
     */
    protected synchronized void validateCreate(final LicenseContent content)
            throws LicenseContentException {
        final LicenseParam param = getLicenseParam();
 
        final Date now = new Date();
        final Date notBefore = content.getNotBefore();
        final Date notAfter = content.getNotAfter();
        if (null != notAfter && now.after(notAfter)){
            throw new LicenseContentException("证书失效时间不能早于当前时间");
        }
        if (null != notBefore && null != notAfter && notAfter.before(notBefore)){
            throw new LicenseContentException("证书生效时间不能晚于证书失效时间");
        }
        final String consumerType = content.getConsumerType();
        if (null == consumerType){
            throw new LicenseContentException("用户类型不能为空");
        }
    }
 
 
    /**
     * 复写validate方法,增加IP地址、Mac地址等其他信息校验
     * @param content LicenseContent
     */
    @Override
    protected synchronized void validate(final LicenseContent content)
            throws LicenseContentException {
        //1. 首先调用父类的validate方法
        super.validate(content);
 
        //2. 然后校验自定义的License参数
        //License中可被允许的参数信息
        LicenseCheckModel expectedCheckModel = (LicenseCheckModel) content.getExtra();
        //当前服务器真实的参数信息
        LicenseCheckModel serverCheckModel = getServerInfos();
 
        if(expectedCheckModel != null && serverCheckModel != null){
            //校验IP地址
            if(!checkIpAddress(expectedCheckModel.getIpAddress(),serverCheckModel.getIpAddress())){
                throw new LicenseContentException("当前服务器的IP没在授权范围内");
            }
 
            //校验Mac地址
            if(!checkIpAddress(expectedCheckModel.getMacAddress(),serverCheckModel.getMacAddress())){
                throw new LicenseContentException("当前服务器的Mac地址没在授权范围内");
            }
 
            //校验主板序列号
            if(!checkSerial(expectedCheckModel.getMainBoardSerial(),serverCheckModel.getMainBoardSerial())){
                throw new LicenseContentException("当前服务器的主板序列号没在授权范围内");
            }
 
            //校验CPU序列号
            if(!checkSerial(expectedCheckModel.getCpuSerial(),serverCheckModel.getCpuSerial())){
                throw new LicenseContentException("当前服务器的CPU序列号没在授权范围内");
            }
        }else{
            throw new LicenseContentException("不能获取服务器硬件信息");
        }
    }
 
 
    /**
     * 重写XMLDecoder解析XML
     * @param encoded XML类型字符串
     * @return java.lang.Object
     */
    private Object load(String encoded){
        BufferedInputStream inputStream = null;
        XMLDecoder decoder = null;
        try {
            inputStream = new BufferedInputStream(new ByteArrayInputStream(encoded.getBytes(XML_CHARSET)));
 
            decoder = new XMLDecoder(new BufferedInputStream(inputStream, DEFAULT_BUFSIZE),null,null);
 
            return decoder.readObject();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        } finally {
            try {
                if(decoder != null){
                    decoder.close();
                }
                if(inputStream != null){
                    inputStream.close();
                }
            } catch (Exception e) {
                logger.error("XMLDecoder解析XML失败",e);
            }
        }
 
        return null;
    }
 
    /**
     * 获取当前服务器需要额外校验的License参数
     * @return demo.LicenseCheckModel
     */
    private LicenseCheckModel getServerInfos(){
        //操作系统类型
        String osName = System.getProperty("os.name").toLowerCase();
        AbstractServerInfos abstractServerInfos = null;
 
        //根据不同操作系统类型选择不同的数据获取方法
        if (osName.startsWith("windows")) {
            abstractServerInfos = new WindowsServerInfos();
        } else if (osName.startsWith("linux")) {
            abstractServerInfos = new LinuxServerInfos();
        }else{//其他服务器类型
            abstractServerInfos = new LinuxServerInfos();
        }
 
        return abstractServerInfos.getServerInfos();
    }
 
    /**
     * 校验当前服务器的IP/Mac地址是否在可被允许的IP范围内<br/>
     * 如果存在IP在可被允许的IP/Mac地址范围内,则返回true
     * @return boolean
     */
    private boolean checkIpAddress(List<String> expectedList, List<String> serverList){
        if(expectedList != null && expectedList.size() > 0){
            if(serverList != null && serverList.size() > 0){
                for(String expected : expectedList){
                    if(serverList.contains(expected.trim())){
                        return true;
                    }
                }
            }
 
            return false;
        }else {
            return true;
        }
    }
 
    /**
     * 校验当前服务器硬件(主板、CPU等)序列号是否在可允许范围内
     * @return boolean
     */
    private boolean checkSerial(String expectedSerial,String serverSerial){
        if(StringUtils.isNotBlank(expectedSerial)){
            if(StringUtils.isNotBlank(serverSerial)){
                if(expectedSerial.equals(serverSerial)){
                    return true;
                }
            }
 
            return false;
        }else{
            return true;
        }
    }
}

自定义KeyStoreParam,用于将公私钥存储文件存放到其他磁盘位置而不是项目中

public class CustomKeyStoreParam extends AbstractKeyStoreParam {
 
    /**
     * 公钥/私钥在磁盘上的存储路径
     */
    private String storePath;
    private String alias;
    private String storePwd;
    private String keyPwd;
 
    public CustomKeyStoreParam(Class clazz, String resource,String alias,String storePwd,String keyPwd) {
        super(clazz, resource);
        this.storePath = resource;
        this.alias = alias;
        this.storePwd = storePwd;
        this.keyPwd = keyPwd;
    }
 
 
    @Override
    public String getAlias() {
        return alias;
    }
 
    @Override
    public String getStorePwd() {
        return storePwd;
    }
 
    @Override
    public String getKeyPwd() {
        return keyPwd;
    }
 
    /**
     * 复写de.schlichtherle.license.AbstractKeyStoreParam的getStream()方法<br/>
     * 用于将公私钥存储文件存放到其他磁盘位置而不是项目中
     * @param
     * @return java.io.InputStream
     */
    @Override
    public InputStream getStream() throws IOException {
        final InputStream in = new FileInputStream(new File(storePath));
        if (null == in){
            throw new FileNotFoundException(storePath);
        }
 
        return in;
    }
}

最后是license的生成类,用于生成license证书

public class LicenseCreator {
 
    private static Logger logger = LogManager.getLogger(LicenseCreator.class);
    private final static X500Principal DEFAULT_HOLDER_AND_ISSUER = new X500Principal("CN=localhost, OU=localhost, O=localhost, L=SH, ST=SH, C=CN");
    private LicenseCreatorParam param;
 
    public LicenseCreator(LicenseCreatorParam param) {
        this.param = param;
    }
 
    /**
     * 生成License证书
     * @return boolean
     */
    public boolean generateLicense(){
        try {
            LicenseManager licenseManager = new CustomLicenseManager(initLicenseParam());
            LicenseContent licenseContent = initLicenseContent();
 
            licenseManager.store(licenseContent,new File(param.getLicensePath()));
 
            return true;
        }catch (Exception e){
            logger.error(MessageFormat.format("证书生成失败:{0}",param),e);
            return false;
        }
    }
 
    /**
     * 初始化证书生成参数
     * @return de.schlichtherle.license.LicenseParam
     */
    private LicenseParam initLicenseParam(){
        Preferences preferences = Preferences.userNodeForPackage(LicenseCreator.class);
 
        //设置对证书内容加密的秘钥
        CipherParam cipherParam = new DefaultCipherParam(param.getStorePass());
 
        KeyStoreParam privateStoreParam = new CustomKeyStoreParam(LicenseCreator.class
                ,param.getPrivateKeysStorePath()
                ,param.getPrivateAlias()
                ,param.getStorePass()
                ,param.getKeyPass());
 
        LicenseParam licenseParam = new DefaultLicenseParam(param.getSubject()
                ,preferences
                ,privateStoreParam
                ,cipherParam);
 
        return licenseParam;
    }
 
    /**
     * 设置证书生成正文信息
     * @return de.schlichtherle.license.LicenseContent
     */
    private LicenseContent initLicenseContent(){
        LicenseContent licenseContent = new LicenseContent();
        licenseContent.setHolder(DEFAULT_HOLDER_AND_ISSUER);
        licenseContent.setIssuer(DEFAULT_HOLDER_AND_ISSUER);
 
        licenseContent.setSubject(param.getSubject());
        licenseContent.setIssued(param.getIssuedTime());
        licenseContent.setNotBefore(param.getIssuedTime());
        licenseContent.setNotAfter(param.getExpiryTime());
        licenseContent.setConsumerType(param.getConsumerType());
        licenseContent.setConsumerAmount(param.getConsumerAmount());
        licenseContent.setInfo(param.getDescription());
 
        //扩展校验服务器硬件信息
        licenseContent.setExtra(param.getLicenseCheckModel());
 
        return licenseContent;
    }
}

添加一个生成证书的Controller,对外提供了两个RESTful接口,分别是「获取服务器硬件信息」和「生成证书」

@RestController
@RequestMapping("/license")
public class LicenseCreatorController {
 
    /**
     * 证书生成路径
     */
    @Value("${license.licensePath}")
    private String licensePath;
 
    /**
     * 获取服务器硬件信息
     * @param osName 操作系统类型,如果为空则自动判断
     * @return com.ccx.models.license.LicenseCheckModel
     */
    @RequestMapping(value = "/getServerInfos",produces = {MediaType.APPLICATION_JSON_UTF8_VALUE})
    public LicenseCheckModel getServerInfos(@RequestParam(value = "osName",required = false) String osName) {
        //操作系统类型
        if(StringUtils.isBlank(osName)){
            osName = System.getProperty("os.name");
        }
        osName = osName.toLowerCase();
 
        AbstractServerInfos abstractServerInfos = null;
 
        //根据不同操作系统类型选择不同的数据获取方法
        if (osName.startsWith("windows")) {
            abstractServerInfos = new WindowsServerInfos();
        } else if (osName.startsWith("linux")) {
            abstractServerInfos = new LinuxServerInfos();
        }else{//其他服务器类型
            abstractServerInfos = new LinuxServerInfos();
        }
 
        return abstractServerInfos.getServerInfos();
    }
 
    /**
     * 生成证书
     * @param param 生成证书需要的参数
     * @return java.util.Map<java.lang.String,java.lang.Object>
     */
    @RequestMapping(value = "/generateLicense",produces = {MediaType.APPLICATION_JSON_UTF8_VALUE})
    public Map<String,Object> generateLicense(@RequestBody(required = true) LicenseCreatorParam param) {
        Map<String,Object> resultMap = new HashMap<>(2);
 
        if(StringUtils.isBlank(param.getLicensePath())){
            param.setLicensePath(licensePath);
        }
 
        LicenseCreator licenseCreator = new LicenseCreator(param);
        boolean result = licenseCreator.generateLicense();
 
        if(result){
            resultMap.put("result","ok");
            resultMap.put("msg",param);
        }else{
            resultMap.put("result","error");
            resultMap.put("msg","证书文件生成失败!");
        }
 
        return resultMap;
    }
}

获取服务器硬件信息:

 生成证书:

示例参数如下所示:

{
	"subject": "license_demo",
	"privateAlias": "privateKey",
	"keyPass": "private_password1234",
	"storePass": "public_password1234",
	"licensePath": "E:/LicenseDemo/license.lic",
	"privateKeysStorePath": "E:/LicenseDemo/privateKeys.keystore",
	"issuedTime": "2022-04-26 14:48:12",
	"expiryTime": "2022-08-22 00:00:00",
	"consumerType": "User",
	"consumerAmount": 1,
	"description": "这是证书描述信息",
	"licenseCheckModel": {
		"ipAddress": [
			"192.168.3.57"
		],
		"macAddress": [
			"D8-F2-CA-06-1A-F3"
		],
		"cpuSerial": "BFEBFBFF000806EA",
		"mainBoardSerial": "PM01I01911000743"
	}
}

运行完生成证书接口后即可在 E:/LicenseDemo/目录下看到【license.lic】证书:

 


客户端代码实现认证
这里使用我本地已有项目的客户端代码,不再单独写个demo了,总体思路是:

首先将服务端生成的【license.lic】证书文件与keytool生成的公钥【publicCerts.keystore】放到客户端代码指定的路径下;

然后在启动客户端代码的时候安装证书;

最后再拦截需要验证证书的接口的拦截器里添加License校验,我这里的需求是所有访问的接口都要拦截。

引用依赖
maven引用truelicense的依赖
 

<dependency>
    <groupId>de.schlichtherle.truelicense</groupId>
    <artifactId>truelicense-core</artifactId>
    <version>1.33</version>
</dependency>

 配置文件

客户端代码的配置文件中需要加上如下配置:

#License相关配置
license.subject=license_demo
license.publicAlias=publicCert
license.storePass=public_password1234
license.licensePath=E:/LicenseDemo/license.lic
license.publicKeysStorePath=E:/LicenseDemo/publicCerts.keystore
license.uploadPath=E:/LicenseDemo/

License校验类需要的参数类

@Data
public class LicenseVerifyParam {
 
    /**
     * 证书subject
     */
    private String subject;
 
    /**
     * 公钥别称
     */
    private String publicAlias;
 
    /**
     * 访问公钥库的密码
     */
    private String storePass;
 
    /**
     * 证书生成路径
     */
    private String licensePath;
 
    /**
     * 密钥库存储路径
     */
    private String publicKeysStorePath;
}

创建de.schlichtherle.license.LicenseManager类的单例

public class LicenseManagerHolder {
 
    private static volatile LicenseManager LICENSE_MANAGER;
 
    public static LicenseManager getInstance(LicenseParam param){
        if(LICENSE_MANAGER == null){
            synchronized (LicenseManagerHolder.class){
                if(LICENSE_MANAGER == null){
                    LICENSE_MANAGER = new CustomLicenseManager(param);
                }
            }
        }
 
        return LICENSE_MANAGER;
    }
}

License校验类,安装/校验证书:

public class LicenseVerify {
 
    private static final Logger logger = LoggerFactory.getLogger(LicenseVerify.class);
 
    /**
     * 安装License证书
     */
    public synchronized LicenseContent install(LicenseVerifyParam param){
        LicenseContent result = null;
        DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
 
        //1. 安装证书
        try{
            LicenseManager licenseManager = LicenseManagerHolder.getInstance(initLicenseParam(param));
            licenseManager.uninstall();
 
            result = licenseManager.install(new File(param.getLicensePath()));
            logger.info(MessageFormat.format("证书安装成功,证书有效期:{0} - {1}",format.format(result.getNotBefore()),format.format(result.getNotAfter())));
        }catch (Exception e){
            logger.error("证书安装失败!",e);
        }
 
        return result;
    }
 
    /**
     * 校验License证书
     * @return boolean
     */
    public boolean verify(){
        LicenseManager licenseManager = LicenseManagerHolder.getInstance(null);
        DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
 
        //2. 校验证书
        try {
            LicenseContent licenseContent = licenseManager.verify();
 
            logger.info(MessageFormat.format("证书校验通过,证书有效期:{0} - {1}",format.format(licenseContent.getNotBefore()),format.format(licenseContent.getNotAfter())));
            return true;
        }catch (Exception e){
            logger.error("证书校验失败!",e);
            return false;
        }
    }
 
    /**
     * 初始化证书生成参数
     * @param param License校验类需要的参数
     * @return de.schlichtherle.license.LicenseParam
     */
    private LicenseParam initLicenseParam(LicenseVerifyParam param){
        Preferences preferences = Preferences.userNodeForPackage(LicenseVerify.class);
 
        CipherParam cipherParam = new DefaultCipherParam(param.getStorePass());
 
        KeyStoreParam publicStoreParam = new CustomKeyStoreParam(LicenseVerify.class
                ,param.getPublicKeysStorePath()
                ,param.getPublicAlias()
                ,param.getStorePass()
                ,null);
 
        return new DefaultLicenseParam(param.getSubject()
                ,preferences
                ,publicStoreParam
                ,cipherParam);
    }
}

在项目启动的时候安装证书的Listener类:

@Component
public class LicenseCheckListener implements ApplicationListener<ContextRefreshedEvent> {
 
    private static Logger logger = LoggerFactory.getLogger(LicenseCheckListener.class);
 
    /**
     * 证书subject
     */
    @Value("${license.subject}")
    private String subject;
 
    /**
     * 公钥别称
     */
    @Value("${license.publicAlias}")
    private String publicAlias;
 
    /**
     * 访问公钥库的密码
     */
    @Value("${license.storePass}")
    private String storePass;
 
    /**
     * 证书生成路径
     */
    @Value("${license.licensePath}")
    private String licensePath;
 
    /**
     * 密钥库存储路径
     */
    @Value("${license.publicKeysStorePath}")
    private String publicKeysStorePath;
 
    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        //root application context 没有parent
        ApplicationContext context = event.getApplicationContext().getParent();
        if(context == null){
            if(StringUtils.isNotBlank(licensePath)){
                logger.info("++++++++ 开始安装证书 ++++++++");
 
                LicenseVerifyParam param = new LicenseVerifyParam();
                param.setSubject(subject);
                param.setPublicAlias(publicAlias);
                param.setStorePass(storePass);
                param.setLicensePath(licensePath);
                param.setPublicKeysStorePath(publicKeysStorePath);
 
                LicenseVerify licenseVerify = new LicenseVerify();
                //安装证书
                licenseVerify.install(param);
 
                logger.info("++++++++ 证书安装结束 ++++++++");
            }
        }
    }
}

在项目启动的时候安装证书的Listener类:

@Component
public class LicenseCheckListener implements ApplicationListener<ContextRefreshedEvent> {
 
    private static Logger logger = LoggerFactory.getLogger(LicenseCheckListener.class);
 
    /**
     * 证书subject
     */
    @Value("${license.subject}")
    private String subject;
 
    /**
     * 公钥别称
     */
    @Value("${license.publicAlias}")
    private String publicAlias;
 
    /**
     * 访问公钥库的密码
     */
    @Value("${license.storePass}")
    private String storePass;
 
    /**
     * 证书生成路径
     */
    @Value("${license.licensePath}")
    private String licensePath;
 
    /**
     * 密钥库存储路径
     */
    @Value("${license.publicKeysStorePath}")
    private String publicKeysStorePath;
 
    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        //root application context 没有parent
        ApplicationContext context = event.getApplicationContext().getParent();
        if(context == null){
            if(StringUtils.isNotBlank(licensePath)){
                logger.info("++++++++ 开始安装证书 ++++++++");
 
                LicenseVerifyParam param = new LicenseVerifyParam();
                param.setSubject(subject);
                param.setPublicAlias(publicAlias);
                param.setStorePass(storePass);
                param.setLicensePath(licensePath);
                param.setPublicKeysStorePath(publicKeysStorePath);
 
                LicenseVerify licenseVerify = new LicenseVerify();
                //安装证书
                licenseVerify.install(param);
 
                logger.info("++++++++ 证书安装结束 ++++++++");
            }
        }
    }
}

上述安装证书的类要与服务端生成证书的类要在同一个包路径下

尤其是LicenseCheckModel类需要在同一个包路径下,防止XML反序列化失败,我的都是在【com.bw.license】路径下。

拦截器校验license证书

@Component
public class LoginInterceptor implements HandlerInterceptor {
 
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        LicenseVerify licenseVerify = new LicenseVerify();
 
        //校验证书是否有效
        boolean verifyResult = licenseVerify.verify();
 
        if(verifyResult){
            return true;
        }else{
            response.setCharacterEncoding("utf-8");
            JSONObject obj = new JSONObject();
            obj.put("errcode", "0319");
            obj.put("errmsg", "您的证书无效,请核查服务器是否取得授权或重新申请证书!");
            response.getWriter().print(obj);
            response.getWriter().flush();
            return false;
        }
    }
}
 

Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐