Configure an authentication proxy

Note: This topic is relevant for ALM Synchronizer for Agile Manager only. For details about the NextGen Synchronizer see NextGen Synchronizer, or search using the NextGen Synchronizer filter.

If you are still using ALM Synchronizer, we recommend migrating to the more robust NextGen Synchronizer embedded in Agile Manager's configuration area.

By default, the connection between the Synchronizer server to Agile Manager is not authenticated by proxy.

If you configure an authentication proxy for connecting to Agile Manager, clicking Check Connectivity in the Create Link wizard or the link's Connectivity tab uses the values specified in the proxy.properties file for authentication.

Tip: If authentication fails and errors 401 and 407 display in the restClient.log, verify that the contents of the proxy.properties file are syntactically correct and contain valid values.

Configure an authentication proxy for connecting to Agile Manager

  1. In the <ALM Synchronizer installation directory>\adapters\dat\HP-Agile-Manager folder, open the proxy.properties file.

  2. To use a proxy, change the setProxy value to true.

    If this value is false, proxy settings are ignored and no proxy is used.

  3. Set the proxy host and port values:

    1. Change the proxyHost value to the proxy IP address or server name.

    2. Change the proxyPort value to the relevant port for the proxy.

      When proxyHost has a value, proxyPort is mandatory.

  4. If the proxy requires authentication:

    1. Change the proxyUser value to the Agile Manager user name.

    2. Change the proxyPass value to the Agile Manager password.

      When proxyUser has a value, proxyPass is mandatory.

  5. Save the proxy.properties file.

  6. Restart the Synchronizer server.