Desarrollador OneSpan: Autenticación Adaptativa Inteligente - Registro de Usuario

Hakim Aldaoub, 8 de Julio de 2020
Intelligent Adaptive Authentication

Autenticación adaptativa inteligente OneSpan (IAA) proporciona una API REST de registro de usuarios para el entorno Sandbox para permitirle integrar sin problemas la funcionalidad de registro de usuarios en su aplicación web o móvil. En este artículo, exploraremos la API de registro de usuarios que reside en la API de Sandbox interactivo de OneSpan IAA. Consulte nuestro blog anterior "Introducción a la API de Sandbox de autenticación adaptativa inteligente" para obtener una introducción de la API de Sandbox de IAA. 

Antes de que comencemos

Antes de explorar la API de registro de usuarios, primero debe ser miembro de la Comunidad OneSpan e inscribirse para obtener una cuenta gratuita de sandbox de autenticación inteligente adaptativa. Mira nuestro blog anterior "OneSpan Cloud Solutions en acción: demostración del portal web de MyBank, parte 1" para obtener instrucciones sobre cómo hacerlo.

Introducción

La API de registro de usuario le permite aprovisionar una nueva cuenta de usuario para OneSpan Intelligent Adaptive Authentication y asignar automáticamente un autenticador a esa cuenta de usuario recién creada. Aprovisionar una instancia de usuario en el OneSpan Risk Analytics es esencial para aprovechar las actividades integrales de IAA. 

Navegue a la API interactiva de registro de usuario

Para experimentar con la API de registro de usuarios, navegue a la API interactiva Sandbox de IAA de su cuenta de la comunidad OneSpan. En el editor Open API Swagger, expanda el recurso "Aprovisionamiento". Luego encontrará una entrada para el método HTTP Post de registro de usuario como en la imagen a continuación. 

8 al 20 de julio

 

Ejemplo de la estructura de la URL de la API de registro de usuario

La URL de solicitud para esta llamada a la API se parecerá a la siguiente

https: // {your_tenant_ID} .sdb.tid.onespan.cloud / v1 / users / register

No necesitará proporcionar esta URL durante el tutorial. Es solo para referencia. La URL se asignará automáticamente en la API interactiva al llamar al servicio web. 

Cuerpo de solicitud de API de registro de usuario

En la sección "Cuerpo de solicitud" del punto final de Registro de usuario, seleccione el tipo de objeto "AdaptiveRegisterUserInput" del menú desplegable como se muestra a continuación. Este tipo de objeto se utiliza para crear un nuevo usuario para las actividades de IAA. Luego obtendrá un ejemplo de la carga útil JSON para la solicitud de registro. Se completará con los objetos JSON, que son requeridos por la API del tipo de objeto "AdaptiveRegisterUserInput". 

8 y 20 de julio

El cuerpo de la solicitud se verá como el siguiente ejemplo de los campos obligatorios del punto final "usuarios / registro".

Solicitar carga útil

{

  "objectType": "AdaptiveRegisterUserInput",

  "cddc": {

    "browserCDDC": {

                    "fingerprintRaw": "{navegador: {\" userAgent \ ": Mozilla / 5.0 
                    (Windows NT 6.1; WOW64) AppleWebKit / 537.36 (KHTML, como Gecko)
                     Chrome / 65.0.3325.181 Safari / 537.36},
                    soporte: {\ "ajax \": verdadero, \ "boxModel \": indefinido,
                    \ "changeBubbles \": indefinido, \ "checkClone \": verdadero,
                    \ "checkOn \": verdadero, \ "cors \": verdadero,
                    \ "cssFloat \": indefinido, \ "hrefNormalized \": indefinido,
                    \ "htmlSerialize \": undefined, \ "LeadingWhitespace \": undefined,
                    \ "noCloneChecked \": verdadero, \ "noCloneEvent \": indefinido,
                    \ "opacidad \": indefinido, \ "optDisabled \": indefinido,
                    \ "style \": undefined, \ "submitBubbles \": undefined,
                    \ "tbody \": undefined}, computadora: {\ "screenWidth \": 2560,
                    \ "screenHeight \": 1440, \ "OS \": \ "Microsoft Windows \",
                    \ "plataforma \": \ "Win32 \"}, adicional: {}} ",

    "fingerprintHash": "e96dadc9651f5fe8f071110eb174fe8e7a17a9d7a96b3b1980c13e5b4af3a4d7"

                   }

           },

  "clientIP": "192.168.0.1",

  "relationshipRef": "userid1",

  "staticPassword": "Test1234",

  "sessionID": "4ED23EA44F23",

  "userID": "userid1"

}

 

