Le AcombaWebService est un service web SOAP fonctionnant sous IIS et utilisant le SDK de Acomba pour effectuer un pont avec Progression LIVE. Il permet des échanges de données bidirectionnels.
Pré-requis:
- Système d'exploitation Windows avec le .NET framework 4.x Télécharger ici
- Le serveur IIS (Serveur web de microsoft) installé et fonctionnel**
- Un utilisateur / mot de passe avec accès au serveur et les permissions de lecture / écriture dans les répertoires d'acomba
- Un utilisateur / mot de passe pour Acomba
- Accès au routeur de votre compagnie
- Avoir un outil d'accès à distance sur le serveur du client ( Exemple TeamViewer ou Screenconnect )
Version de Windows supportées :
Server
- Windows Server 2008
- Windows Server 2012
- Windows Server 2016
Workstation
- Windows 7
- Windows 8
- Windows 8.1
- Windows 10
Procédure d'installation:
- Configuration de IIS
- Si la version de IIS est 7 ou +, installer les outils de compatibilité pour IIS 6
- Si aucun certificat installé, configurer l'accès au serveur IIS en mode SSL avec un certificat auto-signé (si aucun certificat présent).
- IIS 7: http://www.sslshopper.com/article-how-to-create-a-self-signed-certificate-in-iis-7.html
- IIS 6: https://community.aspnix.com/windows-manuals-tutorials-tos/2669-create-self-signed-secure-socket-layer-certificate-ii6-windows-server-2003-a.html
- IIS 5: http://www.xenocafe.com/tutorials/self_signed_cert_IIS/self_signed_cert_IIS-part1.php
- Créer un utilisateur "acombaws"
- Cet utilisateur doit avoir les droits de lecture et écriture dans le répertoire de données d'acomba.
- Cet utilisateur doit avoir les droits de lecture et écriture dans le répertoire de données d'acomba.
- Ajouter un nouveau app pool appelé AcombaWS.
- Configurer le app pool AcombaWS
- pour qu'il s'exécute en tant que l'utiisateur "acombaws" définit auparavant
- pour qu'il utilise .NET 4
- pour qu'il supporte le 32 bits
- S'assurer que le serveur peut répond bien au URL https://localhost
- S'assurer que le firewall de Windows ne bloque pas les requêtes entrantes sur IIS
- Installation du AcombaWebService
- Télécharger les fichiers de l'installateur ici : http://plive.ca/acomba/AcombaWebServiceSetup.zip
- Extraire les fichiers dans un répertoire
- Exécuter setup.exe
- Sélectionner le app pool AcombaWS
- Donner les droit de lecture / écriture au répertoire C:\Inetpub\wwwroot\AcombaWebService à l'utilisateur acombaws
- Désactiver le mode de sécurité anonymous et activer le mode d'authenfication de base.
- Configuration des options de connexion dans le fichier web.config
- Ouvrir le répertoire C:\Inetpub\wwwroot\AcombaWebService
- Ouvrir le fichier Web.config
- Modifier les paramètres de la section <appSettings>
- Inscrire les paramètres concernant votre compagnie
- Donner les droits d'écriture à l'utilisateur "acombaws" dans le répertoire où le web service a été installé. Par défaut, il s'agira de C:\inetpub\wwwroot\AcombaWebService
- Configurer un "port mapping" dans votre routeur.
- Port externe 8443 vers votre serveur IIS (IP fixe svp) sur le port 443
- Si votre adresse IP publique n'est pas fixe, configurer un agent du type no-ip.org ou dyndns.com
- Optionnel: configurer un accès à distance pour le support technique et l'aide à distance
Configuration plusieurs compagnies sur un même serveur IIS
Pré-requis:
- Avoir une 2e compte progression live
- Utiliser la même version d'Acomba pour toutes les compagnies
- Avoir complété avec succès le setup de la première compagnie
Procédure d'installation:
- Copier le répertoire de la première installation du web service (par défaut, il s'agira de C:\inetpub\wwwroot\AcombaWebService)
- Renommer le répertoire copié pour AcombaWebService2
- Dans la configuration IIS, convertir le nouveau répertoire en application.
-
- Essayer d'accéder au URL : http://localhost/acombaWebService2/acomba.asmx
-
- Configurer les options de connexion dans le fichier web.config
- Ouvrir le répertoire C:\Inetpub\wwwroot\AcombaWebService2
- Ouvrir le fichier Web.config
- Modifier les paramètres de la section <appSettings>
- Inscrire les paramètres concernant votre 2e compagnie
- Dans la configuration Acomba de la 2e compagnie, changer le URL pour https://....../AcombaWebService2/acomba.asmx