API サーバの URL. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE COMPLIANCE_SCAN SYSTEM "

Size: px

Start display at page:

Download "API サーバの URL. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE COMPLIANCE_SCAN SYSTEM ""

Rosemary Welch
5 years ago
Views:

1 Policy Compliance PC スキャン結果の XML Policy Compliance(PC) スキャンの結果はユーザインタフェースのスキャン履歴リストから XML 形式でダウンロードできます UI からダウンロードした XML 形式の PC スキャン結果にはその他のサポートされている形式 (PDF HTML MHT および CSV) の PC スキャン結果と同じ内容が表示されます compliance_scan.dtd は PC スキャン結果の XML 出力と関連付けられていますこの DTD はアカウントの場所に対応した API サーバ URL にありますアカウントの場所 US プラットフォーム EU プラットフォームプライベートクラウドプラットフォーム API サーバの URL 重要 :PC スキャン API v2(/api/2.0/fo/scan/compliance/?action=fetch) を使用して PC スキャン結果をダウンロードした場合スキャン結果の XML では別の DTD(compliance_scan_result_output.dtd) が使用されますこの DTD の詳細については API v2 ユーザガイドを参照してください PC スキャン結果の例以下は PC スキャン結果が示されている XML 出力の例です <AUTH_STATUS_ISSUES> 要素に認証ステータスの問題が示されています <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE COMPLIANCE_SCAN SYSTEM " <COMPLIANCE_SCAN> <HEADER> <NAME><![CDATA[Compliance Scan Results]]></NAME> <GENERATION_DATETIME> T17:39:03Z</GENERATION_DATETIME> <COMPANY_INFO> <NAME><![CDATA[Qualys]]></NAME> <ADDRESS><![CDATA[1600 Bridge Parkway]]></ADDRESS> <CITY><![CDATA[Redwood Shores]]></CITY> <STATE><![CDATA[California]]></STATE> <COUNTRY><![CDATA[United States]]></COUNTRY> <ZIP_CODE><![CDATA[94065]]></ZIP_CODE> </COMPANY_INFO> <USER_INFO> <NAME><![CDATA[USERNAME]]></NAME> <USERNAME>USER_LOGIN</USERNAME> <ROLE>Manager</ROLE> </USER_INFO> <KEY value="username">user_login</key> <KEY value="company"><![cdata[qualys]]></key> <KEY value="date"> t17:33:19z</key> <KEY value="title"><![cdata[my Compliance Scan]]></KEY> <KEY value="target"> , , , , , , , , , , , , , , </KEY> <KEY value="excluded_target"><![cdata[n/a]]></key> <KEY value="duration">01:12:02</key> <KEY value="scan_host"> (Scanner , Vulnerability Signatures )</KEY> <KEY value="nbhost_alive">13</key> <KEY value="nbhost_total">16</key> 無断複写転載を禁じます 2012 年クォリスジャパン株式会社 1

