Nous avons effectué des mises à jour ! Consultez notre portail de documentation mis à jour ! En savoir plus...

Guide de démarrage rapide de OneSpan Sign Embedded Integration for CRM

  • Mis à jour le Jan 19, 2026
  • Publié le Nov 18, 2024
  • 10 Minute(s) lue(s)
Prev Next

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

OneSpan Sign offre une plateforme complète de signature électronique pour le Web, incluant la préparation, la distribution, la relecture, la signature et le téléchargement de documents.

Ce guide est destiné uniquement aux utilisateurs de OneSpan Sign Embedded Integration pour CRM Online (mise à jour 8.2 ou supérieure).

OneSpan Sign offre une plateforme complète de signature électronique pour le Web, incluant la préparation, la distribution, la relecture, la signature et le téléchargement de documents.

L'intégration intégrée 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 OneSpan Sign ne sont pas prises en charge par une intégration avec ce connecteur. Cependant, la plupart, sinon la totalité, des fonctionnalités prises en charge par cette intégration se trouvent dans la documentation de ce Connector. Pour toute question concernant une fonctionnalité spécifique, veuillez les poser sur nos forums. Si une fonctionnalité que vous recherchez n'est pas prise en charge, veuillez informer votre contact commercial afin qu'une demande officielle puisse être faite.

Le but de ce guide est de vous mettre rapidement en marche avec la version 2 de ce connecteur. Vous pouvez le faire en réalisant les procédures suivantes :

Contraintes de taille de fichier

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

  • La taille totale maximale de tous les documents d'une transaction est de 39 Mo.

  • 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 livraison d'e-mail tout en configurant un destinataire, les pièces jointes supérieures à 5 Mo ne sont pas prises en charge.

Contraintes de noms de fichiers

  • Les noms de fichiers des documents 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 signée.

Contraintes générales des fichiers

  • Nous vous recommandons de ne pas utiliser de documents PDF qui utilisent XML Forms Architecture. Pour plus d'informations, voir Soutien XFA.

  • Ne téléchargez pas les documents protégés par mot de passe ou corrompus. Celles-ci génèrent une erreur.

  • OneSpan recommande vivement de scanner un PDF pour détecter des erreurs de syntaxe (par exemple, en utilisant l'outil Preflight d'Adobe) et de résoudre les erreurs avant d'ajouter le document à une transaction.

  • Les PDF avec le drapeau NeedAppearances réglé sur true ne sont pas actuellement pris en charge.

Installation de la solution

Prérequis

  • Vous avez un compte bac à sable ou en production pour la version 11 de OneSpan Sign, ainsi qu'une clé API associée. Pour obtenir un compte Sandbox gratuit, suivez les instructions sur cette page.

  • Vous avez des privilèges administrateur pour l'intégration intégrée OneSpan Sign pour le CRM.

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

Action

Pour installer la version 2 de OneSpan Sign Embedded Integration pour CRM :

  1. Connectez-vous à Microsoft Dynamics CRM en tant qu'utilisateur avec des privilèges administrateur.

  2. Naviguez dans Microsoft Dynamics CRM > Paramètres.

  3. Dans le groupe Personnalisation , cliquez sur Solutions.

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

    On vous demande d'indiquer l'emplacement du paquet de solutions.

  5. Cliquez sur Parcourir, puis sélectionnez le fichier Download OneSpan Sign for 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. Sélectionnez la case à cocher sous Publier les actions d'importation, puis cliquez sur Importer. La solution est importée, et une page de résumé apparaît. 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 OneSpan Sign Embedded Integration for CRM Online sera informée de tous les changements de données affectant l'interface utilisateur.

Pour achever votre installation, vous devez configurer la solution.

Configuration de la solution

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

Configuring Microsoft Azure

Prérequis

  • Vous devez avoir des privilèges administrateur pour Microsoft Azure.

Action

Pour enregistrer l'intégration OneSpan Sign Embedded pour le CRM avec Microsoft Azure :

  1. Connectez-vous à https://portal.azure.com en tant qu'utilisateur avec des privilèges d'Administrateur.

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

  3. Dans le menu actif, sélectionnez Inscriptions à l'application.

  4. Cliquez sur + Nouvelle inscription. Une page de candidature apparaît dans la page Inscription .

  5. Tapez un nom pour votre candidature.

  6. Dans la section 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>

    Voici :

    • Remplacez la variable < DOMAIN_NAME> par la chaîne correspondant à 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 candadiens

    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' URL de redirection n'a pas de variables :

    N'utilisez pas l'URL suivante — ce n'est qu'un exemple. Vous devez créer votre propre URL.

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

  8. Sélectionnez le type de candidature Public/natif .

  9. Cliquez sur S'inscrire.

  10. Copiez l'identifiant 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 des permissions de l'API apparaît.

  12. Cliquez sur Ajouter une permission.

  13. Sélectionnez Dynamics CRM.

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

  15. Cliquez sur Ajouter une permission.

  16. Select Azure Active Directory

  17. Dans la section Autorisations déléguées, développez tout puis cochez tout.

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

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

Spécification des informations de compte

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

