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

■ getVulnOverviewList

フィルタリング条件に当てはまる脆弱性対策の概要情報リストを取得します。

■ リクエスト

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

パラメタ名 名称 パラメタ値 必須 デフォルト[1]
method メソッド名 getVulnOverviewList (固定) ○ −
startItem エントリ開始位置 整数 (半角数字)
1〜応答エントリ数		 − 1
maxCountItem エントリ取得件数 整数 (半角数字)
1〜50 (getVulnOverviewList エントリ上限値) 		− 50
cpeName CPE 製品名
(cpe:/{part}:{vendor}:{product}) 		cpe:/{part}:{vendor}:{product}
{part}フィールド ... "h" | "o" | "a" | "*"
{vendor}:{product}フィールド ... CPE 製品名
  • ワイルドカード "*" 指定可
  • アスキー文字
  • 大文字／小文字区別なし
  • 複数指定時は "+" で連結
  • URL エンコードされたエスケープシーケンス
    cpe:/a:apache:xerces-c%2B%2B
    cpeName=cpe:/a:apache:xerces-c%252B%252B
  • いずれか1つのみ指定可 [ cpeName | vendorId | productId ]
− −
vendorId ベンダID 整数 (半角数字)
  • 複数指定時は "+" で連結
  • いずれか1つのみ指定可 [ cpeName | vendorId | productId ]
− −
productId 製品ID 整数 (半角数字)
  • 複数指定時は "+" で連結
  • いずれか1つのみ指定可 [ cpeName | vendorId | productId ]
− −
keyword キーワード URL エンコードされたキーワード
  • 脆弱性概要情報の部分一致によるフィルタリング
  • ワイルドカード "*" 指定不可 ("*"を指定した場合、"*"を含む項目をフィルタリング)
  • 大文字／小文字区別なし
  • charset=UTF-8
− −
severity CVSS 深刻度 l:低、m:中、h:高 − −
vector CVSS 基本評価基準 CVSS 基本評価基準
AV:[L,A,N]/AC:[H,M,L]/Au:[M,S,N]/C:[N,P,C]/I:[N,P,C]/A:[N,P,C]
  • 評価基準パラメタは "項目名:評価値" から構成
    AV:L
  • 評価基準パラメタ列挙時は "/" で連結
    AV:L/AC:M/Au:N/C:C/I:C/A:C
− −
rangeDatePublic 発見日の範囲指定 n:範囲指定なし、w:過去1週間[2]、m:過去1ヶ月[3]
  • 発見日開始年月日または発見日終了年月日に入力がある場合、日付指定を優先
− w
rangeDatePublished 更新日の範囲指定 n:範囲指定なし、w:過去1週間[2]、m:過去1ヶ月[3]
  • 更新日開始年月日または更新日終了年月日に入力がある場合、日付指定を優先
− w
rangeDateFirstPublished 発行日の範囲指定 n:範囲指定なし、w:過去1週間[2]、m:過去1ヶ月[3]
  • 発行日開始年月日または発行日終了年月日に入力がある場合、日付指定を優先
− w
datePublicStartY 発見日開始年 整数4桁 (半角数字) −
  • 年、年月、年月日いずれかの形式で指定可能
  • 年指定の場合、月と日は次の値をとる
    開始月:1
    開始日:1
    終了月:12
    終了日:31
  • 年月指定の場合、日は次の値をとる
    開始日:1
    終了日:終了月の最終日
