OneSpan Sign Versión 11.41: URL de traspaso automático

Duo Liang, 5 de Mayo de 2021

La versión 11.41 de OneSpan Sign se ha desplegado recientemente en el entorno de vista previa y sandbox. En esta última versión, hemos introducido varias mejoras relacionadas con el traspaso de URL. También proporcionamos la función de informes en la aplicación que permite a los administradores de cuentas descargar datos estructurados de las transacciones mensuales. Además, hemos mejorado continuamente la nueva experiencia del firmante, como la compatibilidad con las notificaciones de JavaScript en las vistas web, y mucho más. Para obtener una lista completa de las actualizaciones del producto, consulte la nota de la versión 11.41. Consulte también nuestro Centro de Confianza y encuentre las fechas de despliegue de todos nuestros entornos.

En este blog, le mostraremos tres mejoras y cambios de comportamiento del producto en torno a la URL de traspaso, para que tenga una mejor idea de cómo aprovechar esta característica en su integración. Sin más dilación, ¡comencemos!

Redirigir automáticamente a los firmantes después de firmar

Una URL de traspaso es un enlace de redirección que permite determinar dónde se reubicará la ceremonia de firma después de que el destinatario interactúe con una transacción. Podría simplemente redirigir el enlace a la página de inicio de su organización o utilizar este mecanismo de redirección como un webhook y reenviar la página a su flujo comercial. Esta última opción es especialmente atractiva si no va a incrustar la ceremonia de firma en un iFrame, pero necesita controlar el flujo de la firma.

5-5-1

En la experiencia de firma anterior, se mostraba una página de resumen de agradecimiento después de firmar, y el firmante tenía que hacer clic manualmente en el botón de siguiente paso para activar la redirección. Aunque definitivamente podrías incluir instrucciones descriptivas en la página, es posible que algunos firmantes hayan ignorado tocar el botón y no hayan sabido qué hacer a continuación.

Esto ya no será así desde la versión 11.41, porque los propietarios de las cuentas tienen la opción de redirigir a los firmantes después de que hayan terminado de firmar. En lugar de la página de resumen de agradecimiento, se mostrará una página intermedia durante la redirección para informar a los firmantes de lo que está ocurriendo.

5-5-2

Por ahora, los firmantes permanecerán en esta página provisional durante 10 segundos antes de ser redirigidos, mientras que pueden activar manualmente la redirección en cualquier momento.

Nota:

  • Al volver a la ceremonia de firma una vez finalizada, se mostrará la página de resumen en lugar de activarse la redirección automática.
  • El título y el cuerpo de esta página se pueden personalizar. Sólo tiene que proporcionar su propia copia a nuestro equipo de asistencia, y nuestros agentes de asistencia le ayudarán a configurar su cuenta

Al final de este blog mostraremos cómo activar esta función.

Parámetros configurables de la URL de traspaso

Una vez redirigido, OneSpan Sign añade parámetros de URL adicionales a la URL de traspaso, para que su aplicación pueda estar al tanto del evento y manejarlo en consecuencia.

Por ejemplo, si ha especificado la URL de traspaso como "https://localhost/oss/handover" después de que el destinatario con el ID de firmante "Signer1" haya rechazado la transacción (ID de "T840KlFsIeC--LqGu9O9Enp9T6I"), la información asociada a este evento se pasará por parámetros, y el enlace real que el destinatario pulsará tendrá el siguiente aspecto:

https://localhost/oss/handover?package=T840KlFsIeC--LqGu9O9Enp9T6I%3D&signer=Signer1&status=PACKAGE_DECLINE

Cada uno de estos tres parámetros representa:

  • Paquete: Se refiere al ID de la transacción
  • Firmante: Se refiere al ID del firmante en lugar del ID del rol. Para leer más sobre las diferencias detalladas entre el firmante y el rol, lea nuestro blog anterior "Rol vs Firmante - Parte 1".
  • Estado: Los valores disponibles son "SIGNER_COMPLETE" o "PACKAGE_DECLINE".

En esta versión 11.41, OneSpan Sign ha introducido la posibilidad de que los remitentes de paquetes elijan si desean mostrar parte de estos tres parámetros en función de sus necesidades específicas y para proteger mejor la privacidad del firmante. Por defecto, la URL de traspaso se adjuntará a los tres parámetros, y mostraremos cómo definir parámetros parciales en la siguiente sección.

