QualysGuard(R) API Release Notes

Size: px

Start display at page:

Download "QualysGuard(R) API Release Notes"

ゆきはらしない
5 years ago
Views:

1 QualysGuard API リリースノートバージョン年 2 月 14 日 QualysGuard 7.8 の QualysGuard API ではユーザのプログラムおよび API 呼び出しを QualysGuard クラウドスイートのセキュリティおよびコンプライアンスアプリケーションに統合するための改善が行われました新機能 VM スキャン結果の XML - 選択したアセットタグを表示する新しい要素アセット IP API v1 - CIDR 形式のサポートとクラス A の IP アドレスの追加検出 API v2 - 実行されていないカーネルで見つかった脆弱性を除外全般的な注意事項 QualysGuard API サーバの URL - QualysGuard API のドキュメントとサンプルコードには QualysGuard US プラットフォーム用 API サーバの URL を使用していますアカウントが別のプラットフォームに所属している場合はご使用のアカウントが所属するサーバの URL に置き換えてくださいアカウントの場所 QualysGuard US QualysGuard EU ログインする API サーバの URL QualysGuard API のドキュメント - API ユーザガイドおよびその他のドキュメントはアカウントの Resources 項から利用できます ( Help Resources API ) 注記 : ユーザが実行できる API 呼び出しにはサブスクリプションに基づく制限が設けられています詳細については QualysGuard API Limits を参照してください無断複写転載を禁じます 2013 年クォリスジャパン株式会社

