Installation Serveur DataExpert

Transcription

1 Projet IGH DataExpert Installation Serveur DataExpert Date: Version: Table des matières 1 Introduction. 2 2 Conditions pour l'installation de DataExpert Installation de l'application de configuration DE_AnbietSetup 4 4 Préparation pour l'installation des Services Web Installation des Services Web pour "l'ancien" protocole (support de DataExpert-Clients < Version 2.0) Installation des Services Web pour le nouveau protocole (support de DataExpert-Clients >= Version 2.0) Organisation du serveur pour l'accès clients Admission de nouveaux utilisateurs Test de communication Attribution aux clients des paramètres d'autorisation d'accès Certificat X.509 / Acquisition et installation / 1-18

2 1 Introduction Une transmutation directe de DataExpert 1.5 sur DataExpert 2.0 est opérationnellement impossible: une mise à jour simultanée de tous les clients n'est pas faisable. La version 2.0 offre pour cela deux Services Web permettant du côté de l'offreur l'utilisation des deux versions pendant un certain temps. Durant cette phase, les deux Services Web doivent être installés parallèlement et être en service avec des URL différenciés. Les deux versions travaillent par contre avec une structure de données identique. Alte Branchenlösungen Anciennes applications Alte Branchenlösungen Nouvelles applications DataExpert API (DE_TransferInst) HTTPS/SOAP WebService (avec compression) HTTPS/SOAP WebService (sans compression) DataExpert\ DE_WebService (old style) DataExpert2\ DE_WebService DE_Anbiet (Konfig Editor) Cette installation implique.net Framework Version / 2-18

3 2 Conditions pour l'installation de DataExpert 2.0 Windows Server 2008.NET Framework Version 4.0 (version complète, pas la version client!) IIS IIS Management Compatibility / 3-18

4 3 Installation de l'application de configuration DE_AnbietSetup Sélectionner le fichier "IGH.DataExpert.DE_Anbiet.Setup.msi" et démarrer. Le répertoire proposé lors de l'implantation peut être simplement repris et se dénomme de manière standard C:\IGH\DataExpert\... Ce chemin d'accès peut être au besoin adapté dans le fichier "IGH.DataExpert.DE_Anbiet.exe.config". En cas de changement, ce chemin d'accès doit être également adapté dans les fichiers de configuration des Services Web. Important: L'application DE_Anbiet doit maintenant être démarrée une première fois. Elle se trouve sous "Démarrer > IGH > DE_Anbiet". La structure du répertoire de fichiers est organisée lors du premier démarrage de l'application. Les indications suivantes doivent être adaptées dans le fichier C:\IGH\DataExpert\Config\ServerConfig.xml après l'installation: PartnerId Le numéro univoque d'identification du partenaire (p.ex = Geberit). Une liste de tous les fournisseurs permettant l'accès DataExpert se trouve sous PartnerName Le nom de l'entreprise, p.ex. Geberit Distribution SA. URL du WebServer p.ex. ou sans certificat p.ex / 4-18

5 4 Préparation pour l'installation des Services Web Dans l'administration IIS (Internet Information Services Manager), un nouveau pool d'application doit être créé pour les Services Web DataExpert: Le nom "DataExpert" est donné au nouveau pool d'application et ".NET Framework v40.xxx" est appliqué / 5-18

6 Le nouveau pool d'application DataExpert doit être configuré après sa création. La représentation suivante montre comment le dialogue de configuration correspondant peut être ouvert: / 6-18

7 La caractéristique "Identity" doit être mutée sur "Local System": / 7-18

