デバイスバインディングを作成する（グリーンフロー）

Visa Cloud Token Framework (CTF) のデバイスバインディングを使用する グリーンフロー イシュアがデバイスバインディングを承認したとき 〜なしで ステップアップ認証。

本番環境では、デバイスバインディングはしばしばステップアップ認証を必要とします。その経路は イエローフロー.

前提条件:

決済カードは既にトークン化されています。
あなたは持っています、 vProvisionedTokenId.
エンドユーザーはデバイス上で認証できます（PIN、パスコード、指紋、Face ID など）。

フロー

ステップ

説明

Thales SDK を使用してマーチャントアプリケーションからデバイスバインディングフローを開始します。

Thales SDK はデバイス ID と CTF 鍵ペアを生成し、その CTF 鍵ペアをデバイス上に安全に保存します。

Thales SDK はデバイス上でエンドユーザー認証をトリガーします。

Thales SDK は Visa 定義のペイロードを生成して署名します。

Thales SDK は署名済みペイロードと CTF 公開鍵を Thales バックエンドに送信します。

Thales バックエンドは公開鍵を Visa CA を使用して証明書に変換します。

Thales バックエンドはデバイスを登録し、VTS にデバイスバインディングを要求します。

VTS はイシュアの決定を確認します。

イシュアはステップアップ認証なしでデバイスバインディングを承認します。

VTS は結果を Thales バックエンドに転送します。

Thales SDK に通知され、トークン識別子をローカルでデバイスにバインドします。

Thales バックエンドはバインディングの詳細をマーチャント/PSP バックエンドに通知します。

SDK 統合

バインディングを作成する

String vProvisionedTokenId;
String correlationId;

visaCTFHelper.createBinding(vProvisionTokenId, 
                            correlationId, 
                            new TokenBindingListener() {

        ......
        
        @Override
        public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
            // ユーザー認証を行う
         }

        @Override
        public void onSuccess() { }

        @Override
        public void onError(TMGClientException exception) { 
            // エラーを確認する
            int errorCode = exception.getErrorCode();
            int errorMessage = exception.getMessage();
        }
    });

let vProvisionedTokenID: String = ""
let correlationID: String = ""
// 1. バインディング作成を開始
visaCTFHelper.createBinding(forVProvisionedTokenID: vProvisionedTokenID,
                            correlationID: correlationID,
    deviceAuthenticationHandler: { auth in
        // 2. Face ID
        let customMessage = "" // カスタムメッセージを渡します。例: "Face ID で認証"
        auth.startAuthentication(withMessage: customMessage)
    }, idvSessionHandler: { session in
        // idv セッションを開始する（イエローフローにのみ適用）
        
    }, completionHandler: { session, error in
        // 3. バインディング成功
        if error == nil {
            
        }
        // フェール時にエラーを処理するか idv セッションを再試行する（グリーンフローには該当しません）
    })

createBinding は非同期です。アプリケーションが UI を更新する必要がある場合、コールバック内で runOnUiThread(Runnable) を呼び出すことを推奨します。

エンドユーザーを認証する

デバイスバインディングを作成するには、エンドユーザーのプレゼンスが必要です。 deviceAuhenticationHandler コールバックを実装します。 createBinding.

このコールバックを使用してカスタム UI（例えば Face ID の許可プロンプト）を表示します。認証を開始するには startAuthenticationを呼び出します。認証中に表示するカスタムメッセージを渡すこともできます。

@Override
public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
    FragmentActivity fragmentActivity;
    CharSequence title;
    CharSequence subTitle;
    CharSequence description;
    CharSequence negativeButtonText;

    // ユーザー認証を開始する
    deviceAuthentication.startAuthentication(fragmentActivity, 
                                             title, 
                                             subTitle, 
                                             description, 
                                             negativeButtonText);
}

let deviceAuhenticationHandler: ((DeviceAuthentication) -> Void) = {(auth) in
    // ユーザー認証を開始する
    let customMessage = "" // カスタムメッセージを渡します。例: "Face ID で認証"
    auth.startAuthentication(withMessage: customMessage)
}

結果を処理する

結果は onSuccess または onError コールバックを通じて返されます。

エラーが発生した場合、例外のエラーコードとメッセージを記録して検査してください。

@Override
public void onError(TMGClientException exception) {
    // エラーを確認する
    int errorCode = exception.getErrorCode();
    int errorMessage = exception.getMessage();
}

let vProvisionedTokenID: String = ""
let correlationID: String = ""
// 1. バインディング作成を開始
visaCTFHelper.createBinding(forVProvisionedTokenID: vProvisionedTokenID,
                            correlationID: correlationID,
    deviceAuthenticationHandler: { auth in
        // 2. デバイス認証をキャンセルする
        auth.cancel()
    }, idvSessionHandler: { session in
        // idv セッションを開始する（イエローフローにのみ適用）
        
    }, completionHandler: { session, error in
        if error == nil {
            
        }
        // 3. キャンセルエラーを処理する
    })

前へデバイスバインディングを確認する次へデバイスバインディングを作成する（イエローフロー）

最終更新 3 か月前

役に立ちましたか？