Security-Database API Reference : vDNACPESingle *

* This API is Only available with Enterprise Subscription

The vDNACPESingle 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_cpesingle.php?wsdl

SOAP Service Endpoints Limitations

For each Security-Database Web Services API service Endpoints, we limitthe query request per module as follow :

Production Web Services API Services Endpoints Queries Limitations
 Free and BusinessEnterprise
vDNACPESingle()N/A3.000 queries / day

vDNACPESingle API Overview

vDNACPESingle API Overview by Name

APIPurpose
get_cpeProductCveRetreive a Summary information for a specified Product or Product/Version that is in your inventory

vDNACPESingle API Overview by Name and Function

API Overview by Name and Function and Service Endpoint

SOAP NameSOAP Request / Response
get_cpeProductCveget_cpeProductCveIn
get_cpeProductCveOut

get_cpeProductCve

get_cpeProductCveIn is your request to retreive a Summary information for a specified Product or Product/Version that is in your inventory

get_cpeProductCveIn

vDNACPESingle 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
cpeproductYour CPE product / Version. Must be CPE compatible :
[cC][pP][eE]:/[AHOaho](:[A-Za-z0-9\._\-~%]*){0,6}
xsd:stringSee DescriptionYes
cpetypeSpecify if the Product is a Full Product (like Mozilla Firefox) '2' or a Product/Version '1' (like Mozilla Firefox 3.6) xsd:int1|2Yes

Example of get_cpeProductCveIn

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="https://www.security-database.com/get_vdna_soapserver_cpesingle.php">
   <soapenv:Header/>
   <soapenv:Body>
      <get:get_cpeProductCve soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <login xsi:type="xsd:string">testlogin</login>
         <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
         <modulekey xsi:type="xsd:string">65de86d1ksn10odj1u42f4f66885d211</modulekey>
         <cpeproduct xsi:type="get:CPEproduct">cpe:/a:sun:jre</cpeproduct>
         <cpetype xsi:type="xsd:int">2</cpetype>
         </get:get_cpeProductCve>
   </soapenv:Body>
</soapenv:Envelope>

get_cpeProductCveOut

vDNACPESinglet API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn a complex XML (validation with schema)tns:tns:wsGetCVEInfosResultSee description

Example of get_cpeProductCveOut

Example of SOAP return. See the third block for the complex XML return with shema validation possibility. Schema available here : https://www.security-database.com/schemas/vdnacpesingle.xsd

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_cpesingle.php">
   <SOAP-ENV:Body>
      <ns1:get_cpeProductCveResponse>
         <return>
            <cveCount>2</cveCount>
            <lastCVEPublishedDate>2012-10-16</lastCVEPublishedDate>
            <lastCVEModifiedDate>2012-12-18</lastCVEModifiedDate>
            <detailsCveList>
               <cveDetail>
                  <name>CVE-2012-5089</name>
                  <sdcon>High</sdcon>
                  <score>7.6</score>
                  <vector>(AV:N/AC:H/Au:N/C:C/I:C/A:C)</vector>
                  <date_published>2012-10-16</date_published>
                  <date_modified>2012-12-18</date_modified>
                  <md5>cc19bbc57066edf12ba7f6100dfe58d6</md5>
               </cveDetail>
               <cveDetail>
                  <name>CVE-2012-5086</name>
                  <sdcon>Critical</sdcon>
                  <score>10</score>
                  <vector>(AV:N/AC:L/Au:N/C:C/I:C/A:C)</vector>
                  <date_published>2012-10-16</date_published>
                  <date_modified>2012-12-18</date_modified>
                  <md5>1dc15db8835fe57d1592f8eec999be60</md5>
               </cveDetail>
            </detailsCveList>
         </return>
      </ns1:get_cpeProductCveResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>