Delete Authentication Record

[POST] /qps/rest/3.0/delete/was/webappauthrecord/<id>

[POST] /qps/rest/3.0/delete/was/webappauthrecord/<filters>

Delete an authentication record which is in the user’s scope.

Permissions required - User must have WAS module enabled. User account must have these permissions: Access Permission “API Access”. The authentication record to be deleted must be within the user’s scope.

Input ParametersInput Parameters

These elements are optional and act as filters. When multiple elements are specified, parameters are combined using a logical AND. Click here for descriptions of <WebApp> elements

Click here for available operators

Parameter

Mandatory

/Optional

Data Type

Description

id

Optional

integer

(integer)  Authentication record ID.

name

Optional

text

Authentication record name.

tags

Optional

integer

Tag associated with the authentication record.

tags.name

Optional

text

Tag name assigned to the authentication record.

tags.id

Optional

integer

Tag ID assigned to the authentication record.

createdDate

Optional

date

The date when the authentication record was created in WAS, in UTC date/time format.

updatedDate

Optional

date

The date when the authentication record was updated in WAS, in UTC date/time format.

lastScan.date

Optional

date

The date when the web application (associated with the authentication record) was last scanned, in UTC date/time format.

lastScan.authStatus

Optional

keyword

Authentication status reported by the last web application scan: NONE, NOT_USED, SUCCESSFUL, FAILED or PARTIAL

isUsed

Optional

boolean

Indicates whether used by a web application or scan.

contents

Optional

keyword

(Keyword: FORM_STANDARD, FORM_CUSTOM, FORM_SELENIUM, SERVER_BASIC, SERVER_DIGEST, SERVER_NTLM, CERTIFICATE, OAUTH2_AUTH_CODE, OAUTH2_IMPLICIT, OAUTH2_PASSWORD, and OAUTH2_CLIENT_CREDS)

Sample - Delete a single authentication recordSample - Delete a single authentication record

Let us delete authentication record ID 78149.

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST"
"<qualys_base_url>/qps/rest/3.0/delete/was/webappauthrecord/78149"      
    

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/webappauthrecord.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <WebAppAuthRecord>
            <id>78149</id>
        </WebAppAuthRecord>
    </data>
</ServiceResponse>         
    

Sample - Delete multiple authentication recordsSample - Delete multiple authentication records

Let us delete authentication records that have a name containing the term “server”.

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST" --data-binary @-
"<qualys_base_url>/qps/rest/3.0/delete/was/webappauthrecord/" < file.xml
Note: “file.xml” contains the request POST data.     
    

Request POST data

<ServiceRequest>
    <filters>
        <Criteria field="name" operator="CONTAINS">server</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/webappauthrecord.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>2</count>
    <data>
        <WebAppAuthRecord>
            <id>12874</id>
            <WebAppAuthRecord>
                <WebAppAuthRecord>
                    <id>13093</id>
                    <WebAppAuthRecord>
                    </data>
                </ServiceResponse>    
   

XSD

<platform API server>/qps/xsd/3.0/was/webappauthrecord.xsd