8 5 Installation des Services Web pour "l'ancien" protocole (pour le support de DataExpert-Clients < Version 2.0) Sélectionner le fichier "DE_WebService.Setup.msi" et démarrer. Le pool d'application "DataExpert" doit être sélectionné pendant l'installation: Le Service Web présume un enregistrement standard du répertoire de fichiers sous C:\IGH\DataExpert\... Ce chemin d'accès peut être au besoin adapté dans le fichier C:\inetpub\wwwroot\DataExpert\Web.config. Ce chemin d'accès doit être en concordance avec celui configuré pour DE_Anbiet (voir paragraphe 3, resp. l'image ci-après). URL du WebServer p.ex. ou sans certificat p.ex / 8-18

9 La communication cryptée via HTTPS/SSL nécessite l'acquisition et l'installation d'un certificat pour le serveur. La communication cryptée via HTTPS/SSL imposée nécessite la configuration adéquate de celle-ci avec l'internet Information Services Manager: / 9-18

10 6 Installation des Services Web pour le nouveau protocole (pour le support de DataExpert-Clients DataExpert >= Version 2.0) Sélectionner le fichier "DE_WebService.Setup.msi" " " et démarrer. Le pool d'application "DataExpert" doit être sélectionné pendant l'installation: Le Service Web présume un enregistrement standard du répertoire de fichiers sous C:\IGH\DataExpert DataExpert\ Ce chemin d'accès peut être au besoin adapté dans le fichier C:\inetpub\wwwroot wwwroot\dataexpert\web.config. Ce chemin d'accès doit être en concordance avec celui configuré pour DE_Anbiet (voir paragraphe 3) 3) / 10-18

11 La communication cryptée via HTTPS/SSL nécessite l'acquisition et l'installation d'un certificat pour le serveur. La communication cryptée via HTTPS/SSL imposée nécessite la configuration adéquate de celle-ci avec l'internet Information Services Manager: Attention: Ce Service Web est, après l'installation, préconfiguré pour HTTPS. La configuration dans le fichier web.config doit être adaptée afin de permettre une utilisation du Service Web avec HTTP. Dans ce but, les commentaires des réglages HTTPS doivent être introduits dans le domaine concerné, de même que les commentaires des réglages HTTP doivent être supprimés de leur domaine: <!--HTTPS--> <!--<system.servicemodel> <bindings> <basichttpbinding> <binding name="dataexpertbinding" maxbuffersize=" " maxbufferpoolsize=" " maxreceivedmessagesize=" "> <security mode="transport"/> <readerquotas maxdepth="32" maxstringcontentlength=" " maxarraylength=" " maxbytesperread="4096" maxnametablecharcount="16384" /> </binding> </basichttpbinding> </bindings> <services> <service name="igh.dataexpert.webservice.de_webservice"> <endpoint address="" binding="basichttpbinding" bindingconfiguration="dataexpertbinding" / 11-18

12 contract="igh.dataexpert.webservice.ide_webservice" /> <endpoint address="mex" binding="mexhttpsbinding" contract="imetadataexchange" /> </service> </services> <behaviors> <servicebehaviors> <behavior> <servicemetadata httpsgetenabled="true"/> <servicedebug includeexceptiondetailinfaults="true"/> </behavior> </servicebehaviors> </behaviors> <servicehostingenvironment multiplesitebindingsenabled="true" /> </system.servicemodel>--> <!--HTTP--> <system.servicemodel> <bindings> <basichttpbinding> <binding name="dataexpertbinding" maxbuffersize=" " maxbufferpoolsize=" " maxreceivedmessagesize=" "> <security mode="none"/> <readerquotas maxdepth="32" maxstringcontentlength=" " maxarraylength=" " maxbytesperread="4096" maxnametablecharcount="16384" /> </binding> </basichttpbinding> </bindings> <services> <service name="igh.dataexpert.webservice.de_webservice"> <endpoint address="" binding="basichttpbinding" bindingconfiguration="dataexpertbinding" contract="igh.dataexpert.webservice.ide_webservice" /> <endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange" /> </service> </services> <behaviors> <servicebehaviors> <behavior> <servicemetadata httpgetenabled="true"/> <servicedebug includeexceptiondetailinfaults="true"/> </behavior> </servicebehaviors> </behaviors> <servicehostingenvironment multiplesitebindingsenabled="true" /> </system.servicemodel> / 12-18

13 7 Organisation du serveur pour l'accès clients Lors de l'installation d'un nouveau serveur, les schémas et le fichier ServerUse peuvent être copiés à partir de l'ancien serveur, répertoire.\dataexpert\server\config. Config et chargés dans le nouveau répertoire.\config. Lors de la première installation du serveur s DataExpert,, les schémas fournis avec le dossier doivent être copiés dans le répertoire.\config.. Activation de nouveaux schémas De nouveaux schémas sont activés avec le programme DE_Anbiet. Les schémas demandés sont activés dans le menu "Options". Pour ce faire, les schémas peuvent être sélectionnés dans la liste et activés à l'aide de la fonction "Öffnen"("Ouvrir") (1) / 13-18

