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 Business Enterprise
getVDNACvssv3() Unlimited queries / day Unlimited queries / day

vDNACvssv3 API Overview

vDNACvssv3 API Overview by Name

API Purpose
get_cvssv3score_withvector Retreive 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 Name SOAP Request / Response
get_cvssv3score_withvector get_cvssv3score_withvectorIn
get_cvssv3score_withvectorOut

get_cvssv3score_withvector

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

get_cvssv3score_withvectorIn

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

vDNACvssv3 API Overview by Field

Element Description Data Type Allowable Values Required
login This is your Security-Database User Login xsd:string See Description Yes
apikey This is your API Key that you can found in your Security-Database User Panel (menu vDNA API) xsd:string 32 single-byte characters Yes
modulekey This is your Module id that you can found in your Security-Database User Panel (menu vDNA API -> modules) xsd:string 32 single-byte characters Yes
vector A 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:string See description Yes

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

Element Description Data Type Possible Values
Vector This is the full CVSSv3 vector xsd:string See Description
OverallScore This the CVSS v3 Overall Score 0-10 xsd:float 0-10
BaseScore This the CVSS v3 Base Score 0-10 xsd:float 0-10
TemporalScore This the CVSS v3 Temporal Score 0-10 xsd:float 0-10
EnvironmentalScore This the CVSS v3 Environmental Score 0-10 xsd:float 0-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>
            <Overallscore>10</Overallscore>
            <BaseScore>10</BaseScore>
            <TemporalScore>10</TemporalScore>
            <EnvironmentalScore>10</EnvironmentalScore>
         </return>
      </ns1:get_cvssscore_withvectorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>