Page tree
Skip to end of metadata
Go to start of metadata

 

Introduction

If your organization uses a forward web proxy to control or improve performance of internet or intranet access, the CAST Delivery Manager Tool supports this. Note that HTTP proxies are fully supported, however, SOCKS proxies are untested. To support this, the DMT relies on Java's proxy configuration.

To configure a proxy in your command line, please alter the very last line in the batch file where the javaws.exe is called, for example:

"C:\Program Files (x86)\Java\jre7\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_Deliver%"

You need to add the following two parameters, changing <value> respectively to the IP address of the proxy server and the port it functions on:

  • -J-Dhttp.proxyHost=<hostIPAddress>
  • -J-Dhttp.proxyPort=<hostPortNumber>

The following shows these parameters in action:

"C:\Program Files (x86)\Java\jre7\bin\javaws.exe" -J-Dhttp.proxyHost=10.0.1.50 -J-Dhttp.proxyPort=81 %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_Deliver%"
Note that HTTP proxies are fully supported via the Java proxy configuration, however, SOCKS proxies are untested. To support this, the DMT relies on Java's proxy configuration.

Authentication

Please note that if your web proxy uses SSO (Single Sign On) authentication, the CAST Delivery Manager Tool does not support it.

If your web proxy requires authentication, you need to use the following two parameters to allow auto login during the command line action:

  • -pxUsername
  • -pxPassword  or -pxAuthKey

CAST recommends that these parameters are added to your command line by setting a variable (%PXAUTH%) in the batch file - this variable should be set in the same location as the %AUTH% variable (see above):

set PXAUTH=-pxUsername JoeBloggs -pxPassword cast

This will send the username and password in clear-text - if you need to encrypt the password to improve security (highly recommended), you should instead generate an encryption key (please see Encrypting the password for the DMT command line for more information) for your password and use it as follows:

set PXAUTH=-pxUsername JoeBloggs -pxAuthKey <your encrypted key>

For example:

set PXAUTH=-pxUsername JoeBloggs -pxAuthKey u0tjM5qkCZO8IpzrD0CYUw==

You should then use the %PXAUTH% variable within the quote marks for the -open command as follows:

"C:\Program Files (x86)\Java\jre7\bin\javaws.exe" -J-Dhttp.proxyHost=10.0.1.50 -J-Dhttp.proxyPort=81 %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %PXAUTH% %ACTION_Deliver%"
  • No labels