Guide de démarrage rapide de l’intégration intégrée de OneSpan Sign pour CRM

À compter du 1er février 2025, ce connecteur n'est plus disponible à l'achat et à l'installation et sera considéré comme en fin de vie le 1er mars 2026. À ce moment-là, ce connecteur ne sera plus pris en charge.

OneSpan Sign fournit une plateforme complète de signature électronique pour le Web, y compris la préparation, la distribution, la révision, la signature et le téléchargement de documents.

Ce guide s'adresse uniquement aux utilisateurs de l'intégration intégrée de OneSpan Sign pour CRM en ligne (mise à jour 8.2 ou ultérieure).

OneSpan Sign fournit une plateforme complète de signature électronique pour le Web, y compris la préparation, la distribution, la révision, la signature et le téléchargement de documents.

L'intégration intégrée de OneSpan Sign pour CRM permet à ses utilisateurs d'obtenir rapidement des signatures électroniques sécurisées et conformes pour les transactions créées dans ce connecteur.

Toutes les fonctionnalités de OneSpan Sign ne sont pas prises en charge par une intégration avec ce connecteur. Toutefois, la plupart, sinon la totalité, des fonctionnalités prises en charge par cette intégration se trouvent dans la documentation de ce connecteur. Pour toute question sur une fonctionnalité spécifique, veuillez les poser dans nos forums. Si une fonctionnalité que vous recherchez n'est pas prise en charge, veuillez en informer votre contact commercial afin qu'une demande officielle puisse être faite.

L'objectif de ce guide est de vous permettre d'être rapidement opérationnel avec la version 2 de ce connecteur. Pour ce faire, procédez comme suit :

• Installation de la solution

• Configuration de la solution

• Test de la solution

Contraintes de taille de fichier

• La taille maximale d'un document est de 16 Mo. Les documents plus petits offrent de meilleures performances : nous recommandons moins de 5 Mo par document.

• Si votre organisation utilise des connecteurs Salesforce ou Microsoft SharePoint, la taille maximale du fichier est de 5 Mo par document.

• Si votre organisation utilise des connecteurs Salesforce, le nombre maximal de documents pouvant être ajoutés à une transaction est de dix (10).

• Si vous activez la distribution d'e-mails lors de la configuration d'un destinataire, les pièces jointes de plus de 5 Mo ne sont pas prises en charge.

Contraintes de nom de fichier

• Les noms de fichiers de document ne doivent pas contenir les caractères suivants séparés par des virgules : *, /, \, :, <, >, |, ?, ".

• Le nom d'un document ne peut pas contenir la chaîne esigned.

Contraintes générales des fichiers

• Nous vous recommandons de ne pas utiliser de documents PDF qui utilisent l'architecture des formulaires XML. Pour plus d'informations, consultez Prise en charge XFA.

• Ne téléchargez pas de documents protégés par un mot de passe ou corrompus. Ceux-ci généreront une erreur.

• OneSpan vous recommande fortement de numériser un fichier PDF à la recherche d'erreurs de syntaxe (par exemple, à l'aide de l'outil de contrôle en amont d'Adobe) et de résoudre toute erreur avant d'ajouter le document à une transaction.

• Les fichiers PDF dont l'indicateur NeedAppearances est défini sur true ne sont actuellement pas pris en charge.

Installation de la solution

Conditions préalables

• Vous disposez d'un compte Sandbox ou Production pour la version 11 de OneSpan Sign et d'une clé API associée. Pour obtenir un compte Sandbox gratuit, suivez les instructions sur cette page.

• Vous disposez de privilèges d'administrateur pour l'intégration intégrée de OneSpan Sign pour CRM.

• Vous avez téléchargé OneSpan Sign Embedded Integration for CRM (le package de la solution).

Action

Pour installer la version 2 de l'intégration intégrée de OneSpan Sign pour CRM :

1. Connectez-vous à Microsoft Dynamics CRM en tant qu'utilisateur disposant de privilèges d'administrateur.

2. Accédez à Microsoft Dynamics CRM > Paramètres.

3. Dans le groupe Personnalisation , cliquez sur Solutions.

   

4. Dans la fenêtre Toutes les solutions , cliquez sur Importer.

   

   Vous êtes invité à indiquer l'emplacement du package de solution.

5. Cliquez sur Parcourir, puis sélectionnez le fichier Télécharger OneSpan Sign pour Microsoft Dynamics v2.0 Release Candidate (Solution Package).

6. Cliquez sur Suivant pour afficher les informations sur la solution.

