Guide d’installation et de configuration

Prev Next

OneSpan Sign for Laserfiche permet d’intégrer des signatures électroniques dans les documents Laserfiche et de les envoyer pour signature. Ce guide explique comment installer et configurer l’intégration OneSpan Sign pour le client Web Laserfiche et le flux de travail.

Prérequis

Comptes & Logiciels

  • Compte OneSpan Sign (compte bac à sable recommandé pour les tests)

  • Compte administrateur pour le dépôt Laserfiche

  • Client Web Laserfiche installé

  • Workflow Laserfiche installé

Base de données

  • MSSQL Server 2012 ou supérieur installé

  • Utilisateur MSSQL Server avec les permissions suivantes :

    • Créer une base de données

    • Créer table

    • Créer une procédure stockée

    • Insérer les données

Environnement Windows

  • Windows PowerShell 4.0 ou version, avec la permission de définir la politique d’exécution sur Sans restriction

  • Compte Windows exécutant le script PowerShell avec les permissions suivantes :

    • Créer / Modifier / Modifier des dossiers et fichiers

    • Créer un pool d’applications dans IIS

    • Pool d’applications Start / Stop

    • Créer un site web dans IIS

    • Restart IIS

    • Créer une source d’événement dans le journal d’événements


Étapes d’installation

1. Télécharger le package d’intégration

Téléchargez la dernière version depuis :
https://www.onespan.com/integrations/laserfiche

2. Dézipper le colis

Extrais le colis à l’endroit souhaité. Le dossier décompressé contiendra :

Images/Documentation/laserfiche_install_image1.png

3. Configurez app_config.xml

Ouvrez app_config.xml avec n’importe quel éditeur de texte et remplissez vos identifiants SQL Server :

Terrain

Valeur

Notes

UserId

Texte clair

Votre identifiant utilisateur SQL Server

DataSourceName

Texte clair

Nom de votre source de données SQL Server

Base de données

OSSInfo

Ne pas changer, il faut rester OSSInfo

Mot de passe

Crypté

Utilisez l’outil ContentEncryptor (voir ci-dessous)

Important : La valeur DatabaseName doit rester OSSInfo. Ne le modifiez pas.

Pour chiffrer le mot de passe :

  1. Ouvre le dossier ContentEncryptor/ .

  2. Double-clic ESLConnector.ContentEncryptor.exe.

laserfiche_install_image2.png

  1. Saisissez votre mot de passe dans le champ Votre mot de passe (texte clair).

  2. Cliquez sur Chiffrer.

  3. Cliquez sur Copier le mot de passe chiffré dans le presse-papiers et collez la valeur dans app_config.xml.

     laserfiche_install_image3.png

Sauvegardez et fermez le fichier une fois terminé.

4. Copier le dossier vers le(s) serveur(s) approprié(s)

Composant

Copiez le dossier vers...

Exigences supplémentaires

Web Client

Serveur où Laserfiche WebAccess est installé

—

Récepteur de notification

Serveur où vous souhaitez installer le récepteur de notifications

(1)IIS installé ;

(2)Accessible depuis le serveur de notification OneSpan Sign (liste blanche des IP sortantes — voir les URL et IP de l’environnement) ;

(3) .NET Framework 4.8+ ;

(4)Accès au serveur Laserfiche et au serveur de base de données. Si Laserfiche WebAccess n’est pas installé, installez également le runtime du SDK Laserfiche.

Flux de travail

Serveur où sont installés Laserfiche, serveur de workflow et concepteur de workflow

—

5. Exécuter PowerShell en tant qu’administrateur

Faites un clic droit sur Windows PowerShell et sélectionnez Exécuter en tant qu’administrateur.

laserfiche_install_image4.png

6. Naviguer jusqu’au dossier d’installation

CD « Votre chemin vers les fichiers d’installation »

7. Définir la politique d’exécution sur Sans restriction

Set-ExecutionPolicy - ExécutionPolitique Sans restriction

8. Lancer l’installateur

.\Installer.ps1

Lorsqu’on le demande, tapez le nom du composant ou son numéro pour installer :

#

Composant

1

WebClient

2

Flux de travail

3

Notification

4

Base de données

5

Sortie

laserfiche_install_image5.png

L’installateur vérifie automatiquement les prérequis. Toute erreur apparaît dans la console et est enregistrée dans log.txt.

9. Installer le composant Base de données

Vous avez deux options :

Option A — Exécuter manuellement des scripts SQL

Naviguez jusqu’à src\\MSSQLScript\\ et exécutez les scripts suivants dans l’ordre :

  1. schema.sql

  2. masterdata.sql

Option B — Exécuter des scripts SQL via l’installateur

  1. Dans app_config.xml, saisissez UserId, DataSourceName et Password en texte clair (aucun chiffrement nécessaire pour cette option). DatabaseName doit rester OSSInfo.

  2. Sauvegardez et fermez le fichier.

  3. Copiez le dossier sur le serveur où MSSQL Server est installé.

  4. Suivez les étapes 5 à 8 ci-dessus et sélectionnez Base de données (4).

  5. Les journaux d’exécution sont écrits dans src\\MSSQLScript\\log.txt.


Configuration

1. Créer les groupes de dépôt requis dans Laserfiche

Groupe

Accès

OSS_User

