This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Movil

SDK Android para interacciones de Identidad

1 - SDK

H+ tiene la funcionalidad de poder validar a una persona mediante sus huellas digitales.

Con una foto que captura la huella dactilar es posible verificar que una persona sea quien dice ser. La finalidad de este producto como SDK es que pueda ser integrable dentro de la APK de nuestros clientes.

Integración

Siga las siguientes instrucciones para el correcto uso del SDK:

  1. Abrir el archivo build.gradle a nivel de aplicación.
  2. Ubicar zona de dependencies.
  3. Agregar la siguiente línea de comando.
implementation('id.autentiaplus:sdk:0.0.5@aar') { transitive = true }

Luego, para agregar las dependencias de maven al proyecto sigue los siguientes pasos

  1. Abrir el archivo build.gradle a nivel de proyecto.
  2. Ubicar la zona de repositorios.
  3. Agregar las siguientes líneas de código.
allprojects {
    repositories {
        maven {
		    url "https://artifacts.autentia.io/repository/maven-releases/"  
		    credentials {  
		        username "YOUR_USERNAME"  
			    password "YOUR_PASSWORD"  
		    }  
	    } 
	    maven { url 'https://maven.microblink.com' }
        google()
        jcenter()
	    ...
	}
}

Credenciales

Para poder descargar y utilizar el SDK es necesario colocar las credenciales como aparece en el ejemplo anterior.

Debe solicitar las credenciales a su ejecutivo de ventas o jefe de proyecto asignado.

YOUR_USERNAME: Nombre de usuario de maven

YOUR_PASSWORD: Contraseña del usuario de maven

Requisitos

El SDK requiere que el API mínimo de Android sea 25, como se muestra en la pantalla.

android {
        ...
        defaultConfig {
            minSdkVersion 25
            ...
        }
    ...
}

Implementación

Ambos métodos iniciarán el flujo H+, la diferencia es la siguiente:

El Método 1 requerirá escribir el OTP_MOVIL mediante una interfaz de usuario ya sea de manera manual o mediante lectura de un código QR.

El Método 2 no lo solicitará, ya que asumirá que viene en la llamada y ejecutará este paso automáticamente.

Método 1 - Kotlin

SdkManager(this).hPlusCaller(REQUEST_CODE)

Método 2 - Kotlin

SdkManager(this).hPlusCaller(OTP_MOVIL,REQUEST_CODE)

Parámetros

OTP_MOVIL: Código numérico de 6 dígitos en formato String.

REQUEST_CODE: Código asignado por el usuario en formato Int para obtener la respuesta de H+ en el método onActivityResult.

Resultados

Para obtener los resultados de H+, se utiliza el método

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {  
    super.onActivityResult(requestCode, resultCode, data)  
    if(requestCode == REQUEST_CODE){  
        when (resultCode){  
            Activity.RESULT_OK -> {  
                if(data!=null){  
                    if(data.hasExtra("autentia_sdk_error")){  
                        val sdk_error = data.getStringExtra("autentia_sdk_error")
                        //do something with sdk_error  
                    }  
                    if(data.hasExtra("h_plus_response")){  
                        val sdk_response = data.getBooleanExtra("h_plus_response",false)  
                        //do something with sdk_response 
                    }
                    if(data.hasExtra("autentia_sdk_code")){  
                        val sdk_code = data.getIntExtra("autentia_sdk_code",-1)
                        //do something with sdk_code 
                    }  
                }  
            }  
            Activity.RESULT_CANCELED -> {  
                 //do something with result
            }  
        }  
    }  
}

Posibles respuestas de RESULT_OK

Este resultado se da cuando el SDK termina el flujo completo de manera natural.

autentia_sdk_error: Nombre del error tipo String.

autentia_sdk_code: Código del error ocurrido, tipo Int.

h_plus_response: Indica si la verificación fue exitosa o no, tipo boolean.

Cuando el resultado es exitoso, autentia_sdk_code tendrá valor 0 y h_plus_response puede tomar valor true o false.

El valor true se retorna cuando la validación de identificación fue exitosa.

El valor false se retorna cuando la validación de identificación fue fallida.

Posibles respuestas de RESULT_CANCELED

Este resultado se da cuando el SDK no termina el flujo completo de manera natural, ya que el usuario canceló o cerró el flujo invocado.

H+ maneja los errores de la siguiente manera:

Código Valor Descripción
399 h_plus_otp_error El OTP es inválido
398 h_plus_cancel_permission El usuario canceló los permisos de la aplicación y aseguró que no quería darle permisos (hay un diálogo de confirmación)
397 h_plus_unexpected_error Error no previsto por el SDK