Proxy configuration on Mac

Here are the steps to enable the Mac agent to use a proxy for communication with our cloud platform:

Proxy configuration on Mac 1.7 or later agents

1) if /Library/Application Support/QualysCloudAgent/Config/proxy file doesn't exist create it

2) add 1 of the following lines to the file (1 line only):

https_proxy=https://[<username>:<password>@]<host>[:<port>]

qualys_https_proxy=https://[<username>:<password>@]<host>[:<port>]

where <username> and <password> are specified if the https proxy uses authentication. If special characters are embedded in the username or password (e.g. @, :, $) they need to be url-encoded. where <host> is the proxy server's IPv4 address or FQDN. where <port> is the proxy's port number.

If the proxy is specified with the https_proxy environment variable, it will be used for all commands performed by the Cloud Agent. If the proxy is specified with the qualys_https_proxy environment variable, it will only be used by the Cloud Agent to communicate with our cloud platform.

3) change the permissions using these commands:

chown root /Library/Application Support/

QualysCloudAgent/Config/proxy

chmod 644 /Library/Application Support/

QualysCloudAgent/Config/proxy

Alternatively, you can set automatic proxy by going to Mac System Preferences > Network > Advanced > Proxies tab. Select Automatic Proxy Configuration and provide the pac file.

Note: Qualys proxy configured in the .../QualysCloudAgent/Config/proxy file will take preference over any proxies set in System Preferences (including Automatic Proxy, Web Proxy (HTTP), or Secure Web Proxy (HTTPS)).

Proxy configuration on Mac 1.5 and 1.6 agents

1) if /Applications/QualysCloudAgent.app/Contents/Config/proxy file doesn't exist create it

2) add 1 of the following lines to the file (1 line only):

https_proxy=https://[<username>:<password>@]<host>[:<port>]

qualys_https_proxy=https://[<username>:<password>@]<host>[:<port>]

where <username> and <password> are specified if the https proxy uses authentication. If special characters are embedded in the username or password (e.g. @, :, $) they need to be url-encoded. where <host> is the proxy server's IPv4 address or FQDN. where <port> is the proxy's port number.

If the proxy is specified with the https_proxy environment variable, it will be used for all commands performed by the Cloud Agent. If the proxy is specified with the qualys_https_proxy environment variable, it will only be used by the Cloud Agent to communicate with our cloud platform.

3) change the permissions using these commands:

chown root /Applications/QualysCloudAgent.app/

Contents/Config/proxy

chmod 644 /Applications/QualysCloudAgent.app/

Contents/Config/proxy