Déploiement du service de notification Push

Select * From EslNotifications

Déploiement du service de notification Push

Le service de notification Push n'est nécessaire que si votre connecteur est installé sur site. Si vous avez un déploiement SaaS, veuillez ignorer cette section.

Les instructions de déploiement ci-dessous ne sont pertinentes que si vous utilisez la version 1.2 de OneSpan Sign Embedded Integration for CRM.

Le service de notification Push :

1. Reçoit une notification d'événement (rappel) de la part de OneSpan Sign chaque fois que le statut d'un processus de signature électronique change. 
2. Transmet cette information au connecteur correspondant.

Le reste de cette section décrit :

• Installation du service de notification Push
• Vérification du service de notification Push

Installation du service de notification Push

Pour installer le service de notification Push :

1. Créez un site Web IIS en procédant comme suit :

   1. Connectez-vous à IIS avec des privilèges suffisants.

   

   2. Cliquez sur Ajouter un site Web. Une nouvelle boîte de dialogue apparaît.

   

   3. Spécifiez les paramètres suivants :
   • Nom du site : Vous pouvez spécifier le nom de votre choix.
   • Chemin physique : Ce chemin doit identifier le dossier dans lequel le service de notification Push sera installé.
   • Port : Vous pouvez spécifier le numéro de port de votre choix.
   4. Cliquez sur OK.
2. Assurez-vous que la version du bassin d'applications est 4.0 en sélectionnant les paramètres de base du bassin d'applications, comme illustré ci-dessous.





3. Exécutez le programme d'installation en procédant comme suit :
   1. Double-cliquez sur le fichier ESLEventReceiverInstaller.msi.
   2. Sur l'écran de bienvenue, cliquez sur Suivant. Une nouvelle boîte de dialogue apparaît.

   

   3. Spécifiez le site IIS et le bassin d'applications.

      Indiquez un répertoire virtuel uniquement si vous souhaitez héberger le service dans un répertoire virtuel à l'intérieur du site Web IIS. Sinon, laissez ce champ vide.

   4. Cliquez sur Suivant. La page Paramètres de connexion s'affiche.

   

   5. Spécifiez les paramètres suivants, qui seront utilisés pour stocker les notifications du service. Leurs valeurs ont été déterminées lorsque la base de données SQL a été installée dans le cadre du déploiement de votre connecteur.
   • Nom du serveur : Nom du serveur SQL
   • Nom de la base de données : Nom de la base de données SQL
   • Nom de l'utilisateur : Le nom d'utilisateur associé à la base de données
   • Mot de passe : Mot de passe pour le nom d'utilisateur
   6. Cliquez sur Suivant.
4. Une fois l'installation terminée, cliquez sur Fermer.
5. Pour vérifier que le service est en cours d'exécution : (1) ouvrez le service dans la vue du contenu de IIS; (2) recherchez le fichier PostEvent.svc
   
6. Liez le site Web IIS à l'IP ou au domaine public, de sorte que OneSpan Sign puisse envoyer des notifications au service de notification Push. À cette fin, gardez à l'esprit que :
   • L'URL du service de notifications Push est la suivante :

   http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

   Ici, {���} est un espace réservé pour le nom du serveur et le numéro de port.

   Le service peut être hébergé sur le port de votre choix.

   Le nom et le port du serveur doivent être accessibles depuis Internet. Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.

   Cette URL doit être utilisée dans Compte OneSpan Sign > URL de rappel dans la configuration du connecteur.

   PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Vérification du service de notification Push

Pour vérifier que les événements sont correctement reçus par le service de notification Push :

1. Créez un paquet en utilisant votre connecteur OneSpan Sign.
2. Le service doit avoir reçu au moins un événement associé au nouveau paquet. Vérifiez qu'il l'a fait en vérifiant le tableau SQL :

Select * From EslNotifications

3. Si les événements attendus n'apparaissent pas, vérifiez le journal de service suivant :

{SERVICE_INSTALLATION_FOLDER}\Logs\Log.txt



4. Si les fichiers journaux n'ont pas été créés, il se peut qu'il y ait un problème d'autorisation dans le répertoire du site Web de IIS. Assurez-vous que le compte qui exécute le bassin d'applications a des droits d'écriture sur le dossier Site Web.

Le service de notification Push ne fonctionnera pas si la mémoire libre est insuffisante. Si vous constatez que cela ne fonctionne pas, assurez-vous que sur le serveur où le service est installé, la mémoire libre est >5 % de la mémoire totale.

Désinstallation du service de notification Push

Le service de notification Push est nécessaire à votre connecteur s'il a été installé sur place. Vous ne devez donc désinstaller le service que si vous souhaitez également désinstaller le déploiement sur site de votre connecteur.

Pour désinstaller le service de notification Push pour votre connecteur :

