.NET SDK ClientConfigurator: Proxy Settings
To connect to the ThingWorx Platform through a proxy server, set the appropriate values for the ProxyInfo property on the ClientConfigurator. For authentication with a proxy server, the .NET SDK supports the following options:
• No authentication
• Basic authentication
• Digest authentication
• NTLM authentication
 |
As of v.5.8.2, the .NET SDK supports Server Name Indication (SNI) for Edge SDK clients when initiating the SSL connection. SNI support is required in the Edge client when using a reverse proxy to ThingWorx Platform, or the connection fails.
|
Setting Up a Proxy Server in the ClientConfigurator
To set up the information needed to access a ThingWorx Platform through a proxy server, use the ProxyInfo class. This calls sets the address and authentication credentials, using the following properties:
• host — Supply the IP address or host name of the proxy server to use when connecting to the ThingWorx Platform, as shown below.
• port — Supply the number of the port on the proxy server to use, as shown here:
config.ProxyInfo = new ProxyInfo();
config.ProxyInfo.Host = "xxx.xxx.xxx.xxx";
config.ProxyInfo.Port = xxxx;
• Claims — If the proxy server requires Basic or Digest authentication, a user name and password must be presented to the proxy server on connection. These credentials are only for the proxy server. They are not passed beyond it. Refer to the next section for information on using the callback function to obtain and pass in the password for proxy server authentication. To set the Claims property, you could use something like this:
string uid = myProxyUsername;
TwPasswordDelegate pwdCallback = myProxyPasswordCallback;
config.ProxyInfo.Claims = SecurityClaims.fromCredentials(uid, pwdCallback);
 |
To improve security, callbacks have been implemented for strings of Base Type PASSWORD. The affected PASSWORD types are proxy passwords and digests, certificate passwords and passphrases, and application keys. For more information, refer to .NET SDK: SecurityClaims Class.
|