# 前言
最近老闆要我開發一個商城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)

原作者：晚上吃啥</userdetectresponse></boolean>

詳細例項教程！整合華為虛假使用者檢測，防範虛假惡意流量

相關文章