Un aviso importante

En cuanto a la URL de traspaso, se conocen incoherencias entre la experiencia del nuevo firmante, la experiencia de la firma clásica y la ceremonia de la firma móvil. Debido al hecho de que la Experiencia de Firma Clásica está a punto de quedar obsoleta en los entornos SaaS, es importante entender estas inconsistencias y hacer planes para actualizar sus integraciones existentes:

En la Experiencia Clásica, el parámetro "estado" tenía tres valores potenciales "COMPLETED", "PACKAGE_OPT_OUT" y "PACKAGE_DECLINE". Se han cambiado a "SIGNER_COMPLETE" y "PACKAGE_DECLINE" en New Signer Experience.

Además, se ha cambiado el nombre de "COMPLETED" por "SIGNER_COMPLETE". Si su integración hace uso del parámetro "estado", deberá actualizar su integración para reemplazar el valor del parámetro o aceptar ambos estados para evitar conflictos. El siguiente pseudocódigo muestra la idea:

Código existente: status.equals("COMPLETED") Código nuevo: status.equals("COMPLETED") OR status.equals("SIGNER_COMPLETE")

Dado que la función de exclusión no es compatible con New Signer Experience, el valor "PACKAGE_OPT_OUT" ya no estará disponible.

Cómo activar el redireccionamiento automático y configurar los parámetros

API RESTful

La activación de la redirección automática y la configuración de los parámetros de la URL se definen en la configuración del paquete "ajustes" > "ceremonia" > "handOver". El ejemplo siguiente muestra cómo organizar el nodo "handOver"

{"status": "DRAFT", "settings": {"ceremony": {"handOver": {"href": "https://www.google.com", "text": "Next Step", "title": "Next Step", "autoRedirect": true, "parameters": ["PACKAGE", "SIGNER", "STATUS"] } }, "type": "PACKAGE", "name": "Customizing Signing Ceremony" }

Nota:

  • Por defecto, "autoRedirect" se establecerá en falso.
  • Aunque los valores de los "parámetros" no distinguen entre mayúsculas y minúsculas, el nombre real del parámetro estará en minúsculas
  • Para eliminar todos los parámetros de la URL de traspaso, basta con dejar una matriz vacía ("parameters":[]).

El código de ejemplo que se muestra a continuación demuestra el código equivalente del SDK para construir un objeto DocumentPackage con parámetros de auto-redirección y configuración. Antes de seguir el código, asegúrese de haber actualizado su SDK a la versión 11.41 o posterior.

SDK de Java

DocumentPackage package = PackageBuilder.newPackageNamed("Test Handover URL - " + System.currentTimeMillis()) ...... .withSettings(DocumentPackageSettingsBuilder.newDocumentPackageSettings() .withHandOverLinkHref("https://www.google.com") .withHandOverLinkText("Next Step") .withHandOverLinkTooltip("Next Step") .withHandOverLinkAutoRedirect() .withHandOverLinkParameters(new HashSet(Arrays.asList("signer", "package", "status")) ) .build();

SDK DE .NET

DocumentPackage package = PackageBuilder.NewPackageNamed("Test Handover URL - " + System.currentTimeMillis()) ...... .WithSettings(DocumentPackageSettingsBuilder.NewDocumentPackageSettings() .WithHandOverLinkHref("https://www.google.com") .WithHandOverLinkText("Next Step") .WithHandOverLinkTooltip("Next Step") .WithHandOverLinkAutoRedirect() .WithHandOverLinkParameters(new HashSet("signer", "package", "status")) .Build();

Nivel de cuenta

Puede especificar estos ajustes por transacción o establecer el valor por defecto a nivel de cuenta poniéndose en contacto con nuestro Equipo de Soporte. Si elige este último caso, todas las transacciones recién creadas heredarán esta configuración.

Ahí está. En este blog, hemos cubierto las recientes mejoras relacionadas con la URL de traspaso. Permanezca atento, y le traeremos más actualizaciones de la versión en futuras entregas.

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite los foros de la comunidad de desarrolladores. Su opinión nos importa

Comunidad de desarrolladores de OneSpan Sign

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