Desarrollador de OneSpan: Autenticación Adaptativa Inteligente - Punto Final de Asignación del Autenticador

Hakim Aldaoub, 16 de Septiembre de 2020

OneSpan Developer: Intelligent Adaptive Authentication – Authenticator Assignment Endpoint

En el blog anterior, demostramos cómo consultar los autenticadores para obtener una lista de las instancias disponibles para utilizar en un dominio específico. Hoy mostraremos cómo asignar un autentificador para un usuario específico utilizando la API interactiva del Sandbox de OneSpan Intelligent Adaptive Authentication (IAA)

Antes de empezar

Antes de explorar el servicio web de Assign Authenticator, debe ser miembro de la Comunidad OneSpan y registrarse para obtener una cuenta gratuita de la caja de arena de Autenticación Adaptativa Inteligente. Aquí tienes las instrucciones paso a paso para hacerlo.

También debes asegurarte de tener al menos un usuario registrado antes de intentar esta llamada. Para saber cómo registrar un usuario, consulte este blog detallado sobre el registro de usuarios.

URL del punto final

https://{su_identificación_del_arrendatario}.sdb.tid.onespan.cloud/v1/autenticadores/{número_de_serial}

No necesitarás proporcionar esta URL durante el tutorial. Es sólo para mostrar la estructura de la URL. La URL se asignará automáticamente en la API interactiva cuando se llame al servicio web

Pruébalo

Para experimentar con la API de asignación de autenticadores, navegue hasta el documento de la API interactiva IAA Sandbox en su cuenta de la Comunidad OneSpan. En el editor de Open API Swagger, expanda el recurso "Authenticators". A continuación, encontrará una entrada para el método HTTP Post de asignación de autenticadores, como se muestra en la imagen siguiente

Parámetros de la ruta URL:

El único parámetro de ruta que se requiere para la API de asignación de autenticadores es el número de serie del autenticador, que pretendemos asignar para el usuario especificado en el cuerpo de la solicitud. La variable serialNumber es de tipo string. Es un identificador único formado por tres letras y siete dígitos. Por ejemplo, un número de serie podría ser VDS0066822.

Como se ha observado en la URL de asignación del autentificador anterior, es necesario proporcionar un número de serie para que el autentificador se asigne al usuario. Para ello, tendremos que buscar los autentificadores disponibles en un dominio concreto y, a continuación, obtener el número de serie del autentificador para asignarlo al usuario final. Si no sabe cómo hacerlo, ¡podemos ayudarle! Consulte nuestro blog anterior, Desarrollador de OneSpan: Autenticación Adaptativa Inteligente - Punto Final de Consulta de Autenticadores

Cuerpo de la solicitud de asignación de autenticador

En la API interactiva del entorno de pruebas, la carga útil de la solicitud del punto final "Asignación del autenticador" se parecerá al ejemplo siguiente:


{ "dominio": " ospanuser-mail", "userID": " iaa_user" }

Contiene dos objetos JSON obligatorios que se muestran en la siguiente tabla:

Campos de datos obligatorios JSON	Descripción	Campo Tipo de datos
dominio*	El dominio en el que reside la cuenta de usuario a la que se va a asignar el autentificador.	Tipo: cadena minLength: 1 maxLength: 255 ejemplo: ospanuser-mail
iD de usuario*	El identificador del usuario al que se asignará el autentificador	Tipo: cadena minLength: 1 maxLength: 255 ejemplo: iaa_user

Llamada al punto final

Llegados a este punto, estamos preparados para realizar una llamada RESTful al punto final de asignación de autenticadores utilizando la API interactiva del Sandbox de la IAA. Para realizar la llamada, haga clic en el botón "Probar" que se muestra en la siguiente captura de pantalla y que se encuentra a la derecha de la sección del método HTTP POST. Una vez solicitado, recibirá el cuerpo de la respuesta en formato JSON. Será similar a la carga útil de respuesta descrita en la siguiente sección.

Carga útil de la respuesta

A continuación se muestra un ejemplo del cuerpo de respuesta devuelto de una llamada exitosa para asignar un autentificador


{ "applications": [ { "name": "ACTIVATION", "type": "MA" } ], "created": "2018-09-07T11:52:32Z", "domain": "osiaa4-mailinator", "lastModified": "2020-09-15T04:40:28Z", "serialNumber": "VDS0066822", "activation": { "activationsCount": "2", "locationsCount": "0", "bound": false, "lastActivated": "2020-09-10T04:40:28Z" }, "assignedUserID": "userid1", "authenticatorType": "DAL10", "assigned": true }

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

La siguiente tabla ofrece información más detallada sobre cada una de las propiedades de la carga útil de la respuesta anterior.

Objeto de respuesta	Descripción	Tipo de datos
aplicaciones*	Lista de aplicaciones soportadas por el autentificador. Cada entrada tendrá el nombre y el tipo de una aplicación	Tipo: lista JSON Ejemplo: "aplicaciones": [{ "nombre": ACTIVACIÓN", "tipo": "MA" } ]
asignado*	Indica si este autentificador está asignado a un usuario.	Tipo: booleano Ejemplo: Verdadero o Falso
creado*	Fecha de creación del autentificador.	Tipo: cadena Ejemplo: 2019-02-04T11:42:39Z
dominio*	El dominio en el que reside la cuenta de usuario a la que se va a asignar el autentificador.	Tipo: cadena minLength: 1 maxLength: 255 ejemplo: ospanuser-mail
lastModified*	Fecha de la última modificación del autentificador.	Tipo: cadena Ejemplo: 2019-02-04T11:42:39Z
número de serie*	El número de serie del autentificador.	Tipo: cadena Ejemplo: "VDS0066822"
activación	Tendrá cuatro atributos, "bound" para indicar si el autentificador está vinculado a un dispositivo específico, "activationsCount" para mostrar el número de activaciones. "lastActivated" para mostrar la última fecha de activación del autentificador. "locationsCount" para mostrar el número de ubicaciones de activación.	Tipo: Lista JSON Ejemplo: Véase la carga útil de la respuesta anterior
assignedUserID	El usuario al que está asignado este autentificador.	Tipo: cadena Ejemplo: "iaa_user1"
authenticatorType	El tipo de autentificador.	Tipo: cadena Ejemplo: "DAL10"

En este blog, explicamos cómo aprovechar el punto final "Asignar autenticador" para asignar un autenticador Digipass a un usuario final a través de la API del Sandbox IAA

Si tiene alguna pregunta sobre este blog, no dude en ponerse en contacto con nosotros en los foros del portal de la comunidad de OneSpan

Consulte más puntos finales de la categoría Authenticators:

OneSpan Blog