Security-Database API Reference : vDNASingle

The vDNASingle 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_single.php?wsdl

SOAP Service Endpoints Limitations

During the Beta phase and 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
getVDNASingle()100 queries / day300 queries / day

vDNASingle API Overview

vDNASingle API Overview by Name

APIPurpose
get_vdnaCVSSRetreive a CVSS (Common Vulnerability Scoring System) Vector for a given Alert.
get_vdnaPublishedDateRetreive the Published Date for a given Alert
get_vdnaModifiedDateRetreive the Last Modified Date for a given Alert
get_vdnaSDconRetreive the Security Scoring used by Security-Database (SDcon) for a given Alert
get_vdnaDescriptionRetreive the Description used by Security-Database for a given Alert
get_vdnaHistoryRetreive the History for a given CVE Alert

vDNASingle API Overview by Name and Function

API Overview by Name and Function and Service Endpoint

SOAP NameSOAP Request / Response
get_vdnaCVSSget_vdnaCVSSIn
get_vdnaCVSSOut
get_vdnaPublishedDateget_vdnaPublishedDateIn
get_vdnaPublishedDateOut
get_vdnaModifiedDateget_vdnaModifiedDateIn
get_vdnaModifiedDateOut
get_vdnaSDconget_vdnaSDconIn
get_vdnaSDconOut
get_vdnaDescriptionget_vdnaDescriptionIn
get_vdnaDescriptionOut
get_vdnaHistoryget_vdnaHistoryIn
get_vdnaHistoryOut

get_vdnaCVSS

get_vdnaCVSSIn is your request to retreive a CVSS (Common Vulnerability Scoring System) Vector for a given Alert

get_vdnaCVSSIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes
base64Can be use to retreive a Base64 76 Columns instead of stringxsd:int1|0Yes

Example of get_vdnaCVSSIn

<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_single.php">
    <soapenv:Header/>
    <soapenv:Body>
        <get:get_vdnaCVSS soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <login xsi:type="xsd:string">testlogin</login>
            <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
            <vdna xsi:type="xsd:string">CVE-2009-3135</vdna>
            <modulekey xsi:type="xsd:string">9J4rdVutHFmed7a3Kp5JzUZq02W6cQDj</modulekey>
            <base64 xsi:type="xsd:int">0</base64>
        </get:get_vdnaCVSS>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaCVSSOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn a full CVSS (Common Vulnerability Scoring System) Vector
Example :
(AV:N/AC:M/Au:N/C:C/I:C/A:C) or Base64 String or empty
xsd:stringSee description

Example of get_vdnaCVSSOut string

Example of SOAP return with CVSS (Common Vulnerability Scoring System) as a string

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaCVSSResponse>
            <return xsi:type="xsd:string">(AV:N/AC:M/Au:N/C:C/I:C/A:C)</return>
        </ns1:get_vdnaCVSSResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return with CVSS (Common Vulnerability Scoring System) as a string encoded in Base64 76 Column

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaCVSSResponse>
            <return xsi:type="xsd:string">KEFWOk4vQUM6TS9BdTpOL0M6Qy9JOkMvQTpDKQ==</return>
        </ns1:get_vdnaCVSSResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

get_vdnaPublishedDate

get_vdnaPublishedDateIn is your request to retreive the Published Date for a given Alert

get_vdnaPublishedDateIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes
base64Can be use to retreive a Base64 76 Columns instead of stringxsd:int1|0Yes

Example of get_vdnaPublishedDateIn

<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_single.php">
    <soapenv:Header/>
    <soapenv:Body>
        <get:get_vdnaPublishedDate soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <login xsi:type="xsd:string">testlogin</login>
            <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
            <vdna xsi:type="xsd:string">CVE-2009-3135</vdna>
            <modulekey xsi:type="xsd:string">9J4rdVutHFmed7a3Kp5JzUZq02W6cQDj</modulekey>
            <base64 xsi:type="xsd:int">0</base64>
        </get:get_vdnaPublishedDate>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaPublishedDateOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn the Published Date
Example :
(YYY-MM-DD) or Base64 String
xsd:stringSee description

Example of get_vdnaPublishedDateOut

Example of SOAP return a Date as a string

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaPublishedDateResponse>
            <return xsi:type="xsd:string">2011-12-13</return>
        </ns1:get_vdnaPublishedDateResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return a Date as a string encoded in Base64 76 Column

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaPublishedDateResponse>
            <return xsi:type="xsd:string">MjAxMS0xMi0xMw==</return>
        </ns1:get_vdnaPublishedDateResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

get_vdnaModifiedDate

get_vdnaModifiedDateIn is your request to retreive the Last Modified Date for a given Alert

get_vdnaModifiedDateIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes
base64Can be use to retreive a Base64 76 Columns instead of stringxsd:int1|0Yes

Example of get_vdnaModifiedDateIn

<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_list.php">
    <soapenv:Header/>
    <soapenv:Body>
        <get:get_vdnaModifiedDate 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">9J4rdVutHFmed7a3Kp5JzUZq02W6cQDj</modulekey>
            <base64 xsi:type="xsd:int">0</base64>
        </get:get_vdnaModifiedDate>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaModifiedDateOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn the Last Modified Date
Example :
(YYY-MM-DD) or Base64 String
xsd:stringSee description

Example of get_vdnaModifiedDateOut

