Orchestration SDK (Java Edition) - Activación de dispositivos de confianza con Android Studio: Parte I

Hakim Aldaoub, 14 de Octubre de 2020

Orchestration SDK (Java Edition) – Trusted Device Activation with Android Studio: Part 1

En este blog, demostraremos cómo aprovisionar una instancia de usuario y activar su autentificador en el dispositivo del usuario final. Este se convertirá en el dispositivo de confianza para este único usuario registrado, y entonces se le notificará cada vez que OneSpan Intelligent Adaptive Authentication (IAA) decida que es necesario un paso a un método de autenticación específico, basado en el nivel de riesgo asociado a una actividad. Una aplicación Android de ejemplo utilizará nuestro SDK de orquestación para activar la instancia de usuario.

El SDK de orquestación de OneSpan forma parte de Mobile Security Suite (MSS). Junto con el aprovisionamiento seguro, del que hablaremos hoy, el SDK de orquestación permite a los desarrolladores de dispositivos móviles integrar las principales funciones proporcionadas por OneSpan Mobile Security, como la firma de transacciones, el reconocimiento de huellas dactilares, el canal seguro, la protección por contraseña y la autenticación de dos factores, entre otras

Para aprovisionar completamente la cuenta de usuario, se producirá un intercambio de comandos de activación entre el SDK de Orchestration Client, su servidor de aplicaciones y su servidor de autenticación OneSpan IAA.

Requisitos

Android Studio IDE: está disponible de forma gratuita en el sitio web de Android Studio. Necesitará la versión 4.0.1 o posterior.
Java Development Kit (JDK) 1.6 o posterior: también debe asegurarse de que la ruta del entorno del sistema incluye Java.
Cuenta de Google para el servicio de mensajería en la nube Firebase: es necesaria para enviar notificaciones push desde el SDK de notificaciones push de la IAA a su aplicación móvil.
Cuenta comunitaria de OneSpan
Orchestration SDK.zip: incluye la aplicación de ejemplo para Android utilizada en este blog.

Importar la aplicación de ejemplo a Android Studio

Descargue el SDK de orquestación desde el enlace proporcionado anteriormente en la sección de requisitos
Descomprima el contenido de Orchestration SDK.zip.
Importe el proyecto de la aplicación de ejemplo en Android Studio como se muestra a continuación. Se encuentra en el directorio "Orchestration SDK\Client API\Android" que está dentro del archivo Zip.

Espere unos segundos para que el proyecto se construya dentro del IDE.

Si navega por el proyecto de la aplicación de ejemplo, observará que la integración del cliente del SDK de orquestación se consigue implementando unas cuantas anulaciones de devolución de llamada en el código Java de su aplicación móvil y recopilando los datos de registro de la instancia de usuario que se va a activar. A continuación se muestran algunos ejemplos de las llamadas de retorno y sus métodos que se pueden utilizar para diferentes actividades en su código Java:

OnlineActivationCallback será implementado por la clase ActivationActivity en la aplicación de ejemplo.
LocalAuthenticationCallback será implementado por la clase LocalAuthenticationActivity en la aplicación de ejemplo.
ChangePasswordCallback será implementado por la clase ChangePasswordActivity en la aplicación de ejemplo.
LocalTransactionCallback será implementado por la clase LocalTransactionActivity en la aplicación de ejemplo.
RemoteAuthenticationCallback y RemoteTransactionCallback será implementado por la clase ActivationActivity en la aplicación de ejemplo.
OnlineActivationCallback será implementado por la clase ActivationActivity en la aplicación de ejemplo.
NotificationRegistrationCallback será implementado por la clase MainActivity en la aplicación de ejemplo.

Configuración de Firebase para la mensajería en la nube:

Para registrar su aplicación para las notificaciones push, necesitará crear una instancia de Firebase para obtener la clave de la API web y los valores del ID del remitente, que son generados por el servicio de mensajería en la nube, Firebase. Siga los siguientes pasos:

Utiliza tu cuenta de Google para acceder a la consola de Firebase.
Configure un nuevo proyecto Firebase, haga clic en el símbolo "Añadir proyecto" que se muestra a continuación.

Llamemos al proyecto MySampleApp y hagamos clic en "Continuar".
Tendrá la opción de habilitar Google Analytics para este proyecto. Puedes desactivar esta opción ya que no afectará a este proyecto y hacer clic en "Continuar" para finalizar la creación del proyecto.
Desde la página del proyecto, haga clic en el icono del engranaje que se muestra en la captura de pantalla siguiente y, a continuación, en "Configuración del proyecto".

En los ajustes del proyecto, encontrará los parámetros cruciales para configurar la notificación push para su proyecto. Tenga a mano el valor de la "Clave de la API web" de la pestaña "General" y el valor del ID del remitente de la pestaña "Mensajería en la nube" para utilizarlos en los próximos pasos.

Registre su aplicación para recibir notificaciones push

Para completar este paso, debe ser miembro de la Comunidad OneSpan. Para obtener instrucciones sobre cómo registrarse para obtener una cuenta gratuita de la caja de arena de autenticación adaptativa inteligente, consulte nuestro blog "Soluciones en la nube de OneSpan en acción - Demostración del portal web de MyBank, parte 1".
Desde su cuenta de la Comunidad OneSpan, navegue hasta la pestaña "Sandbox", luego haga clic en "Actualizar la aplicación" como se muestra en la siguiente captura de pantalla

Después de eso, aparecerá la ventana Register My App que se muestra a continuación

Seleccione el botón de radio para "Usar mi propia aplicación móvil". A continuación, marque la opción "Configuración de la aplicación Android" y pegue la clave de la API web obtenida de Firebase anteriormente.

Por último, haga clic en "Registrar la aplicación" en la parte inferior para finalizar el registro de su aplicación para las notificaciones push.

El último paso para registrar su aplicación para el servicio de notificaciones push es colocar el ID del remitente obtenido previamente de la consola de Firebase en el lugar de la cadena ANDROID_SENDER_ID de la clase Java Constants, como se muestra en el siguiente fragmento de código.

Con todo lo que hay en este blog completado, estamos a mitad de camino. En la parte 2 de esta serie, configuraremos el SDK desde Android Studio, veremos más de cerca la función de activación en el SDK de Orchestration y finalizaremos la activación. Mientras tanto, si tiene alguna pregunta sobre el contenido, no dude en ponerse en contacto con nosotros en los foros del portal de la comunidad de OneSpan.