datePublicStartM 発見日開始月 整数2桁 (半角数字) 1 〜 12 −
datePublicStartD 発見日開始日 整数2桁 (半角数字) 1 〜 31 −
datePublicEndY 発見日終了年 半角整数4桁 −
datePublicEndM 発見日終了月 整数2桁 (半角数字) 1 〜 12 −
datePublicEndD 発見日終了日 整数2桁 (半角数字) 1 〜 31 −
datePublishedStartY 更新日開始年 半角整数4桁 −
datePublishedStartM 更新日開始月 整数2桁 (半角数字) 1 〜 12 −
datePublishedStartD 更新日開始日 整数2桁 (半角数字) 1 〜 31 −
datePublishedEndY 更新日終了年 半角整数4桁 −
datePublishedEndM 更新日終了月 整数2桁 (半角数字) 1 〜 12 −
datePublishedEndD 更新日終了日 整数2桁 (半角数字) 1 〜 31 −
dateFirstPublishedStartY 発行日開始年 半角整数4桁 −
dateFirstPublishedStartM 発行日開始月 整数2桁 (半角数字) 1 〜 12 −
dateFirstPublishedStartD 発行日開始日 整数2桁 (半角数字) 1 〜 31 −
dateFirstPublishedEndY 発行日終了年 半角整数4桁 −
dateFirstPublishedEndM 発行日終了月 整数2桁 (半角数字) 1 〜 12 −
dateFirstPublishedEndD 発行日終了日 整数2桁 (半角数字) 1 〜 31 −
lang 表示言語 (日本語／英語) ja:日本語、en:英語 − ja
xsl XSLファイル適用／未適用 1:適用、0:未適用 (準備中) − 0
  • 1)「デフォルト」は該当パラメタに指定がない場合 (パラメタ自体もしくはパラメタ値が未指定の場合)にMyJVN API側で自動的に設定する値です。
  • 2)「過去1週間」は当日を含む7日間を範囲とします(当日が6/18の場合、6/12〜6/18)。
  • 3)「過去1ヶ月」は前月の同一日付から当日までを範囲とします(当日が6/18の場合、5/18〜6/18)。
  • 4) 日付指定の方式について
    発見日、更新日および発行日は、それぞれ年月日と範囲のいずれかの方法で指定可能です。両方が指定された場合は年月日指定が優先されます。
  • 過去1週間に更新された情報を取得する場合
    パラメタ名 名称 パラメタ値
    rangeDatePublic 発見日の範囲指定 n
    rangeDatePublished 更新日の範囲指定 w (デフォルト値のため、指定不要)
    rangeDateFirstPublished 発行日の範囲指定 n
  • 過去1ヶ月に更新された情報を取得する場合
    パラメタ名 名称 パラメタ値
    rangeDatePublic 発見日の範囲指定 n
    rangeDatePublished 更新日の範囲指定 m
    rangeDateFirstPublished 発行日の範囲指定 n
  • 2008年1月1日以降に発見された脆弱性情報の中で、過去1ヶ月に更新された情報を取得する場合
    パラメタ名 名称 パラメタ値
    datePublicStartY 発見日開始年 2008
    rangeDatePublished 更新日の範囲指定 m
    rangeDateFirstPublished 発行日の範囲指定 n
  • 2007年4月1日から2007年9月30日までに発見された脆弱性情報を取得する場合
    パラメタ名 名称 パラメタ値
    datePublicStartY 発見日開始年 2007
    datePublicStartM 発見日開始月 4
    datePublicEmdY 発見日終了年 2007
    datePublicEmdM 発見日終了月 9
    rangeDatePublished 更新日の範囲指定 n
    rangeDateFirstPublished 発行日の範囲指定 n

■ レスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<rdf:RDF xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://purl.org/rss/1.0/"
xmlns:rss="http://purl.org/rss/1.0/"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:dcterms="http://purl.org/dc/terms/"
xmlns:sec="http://jvn.jp/rss/mod_sec/"
xmlns:status="http://jvndb.jvn.jp/myjvn/Status"
xsi:schemaLocation="http://purl.org/rss/1.0/
http://jvndb.jvn.jp/schema/jvnrss_3.1.xsd
http://jvndb.jvn.jp/myjvn/Status
http:// jvndb.jvn.jp/schema/status_3.1.xsd"
xml:lang="ja">
<channel rdf:about="セキュリティ情報のチャンネルURI">
<title>セキュリティ情報のチャンネルタイトル</title>
<link>セキュリティ情報が掲載されているURI</link>
<description>セキュリティ情報の概要</description>
<dc:date>レスポンス生成日時</dc:date>
<dcterms:issued />
<dcterms:modified>レスポンス生成日時</dcterms:modified>
<items>
<rdf:Seq>
<rdf:li rdf:resource="item要素のrdf:about属性と同じURI"/>
    ：フィルタリングに当てはまる脆弱性対策概要情報の件数分 <rdf:li rdf:resource= を繰り返します。
