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

5a. (任意) ユーザー ID の設定

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

// シグネチャ: int setAccount(String account)
// 戻り値: 成功した場合は 0、失敗した場合は -1

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

5b. SDK の初期化

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

2 つの収集モードが利用可能です。

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

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

// シグネチャ: int init(Context context, String appkey, int type)
// 戻り値: 成功した場合は 0、失敗した場合は -1

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") を渡してください。

// シグネチャ: String vmpSign(int signType, byte[] input)
// 戻り値: 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();