API Reference : vDNASingle

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 limit the query request per module as follow :

Production Web Services API Services Endpoints Queries Limitations
	Free and Business	Enterprise
getVDNASingle()	100 queries / day	300 queries / day

vDNASingle API Overview

vDNASingle API Overview by Name

API	Purpose
get_vdnaCVSS	Retreive a CVSS v2 (Common Vulnerability Scoring System) Vector for a given Alert.
get_vdnaCVSSv3	Retreive a CVSS v3 (Common Vulnerability Scoring System) Vector for a given Alert.
get_vdnaPublishedDate	Retreive the Published Date for a given Alert
get_vdnaModifiedDate	Retreive the Last Modified Date for a given Alert
get_vdnaSDcon	Retreive the Security Scoring used by Security-Database (SDcon) for a given Alert
get_vdnaDescription	Retreive the Description used by Security-Database for a given Alert
get_vdnaHistory	Retreive the History for a given CVE Alert

vDNASingle API Overview by Name and Function

API Overview by Name and Function and Service Endpoint

SOAP Name	SOAP Request / Response
get_vdnaCVSS	get_vdnaCVSSIn get_vdnaCVSSOut
get_vdnaCVSSv3	get_vdnaCVSSv3In get_vdnaCVSSv3Out
get_vdnaPublishedDate	get_vdnaPublishedDateIn get_vdnaPublishedDateOut
get_vdnaModifiedDate	get_vdnaModifiedDateIn get_vdnaModifiedDateOut
get_vdnaSDcon	get_vdnaSDconIn get_vdnaSDconOut
get_vdnaDescription	get_vdnaDescriptionIn get_vdnaDescriptionOut
get_vdnaHistory	get_vdnaHistoryIn get_vdnaHistoryOut

get_vdnaCVSSv3

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

get_vdnaCVSSv3In

vDNASingle 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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

Example of get_vdnaCVSSv3In

<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_vdnaCVSSv3 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_vdnaCVSSv3>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaCVSSv3Out

vDNASingle API Overview by Field

Element	Description	Data Type	Possible Values
return	return a full CVSS v3 (Common Vulnerability Scoring System) Vector Example : CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H or Base64 String or empty	xsd:string	See description

Example of get_vdnaCVSSv3Out string

Example of SOAP return with CVSS v3 (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_vdnaCVSSv3Response>
            <return xsi:type="xsd:string">CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H</return>
        </ns1:get_vdnaCVSSv3Response>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return with CVSS v3 (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_vdnaCVSSv3Response>
            <return xsi:type="xsd:string">Q1ZTUzozLjAvQVY6TC9BQzpML1BSOkwvVUk6Ti9TOlUvQzpIL0k6SC9BOkg=</return>
        </ns1:get_vdnaCVSSv3Response>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

get_vdnaCVSS

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

get_vdnaCVSSIn

vDNASingle 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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

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

Element	Description	Data Type	Possible Values
return	return a full CVSS v2 (Common Vulnerability Scoring System) Vector Example : (AV:N/AC:M/Au:N/C:C/I:C/A:C) or Base64 String or empty	xsd:string	See description

Example of get_vdnaCVSSOut string

Example of SOAP return with CVSS v2 (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 v2 (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

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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

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

Element	Description	Data Type	Possible Values
return	return the Published Date Example : (YYY-MM-DD) or Base64 String	xsd:string	See 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

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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

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

Element	Description	Data Type	Possible Values
return	return the Last Modified Date Example : (YYY-MM-DD) or Base64 String	xsd:string	See 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

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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

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_vdnaSDcon>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaSDconOut

vDNASingle API Overview by Field

Element	Description	Data Type	Possible Values
return	return the Security-Database Severity (SDcon) for A given Alert Ouput can be : Critial - High - Medium - Low - NA or Base64 string	xsd:string	See 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

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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes
base64	Can be use to retreive a Base64 76 Columns instead of string	xsd:int	1\|0	Yes

Example of get_vdnaDescriptionIn

<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_vdnaDescription 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_vdnaDescription>
    </soapenv:Body>
</soapenv:Envelope>

get_vdnaDescriptionOut

vDNASingle API Overview by Field

Element	Description	Data Type	Possible Values
return	return the Security-Database Desription for A given Alert	xsd:string	See Description

Example of get_vdnaDescriptionOut

Example of SOAP return a Security-Database Description 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_vdnaDescriptionResponse>
            <return xsi:type="xsd:string">A Description</return>
        </ns1:get_vdnaDescriptionResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example of SOAP return a Security-Database Description 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_vdnaDescriptionResponse>
            <return xsi:type="xsd:string">Q1ZTUzozLjAvQVY6TC9BQzpML1BSOkwvVUk6Ti9TOlUvQzpIL0k6SC9BOkg=</return>
        </ns1:get_vdnaDescriptionResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

get_vdnaHistory

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

get_vdnaHistoryIn

vDNASingle 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
vdna	This is the vDNA Alert that you want. it must be a CVE-XXXX-XXXX	xsd:string	See Description	Yes

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

Element	Description	Data Type	Possible Values
return	return the Security-Database History for A given CVE Alert Ouput is a ComplexType. See the Schema for more informations	tns:wsGetHistoryInfosResult	See 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>Cvss_Vector_v3</historyType>
                     <valueBefore/>
                     <detail>CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H</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>

API Reference : vDNASingle

Security-Database API Reference : vDNASingle

Endpoint WSDL/XSD

SOAP Service Endpoints Limitations

vDNASingle API Overview

vDNASingle API Overview by Name and Function

get_vdnaCVSSv3

get_vdnaCVSSv3In

Example of get_vdnaCVSSv3In

get_vdnaCVSSv3Out

Example of get_vdnaCVSSv3Out string

get_vdnaCVSS

get_vdnaCVSSIn

Example of get_vdnaCVSSIn

get_vdnaCVSSOut

Example of get_vdnaCVSSOut string

get_vdnaPublishedDate

get_vdnaPublishedDateIn

Example of get_vdnaPublishedDateIn

get_vdnaPublishedDateOut

Example of get_vdnaPublishedDateOut

get_vdnaModifiedDate

get_vdnaModifiedDateIn

Example of get_vdnaModifiedDateIn

get_vdnaModifiedDateOut

Example of get_vdnaModifiedDateOut

get_vdnaSDcon

get_vdnaSDconIn

Example of get_vdnaSDconIn

get_vdnaSDconOut

Example of get_vdnaSDconOut

get_vdnaDescription

get_vdnaDescriptionIn

Example of get_vdnaDescriptionIn

get_vdnaDescriptionOut

Example of get_vdnaDescriptionOut

get_vdnaHistory

get_vdnaHistoryIn

Example of get_vdnaHistoryIn

get_vdnaHistoryOut

Example of get_vdnaHistoryOut

API Documentation

API Monitoring Documentation

XSD Documentation

COMPANY

STANDARDS

RECENT POSTS

MENU