</rdf:Seq>
</items>
</channel>
<item rdf:about="ベンダが掲載するセキュリティ情報のURI">
<title>セキュリティ情報のタイトル</title>
<link>セキュリティ情報のURI</link>
<description>セキュリティ情報の概要</description>
<dc:publisher> Information Promotion Agency, Japan </dc:publisher>
<dc:creator> Information Promotion Agency, Japan </dc:creator>
<sec:identifier>ベンダ固有のセキュリティ情報ID</sec:identifier>
<sec:references source="発行元省略名" id="識別番号" >関連情報</sec:references>
    ：参考情報の件数分 sec:references ノードを繰り返します。
<sec:cpe-item name="CPE 製品名">
<sec:vname>ベンダ名</sec:vname>
<sec:title>製品名</sec:title>
</sec:cpe-item>
    ：製品情報の件数分 sec:cpe-item ノードを繰り返します。
<sec:cvss score="CVSS 基本値"
severity="CVSS 深刻度"
vector="CVSS 基本評価基準"
version="CVSS バージョン"/>
<dc:date>更新日</dc:date>
<dcterms:issued>発行日</dcterms:issued>
<dcterms:modified>更新日</dcterms:modified>
</item>
    ：フィルタリングに当てはまる脆弱性対策概要情報の件数分 item ノードを繰り返します。
<status:Status
version="3.1"
method="getVulnOverviewList"
lang="表示言語"
retCd="リターンコード (0:成功時、1:エラー時) "
retMax="エントリ取得件数 (item単位)"
errCd="エラーコード (処理成功時は空文字列) "
errMsg="エラーメッセージ (処理成功時は空文字列) "
totalRes="応答エントリ総数 (item単位)"
totalResRet="応答エントリ数 (item単位)"
firstRes="応答エントリ開始位置 (item単位)"
各リクエストパラメタ>
</status:Status>
</rdf:RDF>

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

