Fraud Detection:Android 向け Fraud Detection SDK の統合

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• Android 4.0.3 以降を対象とする Android アプリ（minSdkVersion は 15 以上に設定）

• Alibaba Cloud 公式ウェブサイトで公開されている最新版 SDK（プライバシーに関するコンプライアンス要件を満たすために必須）

• Fraud Detection SDK プライバシーポリシー

権限

SDK では、1 つの必須権限と、いくつかの任意権限が必要です。検出精度を向上させるため、SDK の初期化前に任意権限を付与してください。

SDK のダウンロードと構成

1. Android SDK パッケージをダウンロードし、解凍します。パッケージは標準の .aar（Android Archive）ファイルです。

2. .aar ファイルをプロジェクトの libs ディレクトリにコピーします。

3. アプリの build.gradle ファイルに、以下の依存関係を追加します。

   // Device Fraud Detection SDK
   implementation files('libs/Android-AliyunDevice-<version>.aar')
   
   // 必須のネットワークライブラリ依存関係
   implementation 'com.squareup.okhttp3:okhttp:3.11.0'
   implementation 'com.squareup.okio:okio:1.14.0'

   重要

   ネットワークライブラリの依存関係を追加してください。これらの依存関係がないと、SDK がインターネットに接続できなくなります。

データの収集

ユーザーからのプライバシー同意を取得した後、アプリのライフサイクルのできるだけ早い段階（理想的には Application.onCreate() 内）で、initWithOptions を呼び出します。SDK は収集されたデバイス信号を用いてデバイストークンを生成します。

アカウント登録、ログイン、キャンペーン参加など、デバイスレベルの詐欺信号が特に重要となるリスクに敏感なエントリポイントで、この関数を呼び出してください。

public interface SecurityInitListener {
    // code：データ収集の成功／失敗を示すステータスコード
    void onInitFinish(int code);
}

public void initWithOptions(
    Context ctx,
    String appKey,
    Map<String, String> options,
    SecurityInitListener securityInitListener
);

デバイストークンの取得

initWithOptions の呼び出し後、少なくとも 2 秒待ってから、バックグラウンドスレッドから getDevicetoken を呼び出してデバイストークンを取得します。取得したトークンをアプリケーションサーバーに送信し、サーバー側で Device Fraud Detection API を呼び出してデバイスのリスク情報を照会します。

public class Securitytoken {
    // トークン取得の成功／失敗を示すステータスコード
    public int code;

    // サーバー側でリスク判定結果を照会する際に使用するトークン文字列
    public String token;
}

public Securitytoken getDevicetoken();

サンプルコード

以下の例では、Application.onCreate() でデータ収集を初期化し、ユーザー登録やキャンペーン参加などのリスクに敏感なイベント発生時にバックグラウンドスレッドからデバイストークンを取得する、完全な統合手順を示します。

Java

public class CustomApplication extends Application {
    // Fraud Detection コンソールの Device APP 管理タブから取得した appKey
    private static final String ALIYUN_APPKEY = "xxxx";

    @Override
    public void onCreate() {
        super.onCreate();

        // プライバシー要件を満たすため、非リセット可能なデバイス識別子を除外。
        // 複数の DataType 値は | で区切ります。
        Map<String, String> options = new HashMap<>();
        options.put("DataType", "NO_IDENTIFY_DEVICE_DATA");

        // プライバシー同意を取得した直後に、できるだけ早期に initWithOptions を呼び出します。
        SecurityDevice.getInstance().initWithOptions(this, ALIYUN_APPKEY, options, null);
    }
}

アプリの初期化後、リスクに敏感なイベント発生時にバックグラウンドスレッドからデバイストークンを取得します。initWithOptions の呼び出し後、getDevicetoken を呼び出すまでに少なくとも 2 秒待ってください。

new Thread() {
    @Override
    public void run() {
        Securitytoken st = SecurityDevice.getInstance().getDevicetoken();
        if (st != null) {
            if (SecurityCode.SC_SUCCESS == st.code) {
                Log.d("AliyunDevice", "token: " + st.token);

                // トークンをアプリケーションサーバーに送信します。
                // サーバーはこのトークンを用いて Device Fraud Detection API を呼び出します。
                // sendToAppServer(st.token);
            } else {
                Log.e("AliyunDevice", "getDevicetoken エラー、コード: " + st.code);
            }
        } else {
            Log.e("AliyunDevice", "getDevicetoken が null を返しました。");
        }
    }
}.start();

Kotlin

class CustomApplication : Application() {
    // Fraud Detection コンソールの Device APP 管理タブから取得した appKey
    private val ALIYUN_APPKEY = "xxxx"

    override fun onCreate() {
        super.onCreate()

        // プライバシー要件を満たすため、非リセット可能なデバイス識別子を除外。
        val options = HashMap<String, String>()
        options["DataType"] = "NO_IDENTIFY_DEVICE_DATA"

        // プライバシー同意を取得した直後に、できるだけ早期に initWithOptions を呼び出します。
        SecurityDevice.getInstance().initWithOptions(this, ALIYUN_APPKEY, options, null)
    }
}

コルーチンディスパッチャーを使用してバックグラウンドスレッドからデバイストークンを取得します。initWithOptions の呼び出し後、getDevicetoken を呼び出すまでに少なくとも 2 秒待ってください。

// メインスレッドをブロックしないよう Dispatchers.IO を使用（ANR エラーを防止）
CoroutineScope(Dispatchers.IO).launch {
    val st = SecurityDevice.getInstance().getDevicetoken()
    if (st != null) {
        if (SecurityCode.SC_SUCCESS == st.code) {
            Log.d("AliyunDevice", "token: ${st.token}")

            // トークンをアプリケーションサーバーに送信します。
            // サーバーはこのトークンを用いて Device Fraud Detection API を呼び出します。
            // sendToAppServer(st.token)
        } else {
            Log.e("AliyunDevice", "getDevicetoken エラー、コード: ${st.code}")
        }
    } else {
        Log.e("AliyunDevice", "getDevicetoken が null を返しました。")
    }
}

難読化

SDK が難読化されないように、ProGuard 構成に以下のルールを追加してください。

-keep class net.security.device.api.** {*;}
-dontwarn net.security.device.api.**

ステータスコード

Device Fraud Detection API の呼び出し

アプリケーションサーバーがデバイストークンを受信した後、そのトークンとその他のイベントパラメーターを用いて Device Fraud Detection API を呼び出し、デバイスのリスク判定結果を取得します。

リクエストおよびレスポンスパラメーターの全一覧については、「Device Fraud Detection のサービスイベントパラメーターおよびレスポンスパラメーター」をご参照ください。

よくある質問

SDK がサポートする CPU アーキテクチャは何ですか？

SDK は ARM、ARMv7、ARM64 アーキテクチャをサポートしています。

SDK パッケージのサイズはどのくらいですか？

単一アーキテクチャの共有オブジェクト（SO）ファイルは約 1.8 MB です。パッケージが大きい理由は、リバースエンジニアリング防止および通信中のデータ保護のため、難読化、膨張、暗号操作が含まれているためです。

デバイストークンの有効期間はどれくらいですか？再利用できますか？

デバイストークンの有効期間は 7 日間です。この期間内であれば、複数回のサーバー側 API 呼び出しで同じトークンを再利用できます。