Proxy configuration on MacOS

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

Proxy configuration on MacOS 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)).