DID身份系统，是一种基于区块链的数字身份体系，由唯一身份标识和相应的DID文件夹组成，允许第三方应用通过开发者平台完成注册，并获得接入者key及secret。DID集合实名认证、学位认证及更多的声明服务，几乎可以满足绝大部分的开发者业务需求。本篇文档主要介绍DID系统的SDK接口服务。
DID 三方登录授权
Andriod 登录授权
用于三方登录时，使用 DID 授权登录，获取 DID 信息及证书信息
调用授权示例代码，证书服务编码，请参考服务列表
DID 授权
/**
*@param context Activity 上下文
*@param userSecret平台秘钥
*@param serviceCode 证书编码 code 不需要授权证书仅登录类型 传空
*证书服务编码，请参考服务列表
*@param listener 回调监听
* */ DidAuthManager.requestAuth(
context, userSecret， serviceCode,
object : OnDidAuthListener {
/**
*@param code 返回错误码
*-1 用户取消授权
*10002//拒绝
*10003 //请求的正确不存在或审核不通过
*10004 //数据解析为空
*10005 //没有安装 DidApp
*10006 //userSecret 为空
*10007 //userSecret 不可用
* */
override fun onFail(code: Int) {
}
/**
*同意授权 成功回调
*@param data 授权返回数据
* */
override fun onSuccess(data: SignData) {
//返回数据参考【SignData 数据格式】
}
}
)
授权数据处理
SignData 数据格式
SDK 下载
didauthsdk-1.0.0.aar
IOS 登录授权
用于三方登录时，使用 DID 授权登录，获取 DID 信息及证书信息
注：注意修改info.plist 文件
·在LSApplicationQueriesSchemes 字段中添加白名单 vbhledger
·在URL types 中添加URL Scheme: vbhledger8888
DID 授权
[XIDAuthMob.sharedMob getAuthorizationForLogin];
DID 证书授权
[XIDAuthMob.sharedMob getAuthorization:@"serviceCode"];
授权数据处理
数据授权结果通过 XIDAuthMob.sharedMob.delegate 代理回调：
-(void)didAuthorizationFailure:(NSUInteger)code msg:(NSString *)msg{}
-(void)didAuthorizationForLogin:(XIDAuthResp *)resp{}
-(void)didAuthorizationForService:(XIDAuthCertResp *)resp{}
注：在 AppDelegate 中的代理方法中调用XIDAuthMob 例中相对于的方法来处理授权数据
-(BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options;
-(BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation;
例如：
-(BOOL)application:(UIApplication*)appopenURL:(NSURL*)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options{
if ([XIDAuthMob.sharedMob isVaildURL:url]) {
return [XIDAuthMob.sharedMob application:app openURL:url options:options];
}
return true;
}
SDK 下载
XIDSDK.framework_0.0.1.zip
签名数据核验
服务地址
https://sim-did-api.vbhledger.com/grant/verifySign
提交方式
POST
请求参数
响应参数
结语
结语
欢迎广大企业机构及个人开发者，成为VBH开发者中心会员，调用体验永旗DID系统。
VBH开发者中心会员注册链接：
https://con.vbhledger.com/login/index
下期预告：永旗版权链开发文档。
