# 前言
最近老板要我开发一个商城App，**在注册登录环节过滤掉虚假用户，减少这些恶意流量对App运营的影响**。偶然想起来，在今年的华为开发者大会上了解到虚假用户检测功能，于是准备试试集成在我们的App上。集成后发现效果还真不错，不仅对虚假用户识别率高，而且目前这项功能是免费开放的。老板再也不用担心之前的**虚假用户撞库、恶意刷帖、薅羊毛**等问题了。

今天简单总结了一下我开发过程的教程，分享给大家！

# 官网的Demo和Sample代码体验
华为官网上有实例代码可以直接下下来看，除了虚假用户检测（UserDetect），还有其他4个功能的示例代码，都是支持Java和Kotlin两种开发语言的：[华为官网的示例代码Java/Kotlin](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Examples-V5/sample-code-0000001050157020-V5?ha_source=hms1)，下载下来以后，根据官网页面的提示说明，改一下包名就可以运行。

我自己写的简易sample，朋友们感兴趣也可以下下来参考。

[商城App集成安全检测 sample示例](https://github.com/huaweicodelabs/PetStore)

## 1 开发前准备
### 1.1 Android studio安装
开发工具还没有装的小伙伴可以先自己下载一下：
Android studio官网下载：[https://developer.android.com/studio?ha_source=hms1](https://developer.android.com/studio?ha_source=hms1) 
Android studio安装教程：[https://www.cnblogs.com/xiadewang/p/7820377.html](https://www.cnblogs.com/xiadewang/p/7820377.html)

### 1.2 在AppGallery Connect中配置相关信息
在开发应用前，需要在AppGallery Connect中配置相关信息。[具体操作步骤](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides-V5/config-agc-0000001050416303-V5?ha_source=hms1)

### 1.3 配置华为maven仓地址
打开Android Studio项目级“build.gradle”文件：

![在这里插入图片描述](https://img-blog.csdnimg.cn/20210208102950917.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

添加HUAWEI agcp插件以及Maven代码库：
- 在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
- 在“allprojects > repositories”中配置HMS Core SDK的Maven仓地址。
- 如果App中添加了“agconnect-services.json”文件则需要在“buildscript > dependencies”中增加agcp配置。

```java
buildscript {
    repositories {
        google()
        jcenter()
        // 配置HMS Core SDK的Maven仓地址。
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        // 增加agcp配置。
        classpath 'com.huawei.agconnect:agcp:1.4.2.300'
    }
}
 
allprojects {
    repositories {
        google()
        jcenter()
        // 配置HMS Core SDK的Maven仓地址。
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
```

这里需要说明的是，Maven仓地址无法直接在浏览器中打开访问，只能在IDE中配置。需要添加多个Maven代码库的话，将华为公司的Maven仓地址配置在最后哦。

### 1.4 添加编译依赖

打开应用级的“build.gradle”文件：

![在这里插入图片描述](https://img-blog.csdnimg.cn/20210208103610771.jpg#pic_center)

在文件头 **apply plugin: 'com.android.application'** 下一行添加如下配置：

```java
apply plugin: 'com.huawei.agconnect'
```

在“dependencies”中添加如下编译依赖：

```java
dependencies {
    implementation 'com.huawei.hms:safetydetect:5.0.5.301'
}
```

### 1.5 配置混淆脚本
如果你自己开发时要用到AndResGuard，那就还需要在应用级的“build.gradle”文件中加入AndResGuard允许清单，代码可以参考[官网的混淆配置](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides-V5/config-obfuscation-scripts-0000001055268435-V5?ha_source=hms1)。

## 2 代码开发
### 2.1 创建SafetyDetectClient

```java
// 替换成自己的 activity 或者 context作为参数.
SafetyDetectClient client = SafetyDetect.getClient(MainActivity.this);
```

### 2.2初始化虚假用户行为检测

在使用该能力前，需要先通过initUserDetect接口完成初始化工作。我在商城App的LoginAct.java类的onResume方法里来调用初始化接口，示例代码如下：

```java
@Override
protected void onResume() {
    super.onResume();
 
    // 初始化虚假用户检测API
    SafetyDetect.getClient(this).initUserDetect();
}
```

### 2.3 发起检测请求
 我设计的是在商城App用户登录阶段进行虚假用户检测的，一般检测请求也可以设计在抢购、抽奖等环节。

先在LoginAct.java中的onLogin方法中，调用SafetyDetectUtil的callUserDetect方法来发起检测。我具体的业务逻辑：**商场App在判断用户名和密码是否正确之前发起虚假用户检测，然后通过回调方法来获取检测结果，并做相应的处理。若检测结果为真实用户，则允许该用户登录，否则不允许其登录操作**：

```java
private void onLogin() {
    final String name = ...
    final String password = ...
    new Thread(new Runnable() {
        @Override
        public void run() {
// 调用经过封装后的虚假用户检测接口，此处需要传入当前的Activity或上下文并添加回调处理
            SafetyDetectUtil.callUserDetect(LoginAct.this, new ICallBack<Boolean>() {
                @Override
                public void onSuccess(Boolean userVerified) {
                    // 虚假用户检测成功                   
                    if (userVerified){
                        // 检测结果为成功，继续登录
                        loginWithLocalUser(name, password);
                    } else {
                        // 检测结果为失败，登录失败
                        ToastUtil.getInstance().showShort(LoginAct.this, R.string.toast_userdetect_error);
                    }
                }
            });
        }
    }).start();
}
```

SafetyDetectUtil.java中的callUserDetect方法封装了虚假用户检测中的关键流程，如APP ID的获取、responseToken的获取以及向App Server发送responseToken等，详见：

```java
public static void callUserDetect(final Activity activity, final ICallBack<? super Boolean> callBack) {
    Log.i(TAG, "User detection start.");
    // 从app目录下的agconnect-services.json文件中读取app_id字段
    String appid = AGConnectServicesConfig.fromContext(activity).getString("client/app_id");
    // 调用虚假用户检测 API，并添加回调来做后续的异步处理
    SafetyDetect.getClient(activity)
        .userDetection(appid)
        .addOnSuccessListener(new OnSuccessListener<UserDetectResponse>() {
            @Override
            public void onSuccess(UserDetectResponse userDetectResponse) {
                // 虚假用户检测成功，通过 getResponseToken 方法来获取responseToken
                String responseToken =userDetectResponse.getResponseToken();
                // 将该responseToken发送到App Server
                boolean verifyResult = verifyUserRisks(activity, responseToken);
                callBack.onSuccess(verifyResult);
                Log.i(TAG, "User detection onSuccess.");
            }
        })
}
```

到这里，responseToken就通过虚假用户检测API拿到啦。

### 2.4 获取检测结果
获得上述的responseToken后，提交至App服务端，再由App服务端发送到Safety Detect Server，调用[verify云侧接口](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References-V5/getresult-0000001051066312-V5?ha_source=hms1)获取结果。不过在中国大陆地区，由于User Detect不支持验证码二次验证，为了保证检测同样准确有效，调用的是[nocaptcha云侧接口](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References-V5/result-0000001058290700-V5?ha_source=hms1)来获取检测结果。

具体步骤：
a)  获取Access Token
打开AppGallery Connect网站 - “我的应用” - “HMSPetStoreApp” - “分发” - “应用信息”，可以查看SecretKey，如图：

![在这里插入图片描述](https://img-blog.csdnimg.cn/20210208140201573.png#pic_center)

然后使用SecretKey和APP ID请求华为认证服务获取Access Token，[获取方法参考](https://developer.huawei.com/consumer/cn/forum/topic/0201442113097620449?fid=18&pid=0301442113097620827)

b)  调用Safety Detect Server接口获取结果
根据上一步中获取到的Access Token，和之前获取到的responseToken，调用Safety Detect Server的检测结果查询接口，小伙伴戳这里参考[接口调用方法](https://developer.huawei.com/consumer/cn/forum/topic/0202442955206220496?fid=18)。

最后获取的检测结果，可以通过App Server直接返回给App。**True代表真实用户，False代表虚假用户，App可以根据自身业务场景来完成对应的防护处理。**

### 2.5 关闭虚假用户检测
小伙伴们记得用完以后关闭服务，释放资源哦。在App的LoginAct.java 类的onPause方法中调用关闭接口：

```java
@Override
protected void onPause() {
    super.onPause();
    // 关闭虚假用户检测API
    SafetyDetect.getClient(this).shutdownUserDetect();
}
```

# 结后语
整个代码开发过程就结束啦，保姆级教程，是不是超简单，给大家看下效果：
[Demo演示请戳此](https://developer.huawei.com/consumer/cn/forum/topic/0202445499791050552?fid=18)

### 附官方开发指南
[华为虚假用户检测开发指南](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/userdetect-0000001050154382#ZH-CN_TOPIC_0000001050154382__li151811171220?ha_source=hms1)

----
原文链接：[https://developer.huawei.com/consumer/cn/forum/topic/0202445499791050552?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0202445499791050552?fid=18)

原作者：晚上吃啥

ITPub博客

详细实例教程！集成华为虚假用户检测，防范虚假恶意流量

最新文章