改造起因
在上篇文章, 我描述了为skynet
添加稳定的websocket
支持的起始并阐述了这么做的原因.
这几天在测试的时候发现, 当使用skynet
内置的httpc库的时候会遇见crypt
缺少一些我需要用到的算法(例如: crc
、sha256
、hmac_sha256
等等).
这里完全可以假设开发者在框架选型的时候没发现这个问题, 那可能会到开发中期需要第三方平台接入或扩展不同架构的时候才可能会发现了.
显然这将会在无形之中就会给一个项目引入不可预料的稳定性因素. 为了尽可能的避免这个因素, 扩展一些常见的加密(摘要)算法支持是必不可少的.
首选方案肯定使用已经成熟的库. 但是很可惜, lua5.3没有较为可靠并且现成的实现库可以fork
后直接使用.
而且可以用来参考的库仅有: luajit
利用ffi
实现的库、OpenSSL
的实现. 然而这些无法直接或间接移植到lua 5.3.
这是目前遇到的最坏的情况! 最终, 我们只能用Lua的C API来粘合C语言的Crypt实现来完成Lua版本的Crypt扩展库改造工作.
改造开始
我在网上寻找一段时间后发现一个比较不错的Lua sha实现.
这份代码包含md5
、sha128
、sha384
、sha512
的C实现, 其用大量的宏来完成Lua注入动作. 可见我们需要做的第一件事情就是去掉这些不易阅读的宏定义.
我们知道skynet
的luaclib-src/lsha1.c
文件中已经存在了一份sha1实现. 那么我们可以保留sha1, 仅仅提取sha2部分的sha256
与sha512
的实现.
sha2在改造成标准Lua Model实现后可维护性大大提升, 我们将其命名为lsha2.c
与lsha2.h
来描述显然再好不过. 这时候, 我们已经可以使用这些算法进行测试了.
大家都知道HMAC
是一种哈希
算法, 目前这种哈希
算法的hmac_256
与hmac_512
实现已经在很多云平台广为使用. 一个较为明显的例子就是腾讯云.
在lsha1.c
的文件内已经有了一份HMAC
实现代码, 我们将xor_str
算法拷贝到lsha2
文件中. 就可以简单的完成扩展.
这里需要知道的是, sha128
与sha256
的Block都可以使用64, 但是hmac_sha512
的block
的长度是128
. 所以我们为它单独在内部多写了一份代码方便维护.
参照lsha1.c
的hmac_sha128
实现方法扩展hmac_256
与hmac_512
非常简单. 基本上就是改block
与Lua Model编写. 很快就能完成.
skynet的3rd
目录下已经支持md5
. 虽然不知道大家怎么用的, 但是我使用起来感觉非常不便. 并且crypt
库支持的hmac64_md5
目前与其它语言对接也较为不便.
最后我们索性上面提到的代码创建lmd5.c
文件实现一份md5的算法, 然后参照上面的hmac算法又实现了一份hmac_md5
. 这样能让所有算法并存于crypt
库内部.
当你看到这里! 你肯定以为, 我们的工作已经完成了! 然而这还不够, 既然已经开始动手. 那么一些常见的算法必将都要被纳入进来.
我们最后尝试从redis
的源码文件中拿到crc32
与crc64
的源码, 然后直接提取出来改造成为一个单独的lcrc.c
文件并为其注入Lua C API.
以上, 完成了crypt
的基本改造.
改造结果
目前测试结果在其它语言集上内容输出一致. 由于实现使用到是C语言, 性能表现方面自然强过一些lua实现. 所以不用过多考虑性能都问题.
既然已经开源了一份Websocket
实现, 那么干脆也开源这份代码吧! 至于命名就延续之前的命名: skynet-lua-crypt
.
安装方法
由于改造涉及到了skynet的luaclib-src
内的文件修改, 所以编译方法肯定不能是普通的3rd方式就能完成编译的.
而且skynet
的一些文件内部也使用到了这个库, 我们需要直接修改skynet
的Makefile
文件完成这个替换动作. 这样能保证编果更加顺利.
为了跟进版本. 我拉取了skynet
的1.2版本代码进行测试, 经过我的MacBook Pro编译与skynet/test/testsha.lua
文件测试通过并且无副作用.
项目地址
项目地址在这里. 安装与替换方式非常简单. 基本上就是拷贝源码与替换Makefile.
并且我在项目内提供了一份Makefile用于直接替换, 这在项目的README
中都有描述. 至于为什么不提pull request
, 只是觉得没有那个必要而已.
更多详细介绍, 请参考项目Release发布介绍与README.
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。