更新记录
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
查看更多平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.98,Android:5.0,iOS:9 | × | × | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
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