7. Cliquez sur Suivant pour afficher les options d'importation.

8. Cochez la case sous Actions de publication d'importation, puis cliquez sur Importer. La solution est importée et une page de résumé s'affiche. Après un certain délai, un message doit indiquer que l'importation a réussi.

9. Cliquez sur Fermer.

10. Cliquez sur Publier toutes les personnalisations. Cela garantit que l'intégration intégrée de OneSpan Sign pour CRM en ligne sera au courant de toutes les modifications de données qui affectent l'interface utilisateur.

Pour terminer votre installation, vous devez configurer la solution.

Configuration de la solution

Cette section décrit comment configurer votre solution en effectuant les procédures suivantes :

• Configuration de Microsoft Azure

• Spécification des informations de compte

• Spécification d'une langue

• Spécification des autorisations utilisateur

Configuration de Microsoft Azure

Conditions préalables

• Vous devez disposer des privilèges d'administrateur pour Microsoft Azure.

• La politique basée sur la localisation de Microsoft Azure a été désactivée. Pour en savoir plus sur cette politique, consultez cet article.

Action

Pour enregistrer l'intégration intégrée de OneSpan Sign pour CRM avec Microsoft Azure :

1. Connectez-vous à https://portal.azure.com en tant qu'utilisateur disposant de privilèges d'administrateur.

2. Dans le menu, sélectionnez Azure Active Directory.

3. Dans le menu actif, sélectionnez Inscriptions d'applications.

   

4. Cliquez sur + Nouvelle inscription. La page Enregistrer une application s' affiche.

   

5. Tapez un nom pour votre application.

6. Sous Types de comptes pris en charge, sélectionnez qui peut accéder à cette application.

7. Spécifiez l' URL de redirection, en lui donnant la forme suivante :

   https://<DOMAIN_NAME>/connectors/api/v2/authorization/oauth2/dynamicscrm/<ORGANIZATION_NAME>
   				

   Ici:

   • Remplacez la variable < DOMAIN_NAME> par la chaîne qui correspond à votre environnement. Les deux dernières colonnes du tableau suivant fournissent quelques exemples :

   	Bac à sable	Production
   Clients américains	sandbox.esignlive.com	apps.esignlive.com
   Clients canadiens	sandbox.e-signlive.ca	apps.e-signlive.ca
   Clients australiens		apps.esignlive.com.au
   Clients européens		apps.esignlive.eu

   • Remplacez la variable <ORGANIZATION_NAME> par la valeur que vous voyez dans le menu déroulant sous votre nom d'utilisateur (le nom de votre organisation commence par « org »).

     

   L'exemple suivant d'une URL de redirection n'a pas de variables :

   N'utilisez pas l'URL suivante, il ne s'agit que d'un exemple. Vous devez créer votre propre URL.

   https://sandbox.esignlive.com/connectors/api/v2/authorization/oauth2/dynamicscrm/org7f7db73d

8. Sélectionnez Client public/natif comme type d'application.

9. Cliquez sur S'inscrire.

10. Copiez l'ID de l'application et gardez-le à portée de main (exemple : e1928f91-f723-4406-94cf-024fcf9ae6b8).

11. Cliquez sur Afficher les autorisations de l'API. La page Autorisations de l'API s'affiche.

    

12. Cliquez sur Ajouter une autorisation.

13. Sélectionnez Dynamics CRM.

14. Sous Autorisations déléguées, cochez la case user_impersonation .

15. Cliquez sur Ajouter une autorisation.

16. Sélectionnez Azure Active Directory

17. Sous Autorisations déléguées, développez tout, puis cochez tout.

18. Attendez que le bouton Accorder le consentement de l'administrateur soit disponible, puis cliquez sur ce bouton.

    

19. Cliquez sur Oui dans la boîte de dialogue qui s'affiche. La page devrait maintenant ressembler à ceci :

    

Spécification des informations de compte

Votre organisation ne doit avoir qu'un seul compte OneSpan Sign.

Pour informer OneSpan Sign Embedded Integration for CRM au sujet de votre compte OneSpan Sign :

1. Connectez-vous à l'intégration intégrée de OneSpan Sign pour CRM en tant qu'utilisateur disposant de privilèges d'administrateur.

2. Accédez à l'intégration intégrée de OneSpan Sign pour la gestion de la relation client > comptes OneSpan Sign >.

   La liste des comptes OneSpan Sign actifs s'affiche. Au départ, cette liste doit être vide.

