Skip to main content
Version: 24.5

Install FlexxAgent configuring proxy

FlexxAgent needs to have internet connectivity. In many organizations, users connect to the internet using a proxy server.

Example

During the installation of FlexxAgent, you can include the proxy server configuration using the following command line options:

FlexxAgent-Installer.exe -proxyAbsoluteUri <http(s)://ip.ad.dre.ss:port> -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig -repairAgent $True

proxycom

Explanation of the options

  • proxyAbsoluteUri: the address of the proxy server, expressed as a complete “URL”; for example https://192.168.1.1:3128.
  • proxyUser: the user identifier for authentication on the proxy server; for example Administrator. This parameter is optional if the proxy server does not require authentication.
  • proxyPass: the password for the aforementioned identifier. This parameter is optional when the proxy does not require authentication.

The value can be plain text (not recommended) or base64 encoded, preceded and followed by the string “&&&"; for example &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&&. In any case, FlexxAgent encrypts this value at startup.

For base64 encoding you can use any generator, like https://www.base64encode.org/.

proxyPersistConfig

This parameter must be specified to persist the proxy configuration introduced in the other parameters. If not specified, the proxy configuration will only be used during the installation process and will not affect subsequent executions of FlexxAgent.

For Windows operating systems, the proxy configuration data will persist in the registry, under the following keys:

Proxy_URL Key

  • Key path: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
  • Key name: Proxy_URL
  • Key type: REG_SZ
  • Allowed values: the URL and port; for example http://192.168.1.1:3128 or https://192.168.1.1:3128

Proxy_User Key

  • Key path: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
  • Key name: Proxy_User
  • Key type: REG_SZ
  • Allowed values: the username to authenticate to the proxy; for example Administrator. It can be omitted for unauthenticated proxies.

Proxy_Pwd Key

  • Key path: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
  • Key name: Proxy_Pwd
  • Key type: REG_SZ
  • Accepted values: the password to authenticate on the proxy. It can be omitted for unauthenticated proxies. The value of the Proxy_Pwd key can be set in plain text (not recommended) or base64 encoded and enclosed by «&&&»; for example &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& for the value “Proxy_Pwd”.

RepairAgent

If $true, forces the repair of FlexxAgent; it is important to know that the command will fail if this parameter is specified and FlexxAgent has not been previously installed.