WillB

QualysGuard WAS 2.3.1 API Enhancements US Platform: August 8, 2012 (Updated)

Blog Post created by WillB on Jul 24, 2012

Note: The deployment of the following release has been delayed by 24 hours to Wed, August 8, 2012, due to an unanticipated, last-minute infrastructure upgrade which had to be undertaken prior to deployment of this release. We regret the inconvenience.

 

A maintenance release of QualysGuard® Web Application Scanning 2.3.1 with one API enhancement will be available in production in the US on August 8, 2012. This release is completely transparent to users and will require no scheduled downtime. The release will occur between 12 PM PST (20:00 GMT) and 6 PM PST (02:00 AM GMT next day).

 

 

QualysGuard WAS 2.3.1 includes one enhancement to the API services which were first made available in the 2.2 release. This notification provides an early preview of these enhancements.

 

Scan API

The WAS Scan API provides a call to download scan results.  The scan summary date format included unnecessary zeros.  The dates have been updated to remove the extra zeros in WAS 2.3.1. 

 

An example of the old date format is:

 <VALUE><![CDATA[2012-05-29T18:00:00.000Z]]></VALUE>

 

An example of the new date format is:

<VALUE><![CDATA[2012-05-29T18:00:00Z]]></VALUE>

 

Web App API

 

With the new feature added to lock a scanner, the value of this attribute is now available in the Web App API.   Sample response is listed below with the new 'scannerLocked" attribute at the end:

 

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:noNamespaceSchemaLocation="http://localhost:8080/qps-api-provider/xsd/3.0/was/webapp.xsd">
  <responseCode>SUCCESS</responseCode>
  <count>1</count>
  <data>
    <WebApp>
      <id>323126</id>
      <name><![CDATA[Merchant Site - Updated by API]]></name>
      <url><![CDATA[http://1.1.25.116:80/merchant/2.2/themerchant]]></url>
      <owner>
        <id>123056</id>
        <username>quays_at3</username>
        <firstName><![CDATA[John]]></firstName>
        <lastName><![CDATA[Doe]]></lastName>
      </owner>
      <scope>DOMAINS</scope>
      <domains>
        <count>2</count>
        <list>
          <Domain><![CDATA[10.10.25.117]]></Domain>
          <Domain><![CDATA[10.10.25.118]]></Domain>
        </list>
      </domains>
      <attributes>
        <count>3</count>
        <list>
          <Attribute>
            <category>Business Location</category>
            <value><![CDATA[Location]]></value>
          </Attribute>
          <Attribute>
            <category>Business Function</category>
            <value><![CDATA[Function]]></value>
          </Attribute>
          <Attribute>
            <category>Business Description</category>
            <value><![CDATA[Description]]></value>
          </Attribute>
        </list>
      </attributes>
      <defaultProfile>
        <id>1072</id>
        <name><![CDATA[Initial WAS Optionss]]></name>
      </defaultProfile>
      <defaultScanner>
        <type>EXTERNAL</type>
      </defaultScanner>
      <scannerLocked>false</scannerLocked>

 

 

Full details regarding these updates will be available in the WAS API User Guide on the day of the release.

 

To receive more information on QualysGuard WAS 2.3.1, please visit the Qualys Community at https://community.qualys.com or contact your Technical Account Manager or Qualys' Technical Support Department at support@qualys.com.

Outcomes