3. À partir du ruban, cliquez sur Nouveau pour créer un compte OneSpan Sign. Une nouvelle page apparaît.

4. Assurez-vous que les paramètres des onglets suivants ont été correctement spécifiés :

   • Généralités

   • Configuration de OneSpan

   • Intégration SharePoint

   • Clé API : Vous pouvez obtenir cette clé API OneSpan Sign auprès de notre équipe d'assistance.

   • Spécifiez les paramètres URL de l' API, URL du concepteur et URL du signataire. Par exemple, si vous avez un compte Sandbox, spécifiez-les comme suit :

     URL de l'API	https://sandbox.esignlive.com/api
     URL du concepteur	https://sandbox.esignlive.com/auth?senderAuthenticationToken={0}&target=https ://sandbox.esignlive.com/designer/{1} ?profile=dynamics2.1
     URL du signataire	https://sandbox.esignlive.com/auth?signerAuthenticationToken={0}&target=https ://sandbox.esignlive.com/packages/{1}/sign ?iframe=true

   • URL de rappel : entrez la valeur suivante : http://0.0.0.0:80/PostEvent.svc/PostESLEvent

   • ID client : Spécifiez l'ID client à partir de la procédure Configuration de Microsoft Azure.

5. Si vous le souhaitez, vous pouvez modifier la valeur par défaut de l'un des paramètres suivants : Intégration SharePoint, Nombre maximal de documents, Taille maximale des documents, Types de fichiers acceptés et Format de l'horodatage du nom du package.

6. Cliquez sur Enregistrer ou Enregistrer et fermer.

7. Dans le ruban, cliquez sur Vérifier les paramètres pour confirmer que : (a) la clé API et l'URL de l'API sont correctes ; (b) des communications avec le serveur OneSpan Sign peuvent être établies.

8. À partir du ruban, cliquez sur Définir l' URL de rappel pour enregistrer l'URL avec OneSpan Sign.

Spécification d'une langue

Pour spécifier une langue pour les transactions OneSpan Sign :

1. Connectez-vous à l'intégration intégrée de OneSpan Sign pour CRM en tant qu'utilisateur disposant de privilèges d'administrateur.

2. Accédez à l'intégration de OneSpan Sign pour le CRM > OneSpan Sign > langue. La liste Langues s'affiche. Cette liste doit initialement être vide.

3. Pour créer une nouvelle langue pour OneSpan Sign, cliquez sur Nouveau.

4. Entrez les informations requises (par exemple, Nom = Anglais, Valeur = en). Vous pouvez voir toutes les langues prises en charge et leurs valeurs associées ici. Vous devez entrer l'une de ces valeurs, mais vous pouvez spécifier le nom comme vous le souhaitez.

5. Cliquez sur Enregistrer.

Spécification des autorisations utilisateur

Pour spécifier les autorisations d'un utilisateur :

1. Connectez-vous à l'intégration intégrée de OneSpan Sign pour CRM en tant qu'utilisateur disposant de privilèges d'administrateur.

2. Cliquez sur l'icône d'engrenage dans le coin supérieur droit, puis sélectionnez Paramètres avancés > Paramètres > Sécurité > utilisateurs.

3. Dans la liste Utilisateurs activés , double-cliquez sur le nom de l'utilisateur concerné.

4. Cliquez sur Gérer les rôles.

5. Cochez toutes les cases et seulement les cases à côté des rôles que vous souhaitez que l'utilisateur ait (p. ex., Créateur de package OneSpan, Rôle de plug-in OneSpan, Créateur de modèle OneSpan). Chaque rôle est défini par un ensemble d'autorisations associées.

6. Cliquez sur OK.

Test de la solution

Pour tester votre installation, au moins un utilisateur doit avoir le droit de créer des packages, ou le droit de créer des modèles. Les administrateurs système ont toujours ces droits.

Une fois que vous avez installé et configuré votre solution, vous pouvez la tester en effectuant les procédures suivantes :

1. Creating, Preparing and Sending a Package

2. Signature de documents

Création, préparation et envoi d'un colis

Pour créer un package :

1. Connectez-vous à l'intégration intégrée de OneSpan Sign pour CRM en tant qu'utilisateur autorisé à créer des forfaits.

2. Accédez à l'intégration de OneSpan Sign pour la gestion de la relation client > à OneSpan Sign > aux forfaits OneSpan Sign. La liste Packages (Packages) s'affiche. Cette liste doit initialement être vide.

3. Sur le ruban, cliquez sur Nouveau. La page Nouveau forfait OneSpan Sign s'affiche.

