truelicense

truelicense简要说明使用trueLicense来做软件产品的保护，我们主要使用它的LicenseManager类来生成证书文件、安装证书文件、验证证书文件.假设我们已为我们软件的使用者提供了证书，下面的流程图为简略的trueLicense验证证书文件的流程。

LicenseEngine是我们自己写的一个引擎类，它封装了一些业务逻辑，以方便外部进行调用，我们验证license文件时，首先要安装license文件，安装license文件就是把文件形式的license 文件（数字签名过的普通文本文件）转换成GenericCertificate对象，这个以及其他的持久化操作是由de.schlichtherle.xml.PersistenceService类提供的。

GenericCertificate是一个起纽带作用的类，也是truelicense最底层最核心的类。

它对最底层的javax.crypto包下类的方法进行了逻辑封装，truelicense上层在生成license文件时对其数字签名以及在验证证书内容时解密证书内容就是借助它来完成的。

安装license文件和调用verify()方法时都会进行certification的验证和license内容的校验。

从LicenseManager的install()方法的源码中可以看出我们最好让LicenseManager为单例，只要虚拟机一直运行，在安装license时，install方法会通过setCertificate(certificate)来设置系统当前的certificate，注意LicenseManager是线程安全的类，使用得当的情况下单例也不会出现线程问题。

以下是install方法的源码。

validate(LicenseContent content)方法会验证证书的基本内容，最主要的是验证内容是对比当前日期和证书上的有效期。

trueLicense的验证机制是当验证失败后，直接抛出异常。

下面简要说明如何生成license文件首先license文件是被数字签名的普通文本信息，我们需要一个私钥库来生成私钥来用于加密，我们相应也需要一个从私钥库中导出的公钥来解密，我们可以使用JAVA的Toolkit 来生成私钥库。

（1）命令行下：keytool -genkey -alias privatekey -keystore privateKeys.store此时生成私钥库。

别名很重要请务必记下来。

此时会提示你输入keyStore的密码，注意此时有个小陷阱，请务必把密码设置为数字和小写字母的混合体，原因会在后面说明。

（2）然后把私匙库内的公匙导出到一个文件当中：keytool -export -alias privatekey -file certfile.cer -keystore privateKeys.store（3）然后再把这个证书文件导入到公匙库：keytool -import -alias publiccert -file certfile.cer -keystore publicCerts.store这个公钥库要随软件一起发布给用户。

生成license文件依然需要用到LicenseManager类从它实现的接口上看知道其既有创建License的职责又有验证License文件的职责。

调用LicenseManager的实例方法store(LicenseContent, File)即可生成license文件。

下面是LiicenseManager类构造器的源码。

public LicenseManager(LicenseParam param) {setLicenseParam0(param);}生成一个LicenseManager类的实例，需要一个LicenseParam类型的形参。

下面是LicenseParam的继承体系它持有生成license和验证license时所需要的一些对象。

注意这里的subject和LicensContent的subject必须一致，否则不能通过验证而抛出异常。

KeyStoreParam是根据公、私匙库的参数抽象出的类，在底层操作公私钥库时需要这些具体的参数（如通过alias来找到具体的钥库等下面是简要的license文件生成的时序图。

简单说来就是对licenseContent的byte[]形式先进行签名，然后将byte[]以文件的形式输出。

True-License的演示用例简单的trueLicense用例，仅供参考.true-license的源码，已经添加了中文注释，喜欢的朋友可以拿去看看。

import de.schlichtherle.license.LicenseManager;import de.schlichtherle.license.LicenseParam;/*** LicenseManager容器类* @author 宋三思*/public class LicenseManagerHolder {private static LicenseManager licenseManager;public static synchronized LicenseManager getLicenseManager(LicenseParam licenseParams) {if (licenseManager == null) {licenseManager = new LicenseManager(licenseParams);}return licenseManager;}}import java.io.File;import java.util.Date;import java.util.prefs.Preferences;import javax.security.auth.x500.X500Principal;import de.schlichtherle.license.CipherParam;import de.schlichtherle.license.DefaultCipherParam;import de.schlichtherle.license.DefaultKeyStoreParam;import de.schlichtherle.license.DefaultLicenseParam;import de.schlichtherle.license.KeyStoreParam;import de.schlichtherle.license.LicenseContent;import de.schlichtherle.license.LicenseParam;import de.schlichtherle.license.LicenseManager;public class TestTrueLicense {public final static String PRIVATEALIAS = "privatekey";public final static String PUBLICALIAS = "publiccert";public final static String KEYPWD = "111aaa";public final static String STOREPWD = "111aaa";public final static String SUBJECT = "trueLicense测试";//为了方便直接用的API里的例子//X500Princal是一个证书文件的固有格式，详见APIpublic final static X500Principal DEFAULTHOLDERANDISSUER = new X500Principal("CN=Duke、OU=JavaSoft、O=Sun Microsystems、C=US");public static void main(String[] args) throws Exception {/**************证书发布者端执行******************/LicenseManager licenseManager =LicenseManagerHolder.getLicenseManager(initLicenseParams0());String storePath = TestTrueLicense.class.getResource(".").getFile() + File.separator + "测试.lic";licenseManager.store((createLicenseContent()), new File(storePath));System.out.println("服务器端生成证书成功!");/**************证书使用者端执行******************///由于用的是一个licenseManager所以重新设置验证时需要的LicenseParamlicenseManager.setLicenseParam(initLicenseParams1());//安装证书licenseManager.install(new File(storePath));System.out.println("客户端安装证书成功!");//验证证书licenseManager.verify();System.out.println("客户端验证证书成功!");}//返回生成证书时需要的参数private static LicenseParam initLicenseParams0() {Preferences preference = erNodeForPackage(TestTrueLicense.class);//设置对证书内容加密的对称密码CipherParam cipherParam = new DefaultCipherParam("111aaa");//参数1,2从哪个Class.getResource()获得密钥库//参数3密钥库的别名//参数4密钥库存储密码//参数5密钥库密码KeyStoreParam privateStoreParam =new DefaultKeyStoreParam(TestTrueLicense.class, "privateKeys.store", PRIVATEALIAS, STOREPWD, KEYPWD);LicenseParam licenseParams =new DefaultLicenseParam(SUBJECT, preference, privateStoreParam, cipherParam);return licenseParams;}//返回验证证书需要的参数private static LicenseParam initLicenseParams1() {Preferences preference = erNodeForPackage(TestTrueLicense.class);CipherParam cipherParam = new DefaultCipherParam("111aaa");KeyStoreParam privateStoreParam =new DefaultKeyStoreParam(TestTrueLicense.class, "publicCerts.store", PUBLICALIAS, STOREPWD, null);LicenseParam licenseParams =new DefaultLicenseParam(SUBJECT, preference, privateStoreParam, cipherParam);return licenseParams;}//一般可以从外部表单拿到证书的内容//这里为了演示，把证书内容写死了public final static LicenseContent createLicenseContent() {LicenseContent content = null;content = new LicenseContent();content.setSubject(SUBJECT);content.setHolder(DEFAULTHOLDERANDISSUER);content.setIssuer(DEFAULTHOLDERANDISSUER);content.setIssued(new Date());content.setNotBefore(new Date());content.setNotAfter(new Date(new Date().getTime() + 1000));私钥别名privateKey keystore密码： 名字与姓氏:berrygenomics 组织单位:贝瑞和康组织名称:it部城市区域名称:朝阳区州或省份名称:北京市两字母国家代码:CN privateKey主密码berry123privateKeys.store公钥别名：publiccert公钥密码：publicCerts.store。