Integrations

You can configure the following integrations in the Qualys ETM VR Integration app:

1. ETM: Findings Report Request
2. ETM: Download Report Files

Perform the following steps:

1. Navigate to the All tab.
2. Go to Qualys ETM VR Integration.
3. Navigate to Sync and select Integrations.
   

ETM Findings Report Request

This integration is to generate the report request to sync the Qualys ETM findings using Qualys ETM APIs.

Perform the following steps to request the ETM Findings Report:

1. Go to Qualys ETM VR Integration.
2. Navigate to Sync and select Integrations.
3. In the Integrations table, open the ETM Findings Report Request.
   
4. Provide the following configuration details and save the job:

   Field	Description
   Run	Choose the frequency of the scheduled Run. ‎For example, if you select Once, then Integration runs only once at the configured date and time. ‎We recommend scheduling the job to run once a day.
   Filter	Provide a query in the Filter to filter the ETM data. This field is used to filter the Qualys ETM data that is going to be synced. ‎Use search tokens to filter the assets and/or findings as per the requirement. ‎For example,   {     "assetQql": "asset.criticalityScore>=4",     "findingsQql": "finding.vendorProductName:`VMDR` and finding.qds : [90 ... 100]" } Provide the filters in the form of QQL that are used on the Qualys Platform UI for the Qualys ETM application. Use QQL without backtick ( ` ) in the Filter field.
   Import Since	Select the date from the calendar in the Import Data Since field.

ETM Download Report

This integration runs periodically to download requested ETM findings. You can configure a schedule for the integration run to process the downloaded report’s JSON files, which are queued in the ETM Reports table.

1. Go to Qualys ETM VR Integration.
2. Navigate to Sync and select Integrations.
3. In the Integrations table, open ETM Download Report.
   

4. Provide the following configuration details and save the job:

   Field	Description
   Run	Choose the frequency of the scheduled Run. ‎For example, if you select Once, then Integration runs only once at the configured date and time. We recommend scheduling the job to run once a day.
   Import Since	Select the date from the calendar in the Import Data Since field.
   Repeat Interval	Set a frequency in minutes to check the report status of the downloaded queued files. We recommend setting the Repeat Interval to 10 minutes.