CDCVMを処理する

概要

NFC Wallet SDK は、支払い時にエンドユーザーを認証するための複数の CVM（カード所有者認証方式）をサポートしています。たとえば、CDCCVM、オンライン PIN、署名です。

CDCVM（Consumer Device カード所有者認証方式）は、デバイスに依存して確認を行う CVM です。 エンドユーザー NFC 支払いの前に。

ほとんどの NFC Wallet プログラムは CDCVM。CDCVM はデバイスのユーザー認証に依存します。

このセクションでは、NFC Wallet SDK が CDCVM として Android の安全なデバイスのロック解除方法に依存していることを説明します。

CDCVM Android（デバイスのロック解除）

Android 用 NFC Wallet SDK は、CDCVM に Android の安全なロック画面を使用します。次をサポートしています：

• 生体認証：指紋や顔などの強力な生体認証情報。
• デバイス認証情報（keyguard）：PIN、パターン、またはパスワード。

NFC Wallet は Android Keystore のユーザー認証を使用します。参照： Android Keystore のユーザー認証.

推奨事項

統合の早い段階で CDCVM を処理します：

• ウォレット登録またはトークン化を開始する前に、デバイスの CDCVM 機能を確認してください。
• 必要に応じて、エンドユーザーに安全なロック画面を有効にするよう促します。

NFC デバイスの機能チェック

次に記載されているとおり、デバイスが HCE をサポートしていることを確認します： NFC 機能を宣言する。この確認は、アプリケーションのインストール時（Google Play のデバイス フィルタリング）または実行時に行えます。

実行時チェックを使用する場合、サポートされていないデバイスでは NFC Wallet の機能を非表示にします。

SDK 連携

デバイスの CDCVM 機能を確認する

使用する DeviceCVM有効性Checker.checkDevice有効性 デバイスの機能を確認するために使用します。

次を返します： DeviceCVM有効性Result。これを使用して、生体認証とキーガードのサポートを評価します。

このチェックは次の後に実行します： NFC Wallet SDK を初期化する、そしてウォレット登録またはトークン化を開始する前に。

生体認証のサポートを確認する

呼び出します DeviceCVM有効性Result.getBiometricsSupport.

次を返します BiometricSupport.SUPPORTED 生体認証 CDCVM が利用可能な場合。生体認証がサポートされていない場合の可能なエラーについては、下の表を確認してください。

生体認証有効性エラー

結果	説明
ANDROID_VERSION_NOT_SUPPORTED	デバイスで Android 6.0（API レベル 23）より前のバージョンが実行されている場合に返されます。
NO_FINGERPRINT_SENSOR	デバイスで利用可能な生体認証センサーがない場合に返されます。
NO_FINGERPRINT_ENROLLED	エンドユーザーがデバイスに生体認証を登録していない場合に返されます。
PERMISSION_NOT_GRANTED	必要な生体認証権限がマニフェストにない場合に返されます。
SECURE_LOCK_NOT_PRESENTED	デバイスで安全なロック画面が有効になっていない場合に返されます。

デバイスのキーガード サポートを確認する

呼び出します DeviceCVM有効性Result.getDeviceKeyguardSupport.

次を返します DeviceKeyguardSupport.SUPPORTED デバイスのキーガード CDCVM が利用可能な場合。キーガードがサポートされていない場合の可能なエラーについては、下の表を確認してください。

デバイス キーガード有効性エラー

結果	説明
ANDROID_VERSION_NOT_SUPPORTED	デバイスで Android 6.0（API レベル 23）より前のバージョンが実行されている場合に返されます。
SECURE_LOCK_NOT_PRESENTED	デバイスで PIN、パターン、またはパスワードが有効になっていない場合に返されます。

実装例

// CDCVM を選択するためのデバイスの有効性を確認
DeviceCVM有効性Result result =
        DeviceCVM有効性Checker.checkDeviceEligibility(getApplicationContext());

if(result.getBiometricsSupport() == BiometricsSupport.SUPPORTED) {
    // 生体認証がサポートされています
    // ...
}
else if(result.getDeviceKeyguardSupport() == DeviceKeyguardSupport.SUPPORTED){
    // 生体認証がサポートされていない場合は、Device KeyGuard を使用する必要があります。
    // デバイスのキーガードはサポートされています
    // ...
}
else {
    // エラーを記録します。デバイスはサポートされていません
    // またはエンドユーザーが安全なロック画面を有効にしていません
    // エンドユーザーに安全なロック画面を有効にするよう促すことを推奨します
    // ...
}