Installation de OneSpan Sign Embedded Integration for CRM

OneSpan Sign dispose également d'une plateforme d'intégration prête à l'emploi qui vous permet d'utiliser une solution unique pour connecter les signatures électroniques à vos applications professionnelles préférées de manière simple, sécurisée et rentable. Pour plus d'informations, voir OneSpan Sign avec MS Dynamics.

Installation de OneSpan Sign Embedded Integration for CRM

Pour installer OneSpan Sign Embedded Integration for CRM 2015 pour la première fois, effectuez successivement les procédures suivantes :

Étape 1 : Importation de la solution

Étape 2 : Configuration du tableau de bord et des rapports

Étape 3 : Configuration des paramètres du connecteur

Étape 4 : Configuration de la langue

Étape 5 : Installation du service de notification pour Dynamics CRM

Étape 1 : Importation de la solution

Pour importer la solution dans OneSpan Sign Embedded Integration for CRM :

1. Connectez-vous à OneSpan Sign Embedded Integration for CRM en tant qu'utilisateur avec des privilèges d'administrateur.
2. Dans le menu supérieur, cliquez sur OneSpan Sign Embedded Integration for CRM > Paramètres.

3. Dans Personnalisation, cliquez sur Solutions.

4. À partir de Toutes les solutions, cliquez sur Importer.

5. Dynamics CRM vous invite à indiquer l'emplacement du paquet de solutions. Cliquez sur Parcourir, et sélectionnez le paquet de solutions ESLConnector_1_0_0_X_managed.zip.

6. Cliquez sur Suivant pour afficher les informations sur la solution.
7. Cliquez sur Suivant pour afficher les options d'importation. Cochez la case pour activer tous les processus, puis cliquez sur Suivant. La solution sera importée, et une page de résumé apparaîtra.
8. Cliquez sur Fermer pour terminer l'installation de la solution.
9. À partir de Solutions, cliquez sur Publier toutes les personnalisations.

Étape 2 : Configuration du tableau de bord et des rapports

Pour configurer le tableau de bord et le rapport :

1. Créez un nouveau site nommé ESL Dashboard and Report.
2. Décompressez le fichier ESL Dashboard and Report.zip.
3. Indiquez le chemin physique vers le dossier décompressé ci-dessus.

4. Fournissez un nom d'hôte. Cette mise en correspondance du nom d'hôte avec l'IP du serveur physique doit également être effectuée dans le serveur DNS.
5. Changez le numéro de port pour le port de votre choix.
6. Cliquez sur OK.
7. Dans la boîte de dialogue Modifier le bassin d'applications, effectuez les réglages correspondant à l'écran suivant.

8. Dans le dossier décompressé, modifiez le fichier Web.config comme suit :

<appSettings>
					<add key="CRMURL" value="http://ServerName/OrganizationName/XRMServices/2011/Organization.svc" />
					<add key="crmuser" value="UserName" />
					<add key="crmpass" value="Password" />
				</appSettings>

9. Dans Paramètres, allez dans Personnalisations et cliquez sur Personnaliser le système.

10. Sélectionnez Ressources Web dans le volet de gauche, et recherchez la ressource Web de type ESL Dashboard HTML.

11. Ouvrez-le, et remplacez le nom de l'hôte par le nom du site (où Tableau de bord et des rapports est déployé). Ensuite, enregistrez-le et publiez-le.

12. Répétez le processus pour la ressource Web ESL Report.

Étape 3 : Configuration des paramètres du connecteur

Pour configurer les paramètres du connecteur :

1. Dans l'onglet Paramètres sous Paramètres OneSpan Sign, cliquez sur Compte OneSpan Sign. Une grille affichant les comptes OneSpan Sign apparaît. Sa liste doit initialement être vide.

2. Dans le ruban, cliquez sur Nouveau pour créer un nouveau compte OneSpan Sign.

3. Une nouvelle boîte de dialogue apparaît.

