Restore Findings Severity
Restore the severity level of the given findings.
Permissions required: User must have WAS module enabled. User account must have these permissions:
- Access Permission: API Access
- Ignore Vulnerabilities permission
User must have access to web application which belongs to given WebAppVuln id. The output includes findings for web applications in the user's scope.
Input ParametersInput Parameters
The element “id” (integer) is required, where “id” identifies a finding (WebAppVuln, WebAppIg, or WebAppSensitiveContent).
Sample - Restore severity levelSample - Restore severity level
API request:
curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/3.0/restoreSeverity/was/finding"
Request POST data:
<ServiceRequest>
<data>
<Finding>
<id>6034</id>
</Finding>
</data>
</ServiceRequest>
XML response:
<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/finding.xsd">
<responseCode>SUCCESS</responseCode>
<count>1</count>
<data>
<Finding>
<id>6034</id>
<uniqueId>8a2c4d51-6d28-2b92-e053-2943720a74ab</uniqueId>
</Finding>
</data>
</ServiceResponse>
Sample - Restore for multiple findingsSample - Restore for multiple findings
API request:
curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/3.0/restoreSeverity/was/finding"
Request POST data:
<ServiceRequest>
<filters>
<Criteria field="id" operator="IN">645,183</Criteria>
</filters>
</ServiceRequest>
XML response:
<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/finding.xsd">
<responseCode>SUCCESS</responseCode>
<count>2</count>
<data>
<Finding>
<id>645</id>
<uniqueId>6a2c4d51-6d28-2b92-e053-2943720a74ab</uniqueId>
</Finding>
<Finding>
<id>183</id>
<uniqueId>5a2c4d31-5d28-2b92-e055-4943720a51ab</uniqueId>
</Finding>
</data>
</ServiceResponse>
Sample - Restore severity of a finding using uniqueIdSample - Restore severity of a finding using uniqueId
As every uniqueId is unique, you could restore the severity of specific finding.
API request:
curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST" --data-binary @- "<qualys_base_url>/qps/rest/3.0/editSeverity/was/finding/" < file.xml
Note: “file.xml” contains the request POST data.
Request POST data:
<ServiceRequest>
<data>
<Finding>
<uniqueId>8a2c4d51-6d28-2b92-e053-2943720a74ab</uniqueId>
<severityComment>Restoring default severity</severityComment>
<severity>3</severity>
</Finding>
</data>
</ServiceRequest>
XML response:
<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/finding.xsd">
<responseCode>SUCCESS</responseCode>
<count>1</count>
<data>
<Finding>
<id>132990</id>
<uniqueId>8a2c4d51-6d28-2b92-e053-2943720a74ab</uniqueId>
</Finding>
</data>
</ServiceResponse>
XSD
<platform API server>/qps/xsd/3.0/was/finding.xsd