SOG-Helpcenter Logo SOG Business - Software

HttpService


Neuer Service des SOG ERPSrv der Http-Basierte Anfragen verarbeiten kann. Dieser implementiert z.B. den Soap-Handler.

Der Service verfügt über folgende Parameter:

 

ServiceConfig

Pfad bzw. Name der Konfigurationsdatei. z.B. "httpservice_cfg.xml"

Diese hat z.B. folgenden Inhalt:


<?xml version="1.0" encoding="utf-8"?>
<HttpServConfig>
  <Uris>
    <Uri>http://localhost:4401/</Uri>
    <Uri>http://localhost:4402/</Uri>
    <Uri>http://localhost:4403/</Uri>
    <Uri>http://MeinService:8875/<Uri>
  </Uris>
  <Handlers>
    <SoapRequestHandler... />
  </Handlers>
</HttpServConfig>

 

URI

Uniform Resource Identifier - legt fest, welche Adressen vom HttpService auf Anfragen abgehört werden sollen.

Damit der Service nicht nur lokal auf dem ausführenden System verfügbar ist, müssen zwei Schritte ausgeführt werden:

  • Die URI muss mittels netsh http add urlacl url=${INSERT_URL_HERE} user=DOMAIN\Username listen=yes freigeschaltet werden.
    Beispiel: netsh http add urlacl url=http://MeinService:8875 user=MeineDomain\SOGADM listen=yes

  • In der Firewall muss für den entsprechenden Port, im Beispiel 8875 eine Inboundrule für TCP definiert werden, die den Zugriff erlaubt.

Handlers

Hier können verschiedene Handler definiert werden. Z.B. ein Soap-Handler oder ein WebHelp-Handler.

White- bzw.Blacklists

Jeder Handler kann mit einer White- bzw. Blacklist für IPAdressen konfiguriert werden um den Zugriff einzuschränken.
Es können beliebig viele Adressen im IPv4 bzw. IPv6 Format angegeben werden. Der Schalter whiteList steuert dabei, ob es sich um Ein- bzw. Ausschlüsse handelt.
Ist dieser nicht angegeben, entspricht es dem Wert true (Einschluss).

<SoapRequestHandler....>
    <Filter whiteList="true">
      <Address>127.0.0.1</Address>
      <Address>::1:</Address>
    </Filter>


AuthenticationRequired

Schalter mit dem die Authentifizierung an- und ausgeschaltet werden kann.

AuthenticationScheme

Kommagetrennte Listen von erlaubten Authentifizierungen.

Erlaubt sind folgende Werte :

 

None

Digest

Funktioniert nur sofern die verwendeten Nutzer sich innerhalb der gleichen Domäne, in der auch der Server läuft, befinden.

Negotiate

Ntlm

Basic

Anonymous

IntegratedWindowsAuthentication

Eine genaue Beschreibung ist hier zu finden: .net AuthenticationSchemes

Wird AuthenticationRequired auf "false" gesetzt oder das AuthenticationScheme "none" erlaubt, verwendet der Dienst den Benutzer als Sachbearbeiter, unter dem der Dienst gestartet wurde. Diese kann dazu führen, dass dem Dienstebenutzer weit mehr Rechte zur Verfügung stehen, als er normalerweise in SOG ERP hätte.

LogMode

Der Modus wie bzw. wann der Service Logdateien anlegt

 

LogOnly

Keine Log-Datei nur Logbuchausgaben.

Silent

Es wird nur eine Log-Datei produziert.

Error

Im Fehlerfall werden sowohl Log-Dateien als auch Logbuchausgaben produziert.

Full

Es werden immer sowohl Log-Dateien als auch Logbuchausgaben produziert. Achtung: Bei Verwendung von Full können sehr viele Protokolldateien entstehen!

LogDir

Verzeichnis in dem Logdateien ausgegeben werden.

ServicesConfig

Name der ServiceKonfiguration die verwendet werden soll. Beispiel: httpservice_cfg.xml
Die Konfiguration wird wie üblich in den durch die Variable FRMCFGPATH festgelegten Verzeichnissen gesucht.

 

 

Die Aufbewahrungsdauer von Log-Dateien kann über die ENV HTTPServiceReorgLogFileDays in Tagen definiert werden. Ist die env nicht gesetzt, werden Log-Dateien automatishc nach drei Tagen gelöscht.