Qualys Cloud Platform AM&T / CSAM API notification 1

Jeff Leggett

Last updated on: January 27, 2023

A new release of Qualys Cloud Platform Asset Management & Tagging 3.14 and CSAM 2.14.1 includes updated APIs which is targeted for release in FEBRUARY 2023. The specific day will differ depending on the platform. See platform release dates on the Qualys Status page. This API notification provides an early preview into the coming API, allowing you to identify use cases that can leverage this updated API.

What’s New
Asset Management & Tagging
https://www.qualys.com/docs/qualys-asset-management-tagging-api-v2-user-guide.pdf
AM API: Dynamic Tag Rule using Global Asset View Tag Rule Engine
/qps/rest/2.0/create/am/tag
With this release, you can now create and update dynamic tag rule using GLOBAL_ASSET_VIEW tag rule engine. This also includes the support to all CRUD operations of tag API, such as, create, update, delete, search and count.

AM API: Enhanced NETWORK_RANGE Dynamic Tag Rule Engine
/qps/rest/2.0/create/am/tag
With this release, we have enhanced NETWORK_RANGE Dynamic Tag Rule engine. The saving tag rules is optimized for the Network Range engine. All individual IP addresses added by the user now gets converted as an IP address range, if the IPs are in sequence.

AM API: New Tracking Method for Assets
/qps/rest/2.0/search/am/asset
With this release, you can filter the tracking method for the assets using the following APIs.

AM API: New Tracking Method for HostAssets
/qps/rest/2.0/search/am/hostasset
With this release, you can filter the WEBHOOK, SERVICE_NOW, and ACTIVE_DIRECTORY tracking method for hostassets.

AM API: Removal of Restrictions on External Id for AWS Connectors
/qps/rest/2.0/create/am/awsassetdataconnector
/qps/rest/2.0/update/am/awsassetdataconnector
/qps/rest/2.0/update/am/awsassetdataconnector/id
/qps/rest/3.0/create/am/awsassetdataconnector
/qps/rest/3.0/update/am/awsassetdataconnector
/qps/rest/3.0/update/am/awsassetdataconnector/id

We will now support creation and updation of AWS connectors using V2 or V3 APIs for AssetView with all external ID formats. We have removed the validation for External Id format check and the AWS connector can be created using alphanumeric external Id formats.

AM API: Custom Asset Attributes
/qps/rest/2.0/update/am/asset
With this release, a new field “customAttributes” is added to the response of the following public APIs.

CA API: Fetch Installer Binary Information for Cloud Agent Linux on zSystems
/qps/rest/1.0/process/ca/binaryinfo/
With this release, you can fetch the agent installer binary version for Cloud Agent Linux on zSystems using APIs. A two-level check is performed—at the platform level and at the subscription level while retrieving the agent binary information. You can fetch the agent binary version only when the agent is available for the platform.

CA API: Download Installer Binary for Cloud Agent Linux on zSystems
/qps/rest/1.0/download/ca/downloadbinary/
With this release, you can download the installer binary for Cloud Agent Linux on zSystems using APIs. A two-level check is performed—at the platform level and at the subscription level while downloading the agent installer binary. Only when the agent is available for the platform and your subscription, you can download the agent binary.

CA API: Launch On Demand Scan
/qps/rest/1.0/ods/ca/agentasset/
With this release, we have added API support for launching the on-demand scan on assets where Cloud Agent is installed. The on-demand scan feature helps you with the flexibility to initiate a scan without waiting for the next scheduled scan.

CSAM APIs https://www.qualys.com/docs/qualys-gav-csam-api-v2-user-guide.pdf
New Field Added to Response of V2 APIs
/rest/2.0/search/am/asset
With this release, a new field “customAttributes” is added to the response of the following public V2 APIs. In this field, you can see the custom attributes that are entered for an asset.

New Field Added to Response of V1 APIs
With this release, a new field “customAttributes” is added to the response of the public V1 APIs. In this field, you can see the custom attributes that are entered for an asset.

Check Sync Status of an Active EASM Profile
/easm/v1/profile/status
With this release, we have introduced a new EASM public API. By using this API, you can check the sync status of the active EASM profile

The release notes are here: https://www.qualys.com/docs/release-notes/qualys-cloud-platform-3.14-api-release-notes.pdf AND https://www.qualys.com/docs/release-notes/qualys-gav-csam-2.14.1-api-release-notes.pdf

Share your Comments

Comments

Your email address will not be published. Required fields are marked *