Skip to main content

Configuring the Proxy Server Connection Using an Unencrypted Password

Use the following procedure to configure a proxy server connection using an unencrypted password. (The password is stored in plain text in the catalina.sh/.bat script used to start up the proxy server.) This procedure must be performed on the instance hosting the Core Server and on each separate instance hosting a Scan Server.

If you prefer to configure the proxy server connection using an encrypted password, refer to the procedure described in Configuring a Proxy Connection Using an Encrypted Password.

To manually configure a proxy server connection, do the following:

  1. Navigate to the tomcat/bin folder on the instance. This folder resides within the directory where CodeInsight is installed.

  2. Open catalina.sh or catalina.bat for editing.

  3. Locate the following command and uncomment it:

    rem set CATALINA_OPTS=%CATALINA_OPTS% -Dhttps.proxyHost=<HOST> -Dhttps.proxyPort=<PORT> -Dhttps.proxyUser=<USER> -Dhttps.proxyPassword=<PASSWORD> -DproxyProtocol=<PROTOCOL> -Djdk.http.auth.tunneling.disabledSchemes=

    • Set the following values for the proxy server in the command:

    • proxyHost—IP address or Hostname of the proxy server.

    • proxyPort—Port used for the proxy connection.

    • proxyUser—User name used to authenticate the proxy. Omit this value for a transparent proxy connection.

    • proxyPassword—Password (in plain text) used to authenticate the proxy. Omit this parameter for a transparent proxy connection.

    • proxyProtocol—Either http or https.

  4. Save the catalina.sh/.bat file.

  5. Navigate to the <CODE_INSIGHT_ROOT_DIR>``config/core folder, and open the jets3t.properties file.

  6. Edit the file as follows and then save it. (This configuration ensures that the Analysis Workbench dual-pane feature, enabling users to download and compare remote files, directs its calls properly through the proxy.)

    • Set httpclient.proxy-autodetect parameter to false to ensure that the correct proxy is used (that is, the one defined for Code Insight here and in the catalina file).

    • Set the same proxy host, port, user ID, and password as described in step 3 above.

    • Provide the proxy domain name for httpclient.proxy-domain, if one is used.

  7. Restart the Tomcat server so the proxy server configuration takes effect. For information about stopping and restarting Tomcat, see Starting and Stopping Tomcat.