パラメタ 条件 エラーコード エラーメッセージ
method パラメタなし、パラメタ値なし、対象外のメソッド名 XX00000000 対象外のメソッド名です。メソッド名を確認の上、再試行してください。
startItem 半角数字以外 VU01020402 startItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) VU01020403 startItem は正の整数値のみ指定可能です。
startItem ＞ 応答エントリ数 VU01030404 startItem が検索結果件数を超えています。
maxCountItem 半角数字以外 VU02020406 maxCountItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) VU02020407 maxCountItem は正の整数値のみ指定可能です。
maxCountItem ＞ エントリ上限値 VU02030410 maxCountItem が API 検索上限値を超えています。
cpeName 先頭文字が "cpe:/" 以外 VU03030412 cpeName の先頭は "cpe:/" のみ指定可能です。
cpe:/{part}:{vendor}:{product} の {vendor}か{product} が半角英数、半角記号以外 VU03020416 cpeName のベンダおよび製品部分は半角英数または半角記号のみ指定可能です(形式：cpe:/{part}:{vendor}:{product})。
vendorId 半角数字以外 VU04020418 vendorId は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) VU04020419 vendorId は正の整数値のみ指定可能です。
productId 半角数字以外 VU05020421 productId は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) VU05020422 productId は正の整数値のみ指定可能です。
cpeName
vendorId
productId 		パラメタ "cpeName" "vendorId" "productId" の2つ以上指定あり VU06050423 パラメタ "cpeName"、"vendorId"、"productId" はいずれか1つのみ指定可能です。
lang "en"、"ja"以外 VU08030426 lang は "en" または "ja" のみ指定可能です。
severity "h"、"m"、"l" 以外 VU09030428 severity は "h"、"m" または "l" のみ指定可能です。
rangeDatePublic "w"、"m"、"n"以外 VU10030430 rangeDatePublic は "w"、"m" または "n" のみ指定可能です。
rangeDatePublished "w"、"m"、"n"以外 VU11030432 rangeDatePublished は "w"、"m" または "n" のみ指定可能です。
datePublicStartY
datePublicStartM
datePublicStartD 		発見日開始年、発見日開始年月、発見日開始年月日以外 VU12030436 datePublicStart は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
datePublicStartY 半角数字以外 VU12020437 datePublicStartY は半角数値のみ指定可能です(1〜9999)。
datePublicStartM 半角数字以外 VU12020438 datePublicStartM は半角数値のみ指定可能です(1〜12)。
datePublicStartD 半角数字以外 VU12020439 datePublicStartD は半角数値のみ指定可能です(1〜31)。
datePublicStartY ＜ 0 または ＞ 9999 VU12030440 datePublicStartY の値が無効です。
datePublicStartM ＜ 0 または ＞ 12 VU12030441 datePublicStartM の値が無効です。
datePublicStartD ＜ 0 または ＞ 31 VU12030442 datePublicStartD の値が無効です。
datePublicStartY
datePublicStartM
datePublicStartD 		発見日開始年、発見日開始年月、発見日開始年月日が有効日付でない VU12030443 datePublicStart で指定した日付が無効です。
datePublicEndY
datePublicEndM
datePublicEndD 		発見日終了年、発見日終了年月、発見日終了年月日以外 VU13030447 datePublicEnd は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
datePublicEndY 半角数字以外 VU13010448 datePublicEndY は半角数値のみ指定可能です(1〜9999)。
datePublicEndM 半角数字以外 VU13010449 datePublicEndM は半角数値のみ指定可能です(1〜12)。
datePublicEndD 半角数字以外 VU13010450 datePublicEndD は半角数値のみ指定可能です(1〜31)。
datePublicEndY ＜ 0 または ＞ 9999 VU13030451 datePublicEndY の値が無効です。
datePublicEndM ＜ 0 または ＞ 12 VU13030452 datePublicEndM の値が無効です。
datePublicEndD ＜ 0 または ＞ 31 VU13030453 datePublicEndD の値が無効です。
datePublicEndY
datePublicEndM
datePublicEndD 		発見日終了年、発見日終了年月、発見日終了年月日が有効日付でない VU13030454 datePublicEnd で指定した日付が無効です。
datePublishedStartY
datePublishedStartM
datePublishedStartD 		更新日開始年、更新日開始年月、更新日開始年月日以外 VU14030458 datePublishedStart は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
datePublishedStartY 半角数字以外 VU14020459 datePublishedStartY は半角数値のみ指定可能です(1〜9999)。
datePublishedStartM 半角数字以外 VU14020460 datePublishedStartM は半角数値のみ指定可能です(1〜12)。
datePublishedStartD 半角数字以外 VU14020461 datePublishedStartD は半角数値のみ指定可能です(1〜31)。
datePublishedStartY ＜ 0 または ＞ 9999 VU14030462 datePublishedStartY の値が無効です。
datePublishedStartM ＜ 0 または ＞ 12 VU14030463 datePublishedStartM の値が無効です。
datePublishedStartD ＜ 0 または ＞ 31 VU14030464 datePublishedStartD の値が無効です。
datePublishedStartY
datePublishedStartM
datePublishedStartD 		更新日開始年、更新日開始年月、更新日開始年月日が有効日付でない VU14030465 datePublishedStart で指定した日付が無効です。
datePublishedEndY
datePublishedEndM
datePublishedEndD 		更新日終了年、更新日終了年月、更新日終了年月日以外 VU15030469 datePublishedEnd は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
datePublishedEndY 半角数字以外 VU15020470 datePublishedEndY は半角数値のみ指定可能です(1〜9999)。
datePublishedEndM 半角数字以外 VU15020471 datePublishedEndM は半角数値のみ指定可能です(1〜12)。
datePublishedEndD 半角数字以外 VU15020472 datePublishedEndD は半角数値のみ指定可能です(1〜31)。
datePublishedEndY ＜ 0 または ＞ 9999 VU15030473 datePublishedEndY の値が無効です。
datePublishedEndM ＜ 0 または ＞ 12 VU15030474 datePublishedEndM の値が無効です。
datePublishedEndD ＜ 0 または ＞ 31 VU15030475 datePublishedEndD の値が無効です。
datePublishedEndY
datePublishedEndM
datePublishedEndD 		更新日終了年、更新日終了年月、更新日終了年月日」が有効日付でない VU15030476 datePublishedEnd で指定した日付が無効です。
dateFirstPublishedStartY
dateFirstPublishedStartM
dateFirstPublishedStartD 		更新日開始年、更新日開始年月、更新日開始年月日以外 VU19030487 dateFirstPublishedStart は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
dateFirstPublishedStartY 半角数字以外 VU19030488 dateFirstPublishedStartY は半角数値のみ指定可能です(1〜9999)。
dateFirstPublishedStartM 半角数字以外 VU19030489 dateFirstPublishedStartM は半角数値のみ指定可能です(1〜12)。
dateFirstPublishedStartD 半角数字以外 VU19030490 dateFirstPublishedStartD は半角数値のみ指定可能です(1〜31)。
dateFirstPublishedStartY ＜ 0 または ＞ 9999 VU19030491 dateFirstPublishedStartY の値が無効です。
dateFirstPublishedStartM ＜ 0 または ＞ 12 VU19030492 dateFirstPublishedStartM の値が無効です。
dateFirstPublishedStartD ＜ 0 または ＞ 31 VU19030493 dateFirstPublishedStartD の値が無効です。
dateFirstPublishedStartY
dateFirstPublishedStartM
dateFirstPublishedStartD 		更新日開始年、更新日開始年月、更新日開始年月日が有効日付でない VU19030494 dateFirstPublishedStart で指定した日付が無効です。
dateFirstPublishedEndY
dateFirstPublishedEndM
dateFirstPublishedEndD 		更新日終了年、更新日終了年月、更新日終了年月日以外 VU18030479 dateFirstPublishedEnd は "Y"、"YM"、"YMD" のいずれかの組み合わせのみ指定可能です。
dateFirstPublishedEndY 半角数字以外 VU18030480 dateFirstPublishedEndY は半角数値のみ指定可能です(1〜9999)。
dateFirstPublishedEndM 半角数字以外 VU18030481 dateFirstPublishedEndM は半角数値のみ指定可能です(1〜12)。
dateFirstPublishedEndD 半角数字以外 VU18030482 dateFirstPublishedEndD は半角数値のみ指定可能です(1〜31)。
dateFirstPublishedEndY ＜ 0 または ＞ 9999 VU18030483 dateFirstPublishedEndY の値が無効です。
dateFirstPublishedEndM ＜ 0 または ＞ 12 VU18030484 dateFirstPublishedEndM の値が無効です。
dateFirstPublishedEndD ＜ 0 または ＞ 31 VU18030485 dateFirstPublishedEndD の値が無効です。
dateFirstPublishedEndY
dateFirstPublishedEndM
dateFirstPublishedEndD 		更新日終了年、更新日終了年月、更新日終了年月日」が有効日付でない VU18030486 dateFirstPublishedEnd で指定した日付が無効です。
− サーバ側でエラーが発生した場合 RQ01999951 ※サーバ側でエラーが発生しました。しばらく時間を置いてから再試行してください。問題が解決しない場合は管理者にお問い合わせください。

TOP

[更新履歴]
2011年10月26日 改訂(XMLスキーマ)．
2010年02月25日 初版．