[tls] TLS工具包

不同于 Golang 原生的 TLS 包，yak 的 TLS 工具包并不提供 TLS 连接等功能，只提供必要的根证书生成与证书签发等功能。

本 tls 工具包重点支持其他工具包对于 TLS 的需求：

比如开启一个 TCP TLS 连接需要的 HTTPS 证书组
mitm 中间人劫持对证书的需求
...

API

fn tls.GenerateRootCA(commonName: string): (caCert []byte, pKey []byte, err error) 使用 CommonName 作为根证书的名字，生成一个简易根证书：PEM格式
fn tls.SignClientCertAndKey(caCert: []byte, pKey: []byte): (cert []byte, pKey []byte, err error) 使用根证书签出一个 Server 端可用的服务器证书（不开启 x509 认证）：PEM格式
fn tls.SignServerCertAndKey(caCert: []byte, pKey: []byte): (cert []byte, pKey []byte, err error) 使用证书签出一个 Client 端可用的用户端证书（不开启 x509 认证）：PEM格式
fn tls.SignX509ClientCertAndKey(caCert: []byte, pKey: []byte): (cert []byte, pKey []byte, err error) 使用根证书签出一个 Server 端可用的服务器证书（开启 x509 认证）：PEM格式
fn tls.SignX509ServerCertAndKey(caCert: []byte, pKey: []byte): (cert []byte, pKey []byte, err error) 使用证书签出一个 Client 端可用的用户端证书（开启 x509 认证）：PEM格式

`x509` or Not ?

我们在上面 API 中，发现我们签发服务端证书或者客户端证书的时候，可以选择 x509 是否开启。那么什么是 x509 认证呢？简单理解可以理解为: TLS签发的服务端/客户端证书只允许连接受信任的客户端/服务端，这个认证不需要密码，只通过证书来认证，在本包中，我们保证同一个根证书签发的开启 X509 认证的客户端和服务端都可以互相连接。

案例：如果你想开启一个 HTTPS 大家都可以访问，就不应该开启 X509 认证

反之，你的 HTTPS 连接如果只想要自己（的证书应用）连接，则需要开启 x509 认证

案例

生成根证书保存在本地

ca, key, err := tls.GenerateRootCA("Yak Test")
die(err)

// 打印一下 ca key 到屏幕，看一下具体格式：PEM格式
println(string(ca))
println(string(key))

// 把 ca 和 key 保存在本地，如果错误，直接退出
die(file.Save("yak.ca.pem", ca))
die(file.Save("yak.pkey.pem", key))

我们执行上述内容之后，获得如下结果

签发证书，并尝试构建 TLS TCP 通信

// 生成一个 CA
ca, key, err := tls.GenerateRootCA("Yak Test")
die(err)

// 使用 CA 和 KEY 签发一个 TLS 服务端证书
serverCert, serverKey, err := tls.SignServerCertAndKey(ca, key)
die(err)

// 签发一个客户端 TLS 证书
clientCert, clientKey, err := tls.SignClientCertAndKey(ca, key)
die(err)

// 启动一个 TCP 服务器
go tcp.Serve("127.0.0.1", 54326, tcp.serverTls(serverCert, serverKey), tcp.serverCallback(func(conn){
    println("TLS Server RECV conn from: ", conn.RemoteAddr())
    defer conn.Close()

    conn.Send("Hello TLS Config")
}))

// 启动一个 TLS 客户端连接
sleep(1)
conn, err := tcp.Connect("127.0.0.1", 54326, tcp.clientTls(clientCert, clientKey))
die(err)

sleep(2)

raw, err := conn.RecvString()
die(err)

println("Client RECV: ", raw)

我们在上述代码中，构建了 CA，并用 CA 签发了客户端和服务端证书，使用证书进行了密码通信（虽然没有进行 x509 加密）

我们执行完上述代码之后，收到的结果为：

TLS Server RECV conn from:  127.0.0.1:55217
Client RECV:  Hello TLS Config

API​

x509 or Not ?​

案例​

生成根证书保存在本地​

签发证书，并尝试构建 TLS TCP 通信​

API

`x509` or Not ?

案例

生成根证书保存在本地

签发证书，并尝试构建 TLS TCP 通信