Cambiar un PIN

Para limitar la exposición del PIN en una tarjeta física, la aplicación del emisor delega la tarea de cambiar el PIN al SDK D1.

Estos son los formatos de PIN (del backend del emisor) que actualmente son compatibles:

• PIN ISO0
• PIN 3DES Seccos

Experiencia de usuario

Pantalla de ejemplo de cambio de PIN en la aplicación del emisor

Flujo

Flujo de alto nivel para cambiar un PIN

1. El usuario se autentica en la app bancaria y solicita cambiar el PIN
2. Se realiza una llamada interna al SDK
3. Capturar de forma segura el PIN
4. API de backend D1
5. D1 recifra el PIN de la clave del dispositivo a la clave del emisor
6. Establecer el PIN en el backend del emisor

Diagrama de secuencia

Requisitos previos

• Consumidor, cuenta y tarjeta ya registrados en D1
• El SDK está correctamente inicializado
• La aplicación del emisor llamó a la API de inicio de sesión del SDK D1.

Diagrama de secuencia para el cambio de PIN

APIs requeridas

API	Entrada/Salida	Descripción
Obtener token de autorización	Emisor <- Thales D1	Obtener un token de acceso OAuth 2.0 para llamar al backend del emisor.
Establecer PIN	Emisor <- Thales D1	Establecer el PIN desde la app móvil en el backend del emisor.

APIs condicionales

API	Entrada/Salida	Descripción
API de obtención del contador de cambio de PIN	Emisor <- Thales D1	En caso de PIN Seccos. Se utiliza para recuperar el contador de cambio de PIN necesario para el cálculo del PIN

SDK

Nota

Por seguridad mejorada, la API de Cambio de PIN tiene, de forma predeterminada, un período de espera desde el último inicio de sesión más estricto que las otras APIs. Para garantizar un cambio de PIN exitoso, debes gestionar el flujo de inicio de sesión/reinicio de sesión para completar el inicio de sesión dentro del tiempo asignado antes de enviar el cambio de PIN.

Android

@Nullable
@Override
public View onCreateView(
        @NonNull LayoutInflater inflater,
        @Nullable ViewGroup container,
        @Nullable Bundle savedInstanceState
) {
    View view = inflater.inflate(R.layout.fragment_main, container, false);

    SecureEditText entryEditPin = (SecureEditText)view.findViewById(R.id.pin_entry);
    SecureEditText confirmEditPin = (SecureEditText)view.findViewById(R.id.pin_confirm);
    PINEntryUI.PINEventListener listener = new PINEntryUI.PINEventListener() {
        @Override
        public void onPinEvent(PINEntryUI.PINEvent pinEvent, String additionalInfo) {
            switch (pinEvent){
                case FIRST_ENTRY_FINISH:
                    // cambiar el foco a confirmEditPin
                    break;
                case PIN_MATCH:
                    // habilitar el botón Continuar/Enviar
                    break;
                case PIN_MISMATCH:
                    // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                    break;
            }
        }
    };

    String cardID = ""; // obtenido, por ejemplo, del servidor
    ChangePINOptions options = new ChangePINOptions(4);
    pinEntryUI = d1Task.changePIN(cardID, entryEditPin, confirmEditPin, options, listener);

    Button button = (Button)view.findViewById(R.id.pin_submit);
    button.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            pinEntryUI.submit(new D1Task.Callback<Void>() {
                @Override
                public void onSuccess(final Void data) {
                }

                @Override
                public void onError(@NonNull final D1Exception exception) {
                }
            });
        }
    });
    
    return view;
}

iOS

class ViewController: UIViewController {
    var pinEntryUI: PINEntryUI? = nil
    override func viewDidLoad() {
        let entryEditPin = D1SecureTextField()
        let confirmEditPin = D1SecureTextField()
        let cardID = "" // obtenido, por ejemplo, del servidor
        let options = ChangePINOptions(pinLength: 4)
        pinEntryUI = d1Task.changePIN(cardID, textFieldNew: entryEditPin, textFieldConfirm: confirmEditPin, options: options, delegate: self)
    }

    func onButtonClick() {
        pinEntryUI?.submit { error in 
        }
    }
}

extension ViewController: PINEntryUIDelegate {
    func pinEntryUI(_ pinEntryUI: PINEntryUI, pinEvent: PINEntryUI.PINEvent, additionalInfo: String) {
        switch pinEvent {
            case .firstEntryFinish: 
                // cambiar el foco a confirmEditPin
                break
            case .pinMismatch:
                // habilitar el botón Continuar/Enviar
                break
            case .pinMatch:
                // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                break
        }
    }
}