1、拷贝.so文件在Android Stuido中打开项目,将解压文件夹下armeabi-v7a 和x86 中的.so 文件到项目jniLibs对应的文件夹中,若没有jniLibs文件请自行创建,如下图
2、拷贝.aar文件将解压包中的KiwiWBSDK.aar文件到项目的libs文件中,如下图:
3、配置build.gradle文件在Android Studio中打开build.gradle文件,在android节点下的defaultConfig中 配置 ndk引用armeabi-v7a 和 x86文件的路径,在repositories中配置libs;以及在dependencies节点下配置 .aar 文件的引用,配置代码如下图: 配置代码如下
4、配置截图如下:
5、导入SDK包在项目中添加下面的代码,导入密钥白盒SDK包import com.kiwisec.whitebox.KiwiWBSDK;
6、调用加解密函数(1)函数描述:调用SDK提供的加密、解密算法,无需提供密囊枣荷罢钥key信息,无需担心密钥泄露问题。(2)加密函数:public static byte[] encrypt(int keyType, String input)public static byte[] encrypt(int keyType, byte[] input)(3)解密函数:public static byte[] decrypt(int keyType, byte[] input)(4)参数说明input:待加密数据,String或byte数据类型keyType:由算法类型和算法模式经过或运用所得,不支持算命模式则为算法类型(5)支持算法类型AES、BLOWFISH、CAMELLIA、CAST128、CAST256、DES、DESX、GOST、MISTY1、RC4、RC5、SAFERK64、SEED、SKIPJACK、TDES、TWOFISH、XTEA、XXTEA、SM4、BASE64(6) 支持算法模式ECB、CBC、CFB、OFB、CTR,其中SM4暂仅支持ECB和CBC模式,RC4、RC5为序列算法和BASE64不支持算法模式(7) 返回数据加密或解密后的数据(8) 代码实例AES算法使用代码如下:KiwiWBSDK.encrypt(KiwiWBSDK.CRYPT_AES, input)//默认为ECB模式KiwiWBSDK.encrypt(KiwiWBSDK.CRYPT_AES|KiwiWBSDK.CRYPT_CBC, input)KiwiWBSDK.encrypt(KiwiWBSDK.CRYPT_AES|KiwiWBSDK.CRYPT_CFB, input)KiwiWBSDK.encrypt(KiwiWBSDK.CRYPT_AES|KiwiWBSDK.CRYPT_OFB, input)KiwiWBSDK.encrypt(KiwiWBSDK.CRYPT_AES|KiwiWBSDK.CRYPT_CTR, input)(9)白盒密钥偏移量IV说明在CBC,OFB,CFB,CTR,PCPB加密模式下,必须提供偏移量IV,白盒密钥的偏移IV会根据Key(密钥)与加密的BlockSize(块大小)生成。(10)生成原理第一种情况:Key长度大于BlockSize【目前自动生成的密钥都是这种情况】,从Key中截取长度为BlockSize长度的字符并倒序处理 例如:iv = Key.subString(0,BlockSize);//iv=g04SCvsa4dYxdGjumode_iv = ujGdxYd4asvCS40g第二种情况:Key长度小于BlockSize【自定义的密钥可能存在】,使用PKCS5Padding方式进行填充,填充BlockSize - Key.length个字符,并倒序处理
7、调用加签函数(1)函数描述网络数据在传输过程中存在被篡改或伪装的攻击,通过对数据进行加签操作,便于数据接收端检验数据的有效性(2)数据加签函数public static byt髫潋啜缅e[] sign(int signType, byte[] input)public static byte[] sign(int signType, String input)(3)参数说明Input:待加签的数据,String或byte数据类型signType摘要算法:MD5、SHA_224、SHA_256、SHA_384、SHA_512、HMAC_SHA224、HMAC_SHA256、HMAC_SHA384、HMAC_SHA512、SM3、HMAC_SM3(4)返回数据加签后的摘要数据(5)代码实例例如MD5摘要计算代码如下:KiwiWBSDK.sign(KiwiWBSDK.CRYPT_MD5, input)
8、调用验签函数(1)函数描述网络数据在传输过程中存在被篡改或伪装的攻击,通过对接收到的数据进行验签操作,确认数据的有效性数据验签函数:public static boolean 即枢潋雳verify(int signType, String input, String signInfo)public static boolean verify(int signType, byte[] input, String signInfo)(2)参数说明Input:待验签的数据,String或byte数据类型signType验签算法:MD5、SHA_224、SHA_256、SHA_384、SHA_512、HMAC_SHA224、HMAC_SHA256、HMAC_SHA384、HMAC_SHA512、SM3、HMAC_SM3(3)返回数据验签后的摘要数据(4)代码实例例如MD5验签计算代码如下:KiwiWBSDK.verify(KiwiWBSDK.CRYPT_MD5, inputString, sigInfo)