認証器を登録する

概要

eコマース取引中に3DSチャレンジを完了する前に、エンドユーザーはイシュアアプリケーションでデバイス認証器を登録する必要があります。

D1 SDKはEMV 3‑D Secure（3DS）向けのFIDOベースの認証器を提供します。登録（エンロールメント）はエンドユーザーの認証器をデバイス上に3DS用として登録します。

登録フロー

認証器登録のハイレベルフロー。

シーケンス図

以下の図は認証器登録のエンドツーエンドのメッセージシーケンスを示します。

前提条件

• イシュアアプリケーションがD1 SDKを統合し、SDKが初期化されていること。

• イシュアアプリケーションがD1 SDKにログインしていること。

• エンドユーザーがD1プラットフォームに登録されていること。

• プッシュ通知がイシュアアプリケーションで設定されていること。

認証器登録のシーケンス図。

• 各デバイスは最大で 1人の登録されたエンドユーザー.

• 単一のエンドユーザーは 複数のデバイスに登録される場合があります.

• 特定のAndroidデバイスは不正確なアテステーションペイロードを生成し、これが登録失敗を引き起こす可能性があります。このリスクを軽減するために、 強く推奨されます に登録すること BIOMETRIC（生体認証） 認証器ではなく PLATFORM（プラットフォーム） 認証器を使用すること。

D1 SDKの統合

認証器を登録する

Android（Java）

// AuthnCallbackを提供する
D1Authn d1Authn = d1Task.getD1Authn(activity, authnCallback);

// 認証器の種類を選択する
AuthnType preferredAuthnType = AuthnType.BIOMETRIC;

d1Authn.enrollAuthnCredentials(preferredAuthnType, new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // デバイスは3DSに登録されました。OOBチャレンジを続行してください。
    }

    @Override
    public void onError(@NonNull D1Exception e) {
        // アプリ内でエラーを処理します。
    }
});

Android（Kotlin）

fun enrollAuthnCredentials(d1Task: D1Task, activity: FragmentActivity, authnCallback: AuthnCallback) {
    // AuthnCallbackに準拠するインターフェースを実装する
    val d1Authn: D1Authn = d1Task.getD1Authn(activity, authnCallback)

    // 希望する認証器の種類を選択する
    val preferredAuthnType: AuthnType = AuthnType.BIOMETRIC

    d1Authn.enrollAuthnCredentials(preferredAuthnType, object : D1Task.Callback<Void?> {
        override fun onSuccess(unused: Void?) {
            // 以降のフローを進めます。デバイスは3Dセキュアサービスに登録されました。
        }

        override fun onError(e: D1Exception) {
            // D1 SDK統合 – エラー管理のセクションを参照してください。
        }
    })
}

iOS

// AuthnDelegateに準拠する
let d1Authn = d1Task.d1Authn(self)

// 認証器の種類を選択する
let preferredAuthnType = AuthnType.biometric

d1Authn.enrollAuthnCredentials(preferredAuthnType, completion: { error in
    if let error = error {
        // アプリ内でエラーを処理します。
    } else {
        // デバイスは3DSに登録されました。OOBチャレンジを続行してください。
    }
})

次に、次へ進みます OOBチャレンジを処理する.

認証機器の登録解除

呼び出す unenrollAuthnCredentials このデバイスでの登録を削除するには。D1バックエンドとローカルデバイスストレージは関連する登録データを削除します。その他のデバイスは引き続き登録されたままです。デバイスが既に登録解除されている場合、呼び出しは成功します（冪等）。

Android（Java）

// AuthnCallbackを提供する
D1Authn d1Authn = d1Task.getD1Authn(activity, authnCallback);

d1Authn.unenrollAuthnCredentials(new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // デバイスは3DSのために登録解除されています。
    }

    @Override
    public void onError(@NonNull D1Exception e) {
        // アプリ内でエラーを処理します。
    }
});

Android（Kotlin）

fun unenrollAuthnCredentials(d1Task: D1Task, activity: FragmentActivity, authnCallback: AuthnCallback) {
    // AuthnCallbackに準拠するインターフェースを実装する
    val d1Authn: D1Authn = d1Task.getD1Authn(activity, authnCallback)

    d1Authn.unenrollAuthnCredentials(object : D1Task.Callback<Void?> {
        override fun onSuccess(unused: Void?) {
            // デバイスは現在3Dセキュアサービスのために登録解除されています。
        }

        override fun onError(@NonNull e: D1Exception) {
            // D1 SDK 統合 – エラー管理 セクションを参照してください。ネットワーク接続の問題で失敗する可能性があります。
        }
    })
}

iOS

// AuthnDelegateに準拠する
let d1Authn = d1Task.d1Authn(self)

d1Authn.unenrollAuthnCredentials({ error in
    if let error = error {
        // アプリ内でエラーを処理します。
    } else {
        // デバイスは3DSのために登録解除されています。
    }
})

プロンプトメッセージをカスタマイズする

Android 対象: BIOMETRIC（生体認証）、バイオメトリクスプロンプトダイアログに表示されるメッセージをカスタマイズできます。 対して、 PLATFORM（プラットフォーム）、プロンプトメッセージのカスタマイズはサポートされていません。

iOS 認証プロンプトメッセージのカスタマイズはサポートされていません。

Android（Java）

public void customizingBiometricPromptMessage(@NonNull D1Task d1Task, @NonNull FragmentActivity activity) throws D1Exception {
    // 優先する認証タイプを AuthnType.BIOMETRIC に選択します
    AuthnType preferredAuthnType = AuthnType.BIOMETRIC;

    String customMessage = "生体認証で認証してください";

    d1Task.getD1Authn(activity, new AuthnCallback() {
        @Override
        public void onTransactionDataConfirmation(@NonNull Map<String, String> map, @NonNull AuthnUserConfirmationCallback authnUserConfirmationCallback) {
            // 'map' には認証されるトランザクションデータが含まれます。
            // アプリケーションは内容を表示し、ユーザーに認証リクエストを「進める」か「拒否する」かを促します。
        }

        @NonNull
        @Override
        public String onBiometricPromptMessage() {
            return customMessage;
        }
    });
}

Android（Kotlin）

@Throws(D1Exception::class)
fun customizingBiometricPromptMessage(d1Task: D1Task, activity: FragmentActivity) {
    // 優先する認証タイプを AuthnType.BIOMETRIC に選択します
    val preferredAuthnType = AuthnType.BIOMETRIC

    val customMessage = "生体認証で認証してください"

    d1Task.getD1Authn(activity, object : AuthnCallback {
        override fun onTransactionDataConfirmation(map: Map<String, String>, authnUserConfirmationCallback: AuthnUserConfirmationCallback) {
            // ‘map’ には認証されるトランザクションデータが含まれます。
            // アプリケーションは内容を表示し、エンドユーザーに認証リクエストを「進める」か「拒否する」かを促します。
        }

        override fun onBiometricPromptMessage(): String {
            return customMessage
        }
    })
}