API Reference
This document, Security-Database Web Services API Reference, describes the Security-Database Web Services Application Programming Interface (API) and service.
Intended Audience
This document is written for programmers familiar with Web Services application programming standards such as the Simple Object Access Protocol (SOAP), the Web Services Description Language (WSDL), and XML Schema Definition (XSD) language.
Security-Database WSDL/XSD Schemas Definitions
The following are the locations of the WSDL and XSD files.
Production Web Services API Services WSDL | |
---|---|
getVDNA() | https://www.security-database.com/get_vdna_soapserver.php?wsdl |
getVDNASingle() | https://www.security-database.com/get_vdna_soapserver_single.php?wsdl |
getVDNAList() | https://www.security-database.com/get_vdna_soapserver_list.php?wsdl |
getVDNACvss() | https://www.security-database.com/get_vdna_soapserver_cvss.php?wsdl |
getVDNACvssv3() | https://www.security-database.com/get_vdna_soapserver_cvssv3.php?wsdl |
getVDNACPEList() | https://www.security-database.com/get_vdna_soapserver_cpelist.php?wsdl |
getVDNAOvalID() | https://www.security-database.com/get_vdna_soapserver_oval.php?wsdl |
getVDNACPEManagement() * | https://www.security-database.com/get_vdna_soapserver_cpemanagement.php?wsdl |
getVDNACPE() * | https://www.security-database.com/get_vdna_soapserver_cpe.php?wsdl |
getVDNACPESingle() * | https://www.security-database.com/get_vdna_soapserver_cpesingle.php?wsdl |
*Only available with Enterprise Subscription
Production Web Services API Services XSD | |
---|---|
getVDNA() | https://www.security-database.com/schemas/vdna.xsd |
getVDNASingle() | https://www.security-database.com/schemas/vdnasingle.xsd |
getVDNAList() | https://www.security-database.com/schemas/vdnalist.xsd |
getVDNACvss() | https://www.security-database.com/schemas/vdnacvss.xsd |
getVDNACvssv3() | https://www.security-database.com/schemas/vdnacvssv3.xsd |
getVDNACPEList() | https://www.security-database.com/schemas/vdnacpelist.xsd |
getVDNAovalID() | https://www.security-database.com/schemas/vdnaovalid.xsd |
getVDNACPEManagement() * | https://www.security-database.com/schemas/vdnamanagement.xsd |
getVDNACPE() * | https://www.security-database.com/schemas/vdnacpe.xsd |
getVDNACPESingle() * | https://www.security-database.com/schemas/vdnacpesingle.xsd |
*Only available with Enterprise Subscription
API Security
The Security-Database Web Services API service is protected to ensure that only authorized Security-Database members use it. There are three primary levels of security:
- API username/password and third-party account authentication
- Public/private key encryption via an API certificate or API signature
- Secure Sockets Layer (SSL) data transport
A failure of authenticated security at any one of these levels denies access to the Security-Database Web Services API.
SOAP Service Endpoints
Depending on your chosen action, your SOAP requests must be processed by different service endpoints
Production Web Services API Services Endpoints | |
---|---|
getVDNA() | https://www.security-database.com/get_vdna_soapserver.php |
getVDNASingle() | https://www.security-database.com/get_vdna_soapserver_single.php |
getVDNAList() | https://www.security-database.com/get_vdna_soapserver_list.php |
getVDNACvss() | https://www.security-database.com/get_vdna_soapserver_cvss.php |
getVDNACvssv3() | https://www.security-database.com/get_vdna_soapserver_cvssv3.php |
getVDNACPEList() | https://www.security-database.com/get_vdna_soapserver_cpelist.php |
getVDNAOvalID() | https://www.security-database.com/get_vdna_soapserver_oval.php |
getVDNACPEManagement() * | https://www.security-database.com/get_vdna_soapserver_cpemanagement.php |
getVDNACPE() * | https://www.security-database.com/get_vdna_soapserver_cpe.php |
getVDNACPESingle() * | https://www.security-database.com/get_vdna_soapserver_cpesingle.php |
*Only available with Enterprise Subscription
SOAP Service Endpoints Limitations
Security-Database Web Services API service Endpoints have limited query request per module as follow :
Production Web Services API Services Endpoints Queries Limitations | ||
---|---|---|
Free and Business | Enterprise | |
getVDNA() | 10 queries / day | 30 queries / day |
getVDNASingle() | 100 queries / day | 300 queries / day |
getVDNAList() | Unlimited queries / day | Unlimited queries / day |
getVDNACvss() | Unlimited queries / day | Unlimited queries / day |
getVDNACvssv3() | Unlimited queries / day | Unlimited queries / day |
getVDNACPEList() | Unlimited queries / day | Unlimited queries / day |
getVDNAOvalID() | 5 / day | 60 / day |
getVDNACPEManagement() * | -- | Unlimited queries / day |
getVDNACPE() * | -- | 3.000 queries / day |
getVDNACPESingle() * | -- | 3.000 queries / day |
*Only available with Enterprise Subscription
SOAP Service Endpoints Documentation
For each Security-Database Web Services API service Endpoints, we provide separate doculentation
Production Web Services API Services Endpoints Documentation | |
---|---|
getVDNA() | here |
getVDNASingle() | here |
getVDNAList() | here |
getVDNACvss() | here |
getVDNACvssv3() | here |
getVDNACPEList() | here |
getVDNAOvalID() | here |
getVDNACPEManagement() * | here |
getVDNACPE() * | here |
getVDNACPESingle() * | here |
*Only available with Enterprise Subscription
API Overview By Business Function and Service Endpoint
The Security-Database Web Services API consists of individual APIs for specific business uses, and the individual APIs are grouped into three service endpoints
Business Function | SOAP Request/Response | Production (Live) Endpoint |
---|---|---|
Retreive vDNA Full informations | get_vdnaIn get_vdnaOut | https://(...)/get_vdna_soapserver.php |
Retreive vDNA Information for a single element | get_vdnaCVSSIn get_vdnaCVSSOut get_vdnaPublishedDateIn get_vdnaPublishedDateOut get_vdnaModifiedDateIn get_vdnaModifiedDateOut get_vdnaSDconIn get_vdnaSDconOut get_vdnaHistoryIn get_vdnaHistoryOut | https://(...)/get_vdna_soapserver_single.php |
Retreive vDNA Listing | get_vdnaCVELast10PublishedIn get_vdnaCVELast10PublishedOut get_vdnaCVELast10ModifiedIn get_vdnaCVELast10ModifiedOut | https://(...)/get_vdna_soapserver_list.php |
CVSS Calculator | get_cvssscore_withenumerationIn get_cvssscore_withenumerationOut get_cvssscore_withvectorIn get_cvssscore_withvectorOut | https://(...)/get_vdna_soapserver_cvss.php |
CVSSv3 Preview 2 Calculator | get_cvssscore_withvectorIn get_cvssscore_withvectorOut | https://(...)/get_vdna_soapserver_cvssv3.php |
Retreive CPEList | get_vdnacpevendorlistIn get_vdnacpevendorlistOut get_vdnacpeproductlistIn get_vdnacpeproductlistOut get_vdnacpeversionlistIn get_vdnacpeversionlistOut get_vdnacpesearchlistIn get_vdnacpesearchlistOut | https://(...)/get_vdna_soapserver_cvssv3.php |
Manage Monitoring Products * | add_productIn add_productOut remove_productIn remove_productOut get_inventoryIn get_inventoryOut | https://(...)/get_vdna_soapserver_cpemanagement.php |
Retreive Product Summary * | get_cpeProductSummaryIn get_cpeProductSummaryOut | https://(...)/get_vdna_soapserver_cpe.php |
Retreive Alerts listing for a Product * | get_cpeProductCveIn get_cpeProductCveOut | https://(...)/get_vdna_soapserver_cpesingle.php |
*Only available with Enterprise Subscription