Comment configurer l'identification validée pour l'utiliser avec le flux de travail ?

Question :
Comment puis-je configurer un workflow pour utiliser le service de signature de Validated ID ?

Réponse :
Veuillez suivre les instructions ci-dessous pour configurer votre système DocuWare afin d'utiliser le service de signature de Validated ID.

Étape 1 : Enregistrer l'organisation auprès du service de signature de Validated ID :

Pour enregistrer un jeton de production, utilisez cettepage Web.Il nous sera demandé de nous connecter à Validated ID et d'utiliser les informations d'identification du compte Validated ID que nous souhaitons activer avec notre service de signature pour nous connecter à Validated ID en leur nom.

Une fois connecté à Validated ID, nous serons redirigés vers la page d'enregistrement. Ici, vous devez indiquer votre organisation, l'URL de DocuWare et fournir un nom d'utilisateur et un mot de passe DocuWare. En outre, nous devons fournir une adresse électronique valide à laquelle le jeton sera envoyé par courrier électronique. Vous verrez des informations sur votre compte Validated ID, notamment le type d'abonnement et l'identifiant de l'utilisateur qui s'est connecté à l'étape précédente.
Si toutes les informations sont correctes, l'enregistrement sera terminé et nous recevrons sous peu un courrier électronique contenant la clé de protection émise pour votre organisation.



Étape 2 : Ajout du Service de signature DocuWare en tant que service Web :
Avant de configurer un flux de travail avec l'identification validée, nous devons ajouter l'identification validée aux services Web disponibles dans la configuration DocuWare :
https://signature.docuware.cloud/ViDSignatureService.svc



Étape 3 : Configuration du flux de travail de signature



La procédure suivante décrit comment le document dans le flux de travail est envoyé à Validated ID pour être signé et récupéré :