2 VM スキャン結果の XML - 選択したアセットタグを表示する新しい要素脆弱性スキャン結果の XML にスキャン対象としてユーザが選択したアセットタグを表示する新しい要素が追加されました脆弱性スキャン結果の XML では scan-1.dtd が使用されますがこの DTD には新しいアセットタグ選択要素が含まれています scan-1.dtd はから入手できます (qualysapi.qualys.com はご使用のアカウントがある API サーバです ) 新しいアセットタグ選択要素 QualysGuard 7.8 ではレポート出力用 DTD(scan-1.dtd) に新しいタグ選択要素が含まれておりスキャン対象に含めるまたは対象から除外するようにユーザが選択したタグを表示しますアセットタグの選択は QualysGuard ユーザインタフェースを使用して行うことができます /SCAN/HEADER/ASSET_TAG_LIST (INCLUDED_TAGS, EXCLUDED_TAGS?) /SCAN/HEADER/ASSET_TAG_LIST/INCLUDED_TAGS/ASSET_TAG (#PCDATA) スキャン対象に含まれるアセットタグのリストです範囲が all の場合ホストがすべてのタグに一致することを意味します範囲が any の場合ホストが少なくとも 1 つのタグに一致することを意味します /SCAN/HEADER/ASSET_TAG_LIST/EXCLUDED_TAGS/ASSET_TAG (#PCDATA) スキャン対象から除外されるアセットタグのリストです範囲が all の場合ホストがすべてのタグに一致することを意味します範囲が any の場合ホストが少なくとも 1 つのタグに一致することを意味します脆弱性スキャン結果の XML 出力例?xml version="1.0" encoding="utf-8"? <!DOCTYPE SCAN SYSTEM " <SCAN value="scan/ " <HEADER <KEY value="username"user1</key <KEY value="company"<![cdata[qualys, Inc.]]</KEY <KEY value="date" t23:30:45z</key <KEY value="title"<![cdata[my Scan]]</KEY <KEY value="target"<![cdata[ , , , ]]</KEY <KEY value="excluded_target"<![cdata[n/a]]</key <KEY value="duration"00:08:17</key <KEY value="scan_host" (Scanner , Vulnerability Signatures )</KEY <KEY value="nbhost_alive"3</key QualysGuard API リリースノート 2

3 <KEY value="nbhost_total"4</key <KEY value="report_type"on-demand (default option profile)</key <KEY value="options"<![cdata[standard TCP port list, Standard UDP port list, parallel ML scaling disabled for appliances, Load balancer detection OFF, Windows Authentication ON, ICMP Host Discovery, Overall Performance: Normal, Hosts to Scan in Parallel - External Scanners: 15, Hosts to Scan in Parallel - Scanner Appliances: 30, Total Processes to Run in Parallel: 10, HTTP Processes to Run in Parallel: 10, Packet (Burst) Delay: Medium, Intensity: Normal]]</KEY <KEY value="status"finished</key <ASSET_TAG_LIST <INCLUDED_TAGS scope="any" <ASSET_TAG<![CDATA[Windows XP]]</ASSET_TAG <ASSET_TAG<![CDATA[Windows 2008]]</ASSET_TAG </INCLUDED_TAGS <EXCLUDED_TAGS scope="any" <ASSET_TAG<![CDATA[Finance]]</ASSET_TAG </EXCLUDED_TAGS </ASSET_TAG_LIST <OPTION_PROFILE <OPTION_PROFILE_TITLE option_profile_default="1"<![cdata[first Scan]]</OPTION_PROFILE_TITLE </OPTION_PROFILE </HEADER <IP value=" " name="com-xpsp " <OS<![CDATA[Windows XP]]</OS <NETBIOS_HOSTNAME<![CDATA[COM-XPSP ]]</NETBIOS_HOSTNAME <INFOS <CAT value="tcp/ip" <INFO number="82040" severity="1" <TITLE<![CDATA[ICMP Replies Received]]</TITLE <LAST_UPDATE<![CDATA[ T20:14:30Z]]</LAST_UPDATE <PCI_FLAG0</PCI_FLAG <DIAGNOSIS<![CDATA[ICMP (Internet Control and Error Message Protocol) is a protocol encapsulated in IP packets. ICMP's principal purpose is to provide a protocol layer that informs gateways of the interconnectivity and accessibility of other gateways or hosts. 脆弱性スキャン結果出力用 DTD 次の脆弱性スキャン結果出力用 DTD(scan-1.dtd) では新しい要素が太字で示されています <!-- QUALYS SCAN DTD -- <!ELEMENT SCAN ((HEADER ERROR IP)+) <!ATTLIST SCAN value CDATA #REQUIRED QualysGuard API リリースノート 3

4 <!ELEMENT ERROR (#PCDATA) <!ATTLIST ERROR number CDATA #IMPLIED <!-- INFORMATION ABOUT THE SCAN -- <!ELEMENT HEADER (KEY+, ASSET_GROUPS?, ASSET_TAG_LIST?, OPTION_PROFILE?) <!ELEMENT KEY (#PCDATA) <!ATTLIST KEY value CDATA #IMPLIED <!-- NAME of the asset group with the TYPE attribute with possible values of (DEFAULT EXTERNAL ISCANNER) -- <!ELEMENT ASSET_GROUP (ASSET_GROUP_TITLE) <!ELEMENT ASSET_GROUPS (ASSET_GROUP+) <!ELEMENT ASSET_GROUP_TITLE (#PCDATA) <!ELEMENT OPTION_PROFILE (OPTION_PROFILE_TITLE) <!ELEMENT OPTION_PROFILE_TITLE (#PCDATA) <!ATTLIST OPTION_PROFILE_TITLE option_profile_default CDATA #IMPLIED <!-- TAGSET -- <!ELEMENT ASSET_TAG_LIST (INCLUDED_TAGS?, EXCLUDED_TAGS?) <!ELEMENT INCLUDED_TAGS (ASSET_TAG+) <!ELEMENT EXCLUDED_TAGS (ASSET_TAG+) <!ELEMENT ASSET_TAG (#PCDATA) <!ATTLIST INCLUDED_TAGS scope (any all) #REQUIRED <!ATTLIST EXCLUDED_TAGS scope (any all) #REQUIRED <!-- IP -- <!ELEMENT IP (OS?, OS_CPE?, NETBIOS_HOSTNAME?, INFOS?, SERVICES?, VULNS?, PRACTICES?) <!ATTLIST IP value CDATA #REQUIRED name CDATA #IMPLIED status CDATA #IMPLIED <!ELEMENT OS (#PCDATA) <!ELEMENT OS_CPE (#PCDATA) <!ELEMENT NETBIOS_HOSTNAME (#PCDATA) <!-- CATEGORIES OF INFO, SERVICE, VULN or PRACTICE -- <!ELEMENT CAT (INFO+ SERVICE+ VULN+ PRACTICE+) <!ATTLIST CAT value CDATA #REQUIRED fqdn CDATA #IMPLIED port CDATA #IMPLIED protocol CDATA #IMPLIED QualysGuard API リリースノート 4

5 misc CDATA #IMPLIED <!-- IP INFORMATIONS -- <!ELEMENT INFOS (CAT)+ <!ELEMENT INFO (TITLE, LAST_UPDATE?, PCI_FLAG, VENDOR_REFERENCE_LIST?, CVE_ID_LIST?, BUGTRAQ_ID_LIST?, DIAGNOSIS?, DIAGNOSIS_COMMENT?, CONSEQUENCE?, CONSEQUENCE_COMMENT?, SOLUTION?, SOLUTION_COMMENT?, COMPLIANCE?, CORRELATION?, RESULT?) <!ATTLIST INFO severity CDATA #IMPLIED standard-severity CDATA #IMPLIED number CDATA #IMPLIED <!-- MAP OF SERVICES -- <!ELEMENT SERVICES (CAT)+ <!ELEMENT SERVICE (TITLE, LAST_UPDATE?, PCI_FLAG, VENDOR_REFERENCE_LIST?, CVE_ID_LIST?, BUGTRAQ_ID_LIST?, DIAGNOSIS?, DIAGNOSIS_COMMENT?, CONSEQUENCE?, CONSEQUENCE_COMMENT?, SOLUTION?, SOLUTION_COMMENT?, COMPLIANCE?, CORRELATION?, RESULT?) <!ATTLIST SERVICE severity CDATA #REQUIRED standard-severity CDATA #IMPLIED number CDATA #IMPLIED <!-- VULNERABILITIES -- <!ELEMENT VULNS (CAT)+ <!ELEMENT VULN (TITLE, LAST_UPDATE?, CVSS_BASE?, CVSS_TEMPORAL?, PCI_FLAG, VENDOR_REFERENCE_LIST?, CVE_ID_LIST?, BUGTRAQ_ID_LIST?, DIAGNOSIS?, DIAGNOSIS_COMMENT?, CONSEQUENCE?, CONSEQUENCE_COMMENT?, SOLUTION?, SOLUTION_COMMENT?, COMPLIANCE?, CORRELATION?, RESULT?) <!-- number is Qualys numeric ID -- <!-- cveid is the CVE identification code (if any) -- <!-- severity is Qualys severity level 1 to 5 (possibly customized) -- <!-- standard-severity is the original Qualys severity level 1 to 5 if it has been customized by the user -- <!ATTLIST VULN number CDATA #REQUIRED cveid CDATA #IMPLIED severity CDATA #REQUIRED standard-severity CDATA #IMPLIED <!-- Required Element -- <!ELEMENT TITLE (#PCDATA) QualysGuard API リリースノート 5

6 <!-- Optional Elements -- <!ELEMENT LAST_UPDATE (#PCDATA) <!ELEMENT CVSS_BASE (#PCDATA) <!ATTLIST CVSS_BASE source CDATA #IMPLIED <!ELEMENT CVSS_TEMPORAL (#PCDATA) <!ELEMENT PCI_FLAG (#PCDATA) <!ELEMENT VENDOR_REFERENCE_LIST (VENDOR_REFERENCE+) <!ELEMENT VENDOR_REFERENCE (ID,URL) <!ELEMENT ID (#PCDATA) <!ELEMENT URL (#PCDATA) <!ELEMENT CVE_ID_LIST (CVE_ID+) <!ELEMENT CVE_ID (ID,URL) <!ELEMENT BUGTRAQ_ID_LIST (BUGTRAQ_ID+) <!ELEMENT BUGTRAQ_ID (ID,URL) <!ELEMENT DIAGNOSIS (#PCDATA) <!ELEMENT DIAGNOSIS_COMMENT (#PCDATA) <!ELEMENT CONSEQUENCE (#PCDATA) <!ELEMENT CONSEQUENCE_COMMENT (#PCDATA) <!ELEMENT SOLUTION (#PCDATA) <!ELEMENT SOLUTION_COMMENT (#PCDATA) <!ELEMENT COMPLIANCE (COMPLIANCE_INFO+) <!ELEMENT COMPLIANCE_INFO (COMPLIANCE_TYPE, COMPLIANCE_SECTION, COMPLIANCE_DESCRIPTION) <!ELEMENT COMPLIANCE_TYPE (#PCDATA) <!ELEMENT COMPLIANCE_SECTION (#PCDATA) <!ELEMENT COMPLIANCE_DESCRIPTION (#PCDATA) <!ELEMENT CORRELATION (EXPLOITABILITY?,MALWARE?) <!ELEMENT EXPLOITABILITY (EXPLT_SRC)+ <!ELEMENT EXPLT_SRC (SRC_NAME, EXPLT_LIST) <!ELEMENT SRC_NAME (#PCDATA) <!ELEMENT EXPLT_LIST (EXPLT)+ <!ELEMENT EXPLT (REF, DESC, LINK?) <!ELEMENT REF (#PCDATA) <!ELEMENT DESC (#PCDATA) <!ELEMENT LINK (#PCDATA) <!ELEMENT MALWARE (MW_SRC)+ <!ELEMENT MW_SRC (SRC_NAME, MW_LIST) QualysGuard API リリースノート 6

7 <!ELEMENT MW_LIST (MW_INFO)+ <!ELEMENT MW_INFO (MW_ID, MW_TYPE?, MW_PLATFORM?, MW_ALIAS?, MW_RATING?, MW_LINK?) <!ELEMENT MW_ID (#PCDATA) <!ELEMENT MW_TYPE (#PCDATA) <!ELEMENT MW_PLATFORM (#PCDATA) <!ELEMENT MW_ALIAS (#PCDATA) <!ELEMENT MW_RATING (#PCDATA) <!ELEMENT MW_LINK (#PCDATA) <!-- if format is set to "table" -- <!-- tab '\t' is the col separator -- <!-- and new line '\n' is the end of row -- <!ELEMENT RESULT (#PCDATA) <!ATTLIST RESULT format CDATA #IMPLIED <!-- SECURITY TIPS -- <!ELEMENT PRACTICES (CAT+) <!ELEMENT PRACTICE (TITLE, LAST_UPDATE?, CVSS_BASE?, CVSS_TEMPORAL?, PCI_FLAG, VENDOR_REFERENCE_LIST?, CVE_ID_LIST?, BUGTRAQ_ID_LIST?, DIAGNOSIS?, DIAGNOSIS_COMMENT?, CONSEQUENCE?, CONSEQUENCE_COMMENT?, SOLUTION?, SOLUTION_COMMENT?, COMPLIANCE?, CORRELATION?, RESULT?) <!ATTLIST PRACTICE number CDATA #REQUIRED cveid CDATA #IMPLIED severity CDATA #REQUIRED standard-severity CDATA #IMPLIED <!-- EOF -- QualysGuard API リリースノート 7

8 アセット IP API v1 - CIDR 形式のサポートとクラス A の IP アドレスの追加アセット IP API v1 - CIDR 形式のサポートとクラス A の IP アドレスの追加アセット IP API v1(/msp/asset_ip.php) を使用するとユーザはサブスクリプション内のホストアセットと関連データの追加と編集が可能になりますこのリリースでは次の拡張が追加されました単一のアセット IP リクエストを使用してクラス A ネットワークの IP アドレスを追加または編集できます 1 回のリクエストで最大 16,777,216 個の IP を追加または編集できますホストの指定には CIDR 記法を使用できます次のアセット API リクエストではクラス A ネットワークのホスト (16,777,216 個の IP) をユーザのサブスクリプションに追加します host_ips パラメータには CIDR 記法が使用されています次に新しい IP がアカウントに追加されたことを確認するために IP リスト API v2 リクエスト (/api/2.0/fo/asset/ip) を行いますアセット API v1 リクエスト : " host_ips= /8" XML 出力 : <?xml version="1.0" encoding="utf-8"? <!DOCTYPE GENERIC_RETURN SYSTEM " <GENERIC_RETURN <API name="asset_ip.php" username="user1" at=" t10:15:28z" / <RETURN status="success" The operation was successfully completed. </RETURN </GENERIC_RETURN IP リスト API v2 リクエスト : " XML 出力 : <!DOCTYPE IP_LIST_OUTPUT SYSTEM " <IP_LIST_OUTPUT <RESPONSE <DATETIME T10:20:01Z</DATETIME <IP_SET <IP_RANGE </IP_RANGE </IP_SET </RESPONSE </IP_LIST_OUTPUT QualysGuard API リリースノート 8

9 検出 API v2 - 実行されていないカーネルで見つかった脆弱性を除外検出 API v2 - 実行されていないカーネルで見つかった脆弱性を除外検出 API v2(/api/2.0/fo/asset/host/vm/detection/) を使用すると自動処理が可能な脆弱性検出データを取得してサードパーティ製のソリューションに簡単にインポートできます QualysGuard 7.8 では新しい active_kernels_only=1 パラメータを指定することで実行されていない Linux カーネルで見つかった脆弱性を XML 出力から除外できますこの新しいパラメータはサブスクリプションで New Data Security Model が有効になっているユーザが使用できます次の API リクエストではホストの検出レコードのリストが返されますが実行されていない Linux カーネルで見つかった脆弱性は XML 出力には含まれていません API リクエスト : " ctive_kernels_only=1" 動作方法 : 1 つの Linux ホストで複数のカーネルが検出されることもありますスキャン結果は QID の収集情報における各 Linux ホストで実行されているカーネルをレポートします active_kernels_only=1 で検出 API リクエストを行うと XML 出力には実行中のカーネルで見つかった脆弱性のみが含まれます QualysGuard API リリースノート 9

DTD Reference Guide

DTD Reference Guide 脆弱性スキャン結果の XML 出力脆弱性スキャンの結果はスキャン履歴リストから XML 形式でダウンロードできます XML 形式の脆弱性スキャン結果にはその他のサポートされている形式 (PDF HTML MHT および CSV) の脆弱性スキャン結果と同じ内容が表示されますスキャン結果レポートにはサマリとホストベースの結果が表示されますヘッダの項のレポートサマリではスキャンをリクエストしたユーザ