Skip navigation
1 2 Previous Next

API Notifications

20 Posts authored by: WillB

A maintenance release of QualysGuard® Web Application Scanning 2.3.1 with one API enhancement will be available in production in the EU on August 14, 2012. This release is completely transparent to users and will require no scheduled downtime. The release will occur between 20:00 GMT and 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.

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.

A new release of QualysGuard® Web Application Scanning 2.3 with two API enhancements will be available in production in the US on April 4, 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 includes two enhancements 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 suite of API functions for managing web application scans across the enterprise. The API enables subscribers to launch new scans, list, view and delete scans. The following enhancements have been made in WAS 2.3:

  • Launch a new scan: with WAS 2.3, the option profile element is not required to launch a scan when the target web application has a default option profile defined.

 

Schedule API

The WAS Schedule API provides a suite of API functions for managing web application scan schedules across the enterprise. The API enables subscribers to create, update and delete scan schedules. The following enhancements have been made in WAS 2.3:

  • Download schedules in iCal format

 

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

 

Target for the release of WAS 2.3 API enhancements on the EU platform is May, 2012.

 

To receive more information on QualysGuard WAS 2.3, 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.

A new release of QualysGuard®, WAS Version 2.2 with a new set of APIs, will be available in production in the EU datacenter on March 30th, 2012. This release is completely transparent to users and will require no scheduled downtime.


QualysGuard WAS 2.2  includes a number of new API services. This notification provides an early preview of these API services that can be used to integrate WAS 2.2 with external systems or to script workflows.


Web Application API

The WAS Web Application API provides a suite of API functions for managing web application configurations across the enterprise.   The API enables subscribers to create and manage web application configurations used to scan the applications for vulnerabilities.  The API includes the ability to update web application scan default settings and purge scan data.  The following functions are available:

  • Create a new web application
  • Retrieve the current web application count
  • Retrieve a list of web applications
  • View details of a web application
  • Update a web application
  • Purge a web application


 

Scan API

The WAS Scan API provides a suite of API functions for managing web application scans across the enterprise.  The API enables subscribers to launch new scans, list, view and delete scans.  The following functions are available:

  • Launch a new scan
  • Retrieve the current scan count
  • Retrieve a list of scans
  • View scan details
  • Retrieve the status of a scan
  • Retrieve the results of a scan
  • Cancel a running scan
  • Delete an existing scan

 

Schedule API

The WAS Schedule API provides a suite of API functions for managing web application scan schedules across the enterprise.   The API enables subscribers to create, update and delete scan schedules.  The following functions are available:

  • Create a schedule
  • Update a schedule
  • Retrieve the current schedule count
  • Retrieve a list of schedules
  • View schedule details
  • Activate an existing schedule
  • Deactivate an existing schedule
  • Delete one or more existing schedules

 

Report API

The WAS Report API provides a suite of API functions for managing web application reports across the enterprise. The API enables subscribers to manage reports that have been previously saved.  The following functions are available:

  • Retrieve the current report count
  • Retrieve a list of reports
  • View details of a report
  • Retrieve the status of a report
  • Download a report
  • Send an encrypted PDF report
  • Update a report
  • Delete one or more existing reports

 

 

Full details of the API can be found in the WAS API User Guide Version 2.2.

 

To receive more information on QualysGuard WAS 2.2, 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.

A new release of QualysGuard®, WAS Version 2.2 with a new set of APIs, will be available in production in the US on February 22nd 2012. This release is completely transparent to users and will require no scheduled downtime.


QualysGuard WAS 2.2  includes a number of new API services. This notification provides an early preview of these API services that can be used to integrate WAS 2.2 with external systems or to script workflows.


Web Application API

The WAS Web Application API provides a suite of API functions for managing web application configurations across the enterprise.   The API enables subscribers to create and manage web application configurations used to scan the applications for vulnerabilities.  The API includes the ability to update web application scan default settings and purge scan data.  The following functions are available:

  • Create a new web application
  • Retrieve the current web application count
  • Retrieve a list of web applications
  • View details of a web application
  • Update a web application
  • Purge a web application


 

Scan API

The WAS Scan API provides a suite of API functions for managing web application scans across the enterprise.  The API enables subscribers to launch new scans, list, view and delete scans.  The following functions are available:

  • Launch a new scan
  • Retrieve the current scan count
  • Retrieve a list of scans
  • View scan details
  • Retrieve the status of a scan
  • Retrieve the results of a scan
  • Cancel a running scan
  • Delete an existing scan

 

Schedule API

The WAS Schedule API provides a suite of API functions for managing web application scan schedules across the enterprise.   The API enables subscribers to create, update and delete scan schedules.  The following functions are available:

  • Create a schedule
  • Update a schedule
  • Retrieve the current schedule count
  • Retrieve a list of schedules
  • View schedule details
  • Activate an existing schedule
  • Deactivate an existing schedule
  • Delete one or more existing schedules

 

Report API

The WAS Report API provides a suite of API functions for managing web application reports across the enterprise. The API enables subscribers to manage reports that have been previously saved.  The following functions are available:

  • Retrieve the current report count
  • Retrieve a list of reports
  • View details of a report
  • Retrieve the status of a report
  • Download a report
  • Send an encrypted PDF report
  • Update a report
  • Delete one or more existing reports

 

 

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

 

To receive more information on QualysGuard WAS 2.2, 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.

Filter Blog

By date: By tag: