認証器を登録する

概要

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）

iOS

次に、次へ進みます 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）

iOS

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

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）