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>