4. Saisissez les informations requises suivantes.
   • Nom : Nom de l'élément de configuration
   • Courriel : Adresse courriel du propriétaire du compte

   Les paramètres de configuration suivants dépendent de l'URL à partir de laquelle vous vous connectez à OneSpan Sign. Si vous n'êtes pas certain de votre URL de connexion, référez-vous au courriel reçu lors de votre inscription et suivez le lien Connexion à votre compte. Vous serez dirigé vers une page de connexion, à partir de laquelle votre URL de connexion apparaîtra dans la barre d'adresse de votre navigateur.

   • Pour les clients américains qui effectuent un déploiement dans un environnement de production américain et dont l'URL de connexion est https://apps.esignlive.com/login :
     • URL DE L'API :

     https://apps.esignlive.com/api

     • URL du concepteur :

     https://apps.esignlive.com/auth?senderAuthenticationToken={0}&target=https://apps.esignlive.com/designer/{1}?profile=dynamics1.2

     • URL de signature :

     https://apps.esignlive.com/auth?signerAuthenticationToken={0}&target=https://apps.esignlive.com/packages/{1}/sign

   • Pour les clients américains qui effectuent un déploiement dans un environnement Sandbox américain et dont l'URL de connexion est https://sandbox.esignlive.com/login :
     • 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=dynamics1.2

     • URL de signature :

     https://sandbox.eSignlive.com/auth?signerAuthenticationToken={0}&target=https://sandbox.esignlive.com/packages/{1}/sign

   • Pour les clients américains qui effectuent un déploiement dans un environnement de production américain et dont l'URL de connexion est https://apps.e-Signlive.com/login :
     • URL DE L'API :

     https://apps.e-SignLive.com/api

     • URL du concepteur :

     https://apps.e-SignLive.com/auth?senderAuthenticationToken={0}&target=https://apps.e-SignLive.com/designer/{1}?profile=dynamics1.2

     • URL de signature :

     https://apps.e-SignLive.com/auth?signerAuthenticationToken={0}&target=https://apps.e-SignLive.com/packages/{1}/sign

   • Pour les clients américains qui effectuent un déploiement dans un environnement Sandbox américain et dont l'URL de connexion est https://sandbox.e-SignLive.com/login :
     • URL DE L'API :

     https://sandbox.e-SignLive.com/api

     • URL du concepteur :

     https://sandbox.e-SignLive.com/auth?senderAuthenticationToken={0}&target=https://sandbox.e-SignLive.com/designer/{1}?profile=dynamics1.2

     • URL de signature :

     https://sandbox.e-SignLive.com/auth?signerAuthenticationToken={0}&target=https://sandbox.e-SignLive.com/packages/{1}/sign

   • Pour les clients canadiens qui effectuent un déploiement dans un environnement de production canadien et dont l'URL de connexion est https://apps.e-SignLive.ca/login :
     • URL DE L'API :

     https://apps.e-SignLive.ca/api

     • URL du concepteur :

     https://apps.e-SignLive.ca/auth?senderAuthenticationToken={0}&target=https://apps.eSignLive.ca/designer/{1}?profile=dynamics1.2

     • URL de signature :

     https://apps.eSignLive.ca/auth?signerAuthenticationToken={0}&target=https://apps.e-SignLive.ca/packages/{1}/sign

   • Pour les clients canadiens qui effectuent un déploiement dans un environnement Sandbox canadien et dont l'URL de connexion est https://sandbox.e-SignLive.ca/login :
     • URL DE L'API :

     https://sandbox.e-SignLive.ca/api

     • URL du concepteur :

     https://sandbox.e-SignLive.ca/auth?senderAuthenticationToken={0}&target=https://sandbox.e-SignLive.ca/designer/{1}?profile=dynamics1.2

     • URL de signature :

     https://sandbox.e-SignLive.ca/auth?signerAuthenticationToken={0}&target=https://sandbox.e-SignLive.ca/packages/{1}/sign

5. Saisissez l'URL de rappel utilisée pour le service de notification des événements. Par exemple : http://server/PostEvent.svc/PostESLEvent
6. Enregistrez le formulaire, puis cliquez sur le bouton du ruban Définir l'URL de rappel pour enregistrer l'URL dans OneSpan Sign.
7. Saisissez la chaîne de connexion d'audit de la base de données créée précédemment.

Data Source=servername; Initial Catalog=databasename; uid=userid ; pwd=password

8. Indiquez si vous souhaitez utiliser l'intégration SharePoint. Si oui, alors :
   1. Saisissez l'URL de l'hôte de téléversement des documents. Il s'agit du nom d'hôte du site hébergé créé à l'Étape 2 : Configuration du tableau de bord et des rapports
   2. Saisissez l'URL des documents SharePoint, où eSignLive.com.ESL.WebService.wsp sera déployé dans votre intégration SharePoint. Il s'agit de l'URL du site SharePoint à partir de laquelle vous allez sélectionner des documents pour Dynamics CRM.
   3. Saisissez l'URL du document SharePoint terminé. Il s'agit de l'URL de la bibliothèque de sites SharePoint dans laquelle les documents signés à partir de OneSpan Sign seront enregistrés.
9. Cliquez sur Vérifier les paramètres pour confirmer que la clé API et l'URL API sont correctes et que la communication avec le serveur OneSpan Sign peut être établie.

Étape 4 : Configuration de la langue

Pour configurer la langue d'affichage du connecteur :

