Web Application Firewall:iOSアプリへのAnti-Bot SDKの統合

ステップ1: Xcodeプロジェクトのセットアップ

Xcode で iOS プロジェクトを開き、SDK フレームワークをプロジェクトディレクトリにコピーします。

ステップ2: 依存ライブラリの追加

以下のライブラリをターゲットに追加します。

ステップ3: -ObjCリンカフラグの追加

ビルド設定で、[その他のリンカーフラグ] に -ObjC を追加します。

ステップ4: SDKヘッダーのインポート

Objective-C — SDK を呼び出すソースファイルにインポート文を追加します。

// Non-IDFA バージョン
#import <AliTigerTally_NOIDFA/AliTigerTally.h>

// IDFA バージョン
#import <AliTigerTally_IDFA/AliTigerTally.h>

Swift — ブリッジングヘッダーファイルを作成し、インポート文を追加します。

#ifndef TigerTally_sdk_Swift_h
#define TigerTally_sdk_Swift_h

// Non-IDFA バージョン
#import <AliTigerTally_NOIDFA/AliTigerTally.h>
// IDFA バージョン
#import <AliTigerTally_IDFA/AliTigerTally.h>

#endif /* TigerTally_sdk_Swift_h */

次に、[ビルド設定] > [Objective-C ブリッジングヘッダー]でブリッジングヘッダーのパスを設定します。

ステップ5: ユーザー IDの設定 (オプション)

setAccount を呼び出して、ユーザー ID を SDK リクエストに関連付けます。これにより、よりきめ細かい WAF 保護ポリシーを構築できます。ゲストユーザーの場合は、この呼び出しをスキップして、直接 initialize に進んでください。

構文：

-(void)setAccount:(NSString*)account

Objective-C：

// マスクされたユーザー ID を使用
[[AliTigerTally sharedInstance] setAccount:@"testAccount"];

Swift：

AliTigerTally.sharedInstance().setAccount("testAccount")

ステップ6: SDKの初期化

App キーを使用して initialize を呼び出し、SDK を起動してデバイス情報を収集します。デバイス情報を更新する必要がある場合は、いつでも再度呼び出すことができます。

構文：

-(bool)initialize:(NSString*)appKey

成功した場合は true、失敗した場合は false を返します。

Objective-C：

NSString *appKey = @"****OpKLvM6zliu6KopyHIhmneb_****u4ekci2W8i6F9vrgpEezqAzEzj2ANrVUhvAXMwYzgY_****vc51aEQlRovkRoUhRlVsf4IzO9dZp6nN_****Wz8pk2TDLuMo4pVIQvGaxH3vrsnSQiK****";
if ([[AliTigerTally sharedInstance] initialize:appKey]) {
    NSLog(@"初期化に成功しました。");
} else {
    NSLog(@"初期化に失敗しました。");
}

Swift：

let binit = AliTigerTally.sharedInstance().initialize("****OpKLvM6zliu6KopyHIhmneb_****u4ekci2W8i6F9vrgpEezqAzEzj2ANrVUhvAXMwYzgY_****vc51aEQlRovkRoUhRlVsf4IzO9dZp6nN_****Wz8pk2TDLuMo4pVIQvGaxH3vrsnSQiK****")
if binit {
    NSLog("初期化に成功しました。")
} else {
    NSLog("初期化に失敗しました。")
}

ステップ7: リクエストへの署名

vmpSign を呼び出して、リクエストボディの署名トークンを生成します。

構文：

-(NSString*)vmpSign:(NSData*)inputBody

成功した場合は、署名文字列 (NSString*) を返します。この署名は wToken と呼ばれます。

エラー時の戻り値：

Objective-C：

if (![[AliTigerTally sharedInstance] initialize:@"****OpKLvM6zliu6KopyHIhmneb_****u4ekci2W8i6F9vrgpEezqAzEzj2ANrVUhvAXMwYzgY_****vc51aEQlRovkRoUhRlVsf4IzO9dZp6nN_****Wz8pk2TDLuMo4pVIQvGaxH3vrsnSQiK****"]) {
    NSLog(@"初期化に失敗しました。");
    return;
}
NSString *signBody = @"hello";
NSString *wToken = [[AliTigerTally sharedInstance] vmpSign:[signBody dataUsingEncoding:NSUTF8StringEncoding]];
NSLog(@"wToken: %@", wToken);

Swift：

if !AliTigerTally.sharedInstance().initialize("****OpKLvM6zliu6KopyHIhmneb_****u4ekci2W8i6F9vrgpEezqAzEzj2ANrVUhvAXMwYzgY_****vc51aEQlRovkRoUhRlVsf4IzO9dZp6nN_****Wz8pk2TDLuMo4pVIQvGaxH3vrsnSQiK****") {
    NSLog("初期化に失敗しました。")
    return
}
let signBody = "hello"
let signData = signBody.data(using: .utf8)!
let token = AliTigerTally.sharedInstance().vmpSign(signData)!
NSLog("wToken: %@", token)

ステップ8: 署名付きリクエストの送信

wToken を HTTP リクエストヘッダーに追加し、リクエストを送信します。

Objective-C：

NSURL *url = [NSURL URLWithString:@"https://xxxxxx/test?id=123"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url
                                                       cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                   timeoutInterval:10];
[request setValue:wToken forHTTPHeaderField:@"wToken"];
request.HTTPMethod = @"post";
request.HTTPBody = [signBody dataUsingEncoding:NSUTF8StringEncoding];

NSURLSessionDataTask *dataTask = [[NSURLSession sharedSession]
    dataTaskWithRequest:request
      completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
          if (error) {
              NSLog(@"リクエストに失敗しました: %@", error);
          } else {
              NSLog(@"リクエストを送信しました。");
          }
      }];
[dataTask resume];

Swift：

guard let url = URL(string: "https://xxxxxx/test?id=123") else { return }
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue(token, forHTTPHeaderField: "wToken")

URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("リクエストに失敗しました: \(error)")
    } else {
        print("リクエストを送信しました。")
    }
}.resume()