Pour informer l' intégration OneSpan Sign Embedded pour le CRM à propos de votre compte OneSpan Sign :

  1. Connectez-vous à OneSpan Sign Embedded Integration pour CRM en tant qu'utilisateur avec des privilèges Administrateur.

  2. Naviguez vers l'intégration intégrée OneSpan Sign pour les comptes CRM > OneSpan Sign >.

    Une liste active de comptes OneSpan Sign apparaît. Au départ, cette liste devrait être vide.

  3. Depuis le ruban, cliquez sur Nouveau pour créer un nouveau 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 OneSpan

    • Intégration SharePoint

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

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

      API URL

      https://sandbox.esignlive.com/api

      Designer URL

      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 : Saisissez la valeur suivante : http://0.0.0.0:80/PostEvent.svc/PostESLEvent

    • ID client : Spécifier l'ID client de la procédure Configuring 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 de Document, Types de Fichiers Acceptés et Format de Date-Tampon du Nom du Paquet.

  6. Cliquez sur Enregistrer ou Enregistrer et Fermer.

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

  8. Depuis le ruban, cliquez sur Définir l'URL de rappel pour enregistrer l'URL avec OneSpan Sign.

Spécifier une langue

Pour spécifier un langage pour les transactions OneSpan Sign :

  1. Connectez-vous à OneSpan Sign Embedded Integration pour CRM en tant qu'utilisateur avec des privilèges Administrateur.

  2. Naviguez vers l' intégration intégrée de signes OneSpan pour CRM > OneSpan Sign > Language. Une liste des langues apparaît. Cette liste devrait d'abord être vide.

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

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

  5. Cliquez sur Enregistrer.

Spécifier les permissions utilisateur

Pour spécifier les permissions d'un utilisateur :

  1. Connectez-vous à OneSpan Sign Embedded Integration pour CRM en tant qu'utilisateur avec des privilèges Administrateur.

  2. Cliquez sur l'icône d'engrenage en haut à droite, puis sélectionnez Paramètres avancés > Paramètres > Sécurité > Utilisateurs.

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

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

  5. Cochez toutes et seulement les cases à côté des rôles que vous souhaitez que l'utilisateur ait (par exemple, OneSpan Package Creator, OneSpan Plugin Role, OneSpan Template Creator). Chaque rôle est défini par un ensemble de permissions 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 paquets, ou le droit de créer des modèles. Les administrateurs système ont toujours ces droits.

Après avoir installé et configuré votre solution, vous pouvez la tester en effectuant les procédures suivantes :

  1. Créer, préparer et envoyer un colis

  2. Documents de signature

Créer, préparer et envoyer un colis

Pour créer un package :

  1. Connectez-vous à OneSpan Sign Embedded Integration for CRM en tant qu'utilisateur ayant la permission de créer des paquets.

  2. Naviguez vers l' intégration embarquée OneSpan Sign pour CRM > OneSpan Sign > OneSpan Sign Sign. Une liste de colis apparaît. Cette liste devrait d'abord être vide.

  3. Sur le ruban, cliquez sur Nouer. La nouvelle page du forfait OneSpan Sign apparaît.

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

  5. Cliquez sur Enregistrer.

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

Un colis doit être sauvegardé avant que des documents puissent y être ajoutés.

Pour ajouter des documents à un paquet :

  1. Depuis la section Documents du package, cliquez sur « + ». La nouvelle page de document de signature OneSpan apparaît.

  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 annuaire 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 ces permissions activées : (1) Modification du document ; (2) Signature ; (3) Remplissage des champs de formulaire.

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

    • Open Office (*.odt)

    • Texte (*.txt)

    • Format de texte enrichi (*.RTF)

    De plus, le pilote d'impression OneSpan Sign prend en charge tout document pouvant être imprimé depuis une application Windows (par exemple, Microsoft Word, Microsoft Excel, Microsoft PowerPoint).

  5. Sélectionnez ces fichiers dans le volet Documents sélectionnés , puis cliquez sur Ajouter des documents. Un message de confirmation apparaît.

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

Pour préparer les documents à signer :

  1. Lors de la consultation d'un package auquel un ou plusieurs documents ont été ajoutés, cliquez sur Préparer. La vue Designer apparaît

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

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

  4. Cliquez sur Ajouter signature.

  5. Glissez le bloc de signature à l'endroit où vous voulez qu'il apparaisse dans le document.

  6. Si vous souhaitez changer le type de bloc signature, ou ajouter un champ, cliquez sur l'icône d'engrenage. Le menu Signature Block apparaît.

  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 de droite pour l'afficher, puis répétez les étapes 3 à 7.

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

Pour envoyer les documents à signer :

  1. Depuis la vue Designer du paquet, 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.

Documents de signature

Pour signer les documents dans un colis qui a été envoyé :

  1. Connectez-vous à OneSpan Sign Embedded Integration pour CRM en tant qu'utilisateur ayant créé le package que vous souhaitez signer.

  2. Naviguez vers l' intégration embarquée OneSpan Sign pour CRM > OneSpan Sign > OneSpan Sign Sign.

  3. Ouvrez le colis et vérifiez que son statut est Envoyé.

  4. Cliquez sur Commencer la signature.

  5. Lisez l'accord de consentement et cliquez sur Accepter. Le premier document du colis apparaît.

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

    Si des blocs de signature non signés se trouvent en dehors de votre écran, une notification de 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 sont 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 à 7 pour chaque document du paquet.

  9. Cliquez sur Enregistrer et fermer. La page associée au colis signé apparaît.

  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 en bas de la page). Ouvrez chaque document et vérifiez que tous ses blocs de signature ont été signés.