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
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
orhttps://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.