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

■ getXccdfData

XCCDF チェックリストデータを取得します。

■ リクエスト

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

パラメタ名 名称 パラメタ値 必須 デフォルト[1]
method メソッド名 getXccdfData (固定)
benchmarkId XCCDF チェックリストデータ識別子 getXccdfList の レスポンス <XccdfListItem id="###"/> の id を指定

  • 大文字/小文字区別なし
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
cceName CCE 名 cpe:/{part}:{vendor}:{product}
{part}フィールド ... "h" | "o" | "a" | "*"
{vendor}:{product}フィールド ... CPE 製品名

  • 大文字/小文字区別なし
  • 複数指定時は "+" で連結
lang 表示言語 (日本語/英語) ja:日本語、en:英語 ja
xsl XSLファイル適用/未適用 1:適用、0:未適用 (準備中) 0
  • 1)「デフォルト」は、該当パラメタに指定がない場合 (パラメタ自体もしくはパラメタ値が未指定の場合)に MyJVN API 側で自動的に設定する値です。

■ レスポンス

<?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 ">

<Benchmark id="XCCDF チェックリストデータ識別子"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://checklists.nist.gov/xccdf/1.1"
xmlns:cdf="http://checklists.nist.gov/xccdf/1.1"
xmlns:cpe="http://cpe.mitre.org/XMLSchema/cpe/1.0"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:dsig="http://www.w3.org/2000/09/xmldsig#"
xmlns:xhtml="http://www.w3.org/1999/xhtml"
xmlns:jvndef="http://jvndb.jvn.jp/myjvn/jvndefinitions"
xsi:schemaLocation="http://checklists.nist.gov/xccdf/1.1
http://jvndb.jvn.jp/schema/xccdf-1.1.4.xsd
http://jvndb.jvn.jp/myjvn/jvndefinitions
http://jvndb.jvn.jp/schema/jvndefinitions_0.2.xsd">
  <status date="2011-08-18">draft</status>
  <title>タイトル</title>
  <description>説明</description>
  <reference href="http://jvndb.jvn.jp/ja/apis/myjvn/">
    <dc:title>Windows チェックリスト</dc:title>
    <dc:creator>セキュリティ部</dc:creator>
    <dc:publisher>Information Promotion Agency, Japan</dc:publisher>
    <dc:identifier>http://jvndb.jvn.jp/ja/apis/myjvn/</dc:identifier>
  </reference>
  <version>1.0</version>
  XCCDF チェックリストデータ (Profile, Group, Value, Rule など)
</Benchmark>

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

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

パラメタ 条件 エラーコード エラーメッセージ
method パラメタなし、パラメタ値なし、対象外のメソッド名 XX00000000 対象外のメソッド名です。メソッド名を確認の上、再試行してください。
benchmarkId benchmarkId パラメタならびにパラメタ値未設定 XD01010901 benchmarkId パラメタとパラメタ値は必須です。
cpeName 先頭文字が "cpe:/*:" もしくは "cpe:*:" 以外 XD04030904 cpeName の先頭は "cpe:/*:" または "cpe:*:" のみ指定可能です。
cpe:/{part}:{vendor}:{product} の {vendor} か {product} が半角英数、半角記号以外 XD04020908 cpeName のベンダおよび製品部分は半角英数または半角記号のみ指定可能です(形式:cpe:/{part}:{vendor}:{product})。
cceName 半角英数、半角記号以外 XD05020909 cceName は半角英数または半角記号のみ指定可能です。
lang "en"、"ja"以外 XD02030902 lang は "en" または "ja" のみ指定可能です。
サーバ側でエラーが発生した場合 RQ01999951 ※サーバ側でエラーが発生しました。しばらく時間を置いてから再試行してください。問題が解決しない場合は管理者にお問い合わせください。

TOP

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