installation serveur dataexpert - igh5)installation-server-f.pdf · 2016. 3. 10. · igh /...

_________________________________________________________________________________IGH / Installation Serveur 2.0.0.2

Projet IGH DataExpert______________________________________________________

Installation Serveur DataExpert

Table des matières

1 Introduction …………………………………………………

2 Conditions pour l'installation de DataExpert 2.0 ……………………

3 Installation de l'application de configuration DE_AnbietSetup …………………

4 Préparation pour l'installation des

5 Installation des Services Web pour "l'ancien" protocole(support de DataExpert

6 Installation des Services Web pour le nouveau protocole(support de DataExpert

7 Organisation du serveur pour l'accès clients …………………………………

8 Admission de nouveaux utilisateurs ……………………………………………

9 Test de communication ………………………………………………………

10 Attribution aux clients des paramètres d'a

11 Certificat X.509 / Acquisition et installation …………………………………

_________________________________________________________________________________

Projet IGH DataExpert______________________________________________________


Date: 20.09.2011Version: 2.0.0.2

………………………………………………………………

Conditions pour l'installation de DataExpert 2.0 ………………………

Installation de l'application de configuration DE_AnbietSetup …………………

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) ……………………………

erveur 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 …………………………………

_________________________________________________________________________________20.09.2011 / 1 - 18

______________________________________________________


…………….………… 2

………………... 3

Installation de l'application de configuration DE_AnbietSetup ……………………… 4

Services Web ………………………………..……5

Clients < Version 2.0) …………………………………..……8

n 2.0) ……………………………….…… 10

erveur pour l'accès clients …………………………………….…. 13

Admission de nouveaux utilisateurs ……………………………………………….….14

Test de communication ………………………………………………………….…….. 15

utorisation d'accès ……………….……. 16

Certificat X.509 / Acquisition et installation …………………………………….……. 17

_________________________________________________________________________________IGH / Installation Serveur 2.0.0.2 20.09.2011 / 2 - 18

Alte BranchenlösungenAlte BranchenlösungenAnciennes applications

DataExpert\DE_WebService(old style)

DE_Anbiet(Konfig Editor)

HTTPS/SOAP WebService(avec compression)

DataExpert API(DE_TransferInst)

Nouvelles applications

DataExpert2\DE_WebService

HTTPS/SOAP WebService(sans compression)

1 Introduction

Une transmutation directe de DataExpert 1.5 sur DataExpert 2.0 est opérationnellementimpossible: une mise à jour simultanée de tous les clients n'est pas faisable. La version 2.0offre pour cela deux Services Web permettant du côté de l'offreur l'utilisation des deuxversions pendant un certain temps. Durant cette phase, les deux Services Web doivent êtreinstallés parallèlement et être en service avec des URL différenciés. Les deux versionstravaillent par contre avec une structure de données identique.

Cette installation implique .NET Framework Version 4.0.


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 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 êtreau besoin adapté dans le fichier "IGH.DataExpert.DE_Anbiet.exe.config". En casde changement, ce chemin d'accès doit être également adapté dans les fichiers deconfiguration des Services Web.

Important:

L'application DE_Anbiet doit maintenant être démarrée une première fois. Elle setrouve sous "Démarrer > IGH > DE_Anbiet". La structure du répertoire de fichiersest organisée lors du premier démarrage de l'application.

Les indications suivantes doivent être adaptées dans le fichierC:\IGH\DataExpert\Config\ServerConfig.xml après l'installation:

PartnerIdLe numéro univoque d'identification du partenaire (p.ex. 1900 = Geberit). Uneliste de tous les fournisseurs permettant l'accès DataExpert se trouve soushttp://www.igh.ch/SC/IDNR-Lief-d.html.

PartnerNameLe nom de l'entreprise, p.ex. Geberit Distribution SA.

URL du WebServerp.ex. https://igh2.exigo.ch/DataExpert2/DE_WebService.svcou sans certificatp.ex. http://igh2.exigo.ch/DataExpert2/DE_WebService.svc


4 Préparation pour l'installation des Services Web

Dans l'administration IIS (Internet Information Services Manager), un nouveau poold'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é.


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


