Web Application Firewall:Android 向けアプリ保護 SDK の統合

5a. (オプション) ユーザー ID の設定

setAccount() を呼び出して、SDK リクエストにユーザー ID を関連付けます。これにより、WAF はユーザーレベルの保護ポリシーを適用できます。ユーザーがログインしていない場合は、この呼び出しをスキップし、代わりに init() を直接呼び出してください。

// Signature: int setAccount(String account)
// Returns: 0 on success, -1 on failure

final String account = "account"; // マスクされたユーザー ID を使用します
TigerTallyAPI.setAccount(account);

5b. SDK の初期化

アプリの起動時に init() を 1 回だけ呼び出してください。これにより、リスク分析に使用されるデバイス情報が 1 回だけ収集されます。

収集モードは 2 種類あります：

• DEFAULT： 機密フィールド (imei、imsi、simSerial、wifiMac、wifiList、bluetoothMac) を含むすべてのデバイスデータを収集します。対応する権限が必要です。ユーザーがアプリのプライバシーポリシーに同意した後に、このモードを使用してください。

• NOT_GRANTED： 機密フィールドをスキップします。ユーザーがプライバシーポリシーに同意する前に、このモードを使用してください。

// Signature: int init(Context context, String appkey, int type)
// Returns: 0 on success, -1 on failure

final String appkey = "your_appkey";

// 完全なデータ収集 (ユーザーがプライバシーポリシーに同意した後)
int ret = TigerTallyAPI.init(this.getApplicationContext(), appkey, TigerTallyAPI.CollectType.DEFAULT);

// 機密フィールドを除外 (ユーザーがプライバシーポリシーに同意する前)
int ret = TigerTallyAPI.init(this.getApplicationContext(), appkey, TigerTallyAPI.CollectType.NOT_GRANTED);

Log.d("AliSDK", "ret:" + ret);

5c. リクエストへの署名

送信する HTTP リクエストごとに、送信前に vmpSign() を呼び出してください。リクエストボディをバイト配列として渡します。GET リクエストまたは POST のボディが空の場合は、null または "".getBytes("UTF-8") を渡します。

// Signature: String vmpSign(int signType, byte[] input)
// Returns: wToken 署名文字列

String request_body = "i am the request body, encrypted or not!";
String wToken = null;
try {
    wToken = TigerTallyAPI.vmpSign(1, request_body.getBytes("UTF-8"));
} catch (UnsupportedEncodingException e) {
    e.printStackTrace();
}
Log.d("AliSDK", "wToken:" + wToken);

5d. HTTP ヘッダーへの署名の追加

リクエスト送信前に、wToken の値を HTTP ヘッダーのプロパティとして設定してください。以下の例では HttpURLConnection を使用しています：

String request_body = "i am the request body, encrypted or not!";
new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            URL url = new URL("https://www.aliyundoc.com");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setReadTimeout(5000);
            conn.setRequestMethod("POST");
            // wToken 署名をリクエストヘッダーに追加
            conn.setRequestProperty("wToken", wToken);
            OutputStream os = conn.getOutputStream();
            // リクエストボディを書き込む
            byte[] requestBody = request_body.getBytes("UTF-8");
            os.write(requestBody);
            os.flush();
            os.close();
            int code = conn.getResponseCode();
            Log.d("respCode", Integer.toString(code));
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        } catch (ProtocolException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}).start();