Proxy Configuration

By default, the Cloud Agent for Solaris operates in non-proxy mode. However, it can be configured to use an HTTPS proxy for internet access.

You can configure a Cloud Agent to HTTP proxy in of the following ways:

  • /etc/environment - applies to Cloud Agent for Solaris (.pkg)
  • /etc/default/qualys-cloud-agent - applies to Cloud Agent for Solaris (.pkg)

 If Cloud Agent uses a system-wide proxy, /etc/environment is a preferred choice.

Proxy Configuration Steps

Perform the following steps to enable a proxy for Solaris Cloud Agent:

  1. If the /etc/default/qualys-cloud-agent file does not exist, create the file.
  2. Add 1 of the following lines to the file (1 line only):

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

    Option 2: 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.
     

    You can use the Proxy Configuration Encryption Utility to encrypt the user name and password that you provide to the proxy environment variable.

  3. Change the permissions using the following commands:

    chown <cloud_agent_user> /etc/environment/qualys-cloud-agent
    chmod 600 /etc/environment/qualys-cloud-agent


    Where <cloud_agent_user> is a user configured through the Configuration Tool.
  4. Restart qualys-cloud-agent service using the following commands (disable and then enable):

    To disable Cloud Agent: svcadm disable qualys-cloud-agent
    To enable Cloud Agent: svcadm enable qualys-cloud-agent