接入只需4步
具体步骤
Step 1:获取AppId、AppSecret;
前往顶象管理后台,在实时风险决策的二级菜单“应用管理”中获取;
PS:未开通服务的,需要先申请开通服务。
Step 2:前端接入,即设备指纹埋点;
支持Web接入,支持IE8+、Chrome、Firefox、360浏览器、QQ浏览器等主流浏览器及Android、iOS上的内嵌Webview。
PS:提示:设备指纹token具有时效性,超过一定时间会过期,请勿自行缓存
重要:因终端用户的设备网络环境和设备版本等因素,设备指纹采集率并不能一定达到100%,可能会存在极少部分未能正常采集到的情况。
所以在集成指纹服务的时候,请尽量避免对指纹信息强依赖。
复制代码
1. web接入
1.1 环境要求
兼容IE8+,Chrome,Firefox,360浏览器,QQ浏览器等主流浏览器。
1.2 引入JS
在页面 HTML 中引入const-id.js,代码如下:
<script src="https://cdn.dingxiang-inc.com/ctu-group/constid-js/index.js"></script>
复制代码
1.3 生成token
页面加载后,初始使用,需要在 JavaScript 中调用_dx.ConstID(options, callback)方法,生成token,代码形如:
var options = {
appId: '【这里填写 AppId】', // 唯一标识,必填
server: 'https://constid.dingxiang-inc.com/udid/c1', // ConstId 服务接口,可选
userId: '【这里填写 userID】' // 用户标识,可选
};
_dx.ConstID(options, function (e, id) {
if (e) {
// console.log('error: ' + e);
return;
}
// console.log('token is ' + id);
// console.log(_dx.constID === id); // true
});
复制代码
执行成功后,页面中将会有一个全局变量_dx,可以通过_dx.constID访问这个值。也可以继续调用上面的初始化方法,同一个浏览器多次初始化返回的值相同。
options 字段说明
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
AppId | String | 是 | 当前应用的标识,需要联系工作人员获取 |
server | String | 否 | 服务接口,可选,如不填,则默认会用云服务接口 |
scene | String | 否 | 场景标识,例如login、survey等 |
userId | String | 否 | 业务方的用户唯一标识,例如用户名、用户ID、手机号、Email等 |
2. Android接入
2.1 环境要求
条目 | 说明 |
---|---|
开发目标 | Android 4.0+ |
开发环境 | Android Studio 3.0.1 或者 Eclipse + ADT |
CPU架构 | ARM 或者 x86 |
SDK三方依赖 | 无 |
2.2 集成SDK
2.2.1 下载SDK
点击下载demo(仅做代码配置演示使用,其中appId请在顶象后台申请,SDK需要替换为链接中下载的SDK)
2.2.2 Android Studio
集成SDK包集成内容:
- libs文件夹下的jar和so
- assets文件夹下的配置文件
把libs下jar和so库放到相应模块的libs目录下,assets下的文件放置到项目assets下
在该Module的build.gradle中如下配置:
android{
sourceSets {
main {
jniLibs.srcDirs = ['libs']
assets.srcDirs = ['assets']
}
}
packagingOptions {
doNotStrip "**/libDX*.so"
}
}
repositories{
flatDir{
dirs 'libs'
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation files('libs/dx-risk-x.x.x.jar')
}
复制代码
2.2.3 添加SDK所需权限
<!-- 必选-默认申请 -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission