更新记录

1.1.0(2021-06-02)

优化了加密的方法调用。

1.0(2020-06-04)


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 14

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


RSA 客户端加解密插件使用文档

  • 如果你的APP 有敏感数据要传送,可以使用 RSA 非对称加密法,目前是世界上公认的最安全的加密法之一。
  • 如果你嫌 JS 版本的RSA加密效率差,可以试试这个原生版的加密法。

    一、 方法介绍

方法名称 说明
publicKeyEncodeRSA 公钥加密
privateKeyDecodeRSA 私钥解密
privateKeyEncodeRSA 私钥加密
publicKeyDecodeRSA 公钥解密
getAESKey 随机生成AES 密钥,也可以自定义,16/24/31位字符串密钥
encodeAES AES 加密
decodeAES AES 解密

二、生成对非称加密,密钥工具,

支付宝生成密钥工具:https://opendocs.alipay.com/open/291/105971/

  • 获得 公钥,私钥后,就可以在客户端和服务器端加解密了。

三、使用前引放插件

const plug=uni.requireNativePlugin("Html5app-encryptionRas");

四、 RAS 加解密, RAS 使用的是非对称加解密,公钥加密私钥解密, 私钥加密公钥解密.

  • 1.公钥加密
    plug.publicKeyEncodeRSA({context:txt,publicKey:publicKey},ret=>
    {
         console.log("使用公钥加密后:"+JSON.stringify(ret));
    });
  • 参数说明: context => 需要加密的文明字符串, publicKey => 使用公钥加密。
  • 返回结果
{
"msg":"公钥加密后的字符串",
"sing":"NekGz/I5ylw2c2Tz2qBofIx1M3/OwUcpqw0XDFbrwKzlsz9o44ImRNQuC7JE7g==",
"code":0
}
  • 2.私钥解密
 plug.privateKeyDecodeRSA({sing:sing,privateKey:privateKey},ret=>
              {
                    console.log("使用私钥解密后:"+JSON.stringify(ret));

              });
  • 参数说明: sing => 需要解密的字符串, privateKey => 使用私钥解密。

  • 返回结果

    {
    "msg":"私钥解密后的字符串",
    "context":"我是重新的数据哦",
    "code":0
    }
  • 3.私钥加密

  plug.privateKeyEncodeRSA({context:txt,privateKey:privateKey},ret=>
  {
                    console.log("使用私钥加密后:"+JSON.stringify(ret));
  }); 
  • 参数说明: context => 需要加密的文明字符串,privateKey => 使用私钥加密。
  • 返回结果
{
"msg":"私钥加密后的字符串",
"sing":"NekGz/I5ylw2c2Tz2qBofIx1M3/OwUcpqw0XDFbrwKzlsz9o44ImRNQuC7JE7g==",
"code":0
}
  • 4.公钥解密
  plug.publicKeyDecodeRSA({sing:sing,publicKey:publicKey},ret=>
  {
                    console.log("使用公钥解密后:"+JSON.stringify(ret));
  });  
  • 参数说明: sing => 需要解密的字符串, publicKey} => 使用公钥解密。
  • 返回结果
    {
    "msg":"公钥解密后的字符串",
    "context":"我是重新的数据哦",
    "code":0
    }

五、AES 加解密,AES 是对称加解密方式。

  • 1.获取随机生成的AES 密钥. 也可以自己自定义密钥字符串只要长度是 16/24/32位既可。
 plug.getAESKey({len:16},ret=>
{
    console.log("生成AES 密钥:"+JSON.stringify(ret));
});  
  • 参数说明: len => 生成的AES 密钥长,只有 16/24/32位.
  • 返回结果
{"msg":"生成AEC随机KEY","key":"N9Io3rrctJyV8IaUqSLREyTV","code":0}
  • 2.AES 加密
  plug.encodeAES({context:"我是重新的数据哦",key:"3o7eH777z4xQRuupVNzgJS8K"},ret=>
{
                console.log("AES 加密后:"+JSON.stringify(ret));
}); 
  • 参数说明: context => 需要加密的字符串,key => AES 密钥
  • 返回结果
{"msg":"AES加密后字符串","sing":"WAuSV7QjU7eBwk7aTpRY+AO7uPftdv4XCdmzg3KsXZk=","code":0}
  • 3.AES 解密
plug.decodeAES({sing:sing,key:"3o7eH777z4xQRuupVNzgJS8K"},ret=>
{
            console.log("AES 解密后:"+JSON.stringify(ret));
}); 
  • 参数说明: sing => 需要解密的字符串,key => AES 密钥
  • 返回结果
{"msg":"AES解密后字符串","context":"我是重新的数据哦","code":0}

六、服务器端加密解参考。

  • RAS服务器端加解密,根据后台服务端语言,可以在网上搜索到相关的RAS 加解密方法的例子。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问