2.xから3.0へ移行する

TMG SDK 3.0.0以降、いくつかのパブリックAPIが簡素化されました。

SDKを初期化する

SDKは次を削除します TMGClientConfiguration.Builder および設定をに移動します TMGClientConfiguration イニシャライザ：

削除されたもの： TMGClientConfiguration.Builder
代わりに使用： TMGClientConfiguration

何が変わったか

非推奨 certificatePins。SDKは現在証明書ピンニングを内部で管理します。
名前が変更されました serverUrl から serverURL.
名前が変更されました serverKeyId から serverKeyID.

let serverUrl;
let serverCertificate;
let keyIdentifier;
let configurationBuilder = TMGClientConfiguration.Builder(serverUrl: serverUrl, 
                                                          serverCertificate: Data(serverCertificate.utf8), 
                                                          serverKeyId: keyIdentifier)
let configuration: TMGClientConfiguration = TMGClientConfiguration(builder: configurationBuilder)

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

初期化 `VisaCTFHelper`

TMG SDK 3.0.0では、 createVisaCTFHelper は非同期から同期に変わります。これによりエラーハンドリングと制御フローが簡素化されます。

let tmgClient = TMGClient.sharedInstance
tmgClient.createVisaCTFHelper(tmgClientConfiguration: configuration,
                              completion: { (visaCTFHelper, error) in
  // VisaCTFHelperオブジェクトを取得します
  // エラーを確認します
})

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

デバイスバインディングフロー（グリーンおよびイエロー）を更新する

デバイスバインディングはデバイス認証、識別および検証（ID&V）、およびバインディング完了をカバーします。TMG SDK 3.0.0では、フローは：

の使用を標準化しました completionHandler.
の混在を削除しました delegate です。難読化の詳細は、 completionHandler.
バインディング成功を複数箇所でハンドルする必要を削除しました。
制御フローを簡素化しました。

旧バージョンのSDKから移行する際は、これらのAPI名変更に注意してください：

PendingBindingSession は現在 VisaCTFHelper.IDVSession.
DeviceAuthenticationDelegate は現在 DeviceAuthentication.
IdvMethod は現在 IDVMethod.
IdvType は現在 IDVType.
OtpActivationStatus は現在 OTPActivationStatus.
- maxOtpRequestsAllowed は現在 maxOTPRequestsAllowed.
- maxOtpVerificationAllowed は現在 maxOTPVerificationAllowed.

デバイスバインディング統合を更新するには、以下のコードを使用してください：

// 1. DeviceAuthenticationDelegateに準拠する（これはデバイス認証のため）
class DeviceAuthenticationDelegateImplementation: DeviceAuthenticationDelegate {

    let authenticationMessage

    func shouldStartAuthentication(startHandler: (String?, Bool) -> Void) {
        //3. ユーザー認証を開始する 
        startHandler(authenticationMessage, YES)
    }
}

var pendingBindingSession: PendingBindingSession?
let deviceId
let correlationId
let deviceAuthenticationDelegate = DeviceAuthenticationDelegateImplementation()
// 2. バインディング作成を開始する
visaCTFHelper.createBinding(vProvisionedTokenId: vProvisionedTokenId,
                            correlationId: correlationId,
                            deviceAuthenticationDelegate: deviceAuthenticationDelegate) { session, error in
    // 4. バインド成功 [シナリオ 1]
    if error == nil && session == nil {

    }
    // 5. イエローフローのためにセッションをローカルに保存する
    pendingBindingSession = session
}
// MARK: idv フロー
// 6. idvメソッドのリストを取得する（イエローフロー）
pendingBindingSession.idvMethods(completion: { idvMethods, error in
    if error == nil {
        let listOfIdvMethod = idvMethods
    }
})

//7. 選択したidvメソッドを送信する（OTPフロー）
let selectedIdvMethod
pendingBindingSession.submitIdvMethod(idvMethod: selectedIdvMethod,
                                      completion: { otpActivationStatus, error in
     // エラーがないことを確認する
    if error == nil {
        let maxOtpVerificationAllowed = otpActivationStatus.maxOtpRequestsAllowed
        let maxOtpRequestsAllowed = otpActivationStatus.maxOtpVerificationAllowed
        let otpExpiration = otpActivationStatus.maxOtpVerificationAllowed
    }
    // 8. エラーの場合は再試行
    
})