Les membres ont accès à l’intégration dans Laserfiche WebAccess.

OSS_Admin

Les membres ont accès à l’onglet Configuration de l’interface d’intégration (actions administratives).

OSS_All_Transactions

Les membres ont accès à toutes les transactions sur tous les Profils de Connexion.

2. Ajouter un utilisateur administrateur aux groupes

Ajoutez au moins un utilisateur de Laserfiche à la fois OSS_User et OSS_Admin. Cet utilisateur effectuera la configuration initiale de l’intégration.

3. Ouvrir l’interface d’intégration OSS

Dans Laserfiche WebAccess, ouvrez le menu du coin droit et sélectionnez OneSpan.

laserfiche_install_image6.png

4. Créer un nouveau profil de connexion

Sélectionnez Nouveau profil de connexion dans le menu déroulant en haut à droite.

laserfiche_install_image7.png

Cela ouvre l’onglet Configuration avec les sous-onglets verticaux suivants qui doivent être complétés dans l’ordre :

  1. Profil de connexion

  2. Informations du compte OSS

  3. Informations du compte LF

  4. Infos sur le serveur WF

  5. Informations sur les rappels OSS

  6. Préférences de transaction

  7. Préférences de téléchargement

laserfiche_install_image7.png

5. Remplir chaque onglet de configuration

Profil de connexion

Saisissez un nom de profil et une description optionnelle. Toggle Is Default si c’est le profil par défaut. Cliquez sur Enregistrer.

laserfiche_install_image8.png

Informations du compte OneSpan Sign

Sélectionnez votre environnement OneSpan Sign (par exemple, US 2 Sandbox), saisissez votre nom d’utilisateur et mot de passe de votre compte OneSpan Sign. Cliquez sur Valider les identifiants pour tester.

Note : La validation utilise toujours les données sauvegardées , pas les valeurs de formulaire non enregistrées.

laserfiche_install_image9.png

Informations du compte Laserfiche

Saisissez le nom de votre serveur Laserfiche, le nom du dépôt, le nom par défaut du volume du dépôt, l’utilisateur Laserfiche et le mot de passe Laserfiche. Cliquez sur Valider les identifiants.

laserfiche_install_image10.png

Informations sur le serveur de flux de travail

Saisissez le nom du serveur de workflow Laserfiche et le port du serveur de workflow.

Infos sur le rappel OneSpan Sign

Entrez l’URL de rappel pointant vers l’application Notification Receiver. Exemple :

http://your.server.address/OneSpanSignConnectorService/api/Notify

HTTP et HTTPS sont tous deux pris en charge. Pour la touche de rappel, saisissez une chaîne de caractères alphanumériques de 6 à 12 caractères.

image-20260622-175435.png

Préférences de transaction

Cliquez sur le champ Email de l’expéditeur par défaut pour charger une liste des expéditeurs disponibles depuis votre compte OSS. Sélectionnez-en un comme expéditeur par défaut.

image-20260622-175447.png

Préférences de téléchargement

Configurez où les documents signés et les résumés de preuves sont sauvegardés après la fin de la transaction. Consultez le Guide utilisateur du client Web pour tous les détails sur les options de téléchargement.

image-20260622-175524.png


Configuration du flux de travail

1. Ajouter le champ PackageStatus_OSS au dépôt

Dans Laserfiche Administration, naviguez dans Métadonnées → Champs et créez un nouveau champ :

Propriété

Valeur

Nom

PackageStatus_OSS

Type

Texte

Largeur

40

image-20260622-175926.png

Laissez tous les autres paramètres à leurs paramètres par défaut et cliquez sur OK.

image-20260622-175954.png

2. Enregistrer les DLL d’activité personnalisées dans la Console d’Administration du Workflow

Les fichiers d’activité personnalisés se trouvent dans votre répertoire d’installation de workflow sous le dossier OneSpanSign , par exemple :

C :\Program Files\Laserfiche\Laserfiche Workflow 11\OneSpanSign

  1. Ouvrez la console d’administration du flux de travail.

  2. Naviguez dans Configuration du serveur → Activités personnalisées.

  3. Dans le panneau Actions , cliquez sur Ajouter une référence d’activité personnalisée.

  4. Parcourez le dossier OneSpanSign et ajoutez tous les fichiers DLL.

image-20260622-180019.png

Note : La recherche de fichiers doit être activée dans Options du navigateur de fichiers → Sécurité dans la Console d’administration du flux de travail avant de pouvoir ajouter des références DLL.

image-20260622-180059.png

3. Ajouter les activités personnalisées dans Workflow Designer

  1. Ouvre le concepteur de workflow.

  2. Faites un clic droit n’importe où dans le panneau Boîte à outils .

  3. Sélectionner la boîte à outils → ajouter/supprimer des activités...

image-20260622-180131.png

  1. Dans la fenêtre Ajouter/Supprimer les activités de la boîte à outils , cliquez sur Ajouter et sélectionnez les assemblages DLL OneSpan Sign.

  2. Cliquez sur OK.

image-20260622-180144.png

Les activités apparaîtront automatiquement sous un nouveau groupe OneSpan Sign dans la boîte à outils, contenant :

  • Télécharger les documents

  • Demande de signature

  • Informations sur les transactions

image-20260622-180204.png