Skip to main content

Configure and modify proxy settings for agents

DigiCert​​®​​ Trust Lifecycle Manager supports modifying existing proxy settings, and configuring new proxy settings without uninstalling or reinstalling the agent. You must be on Agent release 3.1.6 or later to do this.

The proxy settings for an agent are stored in the config.toml file, located in the config directory where the agent is installed. To add new proxy settings, update existing proxy settings, or remove proxy settings, edit the config.toml file to include the templates provided below.

Anmerkung

For agents running an older software version, the proxy template is added during the upgrade process. If auto-upgrade of the software is enabled, the config.toml file is updated with the new proxy template without manual intervention.

Add a new proxy

You can add a new proxy in the following situations:

  • The agent crashes and the existing proxy settings are lost.

  • The agent was activated without a proxy server configured.

To add a new proxy:

  1. Stop the agent service on the local host system where it is installed.

    See Agent service name on the local host for more information.

  2. Open the config.toml file located in the config directory where the agent is installed, and add the new proxy value in the ProxyUrl field.

    [Proxy]
  # sample value to be proxy url with http protocol. eg - http://ip:port or http://username:password@ip:port, this value will be cleared on next stop or restart of agent
  ProxyUrl = "http://10.1.x.x:48xx9"
  # Reset DB proxy flag
  ResetProxy = false

  3. Save the configuration, and start the agent service on the local host system.

    After the agent starts and verifies connectivity using the proxy, the proxy value entered in the ProxyUrl field is cleared automatically.

Update an existing proxy

To update an existing proxy:

  1. Stop the agent service on the local host system where it is installed.

  2. Open the the config.toml file located in the config directory where the agent is installed, and add the new proxy value in the ProxyUrl field:

    [Proxy]

  # sample value to be proxy url with http protocol. eg - http://ip:port or http://username:password@ip:port, this value will be cleared on next stop or restart of agent
  ProxyUrl = "http://10.1.x.x:48xx9"

  # To clear proxy and move to no proxy mode, set this flag as true and keep proxyUrl value empty
  RemoveProxy = false

  3. Save the configuration, and start the agent service on the local host system.

    After the agent starts and verifies connectivity using the proxy, the proxy value entered in the ProxyUrl field is cleared automatically.

Remove an existing proxy

To remove an existing proxy:

  1. Stop the agent service on the local host system where it is installed.

  2. Open the config.toml file located in the config directory where the agent is installed, and set the RemoveProxy value to true, and the ProxyURL field to "":

    [Proxy]

  # sample value to be proxy url with http protocol. eg - http://ip:port or http://username:password@ip:port, this value will be cleared on next stop or restart of agent
  ProxyUrl = ""

  # To clear proxy and move to no proxy mode, set this flag as true and keep proxyUrl value empty
  RemoveProxy = true

  3. Save the configuration, and start the agent service on the local host system.

    After the agent starts, the proxy is removed.

In diesem Abschnitt: