ngx_Lua模块中的加密api接口

 

在Lua模块中提供了多种用于是实现各种字符串加密算法的API接口，主要包括：

 

>ngx.crc32_short

 

语法：digest= ngx.crc32_short(str)

该方法主要是计算给定字符串str的循环校验码（Cyclic Redundancy Code）的摘要，计算出来的结果是一个很大的整数

 

>ngx.crc32_long

 

语法：digest= ngx.crc32_long(str)

该方法与上面的方法计算得到的结果是一致的，主要区别在于ngx.crc32_short适合用于计算长度介于30~60之间的str的摘要，而ngx.crc32_long更适合计算长度超过30~60的str的摘要。因此，到底选择哪一个api进行计算str的crc_32摘要，主要取决于str的长度。

 

>ngx.hmac_sha1

 

语法：digest = ngx.hmac_sha1(secret_key, str)

该方法主要用于计算输入字符串str的HMAC-SHA1的摘要，并根据secret_key对结果进行转换，计算后得到的结果是二进制格式的，可以通过ngx.encode_base64转换成非二进制格式的字符串，例如：

local key = "thisisverysecretstuff"
local src = "some string we want to sign"
local digest = ngx.hmac_sha1(key, src)
ngx.say(ngx.encode_base64(digest))

 

>ngx.md5

 

语法：digest = ngx.md5(str)

该方法将返回字符串str的MD5摘要的16进制的表示，如下：

location = /md5 {
    content_by_lua 'ngx.say(ngx.md5("hello"))';
}

 

产生的结果如下：

5d41402abc4b2a76b9719d911017c592

 

>ngx.md5_bin

 

语法：digest = ngx.md5_bin(str)

该方法将返回字符串str的MD5摘要的二进制格式，可以通过ngx.encode_base64方法转换成非二进制格式的字符串，或者直接使用ngx.md5方法

 

>ngx.sha1_bin

 

语法：digest = ngx.sha1_bin(str)

该方法将返回字符串str的二进制格式的SHA-1摘要，可以通过ngx.encode_base64方法转换成非二进制格式的字符串。

下面来看一个例子：

         location /encryption {
             content_by_lua '
                 local crc_32s, crc_32l
                 local key = "it is my secret"
                 local str = "encrypted hello yuefei"
                 crc_32s = ngx.crc32_short(str)
                 crc_32l = ngx.crc32_long(str)
                 local hmac = ngx.hmac_sha1(key, str)
                 local md5 = ngx.md5(str)
                 local md5_bin = ngx.md5_bin(str)
                 local sha1_bin = ngx.sha1_bin(str)
                 ngx.say("crc_32_short:", crc_32s, ", crc_32_long: ", crc_32l)
                 ngx.say("hmac: ", ngx.encode_base64(hmac))
                 ngx.say("md5: ", md5, ", md5_bin: ", ngx.encode_base64(md5_bin))
                 ngx.say("sha1_bin: ", ngx.encode_base64(sha1_bin))
             ';
         }

 

输出结果：

crc_32_short:1560312840, crc_32_long: 1560312840
hmac: 1gpvtAliGFZfSqSD32Sz04/3PiM=
md5: b80a89b331b307dbef83e2eb90c43481, md5_bin: uAqJszGzB9vvg+LrkMQ0gQ==
sha1_bin: 2A/wkXlXjz1t3wmNxMUi3QuMP7c=

 

（全文完）