金仓数据库kbcrypto 插件实现sm加密算法
首先介绍一下sm4 算法
SM4 算法是对称加密算法，国标 GB/T 32907 对 SM4 对称加密算法进行了详细描述。SM4 算法密钥长度固定为128bit，加密解密采用相同的密钥，加解密速度较快，优于AES算法。
SM4算法首先将加密信息进行分组，分组后通过异或、S盒变换、移位等操作进行分组明文的拓展。其中使用迭代方法实现铭文拓展，每轮迭代所采用的密钥经过加密类似的流程进行迭代生成，也就是说加密迭代和生成密钥迭代是对应的。因此，解密过程也能够通过密钥进行密文的迭代解密。
kbcrypto 插件
kbcrypto 是 KingbaseES 的一个扩展插件，可以提供如 rc4,sm3,sm4 等加密函数的访问，可以提供明文的加密打 印输出到前端
KingbaseES 数据库默认将它添加到 kingbase.conf 文件的 shared_preload_libraries 中，重启数据库时自动加载。默认是已存在。
插件 kbcrypto 的使用方法
-- 创建插件
\c test system create extension kbcrypto ;
CREATE EXTENSION
相关函数含义
rc4、sm3、sm4 三个函数入参都是三个
分别是
参数1、加解密文本
参数2、密钥
参数3、加解密标识 其中0 代表加密 1 代表解密
sm4_ex() 函数却别与rc4 、sm3、sm4 包含四个入参
参数1、加解密文本
参数2、密钥
参数3、加解密标识 其中0 代表加密 1 代表解密
参数4、填充模式。
1）填充模式选1, 数据按16字节倍数强制填充，缺m个字节则填充m个字节的m值(m最大值为16)。
2）填充模式选0，数据按16字节倍数非强制填充0x0, 同sm4。
函数使用示例
-- 1. sm3()函数
select sm3('123456abcdef');
-- 2. sm4()函数/rc4()函数
-- 加密：
select sm4('123456abcdef','0123456789ABCDEF',0);
select rc4('123456abcdef','0123456789ABCDEF',0);
-- 解密
select sm4(sm4('123456abcdef','0123456789ABCDEF',0), '0123456789ABCDEF',1);
select rc4(rc4('123456abcdef','0123456789ABCDEF',0), '0123456789ABCDEF',1);
-- 3. sm4_ex()函数(rc4函数没有ex函数扩展)
-- 1）填充模式选1
-- 加密：
select sm4_ex('123456abcdef','0123456789ABCDEF',0,1);
-- 解密
select sm4_ex(sm4_ex('123456abcdef','0123456789ABCDEF',0,1), '0123456789ABCDEF',1,1);
-- 2) 填充模式选0
-- 加密
select sm4_ex('123456abcdef','0123456789ABCDEF',0,0);
-- 解密
select sm4_ex(sm4_ex('123456abcdef','0123456789ABCDEF',0,0), '0123456789ABCDEF',1,0);
注意事项：
加解密函数的返回是二进制，所以不同bytes 格式返回的结果显示存在差异
可以通过调整参数set bytea_output to escape; 来进行设置。默认值时hex
hex：
"hex"格式将二进制数据编码为每字节2位十六进制数字， 最重要的四位（半字节）放在开始。整条字符串以\x开始 （与转义格式相区别）
escape：
"escape"格式是一种传统的 PostgreSQL格式。它采用以ASCII字符序列来表示二进制串的方法， 同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列
