MyJVN >> API >> getOvalList >> Tool

getOvalList

Getting on the OVAL definition list in JVN repository

Request

  • http://jvndb.jvn.jp/myjvn?method=getOvalList&ParameterName=ParameterValue&...
    • MyJVN API supports GET and POST method.

ParameterName Description ParameterValue Required Default
method Method name of API getOvalList (Fix) v --
startItem Start position of items Integer (1 - The item number of results) -- 1
maxCountItem Maximum number of items Integer
1 - 50 (The maximum item number of results in getOvalList API)
-- 50
cpeName CPE product name
(cpe:/{part}:{vendor}:{product})
cpe:/{part}:{vendor}:{product}
{part}field ... "h" | "o" | "a" | "*"
{vendor}:{product}field ... CPE product name

  • Enabled wild card search (*)
  • Ascii character
  • Case-insensitive
  • Multi-valued value by the plus (+) "string concatenate"
  • Escape-sequences by URL encode

Available CPE product name
cpe:/a:adobe:acrobat_reader
cpe:/a:adobe:flash_player_activex
cpe:/a:adobe:flash_player_plugin
cpe:/a:adobe:shockwave_player
cpe:/a:apache:http_server
cpe:/a:apache:tomcat
cpe:/a:apple:quicktime
cpe:/a:isc:bind
cpe:/a:lhaplus:lhaplus
cpe:/a:lunascape:lunascape
cpe:/a:mozilla:firefox
cpe:/a:mozilla:thunderbird
cpe:/a:openoffice:openoffice.org
cpe:/a:openssl:openssl
cpe:/a:rimarts_inc.:becky_internet_mail
cpe:/a:sun:jre
cpe:/a:vmware:player
-- --
platform CPE product name of platform
(cpe:/{part}:{vendor}:{product})
cpe:/{part}:{vendor}:{product}
{part}field ... "o"
{vendor}:{product}field ... CPE product name

  • Enabled wild card search (*)
  • Ascii character
  • Case-insensitive
  • Escape-sequences by URL encode

Available CPE product name
cpe:/o:microsoft:windows*
cpe:/o:centos:centos*
cpe:/o:redhat:enterprise_linux*
-- --
ovalType Type of MyJVN Checker Version Check, Security Configuration Check
  • vendorinfo: For Version Check
  • securitycheckinfo: For Security Configuration Check
-- vendorinfo
internalType Type of OVAL definition inventory/vulnerability/compliance
  • inventory: For Install Check
  • vulnerability: For Version Check
  • compliance: For Security Configuration Check
-- --
mode Type of Application mode
  • x32: 32 bit mode
  • x64: 64 bit native mode
  • wow64: wow64 mode
  • x32-x64: 32/64 bit mode
  • x32-wow64: 32/wow64 mode
  • x64-wow64: 64-wow64 mode
-- --
lang Language (Japanese/English) ja: Japanese en: English -- ja
xsl XSL 1:Enable 0:Disable (Under Construction) -- 0

Response

<?xml version="1.0" encoding="UTF-8" ?>
<Result version="3.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://jvndb.jvn.jp/myjvn/Results"
xmlns:mjres="http://jvndb.jvn.jp/myjvn/Results"
xmlns:status="http://jvndb.jvn.jp/myjvn/Status"
xsi:schemaLocation="http://jvndb.jvn.jp/myjvn/Results
http://jvndb.jvn.jp/schema/results_3.1.xsd ">


ovalType=vendorinfo
<VendorInfo xml:lang="Language">
  <Vendor vname="Vendor Title" cpe="Vendor CPE Name" vid="Vendor ID">
    <Product pname="Product Title" cpe="Product CPE Name" pid="Product ID">
      <OvalList>
        <OvalListItem oid="OVAL definition ID"/>
        Repeat of OvalListItem node
      </OvalList>
    </Product>
    Repeat of Product node
  </Vendor>
  Repeat of Vendor node
</VendorInfo>

ovalType=securitycheckinfo
<SecurityCheckInfo xml:lang="Language">
  <Group id="Group ID" title="Group Title">
    <Rule id="Rule ID" title="Rule Title" reference="Reference">
      <OvalList>
        <OvalListItem oid="OVAL definition ID"/>
      </OvalList>
    </Rule>
    Repeat of Rule node
  </Group>
  Repeat of Group node
</SecurityCheckInfo>


<status:Status
version="3.1"
method="getOvalList"
lang="Language"
retCd="Return code (0:success, 1:failure) "
retMax="Maximum number of Entry"
errCd="Error code (Null:success) "
errMsg="Error message (Null:success) "
totalRes="Total number of Result entries"
totalResRet="Number of Result entries"
firstRes="Start entry number in Result entries"
Parameters in request>
</status:Status>
</Result>

  • Error code and Error message

ParameterName Error code Error message
method XX00000000 Invalid or no method name. Please retry with valid method name.
startItem OL01020801 Parameter startItem can be number only (1 to 2147483647).
OL01020802 Parameter startItem can be positive number only.
OL01030803 Parameter startItem exceeds result count.
maxCountItem OL02020804 Parameter maxCountItem can be number only (1 to 2147483647).
OL02020805 Parameter maxCountItem can be positive number only.
OL02030806 Parameter maxCountItem exceeds maximum count set by API.
cpeName OL03030807 Parameter cpeName can start with "cpe:/*:" and "cpe:*:" only.
OL03020810 Section "vendor" and "product" of parameter cpeName can be single byte alphanumeric or single byte special character only. (Format: cpe:/{part}:{vendor}:{product})
platform OL04030811 Parameter platform can start with "cpe:/" only.
OL04020814 Section "vendor" and "product" of parameter platformcan be single byte alphanumeric or single byte special character only. (Format: cpe:/{part}:{vendor}:{product})
internalType OL08030820 Parameter internalType can have "inventory", "vulnerability" and "compliance" only.
mode OL10030822 Parameter mode can have "x32", "x64" and "wow64" only.
lang OL06030817 Parameter lang can have "en" and "ja" only.
-- RQ01999951 Error occurred while processing the request. Please retry later or contact administrator.

TOP

[Revisions]
August 9, 2012: MyJVN API getOvalList released.