Security-Database API Reference : vDNACPESingle *
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 limit the query request per module as follow :
Production Web Services API Services Endpoints Queries Limitations | ||
---|---|---|
Free and Business | Enterprise | |
vDNACPESingle() | N/A | 3.000 queries / day |
vDNACPESingle API Overview
vDNACPESingle API Overview by Name
API | Purpose |
---|---|
get_cpeProductCve | Retreive 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 Name | SOAP Request / Response |
---|---|
get_cpeProductCve | get_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
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 |
cpeproduct | Your CPE product / Version. Must be CPE compatible : [cC][pP][eE]:/[AHOaho](:[A-Za-z0-9\._\-~%]*){0,6} | xsd:string | See Description | Yes |
cpetype | Specify if the Product is a Full Product (like Mozilla Firefox) '2' or a Product/Version '1' (like Mozilla Firefox 3.6) | xsd:int | 1|2 | Yes |
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
Element | Description | Data Type | Possible Values |
---|---|---|---|
return | return a complex XML (validation with schema) | tns:tns:wsGetCVEInfosResult | See 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_v2>(AV:N/AC:H/Au:N/C:C/I:C/A:C)</vector_v2> <vector_v3>CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H</vector_v3> <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_v2>(AV:N/AC:L/Au:N/C:C/I:C/A:C)</vector_v2> <vector_v3>CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H</vector_v3> <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>