Descripción de los campos obligatorios de la carga útil solicitada

 Campos de datos obligatorios de JSON Descripción     Tipo de datos de campos
cddc * 

Metodista de Client Device Data Collector. Los dos campos browserCDDC y mobileCDDC son mutuamente exclusivos y colectivamente exhaustivos

Tipo: cadena
Ejemplo: "browserCDDC" o "mobileCDDC"
relacionRef *     La referencia de relación de la ID de usuario

Tipo: cadena
Longitud mínima: 1
Longitud máxima: 150
Ejemplo: iaa_user

staticPassword * La contraseña estática inicial asignada al usuario. 

Tipo: cadena
minLength: 8
maxLength: 255
ejemplo: Test1234

ID de sesión*   Identificador de sesión de aplicación formateado como una cadena hexadecimal; Común para todas las transacciones relacionadas con la misma sesión.

Tipo: cadena
patrón: ^ [0-9a-fA-F] + $
minLength: 2
maxLength: 100
ejemplo: 4ed23ea44f23

ID de usuario * Un identificador único para que el usuario se registre en el sistema.

Tipo: cadena
minLength: 1
maxLength: 255
ejemplo: iaa_user

Llamar al punto final de registro de usuario

Ahora es el momento de enviar la solicitud y registrar al usuario para OneSpan IAA. Para realizar la llamada API, haga clic en el botón "Pruébelo" que se muestra en la captura de pantalla a continuación, en el lado derecho de la sección de método de publicación "/ users / register". Una vez solicitado, recibirá el cuerpo de respuesta nuevamente en formato JSON. Será similar a la carga útil de respuesta descrita en la siguiente sección.

8 y 20 de julio
 

Registro de usuario API Call Response Body:

A continuación se muestra un ejemplo del cuerpo de respuesta devuelto de la llamada API "/ users / register".



  {

    "ActivationPassword": "xK384IF4",

    "serialNumber": "VDS0064137",

    "riskResponseCode": 0

  }


Descripción de los campos de carga útil de respuesta

contraseña de activación : La contraseña de activación que se usará más adelante para activar el autenticador en el dispositivo confiable del usuario final

número de serie : El número de serie del autenticador que se asigna automáticamente a la nueva instancia de usuario

riskResponseCode : El código de respuesta que es específico y devuelve OneSpan Risk Analytics

Una vez que se complete el proceso de registro, recibirá un cuerpo de respuesta similar al ejemplo anterior y con un código de respuesta 200 que indica el registro exitoso de un nuevo usuario para el entorno de IAA Sandbox.

En este blog, describimos cómo registrar un nuevo usuario utilizando la API interactiva de Sandbox de IAA. También hemos explorado la estructura y hemos visto ejemplos de las cargas útiles de solicitud y respuesta, que son requeridas por el punto final "/ users / register". Si tiene alguna pregunta sobre este tutorial, no dude en comunicarse con nosotros en el Foros del portal de la comunidad OneSpan. 

Comunidad de desarrolladores de OneSpan Sign

¡Únase a la comunidad de desarrolladores de OneSpan Sign! Foros, blogs, documentación, descargas de SDK y más.

Únete hoy