Quickstart Deployment Guide for Qualys Virtual Scanner Appliance in Alibaba Cloud

Document created by Alex Mandernack Employee on Apr 25, 2019Last modified by Qualys Documentation on Oct 1, 2019
Version 10Show Document
  • View in full screen mode


This document describes briefly how to quickly deploy the Qualys Virtual Scanner Appliance in Alibaba Cloud from the Alibaba Marketplace. This scanner, once deployed, will function as a standard Virtual Scanner and can scan based on IP address or CIDR block.



Customers will have an active Qualys subscription.

Scanner personalization code (14 digits) obtained from your Qualys account. (Documentation)
Qualys Virtual Scanner Appliance VM must be able to reach the Qualys Cloud Platform over HTTPS port 443


Some things to consider... 

The following features are not supported and are disabled in all cloud (private and public) platforms:

  • WAN/Split network SETTINGS - “WAN Interface” option for split network settings is not available from Scanner UI/console. Only LAN/single network settings from scanner console/UI that allows both scanning and connecting to Qualys servers, are supported
  • NATIVE VLAN - “VLAN on LAN” option for configuring Native VLAN is not available from scanner UI/console
  • STATIC VLAN (IPV4 AND IPV6) - "VLANs" option for configuring static VLANs is not available from Qualys UI
  • STATIC ROUTES (IPV4 AND IPV6) - Option to configure “Static Routes” is not available from Qualys UI
  • IPV6 ON LAN - Option to configure “IPv6 on LAN” is not available from Qualys UI


What do I need to get started?

The Virtual Scanner option must be turned on for your account. Contact Qualys Support or your Technical Account Manager if you would like us to turn on this option for you.

You must be a Manager or a sub-user with the “Manage virtual scanner appliances” permission. This permission may be granted to Unit Managers. Your subscription may be configured to allow this permission to be granted to Scanners.


Configuration in Qualys

You'll add a new virtual scanner appliance and get your personalization code.

Go to Scans > Appliances and select New > Virtual Scanner Appliance. Choose "I have my image" and click Continue.

Give your scanner a name. If you’re a sub-user then you’ll need to pick an asset group that has been assigned to your business unit by a Manager user. Not seeing any asset groups? Please ask a Manager to assign an asset group (other than the All group) to your business unit.

Follow the on screen instructions to configure your virtual scanner and get your personalization code. You'll need this to launch your instance.

pers code

Configuration in Alibaba Cloud

Qualys virtual scanners can be launched from the Alibaba Cloud Marketplace or from a custom image that has been shared with your account. 

1) Deploy the Qualys Virtual Scanner appliance. 

To launch an instance from the Alibaba Cloud Marketplace 

Go to Qualys Virtual Scanner Appliance page in the Alibaba Marketplace and login to your Alibaba Cloud account. 


Launch the virtual scanner by selecting “Choose Your Plan”. 


alibaba marketplace


To launch a custom image from the Alibaba Console 

To launch from a custom image that has been shared with your Alibaba account, login to your Alibaba Cloud account and go to Elastic Compute Service -> Instances & Images -> Images – Share Image - enter ‘qVSA’ in the search box and you should see all Qualys virtual scanner images shared with your account: 



 Select an image and click on ‘Create Instance’. 


2) Use the wizard to enter the instance settings.

  • Name your instance - Choose a distinctive name and label of your scanner
  • Choose instance shape - Select shape that doesn’t exceed 16GB of RAM and 16 CPU Cores
  • Add SSH key - The Qualys Scanner appliance is a locked appliance, login into it is disabled. Leave the SSH key section empty

Under System Configurations, select  the drop down "Advanced (based on instance RAM roles or cloud-init)"

  • User data - use this field to set your Personalization code and Proxy (if required), in the following format:





Proxy formatting:
If you have a domain user, the format is: domain\username:password@proxyhost:port
If authentication is not used, the format is: proxyhost:port
Where “proxyhost” is the IPv4 address or the FQDN of the proxy server.


alibaba user adata


  • User data settings cannot be updated after deployment. If you need to alter the PERSCODE and/or PROXY_URL, you will have to redeploy the scanner
  • You can keep the default storage size or you can increase it based on your requirements.

Once launched, the Virtual Appliance connects to the Qualys Cloud Platform

This step registers the Virtual Scanner Appliance with your Qualys account. Also your appliance will download all the latest software updates right away, so it’s ready for scanning.

Configuring Security Groups for your Virtual Scanner Appliance

  • If you are using proxy server then ensure you have outbound rule allowing access on port 443 and the port used to communicate with proxy server.
  • If scanner appliance has direct internet connectivity, then ensure that there is an outbound rule that allows access on port 443 to Qualys Security Operations Center (SOC) IP address. You can get the SOC IP address range by logging in to Qualys Portal and navigating to Help > About option.
  • Scanner should be able to reach out to all the target instances for running the scan. It is recommended to configure outbound rule that allows access to all ports and subnets of the instances that the scanner is going to scan.


How do I know my scanner is ready to use?
Check your virtual scanner status in Qualys. Go to Scans > Appliances, and find your scanner in the list.
Tip - It can take several minutes for the Qualys user interface to get updated after you add a new appliance. Please refresh your browser periodically to ensure that you are seeing the most up to date details.

scanner status'




Looking for more information on Qualys in Alibaba Cloud? 

See the Help Center for Alibaba Cloud