Golang简单高效的许可证管理插件库lk的使用

lk是一个简单高效的Golang许可证管理库，它可以生成包含任意数据（如用户邮箱、截止日期等）的许可证文件，并支持验证这些许可证。

工作原理

1. 生成一个私钥（并保持安全）
2. 将你想要提供的数据（截止日期、用户邮箱等）转换为字节数组（使用json或gob等）
3. 库获取数据并创建一个加密签名的哈希，附加到数据中
4. 将结果转换为Base64/Base32/Hex字符串并发送给最终用户：这就是许可证
5. 当用户启动程序时，加载许可证并使用公钥验证签名
6. 验证许可证密钥中的数据（如截止日期）

完整示例

1. 生成新许可证

// 首先，你需要一个由`lkgen gen`生成的base32编码的私钥
// 注意你可能更愿意从文件中读取它，并且它应该保持机密（即不要随应用程序分发！）
const privateKeyBase32 = "FD7YCAYBAEFXA22DN5XHIYLJNZSXEAP7QIAACAQBANIHKYQBBIAACAKEAH7YIAAAAAFP7AYFAEBP7BQAAAAP7GP7QIAWCBCRKQVWKPT7UJDNP4LB5TXEQMO7EYEGDCE42KVBDNEGRIYIIJFBIWIVB6T6ZTKLSYSGK54DZ5VX6M5SJHBYZU2JXUFXJI25L2JJKJW4RL7UL2XBDT4GKYZ5IS6IWBCN7CWTMVBCBHJMH3RHZ5BVGVAY66MQAEYQEPSS2ANTYZIWXWSGIUJW3MDOO335JK3D4N3IV4L5UTAQMLS5YC7QASCAAUOHTZ5ZCCCYIBNCWBELBM===="

// 解组私钥
privateKey, err := lk.PrivateKeyFromB32String(privateKeyBase32)
if err != nil {
    log.Fatal(err)
}

// 定义许可证中需要的数据
// 这里我们使用一个被编组成json的结构体，但最终你只需要一个[]byte
doc := struct {
    Email string    `json:"email"`
    End   time.Time `json:"end"`
}{
    "user@example.com",
    time.Now().Add(time.Hour * 24 * 365), // 1年
}

// 将文档编组为[]bytes（这是我们的许可证将包含的数据）
docBytes, err := json.Marshal(doc)
if err != nil {
    log.Fatal(err)
}

// 用私钥和文档生成你的许可证
license, err := lk.NewLicense(privateKey, docBytes)
if err != nil {
    log.Fatal(err)
}

// 许可证的b32表示，这是你给客户的东西
licenseB32, err := license.ToB32String()
if err != nil {
    log.Fatal(err)
}
fmt.Println(licenseB32)

2. 验证许可证

// 一个之前生成的b32编码的许可证。在实际应用中你应该从文件中读取它...
const licenseB32 = "FT7YOAYBAEDUY2LDMVXHGZIB76EAAAIDAECEIYLUMEAQUAABAFJAD74EAAAQCUYB76CAAAAABL7YGBIBAL7YMAAAAD73H74IAFEHWITFNVQWS3BCHIRHIZLTORAGK6DBNVYGYZJOMNXW2IRMEJSW4ZBCHIRDEMBRHAWTCMBNGI3FIMJSHIYTSORTGMXDOMBZG43TIMJYHAVTAMR2GAYCE7IBGEBAPXB37ROJCUOYBVG4LAL3MSNKJKPGIKNT564PYK5X542NH62V7TAUEYHGLEOPZHRBAPH7M4SC55OHAEYQEXMKGG3JPO6BSHTDF3T5H6T42VUD7YAJ3TY5AP5MDE5QW4ZYWMSAPEK24HZOUXQ3LJ5YY34XYPVXBUAA===="

// 公钥b32编码，使用`lkgen pub my_private_key_file`从私钥生成
// 它应该硬编码在你的应用程序中
const publicKeyBase32 = "ARIVIK3FHZ72ERWX6FQ6Z3SIGHPSMCDBRCONFKQRWSDIUMEEESQULEKQ7J7MZVFZMJDFO6B46237GOZETQ4M2NE32C3UUNOV5EUVE3OIV72F5LQRZ6DFMM6UJPELARG7RLJWKQRATUWD5YT46Q2TKQMPPGIA===="

// 解组公钥
publicKey, err := lk.PublicKeyFromB32String(publicKeyBase32)
if err != nil {
    log.Fatal(err)
}

// 解组客户许可证
license, err := lk.LicenseFromB32String(licenseB32)
if err != nil {
    log.Fatal(err)
}

// 验证许可证签名
if ok, err := license.Verify(publicKey); err != nil {
    log.Fatal(err)
} else if !ok {
    log.Fatal("Invalid license signature")
}

result := struct {
    Email string    `json:"email"`
    End   time.Time `json:"end"`
}{}

// 解组文档
if err := json.Unmarshal(license.Data, &result); err != nil {
    log.Fatal(err)
}

// 现在你只需要检查截止日期是否在当前时间之后，然后就可以继续了！
if result.End.Before(time.Now()) {
    log.Fatalf("License expired on: %s", result.End.Format("2006-01-02"))
} else {
    fmt.Printf(`Licensed to %s until %s`, result.Email, result.End.Format("2006-01-02"))
}

3. 完整示例

// 创建一个新的私钥：
privateKey, err := lk.NewPrivateKey()
if err != nil {
    log.Fatal(err)
}

// 创建一个许可证文档：
doc := MyLicence{
    "test@example.com",
    time.Now().Add(time.Hour * 24 * 365), // 1年
}

// 将文档编组为json字节：
docBytes, err := json.Marshal(doc)
if err != nil {
    log.Fatal(err)
}

// 用私钥和文档生成你的许可证：
license, err := lk.NewLicense(privateKey, docBytes)
if err != nil {
    log.Fatal(err)
}

// 将新许可证编码为b64，这是你给客户的东西
str64, err := license.ToB64String()
if err != nil {
    log.Fatal(err)
}
fmt.Println(str64)

// 获取公钥。公钥应该硬编码在你的应用程序中以检查许可证
// 不要分发私钥！
publicKey := privateKey.GetPublicKey()

// 验证许可证：
if ok, err := license.Verify(publicKey); err != nil {
    log.Fatal(err)
} else if !ok {
    log.Fatal("Invalid license signature")
}

// 解组文档并检查截止日期：
res := MyLicence{}
if err := json.Unmarshal(license.Data, &res); err != nil {
    log.Fatal(err)
} else if res.End.Before(time.Now()) {
    log.Fatalf("License expired on: %s", res.End.String())
} else {
    fmt.Printf(`Licensed to %s until %s \n`, res.Email, res.End.Format("2006-01-02"))
}

这个库使用椭圆曲线数字签名算法（使用elliptic.P384）来签名许可证文件，并且许可证可以以易于分发的格式（如base32编码字符串）进行编组。