//9. バインディングを有効化する
let otp
pendingBindingSession.activateBinding(otp: otp, 
                                      completion: { error in
    // 4.1 バインド成功 [シナリオ 2]
    if error == nil {

    }
    // 10. エラーの場合は再試行
})

// Visaフローに必要なプロパティを保持するシングルトンクラス
class VisaService {
    static var shared = VisaService()
    var idvSession: VisaCTFHelper.IDVSession? = nil
    var completionHandler: ((VisaCTFHelper.IDVSession?, TMGError?) -> Void)? = nil
}

let vProvisionedTokenID: String = ""
let correlationID: String = ""
// 1. バインディング作成を開始する
visaCTFHelper.createBinding(forVProvisionedTokenID: vProvisionedTokenID,
                            correlationID: correlationID,
    deviceAuthenticationHandler: { auth in
        // 2. ユーザー認証を開始する
        let customMessage = "" // カスタムメッセージを渡します。例: "Authenticate with Face ID"
        auth.startAuthentication(withMessage: customMessage)
    }, idvSessionHandler: { session in
        // 3. イエローフローのためにセッションをローカルに保存する
        VisaService.shared.idvSession = session

    }, completionHandler: { session, error in
        // 4. completion handlerをローカルに保持する
        VisaService.shared.completionHandler?(session, error)
    })

// MARK: idv フロー
do {
    guard let session = VisaService.shared.idvSession else {
        return
    }
    // 5. idvメソッドのリストを取得する（イエローフロー）
    let idvMethods = try session.idvMethods
    // 6. 選択したidvメソッドを送信する（OTPフロー）
    session.selectIDVMethod(idvMethods[0]) { otp in
        // otpアクティベーションステータスを確認する
    }
} catch let error {
    // idvメソッドのリストでのエラー
}

// 7. バインディングを有効化する
let otp = ""
VisaService.shared.idvSession?.activateBinding(withValue: otp)

// 8. 成功またはエラーを処理する。
// 成功またはエラーについてはcompletionHandlerを監視できます
VisaService.shared.completionHandler = {(session, error) in
    // 9. バインド成功
    if error == nil {
        
    } else if let error, let session {
        // 10. エラーの場合は再試行
        if error.description == TMGError.invalidOTPMessage.description {
            VisaService.shared.idvSession = session
        }
    } else {
        // 11. エラーを処理する
    }
}

バインディングを再開する（`resumeBinding`)

この resumeBinding フローは以前のバージョンから変更されていません。変更されるのは IDVSession （ID&V）ステップのみです。

var pendingBindingSession: PendingBindingSession?
// 1. バインディングの再開を開始する
visaCTFHelper.resumeBinding(vProvisionedTokenId: vProvisionedTokenId) { session, error in
    // 2. イエローフローのためにセッションをローカルに保存する
    if error == nil { 
        pendingBindingSession = session
    }
    // エラーを確認する
}

// 3. MARK: idv フロー（コードスニペットのcreate binding idvフローを参照）

// Visaフローに必要なプロパティを保持するシングルトンクラス
class VisaService {
    static var shared = VisaService()
    var idvSession: VisaCTFHelper.IDVSession? = nil
    var completionHandler: ((VisaCTFHelper.IDVSession?, TMGError?) -> Void)? = nil
}
let vProvisionedTokenID: String = ""
// 1. バインディングの再開を開始する
visaCTFHelper.resumeBinding(forVProvisionedTokenID: vProvisionedTokenID,
                            idvSessionHandler: { session in
        // 2. イエローフローのためにセッションをローカルに保存する
        VisaService.shared.idvSession = session        
    }, completionHandler: { session, error in
        // 3. completion handlerをローカルに保持する
        VisaService.shared.completionHandler?(session, error)
    })
// 4. MARK: idv フロー（コードスニペットのcreate binding idvフローを参照）

バインディング状態を取得する（`bindingState`)

TMG SDK 3.0.0では、 bindingState は非同期から同期に変わります。これによりエラーハンドリングと制御フローが簡素化されます。

let vProvisionedTokenId = ""
visaCTFHelper.bindingState(vProvisionedTokenId: vProvisionedTokenId) { (bindingState, error) in 
}

let vProvisionedTokenID = ""
do {
    let state = try visaCTFHelper.bindingState(forVProvisionedTokenID: vProvisionedTokenID)
} catch let error {
    // エラーを処理します
}

トランザクションを認証する

トランザクション認証はデバイス認証とVisaペイロードの返却をカバーします。TMG SDK 3.0.0では、フローは：

