Scanner Appliance: Management Communications

Document created by justin.lute on Mar 16, 2013Last modified by Qualys Documentation on Aug 26, 2016
Version 4Show Document
  • View in full screen mode

As an extension of the Qualys Cloud Platform, a Qualys Scanner Appliance must be able to communicate with the Qualys Cloud Platform which is managing it in order to operate.  This management contact occurs via an outbound call from the scanner appliance to the Qualys Cloud Platform, using an encrypted HTTPS connection on port 443.  Typically five Platform services URLs must be contacted by the scanner. This communications requirement applies to Qualys Scanner Appliances (physical) and Qualys Virtual Scanner Appliances.


By default, this management contact occurs every three minutes (though this is configurable), as the scanner appliance calls home to provide health updates/heartbeats to the Platform; to request any available software or signature updates from the Platform; to learn if any work (i.e., scan jobs) has been requested of it; and to upload scan result data, if applicable.


Successful communication between an appliance and the Platform requires that your network services and controls are configured properly to allow for this communication.  This includes:


  • network interface physical (or virtual) connection
  • appropriate IP address configuration for the scanner (static or DHCP)
  • DNS name resolution of the QualysGuard platform resources
  • routing
  • ACLs and firewall rules
  • proxy settings, possibly including authentication/authorization


All of these must be properly configured throughout the entire path to ensure the success of this management communication.



Scanner Management Service URLs

The specific services on the Qualys Cloud Platform which must be reachable by your appliance(s) differ depending upon which Platform your Qualys subscription has been provisioned on.


The specific Platform URLs and IP target range which the scanner must be able to reach may be found within the UI for your Qualys subscription, by selecting Help > About.




On the General Information tab, you'll see a section called Qualys Scanner Appliances. This tells you the service URLs and IP range(s) that your appliances must be able to reach.




Good to Know - A scanner appliance may be configured with a single NIC, in which case this single NIC will be responsible for both management communications with the Platform and for scanning target systems.  Alternatively, a scanner may be configured in a dual-NIC "split networking" configuration where the eth0 or "LAN" interface will be responsible for scanning target systems, while the eth1 or "WAN" interface will be responsible for the management connection to the Platform.


For more details on this split networking configuration and for other scanner troubleshooting assistance, please see Scanner Appliance FAQs.



Learn more




2 people found this helpful