Connecteurs OTP

Fonctionnement

Dans Maarch Parapheur, il est possible de faire signer ou valider des utilisateurs externes, via Yousign.
Au moment de signer, l'utilisateur reçoit un code à usage unique (code OTP) sur son adresse mail ou son téléphone portable. Ceci permet d'identifier l'utilisateur.

Administration fonctionnelle

Il est tout d'abord obligatoire de créer un connecteur via l'administration des connecteurs.

Pour obtenir une clé API pour Yousign, il faut se connecter à un compte Yousign et aller dans "Admin/Clés d'API", puis cliquer sur le bouton "Créer une clé API"

Paramétrage technique

Après avoir traité un document dans Yousign, celui-ci va faire un appel REST vers Maarch Parapheur afin de mettre à jour le circuit.
(Plus d'informations sur le fonctionnement des webhook Yousign ici)

La route appelée est : GET: {BASE_URL_PARAPHEUR}/rest/documents/{documentId}/workflows/{workflowId}/files/{trunkedFileId}

• BASE_URL_PARAPHEUR : Url de votre application Maarch Parapheur
• documentId : Identifiant unique du document (main_documents.id)
• workflowId : Identifiant unique du circuit de visa (workflows.id)
• trunkedFiledId : Identifiant du document dans Yousign (workflows_external_informations.informations)

BASE_URL_PARAPHEUR va être automatiquement renseignée avec l'url de votre application Maarch Parapheur. Il faut donc que votre application soit accessible via une adresse publique visible sur internet.