Example of SOAP return a Date as a string

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaModifiedDateResponse>
            <return xsi:type="xsd:string">2011-12-13</return>
        </ns1:get_vdnaModifiedDateResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return a Date as a string encoded in Base64 76 Column

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaModifiedDateResponse>
            <return xsi:type="xsd:string">MjAxMS0xMi0xMw==</return>
        </ns1:get_vdnaModifiedDateResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
 

get_vdnaSDcon

get_vdnaSDconIn is your request to retreive the Security-Database Severity (SDcon) for a given Alert

get_vdnaSDconIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes
base64Can be use to retreive a Base64 76 Columns instead of stringxsd:int1|0Yes

Example of get_vdnaSDconIn

<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_single.php">
    <soapenv:Header/>
    <soapenv:Body>
        <get:get_vdnaSDcon soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <login xsi:type="xsd:string">testlogin</login>
            <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
            <vdna xsi:type="xsd:string">CVE-2009-3135</vdna>
            <modulekey xsi:type="xsd:string">9J4rdVutHFmed7a3Kp5JzUZq02W6cQDj</modulekey>
            <base64 xsi:type="xsd:int">0</base64>
        </get:get_vdnaCVSS>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaSDconOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn the Security-Database Severity (SDcon) for A given Alert
Ouput can be : Critial - High - Medium - Low - NA or Base64 string
xsd:stringSee Description

Example of get_vdnaSDconOut

Example of SOAP return a Security-Database Severity (SDcon) as a string

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaSDconResponse>
            <return xsi:type="xsd:string">Critical</return>
        </ns1:get_vdnaSDconResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return a Security-Database Severity (SDcon) as a string encoded in Base64 76 Column

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:get_vdnaSDconResponse>
            <return xsi:type="xsd:string">Q3JpdGljYWw=</return>
        </ns1:get_vdnaSDconResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

get_vdnaDescription

get_vdnaDescriptionIn is your request to retreive the Security-Database Description for a given Alert

get_vdnaDescriptionIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes
base64Can be use to retreive a Base64 76 Columns instead of stringxsd:int1|0Yes

Example of get_vdnaDescriptionIn

get_vdnaDescriptionOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn the Security-Database Desription for A given Alertxsd:stringSee Description

Example of get_vdnaDescriptionOut

Example of SOAP return a Security-Database Description as a string

Example of SOAP return a Security-Database Description as a string encoded in Base64 76 Column

get_vdnaHistory

get_vdnaHistoryIn is your request to retreive the Security-Database History for a given Alert

get_vdnaHistoryIn

vDNASingle 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
vdnaThis is the vDNA Alert that you want.

it must be a CVE-XXXX-XXXX
xsd:stringSee DescriptionYes

Example of get_vdnaHistoryIn

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="https://www.security-database.com/get_vdna_soapserver_single.php">
   <soapenv:Header/>
   <soapenv:Body>
      <get:get_vdnaHistory>
         <login xsi:type="xsd:string">testlogin</login>
         <apikey xsi:type="xsd:string">quJzDo7J5VDAouuNFuVvlDu6dAhlvfxS</apikey>
         <modulekey xsi:type="xsd:string">65de86d1ksn10odj1u42f4f66885d211</modulekey>
         <vdna>CVE-2012-2556</vdna>
      </get:get_vdnaHistory>
   </soapenv:Body>
</soapenv:Envelope>

get_vdnaHistoryOut

vDNASingle API Overview by Field

ElementDescriptionData TypePossible Values
returnreturn the Security-Database History for A given CVE Alert
Ouput is a ComplexType. See the Schema for more informations
tns:wsGetHistoryInfosResultSee Description

Example of get_vdnaHistoryOut

Example of SOAP return a Security-Database Alert History

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://www.security-database.com/get_vdna_soapserver_single.php" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:get_vdnaHistoryResponse>
         <return>
            <detailsHistoryList>
               <historyDetail>
                  <historyDate>2012-12-21 00:21:33</historyDate>
                  <historyStatus>Update</historyStatus>
                  <detailSingle>
                     <historyType>Modified Date</historyType>
                     <detail>2012-12-20</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>CPE</historyType>
                     <detail>29</detail>
                  </detailSingle>
               </historyDetail>
               <historyDetail>
                  <historyDate>2012-12-12 21:19:38</historyDate>
                  <historyStatus>Update</historyStatus>
                  <detailSingle>
                     <historyType>VendorSeverity</historyType>
                     <detail>Critical</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>Score</historyType>
                     <detail>9.3</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>Cvss_Vector</historyType>
                     <valueBefore/>
                     <detail>(AV:N/AC:M/Au:N/C:C/I:C/A:C)</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>Modified Date</historyType>
                     <detail>2012-12-12</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>Status</historyType>
                     <detail>M</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>Sdcon</historyType>
                     <detail>Critical</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>CPE</historyType>
                     <detail>9</detail>
                  </detailSingle>
                  <detailSingle>
                     <historyType>CWE</historyType>
                     <detail>1</detail>
                  </detailSingle>
               </historyDetail>
               <historyDetail>
                  <historyDate>2012-12-12 13:19:33</historyDate>
                  <historyStatus>Insert</historyStatus>
                  <detailSingle xsi:nil="true"/>
               </historyDetail>
            </detailsHistoryList>
         </return>
      </ns1:get_vdnaHistoryResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>