更新记录

1.0.19（2024-05-10）

1.更新返回值的格式

1.0.18（2022-10-27）

1.更新依赖库

1.0.17（2022-10-09）

手机盾UNIAPP SDK集成说明文档

Android

2022-10-08

手机盾支持安卓12.

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

手机盾UNI-APP的SDK集成说明文档

手机盾签名认证系统是针对移动互联网设计的一种能够提供可信数字签名的产品。该系统在理论创新的基础上，依托于密钥分组、分布式数字签名的专利技术，
通过手机端与服务端独立存储密钥分量，双方协作签名，该系统能有效解决移动互联网中安全的数字签名的痛点，可以在用户端无需任何额外硬件介质的条件下，
为用户提供出安全合规的数字签名。

接口说明

1 导入控件

  const sccaDun = uni.requireNativePlugin("scca-dun_CAModule");

2 初始化控件 init

            参数名                            说明                                              数据类型
           compId                     公司账户ID，由四川CA分配                                    string
           secret                    手机盾密钥，由四川CA分配                                     string
          certAppId                  证书申请应用ID，由四川CA分配                                 string 
          appSecret                  证书申请应用密钥，由四川CA分配                                 string 
          certUrl                        证书申请应用地址                                        string 

        var init=sccaDun.init('100024','PGQdqtYwjLTvcMe5URVIU9DAQyOCGrnYMQnNJ',
                               'SCCA1762399254903484417','63b2ce117f93403191248732b1c39ca9',
                               'http://testmicrosrv.scca.com.cn:9647/certAPI/cert/enroll');

        console.log("初始化是否成功:" + init)

3 用户注册 register

            参数名                            说明                                              数据类型
           username                         用户名                                              string
           password                        登录密码                                             string
          comname                          企业名称                                             string 
          phone                            电话号码                                            string 
          email                            用户邮箱地址                                          string 
          successCallback                  执行成功回调函数                                      function 
          errorCallback                    执行失败回调函数                                      function 

 sccaDun.register("zj002",'123456','张三','18088888888','scca@sicca.com.cn',function (msg) {
               console.log("register:" + msg)
             },function (errorMsg) {
                 console.info("错误信息:" + errorMsg);
             })

4.证书查询 queryCert

           参数名                            说明                                              数据类型
          userName                         用户名                                             string
         successCallback               执行成功回调函数                                         function
         errorCallback                 执行失败回调函数                                         function 

       sccaDun.queryCert("zj002", function(msg) {
                    console.log("queryCert:" + msg)
                }, function(errorMsg) {
                    console.log("错误信息:" + errorMsg);
                })

5.证书申请 applyCert

           参数名                            说明                                              数据类型
          paperType              证件类型 值: 个人身份证书/企业                                  string
         commonName                 用户名称/企业名称                                           string
         phoneNumber                    电话号码                                              string
         organizationalName            组织机构名称                                            string
         paperNo                   证件号码/统一社会信用代码                                     string
         username                        用户名                                               string
         pin                           密钥pin码，数字                                         string 
         successCallback               执行成功回调函数                                         function 
         errorCallback                 执行失败回调函数                                         function 

         sccaDun.applyCert("个人身份证书", "张三", "18088888888", "", "510510510510510510", "zj002", "123456", function(msg) {
                    console.log("applyCert:" + msg)
                }, function(errorMsg) {
                    console.log("错误信息:" + errorMsg);
                })

6.证书申请 signP7

           参数名                            说明                                              数据类型   
         username                          用户名                                               string
         pin                            密钥pin码，数字                                         string 
         toSign                          待签名的原文                                           string 
         successCallback                执行成功回调函数                                         function 
         errorCallback                  执行失败回调函数                                         function 

        sccaDun.signP7("zj002", "123456", "hello", function(msg) {
                            //签名成功
                            console.log("signP7:" + msg)
                        }, function(errorMsg) {
                            console.log("错误信息:" + errorMsg);
                        })

7.查询本机密钥是否存在 checkKeypair

           参数名                            说明                                              数据类型   
         username                          用户名                                               string
         successCallback                执行成功回调函数                                         function 
         errorCallback                  执行失败回调函数                                         function 

        sccaDun.checkKeypair('zj002', function(msg) {
                    console.log("checkKeypair:" + msg)
                }, function(errorMsg) {     
                     console.log("错误信息:" + errorMsg);

                })

8. 用户是否注册 checkUserIsRegister

           参数名                            说明                                              数据类型
          userName                         用户名                                             string
         successCallback               执行成功回调函数,只返回0                                 function
         errorCallback                 执行失败回调函数                                        function 

        sccaDun.checkUserIsRegister(this.state.userName,(success)=>{
                         console.log("当前用户名没有注册");
                 },(errorCode,errorMsg)=>{
                        console.log("错误信息:" + errorMsg);
                 })

9. 查询版本号 getVersion

           参数名                            说明                                              数据类型
         successCallback               执行成功回调函数                                        function

        sccaDun.getVersion( function(msg) {
                    console.log("getVersion:" + msg)
                })

错误码

-1 未初始化手机盾 -101 SDK抓取异常

