springboot基於license詳細實踐

springboot基於license詳細實踐

1.設計思路

    客戶端的代碼在項目啓動時在指定路徑下檢測是否存在license認證文件，若果存在則進行安裝；在登錄接口以及系統核心接口處處添加認證標識，同時添加license文件認證攔截器進行攔截驗證。
    服務端負責生成license認證文件，生成後部署到客戶端指定的路徑下。

2.詳細實現

2.1使用jdk中keytool 工具生成祕鑰對
以下命令在 window cmd 命令窗口執行，注意當前執行目錄，最後生成的密鑰對即在該目錄下：
1、首先要用 KeyTool 工具來生成私匙庫：（-alias別名 -validity 3650 表示10年有效）

keytool -genkey -alias privatekey -keysize 1024 -keystore privateKeys.store -validity 3650
2、然後把私匙庫內的證書導出到一個文件當中

keytool -export -alias privatekey -file certfile.cer -keystore privateKeys.store
3、然後再把這個證書文件導入到公匙庫

keytool -import -alias publiccert -file certfile.cer -keystore publicCerts.store
最後生成的文件 privateKeys.store（私鑰）、publicCerts.store（公鑰）拷貝出來備用。
2.2服務端代碼實現
參考鏈接：https://gitee.com/zifangsky/LicenseDemo/tree/master/ServerDemo
2.3客戶端代碼實現
參考鏈接：https://gitee.com/zifangsky/LicenseDemo/tree/master/ClientDemo

3.完整代碼參考

https://gitee.com/zifangsky/LicenseDemo

4.核心實現步驟

4.1在pom文件中添加核心依賴

de.schlichtherle.truelicense
truelicense-core
1.33
provided

4.2校驗自定義的license參數
TrueLicense的 de.schlichtherle.license.LicenseManager 類自帶的verify方法只校驗了我們後面頒發的許可文件的生效和過期時間，然而在實際項目中我們可能需要額外校驗應用部署的服務器的IP地址、MAC地址、CPU序列號、主板序列號等信息，因此我們需要複寫框架的部分方法以實現校驗自定義參數的目的。

首先需要添加一個自定義的可被允許的服務器硬件信息的實體類（如果校驗其他參數，可自行補充）：

package cn.zifangsky.license;
 
import java.io.Serializable;
import java.util.List;
 
/**
 * 自定義需要校驗的License參數
 *
 * @author zifangsky
 * @date 2018/4/23
 * @since 1.0.0
 */
public class LicenseCheckModel implements Serializable{
 
    private static final long serialVersionUID = 8600137500316662317L;
    /**
     * 可被允許的IP地址
     */
    private List<String> ipAddress;
 
    /**
     * 可被允許的MAC地址
     */
    private List<String> macAddress;
 
    /**
     * 可被允許的CPU序列號
     */
    private String cpuSerial;
 
    /**
     * 可被允許的主板序列號
     */
    private String mainBoardSerial;
 
    //省略setter和getter方法
 
    @Override
    public String toString() {
        return "LicenseCheckModel{" +
                "ipAddress=" + ipAddress +
                ", macAddress=" + macAddress +
                ", cpuSerial='" + cpuSerial + '\'' +
                ", mainBoardSerial='" + mainBoardSerial + '\'' +
                '}';
    }
}

注意
自定義的license參數類路徑必須和客戶端license參數類路徑相同，否則客戶端在進行證書安裝時會出現ClassNotFind
4.3添加license生成類需要的參數

package cn.zifangsky.license;
 
import com.fasterxml.jackson.annotation.JsonFormat;
 
import java.io.Serializable;
import java.util.Date;
 
/**
 * License生成類需要的參數
 *
 * @author zifangsky
 * @date 2018/4/19
 * @since 1.0.0
 */
public class LicenseCreatorParam implements Serializable {
 
    private static final long serialVersionUID = -7793154252684580872L;
    /**
     * 證書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;
 
    //省略setter和getter方法
 
    @Override
    public String toString() {
        return "LicenseCreatorParam{" +
                "subject='" + subject + '\'' +
                ", privateAlias='" + privateAlias + '\'' +
                ", keyPass='" + keyPass + '\'' +
                ", storePass='" + storePass + '\'' +
                ", licensePath='" + licensePath + '\'' +
                ", privateKeysStorePath='" + privateKeysStorePath + '\'' +
                ", issuedTime=" + issuedTime +
                ", expiryTime=" + expiryTime +
                ", consumerType='" + consumerType + '\'' +
                ", consumerAmount=" + consumerAmount +
                ", description='" + description + '\'' +
                ", licenseCheckModel=" + licenseCheckModel +
                '}';
    }
}

4.4添加抽象類AbstractServerInfos，用戶獲取服務器的硬件信息

package cn.zifangsky.license;
 
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
 
import java.net.InetAddress;
import java.net.NetworkInterface;
import java.net.SocketException;
import java.util.ArrayList;
import java.util.Enumeration;
import java.util.List;
 
/**
 * 用於獲取客戶服務器的基本信息，如：IP、Mac地址、CPU序列號、主板序列號等
 *
 * @author zifangsky
 * @date 2018/4/23
 * @since 1.0.0
 */
public abstract class AbstractServerInfos {
    private static Logger logger = LogManager.getLogger(AbstractServerInfos.class);
 
    /**
     * 組裝需要額外校驗的License參數
     * @author zifangsky
     * @date 2018/4/23 14:23
     * @since 1.0.0
     * @return demo.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地址
     * @author zifangsky
     * @date 2018/4/23 11:32
     * @since 1.0.0
     * @return java.util.List<java.lang.String>
     */
    protected abstract List<String> getIpAddress() throws Exception;
 
    /**
     * 獲取Mac地址
     * @author zifangsky
     * @date 2018/4/23 11:32
     * @since 1.0.0
     * @return java.util.List<java.lang.String>
     */
    protected abstract List<String> getMacAddress() throws Exception;
 
    /**
     * 獲取CPU序列號
     * @author zifangsky
     * @date 2018/4/23 11:35
     * @since 1.0.0
     * @return java.lang.String
     */
    protected abstract String getCPUSerial() throws Exception;
 
    /**
     * 獲取主板序列號
     * @author zifangsky
     * @date 2018/4/23 11:35
     * @since 1.0.0
     * @return java.lang.String
     */
    protected abstract String getMainBoardSerial() throws Exception;
 
    /**
     * 獲取當前服務器所有符合條件的InetAddress
     * @author zifangsky
     * @date 2018/4/23 17:38
     * @since 1.0.0
     * @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地址
     * @author zifangsky
     * @date 2018/4/23 18:08
     * @since 1.0.0
     * @param
     * @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;
    }
 
}

5.5獲取客戶Linux服務器的基本信息

package cn.zifangsky.license;

import org.apache.commons.lang3.StringUtils;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.InetAddress;
import java.util.List;
import java.util.stream.Collectors;

/**
 * 用於獲取客戶Linux服務器的基本信息
 *
 * @author zifangsky
 * @date 2018/4/23
 * @since 1.0.0
 */
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;
    }
}

5.6獲取客戶Windows服務器的基本信息：

package cn.zifangsky.license;
 
import java.net.InetAddress;
import java.util.List;
import java.util.Scanner;
import java.util.stream.Collectors;
 
/**
 * 用於獲取客戶Windows服務器的基本信息
 *
 * @author zifangsky
 * @date 2018/4/23
 * @since 1.0.0
 */
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;
    }
}