14 8 Admission de nouveaux utilisateurs (ouverture des autorisations d'accès) Les utilisateurs (clients), avec lesquels une communication électronique doit être établie, sont admis à l'aide du programme DE_Anbiet. Paramètres d'enregistrement: d'enregistrement Nom d'utilisateur Nom avec lequel le client s'identifie sur le WebServer. WebServer Mot de passe Sécurité de l'accès. Le client peut en tout temps changer online le mot de passe. Groupe Un fournisseur, offrant divers catalogues destinés à des groupes de clients précis, peut permettre à chaque client un accès individuel à chaque groupe. Dans ce cas, la structure des catalogues catalogu est.\catalog\groupe. Groupe. Les catalogues se trouvant directement dans le répertoire Catalog sont accessibles à tous les clients enregistrés. Lorsque le client est de plus attribué à un groupe, celui-ci ci a également accès aux données de ce répertoire. PayNet Id (PID) Le numéro de client PayNet doit être enregistré sous PID pour permettre un échange via PayNet de factures conformes TVA. Yellowbill Id (Postfinance) Le numéro de client Postfinance doit être enregistré sous Yellowbill pour permettre un échange via ia Postfinance de factures conformes TVA. Senden (Envoyer) Cette option permet le refus temporaire d'accès à un client sans perte de données. Toutes ces informations peuvent être naturellement administrées sur un système ERP/PGI et actualisées pour DataExpert par importation / 14-18

15 9 Test de communication IGH met à disposition un programme de test destiné à contrôler avant toute utilisation productive l'installation et l'accès conforme. Ce programme peut être installé sur n'importe quel système avec raccordement cordement Internet. Introduire "IGH.DataExpert.TestClient.Setup.msi IGH.DataExpert.TestClient.Setup.msi" et démarrer. Paramètres d'enregistrement: d'enregistrement WebServer URL L'URL du WebServer installé par vos soins. Voir si l'installation a été effectuée avec ou sans certificat (http ou https). https) Nom d'utilisateur Nom de User enregistré dans DE_Anbiet. DE_Anbiet Mot de passe Mot de passe défini dans DE_Anbiet. DE_Anbiet Traitement Diverses fonctions au choix. choix / 15-18

16 10 Attribution aux clients des paramètres d'autorisation d'accès La différence doit être faite dans ans les données destinées aux autorisations d'accès entre les clients désirant l'accès via WebService et ceux utilisant la version Client-Server. Client Server. Exemple de raccordement d'un WebServer URL WebServer p.ex. Nom d'utilisateur p.ex. "client1" Mot de passe p.ex. "aa7417%gral" Exemple de raccordement Client-Server Client / 16-18

17 11 Certificat X.509 / Acquisition et installation L'installation du certificat X.509 sur le WebServer du fournisseur permet la transmission cryptée de tous les messages SOAP par un canal https. Le certificat X.509 comprend entre autre la PublicKey du fournisseur de même que des informations sur le système de cryptage cautionné. Les indications suivantes sont données à titre d'exemple et indiquent le déroulement possible de l'acquisition du certificat et de son installation. Informations concernant le certificat du WebServer: Certificat Class 2 CA Ratio 1024 bits Fournisseur éventuel: TC TrustCenter AG Sonnigstrasse DE Hamburg La demande peut être transmise online à Dossiers indispensables: Extrait du Registre du Commerce Signature de la demande par une personne autorisée / 17-18

18 Fonctionnement avec l'assistent IIS Dans la Management-Console, sous IIS, aller sur le lien WebServer et sélectionner au moyen du menu les caractéristiques. Se muter sur le registre "Directory Security" et cliquer sur le Button Server Certificate. Le fichier de demande de certificat peut être établi ici avec l'aide d'un assistent. (Le ratio de bits sélectionné est de 1024) L'autorité de certificat CA envoie le certificat sous forme de fichier texte qui peut être lu par l'assistent. Installation ultérieure d'un certificat existant: Lorsqu'un certificat est déjà existant, un nouveau fichier de demande, qui permettrait une nouvelle lecture du certificat, ne peut pas être établi. Solution: activer dans la Management Console le certificat "Snap-In". Important: réglage sur "local computer"! Un certificat existant peut être lu sous "All Tasks" "Import " Ce certificat doit se trouver sous "Personal". Il apparait ensuite dans la Management Console IIS comme disponible pour IIS / 18-18