1. Exécutez le fichier ESLEventReceiverInstaller.msi et sélectionnez Supprimer ESLEventReceiverInstaller. Cliquez ensuite sur Terminer.
2. Supprimez le bassin de sites Web et d'applications IIS en cliquant avec le bouton droit de la souris sur PushNotificationService, puis en sélectionnant Supprimer.

Déploiement du service de notification Push

Le service de notification Push est nécessaire uniquement si votre connecteur est installé sur une instance sur site de Dynamics CRM. Si vous installez le connecteur sur Dynamics CRM 365, veuillez ignorer cette section.

Les instructions de déploiement ci-dessous ne sont pertinentes que si vous utilisez la version 2.1 de OneSpan Sign Embedded Integration for CRM.

Le service de notification Push :

1. Reçoit une notification d'événement (rappel) de la part de OneSpan Sign chaque fois que le statut d'un processus de signature électronique change. 
2. Transmet cette information au connecteur correspondant.

Le reste de cette section décrit :

• Installation du service de notification Push
• Vérification du service de notification Push

Installation du service de notification Push

Pour installer le service de notification Push :

1. Décompressez le fichier PushNotificationService.zip dans le dossier où vous voulez installer le service.

2. Créez un site Web IIS en procédant comme suit :

   1. Connectez-vous à IIS avec des privilèges suffisants.

   

   2. Cliquez sur Ajouter un site Web. Une nouvelle boîte de dialogue apparaît.

   

   3. Spécifiez les paramètres suivants :
   • Nom du site : Vous pouvez spécifier le nom de votre choix.
   • Chemin physique : Ce chemin doit identifier le dossier où le fichier zip a été décompressé.
   • Port : Vous pouvez spécifier le numéro de port de votre choix.
   4. Cliquez sur OK.

3. Assurez-vous que la version du bassin d'applications est 4.0 en sélectionnant les paramètres de base du bassin d'applications, comme illustré ci-dessous.





4. Modifiez le fichier web.config comme suit :
   1. Mettez à jour la chaîne de connexion dans la section <add name="CrmLocal" connectionString="....">" du fichier.
   2. Mettez à jour les paramètres suivants :
      • URL : URL de votre organisation OneSpan Sign Embedded Integration for CRM (http://hostname:8888/Dynamics2015, p. ex.)
      • Domaine : Le nom de domaine
      • Nom d'utilisateur : Le nom d'utilisateur associé à un compte de domaine qui a des privilèges d'administrateur sur OneSpan Sign Embedded Integration for CRM 2.0
      • Mot de passe : Mot de passe pour le nom d'utilisateur
   3. Enregistrez vos modifications et redémarrez le site Web dans IIS.

5. Pour vérifier que le service est en cours d'exécution : (1) ouvrez le service dans la vue du contenu de IIS; (2) recherchez le fichier PostEvent.svc
   

6. Liez le site Web IIS à l'IP ou au domaine public, de sorte que OneSpan Sign puisse envoyer des notifications au service de notification Push. À cette fin, gardez à l'esprit que :
   • L'URL du service de notifications Push est la suivante :

   http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

   Ici, {SERVER_NAME:PORT} est un espace réservé pour le nom du serveur et le numéro de port.

   Le service peut être hébergé sur le port de votre choix.

   Le nom et le port du serveur doivent être accessibles depuis Internet. Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.

   Cette URL doit être utilisée dans OneSpan Sign Compte > URL de rappel dans la configuration du connecteur.

   PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Vérification du service de notification Push

Pour vérifier que les événements sont correctement reçus par le service de notification Push :

1. Créez un paquet en utilisant votre connecteur OneSpan Sign.
2. Vérifiez que le service a reçu une entité de notification OneSpan Sign concernant le nouveau paquet.
3. Si les événements attendus n'apparaissent pas, vérifiez le journal de service suivant :

{SERVICE_INSTALLATION_FOLDER}\Logs\Log.txt



4. Si les fichiers journaux n'ont pas été créés, il se peut qu'il y ait un problème d'autorisation dans le répertoire du site Web de IIS. Assurez-vous que le compte qui exécute le pool d'applications a des droits d'écriture sur le dossier Site Web.

Le service de notification Push ne fonctionnera pas si la mémoire libre est insuffisante. Si vous constatez que cela ne fonctionne pas, assurez-vous que sur le serveur où le service est installé, la mémoire libre est >5 % de la mémoire totale.

Désinstallation du service de notification Push

Le service de notification Push est nécessaire à votre connecteur s'il a été installé sur place. Vous ne devez donc désinstaller le service que si vous souhaitez également désinstaller le déploiement sur site de votre connecteur.

Pour désinstaller le service de notification Push pour votre connecteur :

1. Supprimez le bassin de sites Web et d'applications IIS en cliquant avec le bouton droit de la souris sur PushNotificationService, puis en sélectionnant Supprimer.



2. Supprimez le dossier décompressé du service.