Custom sms webservice for use with UMGateway 5.x

Installation

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 <account> contains customers and access informations

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

Flood Protection

You can enable the flooding protection to this webservice (to prevent dos attacks)

EnableFloodProtection
DosProtectionStatisticMinutes
DosProtectionStatisticRequestsLimit
DosProtectionStatisticWhiteList