Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter

Mandatory

Example

Description

ApiLocation

https://myhisinone.customer.com/quiserver/services2

The API Url to the SOAP Service

Username

myuser

The username used to establish the connection

Password

🔑 * * * * * * * *

The password used to establish the connection

SecurityBindingConfiguration

AllowInsecureTranspor AllowInsecureTransport = truefalse
EnableUnsecuredResponse = truefalse
IncludeTimestamp = false

SecurityBindingConfiguration class used to configure the binding

TransportBindingConfiguration

AllowInsecureTransport (false by default): Will result in HTTP communication instead of HTTPS, which is not recommended due to security concerns if sensitive data of any kind is being transmitted.

EnableUnsecuredResponse (false by default): Allows WCF to send and receive unsecured responses to secured requests. Due to the same security concerns, enabling this is not recommended.

TransportBindingConfiguration

HostNameComparisonMode = 2
MaxReceivedMessageSize = 4194304
UnsafeConnectionNtlmAuthentication = trueTransportBindingConfiguration class used to configure the binding= false

HostNameComparisonMode (0 by default):

Code Block
0 = StrongWildcard: Ignores the hostname when dispatching incoming messages to this endpoint.
1 = Exact: Uses the hostname when dispatching incoming messages to this endpoint, if no strong match was found.
2 = WeakWildcard: If no strong or exact match was found, ignores the hostname when matching.

MaxReceivedMessageSize (65536 Bytes by default): The max size for received messages in Bytes. The CoreOne Suite currently requires this value to be at least 4 MB.

UnsafeConnectionNtlmAuthentication (false by default): Whether, when NTLM is used for authentication, additional requests using the same Transmission Control Protocol (TCP) connection are required to authenticate.

Sample configuration

Code Block
<ConnectionParameters>
  <ApiLocation>https://myhisinone.customer.com/quiserver/services2</ApiLocation>
  <Username>your username</Username>
  <Password>your password</Password>
  <SecurityBindingConfiguration>
    <AllowInsecureTransport>true</AllowInsecureTransport>
    <EnableUnsecuredResponse>true</EnableUnsecuredResponse>
    <IncludeTimestamp>false</IncludeTimestamp>
  </SecurityBindingConfiguration>
  <TransportBindingConfiguration>
    <HostNameComparisonMode>2</HostNameComparisonMode>
    <MaxReceivedMessageSize>4194304</MaxReceivedMessageSize>
    <UnsafeConnectionNtlmAuthentication>true</UnsafeConnectionNtlmAuthentication>
  </TransportBindingConfiguration>
</ConnectionParameters>

...