Security-Database API Reference : vDNACvssv3

The vDNACvssv3 API consists of individual requests and responses, as shown below.

Endpoint WSDL/XSD

API Production (Live) Endpoint
https://www.security-database.com/get_vdna_soapserver_cvssv3.php?wsdl

SOAP Service Endpoints Limitations

Production Web Services API Services Endpoints Queries Limitations
 Free and BusinessEnterprise
getVDNACvssv3()Unlimited queries / dayUnlimited queries / day

vDNACvssv3 API Overview

vDNACvssv3 API Overview by Name

APIPurpose
get_cvssv3score_withvectorRetreive a full CVSS v3 vector score with vector input

vDNACvssv3 API Overview by Name and Function

API Overview by Name and Function and Service Endpoint

SOAP NameSOAP Request / Response
get_cvssv3score_withvectorget_cvssv3score_withvectorIn
get_cvssv3score_withvectorOut

get_cvssv3score_withvector

get_cvssv3score_withvectorIn is your request to retreive the CVSS v2 Scores with enumeration input

get_cvssv3score_withvectorIn

All informations about Allowable value of the CVSS v3 Preview 2 requirement are available on the CVSSv3 calculator page

vDNACvssv3 API Overview by Field

ElementDescriptionData TypeAllowable ValuesRequired
loginThis is your Security-Database User Loginxsd:stringSee DescriptionYes
apikeyThis is your API Key that you can found in your Security-Database User Panel (menu vDNA API)xsd:string32 single-byte charactersYes
modulekeyThis is your Module id that you can found in your Security-Database User Panel (menu vDNA API -> modules)xsd:string32 single-byte charactersYes
vectorA fully compliant CVSS v3 Vector. Your can find example here. It must be under ()

Long Example : CVSS:3.0/AV:N/AC:H/PR:H/UI:R/S:U/C:L /I:L/A:N/E:P/RL:W/CR:L/IR:L/MAV:A /MAC:H/MPR:L/MUI:N/MS:U/MC:L/MI:L/MA:L
xsd:stringSee descriptionYes

Example of get_cvssv3score_withvectorIn

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:get="http://sd4:8081/get_vdna_soapserver_cvssv3.php">
    <soapenv:Header/>
    <soapenv:Body>
        <get:get_cvssscore_withvector$>
            <login xsi:type="xsd:string">testlogin</login>
            <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
            <modulekey xsi:type="xsd:string">9J4rdVutHFmed7a3Kp5JzUZq02W6cQDj</modulekey>
            <vector xsi:type="xsd:string">CVSS:3.0/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H/E:H/RL:U/RC:C/CR:H/IR:H/AR:H</vector>
        </get:get_cvssscore_withvector>
    </soapenv:Body>
</soapenv:Envelope>

get_cvssv3score_withvectorOut

vDNACvssv3 API Overview by Field

ElementDescriptionData TypePossible Values
VectorThis is the full CVSSv3 vectorxsd:stringSee Description
BaseScoreThis the CVSS v3 Base Score 0-10xsd:float0-10
TemporalScoreThis the CVSS v3 Temporal Score 0-10xsd:float0-10
EnvironmentalScoreThis the CVSS v3 Environmental Score 0-10xsd:float0-10

Example of get_cvssv3score_withvectorOut

Example of SOAP return.

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="http://sd4:8081/get_vdna_soapserver_cvssv3.php">
   <SOAP-ENV:Body>
      <ns1:get_cvssscore_withvectorResponse>
         <return>
            <Vector>CVSS:3.0/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H/E:H/RL:U/RC:C/CR:H/IR:H/AR:H</Vector>
            <BaseScore>10</BaseScore>
            <TemporalScore>10</TemporalScore>
            <EnvironmentalScore>10</EnvironmentalScore>
         </return>
      </ns1:get_cvssscore_withvectorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>