の使用を標準化しました completionHandler.
の混在を削除しました delegate です。難読化の詳細は、 completionHandler.

トランザクション認証の統合を更新するには、以下のコードを使用してください：

// 1. DeviceAuthenticationDelegateに準拠する（これはデバイス認証のため）
class DeviceAuthenticationDelegateImplementation: DeviceAuthenticationDelegate {

    let authenticationMessage

    func shouldStartAuthentication(startHandler: (String?, Bool) -> Void) {
        //3. ユーザー認証を開始する 
        startHandler(authenticationMessage, YES)
    }
}

let deviceAuthenticationDelegate = DeviceAuthenticationDelegateImplementation()

// 2. トランザクション認証を開始する
visaCTFHelper.authenticateTransaction(vProvisionedTokenId: vProvisionedTokenID,
                                      deviceAuthenticationDelegate: deviceAuthenticationDelegate,
                                      completion: { visaPayload, error in
    // 4. ペイロードの生成に成功
    if error == nil {
    
    } else {
        // エラーを処理する
    } 
})

let vProvisionedTokenID: String = ""
        
// 1. トランザクション認証を開始する
visaCTFHelper.authenticateTransaction(forVProvisionedTokenID: vProvisionedTokenID,
                                        deviceAuthenticationHandler: { auth in
        // 2. ユーザー認証を開始する 
        let customMessage = "" // カスタムメッセージを渡します。例: "Authenticate with Face ID"
        auth.startAuthentication(withMessage: customMessage)
    }, completionHandler: { (visaPayload, error) in
        // 3. ペイロード生成に成功
        if error == nil {
            
        } else {
            // エラーを処理する
        }    
})

バインディングを削除する（`removeBinding`)

removeBinding は現在追加の correlationID.

を必要とします
// 1. バインディング削除を開始する
                            completion: { error in
    visaCTFHelper.removeBinding(vProvisionedTokenId: vProvisionedTokenID,
    if error == nil {
        
    } else {
        // エラーを処理する
    }
})

let vProvisionedTokenID: String = ""
let correlationID: String = ""

を必要とします
// 2. バインディング削除に成功
                            visaCTFHelper.removeBinding(forVProvisionedTokenID: vProvisionedTokenID,
    visaCTFHelper.removeBinding(vProvisionedTokenId: vProvisionedTokenID,
    if error == nil {
        
    } else {
        // エラーを処理する
    } 
}

correlationID: correlationID) { error in`バインディング状態を同期する（`)

バインディング状態を同期する（ は現在追加の correlationID.

syncBindingState
// 1. バインディング状態の同期を開始する
                               visaCTFHelper.syncBindingState(vProvisionedTokenId: vProvisionedTokenID,
    completion: { bindingState, error in
    if error == nil {
        
    } else {
        // エラーを処理する
    }  
})

let vProvisionedTokenID: String = ""
let correlationID: String = ""

syncBindingState
// 2. バインディング状態の同期に成功
                                visaCTFHelper.syncBindingState(forVProvisionedTokenID: vProvisionedTokenID,
    completion: { bindingState, error in
    if error == nil {
        
    } else {
        // エラーを処理する
    }   
}

correlationID: correlationID) { (state, error) in

以前に選択されたID&Vメソッドを読み取る IDVSession に加えて、 createBinding フローで使用される関数、以前に選択されたID&Vメソッドを読み取ることができます。TMG SDK 3.0.0では、 previouslySelectedIDVMethod は非同期から同期に変わります。これによりエラーハンドリングと制御フローが簡素化されます。

// 1. 以前に選択されたidvメソッドを取得する
pendingBindingSession.previouslySelectedIdvMethod(completion: { idvMethod, error in
    // 2. 以前に選択されたidvメソッドを正常に取得する
    if error == nil {
        let prevIDVMethod = idvMethod
    } else {
        // エラーを処理する
    } 
})

guard let idvSession = VisaService.shared.idvSession else {
    // idv セッションがありません
    return
}
// 1. 以前に選択されたidvメソッドを取得する
do {
    let prevIDVMethod = try idvSession.previouslySelectedIDVMethod
} catch let error {
    // 2. エラーを処理する
}

前へiOS API 次へエラー管理

最終更新 5 か月前

役に立ちましたか？

こんにちは

SDKを初期化する

何が変わったか

初期化 VisaCTFHelper

デバイスバインディングフロー（グリーンおよびイエロー）を更新する

バインディングを再開する（resumeBinding)

バインディング状態を取得する（bindingState)