更新记录

1.0.2（2024-03-26）

1、增加动态口令验证 2、升级至深信服SDK2.4.9.1_0223

1.0.1（2024-03-24）

解决BUG，升级至深信服SDK2.3.10.1_0815

1.0.0（2024-03-24）

插件发布1.0.0

平台兼容性

sanfor-atrust

插件说明

        本插件支持 uni-app 和 uni-app x 项目，uni-app x 的uts语法上有细微的区别。请先下载示例(uni-app)项目进行学习、试用，使用 HBuilderX 导入示例项目后，点击插件页面“试用”按钮引入插件,打包自定义基座就可以进行使用了。深信服SDK仅支持armeabi-v7a架构, arm64-v8a架构模拟器, 不支持X86架构模拟器,建议在真机环境下运行调试。

获取插件对象

import * as aTrustVPN from "@/uni_modules/sanfor-atrust";

初始化

created() {
    this.initSDK();//SDK初始化，并设置监听
},
methods: {
    initSDK(){
        aTrustVPN.initSDK()
    },
}

设置SPA安全码

data() {
    return {   
        mSpa:'安全码',
        mVpnAddress: 'https://IP:端口/',
        phoneNumber: '86-185xxxxxx8626@sms',
        mUserName: '账号',
        mUserPassword: '密码',
        smsCode:'',
    }
},
methods: {
    setSpa() {
        if(!aTrustVPN.isSpaSeedExist(this.mVpnAddress)){
            const config={"loginAddress":this.mVpnAddress, "spaSecret":this.mSpa}
            aTrustVPN.setSpaConfig(JSON.stringify(config), result => {
                console.log('前端接收结果',result)
                uni.hideLoading();
                uni.showModal({
                    title: '提示',
                    content: result.message,
                    showCancel:false
                });

            })
        }else{
            //已经登陆
            uni.showToast({
                title: 'SPA已设置！',
                duration: 2000
            });
        }
    },
}

VPN账号主认证

loginVPN() {
    if(this.getAuthStatus()!="SFAuthStatusAuthOk"){
        aTrustVPN.startPasswordAuth(this.mVpnAddress,this.mUserName,this.mUserPassword, result => {
            if(result.message=='AUTH_TYPE_SMS'){
                //需要短信二次辅助认证时，IOS的图型验证码可能不会隐藏，需要弹出窗口输入短信验证码进行验证
                uni.showModal({
                    title: '提示',
                    content: '处理二次认证-短信认证',
                    editable:true,
                    placeholderText:'请输入短信验证码',
                    success: function (res) {
                        if (res.confirm) {
                            console.log('用户点击确定',res.content);
                            //短信验证
                            aTrustVPN.doSecondaryAuth({
                                code: res.content
                            }, result => {
                                uni.showModal({
                                    title: '提示',
                                    content: result.message,
                                    showCancel:false
                                });
                            })

                        } else if (res.cancel) {
                            console.log('用户点击取消');
                        }
                    }
                });
            }else if(result.message=='AUTH_TYPE_TOKEN'){
                //需要短信二次辅助认证时，IOS的图型验证码可能不会隐藏，需要弹出窗口输入短信验证码进行验证
                uni.showModal({
                    title: '提示',
                    content: '处理二次认证-令牌认证',
                    editable:true,
                    placeholderText:'请输入令牌动态口令',
                    success: function (res) {
                        if (res.confirm) {
                            console.log('用户点击确定',res.content);
                            //短信验证
                            aTrustVPN.doSecondaryAuth({
                                code: res.content
                            }, result => {
                                uni.showModal({
                                    title: '提示',
                                    content: result.message,
                                    showCancel:false
                                });
                            })

                        } else if (res.cancel) {
                            console.log('用户点击取消');
                        }
                    }
                });
            }else{
                uni.showModal({
                    title: '提示',
                    content: result.message,
                    showCancel:false
                });
            }
        })
    }else{
        //已经登陆
        uni.showToast({
            title: 'VPN已认证！',
            duration: 2000
        });
    }
}

短信主验证

loginSMS() {
    if(this.getAuthStatus()!="SFAuthStatusAuthOk"){
        uni.showLoading({
            title:'VPN正在认证，请稍候...'
        })
        aTrustVPN.startPrimarySmsAuth(this.mVpnAddress,this.phoneNumber, result => {
            uni.hideLoading();
            uni.showModal({
                title: '提示',
                content: result.message,
                showCancel:false
            });
            console.log(result)
        })
    }else{
        //已经登陆
        uni.showToast({
            title: 'VPN已认证！',
            duration: 2000
        });
    }
},

免密登陆

loginAutoTicket() {
    //自动免密上线接口，该接口可以实现免密认证。
    if(this.getAuthStatus()!="SFAuthStatusAuthOk"){
        // console.log("startAutoTicket");
        //Android  true代表免密调用成功，false代表免密调用失败。
        //IOS  YES代表免密调用成功，NO代表免密调用失败
        let res=aTrustVPN.startAutoTicket();
        console.log(res);
        uni.showModal({
            title: '提示',
            content: ''+res,
            showCancel:false
        });
        return res;
    }else{
        //已经登陆
        uni.showToast({
            title: 'VPN已认证！',
            duration: 2000
        });
    }
}

重新获取短信验证码

regetSmsCode() {
    aTrustVPN.regetSmsCode({},result => {
        uni.showModal({
            title: '提示',
            content: result.message,
            showCancel:false
        });
         console.log(result)
    })
}

获取登陆状态

getAuthStatus() {
    // case 0:
    //  return SFAuthStatusNone;
    // case 1:
    //  return SFAuthStatusLogining;
    // case 2:
    //  return SFAuthStatusPrimaryAuthOK;
    // case 3:
    //  return SFAuthStatusAuthOk;//已登陆
    // case 4:
    //  return SFAuthStatusLogouting;
    // case 5:
    //  return SFAuthStatusLogouted;//已经注销（登出）
    let res = aTrustVPN.getAuthStatus();
    console.log(res);
    return res;
},

登出、注销

logoutVPN() {
    if(this.getAuthStatus()=="SFAuthStatusAuthOk"){
        uni.showLoading({
            title:'正在注销，请稍候...'
        })
        aTrustVPN.logout(result => {
            uni.hideLoading();
            uni.showModal({
                title: '提示',
                content: result.message,
                showCancel:false
            });
             console.log(result)
        })
    }else{
        //已经登陆
        uni.showToast({
            title: 'VPN未登陆！',
            duration: 2000
        });
    }   
}

常见问题原因排查

        常见错误码信息请查阅：https://bbs.sangfor.com.cn/atrustdeveloper/appsdk/android/error.html