Activar el aprovisionamiento

Resumen

Después de digitalizar una tarjeta, inicia una sesión de aprovisionamiento para aprovisionar la tarjeta digital.

Durante la sesión de aprovisionamiento, el NFC Wallet aprovisiona de forma segura el perfil de la tarjeta digital y las claves de pago en tu aplicación de cartera digital.

Inicia la sesión de aprovisionamiento justo después de recibir el activationCode de MGDigitizationListener.onCPSActivationCodeAcquired. Consulte Digitalizar una tarjeta.

Esta devolución de llamada también devuelve digitalCardId. Guárdalo para operaciones posteriores (por ejemplo, tokens de acceso, historial de transacciones y LCM). No lo necesitas para iniciar el aprovisionamiento seguro.

Este paso también establece el canal seguro entre el NFC Wallet SDK y el backend de Thales NFC Wallet.

Esta configuración se denomina inscripción del dispositivo (también conocido como inscripción CPS).

Diagrama de secuencia

Flujo de aprovisionamiento seguro (inscripción del dispositivo y sesión de aprovisionamiento).

Integración del SDK

El aprovisionamiento seguro requiere inscripción del dispositivo.

La inscripción del dispositivo normalmente se requiere una vez por instancia de wallet en un dispositivo. Cuando se requiere la inscripción, el flujo de inscripción desencadena automáticamente la sesión de aprovisionamiento.

Si la inscripción del dispositivo ya está completa, inicia la sesión de aprovisionamiento llamando a ProvisioningBusinessService.sendActivationCode(...).

El SDK solicita el activationCode a través de EnrollingServiceListener.onCodeRequired(...). Proporciona el valor en ese momento.

Requisitos previos

Antes de empezar, asegúrate de tener:

• Inicializado el NFC Wallet SDK. Consulte Inicializar el SDK de NFC Wallet.
• Configurado las notificaciones push y obtenido un token push. Consulte Notificaciones push.
• Recibido el activationCode de la digitalización. Consulta Digitalizar una tarjeta.

Inscripción del dispositivo

La inscripción del dispositivo requiere estas entradas:

• activationCode (byte[]): Devuelto por la digitalización.
• walletId: Obténlo usando MGCardEnrollmentService.getWalletId(). Pasa este valor como el userId parámetro a EnrollingBusinessService.enroll(...). Consulte Obtener el ID de la billetera.
• pushToken: El token de push para FCM o HMS Push Kit.

Prefija HMS Push Kit los tokens con HMS: (por ejemplo, HMS:<token>).

Comprobar el estado de la inscripción del dispositivo

Comprueba el estado de la inscripción del dispositivo usando EnrollingBusinessService.isEnrolled().

Este estado indica si el canal seguro ya está establecido para la instancia actual de wallet en este dispositivo.

Devuelve un EnrollmentStatus:

• ENROLLMENT_NEEDED: Llama a EnrollingBusinessService.enroll(...).
• ENROLLMENT_IN_PROGRESS: Llama a EnrollingBusinessService.continueEnrollment(...).
• ENROLLMENT_COMPLETE: Llama a ProvisioningBusinessService.sendActivationCode(...).

Implemente EnrollingServiceListener

Implemente EnrollingServiceListener para dirigir el flujo de inscripción:

• onCodeRequired: Proporciona el activationCode.
• onComplete: La inscripción del dispositivo se completa correctamente.
• onError: Maneja los errores usando ProvisioningServiceError.

MyEnrollingServiceListener.java

public class MyEnrollingServiceListener implements EnrollingServiceListener {

    // Recibido de MGDigitizationListener.onCPSActivationCodeAcquired(...)
    private final byte[] activationCode;

    public MyEnrollingServiceListener(final byte[] activationCode) {
        this.activationCode = activationCode;
    }

    @Override
    public void onStarted() {
        // Se llama cuando comienza el flujo de inscripción.
    }

    @Override
    public void onCodeRequired(final CHCodeVerifier chCodeVerifier) {
        // Se llama cuando se requiere el código de activación para continuar el flujo.
        final SecureCodeInputer inputer = chCodeVerifier.getSecureCodeInputer();
        for (final byte b : activationCode) {
            inputer.input(b);
        }
        inputer.finish();
    }

    @Override
    public void onComplete() {
        // Se llama una vez que la inscripción del dispositivo se completa correctamente.
        // En un flujo Green, esto normalmente significa que el aprovisionamiento está completo.
    }

    @Override
    public void onError(final ProvisioningServiceError error) {
        // Se llama cuando la inscripción del dispositivo falla.
        // Analice error.getCode() y aplique la lógica correcta de reintento / recuperación.
    }
}

Implementación del código de inscripción del dispositivo

byte[] activationCode = ...; // de MGDigitizationListener.onCPSActivationCodeAcquired(...)
String pushToken = "..."; // de FCM o HMS Push Kit
String language = "en"; // Usa la configuración regional de tu app cuando sea posible.

// El ID de wallet es el identificador de usuario para la inscripción del dispositivo.
String walletId = MobileGatewayManager.INSTANCE.getCardEnrollmentService().getWalletId();

EnrollingServiceListener enrollingListener = new MyEnrollingServiceListener(activationCode);

final EnrollingBusinessService enrollingService = ProvisioningServiceManager.getEnrollingBusinessService();
final ProvisioningBusinessService provisioningBusinessService = ProvisioningServiceManager.getProvisioningBusinessService();

// Comprueba el estado de inscripción.
final EnrollmentStatus status = enrollingService.isEnrolled();
switch (status) {
    case ENROLLMENT_NEEDED:
        // Primer intento de inscripción del dispositivo en esta instancia de wallet.
        enrollingService.enroll(walletId, pushToken, language, enrollingListener);
        break;
    
    case ENROLLMENT_IN_PROGRESS:
        // La inscripción se inició antes y debe reanudarse.
        enrollingService.continueEnrollment(language, enrollingListener);
        break;
    
    case ENROLLMENT_COMPLETE:
        // La inscripción del dispositivo ya está completada.
        // Desencadena el aprovisionamiento de esta tarjeta.
        // El SDK solicita el código de activación a través de enrollingListener.onCodeRequired(...).
        provisioningBusinessService.sendActivationCode(enrollingListener);
        break;
    
    default:
        // Registrar error (estado desconocido).
 }