Setting up Your Environment
- Mahnoor Khan (Deactivated)
- Greg Walsh
Updating Your SOAP Address
After downloading your WSDL file:
be sure to open up the WSDL document in your favorite editor and adjust the target address of the SOAP interface to your server's address. This can be accomplished by searching for the "soap:address" element to configure the URL. Be sure to use an HTTPS secured address to ensure that authentication headers are encrypted.
<wsdl:port name="EngageIP_x0020_Web_x0020_Services_x0020_APISoap" binding="tns:EngageIP_x0020_Web_x0020_Services_x0020_APISoap">
<soap:address location="https://yourdomain/adminportal/webservice.asmx" />
</wsdl:port>
<wsdl:port name="EngageIP_x0020_Web_x0020_Services_x0020_APISoap12" binding="tns:EngageIP_x0020_Web_x0020_Services_x0020_APISoap12">
<soap12:address location="https://yourdomain/adminportal/webservice.asmx" />
</wsdl:port>SOAP Authentication Headers
When integrating with the EngageIP SOAP interface you will need authenticate against the system using SOAP authentication headers in your API calls. These provide both a username and password on each API call to ensure that the caller is authenticated against the system.
NOTE: It is important to note that you should be using an SSL encrypted channel for your SOAP API calls as username and password credentials are passed in plain text in the SOAP authentication header.
Example SOAP request:
POST /adminportal/webservice.asmx HTTP/1.1
Host: demo.logisense.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<AuthHeader xmlns="Logisense_EngageIP">
<Username>string</Username>
<Password>string</Password>
</AuthHeader>
</soap12:Header>
<soap12:Body>
.....
</soap12:Body>
</soap12:Envelope>