File Deployment
Create new folder named webapp in the UMGateway directory (default location: c:\umgateway)
Copy the complete content of this ZIP including the subdirectories to the UMGateway folder: c:\umgateway\webapp
Set the IIS permission for the webservice: Select folder -> Properties ->
Security Tab:
Add: IUSR_... and Network_Service
[Advanced] Button, check: Replace permission on all child ...
Web Setup
IIS 6.0
Webservice Configuration
Name | Description | Example Value |
Debug | For deep debugging only (set to false in production mode) | False |
GenericWebservice_UMGatewaySoap_IUmgMsgWsservice |
URL to the server address of the UMGateway server application (or Proxy) If the webservice is installed on the same server as UMGateway you can point to localhost |
http://localhost8000/soap/IUmgMsgWs |
UMGatewaySoap_wslogin |
Username of Credentials for XML/SOAP Interface of UMGateway Username defined in the user.ini (file mode) or interface tabel (database mode) in the UMGateway Server Application |
someuser |
UMGatewaySoap_wspassword |
Password of Credentials for XML/SOAP Interface of UMGateway Username defined in the user.ini (file mode) or interface tabel (database mode) in the UMGateway Server Application |
somepassword |
AccountsFileName | Website relative path and filename to the accounting.xml document | /accountdata/ws-accounts.xml |
Config user Access
The webservice access is defined in the accounting.xml (ws-accounts.xml)
The xml node
Each customer have one <account ..> node containing
Config Soap Access in UMGateway (filemode)
The users.ini in the config folder of the UMGateway root folder (c:\umgateway\config\users.ini) define the access for this webservice
Add Line (example for localhost access only)
#webserice01;1;0;wsusername;wspassword1;127.0.0.1;255;0;;
Start UMGateway Configuration -> Interface -> XML/SOAP
Check Enable
Save the file and restart the umgateway com service
(after new start the Communication Service you should see "Service: Init
webservice on port: 8000" in the Trace)
TESTING
Test the UMG SOAP Webservice:
http://localhost:8000/
Test the new installed Webservice
http://localhost/webservice
You should get the Websrvice Function List Page
With the function: CheckWebserviceState you can check the complete Configuration
Chain (Frontend until SOAP Access and UMGateway)
The Result codes are from UMGateway SOAP Service and is corresponding to the
Interface Documentation of UMGateway
With the function: CheckLogin you can check the Webervice User Access (ws-accounts.xml)
Flood Protection
You can enable the flooding protection to this webservice (to prevent dos attacks)
EnableFloodProtection
DosProtectionStatisticMinutes
DosProtectionStatisticRequestsLimit
DosProtectionStatisticWhiteList