2 <KEY value="report_type">on-demand</key> <KEY value="options">scanned Ports: Targeted Scan, 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, Overall Performance: Normal, ICMP Host Discovery, Ignore RST packets: Off, Ignore firewall-generated SYN-ACK packets: Off, Do not send ACK or SYN-ACK packets during host discovery: Off</KEY> <KEY value="status">finished</key> <ASSET_GROUPS> <ASSET_GROUP> <ASSET_GROUP_TITLE><![CDATA[Authentication AG]]></ASSET_GROUP_TITLE> </ASSET_GROUP> </ASSET_GROUPS> <OPTION_PROFILE> <OPTION_PROFILE_TITLE option_profile_default="0"><![cdata[initial PC Options]]></OPTION_PROFILE_TITLE> </OPTION_PROFILE> </HEADER> <AUTH_SCAN_ISSUES> <AUTH_SCAN_FAILED> <DNS><![CDATA[u-wxp-10-25]]></DNS> <IP><![CDATA[ ]]></IP> <NETBIOS><![CDATA[U-WXP-10-25]]></NETBIOS> <CAUSE><![CDATA[Unable to complete Windows login for host= , <DNS><![CDATA[-]]></DNS> <IP><![CDATA[ ]]></IP> <CAUSE><![CDATA[Unable to complete login for host= , user=root]]></cause> <DNS><![CDATA[sparc2.corp.com]]></DNS> <IP><![CDATA[ ]]></IP> <CAUSE><![CDATA[Unable to complete login for host= , user=root]]></cause> <DNS><![CDATA[minimac-1.corp.com]]></DNS> <IP><![CDATA[ ]]></IP> <NETBIOS><![CDATA[OSX P]]></NETBIOS> <CAUSE><![CDATA[Unable to complete Windows login for host= , <DNS><![CDATA[2k8sp ]]></DNS> <IP><![CDATA[ ]]></IP> <NETBIOS><![CDATA[2K8SP ]]></NETBIOS> <CAUSE><![CDATA[Unable to complete Windows login for host= , PC スキャン結果の XML 2

3 <DNS><![CDATA[fdcc-rye7zlgzte]]></DNS> <IP><![CDATA[ ]]></IP> <NETBIOS><![CDATA[FDCC-RYE7ZLGZTE]]></NETBIOS> <CAUSE><![CDATA[Unable to complete Windows login for host= , <DNS><![CDATA[dhcp-38.corp.com]]></DNS> <IP><![CDATA[ ]]></IP> <NETBIOS><![CDATA[DHCP-38]]></NETBIOS> <CAUSE><![CDATA[Unable to complete Windows login for host= , </AUTH_SCAN_FAILED> <AUTH_SCAN_INSUFFICIENT> <DNS><![CDATA[cisco2600.corp.com]]></DNS> <IP><![CDATA[ ]]></IP> <CAUSE><![CDATA[Insufficient privileges]]></cause> <DNS><![CDATA[-]]></DNS> <IP><![CDATA[ ]]></IP> <CAUSE><![CDATA[Insufficient privileges]]></cause>... </AUTH_SCAN_INSUFFICIENT> </AUTH_SCAN_ISSUES> <APPENDIX> <TARGET_HOSTS> <HOSTS_SCANNED> , , , , , , , , , , , , </HOSTS_SCANNED> <HOSTS_NOT_ALIVE> , , </HOSTS_NOT_ALIVE> </TARGET_HOSTS> <TARGET_DISTRIBUTION> <SCANNER> <NAME><![CDATA[My_Scanner]]></NAME> <HOSTS> , , , , , , , , , , , , , , </HOSTS> </SCANNER> </TARGET_DISTRIBUTION> <AUTHENTICATION> <AUTH> <TYPE>Windows</TYPE> <FAILED> <IP> , , , , </IP> </FAILED> </AUTH> <AUTH> <TYPE>SSH</TYPE> PC スキャン結果の XML 3

4 <FAILED> <IP> , </IP> </FAILED> <SUCCESS> <IP> , , </IP> </SUCCESS> <INSUFFICIENT> <IP> , , , </IP> </INSUFFICIENT> </AUTH> </AUTHENTICATION> </APPENDIX> </COMPLIANCE_SCAN> PC スキャン結果出力用 DTD PC スキャン結果出力用 DTD(compliance_scan.dtd) を以下に示します  <!ELEMENT COMPLIANCE_SCAN (HEADER, ERROR?, AUTH_SCAN_ISSUES?, APPENDIX)> <!ELEMENT ERROR (#PCDATA)> <!ATTLIST ERROR number CDATA #IMPLIED >  <!ELEMENT KEY (#PCDATA)> <!ATTLIST KEY value CDATA #IMPLIED > <!ELEMENT HEADER (NAME, GENERATION_DATETIME, COMPANY_INFO, USER_INFO, KEY+, ASSET_GROUPS?, OPTION_PROFILE?)> <!ELEMENT NAME (#PCDATA)*> <!ELEMENT GENERATION_DATETIME (#PCDATA)*> <!ELEMENT COMPANY_INFO (NAME, ADDRESS, CITY, STATE, COUNTRY, ZIP_CODE)> <!ELEMENT ADDRESS (#PCDATA)> <!ELEMENT CITY (#PCDATA)> <!ELEMENT STATE (#PCDATA)> <!ELEMENT COUNTRY (#PCDATA)> <!ELEMENT ZIP_CODE (#PCDATA)> <!ELEMENT USER_INFO (NAME, USERNAME, ROLE)> <!ELEMENT USERNAME (#PCDATA)*> <!ELEMENT ROLE (#PCDATA)*>  <!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 > <!ELEMENT AUTH_SCAN_ISSUES (AUTH_SCAN_FAILED*, AUTH_SCAN_INSUFFICIENT*)> <!ELEMENT AUTH_SCAN_FAILED (HOST_INFO*)> <!ELEMENT AUTH_SCAN_INSUFFICIENT (HOST_INFO*)> PC スキャン結果の XML 4

5 <!ELEMENT HOST_INFO (DNS, IP, NETBIOS, INSTANCE, CAUSE)> <!ELEMENT DNS (#PCDATA)> <!ELEMENT IP (#PCDATA)> <!ELEMENT NETBIOS (#PCDATA)> <!ELEMENT INSTANCE (#PCDATA)> <!ELEMENT CAUSE (#PCDATA)> <!ELEMENT APPENDIX (TARGET_HOSTS?, TARGET_DISTRIBUTION?, AUTHENTICATION?)> <!ELEMENT TARGET_HOSTS (HOSTS_SCANNED?, EXCLUDED_HOSTS?, HOSTS_NOT_ALIVE?, PAUSE_CANCEL_ACTION?, HOSTNAME_NOT_FOUND?, HOSTS_SCAN_ABORTED?)> <!ELEMENT HOSTS_SCANNED (#PCDATA)> <!ELEMENT HOSTNAME_NOT_FOUND (#PCDATA)> <!ELEMENT EXCLUDED_HOSTS (#PCDATA)> <!ELEMENT HOSTS_NOT_ALIVE (#PCDATA)> <!ELEMENT HOSTS_SCAN_ABORTED (#PCDATA)> <!ELEMENT PAUSE_CANCEL_ACTION (HOSTS, ACTION, BY)> <!ELEMENT ACTION (#PCDATA)> <!ELEMENT BY (#PCDATA)> <!ELEMENT TARGET_DISTRIBUTION (SCANNER+)> <!ELEMENT SCANNER (NAME, HOSTS)> <!ELEMENT HOSTS (#PCDATA)> <!ELEMENT AUTHENTICATION (AUTH+)> <!ELEMENT AUTH (TYPE?, (FAILED SUCCESS INSUFFICIENT)+)> <!ELEMENT TYPE (#PCDATA)> <!ELEMENT FAILED (IP,INSTANCE?)> <!ELEMENT SUCCESS (IP,INSTANCE?)> <!ELEMENT INSUFFICIENT (IP,INSTANCE?)>  PC スキャン結果の XPath この項では PC スキャン結果の出力 (compliance_scan.dtd) の XPath について説明します XPath /COMPLIANCE_SCAN /COMPLIANCE_SCAN/HEADER 要素の仕様 / 注記 (HEADER, ERROR?, AUTH_SCAN_ISSUES?, APPENDIX) (NAME, GENERATION_DATETIME, COMPANY_INFO, USER_INFO, KEY+, ASSET_GROUPS?, OPTION_PROFILE?) /COMPLIANCE_SCAN/HEADER/NAME (#PCDATA) PC スキャンのタイトル /COMPLIANCE_SCAN/HEADER/GENERATION_DATETIME (#PCDATA) スキャンが開始された日時 /COMPLIANCE_SCAN/HEADER/COMPANY_INFO (NAME, ADDRESS, CITY, STATE, COUNTRY, ZIP_CODE) スキャンを開始したユーザの会社名と住所 /COMPLIANCE_SCAN/HEADER/USER_INFO (NAME, USERNAME, ROLE) /COMPLIANCE_SCAN/HEADER/USER_INFO/NAME (#PCDATA) スキャンを開始したユーザの名前 PC スキャン結果の XML 5

6 XPath 要素の仕様 / 注記 /COMPLIANCE_SCAN/HEADER/USER_INFO/USERNAME (#PCDATA) スキャンを開始したユーザのログイン名 /COMPLIANCE_SCAN/HEADER/USER_INFO/ROLE (#PCDATA) /COMPLIANCE_SCAN/HEADER/ASSET_GROUP スキャンを開始したユーザのロール (ASSET_GROUP_TITLE) /COMPLIANCE_SCAN/HEADER/ASSET_GROUP/ASSET_GROUP_TITLE (#PCDATA) /COMPLIANCE_SCAN/HEADER/OPTION_PROFILE スキャンされたアセットグループのタイトル (OPTION_PROFILE_TITLE) /COMPLIANCE_SCAN/HEADER/OPTION_PROFILE/OPTION_PROFILE_TITLE (#PCDATA) スキャンに使用されたオプションプロファイルのタイトル属性 option_profile_default は 0 に設定されこれがデフォルトのオプションプロファイルではないことを示しています /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES (AUTH_SCAN_FAILED*, AUTH_SCAN_INSUFFICIENT*) /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED (HOST_INFO*) /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED /HOST_INFO (DNS, IP, NETBIOS, INSTANCE, CAUSE) /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED/HOST_INFO/DNS (#PCDATA) 認証に失敗したホストの DNS ホスト名 /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED/HOST_INFO/IP (#PCDATA) 認証に失敗したホストの IP アドレス /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED/HOST_INFO/NETBIOS (#PCDATA) 認証に失敗したホストの NetBIOS 名 /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED/HOST_INFO/INSTANCE (#PCDATA) スキャンが実行されたインスタンスオペレーティングシステム ( 例 : os ) のほかデータベース Active Directory などです同じオペレーティングシステム内でも複数のデータベースインスタンスが実行されていることがありますその場合 Oracle データベース SID やポート ( 例 : oracle:1:1521:oracle) などの複数の文字列でインスタンスが一意に識別されます /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_FAILED/HOST_INFO/CAUSE (#PCDATA) ホストの認証が失敗した理由 /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT (HOST_INFO*) /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO* /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO (DNS, IP, NETBIOS, INSTANCE, CAUSE) /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO/DNS (#PCDATA) 権限不足のため認証に失敗したホストの DNS ホスト名 /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO/IP (#PCDATA) 権限不足のため認証に失敗したホストの IP アドレス /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO/NETBIOS (#PCDATA) 権限不足のため認証に失敗したホストの NetBIOS 名 /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO/INSTANCE (#PCDATA) スキャンが実行されたインスタンス /COMPLIANCE_SCAN/AUTH_SCAN_ISSUES /AUTH_SCAN_INSUFFICIENT/HOST_INFO/CAUSE (#PCDATA) Insufficient privileges という説明が表示されます PC スキャン結果の XML 6

7 XPath 要素の仕様 / 注記 /COMPLIANCE_SCAN/APPENDIX /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS (TARGET_HOSTS?, TARGET_DISTRIBUTION?, AUTHENTICATION?) (HOSTS_SCANNED?, EXCLUDED_HOSTS?, HOSTS_NOT_ALIVE?, PAUSE_CANCEL_ACTION?, HOSTNAME_NOT_FOUND?, HOSTS_SCAN_ABORTED?) /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/HOSTS_SCANNED (#PCDATA) 正常にスキャンされたスキャン対象のホスト /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/HOSTNAME_NOT_FOUND (#PCDATA) 見つからずスキャンされなかった対象のホスト /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/EXCLUDED_HOSTS (#PCDATA) スキャンから除外された対象のホスト /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/HOSTS_NOT_ALIVE (#PCDATA) 稼働していないことが判明した対象のホスト /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/HOSTS_SCAN_ABORTED (#PCDATA) 認証に成功したもののネットワーク障害などのさまざまな理由でスキャンが中断されたためにスキャンされなかった対象のホスト /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/PAUSE_CANCEL_ACTION (HOSTS, ACTION, BY) /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/PAUSE_CANCEL_ACTION/ACTION (#PCDATA) ユーザが実行したアクション ( 一時停止またはキャンセル ) /COMPLIANCE_SCAN/APPENDIX/TARGET_HOSTS/PAUSE_CANCEL_ACTION/BY (#PCDATA) スキャンを一時停止またはキャンセルしたユーザ /COMPLIANCE_SCAN/APPENDIX/TARGET_DISTRIBUTION (SCANNER+) /COMPLIANCE_SCAN/APPENDIX/TARGET_DISTRIBUTION/SCANNER (NAME, HOSTS) /COMPLIANCE_SCAN/APPENDIX/TARGET_DISTRIBUTION/SCANNER/NAME(#PCDATA) スキャンの実行に使用された Scanner Appliance の名前 /COMPLIANCE_SCAN/APPENDIX/TARGET_DISTRIBUTION/SCANNER/HOSTS (#PCDATA) /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION スキャンの実行に使用された Scanner Appliance でスキャンされたホスト (AUTH+) /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION/AUTH (TYPE?, (FAILED SUCCESS INSUFFICIENT)+) /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION/AUTH /TYPE (#PCDATA) このスキャンの実行に使用された認証タイプ /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION/AUTH /FAILED (IP, INSTANCE?) 当該認証タイプの認証に失敗した IP アドレス /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION/AUTH /SUCCESS (IP, INSTANCE?) 当該認証タイプの認証に成功した IP アドレス /COMPLIANCE_SCAN/APPENDIX/AUTHENTICATION/AUTH /INSUFFICIENT (IP, INSTANCE?) 権限不足のため当該認証タイプの認証に失敗した IP アドレス PC スキャン結果の XML 7

本書について... 7 本文中の表記について... 7 マークについて... 7 MTCE をインストールする前に... 7 ご注意... 7 推奨 PC 仕様... 8 MTCE をインストールする... 9 MTCE をアンインストールする... 11

本書について... 7 本文中の表記について... 7 マークについて... 7 MTCE をインストールする前に... 7 ご注意... 7 推奨 PC 仕様... 8 MTCE をインストールする... 9 MTCE をアンインストールする... 11 Installation Guide FOR English 2 About this guide... 2 Notations used in this document... 2 Symbols... 2 Before installing MTCE... 2 Notice... 2 Recommended computer specifications... 3 Installing MTCE...