• La condition de déclenchement se produit sur un document
• Le Service de signature DocuWare ne prend en charge que les PDF - le document est converti si nécessaire.
• Le document est envoyé à l'application Web de Validated ID.
• L'utilisateur ouvre un e-mail et clique sur un bouton qui l'envoie vers Validated ID, où il peut consulter le document.
• L'utilisateur peut avoir besoin de répondre à certaines exigences d'authentification (code d'accès, téléphone, SMS ou authentification basée sur les connaissances). Il peut ensuite signer le document.
• L'application Validated ID appelle notre service et informe DocuWare que le document a été signé.
• DocuWare récupère le document qui a été mis à jour avec une signature, à la fois dans les métadonnées et en plaçant une image de la signature à un endroit spécifique du document.
• La version signée du document peut soit remplacer le document original, soit être jointe à ce dernier. En outre, un champ d'index est mis à jour avec une valeur spécifique. Cette valeur peut être une condition de déclenchement pour un autre flux de travail, par exemple.

Les spécificités du flux de travail dépendront du cas d'utilisation auquel nous répondons. L'application d'une signature à un document de flux de travail nécessite deux activités de flux de travail : "Attribution de données" et "Service Web".

Attribution de données
La première étape consiste à appliquer l'activité de flux de travail "Attribution de données". Cette étape crée des variables globales pour tous les paramètres et leur attribue des données qui seront utilisées pour appeler le service web. Il est recommandé de nommer les variables globales de la même manière que les paramètres qu'elles sont censées représenter.

Pour plus de détails et de paramètres, voir ce qui suit. Cette activité est basée sur la méthode AddNewDocumentRemote:

• FileCabinetId (string) - GUID de l'armoire contenant le document
• DocId (chaîne) - ID du document à signer
• Token (chaîne) - jeton reçu lors de l'étape d'enregistrement qui identifie l'organisation du client et fournit les informations d'identification de l'utilisateur
• SignerName - nom de la personne qui signe le document
• SignerEmail - adresse électronique du signataire du document
• SectionNumber (int) - index de la section dans le document à signer
  -1 indique la dernière section trouvée.
  0ou 1 sera la première section.
  Une erreur se produira si une section inexistante est spécifiée.
• AnchorText (chaîne) - Il s'agit du texte que le service peut rechercher dans le document. S'il est spécifié et non trouvé, une erreur se produira. Si elle n'est pas spécifiée, les informations de localisation ultérieures seront absolues, plutôt que relatives à la recherche d'un élément de texte.
• AnchorTextOccurrence - L'occurrence du texte d'ancrage à utiliser comme point de départ pour placer la signature
  -1 est la dernière occurrence.
  0ou 1 est la première.
  Tout autre nombre est une occurrence spécifique.
• PageNumber (int) - numéro de page dans le fichier où commencer à chercher le texte d'ancrage. -1 indique qu'il faut chercher à la dernière page. Si aucun texte d'ancrage n'est spécifié, il s'agit du numéro de page absolu.
• SizeX (int) - taille en millimètres de la largeur de l'image de la signature
• SizeY (int) - taille en millimètres de la hauteur de l'image de la signature
• PositionX (int) - Par rapport au côté gauche du texte d'ancrage, il s'agit de l'emplacement horizontal de l'image de la signature à placer sur le document (en millimètres). Les nombres positifs sont à droite. Les nombres négatifs sont vers la gauche.
• PositionY (int) - Par rapport au haut du texte d'ancrage, il s'agit de l'emplacement vertical de l'image de la signature à placer sur le document (en millimètres). Les nombres positifs sont vers le bas. Les nombres négatifs sont vers le haut.
• SuccessStatusField (string) - Identifie un champ d'armoire sur le document qui sera mis à jour lorsqu'un document est signé ou rejeté par l'utilisateur dans Validated ID.
• SuccessStatusValue (string) - Fournit la valeur à définir dans le champ ci-dessus lorsqu'un document est signé.
• FailureStatusValue (string) - Valeur à définir dans le champ ci-dessus lorsqu'un document est rejeté par l'utilisateur dans Validated ID.
• DateSignedFieldName (string) - Ce paramètre facultatif peut être utilisé pour indiquer le nom d'un champ de l'armoire contenant la date de signature du document. Une fois le document signé, ce champ est mis à jour avec la date de signature par l'utilisateur dans Validated ID.
• PostSigningAction (chaîne) - Ce champ indique ce qu'il faut faire du document signé après que l'utilisateur l'a signé dans Validated ID. Les choix possibles sont "ClipBefore", "ClipAfter" et "Replace".
• IssuerName (chaîne) - Nom d'affichage utilisé pour l'expéditeur du courrier électronique et dans le contenu du message. Si cette valeur n'est pas renseignée, le nom de l'organisation sera utilisé par défaut.
• EmailSubject (string) - Objet de l'e-mail.
• EmailMessage (chaîne) - Texte affiché dans le contenu de l'e-mail.
• EmailLanguage (chaîne) - Langue dans laquelle l'e-mail sera affiché ainsi que la page où se déroule le processus de signature. Si cette valeur n'est pas renseignée, la valeur par défaut est en (anglais). Les valeurs valides sont : ca, en, es, de, fr. Ces valeurs correspondent respectivement au catalan, à l'anglais, à l'espagnol, à l'allemand et au français.
• DaysBeforeExpiration (int) - si la valeur fournie est supérieure à 0, le document sera limité à ce nombre de jours avant d'expirer. Si le délai est dépassé, le document sera considéré comme refusé. Il sera supprimé du service VidSigner et le signataire ne pourra plus le signer.
• SendSignedDocument (booléen) - si ce paramètre a la valeur "true", le signataire recevra une copie du PDF qu'il a signé après avoir terminé.
• SignerID (chaîne de caractères) - Ce paramètre est requis lors de l'utilisation du produit de signature centralisée de VIDSigner. Dans la plupart des cas, il s'agit d'un numéro de passeport. Lorsque ce paramètre est utilisé pour la signature biométrique ou la signature à distance, il est facultatif.
  Ces trois éléments d'information sur le signataire déterminent qui est invité à signer le document dans VIDsigner. Si ces informations sont incorrectes, l'utilisateur ne pourra pas examiner et signer le document dans VIDsigner.
• IncludeReport (booléen) - ce paramètre est facultatif, mais s'il est fourni, il doit avoir une valeur de "true" (vrai) ou "false" (faux). En lui attribuant la valeur "true", un second PDF sera ajouté au document après le document signé. Ce PDF contient des informations sur le signataire et le certificat numérique qui a été ajouté au document.
• RejectionReasonFieldName (chaîne) - Facultatif. Ce paramètre spécifie un champ d'index sur le document qui doit être un champ de caractères. Lorsque l'utilisateur refuse de signer le document, l'application VidSigner lui demande de fournir une raison. S'il refuse de signer et entre une raison, le texte qu'il a entré sera placé dans ce champ.
• ReminderFrequencyHours (int) - un rappel peut être envoyé au signataire pour qu'il signe le document s'il n'a pas été signé. Cette valeur détermine la fréquence d'envoi du rappel.
• ReminderMaxRetries (int) - cette valeur détermine le nombre de rappels envoyés au signataire si le document n'est pas signé.
• RecipientAuthenticationType (string) - Ce paramètre permet au flux de travail de spécifier le type d'authentification par ID validée requis pour permettre au signataire de signer un document. Les valeurs valides sont "None", "AccessCode", "Phone", "SMS", "KBA"
• SignerPhoneNumber (chaîne) - numéro de téléphone utilisé pour l'authentification à deux facteurs (utiliser le format de numéro de téléphone international, par exemple +18455639045) pendant le processus de signature. Requis pour l'authentification par SMS.
• RecipientMayProvideNumber (booléen) - Uniquement pour l'authentification par téléphone. Si la valeur est "true", elle ignore toute valeur définie par l'utilisateur dans le numéro de téléphone. Au moment de la signature, le signataire peut alors fournir le numéro à appeler pour recevoir le code en le saisissant dans l'application d'identification validée.

Service Web
Dans une activité de service Web, sélectionnez le service Web configuré pour Validated ID. Si vous ne voyez pas le service de signature, configurez-le à cet endroit et revenez à cette étape.Ensuite, sélectionnez la méthode de service appropriée que vous souhaitez mettre en œuvre.
Maintenant, dans "Parameters", sélectionnez les variables globales que nous avons créées pour chaque paramètre.





Nous pouvons également choisir d'utiliser les paramètres de résultat. Ceux-ci peuvent être définis comme des variables globales et sont utilisés pour décider de l'étape suivante de votre flux de travail. Par exemple, si le résultat "Success" du service web (trouvé dans le booléen success) est faux, nous pouvons vouloir prendre un chemin différent que si le résultat est vrai.

Message (chaîne) = ResultMessage
Success (booléen) = BoolSuccess
DocGUI (string) = ResultDocID



Une fois ces modifications effectuées, veuillez enregistrer et publier le flux de travail, puis vous serez prêt à utiliser le service de signature d'identité validée .

Le KBA s'applique aussi bien aux organisations en nuage qu'aux organisations sur site.

Veuillez noter : Cet article est une traduction de l'anglais. Les informations contenues dans cet article sont basées sur la ou les versions originales des produits en langue anglaise. Il peut y avoir des erreurs mineures, notamment dans la grammaire utilisée dans la version traduite de nos articles. Bien que nous ne puissions pas garantir l'exactitude complète de la traduction, dans la plupart des cas, vous la trouverez suffisamment informative. En cas de doute, veuillez revenir à la version anglaise de cet article.