iOS

このガイドを使用して、を統合します Thales SDK iOSのマーチャントネイティブアプリケーションに。

配布パッケージ

SDK配布パッケージには以下が含まれます:

名前	説明
バイナリ	Thales SDKのリリースおよびデバッグバリアント。
デモ	Thales SDKの統合方法と使用方法を示すサンプルプロジェクト。
Apidoc	Thales SDK APIドキュメント。
ライセンス	Thales SDKに同梱されているサードパーティフレームワークのライセンス。

SDKを統合する

1. というフォルダを作成します Framework.

2. をコピーします .xcframework バンドルをから Binaries/<Release|Debug>/ へ Framework フォルダ。

例 Framework SDKを含むフォルダ .xcframework バンドル。

1. をドラッグします TMGSDK.xcframework です。難読化の詳細は、 SecureLogAPI.xcframework から Framework フォルダへ Frameworks, Libraries, and Embedded Content ターゲット設定の中に。

アプリターゲットにSDKフレームワークを埋め込みます。

1. アプリのFace ID使用説明を追加します Info.plist.

にFace ID使用説明を追加します Info.plist.

SDKを構成する

SDKのいかなるAPIを呼ぶ前にもThales SDKを構成してください。

を作成します TMGClientConfiguration 必要なパラメータで:

• サーバーURL

• サーバー証明書

• キー識別子

• 証明書PIN

1. を作成します TMGClientConfiguration

オンボーディング中にサーバーURL、サーバー証明書、およびキー識別子を取得します。

let serverURL = ""
let serverCertificate = ""
let serverKeyID = ""
let configuration = TMGClientConfiguration(serverURL: serverURL,
                                           serverCertificate: Data(serverCertificate.utf8),
                                           serverKeyID: serverKeyID)

2. を作成します VisaCTFHelper

Visa CTFおよびDAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。

do {
      let visaCTFHelper = try TMGClient.sharedInstance.createVisaCTFHelper(withConfiguration: configuration)
} catch let error {
  // エラーを処理します
}

3. を作成します MastercardTAFHelper

Mastercard TAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。

do {
      let mastercardTAFHelper = try TMGClient.sharedInstance.createMastercardTAFHelper(withConfiguration: configuration)
  } catch let error {
      // エラーを処理します
  }

SDKがヘルパーを作成できない場合、エラーをスローします。

SDKの各バリアントは意図された環境でのみ使用してください。を作成すると、SDKはを返します VisaCTFHelper、SDKはを返します deviceEnvironmentUnsafe 次の場合:

• デバッグ: アプリに配布またはアドホックの証明書で署名しています。

• リリース: アプリをデバッグしている、またはXcodeから起動している、もしくは xcodebuild. このエラーが発生した場合は、デバッグを停止してデバイスでアプリを再起動してください。