0x00000010 报文格式错误请求失败 0x00000011 数据长度错误 0x00000020 SM2 密钥生成错误 0x00000021 RSA 密钥生成错误 0x00000022 注册失败 0x00000030 SM2 签名错误 0x00000031 RSA 签名错误 0x00000032 SM4 加密错误 0x00000033 SM4 解密错误 0x00000040 SM2 数据验签错误 0x00000041 RSA 数据验签错误 0x00000045 获取公钥错误 0x00000050 验证 PIN 错误 0x00000051 更新 PIN 错误 0x00000057 证书已存在 0x00000058 更新用户证书信息失败 0x00000059 重新生成证书失败 0x00000060 证书生成错误 0x00000061 证书更新错误 0x00000062 证书注销错误 0x00000063 PFX 解析错误 0x00000064 更新证书状态失败 0x00000065 初始化 RA 失败 0x00000066 PFX 解析错误 0x00000067 证书延期失败 0x00000068 获取 p10 错误 0x00000069 p10 错误 0x0000006A 导入 p10 错误 0x00000070 非有效用户 0x00000071 用户被锁定 0x00000072 用户被冻结 0x00000073 验证 SecretKey 失败 0x00000074 流水号错误 0x00000081 数据库操作错误 0x00000082 更新缓存错误 0x00000091 企业暂不可用 0x00000092 SecretKey 错误 0x00000093 设备 ID 错误 0x00000101 Rsa 加密错误 0x00000102 Rsa 解密错误 0x00000103 Sm2 加密错误 0x00000104 Sm2 解密错误 0x00000107 ASN1 解析错误 0x00000108 解析证书错误 0x00000121 解析公钥错误 0x00000122 公钥类型错误 0x00000123 明文长度错误 0x00000124 签名长度错误 0x00000125 SM3 PRE 错误 0x00000130 第三方生成证书错误 0x00000131 第三方更新证书错误 0x00000132 第三方重新生成证书错误 0x00000133 第三方证书延期错误 0x00000134 第三方更新用户信息错误 0x00000135 第三方注销证书错误 0x00000136 第三方冻结证书错误 0x00000137 第三方解冻证书错误 0x00000138 第三方其他证书错误 0x00000139 第三方初始化错误 0x00000140 第三方证书参数错误 0x00000141 第三方证书恢复错误 0x00000145 第三方证书获取随机数错误 0x00000146 获取业务号错误 0x00000147 证书操作错误 0x00000201 不是有效企业 0x00000301 设备绑定数量错误 0x00000302 未配置单用户设备上线错误 0x00000401 配置文件错误 0x00000500 服务器内部错误 0x00000601 设备已绑定 0x00000602 设备匹配错误 0x00001000 对接 RA 错误 0X00100000 服务端返回为空或网络通讯异常 0X00110000 服务端返回报文解析异常 0X00200000 服务端返回的公钥为空 0X00210000 服务端返回的签名计算结果为空 0X00500000 管理接口返回为空或网络连接错误 0X00510000 管理接口返回格式错误 0X00520000 管理接口返回格式规范错误 0X00530000 管理接口返回格式规范错误 0X00300000 本地存储失败 0X00310000 本地解析数据失败 0X00320000 本地密钥不存在 0X00330000 密钥信息异常 0X00340000 本地验签失败 0X00400000 BASE64 解码失败 0X00410000 padding 补丁失败 0X00420000 undo_padding 解补丁失败 0X00430000 批量签名明文错误 0X00440000 客户端内容格式转换错误 0X00700000 RSA 公钥格式化失败 0X00710000 不支持的 hash 算法或 DN 项格式错误 0X00720000 数据杂凑值计算失败 0X00730000 P10 编码失败 0X00810000 SM2 加密失败 0X00820000 SM2 解密失败 1 0X00830000 SM2 解密失败 2 0X00840000 SM2 解密失败 3 0X00850000 SM2 签名失败 0X00860000 SM2 密钥失败 1 0X00870000 SM2 密钥失败 2 0X00880000 SM3 hash 失败 0X00890000 SM2 证书解析失败 0X008a0000 P7 合成失败 0X008b0000 P7 编码失败 0X008c0000 密钥转换失败 1 0X008d0000 密钥转换失败 2 0X008e0000 SM2 加密私钥解密失败 0X00910000 RSA 加密失败 0X00920000 RSA 解密失败 1 0X00930000 RSA 解密失败 2 0X00940000 RSA 解密失败 3 0X00950000 RSA 签名失败 1 0X00960000 RSA 签名失败 2 0X00970000 RSA 证书解析失败 0X00980000 P7 合成失败 0X00990000 P7 编码失败 0X009a0000 RSA 加密私钥解密失败 0X00a10000 对称解密失败 0X00a20000 不支持的对称加密算法类型 0X00a30000 不支持的对称加密模式 0X00b10000 证书数据格式转换错误 0X00b20000 证书数据为空 0X01000000 成功 0X02000000 用户不存在或密码错误 0X03000000 用户待审核 0X04000000 证书解析失败，获取证书信息失败 0X05000000 用户证书不存在 0X06000000 企业被冻结 0X07000000 用户被冻结 0X08000000 用户已存在 0X09000000 暂无密钥信息 0X14000000 暂无用户信息 0X15000000 传入的参数为空 0X16000000 类型错误 0X17000000 企业不存在 0X18000000 操作类型错误 0X19000000 旧密码输入错误 0X20000000 部分用户审核成功 0X21000000 审核失败 0X22000000 数据过多 0X23000000 页码和行数不是数字 0X24000000 指令输入有误 0X25000000 用户数量已达上限 0X26000000 获取 SecretKey 失败 0X27000000 操作数据库失败