WS#42368: Installation und Konfiguration CxSyncGateway

Der CxSyncGateway ist ein Programm, welches die Kommunikation zwischen verschiedenen Partnern regelt. Der CxSyncGateway wird insbesondere für die Kommunikation mit MDEs, aber auch für andere Zwecke eingesetzt.

Installation

Die Installation des CxSyncGateways erfolgt durch das entsprechende Setup-Programm. Zudem muss eine gültige Datenbank installiert werden.

ACHTUNG: Wird das Setup-Programm über eine bestehenden CxSyncGateway Installation ausgeführt, so sollten die beiden unten beschriebenen Konfigurations-Dateien zuerst gesichert werden.
Bestehende Dateien durch die Installation überschrieben.

Die Installation im Umfeld von CodX PostOffice ist in der AdminDoc beschrieben.

Konfiguration

CxSyncGateway.exe.config

Hier ein Beispiel des Config-Files für CxSyncGateway:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup>
<appSettings>
    <add key="HttpAdress" value="+" />
    <add key="HttpsAdress" value="" />      <-- Wert eintragen, falls Https verwendet werden soll -->
    <add key="HttpPort" value="80" />       <-- Port ändern, falls nötig -->
    <add key="HttpsPort" value="443" />     <-- Port ändern, falls nötig -->
    <add key="PurgeDeltaFile [d]" value="3" /> <-- Wie lange sollen Delta-Files auf dem CxSyncGateway bleiben (nicht ändern!) -->
    <add key="PurgeAllFile [d]" value="60" />   <-- Wie lange sollen die übrigen Files auf dem CxSyncGateway bleiben (nicht ändern) -->
    <add key="ClientSettingsProvider.ServiceUri" value="" />
</appSettings>
<connectionStrings>
    <add name="CxSyncGateway" connectionString="Data Source=<DBserver>;Initial Catalog=<CatalogName>;User ID=<User>;Password=<Password>" providerName="System.Data.SqlClient" /> <-- Connection String anpassen -->
</connectionStrings>
<runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.Owin" publicKeyToken="31bf3856ad364e35" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-3.0.0.0" newVersion="3.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
</runtime>
<system.web>
    <membership defaultProvider="ClientAuthenticationMembershipProvider">
      <providers>
        <add name="ClientAuthenticationMembershipProvider" type="System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider, System.Web.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceUri="" />
      </providers>
    </membership>
    <roleManager defaultProvider="ClientRoleProvider" enabled="true">
      <providers>
        <add name="ClientRoleProvider" type="System.Web.ClientServices.Providers.ClientRoleProvider, System.Web.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceUri="" cacheTimeout="86400" />
      </providers>
    </roleManager>
</system.web>
</configuration>

log4Net.config

Hier die Konfigurationen, welche am log4Net.config vorgenommen werden müssen.

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
<appender name="CxSyncGateway" type="log4net.Appender.RollingFileAppender">
  <file type="log4net.Util.PatternString" value="<FullLogFileName>" /> <-- z.B. C:\\ProgramData\\CodX\\CxSyncGateway\\CxSyncGateway.log -->
  <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
  <rollingStyle value="Size" />
  <datePattern value="yyyyMMdd" />
  <maxSizeRollBackups value="100" />
  <maximumFileSize value="10MB" />
  <layout type="log4net.Layout.PatternLayout">
   <conversionPattern value="%date %-5level: %message%newline" />
  </layout>
  <threshold value="INFO" />
</appender>
<appender name="trace" type="log4net.Appender.TraceAppender, log4net">
  <immediateFlush value="true" />
  <layout type="log4net.Layout.PatternLayout">
   <conversionPattern value="%date %-5level %logger: %message%newline" />
  </layout>
</appender>
<root>
  <level value="ALL" />
  <appender-ref ref="CxSyncGateway" />
</root>
</log4net>

Konfiguration auf PC-Betriebssystem

Für die Konfiguration des CxSyncGateways auf einem PC-Betriebssystem müssen folgende Befehle ausgeführt werden:

netsh http show urlacl
netsh http add urlacl url=http://<server>:80/ user=Everyone
netsh http add urlacl url=https://<server>:443/ user=NT_AUTHORITY\SYSTEM
netsh http delete urlacl url=https://<server>:443/

Einrichten von SSL

Um SSL verwenden zu können, müssen folgende Befehle ausgeführt werden:

netsh http show sslcert
netsh http add sslcert hostnameport=<server>:443 certhash=<Fingerprint> appid={<guid>} certstorename=MY
netsh http delete sslcert hostnameport=<server>:443

Testen

Der CxSyncGateway kann mit dem Aufruf des folgenden URLs getestet werden:

http(s)://<server>/cxsyncapi/checkconnection/MyMandat/MyPartner

Der CxSyncGateway sendet folgende Antwort

"CheckConnection OK for: MyMandat - MyPartner - DBserver-UTC-Time"