OneSpan Sign Release 11.41 : Auto-Redirect Handover URL

Duo Liang, mai 5, 2021

OneSpan-BlogImage-OneSpan Sign Release 11.41

La version 11.41 de OneSpan Sign a été récemment déployée dans l'environnement de prévisualisation et de sandbox. Dans cette dernière version, nous avons introduit plusieurs améliorations concernant l'URL de transfert. Nous avons également fourni la fonction de reporting in-app qui permet aux administrateurs de comptes de télécharger les données structurées des transactions mensuelles. En plus de cela, nous avons continuellement amélioré l'expérience du nouveau signataire, comme la prise en charge des notifications JavaScript dans les vues Web, et plus encore. Pour une liste complète des mises à jour du produit, consultez la note de mise à jour 11.41. Consultez également notre Trust Center et trouvez les dates de déploiement pour tous nos environnements.

Dans ce blog, nous allons vous présenter trois améliorations et changements de comportement du produit autour de l'URL de transfert, afin que vous ayez une meilleure idée de la façon de tirer parti de cette fonctionnalité dans votre intégration. Sans plus attendre, commençons !

Redirection automatique des signataires après la signature

Une URL de transfert est un lien de redirection qui vous permet de déterminer où la cérémonie de signature sera déplacée après qu'un destinataire ait interagi avec une transaction. Vous pouvez simplement rediriger le lien vers la page d'accueil de votre organisation ou utiliser ce mécanisme de redirection comme un webhook et renvoyer la page vers votre flux d'activités. Cette dernière option est particulièrement intéressante si vous n'intégrez pas la cérémonie de signature dans un iFrame, mais que vous devez tout de même contrôler le flux de signatures.

5-5-1

Dans l'expérience de signature précédente, une page de résumé de remerciement s'affichait après la signature, et le signataire devait cliquer manuellement sur le bouton de l'étape suivante pour déclencher la redirection. Bien que vous puissiez certainement inclure des instructions descriptives dans la page, il est toujours possible que certains signataires aient ignoré d'appuyer sur le bouton et ne sachent pas quoi faire ensuite.

Ce ne sera plus le cas depuis la version 11.41, car les propriétaires de comptes ont la possibilité de rediriger les signataires après qu'ils aient fini de signer. Au lieu de la page récapitulative de remerciement, une page intermédiaire sera affichée pendant la redirection pour informer les signataires de ce qui se passe.

5-5-2

Pour l'instant, les signataires resteront sur cette page provisoire pendant 10 secondes avant d'être redirigés, mais ils peuvent déclencher manuellement la redirection à tout moment.

Note :

Si vous retournez à la cérémonie de signature après l'avoir terminée, la page de résumé s'affichera au lieu de déclencher la redirection automatique.
Le titre et le corps de cette page peuvent être personnalisés. Il suffit de fournir votre propre copie à notre équipe d'assistance, et nos agents d'assistance vous aideront à configurer votre compte

Nous vous montrerons comment activer cette fonctionnalité à la fin de ce blog.

Paramètres configurables de l'URL de transfert

Une fois la redirection effectuée, OneSpan Sign ajoute des paramètres URL supplémentaires à l'URL de transfert, afin que votre application puisse être informée de l'événement et le traiter en conséquence.

Par exemple, si vous avez spécifié l'URL de transfert comme étant "https://localhost/oss/handover" après que le destinataire dont l'ID de signataire est "Signer1" a refusé la transaction (ID de "T840KlFsIeC--LqGu9O9Enp9T6I"), les informations associées à cet événement seront transmises par des paramètres, et le lien réel que le destinataire consultera ressemblera à ceci :

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

Ces trois paramètres représentent chacun :

Package: Il s'agit de l'ID de la transaction
Signataire: Il s'agit de l'ID du signataire plutôt que de l'ID du rôle. Pour en savoir plus sur les différences détaillées entre le signataire et le rôle, lisez notre blog précédent "Rôle vs Signataire - Partie 1".
Statut: Les valeurs disponibles sont "SIGNER_COMPLETE" ou "PACKAGE_DECLINE".

Dans cette version 11.41, OneSpan Sign a introduit la possibilité pour les expéditeurs de colis de choisir d'afficher ou non une partie de ces trois paramètres en fonction de vos besoins particuliers et pour mieux protéger la vie privée des signataires. Par défaut, l'URL de transfert sera toujours attachée aux trois paramètres, et nous allons montrer comment définir des paramètres partiels dans la section ci-dessous.

Un avis important

En termes d'URL de transfert, il existe des incohérences connues entre l'expérience du nouveau signataire, l'expérience de la signature classique et la cérémonie de la signature mobile. Étant donné que Classic Signing Experience est sur le point d'être déprécié dans les environnements SaaS, il est important de comprendre ces incohérences et de prévoir la mise à jour de vos intégrations existantes :

Dans l'expérience classique, le paramètre "status" avait trois valeurs potentielles "COMPLETED", "PACKAGE_OPT_OUT" et "PACKAGE_DECLINE". Ils ont été changés en "SIGNER_COMPLETE" et "PACKAGE_DECLINE" dans l'expérience du nouveau signataire.

En outre, "COMPLETED" a été renommé "SIGNER_COMPLETE". Si votre intégration utilise le paramètre "status", vous devez mettre à jour votre intégration pour remplacer la valeur du paramètre ou pour accepter les deux statuts afin d'éviter les conflits. Le pseudo-code ci-dessous vous montre l'idée :

Code existant : status.equals("COMPLETED") Nouveau code : status.equals("COMPLETED") OR status.equals("SIGNER_COMPLETE")

Comme la fonction de retrait n'est pas prise en charge dans New Signer Experience, la valeur "PACKAGE_OPT_OUT" ne sera plus disponible.

Comment activer la redirection automatique et configurer les paramètres ?

API RESTful

L'activation de la redirection automatique et la configuration des paramètres URL sont toutes deux définies dans le paramètre du paquet "settings" > "ceremony" > "handOver". L'exemple ci-dessous montre comment organiser le nœud "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" }

Note :

Par défaut, la valeur de "autoRedirect" est fixée à false.
Bien que les valeurs des "paramètres" ne soient pas sensibles à la casse, le nom réel du paramètre sera tout en minuscules
Pour supprimer tous les paramètres de l'URL de transfert, il suffit de laisser un tableau vide ("parameters" :[]).

L'exemple de code ci-dessous montre le code SDK équivalent pour construire un objet DocumentPackage avec auto-redirection et paramètres de configuration. Avant de suivre le code, assurez-vous d'avoir mis à jour votre SDK à la version 11.41 ou ultérieure.

SDK 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 .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() ;

Niveau du compte

Vous pouvez soit spécifier ces paramètres pour chaque transaction, soit définir la valeur par défaut au niveau du compte en contactant notre équipe d'assistance. Si vous choisissez le dernier cas, toutes les transactions nouvellement créées hériteront de ces paramètres.

Voilà. Dans ce blog, nous avons couvert les récentes améliorations concernant l'URL de Handover. Restez à l'écoute, et nous vous apporterons d'autres mises à jour dans les prochains numéros.

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!