Gestionar CDCVM

Resumen

NFC Wallet SDK admite múltiples CVM (métodos de verificación del titular de la tarjeta) para autenticar al usuario final durante el pago, como CDCCVM, PIN en línea y firma.

CDCVM (método de verificación del titular de la tarjeta en el dispositivo del consumidor) es un CVM que depende del dispositivo para verificar al usuario final antes de un pago NFC.

La mayoría de los programas NFC Wallet usan CDCVM. CDCVM se basa en la autenticación del usuario en el dispositivo.

En esta sección, explicamos que NFC Wallet SDK se basa en el método de desbloqueo seguro del dispositivo de Android como CDCVM.

CDCVM Android (desbloqueo del dispositivo)

NFC Wallet SDK para Android usa la pantalla de bloqueo segura de Android para CDCVM. Admite:

• Biometría: credenciales biométricas fuertes, como huella dactilar o rostro.
• Credenciales del dispositivo (keyguard): PIN, patrón o contraseña.

NFC Wallet usa la autenticación de usuario de Android Keystore. Consulte autenticación de usuario de Android Keystore.

Recomendaciones

Gestione CDCVM desde el inicio de su integración:

• Compruebe las capacidades CDCVM del dispositivo antes de iniciar el enrolamiento de la wallet o la tokenización.
• Indique al usuario final que habilite una pantalla de bloqueo segura cuando sea necesario.

Comprobación de la capacidad del dispositivo NFC

Compruebe que su dispositivo admite HCE como se indica en Declarar características NFC. Puede realizar la comprobación durante la instalación de la aplicación (filtrado de dispositivos de Google Play) o en tiempo de ejecución.

Si usa una comprobación en tiempo de ejecución, oculte las funciones de NFC Wallet para los dispositivos no compatibles.

Integración del SDK

Compruebe las capacidades CDCVM del dispositivo

Use DeviceCVMEligibilityChecker.checkDeviceEligibility para comprobar las capacidades del dispositivo.

Devuelve un DeviceCVMEligibilityResult. Úselo para evaluar la compatibilidad biométrica y de keyguard.

Ejecute esta comprobación después de inicializar NFC Wallet SDK, y antes de iniciar el enrolamiento de la wallet o la tokenización.

Compruebe la compatibilidad biométrica

Llamar a DeviceCVMEligibilityResult.getBiometricsSupport.

Devuelve BiometricSupport.SUPPORTED cuando CDCVM biométrico está disponible. Consulte el posible error en caso de que la biometría no sea compatible en la tabla siguiente.

Error de elegibilidad biométrica

Resultado	Descripción
ANDROID_VERSION_NOT_SUPPORTED	Se devuelve cuando el dispositivo ejecuta una versión de Android anterior a 6.0 (nivel de API 23).
NO_FINGERPRINT_SENSOR	Se devuelve cuando no hay ningún sensor biométrico disponible en el dispositivo.
NO_FINGERPRINT_ENROLLED	Se devuelve cuando el usuario final no ha registrado biometría en el dispositivo.
PERMISSION_NOT_GRANTED	Se devuelve cuando falta en el manifiesto el permiso biométrico requerido.
SECURE_LOCK_NOT_PRESENTED	Se devuelve cuando no hay habilitada ninguna pantalla de bloqueo segura en el dispositivo.

Compruebe la compatibilidad de keyguard del dispositivo

Llamar a DeviceCVMEligibilityResult.getDeviceKeyguardSupport.

Devuelve DeviceKeyguardSupport.SUPPORTED cuando CDCVM de keyguard del dispositivo está disponible. Consulte el posible error en caso de que keyguard no sea compatible en la tabla siguiente.

Error de elegibilidad de keyguard del dispositivo

Resultado	Descripción
ANDROID_VERSION_NOT_SUPPORTED	Se devuelve cuando el dispositivo ejecuta una versión de Android anterior a 6.0 (nivel de API 23).
SECURE_LOCK_NOT_PRESENTED	Se devuelve cuando no hay ningún PIN, patrón o contraseña habilitado en el dispositivo.

Ejemplo de implementación

// Compruebe la elegibilidad del dispositivo para elegir CDCVM
DeviceCVMEligibilityResult result =
        DeviceCVMEligibilityChecker.checkDeviceEligibility(getApplicationContext());

if(result.getBiometricsSupport() == BiometricsSupport.SUPPORTED) {
    // La biometría es compatible
    // ...
}
else if(result.getDeviceKeyguardSupport() == DeviceKeyguardSupport.SUPPORTED){
    // Si la biometría no es compatible, debe usarse Device Keyguard.
    // Device keyguard es compatible
    // ...
}
else {
    // Registrar error, el dispositivo no es compatible
    // o el usuario final no habilita una pantalla de bloqueo segura
    // Recomendamos indicar al usuario final que habilite una pantalla de bloqueo segura
    // ...
}