MyJVN >> API >> getOvalList >> 動作確認支援ツール

■ getOvalList

フィルタリング条件に当てはまる OVAL 定義データリストを取得します。

■ リクエスト

  • https://jvndb.jvn.jp/myjvn?method=getOvalList&パラメタ名=パラメタ値&...
    • リクエスト URL は、HTTP の GET および POST に対応しています。
  • パラメタ
    • メソッド名、パラメタ名は大文字小文字を区別しています。
    • 必須パラメタが未指定、または値なし ("method="など) の場合はエラーとなります。
    • 必須でないパラメタが未指定、または値なし ("lang="など) の場合はデフォルトを使用します。

パラメタ名 名称 パラメタ値 必須 デフォルト[1]
method メソッド名 getOvalList (固定) ○ −
startItem エントリ開始位置 整数 (半角数字)
1〜応答エントリ数		 − 1
maxCountItem エントリ取得件数 整数 (半角数字)
1〜50 (getOvalList エントリ上限値) 		− 50
cpeName CPE 製品名
(cpe:/{part}:{vendor}:{product}) 		cpe:/{part}:{vendor}:{product}
{part}フィールド ... "h" | "o" | "a" | "*"
{vendor}:{product}フィールド ... CPE 製品名
  • ワイルドカード "*" 指定可
  • アスキー文字
  • 大文字／小文字区別なし
  • 複数指定時は "+" で連結
  • URL エンコードされたエスケープシーケンス
2012年05月22日時点で利用可能な CPE 製品名
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 製品名
(cpe:/{part}:{vendor}:{product}) 		cpe:/{part}:{vendor}:{product}
{part}フィールド ... "o"
{vendor}:{product}フィールド ... CPE 製品名
  • ワイルドカード "*" 指定可
  • アスキー文字
  • 大文字／小文字区別なし
  • URL エンコードされたエスケープシーケンス
2012年05月22日時点で利用可能な CPE 製品名
cpe:/o:microsoft:windows*
cpe:/o:centos:centos*
cpe:/o:redhat:enterprise_linux* 		− −
ovalType チェッカー種別 バージョンチェック／セキュリティ設定チェックを選択
  • vendorinfo: バージョンチェック用
  • securitycheckinfo: セキュリティ設定チェック用
− vendorinfo
internalType OVAL データ種別 inventory/vulnerability/compliance を選択
  • inventory: ソフトウェアのインストール有無チェック用
  • vulnerability: ソフトウェアのバージョン情報チェック用
  • compliance: セキュリティ設定チェック用
− −
mode アプリケーション動作モード
  • x32: 32ビットモードで動作
  • x64: 64ビットネイティブモードで動作
  • wow64: wow64モードで動作
  • x32-x64: 32/64ビットモード共通
  • x32-wow64: 32/wow64モード共通
  • x64-wow64: 64-wow64モード共通
− −
lang 表示言語 (日本語／英語) ja:日本語、en:英語 − ja
xsl XSLファイル適用／未適用 1:適用、0:未適用 (準備中) − 0
  • 1)「デフォルト」は、該当パラメタに指定がない場合 (パラメタ自体もしくはパラメタ値が未指定の場合)に MyJVN API 側で自動的に設定する値です。

■ レスポンス

  • 概要
    • 処理成功時、Result ノードの中に VendorInfo、SecurityCheckInfo、MyJVN 共通 Status ノードを含む XML を応答します。 ただし、フィルタリング結果が0件の場合、Result ノードの中に MyJVN 共通 Status ノードのみを含む XML を応答します。
    • エラー発生時、MyJVN 共通 Status ノードにエラーコードとエラーメッセージを格納します。
  • XMLスキーマ

<?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="表示言語">
  <Vendor vname="ベンダ名" cpe="CPE ベンダ名" vid="ベンダ ID">
    <Product pname="製品名" cpe="CPE 製品名" pid="製品 ID">
      <OvalList>
        <OvalListItem oid="OVAL 定義データ識別子"/>
        ：フィルタリングに当てはまる製品の件数分 OvalListItem ノードを繰り返します。
      </OvalList>
    </Product>
    製品の件数分 Product ノードを繰り返します。
  </Vendor>
  ベンダの件数分 Vendor ノードを繰り返します。
</VendorInfo>
ovalType=securitycheckinfo の場合
<SecurityCheckInfo xml:lang="表示言語">
  <Group id="グループ ID" title="グループ名">
    <Rule id="ルール ID" title="ルール名" reference="参考情報">
      <OvalList>
        <OvalListItem oid="OVAL 定義データ識別子"/>
      </OvalList>
    </Rule>
    Rule ノードを繰り返します。
  </Group>
  Group ノードを繰り返します。
</SecurityCheckInfo>

<status:Status
version="3.1"
method="getOvalList"
lang="表示言語"
retCd="リターンコード (0:成功時、1:エラー時) "
retMax="取得件数"
errCd="エラーコード (処理成功時は空文字列) "
errMsg="エラーメッセージ (処理成功時は空文字列) "
totalRes="応答エントリ総数"
totalResRet="応答エントリ数"
firstRes="応答エントリ開始位置"
各リクエストパラメタ>
</status:Status>
</Result>

  • エラーコードとエラーメッセージ

パラメタ 条件 エラーコード エラーメッセージ
method パラメタなし、パラメタ値なし、対象外のメソッド名 XX00000000 対象外のメソッド名です。メソッド名を確認の上、再試行してください。
startItem 半角数字以外 OL01020801 startItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) OL01020802 startItem は正の整数値のみ指定可能です。
startItem ＞ 応答エントリ数 OL01030803 startItem が検索結果件数を超えています。
maxCountItem 半角数字以外 OL02020804 maxCountItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) OL02020805 maxCountItem は正の整数値のみ指定可能です。
maxCountItem ＞ エントリ上限値 OL02030806 maxCountItem が API 検索上限値を超えています。
cpeName 先頭文字が "cpe:/"以外 OL03030807 cpeName の先頭は "cpe:/" のみ指定可能です。
cpe:/{part}:{vendor} の {vendor} が半角英数、半角記号以外 OL03020810 cpeName のベンダ部分は半角英数または半角記号のみ指定可能です(形式：cpe:/*:{vendor})。
platform 先頭文字が "cpe:/"以外 OL04030811 platform の先頭は "cpe:/" のみ指定可能です。
cpe:/{part}:{vendor}:{product} の {vendor} か {product} が半角英数、半角記号以外 OL04020814 platform のベンダおよび製品部分は半角英数または半角記号のみ指定可能です(形式：cpe:/{part}:{vendor}:{product})。
internalType 指定されたパラメタ値以外 OL08030820 internalType は inventory, vulnerability, compliance のみ指定可能です。
mode 指定されたパラメタ値以外 OL10030822 mode は ｘ32, ｘ64, wow64 とその組合せのみ指定可能です。
lang "en"、"ja"以外 OL06030817 lang は "en" または "ja" のみ指定可能です。
− サーバ側でエラーが発生した場合 RQ01999951 ※サーバ側でエラーが発生しました。しばらく時間を置いてから再試行してください。問題が解決しない場合は管理者にお問い合わせください。

TOP

[更新履歴]
2012年08月09日 初版．