La caractéristique "Identity" doit être mutée sur "Local System":


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 fichierssous C:\IGH\DataExpert\... Ce chemin d'accès peut être au besoin adapté dans lefichier C:\inetpub\wwwroot\DataExpert\Web.config. Ce chemin d'accès doit êtreen concordance avec celui configuré pour DE_Anbiet (voir paragraphe 3, resp.l'image ci-après).

URL du WebServerp.ex. https://igh2.exigo.ch/DataExpert/DE_WebService.asmxou sans certificatp.ex. http://igh2.exigo.ch/DataExpert/DE_WebService.asmx


La communication cryptée via HTTPS/SSL nécessite l'acquisition et l'installationd'un certificat pour le serveur.

La communication cryptée via HTTPS/SSL imposée nécessite la configurationadéquate de celle-ci avec l'Internet Information Services Manager:


6 Installation des Services Web pour le nouveau protocole(pour le support de DataExpert

Sélectionner le fichier " Le pool d'application

Le Service Web présume un enregistrement standard du répertoire de fichierssous C:\IGH\DataExpertfichier C:\inetpub\wwwrooten concordance avec celui configuré pour DE_Anbiet (voir paragraphe 3)

_________________________________________________________________________________

Installation des Services Web pour le nouveau 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 fichiersDataExpert\... Ce chemin d'accès peut être au besoin adapté dans le

wwwroot\DataExpert\Web.config. Ce chemin d'accès doit êtreconcordance avec celui configuré pour DE_Anbiet (voir paragraphe 3)

_________________________________________________________________________________20.09.2011 / 10 - 18

Installation des Services Web pour le nouveau protocole

" et démarrer."DataExpert" doit être sélectionné pendant l'installation:

Le Service Web présume un enregistrement standard du répertoire de fichiers... Ce chemin d'accès peut être au besoin adapté dans le

Ce chemin d'accès doit êtreconcordance avec celui configuré pour DE_Anbiet (voir paragraphe 3).

La communication cryptée via HTTPS/SSL nécessite l'acquisition et l'installationd'un certificat pour le serveur.

La communication cryptée via HTTPS/SSL imposée nécessite la configurationadé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 lefichier web.config doit être adaptée afin de permettre une utilisation du Service Web avecHTTP. Dans ce but, les commentaires des réglages HTTPS doivent être introduits dans ledomaine concerné, de même que les commentaires des réglages HTTP doivent être supprimésde leur domaine:

<!--<system.serviceModel>

<bindings><basicHttpBinding><binding name="DataExpertBinding" maxBufferSize="2147483647"

maxBufferPoolSize="2147483647"maxReceivedMessageSize="2147483647"><security mode="Transport"/><readerQuotas maxDepth="32" maxStringContentLength="5242880"

maxArrayLength="2147483647" 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="mexHttpsBinding"

contract="IMetadataExchange" /></service>

</services><behaviors>

<serviceBehaviors><behavior>

<serviceMetadata httpsGetEnabled="true"/><serviceDebug includeExceptionDetailInFaults="true"/>

</behavior></serviceBehaviors>

</behaviors><serviceHostingEnvironment multipleSiteBindingsEnabled="true" />

</system.serviceModel>--><system.serviceModel>

<bindings><basicHttpBinding><binding name="DataExpertBinding" maxBufferSize="2147483647"

maxBufferPoolSize="2147483647"maxReceivedMessageSize="2147483647"><security mode="None"/><readerQuotas maxDepth="32" maxStringContentLength="5242880"

maxArrayLength="2147483647" 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>


7 Organisation du serveur

Lors de l'installation d'un nouveau serveur, les schémas et le fichier ServerUse peuvent êtrecopiés à partir de l'ancien serveur, répertoire .nouveau répertoire .\Config.

Lors de la première installation du sdoivent être copiés dans le répertoire .

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 menupeuvent être sélectionnés dans la liste et activés à l'aide de la fonction "Öffnen"("Ouvrir") (1).

_________________________________________________________________________________

serveur pour l'accès clients

Lors de l'installation d'un nouveau serveur, les schémas et le fichier ServerUse peuvent êtrecopiés à partir de l'ancien serveur, répertoire .\DataExpert\Server\Config et chargés dans le

de la première installation du serveur DataExpert, les schémas fournis avec le dossierdoivent ê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émaspeuvent être sélectionnés dans la liste et activés à l'aide de la fonction "Öffnen"("Ouvrir") (1).

_________________________________________________________________________________20.09.2011 / 13 - 18

Lors de l'installation d'un nouveau serveur, les schémas et le fichier ServerUse peuvent êtreConfig et chargés dans le

, les schémas fournis avec le dossier

"Options". Pour ce faire, les schémaspeuvent être sélectionnés dans la liste et activés à l'aide de la fonction "Öffnen"("Ouvrir") (1).


8 Admission de nouveaux utilisateurs(ouverture des autorisations d'accès)

Les utilisateurs (clients), avecsont admis à l'aide du programme DE_Anbiet.

Paramètres d'enregistrement

Nom d'utilisateurNom avec lequel le client s'identifie sur le WebServer

Mot de passeSécurité de l'accès. Le

GroupeUn 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, lastructure des catalogudirectement dans le répertoire Catalog sont accessibles à tous les clients enregistrés.Lorsque le client est de plus attribué à un groupe,données de ce répertoire.

PayNet Id (PID)Le numéro de client PayNet doit être enregistré sous PID pour permettre un échangevia PayNet de factures conformes

Yellowbill Id (Postfinance)Le numéro de client Postfinance doit être enregistré sous Yellowbill pour permettre unéchange via 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èmeERP/PGI et actualisées pour

_________________________________________________________________________________

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:

Nom avec lequel le client s'identifie sur le WebServer.

Sécurité de l'accès. Le client peut en tout temps changer online le mot de passe.

Un fournisseur, offrant divers catalogues destinés à des groupes de clients précis,permettre à chaque client un accès individuel à chaque groupe. Dans ce cas, la

structure des catalogues est .\Catalog\Groupe. Les catalogues se trouvantdirectement dans le répertoire Catalog sont accessibles à tous les clients enregistrés.Lorsque le client est de plus attribué à un groupe, celui-ci a également accès auxdonnées de ce répertoire.

Le numéro de client PayNet doit être enregistré sous PID pour permettre un échangede factures conformes TVA.

Yellowbill Id (Postfinance)Le numéro de client Postfinance doit être enregistré sous Yellowbill pour permettre un

ia Postfinance de factures conformes TVA.

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èmeERP/PGI et actualisées pour DataExpert par importation.

_________________________________________________________________________________20.09.2011 / 14 - 18

lesquels une communication électronique doit être établie,

client peut en tout temps changer online le mot de passe.

Un fournisseur, offrant divers catalogues destinés à des groupes de clients précis,permettre à chaque client un accès individuel à chaque groupe. Dans ce cas, la

Groupe. Les catalogues se trouvantdirectement dans le répertoire Catalog sont accessibles à tous les clients enregistrés.

ci a également accès aux

Le numéro de client PayNet doit être enregistré sous PID pour permettre un échange

Le numéro de client Postfinance doit être enregistré sous Yellowbill pour permettre un

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


9 Test de communication

IGH met à disposition un programme de test destiné à contrôler avant toute utilisationproductive l'installation et l'accès conforme. Ce programme peut être installé sur n'importequel système avec raccordement Internet.Introduire "IGH.DataExpert.TestClient.Setup.msi

Paramètres d'enregistrement

WebServer URLL'URL du WebServer installé par vos soins.ou sans certificat (http ou https)

Nom d'utilisateurNom de User enregistré dans DE_Anbiet

Mot de passeMot de passe défini dans DE_Anbiet

TraitementDiverses fonctions au choix

_________________________________________________________________________________

Test de communication

IGH met à disposition un programme de test destiné à contrôler avant toute utilisationproductive l'installation et l'accès conforme. Ce programme peut être installé sur n'importe

cordement Internet.IGH.DataExpert.TestClient.Setup.msi" et démarrer.

Paramètres d'enregistrement:

L'URL du WebServer installé par vos soins. Voir si l'installation a été effectuée avecou sans certificat (http ou https).

Nom de User enregistré dans DE_Anbiet.

Mot de passe défini dans DE_Anbiet.

Diverses fonctions au choix.

_________________________________________________________________________________20.09.2011 / 15 - 18

IGH met à disposition un programme de test destiné à contrôler avant toute utilisationproductive l'installation et l'accès conforme. Ce programme peut être installé sur n'importe

Voir si l'installation a été effectuée avec


10 Attribution aux clients des paramètres d'autorisation d'accès

La différence doit être faite dans lesclients désirant l'accès via WebService et ceux utilisant la version Client

Exemple de raccordement d'un WebServer

URL WebServerp.ex. https://igh2.exigo.ch/DataExpert2/DE_WebService.svc

Nom d'utilisateurp.ex. "client1"

Mot de passep.ex. "aA7417%Gral"

Exemple de raccordement Client

_________________________________________________________________________________

Attribution aux clients des paramètres d'autorisation d'accès

ans les données destinées aux autorisations d'accès entre lesclients désirant l'accès via WebService et ceux utilisant la version Client-Server.

Exemple de raccordement d'un WebServer

https://igh2.exigo.ch/DataExpert2/DE_WebService.svc

Exemple de raccordement Client-Server

_________________________________________________________________________________20.09.2011 / 16 - 18

Attribution aux clients des paramètres d'autorisation d'accès

données destinées aux autorisations d'accès entre lesServer.


11 Certificat X.509 / Acquisition et installation

L'installation du certificat X.509 sur le WebServer du fournisseur permet la transmissioncryptée de tous les messages SOAP par un canal https. Le certificat X.509 comprend entreautre la PublicKey du fournisseur de même que des informations sur le système de cryptagecautionné.

Les indications suivantes sont données à titre d'exemple et indiquent le déroulementpossible 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 AGSonnigstrasse 24-28DE 20097 Hamburg

La demande peut être transmise online à www.trustcenter.de.

Dossiers indispensables:

Extrait du Registre du Commerce Signature de la demande par une personne autorisée


Fonctionnement avec l'assistent IIS

Dans la Management-Console, sous IIS, aller sur le lien WebServer et sélectionnerau 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 êtrelu par l'assistent.

Installation ultérieure d'un certificat existant:

Lorsqu'un certificat est déjà existant, un nouveau fichier de demande, qui permettraitune 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 laManagement Console IIS comme disponible pour IIS.

installation serveur dataexpert - igh5)installation-server-f.pdf · 2016. 3. 10. · igh /...

Documents