1. Dans Paramètres, cliquez sur OneSpan SignLangue. Une grille Langues OneSpan Sign apparaît. Sa liste doit initialement être vide.
2. Pour configurer une nouvelle langue pour le connecteur, cliquez sur Nouvelle.
3. Saisissez le nom et la valeur de la langue. Par exemple, pour l'anglais : Nom = anglais et Valeur = en. Pour connaître les paires nom-valeur de toutes les langues prises en charge, voir Langues prises en charge.
4. Cliquez sur Enregistrer.

Étape 5 : Installation du service de notification pour Dynamics CRM

La procédure suivante installe un service de notification Windows qui : (1) lira les mises à jour de statut à partir de la table de la base de données des notifications SQL créée à l'étape précédente ; (2) appliquera ces mises à jour aux données de paquets OneSpan Sign de Dynamics CRM.

Pour installer le service de notification :

1. Décompressez le contenu de eSignLive.comESLNotificationService.zip dans un nouveau répertoire.
2. Ouvrez le fichier eSignLive.comESLNotificationService.exe.config dans un éditeur de texte.
3. Modifiez la chaîne de connexion pour le serveur SQL comme suit :

Chaîne de connexion du serveur SQL :

Data Source=<ServerName>;Initial Catalog=<dbname>;User ID=<sqluser>;Password=<password>

• Remplacez <ServerName> avec le nom du serveur SQL.
• Remplacez <dbname> avec le nom de la base de données où le tableau des notifications a été installé.
• Remplacer <sqluser> et <password> avec les identifiants de connexion SQL qui ont un accès en lecture et en écriture à la base de données.
4. Modifiez la chaîne de connexion pour le serveur Dynamics CRM comme suit :

Chaîne de connexion CRM :

Url=<crmURL>; Domain=<domain>; Username=<user>; Password=<password>
            <appSettings>
            <addkey="CRMURL"value="<crmURL>/XRMServices/2011/Organization.svc"/>
            <add key="crmuser" value="Username" />
            <add key="crmpass" value="password" />
            </appSettings>

• Remplacez <crmURL> par l'URL de l'installation CRM.
• Remplacez <domain>, <user> et <password> par les informations d'identification de l'utilisateur du domaine qui dispose d'un accès administratif à l'installation CRM.
5. Ouvrez une invite de commande Windows, et sélectionnez Exécuter en tant qu'administrateur.
6. Accédez au dossier dans lequel les fichiers du service de notification ont été copiés à l'étape 1.
7. Exécutez la commande : eSignLive.comESLNotificationService.exe -install
8. Ouvrez l'outil de gestion des services Windows (Démarrer > Outils d'administration > Services), et confirmez que le service eSignLive Notifications est présent.
9. Démarrez le service.
10. Ouvrez l'Observateur d'événements de Windows (Démarrer > Outils d'administration > Observateur d'événements), et confirmez qu'un nouveau journal d'événements appelé eSignLive.comEventLog a été créé sous le groupe Journaux des applications et des services.
11. Naviguez jusqu'au eSignLive.comEventLog et confirmez l'enregistrement d'un événement qui indique que le service a été lancé.

OneSpan Sign dispose également d'une plateforme d'intégration prête à l'emploi qui vous permet d'utiliser une solution unique pour connecter les signatures électroniques à vos applications professionnelles préférées de manière simple, sécurisée et rentable. Pour plus d'informations, voir OneSpan Sign avec MS Dynamics.

Installation de OneSpan Sign Embedded Integration for CRM

Cette section décrit comment installer la version 2 de OneSpan Sign Embedded Integration for CRM.

Préalables

• Vous avez un compte Sandbox ou Production pour la version 11 de OneSpan Sign, et une clé API associée.

Pour obtenir un compte Sandbox gratuit, suivez les instructions de cette page.

• Vous avez des privilèges d'administrateur pour OneSpan Sign Embedded Integration for CRM.
• Si vous installez le connecteur dans une instance sur site de Dynamics CRM, vous aurez suivi la procédure Installation du service de notification Push.

Action

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

1. Connectez-vous à Microsoft Dynamics CRM en tant qu'utilisateur avec des privilèges d'administrateur.
2. Naviguez jusqu'à 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 paquet de solutions.

5. Cliquez sur Parcourir et sélectionnez le fichier Télécharger OneSpan Sign pour Microsoft Dynamics v2.0 Version 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 Actions de post-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 devrait indiquer que l'importation a réussi.
9. Cliquez sur Fermer.
10. Cliquez sur Publier toutes les personnalisations. Cela permet de s'assurer que OneSpan Sign Embedded Integration for CRM en ligne sera au courant de tous les changements de données qui affectent l'interface utilisateur.

Pour terminer votre installation, vous devez configurer la solution.