4. Dans la section Détails , tapez un nom pour le package.

5. Cliquez sur Enregistrer.

6. Le package est créé, avec l'utilisateur connecté comme signataire par défaut.

Un paquet doit être enregistré avant de pouvoir y ajouter des documents.

Pour ajouter des documents à un package :

1. Depuis la section Documents du package, cliquez sur « + ». La page Nouveau document OneSpan Sign s'affiche.

2. Dans la liste déroulante Type de document , sélectionnez Télécharger des fichiers locaux.

3. Cliquez sur Choisir des fichiers.

4. Sélectionnez un ou plusieurs fichiers dans votre répertoire local, puis cliquez sur Ouvrir.

   OneSpan Sign prend en charge les types de documents suivants :

   • Le format de document portable d'Adobe (*.pdf) — Les PDF sur lesquels OneSpan Sign peut agir ont généralement au moins les autorisations suivantes activées : (1) Modification du document ; (2) Signature ; (3) Remplissage des champs du formulaire.

   • Microsoft Word (*.doc ou *. docx)

   • Bureau ouvert (*.odt)

   • Texte (*.txt)

   • Format de texte enrichi (*.RTF)

   De plus, le pilote d'impression OneSpan Sign prend en charge tous les documents qui peuvent être imprimés à partir d'une application Windows (p. ex., Microsoft Word, Microsoft Excel, Microsoft PowerPoint).

5. Sélectionnez ces fichiers dans le volet Documents sélectionnés , puis cliquez sur Ajouter des documents. Une invite de confirmation s'affiche.

6. Cliquez sur OK. Les documents sélectionnés sont ajoutés au package.

Pour préparer les documents à signer :

1. Lors de l'affichage d'un package auquel un ou plusieurs documents ont été ajoutés, cliquez sur Préparer. La vue Designer s'affiche

2. Dans l'accord de consentement à la divulgation et à la signature électroniques , cliquez sur la flèche droite pour afficher le premier document du package.

3. Dans la liste déroulante Signataires , sélectionnez un bloc de signature à ajouter au document.

4. Cliquez sur Ajouter une signature.

5. Faites glisser le bloc de signature à l'endroit où vous souhaitez qu'il apparaisse dans le document.

6. Si vous souhaitez modifier le type de bloc de signature ou si vous souhaitez ajouter un champ, cliquez sur l'icône d'engrenage. Le menu Bloc de signature s'affiche.

7. Répétez les étapes 3 à 6 pour chaque bloc de signature que vous souhaitez ajouter au document.

8. S'il y a un autre document, cliquez sur la flèche droite pour l'afficher, puis répétez les étapes 3 à 7.

9. Répétez l'étape 8 pour chaque document du colis.

Pour envoyer des documents à signer :

1. Dans la vue Designer du package, cliquez sur Envoyer.

2. Cliquez sur OK. Les documents sont envoyés pour être signés, et chaque signataire reçoit un e-mail d'invitation.

Signature de documents

Pour signer les documents d'un paquet qui a été envoyé :

1. Connectez-vous à l'intégration intégrée de OneSpan Sign pour CRM en tant qu'utilisateur qui a créé le forfait que vous souhaitez signer.

2. Accédez à l'intégration de OneSpan Sign pour la gestion de la relation client > à OneSpan Sign > aux forfaits OneSpan Sign.

3. Ouvrez le package et vérifiez que son état est Envoyé.

4. Cliquez sur Commencer à signer.

5. Lisez le consentement et cliquez sur Accepter. Le premier document du package s'affiche.

6. Signez tous vos blocs de signature dans le document. Ces blocs doivent être identifiés par des post-its.

   Si des blocs de signatures non signées se trouvent en dehors de votre écran, une notification Signatures non signées affiche le nombre de signatures encore requises.

   Une barre de progression en haut du document indique le nombre de signatures que vous avez complétées, ainsi que le nombre total de signatures qui vous ont été attribuées dans ce document (par exemple, 3/10 complétées).

7. Pour confirmer vos signatures dans le document actuel, cliquez sur OK.

8. Répétez les étapes 6 et 7 pour chaque document de l'emballage.

9. Cliquez sur Enregistrer et fermer. La page associée au package signé s'affiche.

10. Pour vérifier que tous les documents ont été signés, cliquez sur le lien pour télécharger les documents signés (ce lien se trouve au bas de la page). Ouvrez chaque document et vérifiez que tous ses blocs de signature ont été signés.