OneSpan Sign Developer : Outil d'attribution d'accès aux délégués

Duo Liang, mars 10, 2021

Dans le panneau OneSpan Sign, lorsque l'adresse électronique d'un expéditeur est modifiée, l'une des solutions sous-jacentes consiste à inviter un nouvel expéditeur sous le compte principal, puis à attribuer une délégation individuelle au nouvel expéditeur. Ceci est fait afin de préserver les transactions terminées, archivées et en cours. Les administrateurs de comptes peuvent suivre un processus manuel pour configurer l'accès des délégués, comme indiqué dans notre blog précédent. Toutefois, ce processus peut devenir très chronophage s'il est effectué régulièrement

Dans ce blog, nous présenterons l'outil intégré "Outil d'affectation des délégués", qui rationalise ce processus en organisant les informations des délégués et des délégataires dans un fichier CSV et en affectant l'accès des délégués en masse. Sans plus attendre, commençons !

Conditions préalables

L'outil est une intégration Java basée sur le service API OneSpan Sign. Assurez-vous que vous disposez de toutes les informations nécessaires et de l'environnement adéquat pour exécuter le fichier Jar exécutif

Installer l'environnement JRE/JDK (1.8 ou supérieur)
Clé API OneSpan Sign ou nom d'utilisateur + mot de passe de votre compte
Téléchargez l'outil à partir du Code Share de la communauté des développeurs.

Modifier le fichier CSV

Le fichier CSV contenant les informations sur les délégués et les délégants est le véhicule qui permet de transmettre les données dans l'outil et de mettre à jour ultérieurement les profils des expéditeurs dans le compte OneSpan Sign :

Pour identifier un délégué/délégataire, vous pouvez saisir l'email ou l'ID de l'expéditeur, comme tel :

3-10-1

Si le délégué n'est pas devenu un émetteur de compte, vous pouvez fournir des colonnes supplémentaires dans le fichier CSV. L'outil invite l'expéditeur en conséquence avant d'attribuer l'accès au délégué :

3-10-2

Les en-têtes de colonne disponibles sont "ID du délégué", "Email du délégué", "ID du délégué", "Email du délégué", "Prénom du délégué", "Nom du délégué", "Société du délégué", "Langue du délégué", "Fuseau horaire du délégué". Téléchargez un exemple de fichier CSV.

Note :

Les noms des colonnes sont insensibles à la casse
Les colonnes peuvent suivre un ordre aléatoire
L'outil n'invite le délégué que si l'Email/ID du délégué n'existe pas

Exécution de l'outil

Une fois que vous avez entièrement préparé le fichier CSV d'entrée, il est temps d'exécuter l'outil ! L'outil met en œuvre un assistant étape par étape, que vous trouverez intuitif à suivre. Une fois le fichier Jar exécutif lancé, la première étape consiste à sélectionner une instance OneSpan Sign et à saisir la clé API ou les informations d'identification de l'utilisateur admin. En outre, si votre machine se connecte par le biais d'une passerelle, des paramètres proxy correspondants sont également nécessaires. Ces paramètres de proxy permettent de s'assurer que les appels API peuvent atteindre le serveur OneSpan Sign.

Cliquez sur le bouton "Test Connection", et l'instance OneSpan Sign sélectionnée sera testée avec les informations d'identification données

3-10-3

Une fois que l'outil indique que les informations d'identification sont valides, passez à l'étape suivante où vous serez invité à sélectionner le fichier CSV via l'explorateur de fichiers. Prenez le temps de vous assurer que les informations chargées dans l'outil sont identiques à celles du fichier CSV d'entrée. Puis cliquez sur "Attribuer une délégation". Une fois que le délégué s'est vu accorder l'accès, une coche s'affiche en temps réel devant chaque ligne.

3-10-4

Examiner le rapport sur les résultats

Une fois que l'outil a terminé, il génère un rapport ainsi qu'un fichier journal dans le même dossier que le fichier CSV d'entrée. Le fichier de rapport confirme le résultat de chaque processus. Les opérations échouées seront signalées dans la colonne "Message supplémentaire" avec la trace complète de l'erreur.

3-10-5

Voilà. Ce blog couvrait la valeur évidente de l'outil de délégation d'affectation et démontrait ses fonctions principales. Si vous avez rencontré un problème lors de l'utilisation de l'outil ou si vous avez des idées d'amélioration, n'hésitez pas à répondre dans ce message de partage de code. Si vous avez d'autres questions concernant l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs. Vos commentaires sont importants pour nous!