NIST IR 7692 日本語訳
英語タイトル : Specification for the Open Checklist Interactive Language (OCIL) Version 2.0日本語タイトル : Open Checklist Interactive Language(OCIL)バージョン 2.0 の仕様
公開日 : 2011-04-07
原文URL : https://csrc.nist.gov/pubs/ir/7692/final
翻訳編集 : 自動生成(有志による非公式の日本語訳), 原文取得日 : 2026-10-31, 訳文 : 433 / 447 ブロック
[要約] NIST IR 7692 は、Open Checklist Interactive Language(OCIL)のバージョン 2.0 を定義する報告書です。OCIL の意図は、質問票と、質問への回答や質問票の最終結果などの関連情報を表現するための標準化された基盤を提供し、質問票が標準化された機械可読な方法で人間とやり取りできるようにすることです。OCIL 文書は Extensible Markup Language(XML)に基づいており、本書はデータモデルの概要、コンテンツ設計の要件と推奨事項、処理要件を示します。また、OCIL 2.0 仕様への適合を主張する IT 製品と OCIL 文書が満たさなければならない要件を定義し、説明します。
[NIST のロゴ。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]
NIST Interagency Report 7692
NIST省庁間報告書 7692
Specification for the Open Checklist Interactive Language (OCIL) Version 2.0
Open Checklist Interactive Language(OCIL)バージョン 2.0 の仕様
David Waltermire
Karen Scarfone
Maria Casipe
David Waltermire
Karen Scarfone
Maria Casipe
NIST Interagency Report 7692
NIST省庁間報告書 7692
Specification for the Open Checklist Interactive Language (OCIL) Version 2.0
Open Checklist Interactive Language(OCIL)バージョン 2.0 の仕様
David Waltermire
Karen Scarfone
Maria Casipe
David Waltermire
Karen Scarfone
Maria Casipe
COMPUTER SECURITY
コンピュータセキュリティ
Computer Security Division
Information Technology Laboratory
National Institute of Standards and Technology
Gaithersburg, MD 20899-8930
Computer Security Division
Information Technology Laboratory
National Institute of Standards and Technology
Gaithersburg, MD 20899-8930
April 2011
2011 年 4 月
U.S. Department of Commerce
米国商務省
Gary Locke, Secretary
Gary Locke 長官
National Institute of Standards and Technology
National Institute of Standards and Technology
Dr. Patrick D. Gallagher, Director
Dr. Patrick D. Gallagher、所長
Reports on Computer Systems Technology
コンピュータシステム技術に関する報告書
The Information Technology Laboratory (ITL) at the National Institute of Standards and Technology (NIST) promotes the U.S. economy and public welfare by providing technical leadership for the nation’s measurement and standards infrastructure. ITL develops tests, test methods, reference data, proof of concept implementations, and technical analysis to advance the development and productive use of information technology. ITL’s responsibilities include the development of technical, physical, administrative, and management standards and guidelines for the cost-effective security and privacy of sensitive unclassified information in Federal computer systems. This Interagency Report discusses ITL’s research, guidance, and outreach efforts in computer security and its collaborative activities with industry, government, and academic organizations.
National Institute of Standards and Technology(NIST)の Information Technology Laboratory(ITL)は、国の測定・標準基盤に対する技術的リーダーシップを提供することにより、米国経済と公共の福祉を促進しています。ITL は、情報技術の開発と生産的な利用を進めるため、試験、試験方法、参照データ、概念実証の実装、技術分析を開発しています。ITL の責務には、連邦のコンピュータシステムにおける機微だが非機密の情報を費用対効果に優れた形で保護するための、技術的、物理的、管理的、マネジメント上の標準およびガイドラインの策定が含まれます。この Interagency Report は、コンピュータセキュリティにおける ITL の研究、ガイダンス、アウトリーチの取り組みと、産業界、政府、学術機関との共同活動について論じています。
National Institute of Standards and Technology Interagency Report 7692
39 pages (Apr. 2011)
National Institute of Standards and Technology Interagency Report 7692
39 ページ(2011 年 4 月)
Certain commercial entities, equipment, or materials may be identified in this document in order to describe an experimental procedure or concept adequately. Such identification is not intended to imply recommendation or endorsement by the National Institute of Standards and Technology, nor is it intended to imply that the entities, materials, or equipment are necessarily the best available for the purpose.
この文書では、実験の手順や概念を適切に説明するために、特定の商業的な組織、装置、資材が特定されている場合があります。このような特定は、National Institute of Standards and Technology による推奨や承認を意味するものではなく、それらの組織、資材、装置がその目的に必ずしも最善のものであることを意味するものでもありません。
Acknowledgments
謝辞
The authors, David Waltermire of NIST, Karen Scarfone of G2, Inc., and Maria Casipe of the MITRE Corporation, wish to thank their colleagues who reviewed drafts of this report and contributed to its technical content. The authors would like to acknowledge Paul Cichonski and Stephen Quinn of NIST; Charles Schmidt, Andrew Buttner, Jon Baker, Gerry McGuire, and John Wunder of the MITRE Corporation; Rhonda Farrell of Booz Allen Hamilton; and Glenn Strickland and George Saylor of G2, Inc. for their insights and support throughout the development of the report.
著者である NIST の David Waltermire、G2, Inc. の Karen Scarfone、MITRE Corporation の Maria Casipe は、この報告書のドラフトをレビューし、その技術的内容に貢献してくださった同僚の皆様に感謝します。報告書の作成全体を通じて洞察と支援をいただいた、NIST の Paul Cichonski と Stephen Quinn、MITRE Corporation の Charles Schmidt、Andrew Buttner、Jon Baker、Gerry McGuire、John Wunder、Booz Allen Hamilton の Rhonda Farrell、G2, Inc. の Glenn Strickland と George Saylor に謝意を表します。
Abstract
概要
This report defines version 2.0 of the Open Checklist Interactive Language (OCIL). The intent of OCIL is to provide a standardized basis for expressing questionnaires and related information, such as answers to questions and final questionnaire results, so that the questionnaires can use a standardized, machine-readable approach to interacting with humans and using information stored during previous data collection efforts. OCIL documents are Extensible Markup Language (XML) based. This report defines and explains the requirements that IT products and OCIL documents asserting conformance with the OCIL 2.0 specification must meet.
この報告書は、Open Checklist Interactive Language(OCIL)のバージョン 2.0 を定義します。OCIL の意図は、質問票と、質問への回答や質問票の最終結果などの関連情報を表現するための標準化された基盤を提供することにより、質問票が、標準化された機械可読な方法で人間とやり取りし、過去のデータ収集で保存された情報を利用できるようにすることです。OCIL 文書は Extensible Markup Language(XML)に基づいています。この報告書は、OCIL 2.0 仕様への適合を主張する IT 製品と OCIL 文書が満たさなければならない要件を定義し、説明します。
Audience
想定読者
The primary audiences for the OCIL specification are developers of IT products that could leverage OCIL’s capabilities and organizations that could take advantage of OCIL to improve questionnaire-based data gathering from people and from previous data collection efforts. NIST welcomes feedback from these groups on improving the OCIL specification.
OCIL 仕様の主な想定読者は、OCIL の機能を活用できる IT 製品の開発者と、OCIL を利用して、人々からの質問票ベースのデータ収集や、過去のデータ収集活動からのデータ収集を改善できる組織です。NIST は、OCIL 仕様の改善について、これらの方々からのフィードバックを歓迎します。
Table of Contents
目次
List of Figures and Tables
図表一覧
1. Introduction
1. はじめに
The Open Checklist Interactive Language (OCIL) defines a framework for expressing questionnaires that can be used by software to harvest information stored during previous data collection efforts or to collect information from people. OCIL allows organizations to author questionnaires in a standardized format that can be processed by a variety of software products. OCIL also includes constructs for representing such things as questions, instructions that guide users towards an answer, and submission of user-provided documents that provide evidence for responses.
Open Checklist Interactive Language(OCIL)は、ソフトウェアが過去のデータ収集で保存された情報を取り込んだり、人から情報を収集したりするために使用できる質問票を表現するためのフレームワークを定義します。OCIL により、組織は、さまざまなソフトウェア製品で処理できる標準化された形式で質問票を作成できます。OCIL には、質問、利用者を回答へ導く指示、回答の根拠となる利用者提供の文書の提出といったものを表現するための構成要素も含まれています。
OCIL facilitates uniform data collection and reporting. Other benefits of using OCIL include:
OCIL は、統一されたデータ収集と報告を容易にします。OCIL を使用するその他の利点には、次のものがあります。
•Performing every manual check in the same manner with all required steps followed, regardless of who performs the check.
•誰がチェックを実施するかにかかわらず、すべての手動チェックを、必要なすべての手順に従って同じ方法で実施すること。
•Allowing responses to manual checks to be reviewed for auditing purposes.
•手動チェックへの回答を、監査の目的でレビューできるようにすること。
•Fostering the development of standardized, interoperable capabilities in products for creating, evaluating, and supporting manual checks.
•手動チェックを作成、評価、支援するための、製品における標準化された相互運用可能な機能の開発を促進すること。
•Fostering collaboration among security-related communities in authoring and composing manual checks.
•手動チェックの作成と構成における、セキュリティ関連コミュニティ間の協力を促進すること。
•Enhancing the manageability of manual checks.
•手動チェックの管理性を高めること。
The original motivation for creating OCIL was for development of automated security checklist questionnaires for human interaction. OCIL can be used to help assess security controls related to people and processes when assessment is not feasible or possible with fully automated means. An example is asking users about their participation in security training as part of an automated approach to Federal Information Security Management Act (FISMA) compliance reporting or to support a standardized means for presenting information and evaluating users as part of a security awareness and training program. However, OCIL’s capabilities can be applied to collect human input on any topic. For instance, it can be used for authoring research surveys and academic course exams. OCIL can also be used to harvest information stored during previous data collection efforts and convert it to a standardized format, which can then more easily be aggregated with other data sources and accessed through a single interface, such as a dashboard. Many of the examples presented in this document are security-related, but this is not intended to imply any limitation on OCIL’s applicability.
OCIL を作成した当初の動機は、人とのやり取りのための自動化されたセキュリティチェックリスト質問票を開発することでした。OCIL は、完全な自動化手段では評価が実現可能でない、または不可能な場合に、人やプロセスに関連するセキュリティ管理策を評価するのに役立ちます。たとえば、Federal Information Security Management Act(FISMA)への準拠報告の自動化された手法の一環として、利用者にセキュリティトレーニングへの参加状況を尋ねる場合や、セキュリティ意識向上およびトレーニングのプログラムの一環として、利用者に情報を提示し評価するための標準化された手段を支援する場合です。ただし、OCIL の機能は、あらゆるトピックについて人からの入力を収集するために適用できます。たとえば、調査研究のアンケートや学術的な授業の試験を作成するために使用できます。OCIL は、過去のデータ収集で保存された情報を取り込んで標準化された形式に変換するためにも使用できます。変換された情報は、他のデータソースとより容易に集約でき、ダッシュボードなどの単一のインターフェースを通じてアクセスできます。この文書で示す例の多くはセキュリティに関連するものですが、これは OCIL の適用範囲に何らかの制限があることを意味するものではありません。
1.1 Purpose and Scope
1.1 目的と適用範囲
The purpose of this report is to define version 2.0 of OCIL. This report defines and explains the requirements that producers of OCIL-supporting software and OCIL documents (questionnaires) must meet to claim conformance with the OCIL 2.0 specification.
この報告書の目的は、OCIL のバージョン 2.0 を定義することです。この報告書は、OCIL をサポートするソフトウェアと OCIL 文書(質問票)の作成者が、OCIL 2.0 仕様への適合を主張するために満たさなければならない要件を定義し、説明します。
This report only applies to version 2.0 of OCIL. All other versions are out of the scope of this report.
この報告書が適用されるのは OCIL のバージョン 2.0 のみです。その他のバージョンはすべて、この報告書の適用範囲外です。
1.2 Document Structure
1.2 文書の構成
The remainder of this document is organized into the following major sections and appendices:
この文書の残りの部分は、次の主要な節と付録で構成されています。
•Section 2 defines terms used within this specification and provides a list of common acronyms and other abbreviations.
•第 2 節では、この仕様の中で使用する用語を定義し、一般的な略語やその他の短縮形の一覧を示します。
•Section 3 defines the conformance rules for this specification.
•第 3 節では、この仕様の適合性に関する規則を定義します。
•Section 4 provides an overview of related specifications and standards.
•第 4 節では、関連する仕様と標準の概要を示します。
•Section 5 presents the primary components of the OCIL data model.
•第 5 節では、OCIL データモデルの主要な構成要素を示します。
•Section 6 provides requirements and recommendations for OCIL content syntax, structures, and development.
•第 6 節では、OCIL コンテンツの構文、構造、開発に関する要件と推奨事項を示します。
•Section 7 describes OCIL document processing requirements.
•第 7 節では、OCIL 文書の処理要件を説明します。
•Appendix A discusses possible use cases for OCIL.
•付録 A では、OCIL の考えられるユースケースを論じます。
•Appendix B defines requirements for using OCIL as a check system for the eXtensible Configuration Checklist Description Format (XCCDF).
•付録 B では、eXtensible Configuration Checklist Description Format(XCCDF)のチェックシステムとして OCIL を使用するための要件を定義します。
1.3 Document Conventions
1.3 文書の表記規則
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in Request for Comment (RFC) 2119.1
この文書のキーワード "MUST"、"MUST NOT"、"REQUIRED"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、"RECOMMENDED"、"MAY"、"OPTIONAL" は、Request for Comment(RFC)2119 に記述されているとおりに解釈されるものとします。1
Text intended to represent computing system input, output, or algorithmic processing is presented in fixed-width Courier font.
コンピューティングシステムの入力、出力、またはアルゴリズム処理を表すことを意図したテキストは、等幅の Courier フォントで示します。
1.4 Feedback
1.4 フィードバック
OCIL currently does not address:
OCIL が現時点で扱っていないものは次のとおりです。
•A specific method for identifying the subject or role to present an OCIL-based assessment to. This might be addressed by another specification in the future.
•OCIL ベースの評価を提示する対象の主体または役割を特定するための具体的な方法。これは、将来、別の仕様で扱われる可能性があります。
•Specific guidelines on how to report on the evaluation of OCIL questionnaires relating to a population of IT assets
•IT 資産の母集団に関する OCIL 質問票の評価結果をどのように報告するかについての具体的なガイドライン
•A reference architecture for integrating OCIL with other XCCDF check systems to perform a more complete assessment of a checklist
•OCIL を他の XCCDF チェックシステムと統合して、チェックリストのより完全な評価を行うためのリファレンスアーキテクチャ
•Specific guidelines on using questionnaires to collect answers strictly for informational purposes, instead of for compliance purposes. Although OCIL has no requirements that it be used for compliance purposes only, its statuses and results are oriented toward compliance goals, and informational use cases are not explicitly addressed in this specification.
•準拠の目的ではなく、純粋に情報提供の目的で回答を収集するために質問票を使用する際の具体的なガイドライン。OCIL には、準拠の目的のみに使用することを求める要件はありませんが、そのステータスと結果は準拠の目標に向けて作られており、情報提供のユースケースはこの仕様では明示的に扱われていません。
•A method for applying a digital signature to OCIL results. Because the current OCIL data model does not address this, it is assumed that digital signatures should be handled external to the OCIL data model.
•OCIL の結果にデジタル署名を適用する方法。現在の OCIL データモデルはこれを扱っていないため、デジタル署名は OCIL データモデルの外部で扱うべきです。
The development of OCIL as a language strongly depends on community response, suggestions, and feedback. Feedback in these and any other areas is needed in order to improve OCIL in future revisions of this report. Thus, the authors welcome your comments about the OCIL specification. They can be reached at ocil-comments@nist.gov.
言語としての OCIL の発展は、コミュニティからの反応、提案、フィードバックに大きく依存しています。この報告書の今後の改訂で OCIL を改善するには、これらの分野やその他の分野に関するフィードバックが必要です。そのため、著者は OCIL 仕様に関する皆様のコメントを歓迎します。連絡先は ocil-comments@nist.gov です。
2. Definitions and Acronyms
2. 定義と略語
This section defines selected terms and acronyms used within the document.
この節では、この文書で使用する用語と略語のうち、主なものを定義します。
2.1 Definitions
2.1 定義
The definitions below are for the basic elements of OCIL content. Other terms are defined throughout the rest of the publication.
以下の定義は、OCIL コンテンツの基本要素に関するものです。その他の用語は、この刊行物の残りの部分で定義しています。
artifact: A piece of evidence, such as text or a reference to a resource, that is submitted to support a response to a question.
artifact: 質問への回答を裏付けるために提出される、テキストやリソースへの参照などの証拠。
question: The text of a question to pose, optionally accompanied by instructions to help guide a person to a response.
question: 提示する質問のテキスト。必要に応じて、人が回答に至るのを助ける指示が添えられます。
questionnaire: A sequence of questions to be used in determining a state or condition.
questionnaire: ある状態や状況を判断するために使用する、一連の質問。
results: All data acquired from using a questionnaire, such as the answers to individual questions and the final result for the entire questionnaire.
results: 質問票の使用によって得られるすべてのデータ。個々の質問への回答や、質問票全体の最終結果など。
test action: The action to be performed based on the response to a particular question. Examples of test actions are asking another question or calculating a result.
test action: 特定の質問への回答に基づいて実行されるアクション。テストアクションの例には、別の質問をすることや、結果を算出することがあります。
variable: A logical entity that holds a single value.
variable: 単一の値を保持する論理的なエンティティ。
2.2 Acronyms
2.2 略語
| API | Application Programming Interface |
|---|---|
| CCE | Common Configuration Enumeration |
| CPE | Common Platform Enumeration |
| CSRC | Computer Security Resource Center |
| CVE | Common Vulnerabilities and Exposures |
| FISMA | Federal Information Security Management Act |
| IR | Interagency Report |
| IT | Information Technology |
| ITL | Information Technology Laboratory |
| MIME | Multipurpose Internet Mail Extensions |
| NIST | National Institute of Standards and Technology |
| OCIL | Open Checklist Interactive Language |
| OMB | Office of Management and Budget |
| OVAL | Open Vulnerability and Assessment Language |
| PCI-DSS | Payment Card Industry Data Security Standard |
| RFC | Request for Comment |
| SP | Special Publication |
| URL | Uniform Resource Locator |
| XCCDF | eXtensible Configuration Checklist Description Format |
| XML | eXtensible Markup Language |
| API | アプリケーションプログラミングインターフェース |
|---|---|
| CCE | 共通構成列挙 |
| CPE | 共通プラットフォーム列挙 |
| CSRC | コンピューターセキュリティリソースセンター |
| CVE | 共通脆弱性および露出 |
| FISMA | 連邦情報セキュリティ管理法 |
| IR | 省庁間報告書 |
| IT | 情報技術 |
| ITL | 情報技術研究所 |
| MIME | 多目的インターネットメール拡張 |
| NIST | 米国国立標準技術研究所 |
| OCIL | オープンチェックリスト対話型言語 |
| OMB | 行政管理予算局 |
| OVAL | オープン脆弱性評価言語 |
| PCI-DSS | ペイメントカード業界データセキュリティ基準 |
| RFC | コメント募集 |
| SP | 特別刊行物 |
| URL | 統一資源位置指定子 |
| XCCDF | 拡張可能構成チェックリスト記述形式 |
| XML | 拡張可能マークアップ言語 |
3. Conformance
3. 適合性
Products and organizations may want to claim conformance with this specification for a variety of reasons. For example, a software vendor may want to assert that its product uses OCIL content properly and can interoperate with any other product using proper OCIL content. Another example is a policy mandating that an organization use OCIL for documenting and executing security audit questionnaires, as well as storing their results.
製品や組織は、さまざまな理由から、この仕様への適合を主張したい場合があります。たとえば、ソフトウェアベンダーは、自社の製品が OCIL コンテンツを適切に使用しており、適切な OCIL コンテンツを使用する他のあらゆる製品と相互運用できることを主張したい場合があります。別の例として、セキュリティ監査の質問票の文書化と実施、およびその結果の保存に OCIL を使用することを組織に義務付ける方針があります。
This section provides the high-level requirements that a product or OCIL document must meet for conformance with this specification. Most of the requirements listed in this section reference other sections in the document that fully define the requirements.
この節では、製品または OCIL 文書がこの仕様に適合するために満たさなければならない高水準の要件を示します。この節に列挙する要件の大半は、要件を完全に定義している文書内の他の節を参照しています。
Other specifications that use OCIL may define additional requirements and recommendations for OCIL’s use. Such requirements and recommendations are outside the scope of this publication.
OCIL を使用する他の仕様が、OCIL の使用に関する追加の要件や推奨事項を定義している場合があります。そのような要件や推奨事項は、この刊行物の適用範囲外です。
3.1 Product Conformance
3.1 製品の適合性
All products claiming conformance with this specification SHALL adhere to the following requirements:
この仕様への適合を主張するすべての製品は、次の要件に従わなければなりません(SHALL)。
1.Products that process OCIL documents SHALL consume and correctly process well-formed OCIL documents. This includes following all of the processes defined in Section 7.
1.OCIL 文書を処理する製品は、整形式の OCIL 文書を取り込み、正しく処理しなければなりません(SHALL)。これには、第 7 節で定義するすべてのプロセスに従うことが含まれます。
2.Products that produce OCIL documents SHALL ensure that all OCIL documents they produce are well-formed. This includes following all of the processes defined in Section 7, and adhering to the syntax, structural, and other OCIL document development requirements defined in Section 6.
2.OCIL 文書を生成する製品は、生成するすべての OCIL 文書が整形式であることを確実にしなければなりません(SHALL)。これには、第 7 節で定義するすべてのプロセスに従うことと、第 6 節で定義する構文、構造、その他の OCIL 文書開発の要件に従うことが含まれます。
3.If the product uses OCIL as a check system for XCCDF (as described in Appendix A), then the product SHALL adhere to the requirements defined in Appendix B.
3.製品が OCIL を XCCDF のチェックシステムとして使用する場合(付録 A で説明)、その製品は付録 B で定義する要件に従わなければなりません(SHALL)。
4.Make an explicit claim of conformance to this specification in any documentation provided to end users.
4.エンドユーザーに提供するあらゆる文書で、この仕様への適合を明示的に主張すること。
3.2 Organization Conformance
3.2 組織の適合性
Organizations creating or maintaining OCIL documents that claim conformance with this specification SHALL follow these requirements:
この仕様への適合を主張する OCIL 文書を作成または保守する組織は、次の要件に従わなければなりません(SHALL)。
1.Adhere to the official OCIL schema as explained in Section 5.
1.第 5 節で説明する公式の OCIL スキーマに従うこと。
2.Adhere to the syntax, structural, and other OCIL document development requirements defined in Section 6.
2.第 6 節で定義する構文、構造、その他の OCIL 文書開発の要件に従うこと。
3.For OCIL documents to be used in a check system for XCCDF (as described in Appendix A), adhere to the requirements defined in Appendix B.
3.XCCDF のチェックシステムで使用される OCIL 文書(付録 A で説明)については、付録 B で定義する要件に従うこと。
4. Relationships to Existing Specifications and Standards
4. 既存の仕様および標準との関係
This section is primarily informative, and is intended to define the relationships between this specification and any other related specifications or standards (both current and past).2
この節は主に情報提供を目的としており、この仕様と、関連する他の仕様や標準(現在のものと過去のものの両方)との関係を定義することを意図しています。2
4.1 Relationship to OVAL
4.1 OVAL との関係
The Open Vulnerability and Assessment Language (OVAL) is used to express standardized, machine-readable rules that can be used to assess the state of a system. In the domain of information security, OVAL is commonly used to determine the presence of vulnerabilities and insecure software configurations through automated means. OVAL reports its findings in a standardized XML-based manner.
Open Vulnerability and Assessment Language(OVAL)は、システムの状態を評価するために使用できる、標準化された機械可読な規則を表現するために使用されます。情報セキュリティの分野では、OVAL は、脆弱性や安全でないソフトウェア構成の存在を自動化された手段で判断するために一般的に使用されています。OVAL は、その調査結果を、標準化された XML ベースの方法で報告します。
OVAL and OCIL complement each other and they can be considered peers. OVAL is used to collect specified pieces of information from systems directly and automatically, without human interaction; OCIL is used to collect specified pieces of information by harvesting existing sources of collected data or by asking a human to supply it. Both OVAL and OCIL produce XML-based reports, which supports aggregation of OVAL and OCIL results.
OVAL と OCIL は互いに補完し合うものであり、対等なものと考えることができます。OVAL は、人手を介さずに、システムから指定された情報を直接かつ自動的に収集するために使用されます。OCIL は、収集済みのデータの既存の情報源を取り込むか、人に情報の提供を求めることによって、指定された情報を収集するために使用されます。OVAL と OCIL はどちらも XML ベースの報告書を生成するため、OVAL と OCIL の結果の集約を支援します。
4.2 Relationship to XCCDF
4.2 XCCDF との関係
Extensible Configuration Checklist Description Format (XCCDF) is a specification language for expressing security configuration checklists and other sets of system assessment rules. XCCDF provides a standardized means of expressing these sets of rules and the results of evaluating a system using these rules.
Extensible Configuration Checklist Description Format(XCCDF)は、セキュリティ構成チェックリストやその他のシステム評価規則の集合を表現するための仕様言語です。XCCDF は、これらの規則の集合と、これらの規則を使用したシステムの評価結果を表現するための、標準化された手段を提供します。
XCCDF rules do not directly specify how checks should be performed; instead, these rules point to other XML documents, such as OVAL definition files and OCIL document files, which contain the actual instructions for performing the checks. Appendix A describes a use case involving using OCIL as a check system for XCCDF, and Appendix B provides syntax, processing, and other requirements for such a use case.
XCCDF の規則は、チェックをどのように実施すべきかを直接指定しません。代わりに、これらの規則は、チェックを実施するための実際の手順を含む、OVAL 定義ファイルや OCIL 文書ファイルなどの他の XML 文書を指し示します。付録 A では、OCIL を XCCDF のチェックシステムとして使用するユースケースを説明し、付録 B では、そのようなユースケースのための構文、処理、その他の要件を示します。
5. Data Model Overview
5. データモデルの概要
This section provides an overview of the data model that all OCIL implementations MUST support. It describes the data that is required to support common OCIL use cases. This section uses the term “element” to identify the classes within the data model, and the term “property” to identify any properties of a class. This section only defines selected aspects of the data model. The XML schema implementation of this model, which is the authoritative XML binding definition, can be found at http://scap.nist.gov/schema/ocil/2.0/ocil-2.0.xsd.
この節では、すべての OCIL 実装がサポートしなければならない(MUST)データモデルの概要を示します。ここでは、一般的な OCIL のユースケースをサポートするために必要なデータについて説明します。この節では、データモデル内のクラスを識別するために「要素」という用語を、クラスのプロパティを識別するために「プロパティ」という用語を使用します。この節では、データモデルの選択された側面のみを定義します。このモデルの XML スキーマ実装は、正式な XML バインディング定義であり、http://scap.nist.gov/schema/ocil/2.0/ocil-2.0.xsd にあります。
5.1 The ocil Element
5.1 ocil 要素
An ocil element contains all questionnaires, test_actions, questions, artifacts, variables, and results for an OCIL document, as well as document metadata. The table below describes the ocil element’s properties.
ocil 要素には、OCIL 文書のすべての questionnaire、test_action、question、artifact、variable、results と、文書のメタデータが含まれます。次の表は、ocil 要素のプロパティを説明しています。
ocil
ocil
| Property | Type | Count | Description |
|---|---|---|---|
| generator (element) | GeneratorType | 1 | Information related to the generation of the document, including the OCIL schema version, the time of the document’s generation, the name and version of the application used to generate it, and the name(s) of the document’s author(s). |
| document (element) | DocumentType | 0-1 | Document-level information that MAY be presented to a user, including title, descriptions, and notices. |
| questionnaires (element) | QuestionnairesType | 1 | A container for all questionnaire elements. Each questionnaire describes a sequence of questions that MAY be posed to determine a state or condition, including processing instructions. |
| test_actions (element) | TestActionsType | 1 | A container for all test_action elements. Each test_action describes a state or condition that MAY be checked for, including processing instructions. |
| questions (element) | QuestionsType | 1 | A container for all types of question and choice_group elements.
|
| artifacts (element) | ArtifactsType | 0-1 | A container for all artifact elements, which define the types of artifacts to be collected. An artifact MAY be retrieved during evaluation, as evidence to support a response to a question. |
| variables (element) | VariablesType | 0-1 | A container for all types of variables (e.g., constant, local, and external) elements. Each variable SHALL hold a single value computed based on its source. |
| results (element) | ResultsType | 0-1 | Assessment data generated during the evaluation of questionnaires, test_actions, and questions; includes the collection of artifacts and artifact metadata, if applicable. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| generator (要素) | GeneratorType | 1 | 文書の生成に関する情報。OCIL スキーマのバージョン、文書の生成時刻、生成に使用したアプリケーションの名前とバージョン、文書の作成者の名前を含みます。 |
| document (要素) | DocumentType | 0-1 | 利用者に提示してもよい(MAY)文書レベルの情報。タイトル、説明、通知を含みます。 |
| questionnaires (要素) | QuestionnairesType | 1 | すべての questionnaire 要素のコンテナー。各 questionnaire は、状態や状況を判断するために提示してもよい(MAY)一連の質問を、処理の指示を含めて記述します。 |
| test_actions (要素) | TestActionsType | 1 | すべての test_action 要素のコンテナー。各 test_action は、確認してもよい(MAY)状態や状況を、処理の指示を含めて記述します。 |
| questions (要素) | QuestionsType | 1 | あらゆる種類の question 要素と choice_group 要素のコンテナー。
|
| artifacts (要素) | ArtifactsType | 0-1 | すべての artifact 要素のコンテナー。artifact 要素は、収集すべきアーティファクトの種類を定義します。アーティファクトは、質問への回答を裏付ける証拠として、評価中に取得してもよいです(MAY)。 |
| variables (要素) | VariablesType | 0-1 | あらゆる種類の変数(たとえば、定数、ローカル、外部)要素のコンテナー。各変数は、そのソースに基づいて計算された単一の値を保持しなければなりません(SHALL)。 |
| results (要素) | ResultsType | 0-1 | questionnaire、test |
The rest of Section 5 provides additional information on each of these properties.
第 5 節の残りの部分では、これらの各プロパティについて追加の情報を示します。
5.2 The generator Element
5.2 generator 要素
The generator element contains information about the generation of the OCIL document file. The properties of the generator element are listed below. Organizations MAY supply additional information not covered by these properties, but such information is not part of the official OCIL language.
generator 要素には、OCIL 文書ファイルの生成に関する情報が含まれます。generator 要素のプロパティを次に示します。組織は、これらのプロパティで扱われていない追加の情報を提供してもよいです(MAY)が、そのような情報は公式の OCIL 言語の一部ではありません。
generator
generator
| Property | Type | Count | Description |
|---|---|---|---|
| product_name (element) | normalizedString | 0-1 | The name of the application used to generate the file. |
| product_version (element) | normalizedString | 0-1 | The version of the application used to generate the file. |
| author (element) | UserType | 0-n | Authors of the document. |
| schema_version (element) | decimal | 1 | The version of the OCIL schema that the document was written in and that should be used for validation. |
| timestamp (element) | dateTime | 1 | When the OCIL document was generated. |
| additional_data (element) | ExtensionContainerType | 0-1 | A container for metadata extensions about the generator used to create the OCIL document. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| product_name (要素) | normalizedString | 0-1 | ファイルの生成に使用したアプリケーションの名前。 |
| product_version (要素) | normalizedString | 0-1 | ファイルの生成に使用したアプリケーションのバージョン。 |
| author (要素) | UserType | 0-n | 文書の作成者。 |
| schema_version (要素) | decimal | 1 | 文書が記述された OCIL スキーマのバージョンであり、検証に使用すべきもの。 |
| timestamp (要素) | dateTime | 1 | OCIL 文書が生成された日時。 |
| additional_data (要素) | ExtensionContainerType | 0-1 | OCIL 文書の作成に使用した generator に関するメタデータ拡張のコンテナー。 |
5.3 The document Element
5.3 document 要素
The document element holds document-level information such as the title. The properties of the document element are listed below.
document 要素には、タイトルなどの文書レベルの情報が含まれます。document 要素のプロパティを次に示します。
document
document
| Property | Type | Count | Description |
|---|---|---|---|
| title (element) | normalizedString | 1 | The title of the document. |
| description (element) | normalizedString | 0-n | An overall description for the entire document. |
| notice (element) | string | 0-n | A notice or warning to the user of the document. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| title (要素) | normalizedString | 1 | 文書のタイトル。 |
| description (要素) | normalizedString | 0-n | 文書全体の概要説明。 |
| notice (要素) | string | 0-n | 文書の利用者への通知または警告。 |
5.4 The questionnaire Element
5.4 questionnaire 要素
The questionnaire element is the basic unit of an OCIL check. It contains references to sequences of questions and test_actions that are used to determine a state or condition. The properties of a questionnaire element are described below.
questionnaire 要素は、OCIL のチェックの基本単位です。状態や状況を判断するために使用される、一連の question と test_action への参照を含みます。questionnaire 要素のプロパティを次に説明します。
questionnaire
questionnaire
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | QuestionnaireIDPattern | 1 | Unique identifier for a questionnaire element. |
| child_only (attribute) | boolean | 0-1 | Whether the questionnaire SHALL be treated as a child-level questionnaire only (=true) or can be treated as both a child-level and top-level questionnaire (=false). (By default: false.) A child-level questionnaire can only be referenced by test_action elements, and not called directly as a top-level questionnaire. |
| title (element) | TextType | 0-1 | Heading or caption that describes the questionnaire. |
| description (element) | TextType | 0-1 | Text that describes the questionnaire in more detail than a title. |
| references (element) | ReferencesType | 0-1 | Information about any external references related to this questionnaire. Examples MAY include references to other standards, including but not limited to CVE, CCE, or CPE. |
| actions (element) | OperationType | 1 | A container for one or more test_action_ref elements, along with the methods used to combine their results into a single result. |
| notes (element) | string | 0-n | Any additional information related to the questionnaire. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | QuestionnaireIDPattern | 1 | questionnaire 要素の一意の識別子。 |
| child_only (属性) | boolean | 0-1 | questionnaire を子レベルの questionnaire としてのみ扱わなければならない(SHALL)か(=true)、子レベルとトップレベルの両方の questionnaire として扱えるか(=false)を示します。(デフォルト: false。)子レベルの questionnaire は test_action 要素からのみ参照でき、トップレベルの questionnaire として直接呼び出すことはできません。 |
| title (要素) | TextType | 0-1 | questionnaire を説明する見出しまたはキャプション。 |
| description (要素) | TextType | 0-1 | タイトルよりも詳しく questionnaire を説明するテキスト。 |
| references (要素) | ReferencesType | 0-1 | この questionnaire に関連する外部参照についての情報。例として、CVE、CCE、CPE を含む(ただしこれらに限定されない)他の標準への参照を含めてもよいです(MAY)。 |
| actions (要素) | OperationType | 1 | 1 つ以上の test_action_ref 要素と、それらの結果を単一の結果にまとめるために使用する方法のコンテナー。 |
| notes (要素) | string | 0-n | questionnaire に関連する追加情報。 |
The following table defines the properties of the actions element mentioned in the previous table.
次の表は、前の表で触れた actions 要素のプロパティを定義します。
actions
actions
| Property | Type | Count | Description |
|---|---|---|---|
| test_action_ref (element) | TestActionRefType | 1-n | Identifiers of one or more test_action elements. |
| operation (attribute) | OperatorType | 0-1 | How to aggregate (AND, OR) the results of a set of test_actions. (By default: AND.) |
| negate (attribute) | boolean | 0-1 | Whether the result should be toggled from PASS to FAIL and vice versa. Any result other than PASS or FAIL will be unchanged by a negate operation. (By default: false.) |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| test_action_ref (要素) | TestActionRefType | 1-n | 1 つ以上の test_action 要素の識別子。 |
| operation (属性) | OperatorType | 0-1 | test_action の集合の結果を集約する方法(AND、OR)。(デフォルト: AND。) |
| negate (属性) | boolean | 0-1 | 結果を PASS から FAIL へ、またその逆へと切り替えるかどうか。PASS と FAIL 以外の結果は、negate 操作によって変更されません。(デフォルト: false。) |
5.5 The test_action Element
5.5 test_action 要素
A test_action is used to identify a specific question to pose, and then handle the response. Handling the response can involve picking a specific result value for this test_action, as listed in Section 7.2, or calling another test_action or questionnaire. The test_action element itself is abstract and SHALL NOT appear within an OCIL document. It is extended by the question_test_action element. The properties of the question_test_action element are listed below.
test_action は、提示する特定の質問を特定し、その回答を処理するために使用されます。回答の処理には、この test_action の特定の結果値(第 7.2 節に列挙)を選ぶことや、別の test_action または questionnaire を呼び出すことが含まれる場合があります。test_action 要素自体は抽象要素であり、OCIL 文書内に現れてはなりません(SHALL NOT)。これは question_test_action 要素によって拡張されます。question_test_action 要素のプロパティを次に示します。
question_test_action
question_test_action
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | QuestionTestActionIDPattern | 1 | Unique identifier for a question_test_action. |
| question_ref (attribute) | QuestionIDPattern | 1 | Identifies a question using its id. |
| title (element) | TextType | 0-1 | Descriptive heading or caption that describes the question_test action. |
| when_unknown (element) | TestActionConditionType | 0-1 | Action to perform when an UNKNOWN value is received. |
| when_not_tested (element) | TestActionConditionType | 0-1 | Action to perform when a NOT_TESTED value is received. |
| when_not_applicable (element) | TestActionConditionType | 0-1 | Action to perform when a NOT_APPLICABLE value is received. |
| when_error (element) | TestActionConditionType | 0-1 | Action to perform when an ERROR value is received. |
| notes (element) | string | 0-n | Additional information related to the test_action. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | QuestionTestActionIDPattern | 1 | question_test_action の一意の識別子。 |
| question_ref (属性) | QuestionIDPattern | 1 | id を使用して question を特定します。 |
| title (要素) | TextType | 0-1 | question_test action を説明する、説明的な見出しまたはキャプション。 |
| when_unknown (要素) | TestActionConditionType | 0-1 | UNKNOWN 値を受け取ったときに実行するアクション。 |
| when_not_tested (要素) | TestActionConditionType | 0-1 | NOT_TESTED 値を受け取ったときに実行するアクション。 |
| when_not_applicable (要素) | TestActionConditionType | 0-1 | NOT_APPLICABLE 値を受け取ったときに実行するアクション。 |
| when_error (要素) | TestActionConditionType | 0-1 | ERROR 値を受け取ったときに実行するアクション。 |
| notes (要素) | string | 0-n | test_action に関連する追加情報。 |
The question_test_action is extended by four different child elements, each of which corresponds to a different data type for the user response. It is these latter elements that SHALL be used in an OCIL document; the question_test_action element is abstract and SHALL NOT appear within an OCIL document. The child elements inherit all the properties of their parents, and each also defines additional properties related to the user response data type. Listed below are the additional properties of these four child elements: boolean_question_test_action, choice_question_test_action, numeric_question_test_action, and string_question_test_action.
question_test_action は、利用者の回答に用いるデータ型がそれぞれ異なる 4 つの子要素によって拡張されます。OCIL 文書では、これらの子要素を使用しなければなりません(SHALL)。question_test_action 要素は抽象要素であり、OCIL 文書内に現れてはなりません(SHALL NOT)。子要素は親のすべてのプロパティを継承し、それぞれが利用者の回答のデータ型に関連する追加のプロパティも定義します。これら 4 つの子要素、boolean_question_test_action、choice_question_test_action、numeric_question_test_action、string_question_test_action の追加のプロパティを次に示します。
A boolean_question_test_action is used for questions answered by YES/NO or TRUE/FALSE.
boolean_question_test_action は、YES/NO または TRUE/FALSE で答える質問に使用されます。
boolean_question_test_action
boolean_question_test_action
| Property | Type | Count | Description |
|---|---|---|---|
| when_true (element) | TestActionConditionType | 1 | Action to perform when the response is TRUE or YES. |
| when_false (element) | TestActionConditionType | 1 | Action to perform when the response is FALSE or NO. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| when_true (要素) | TestActionConditionType | 1 | 回答が TRUE または YES のときに実行するアクション。 |
| when_false (要素) | TestActionConditionType | 1 | 回答が FALSE または NO のときに実行するアクション。 |
A choice_question_test_action is used when the user is presented with a list of possible responses and selects a single answer from the list.
choice_question_test_action は、利用者に考えられる回答の一覧が提示され、利用者がその一覧から 1 つの回答を選ぶ場合に使用されます。
Note: Choosing multiple answers is not supported by the data model at this time. If responding to multiple answers is desired then additional choices should be provided that combine multiple answers. For example, if choice A, B and C are offered, additional choices might be defined for A and B, B and C or “all of the above”.
注: 複数の回答の選択は、現時点ではデータモデルでサポートされていません。複数の回答への対応が必要な場合は、複数の回答を組み合わせた追加の選択肢を提供すべきです。たとえば、選択肢 A、B、C が提示される場合は、A と B、B と C、または「上記すべて」について、追加の選択肢を定義すべきです。
choice_question_test_action
choice_question_test_action
| Property | Type | Count | Description |
|---|---|---|---|
| when_choice (element) | ChoiceTestActionConditionType | 1-n | Action to perform when the response is one of a specified list of choices. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| when_choice (要素) | ChoiceTestActionConditionType | 1-n | 回答が、指定された選択肢の一覧のいずれかであるときに実行するアクション。 |
A numeric_question_test_action is used for questions answered with a numeric value.
numeric_question_test_action は、数値で答える質問に使用されます。
numeric_question_test_action
numeric_question_test_action
| Property | Type | Count | Description |
|---|---|---|---|
| when_equals (element) | EqualsTestActionConditionType | 0-n | Action to perform when the response is a specific numeric value. |
| when_range (element) | RangeTestActionConditionType | 0-n | Action to perform when the response falls within a specified range of values. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| when_equals (要素) | EqualsTestActionConditionType | 0-n | 回答が特定の数値であるときに実行するアクション。 |
| when_range (要素) | RangeTestActionConditionType | 0-n | 回答が指定された値の範囲内にあるときに実行するアクション。 |
Although either when_equals or when_range MAY be omitted, at least one instance of one of them must appear within the body of a numeric_question_test_action. If multiple handlers could potentially match a particular response (for example, if there were overlapping ranges) then the first matching handler is used based on the order they appear within the document. Since when_equals handlers always come before when_range handlers, this gives when_equals handlers precedence.
when_equals と when_range のどちらか一方は省略してもよいです(MAY)が、numeric_question_test_action の本体内には、そのどちらかのインスタンスが少なくとも 1 つ現れなければなりません。特定の回答に複数のハンドラーが一致する可能性がある場合(たとえば、範囲が重複している場合)は、文書内での出現順に基づいて、最初に一致したハンドラーが使用されます。when_equals ハンドラーは常に when_range ハンドラーの前に来るため、when_equals ハンドラーが優先されます。
A string_question_test_action is used for questions answered with a string.
string_question_test_action は、文字列で答える質問に使用されます。
string_question_test_action
string_question_test_action
| Property | Type | Count | Description |
|---|---|---|---|
| when_pattern (element) | PatternTestActionConditionType | 1-n | Action to perform when the response is a string that matches a specified regular expression. If the response could match multiple patterns, the handler with the first matching pattern is used. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| when_pattern (要素) | PatternTestActionConditionType | 1-n | 回答が、指定された正規表現に一致する文字列であるときに実行するアクション。回答が複数のパターンに一致する可能性がある場合は、最初に一致したパターンを持つハンドラーが使用されます。 |
All four types of child elements (boolean_question_test_action, choice_question_test_action, numeric_question_test_action, and string_question_test_action) use elements of the TestActionConditionType. The properties of a TestActionConditionType are as follows:
4 種類の子要素(boolean_question_test_action、choice_question_test_action、numeric_question_test_action、string_question_test_action)はすべて、TestActionConditionType の要素を使用します。TestActionConditionType のプロパティは次のとおりです。
TestActionConditionType
TestActionConditionType
| Property | Type | Count | Description |
|---|---|---|---|
| result (element) | ResultType | 1, either result or test_action_ref but not both (XOR) | A final value (e.g., PASS, FAIL, ERROR, UNKNOWN, NOT_TESTED, NOT_APPLICABLE) to be returned. See Section 7.2 for additional information on result types. |
| test_action_ref (element) | TestActionRefType | Reference to a new test_action or questionnaire to be processed. | |
| artifact_refs (element) | ArtifactRefsType | 0-1 | References to all the types of artifacts to be requested during evaluation. Contains a collection of one or more artifact_ref elements. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| result (要素) | ResultType | 1、result と test_action_ref のどちらか一方のみ、両方は不可(XOR) | 返される最終的な値(たとえば、PASS、FAIL、ERROR、UNKNOWN、NOT |
| test_action_ref (要素) | TestActionRefType | 処理する新しい test_action または questionnaire への参照。 | |
| artifact_refs (要素) | ArtifactRefsType | 0-1 | 評価中に要求するすべての種類のアーティファクトへの参照。1 つ以上の artifact_ref 要素の集合を含みます。 |
An artifact_ref element defines a single reference to a type of artifact (the basic information indicating which artifact is to be collected during processing).
artifact_ref 要素は、アーティファクトの種類への単一の参照(処理中にどのアーティファクトを収集するかを示す基本情報)を定義します。
artifact_ref
artifact_ref
| Property | Type | Count | Description |
|---|---|---|---|
| idref (attribute) | ArtifactIDPattern | 1 | Unique identifier for a type of artifact. |
| required (attribute) | boolean | 0-1 | Specifies whether the artifact must be included or not during processing. If true, then the questionnaire is not considered complete without the artifact; otherwise the artifact is desired but not necessary. The default value is false. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| idref (属性) | ArtifactIDPattern | 1 | アーティファクトの種類の一意の識別子。 |
| required (属性) | boolean | 0-1 | 処理中にアーティファクトを含めなければならないかどうかを指定します。true の場合、アーティファクトがなければ questionnaire は完了したとみなされません。それ以外の場合、アーティファクトは望ましいものの、必須ではありません。デフォルト値は false です。 |
5.6 The questions Element
5.6 questions 要素
A questions element contains all of the questions and supporting information defined within the document.
questions 要素には、文書内で定義されたすべての質問と補助情報が含まれます。
questions
questions
| Property | Type | Count | Description |
|---|---|---|---|
| question (element) | QuestionType | 1-n | Information for questions to be answered. |
| choice_group (element) | ChoiceGroupType | 0-n | Holds groups that represent possible sets of choices for choice_questions. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| question (要素) | QuestionType | 1-n | 回答される質問の情報。 |
| choice_group (要素) | ChoiceGroupType | 0-n | choice_question で考えられる選択肢の集合を表すグループを保持します。 |
A question element represents a question with REQUIRED text to pose and an OPTIONAL set of instructions for the user to follow to arrive at his or her answer.
question 要素は、提示すべき REQUIRED テキストと、利用者が回答に至るために従うべき OPTIONAL な一連の指示を持つ質問を表します。
question
question
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | QuestionIDPattern | 1 | Unique identifier for a question. |
| question_text (element) | QuestionTextType | 1-n | Provides the text of the question to be posed. The text MAY contain one or more values provided through variables. |
| instructions (element) | InstructionsType | 0-1 | A sequence of steps intended to guide the user in determining an answer to a question. |
| notes (element) | string | 0-n | Any additional information related to the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | QuestionIDPattern | 1 | 質問の一意の識別子。 |
| question_text (要素) | QuestionTextType | 1-n | 提示する質問のテキストを提供します。テキストには、変数を通じて提供される 1 つ以上の値を含めてもよいです(MAY)。 |
| instructions (要素) | InstructionsType | 0-1 | 利用者が質問への回答を判断するのを導くことを意図した、一連の手順。 |
| notes (要素) | string | 0-n | 質問に関連する追加情報。 |
The question element itself is abstract and SHALL NOT appear in OCIL documents. Instead, the four child elements—boolean_question, choice_question, numeric_question, and string_question, one for each data type of response—SHALL be used. Each is designed to handle a particular type of data for a valid answer. The child elements all inherit the constructs of their parent element. Additional properties of the child elements are shown below.
question 要素自体は抽象要素であり、OCIL 文書内に現れてはなりません(SHALL NOT)。代わりに、回答のデータ型ごとに 1 つずつある 4 つの子要素、すなわち boolean_question、choice_question、numeric_question、string_question を使用しなければなりません(SHALL)。それぞれが、有効な回答のための特定の種類のデータを扱うように設計されています。子要素はすべて、親要素の構成要素を継承します。子要素の追加のプロパティを次に示します。
boolean_question
boolean_question
| Property | Type | Count | Description |
|---|---|---|---|
| default_answer (attribute) | boolean | 0-1 | The default value of the question. |
| model (attribute) | BooleanQuestionModelType | 0-1 | Whether the response should be in the set {TRUE, FALSE} or the set {YES, NO}. (Default: response can either be YES or NO.) |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| default_answer (属性) | boolean | 0-1 | 質問のデフォルト値。 |
| model (属性) | BooleanQuestionModelType | 0-1 | 回答が集合 {TRUE, FALSE} または集合 {YES, NO} のいずれであるべきか。(デフォルト: 回答は YES または NO のいずれかです。) |
choice_question
choice_question
| Property | Type | Count | Description |
|---|---|---|---|
| choice (element) | ChoiceType | 1-n (see note below table) | Information associated with the possible responses to this choice_question. |
| choice_group_ref (element) | ChoiceGroupIDPattern | A reference to a choice_group; the choices described in the choice_group are possible responses for this choice_question. | |
| default_answer_ref (attribute) | ChoiceIDPattern | 0-1 | The choice ID of the default answer to this question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| choice (要素) | ChoiceType | 1-n(表の下の注を参照) | この choice_question で考えられる回答に関連付けられた情報。 |
| choice_group_ref (要素) | ChoiceGroupIDPattern | choice_group への参照。choice_group に記述された選択肢は、この choice_question で考えられる回答です。 | |
| default_answer_ref (属性) | ChoiceIDPattern | 0-1 | この質問のデフォルトの回答の選択肢 ID。 |
The choice and choice_group_ref elements listed above MAY be interleaved and products SHALL present each choice or choice_group_ref in the order in which they appear in the OCIL document.
上に列挙した choice 要素と choice_group_ref 要素は、交互に配置してもよいです(MAY)。製品は、各 choice または choice_group_ref を、OCIL 文書に現れる順序で提示しなければなりません(SHALL)。
numeric_question
numeric_question
| Property | Type | Count | Description |
|---|---|---|---|
| default_answer (attribute) | decimal | 0-1 | The default value of the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| default_answer (属性) | decimal | 0-1 | 質問のデフォルト値。 |
string_question
string_question
| Property | Type | Count | Description |
|---|---|---|---|
| default_answer (attribute) | string | 0-1 | The default value of the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| default_answer (属性) | string | 0-1 | 質問のデフォルト値。 |
Figure 1 shows the basic relationships between questionnaires, test actions, and questions in a pseudocode-like manner. The figure is not intended to exhaustively define or describe any of the elements; rather, the focus is on how these elements reference each other. The first box, representing questionnaire 4, calls test action 6. Test action 6 then calls question 1. If the answer to question 1 is “true”, then a result of “FAIL” is returned, otherwise test action 2 is called. Test action 2 calls question 4, which is a choice question. Based on which choice is selected as the answer, test action 2 returns a result of “FAIL” or “PASS”.
図 1 は、questionnaire、test action、question の基本的な関係を、疑似コードに近い形で示しています。この図は、いずれの要素も網羅的に定義または説明することを意図したものではなく、これらの要素が互いをどのように参照するかに焦点を当てています。最初の枠は questionnaire 4 を表し、test action 6 を呼び出します。次に test action 6 は question 1 を呼び出します。question 1 の回答が「true」であれば、結果「FAIL」が返され、そうでなければ test action 2 が呼び出されます。test action 2 は、選択式の質問である question 4 を呼び出します。回答として選択された選択肢に基づいて、test action 2 は結果「FAIL」または「PASS」を返します。
擬似コード風に書いた5つの角の丸い箱を矢印で結んだ図です。「questionnaire 4」: actions (AND)(論理積)— call test action 6、call test action 3、call test action 8。「call test action 6」から「test action 6」へ矢印があり、その中身は call question 1 (boolean)、if true, result = FAIL、if false, call test action 2 です。「call question 1 (boolean)」から「question 1」(question text)へ矢印があります。「if false, call test action 2」から「test action 2」へ矢印があり、その中身は call question 4 (choice)、if choice 1, result = FAIL、if choice 2 or 3, result = PASS です。「call question 4 (choice)」から「question 4」(question text、choice 1、choice 2、choice 3)へ矢印があります。
Figure 1. Relationships between Questionnaires, Test Actions, and Questions
図 1. questionnaire、test action、question の関係
5.7 The artifact element
5.7 artifact 要素
An artifact element defines structures that contain information about an artifact, which is an object that serves as evidence for a question’s answer. For example, if the question asks if a user has a defined process for maintaining system accounts, the artifact element would contain information about the type of process documentation that may need to be collected.
artifact 要素は、アーティファクトに関する情報を含む構造を定義します。アーティファクトは、質問の回答の証拠となるオブジェクトです。たとえば、質問が、利用者がシステムアカウントを維持するための定義済みのプロセスを持っているかどうかを尋ねるものである場合、artifact 要素には、収集が必要になる場合があるプロセス文書の種類に関する情報が含まれます。
artifact
artifact
| Property | Type | Count | Description |
|---|---|---|---|
| title (element) | TextType | 1 | A short summary or a caption about the artifact. |
| description (element) | TextType | 1 | Descriptive text about the artifact. |
| id (attribute) | ArtifactIDPattern | 1 | Unique identifier for an artifact. |
| persistent (attribute) | boolean | 0-1 | Specifies whether the artifact’s existence is time sensitive or not. If the value is true, then a snapshot or a copy SHALL be kept. Otherwise, a pointer to the location of the artifact is enough. The default value is true. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| title (要素) | TextType | 1 | アーティファクトに関する短い要約またはキャプション。 |
| description (要素) | TextType | 1 | アーティファクトに関する説明的なテキスト。 |
| id (属性) | ArtifactIDPattern | 1 | アーティファクトの一意の識別子。 |
| persistent (属性) | boolean | 0-1 | アーティファクトの存在が時間に依存するかどうかを指定します。値が true の場合、スナップショットまたはコピーを保持しなければなりません(SHALL)。それ以外の場合は、アーティファクトの場所へのポインターで十分です。デフォルト値は true です。 |
5.8 The variable element
5.8 variable 要素
A variable is an abstract element that holds a single value computed based on its source. There are three derived classes: constant_variable, external_variable, and local_variable. These three classes SHALL be used in OCIL documents; the variable element, which is abstract, SHALL NOT be used.
variable は、そのソースに基づいて計算された単一の値を保持する抽象要素です。派生クラスは 3 つあり、constant_variable、external_variable、local_variable です。OCIL 文書ではこれら 3 つのクラスを使用しなければならず(SHALL)、抽象要素である variable 要素を使用してはなりません(SHALL NOT)。
The text of a question, which is held in the question_text element, MAY be customized by substituting values from one or more variables into the text.
question_text 要素に保持される質問のテキストは、1 つ以上の変数の値をテキストに代入することで、カスタマイズしてもよいです(MAY)。
The value for a constant_variable is defined by the author of the document.
constant_variable の値は、文書の作成者が定義します。
constant_variable
constant_variable
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | VariableIDPattern | 1 | Unique identifier for a variable. |
| datatype (attribute) | VariableDataType | 1 | Specifies how a variable data value should be treated or used (TEXT or NUMERIC). |
| description (element) | TextType | 0-1 | Descriptive text about the variable. |
| value (element) | string | 1 | A single variable data. |
| notes (element) | string | 0-n | Any additional information related to the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | VariableIDPattern | 1 | 変数の一意の識別子。 |
| datatype (属性) | VariableDataType | 1 | 変数データ値をどのように扱うか、または使用するかを指定します(TEXT または NUMERIC)。 |
| description (要素) | TextType | 0-1 | 変数に関する説明的なテキスト。 |
| value (要素) | string | 1 | 単一の変数データ。 |
| notes (要素) | string | 0-n | 変数に関連する追加情報。 |
The value of an external_variable is defined elsewhere, from an external source.
external_variable の値は、外部のソースから、別の場所で定義されます。
external_variable
external_variable
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | VariableIDPattern | 1 | Unique identifier for a variable. |
| datatype (attribute) | VariableDataType | 1 | Specifies how a variable data value should be treated or used (TEXT or NUMERIC). |
| description (element) | TextType | 0-1 | Descriptive text about the variable. |
| notes (element) | string | 0-n | Any additional information related to the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | VariableIDPattern | 1 | 変数の一意の識別子。 |
| datatype (属性) | VariableDataType | 1 | 変数データ値をどのように扱うか、または使用するかを指定します(TEXT または NUMERIC)。 |
| description (要素) | TextType | 0-1 | 変数に関する説明的なテキスト。 |
| notes (要素) | string | 0-n | 変数に関連する追加情報。 |
The value of a local_variable is determined based on the answer to the question it links to (which is specified by the variable’s question_ref element). This would be used to dynamically set the variable’s value based on the answer to a previously asked question. If the local_variable has one or more set elements defined, the variable’s value is computed based on those set elements, otherwise the variable’s value is the same as the answer, with a few exceptions:
local_variable の値は、リンク先の質問(変数の question_ref 要素で指定されます)への回答に基づいて決まります。これは、以前に尋ねた質問への回答に基づいて、変数の値を動的に設定するために使用されます。local_variable に 1 つ以上の set 要素が定義されている場合、変数の値はそれらの set 要素に基づいて計算されます。そうでない場合、変数の値は、いくつかの例外を除き、回答と同じになります。
1.If the question is a boolean question and the variable data type is NUMERIC, then the value based on the answer is 1 for true and 0 for false.
1.質問が boolean 型の質問で、変数のデータ型が NUMERIC の場合、回答に基づく値は、true なら 1、false なら 0 です。
2.If the question is a boolean question and the variable data type is TEXT, then the value is determined by the question's model as follows:
2.質問が boolean 型の質問で、変数のデータ型が TEXT の場合、値は次のとおり、質問のモデルによって決まります。
a.MODEL_YES_NO: the value is “yes” if true or “no” if false.
a.MODEL_YES_NO: 値は、true なら「yes」、false なら「no」です。
b.MODEL_TRUE_FALSE: the value is “true” if true or “false” if false.
b.MODEL_TRUE_FALSE: 値は、true なら「true」、false なら「false」です。
3.If the question is a choice question, the variable data type is TEXT and the value is set to the text value of the choice.
3.質問が choice 型の質問の場合、変数のデータ型は TEXT で、値は選択肢のテキスト値に設定されます。
4.If the question is a numeric question, the variable data type is NUMERIC then the value is set to the value of the answer.
4.質問が numeric 型の質問で、変数のデータ型が NUMERIC の場合、値は回答の値に設定されます。
5.If the question is a string question, the variable data type is TEXT then the value is set to the value of the answer.
5.質問が string 型の質問で、変数のデータ型が TEXT の場合、値は回答の値に設定されます。
The answer value is matched with patterns, choice_refs, ranges of values, and boolean values. Based on the match, the value of the local variable is set as defined.
回答の値は、パターン、choice_ref、値の範囲、boolean 値と照合されます。照合結果に基づいて、ローカル変数の値は定義されたとおりに設定されます。
local_variable
local_variable
| Property | Type | Count | Description |
|---|---|---|---|
| id (attribute) | VariableIDPattern | 1 | Unique identifier for a variable. |
| datatype (attribute) | VariableDataType | 1 | Specifies how a variable data value should be treated or used (TEXT or NUMERIC). |
| description (element) | TextType | 0-1 | Descriptive text about the variable. |
| question_ref (attribute) | QuestionIDPattern | 1 | Unique identifier of the question in which the variable is linked. |
| set (element) | VariableSetType | 0-n | Information describing how to compute the value to be stored on the variable. Holds the pattern, choice_ref, range, or boolean values to be matched with the answer to the linked question, and the appropriate value to be stored on the variable based on the match. |
| notes (element) | string | 0-n | Any additional information related to the question. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| id (属性) | VariableIDPattern | 1 | 変数の一意の識別子。 |
| datatype (属性) | VariableDataType | 1 | 変数データ値をどのように扱うか、または使用するかを指定します(TEXT または NUMERIC)。 |
| description (要素) | TextType | 0-1 | 変数に関する説明的なテキスト。 |
| question_ref (属性) | QuestionIDPattern | 1 | 変数がリンクされている質問の一意の識別子。 |
| set (要素) | VariableSetType | 0-n | 変数に格納する値の計算方法を記述する情報。リンク先の質問への回答と照合するパターン、choice |
| notes (要素) | string | 0-n | 変数に関連する追加情報。 |
The set type and permitted datatype SHALL match the type of the question. The valid mappings are shown below:
set の型と許可されるデータ型は、質問の型と一致しなければなりません(SHALL)。有効な対応関係を次に示します。
| Question Type | Set Type | Permitted Datatypes |
|---|---|---|
| boolean_question | when_boolean | NUMERIC (for 0, 1 answers) TEXT (for true, false answers and yes, no answers) |
| choice_question | when_choice | TEXT |
| numeric_question | when_range | NUMERIC |
| string_question | when_pattern | TEXT |
| 質問の型 | set の型 | 許可されるデータ型 |
|---|---|---|
| boolean_question | when_boolean | NUMERIC(0、1 の回答用) TEXT(true、false の回答と yes、no の回答用) |
| choice_question | when_choice | TEXT |
| numeric_question | when_range | NUMERIC |
| string_question | when_pattern | TEXT |
5.9 The results element
5.9 results 要素
A results element holds all result data collected during use of the OCIL document. This data includes not only the final results of each questionnaire, but also a breakdown of the results for each test_action and the user's response to each question. The table below lists the properties of the results element. Additional information on calculating questionnaire results is provided in Section 7.3. Note that if the results are collected during multiple sessions, that a separate set of results will be collected for each session.
results 要素は、OCIL 文書の使用中に収集されたすべての結果データを保持します。このデータには、各 questionnaire の最終結果だけでなく、各 test_action の結果の内訳と、各質問に対する利用者の回答も含まれます。次の表は、results 要素のプロパティを示しています。questionnaire の結果の算出に関する追加情報は、第 7.3 節で示します。結果が複数のセッションにわたって収集される場合は、セッションごとに別々の結果の集合が収集されることに注意してください。
results
results
| Property | Type | Count | Description |
|---|---|---|---|
| title (element) | TextType | 0-1 | A descriptive heading or caption that describes the result set. |
| questionnaire_results (element) | QuestionnaireResultsType | 0-1 | A container for all questionnaire_result elements. A questionnaire_result describes the result of evaluating a questionnaire and any associated artifact_result elements. |
| test_action_results (element) | TestActionResultsType | 0-1 | A container for all test_action_result elements. A test_action_result describes the result of evaluating a test_action and any associated artifact_result elements. |
| question_results (element) | QuestionResultsType | 0-1 | A container for all question_result elements. A question_result contains the result of evaluating a question. |
| artifact _results (element) | ArtifactResultsType | 0-1 | A container for all artifact_result elements. An artifact_result contains information about the submitted artifact. |
| targets (element) | TargetsType | 0-1 | A container for all target elements. A target is a user or system from which the documented results have been taken. |
| start_time (attribute) | dateTime | 0-1 | Specifies when the evaluation of the OCIL document started, meaning when the first question was posed. |
| end_time (attribute) | dateTime | 0-1 | Specifies when the evaluation of the OCIL document completed, meaning when the last answer was recorded. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| title (要素) | TextType | 0-1 | 結果の集合を説明する見出しまたはキャプション。 |
| questionnaire_results (要素) | QuestionnaireResultsType | 0-1 | すべての questionnaire_result 要素のコンテナー。questionnaire |
| test_action_results (要素) | TestActionResultsType | 0-1 | すべての test_action_result 要素のコンテナー。test |
| question_results (要素) | QuestionResultsType | 0-1 | すべての question_result 要素のコンテナー。question_result には、質問の評価結果が含まれます。 |
| artifact _results (要素) | ArtifactResultsType | 0-1 | すべての artifact_result 要素のコンテナー。artifact_result には、提出されたアーティファクトに関する情報が含まれます。 |
| targets (要素) | TargetsType | 0-1 | すべての target 要素のコンテナー。target は、文書化された結果の取得元である利用者またはシステムです。 |
| start_time (属性) | dateTime | 0-1 | OCIL 文書の評価が開始された時刻、すなわち最初の質問が提示された時刻を指定します。 |
| end_time (属性) | dateTime | 0-1 | OCIL 文書の評価が完了した時刻、すなわち最後の回答が記録された時刻を指定します。 |
The questionnaire_results element defines the structures that contain the computed results of all the evaluated questionnaires. The properties of the questionnaire_results element are shown below.
questionnaire_results 要素は、評価されたすべての questionnaire の算出結果を含む構造を定義します。questionnaire_results 要素のプロパティを次に示します。
questionnaire_results
questionnaire_results
| Property | Type | Count | Description |
|---|---|---|---|
| questionnaire_result (element) | QuestionnaireResultType | 1-n | Information about the result of a particular questionnaire. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| questionnaire_result (要素) | QuestionnaireResultType | 1-n | 特定の questionnaire の結果に関する情報。 |
The questionnaire_result element listed above has the following properties:
上に列挙した questionnaire_result 要素には、次のプロパティがあります。
questionnaire_result
questionnaire_result
| Property | Type | Count | Description |
|---|---|---|---|
| artifact_results (element) | ArtifactResultsType | 0-1 | A set of retrieved artifacts and artifact metadata. |
| questionnaire_ref (attribute) | QuestionnaireIDPattern | 1 | Identifies a particular questionnaire by its ID. |
| result (attribute) | ResultType | 1 | The result of evaluating the specified questionnaire. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| artifact_results (要素) | ArtifactResultsType | 0-1 | 取得されたアーティファクトとアーティファクトのメタデータの集合。 |
| questionnaire_ref (属性) | QuestionnaireIDPattern | 1 | ID によって特定の questionnaire を特定します。 |
| result (属性) | ResultType | 1 | 指定された questionnaire の評価結果。 |
The test_action_results element defines the structures that contain the computed results of all the evaluated test action types. The properties of the test_action_results element are shown below.
test_action_results 要素は、評価されたすべての test action の種類の算出結果を含む構造を定義します。test_action_results 要素のプロパティを次に示します。
test_action_results
test_action_results
| Property | Type | Count | Description |
|---|---|---|---|
| test_action_result (element) | TestActionResultType | 1-n | Information about the result of a particular test_action evaluation. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| test_action_result (要素) | TestActionResultType | 1-n | 特定の test_action の評価結果に関する情報。 |
The test_action_result element listed above has the following properties:
上に列挙した test_action_result 要素には、次のプロパティがあります。
test_action_result
test_action_result
| Property | Type | Count | Description |
|---|---|---|---|
| artifact_results (element) | ArtifactResultsType | 0-1 | A set of retrieved artifacts and artifact metadata. |
| test_action_ref (attribute) | TestActionRefValuePattern | 1 | Identifies a particular test_action by its ID. |
| result (attribute) | ResultType | 1 | The result of evaluating the specified test_action. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| artifact_results (要素) | ArtifactResultsType | 0-1 | 取得されたアーティファクトとアーティファクトのメタデータの集合。 |
| test_action_ref (属性) | TestActionRefValuePattern | 1 | ID によって特定の test_action を特定します。 |
| result (属性) | ResultType | 1 | 指定された test_action の評価結果。 |
The question_results element defines the structures that contain the computed results of all the evaluated questions. The properties of the question_results element are shown below.
question_results 要素は、評価されたすべての質問の算出結果を含む構造を定義します。question_results 要素のプロパティを次に示します。
question_results
question_results
| Property | Type | Count | Description |
|---|---|---|---|
| question_result (element) | QuestionResultType | 1-n | Information about the result of a particular questionnaire. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| question_result (要素) | QuestionResultType | 1-n | 特定の質問票の結果に関する情報。 |
The question_result element listed above has the following properties:
上に列挙した question_result 要素には、次のプロパティがあります。
question_result
question_result
| Property | Type | Count | Description |
|---|---|---|---|
| question_ref (attribute) | QuestionIDPattern | 1 | Identifies a particular question by its ID. |
| response (attribute) | UserResponseType | 0-1 | Classification of the response. If the response was a standard answer, this is set to ANSWERED. If the answer is exceptional (UNKNOWN, NOT_APPLICABLE, etc.), then this is set to the corresponding exceptional result. See Section 7.2 for a list of result types. |
| result (attribute) | ResultType | 1 | The result of evaluating the specified questionnaire. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| question_ref (属性) | QuestionIDPattern | 1 | ID によって特定の質問を特定します。 |
| response (属性) | UserResponseType | 0-1 | 回答の分類。回答が標準的な回答であった場合は、ANSWERED に設定されます。回答が例外的なもの(UNKNOWN、NOT |
| result (属性) | ResultType | 1 | 指定された questionnaire の評価結果。 |
The question_result type is extended by four other types that correspond to the four kinds of questions: boolean, choice, numeric, and string. Each of these four extensions has an answer element that contains the answer to the question. The answer’s type SHALL match the type of the question. The valid mappings are shown below:
question_result の型は、質問の 4 種類(boolean、choice、numeric、string)に対応する 4 つの他の型によって拡張されます。これら 4 つの拡張にはそれぞれ、質問への回答を含む answer 要素があります。answer の型は、質問の型と一致しなければなりません(SHALL)。有効な対応関係を次に示します。
| Question Type | Question Result Type |
|---|---|
| boolean_question | boolean_question_result |
| choice_question | choice_question_result |
| numeric_question | numeric_question_result |
| string_question | string_question_result |
| 質問の型 | 質問結果の型 |
|---|---|
| boolean_question | boolean_question_result |
| choice_question | choice_question_result |
| numeric_question | numeric_question_result |
| string_question | string_question_result |
The artifact_results element defines the structures that contain all artifacts retrieved during evaluation and associated metadata. The properties of the artifact_results element are shown below.
artifact_results 要素は、評価中に取得されたすべてのアーティファクトと、関連するメタデータを含む構造を定義します。artifact_results 要素のプロパティを次に示します。
artifact_results
artifact_results
| Property | Type | Count | Description |
|---|---|---|---|
| artifact_result (element) | ArtifactResultType | 1-n | Information about a particular artifact. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| artifact_result (要素) | ArtifactResultType | 1-n | 特定のアーティファクトに関する情報。 |
The artifact_result element listed above has the following properties:
上に列挙した artifact_result 要素には、次のプロパティがあります。
artifact_result
artifact_result
| Property | Type | Count | Description |
|---|---|---|---|
| artifact_ref (attribute) | ArtifactIDPattern | 1 | Unique identifier of the artifact object that describes what the artifact is about, the type of data it holds, and other metadata. |
| timestamp (attribute) | dateTime | 1 | Date and time when the artifact was collected. |
| artifact_value (element) | ArtifactValueType | 1 | Contains either the artifact data itself or a pointer to it. This is an abstract value, with child elements binary_artifact_value, reference |
| provider (element) | ProviderValuePattern | 1 | Information about the user or system that provided the artifact. |
| submitter (element) | UserType | 1 | Information about the user who submitted the artifact. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| artifact_ref (属性) | ArtifactIDPattern | 1 | アーティファクトの内容、保持するデータの種類、その他のメタデータを記述する artifact オブジェクトの一意の識別子。 |
| timestamp (属性) | dateTime | 1 | アーティファクトが収集された日時。 |
| artifact_value (要素) | ArtifactValueType | 1 | アーティファクトのデータ自体、またはそれへのポインターのいずれかを含みます。これは抽象的な値であり、子要素として binary |
| provider (要素) | ProviderValuePattern | 1 | アーティファクトを提供した利用者またはシステムに関する情報。 |
| submitter (要素) | UserType | 1 | アーティファクトを提出した利用者に関する情報。 |
The binary_artifact_value and text_artifact_value child elements mentioned in the table above each hold both the artifact data and the Multipurpose Internet Mail Extensions (MIME) type for that data.3
上の表で触れた binary_artifact_value と text_artifact_value の子要素はそれぞれ、アーティファクトのデータと、そのデータの Multipurpose Internet Mail Extensions(MIME)タイプの両方を保持します。3
6. Content Design Requirements and Recommendations
6. コンテンツ設計の要件と推奨事項
This section defines content design requirements, including syntax and structural requirements, that an organization or product MUST follow to create and maintain a well-formed OCIL document. This section also provides recommendations for organizing OCIL content and the implications of various OCIL document design decisions. The requirements and recommendations presented in this section supplement the content data model defined in Section 5.
この節では、整形式の OCIL 文書を作成し保守するために、組織または製品が従わなければならない(MUST)、構文および構造の要件を含むコンテンツ設計の要件を定義します。この節では、OCIL コンテンツの構成に関する推奨事項と、OCIL 文書の設計上のさまざまな判断が及ぼす影響についても示します。この節で示す要件と推奨事項は、第 5 節で定義したコンテンツのデータモデルを補完するものです。
6.1 OCIL Document Contents
6.1 OCIL 文書の内容
An OCIL document instance SHALL hold exactly one ocil element. The ocil element SHALL be the root XML element of an OCIL document.
OCIL 文書のインスタンスは、ocil 要素をちょうど 1 つ保持しなければなりません(SHALL)。ocil 要素は、OCIL 文書のルート XML 要素でなければなりません(SHALL)。
6.2 The generator Element
6.2 generator 要素
Additional information not covered by the standard properties of the generator element MAY be supplied after those properties. However, OCIL implementations can ignore this information.
generator 要素の標準のプロパティで扱われていない追加情報は、それらのプロパティの後に提供してもよいです(MAY)。ただし、OCIL の実装はこの情報を無視できます。
6.3 The questionnaire Element
6.3 questionnaire 要素
A questionnaire acting as top-level SHOULD represent a single discrete check, such as verifying compliance with a particular recommendation or requirement. This is preferred because each top-level questionnaire returns a single result, which corresponds well to performing a single check. Also, having a single check per questionnaire provides a modular approach to questionnaire design that supports questionnaire reuse.
トップレベルとして機能する questionnaire は、特定の推奨事項や要件への準拠の検証など、単一の個別のチェックを表すべきです(SHOULD)。トップレベルの各 questionnaire は 1 つの結果を返し、これは単一のチェックの実施とよく対応するため、この方法が望まれます。また、questionnaire ごとに 1 つのチェックとすることで、questionnaire の設計に対するモジュール型のアプローチが得られ、questionnaire の再利用を支援します。
Each questionnaire SHALL have a unique identifier, as expressed using the id property, and SHALL be referenced through that identifier. Each questionnaire identifier SHALL use the following syntax:
各 questionnaire は、id プロパティで表される一意の識別子を持たなければならず(SHALL)、その識別子を通じて参照されなければなりません(SHALL)。各 questionnaire の識別子は、次の構文を使用しなければなりません(SHALL)。
"ocil:[A-Za-z0-9_\-\.]+:questionnaire:[1-9][0-9]*"
An example of this follows:
例を次に示します。
<questionnaire id="ocil:org.mitre:questionnaire:1">
Each questionnaire identifier SHOULD be globally unique. The string after "ocil:" SHOULD be set appropriately to accomplish this, and SHOULD specify an inverted Domain Name System (DNS) name.
各 questionnaire の識別子は、グローバルに一意であるべきです(SHOULD)。"ocil:" の後の文字列は、これを実現するように適切に設定すべきであり(SHOULD)、逆順にした Domain Name System(DNS)名を指定すべきです(SHOULD)。
Each questionnaire SHALL contain an actions element that has references to one or more test_action elements. The test_action elements within an actions element are evaluated in sequential order. Each actions element MAY also contain an operator to aggregate the test_action results and a negate attribute used to toggle the value of the final result (i.e., from PASS to FAIL, or FAIL to PASS). Although a single questionnaire SHALL NOT specify more than one operator to aggregate its test_action results, more complex aggregations MAY be performed by having one or more test_action elements refer to other questionnaires, which MAY themselves reference multiple test_action elements and aggregate them with their own operator. This allows for arbitrarily complex logical combinations of responses.
各 questionnaire は、1 つ以上の test_action 要素への参照を持つ actions 要素を含まなければなりません(SHALL)。actions 要素内の test_action 要素は、順番に評価されます。各 actions 要素は、test_action の結果を集約する演算子と、最終結果の値を切り替える(すなわち、PASS から FAIL へ、または FAIL から PASS へ)ために使用する negate 属性も含んでもよいです(MAY)。単一の questionnaire が、その test_action の結果を集約する演算子を複数指定してはなりません(SHALL NOT)が、1 つ以上の test_action 要素に他の questionnaire を参照させることで、より複雑な集約を実行してもよいです(MAY)。参照された questionnaire は、それ自体が複数の test_action 要素を参照し、独自の演算子でそれらを集約してもよいです(MAY)。これにより、回答の任意に複雑な論理的組み合わせが可能になります。
At least one questionnaire in each OCIL document SHALL have its child_only property set to false, thus allowing it to be used as a top-level questionnaire.
各 OCIL 文書内の少なくとも 1 つの questionnaire は、child_only プロパティを false に設定しなければならず(SHALL)、これによりトップレベルの questionnaire として使用できるようにします。
6.4 The test_action Element
6.4 test_action 要素
Each question_test_action SHALL have a unique identifier, as expressed using the id property, and its child elements (boolean_question_test_action, choice_question_test_action, numeric_question_test_action, and string_question_test_action) SHALL be referenced through that identifier. The identifiers SHALL use the following syntax:
各 question_test_action は、id プロパティで表される一意の識別子を持たなければならず(SHALL)、その子要素(boolean_question_test_action、choice_question_test_action、numeric_question_test_action、string_question_test_action)は、その識別子を通じて参照されなければなりません(SHALL)。識別子は、次の構文を使用しなければなりません(SHALL)。
"ocil:[A-Za-z0-9_\-\.]+:testaction:[1-9][0-9]*"
Each question_test_action identifier SHOULD be globally unique. The string after "ocil:" SHOULD be set appropriately to accomplish this, and SHOULD specify an inverted Domain Name System (DNS) name.
各 question_test_action の識別子は、グローバルに一意であるべきです(SHOULD)。"ocil:" の後の文字列は、これを実現するように適切に設定すべきであり(SHOULD)、逆順にした Domain Name System(DNS)名を指定すべきです(SHOULD)。
Each question_test_action SHOULD be written so as to cover all of the possible answers that could be provided. If a question_test_action is not written that way, then an ERROR result will be generated if an answer is provided that the question_test_action is not designed to handle. In some cases, an author MAY choose to have a question_test_action not cover certain answers or ranges of answers so that an ERROR result is generated. Section 7.5 further discusses cases when there is no handler for an answer.
各 question_test_action は、提供され得るすべての回答を網羅するように記述すべきです(SHOULD)。question_test_action がそのように記述されていない場合、question_test_action が処理するように設計されていない回答が提供されたときに、ERROR の結果が生成されます。場合によっては、作成者は、ERROR の結果が生成されるように、question_test_action が特定の回答や回答の範囲を網羅しないことを選択してもよいです(MAY)。回答に対するハンドラーがない場合については、第 7.5 節でさらに論じます。
Each numeric_question_test_action SHALL be written so that its handlers are in the proper sequence if there is any overlap between the values that they handle. When looking for a match, all when_equals handlers are checked before when_range handlers, and handlers in each category are checked in sequence based on their order within the document.
各 numeric_question_test_action は、そのハンドラーが処理する値に重複がある場合、ハンドラーが適切な順序になるように記述しなければなりません(SHALL)。一致を探す際は、すべての when_equals ハンドラーが when_range ハンドラーより先にチェックされ、各カテゴリ内のハンドラーは、文書内での順序に基づいて順番にチェックされます。
Each string_question_test_action SHALL be written so that its handlers are in the proper sequence if there is any overlap between the patterns that they look for. The handlers are checked in sequence and the first one with a pattern matching the response is used.
各 string_question_test_action は、そのハンドラーが探すパターンに重複がある場合、ハンドラーが適切な順序になるように記述しなければなりません(SHALL)。ハンドラーは順番にチェックされ、回答に一致するパターンを持つ最初のものが使用されます。
The when_unknown, when_not_tested, when_not_applicable, and when_error properties of the question_test_action element are all of type TestActionConditionType. All of the additional properties of the boolean, choice, numeric, and string child elements of question_test_action either are of the TestActionConditionType or use a type that extends it. When determining how a test_action should handle a response to a question, the author SHALL specify either a result (a final value to be returned) or a test_action_ref (a reference to a new test_action or questionnaire to be processed), but SHALL NOT specify both.
question_test_action 要素の when_unknown、when_not_tested、when_not_applicable、when_error プロパティは、すべて TestActionConditionType 型です。question_test_action の boolean、choice、numeric、string の子要素の追加プロパティはすべて、TestActionConditionType 型であるか、それを拡張した型を使用します。test_action が質問への回答をどのように処理すべきかを決める際、作成者は、result(返される最終的な値)または test_action_ref(処理する新しい test_action または questionnaire への参照)のいずれかを指定しなければならず(SHALL)、両方を指定してはなりません(SHALL NOT)。
6.5 The question Element
6.5 question 要素
Each question SHALL have a unique identifier, as expressed using the id property, and its child elements (boolean_question, choice_question, numeric_question, and string_question) SHALL be referenced through that identifier. The identifiers SHALL use the following syntax:
各 question は、id プロパティで表される一意の識別子を持たなければならず(SHALL)、その子要素(boolean_question、choice_question、numeric_question、string_question)は、その識別子を通じて参照されなければなりません(SHALL)。識別子は、次の構文を使用しなければなりません(SHALL)。
"ocil:[A-Za-z0-9_\-\.]+:question:[1-9][0-9]*"
Each question identifier SHOULD be globally unique. The string after "ocil:" SHOULD be set appropriately to accomplish this, and SHOULD specify an inverted Domain Name System (DNS) name.
各 question の識別子は、グローバルに一意であるべきです(SHOULD)。"ocil:" の後の文字列は、これを実現するように適切に設定すべきであり(SHOULD)、逆順にした Domain Name System(DNS)名を指定すべきです(SHOULD)。
Each question SHALL be referenced only by question_test_action and question_result elements of the same type. For example, a boolean_question could be referenced by a boolean_question_test_action and a boolean_question_result.
各 question は、同じ型の question_test_action 要素と question_result 要素からのみ参照されなければなりません(SHALL)。たとえば、boolean_question は、boolean_question_test_action と boolean_question_result から参照できます。
The four types of child elements—boolean, choice, numeric, and string—offer different granularity for answers. The simplest is boolean, which offers two options (yes/no or true/false). The next simplest is choice, which offers a small set of options (theoretically unlimited, but each choice has to be separately enumerated, which limits the number in practice). Much more granularity is available through numbers (a wide range of positive and negative integers and decimals) and even more granularity through strings (long sequences of letters and other characters). Each question instance SHOULD use the simplest child element type that provides the necessary granularity. For example, if the author wants to get a true/false answer, the author SHOULD use a boolean_question instead of treating the answer as a “TRUE” or “FALSE” string in a string_question or having the user choose “TRUE” or “FALSE” as part of a choice_question. Another example involves numbers. Suppose that the information needed is what quadrant (0-25, 26-50, 51-75, 76-100) a quiz score fell into, and the score itself is not needed. The author SHOULD use a choice_question with four choices, one for each of the quadrants, instead of a numeric_question. A numeric_question SHOULD be used if the score itself is also needed.
4 種類の子要素(boolean、choice、numeric、string)は、回答の粒度がそれぞれ異なります。最も単純なのは boolean で、2 つの選択肢(yes/no または true/false)を提供します。次に単純なのは choice で、少数の選択肢を提供します(理論上は無制限ですが、各選択肢を個別に列挙する必要があるため、実際には数が限られます)。数値(正と負の幅広い整数と小数)を使うとはるかに細かい粒度が得られ、文字列(文字やその他の記号の長い並び)を使うとさらに細かい粒度が得られます。各 question のインスタンスは、必要な粒度を提供する最も単純な子要素の型を使用すべきです(SHOULD)。たとえば、作成者が true/false の回答を得たい場合、string_question で回答を「TRUE」または「FALSE」の文字列として扱ったり、choice_question の一部として利用者に「TRUE」または「FALSE」を選ばせたりするのではなく、boolean_question を使用すべきです(SHOULD)。別の例は、数値に関するものです。必要な情報が、クイズの得点がどの区分(0-25、26-50、51-75、76-100)に入ったかであり、得点そのものは必要ないとします。この場合、作成者は、numeric_question ではなく、区分ごとに 1 つずつの 4 つの選択肢を持つ choice_question を使用すべきです(SHOULD)。得点そのものも必要な場合は、numeric_question を使用すべきです(SHOULD)。
Authors SHOULD use instructions elements for questions that users are likely to answer more accurately and/or easily with step-by-step instructions.
作成者は、段階的な手順の指示があれば、利用者がより正確に、または容易に(あるいはその両方で)答えられそうな質問には、instructions 要素を使用すべきです(SHOULD)。
A single question MAY be referenced by multiple test_actions within an OCIL document. However, implementations presenting the question can cache the answer and reuse it instead of asking the same question more than once. If an author wants to ask a question multiple times within an evaluation because of an expectation that users might give different answers—for example, because the question is being asked within a different context—then the author SHALL define a separate question for each instance, instead of using a single question multiple times. The author SHOULD provide enough information in the question wording or in the supporting instructions so that the user can reach the appropriate answer in each instance.
1 つの question は、OCIL 文書内の複数の test_action から参照されてもよいです(MAY)。ただし、質問を提示する実装は、回答をキャッシュし、同じ質問を複数回尋ねる代わりに再利用できます。たとえば、質問が異なる文脈で尋ねられるなど、利用者が異なる回答をすることが想定されるために、評価の中で同じ質問を複数回尋ねたい場合、作成者は、1 つの質問を複数回使用するのではなく、インスタンスごとに別々の質問を定義しなければなりません(SHALL)。作成者は、どのインスタンスでも利用者が適切な回答に至れるよう、質問の文言または補助的な指示に十分な情報を記載すべきです(SHOULD)。
6.6 The artifact Element
6.6 artifact 要素
Each artifact element SHALL have a unique identifier, as expressed using the id property, and SHALL be referenced through that identifier. The identifiers SHALL use the following syntax:
各 artifact 要素は、id プロパティで表される一意の識別子を持たなければならず(SHALL)、その識別子を通じて参照されなければなりません(SHALL)。識別子は、次の構文を使用しなければなりません(SHALL)。
"ocil:[A-Za-z0-9_\-\.]+:artifact:[1-9][0-9]*"
Each artifact element identifier SHOULD be globally unique. The string after "ocil:" SHOULD be set appropriately to accomplish this, and SHOULD specify an inverted Domain Name System (DNS) name.
各 artifact 要素の識別子は、グローバルに一意であるべきです(SHOULD)。"ocil:" の後の文字列は、これを実現するように適切に設定すべきであり(SHOULD)、逆順にした Domain Name System(DNS)名を指定すべきです(SHOULD)。
There are three possible types of artifacts: binary, reference, and text. Binary and text artifacts are copied from the sources, while reference artifacts are simply references, such as URIs, to the sources. If the author has flexibility in which type of artifact to collect, particularly getting a copy of the source (binary or text) versus a pointer to it (reference), then there are some possible issues to keep in mind. References might not be global; for example, a user might provide a pointer to an internal web site that can only be accessed from the internal network. In those cases, collecting a reference artifact may be of little value. On the other hand, if a source contains sensitive information, there could be security or privacy issues with copying that information and storing the copy elsewhere. OCIL does not provide any mechanisms for protecting information. Also, if files are large, additional storage space may be needed to hold them.
アーティファクトには、binary、reference、text の 3 種類があります。binary と text のアーティファクトはソースからコピーされ、reference のアーティファクトは、ソースへの URI などの単なる参照です。作成者が、収集するアーティファクトの種類を選べる場合、特に、ソースのコピー(binary または text)とソースへのポインター(reference)のどちらを取得するかを選べる場合には、留意すべき問題がいくつかあります。参照はグローバルではない場合があります。たとえば、利用者が、内部ネットワークからのみアクセスできる社内 Web サイトへのポインターを提供することがあります。そのような場合、reference のアーティファクトを収集しても、ほとんど価値がないことがあります。一方、ソースに機微な情報が含まれている場合、その情報をコピーして別の場所に保存することには、セキュリティ上またはプライバシー上の問題が生じる可能性があります。OCIL は、情報を保護するためのいかなる仕組みも提供しません。また、ファイルが大きい場合は、それらを保持するための追加のストレージ容量が必要になることがあります。
The artifact element’s persistent attribute and the artifact_ref element’s required attribute are similar, but subtly different. Setting the persistent attribute to TRUE indicates that the artifact is time-sensitive and that if the artifact is requested, it is mandatory to provide it. Setting the required attribute of the artifact_ref to TRUE indicates that for the particular artifact reference being called by a test_action, it is mandatory to provide the artifact. The same artifact could be requested in a non-mandatory manner by a different artifact_ref and test_action. If the author uses the persistent and/or required attributes to make it mandatory to supply an artifact, and the artifact cannot be supplied when evaluating the questionnaire, then the questionnaire cannot be fully completed. Therefore, authors SHOULD only make artifacts mandatory if they are truly necessary.
artifact 要素の persistent 属性と artifact_ref 要素の required 属性は似ていますが、微妙に異なります。persistent 属性を TRUE に設定すると、アーティファクトが時間に依存することを示し、アーティファクトが要求された場合は、それを提供することが必須になります。artifact_ref の required 属性を TRUE に設定すると、test_action から呼び出される特定のアーティファクト参照については、アーティファクトを提供することが必須であることを示します。同じアーティファクトが、別の artifact_ref と test_action によって、必須ではない形で要求される場合もあります。作成者が persistent 属性や required 属性(またはその両方)を使用してアーティファクトの提供を必須にし、questionnaire の評価時にそのアーティファクトを提供できない場合、その questionnaire を完全に完了することはできません。したがって、作成者は、アーティファクトが本当に必要な場合にのみ、それを必須にすべきです(SHOULD)。
6.7 The variable Element
6.7 variable 要素
Each variable SHALL have a unique identifier, as expressed using the id property, and its child elements (constant_variable, local_variable, and external_variable) SHALL be referenced through that identifier. The identifiers SHALL use the following syntax:
各 variable は、id プロパティで表される一意の識別子を持たなければならず(SHALL)、その子要素(constant_variable、local_variable、external_variable)は、その識別子を通じて参照されなければなりません(SHALL)。識別子は、次の構文を使用しなければなりません(SHALL)。
"ocil:[A-Za-z0-9_\-\.]+:variable:[1-9][0-9]*"
Each variable identifier SHOULD be globally unique. The string after "ocil:" SHOULD be set appropriately to accomplish this, and SHOULD specify an inverted Domain Name System (DNS) name.
各 variable の識別子は、グローバルに一意であるべきです(SHOULD)。"ocil:" の後の文字列は、これを実現するように適切に設定すべきであり(SHOULD)、逆順にした Domain Name System(DNS)名を指定すべきです(SHOULD)。
6.8 Circular References
6.8 循環参照
There are multiple ways that circular references—elements referring to themselves directly or indirectly—can occur in OCIL documents. For example, a questionnaire or test action could call itself, or a question could have a variable that gets its value from the same question. Authors SHOULD avoid using circular references because they can prevent a questionnaire evaluation from being completed and can cause operational problems due to excess resource consumption, such as infinite loops.
OCIL 文書では、循環参照、すなわち要素が直接または間接に自分自身を参照することが、複数の方法で発生し得ます。たとえば、questionnaire や test action が自分自身を呼び出したり、質問が、同じ質問から値を取得する変数を持ったりする場合です。循環参照は、questionnaire の評価が完了するのを妨げたり、無限ループなどによる過剰なリソース消費に起因する運用上の問題を引き起こしたりする可能性があるため、作成者は使用を避けるべきです(SHOULD)。
7. Processing Requirements
7. 処理要件
This section describes the processing requirements that an OCIL implementation MUST follow to correctly process an OCIL document.
この節では、OCIL 文書を正しく処理するために、OCIL 実装が従わなければならない(MUST)処理要件を説明します。
7.1 Questionnaire Display and Evaluation
7.1 質問票の表示と評価
A top-level questionnaire has its child_only attribute set to false (the default setting). A top-level questionnaire MAY be posed to a user directly or called by another questionnaire.
トップレベルの questionnaire は、child_only 属性が false に設定されています(デフォルトの設定)。トップレベルの questionnaire は、利用者に直接提示してもよい(MAY)し、別の questionnaire から呼び出してもよいです。
A low-level questionnaire has its child_only attribute set to true. This type of questionnaire is designed to be part of another questionnaire. A low-level questionnaire SHALL be processed and its questions evaluated only if called by another questionnaire; it SHALL NOT be evaluated independently.
下位レベルの questionnaire は、child_only 属性が true に設定されています。この種の questionnaire は、別の questionnaire の一部となるように設計されています。下位レベルの questionnaire は、別の questionnaire から呼び出された場合にのみ処理し、その質問を評価しなければならず(SHALL)、単独で評価してはなりません(SHALL NOT)。
An OCIL implementation MAY choose to display a list of all the top-level questionnaires in an OCIL document to a user, and allow the user to work through the list. An OCIL implementation SHALL NOT display a low-level questionnaire in a list of top-level questionnaires since it represents a sub-section of other questionnaires.
OCIL 実装は、OCIL 文書内のすべてのトップレベルの questionnaire の一覧を利用者に表示し、利用者がその一覧を順に進められるようにしてもよいです(MAY)。OCIL 実装は、下位レベルの questionnaire を、トップレベルの questionnaire の一覧に表示してはなりません(SHALL NOT)。これは、他の questionnaire の一部を表すためです。
For each choice_question displayed to the user, the choice and choice_group_ref elements SHALL BE presented to the user in the order in which they appear in the OCIL document.
利用者に表示する各 choice_question では、choice 要素と choice_group_ref 要素を、OCIL 文書に現れる順序で利用者に提示しなければなりません(SHALL BE)。
If a questionnaire evaluation is split among multiple sessions, a separate set of results SHALL be collected for each session. The start_time and end_time elements SHALL reflect the start and end time of each session.
questionnaire の評価が複数のセッションに分割される場合、セッションごとに別々の結果の集合を収集しなければなりません(SHALL)。start_time 要素と end_time 要素は、各セッションの開始時刻と終了時刻を反映しなければなりません(SHALL)。
7.2 Test Action and Questionnaire Result Types
7.2 テストアクションと質問票の結果の種類
After processing (which includes receiving the necessary responses), a test action SHALL evaluate to one result type. A questionnaire SHALL also evaluate to one result type after processing. The result value of a test action or questionnaire SHALL be one of the following:
処理(必要な回答の受け取りを含む)の後、test action は 1 つの結果の種類に評価されなければなりません(SHALL)。questionnaire も、処理の後に 1 つの結果の種類に評価されなければなりません(SHALL)。test action または questionnaire の結果の値は、次のいずれかでなければなりません(SHALL)。
1.PASS. The state or condition being tested is achieved or satisfied.
1.PASS. テスト対象の状態または状況が達成または満たされています。
2.FAIL. The state or condition being tested is not achieved or satisfied.
2.FAIL. テスト対象の状態または状況が達成または満たされていません。
3.UNKNOWN. The state or condition being tested could not be determined.
3.UNKNOWN. テスト対象の状態または状況を判断できませんでした。
4.ERROR. The answer to a question was an unacceptable or unhandled value; OR an unhandled situation or system error was encountered.
4.ERROR. 質問への回答が、受け入れられない値または処理されない値でした。または、処理されない状況もしくはシステムエラーが発生しました。
5.NOT_APPLICABLE. The test action or questionnaire does not apply to the goal as determined by response(s).
5.NOT_APPLICABLE. 回答によって判断された目標に、test action または questionnaire が適用されません。
6.NOT_TESTED. The test action or questionnaire has not been evaluated for the following reasons: (a) the user marked a question referenced by a test action as not tested, or (b) the questionnaire or question referenced by a test action has not been evaluated yet.
6.NOT_TESTED. test action または questionnaire は、次のいずれかの理由で評価されていません。(a) 利用者が、test action から参照される質問を未テストとマークした、または (b) test action から参照される questionnaire または質問がまだ評価されていません。
7.3 Questionnaire Result Calculation
7.3 質問票の結果の算出
A test action defines what needs to be tested (e.g., a question), and what action to take based on the response. An action can either be an event that triggers the next test action to be evaluated or it can simply produce a result. If the action is to produce a result, then the result SHALL be propagated up to its calling test action.
test action は、何をテストする必要があるか(たとえば質問)と、回答に基づいてどのようなアクションを取るかを定義します。アクションは、次の test action の評価を引き起こすイベントである場合もあれば、単に結果を生成する場合もあります。アクションが結果を生成するものである場合、その結果は、それを呼び出した test action まで伝播されなければなりません(SHALL)。
A questionnaire may contain multiple references to other test actions. To evaluate a questionnaire, each referenced test action SHALL be evaluated. The test_action elements within each actions element SHALL be evaluated in sequential order. The results of the referenced test actions are combined to produce the final result of the questionnaire. The following steps describe how the results SHALL be combined (in order):
questionnaire は、他の test action への複数の参照を含む場合があります。questionnaire を評価するには、参照される各 test action を評価しなければなりません(SHALL)。各 actions 要素内の test_action 要素は、順番に評価しなければなりません(SHALL)。参照された test action の結果は、組み合わされて questionnaire の最終結果が生成されます。結果をどのように組み合わせなければならないか(SHALL)を、次の手順(順番どおり)で説明します。
1.The value of the operation attribute in the actions element is applied. This attribute can either have an AND or OR value. By default, its value is set to AND. The truth table below (see Table 1) defines how to combine results. A “+” sign in the table denotes the specified value and any larger value. So, for example, “1+” means any value of 1 or greater.
1.actions 要素の operation 属性の値が適用されます。この属性の値は AND または OR のいずれかです。デフォルトでは、値は AND に設定されます。結果をどのように組み合わせるかは、下の真理値表(表 1 を参照)で定義します。表中の「+」記号は、指定された値とそれより大きい任意の値を表します。たとえば「1+」は、1 以上の任意の値を意味します。
2.The value of the negate attribute in the actions element is applied. This attribute can either have a true or false value. By default, its value is set to false. When set to true, the result returned by the questionnaire is changed in the following way: FAIL becomes PASS, PASS becomes FAIL, and all other results are unchanged.
2.actions 要素の negate 属性の値が適用されます。この属性の値は true または false のいずれかです。デフォルトでは、値は false に設定されます。true に設定すると、questionnaire が返す結果は次のように変更されます。FAIL は PASS になり、PASS は FAIL になり、その他の結果はすべて変更されません。
Table 1. Truth Table for Combining Test Action Individual Results
表 1. テストアクションの個別結果を組み合わせるための真理値表
| Operator | Number of Individual Results | Final Result | |||||
|---|---|---|---|---|---|---|---|
| PASS | FAIL | ERROR | UNKNOWN | NOT TESTED | NOT APPLICABLE | ||
| AND | 1+ | 0 | 0 | 0 | 0 | 0+ | PASS |
| 0+ | 1+ | 0+ | 0+ | 0+ | 0+ | FAIL | |
| 0+ | 0 | 1+ | 0+ | 0+ | 0+ | ERROR | |
| 0+ | 0 | 0 | 1+ | 0+ | 0+ | UNKNOWN | |
| 0+ | 0 | 0 | 0 | 1+ | 0+ | NOT TESTED | |
| 0 | 0 | 0 | 0 | 0 | 1+ | NOT APPLICABLE | |
| 0 | 0 | 0 | 0 | 0 | 0 | NOT TESTED | |
| OR | 1+ | 0+ | 0+ | 0+ | 0+ | 0+ | PASS |
| 0 | 1+ | 0 | 0 | 0 | 0+ | FAIL | |
| 0 | 0+ | 1+ | 0+ | 0+ | 0+ | ERROR | |
| 0 | 0+ | 0 | 1+ | 0+ | 0+ | UNKNOWN | |
| 0 | 0+ | 0 | 0 | 1+ | 0+ | NOT TESTED | |
| 0 | 0 | 0 | 0 | 0 | 1+ | NOT APPLICABLE | |
| 0 | 0 | 0 | 0 | 0 | 0 | NOT TESTED | |
| 演算子 | 個別結果の数 | 最終結果 | |||||
|---|---|---|---|---|---|---|---|
| PASS | FAIL | ERROR | UNKNOWN | NOT TESTED | NOT APPLICABLE | ||
| AND | 1+ | 0 | 0 | 0 | 0 | 0+ | PASS |
| 0+ | 1+ | 0+ | 0+ | 0+ | 0+ | FAIL | |
| 0+ | 0 | 1+ | 0+ | 0+ | 0+ | ERROR | |
| 0+ | 0 | 0 | 1+ | 0+ | 0+ | UNKNOWN | |
| 0+ | 0 | 0 | 0 | 1+ | 0+ | NOT TESTED | |
| 0 | 0 | 0 | 0 | 0 | 1+ | NOT APPLICABLE | |
| 0 | 0 | 0 | 0 | 0 | 0 | NOT TESTED | |
| OR | 1+ | 0+ | 0+ | 0+ | 0+ | 0+ | PASS |
| 0 | 1+ | 0 | 0 | 0 | 0+ | FAIL | |
| 0 | 0+ | 1+ | 0+ | 0+ | 0+ | ERROR | |
| 0 | 0+ | 0 | 1+ | 0+ | 0+ | UNKNOWN | |
| 0 | 0+ | 0 | 0 | 1+ | 0+ | NOT TESTED | |
| 0 | 0 | 0 | 0 | 0 | 1+ | NOT APPLICABLE | |
| 0 | 0 | 0 | 0 | 0 | 0 | NOT TESTED | |
The truth table contains two entries under each operator that generate a final result of NOT TESTED. In each case, the first entry corresponds to instances where there are no individual FAIL, ERROR, or UNKNOWN results, and at least one individual NOT TESTED result. The second entry corresponds to no individual results being returned at all.
真理値表には、最終結果が NOT TESTED になる項目が、各演算子の下にそれぞれ 2 つあります。いずれの場合も、1 つ目の項目は、個別の FAIL、ERROR、UNKNOWN の結果がなく、個別の NOT TESTED の結果が少なくとも 1 つある場合に対応します。2 つ目の項目は、個別の結果がまったく返されない場合に対応します。
Within the scope of each operator (AND and OR), the rows in the truth table are mutually exclusive; it is not possible to have a combination of test action individual results that maps to multiple rows. Any combination of test action results will produce a deterministic final result using this table.
各演算子(AND と OR)の範囲内では、真理値表の行は互いに排他的です。test action の個別結果の組み合わせが、複数の行に対応することはあり得ません。test action の結果のどのような組み合わせでも、この表を使用して決定的な最終結果が得られます。
7.4 Test_Action Processing
7.4 Test_Action の処理
Every test_action that references a question MAY contain any or all of the following elements: when_error, when_unknown, when_not_tested, and when_not_applicable. When a test_action evaluates to a value with no defined action, the result SHALL be an ERROR. For example, if a user marks a test as NOT_APPLICABLE, but there is no when_not_applicable handler, the test_action SHALL evaluate to ERROR. Likewise, if a normal answer (boolean, number, string, etc.) is provided but there is no handler for that answer, this SHALL also evaluate to ERROR. For example, if the response is 9, but there is no when_equals or when_range handlers that match a value of 9, then an ERROR SHALL be returned. This means that, apart from an ERROR result, the only time any other result values are returned by a test action would be if the handler explicitly provided a return value.
質問を参照するすべての test_action は、when_error、when_unknown、when_not_tested、when_not_applicable のうち、一部またはすべての要素を含んでもよいです(MAY)。test_action が、定義されたアクションのない値に評価された場合、結果は ERROR でなければなりません(SHALL)。たとえば、利用者がテストを NOT_APPLICABLE とマークしたものの when_not_applicable ハンドラーがない場合、test_action は ERROR に評価されなければなりません(SHALL)。同様に、通常の回答(boolean、数値、文字列など)が提供されたものの、その回答に対するハンドラーがない場合も、ERROR に評価されなければなりません(SHALL)。たとえば、回答が 9 であるものの、値 9 に一致する when_equals ハンドラーも when_range ハンドラーもない場合は、ERROR を返さなければなりません(SHALL)。これは、ERROR の結果を除き、test action がその他の結果の値を返すのは、ハンドラーが明示的に戻り値を指定した場合のみであることを意味します。
Consider the following example:
次の例を考えてみましょう。
(Source: ISO IEC 27002 2005 Information Security Audit Tool)
(出典: ISO IEC 27002 2005 Information Security Audit Tool)
8.1 Question 1. Have you reduced the risk of theft, fraud, or misuse of
facilities by making sure that all prospective employees understand their
responsibilities before you hire them? YES NO N/A
The question requires an answer of YES, NO, or N/A (Not Applicable). It is best modeled with a boolean_question element. For instance,
この質問には、YES、NO、N/A(Not Applicable)のいずれかの回答が必要です。これは boolean_question 要素でモデル化するのが最適です。たとえば次のようになります。
<boolean_question id="ocil:org.mitre:question:1" model="MODEL_YES_NO">
<question_text>
Have you reduced the risk of theft, fraud, or misuse of facilities by
making sure that all prospective employees understand their
responsibilities before you hire them?
</question_text>
</boolean_question>
To describe what happens when a user responds to this type of question, a boolean_question_test_action can be defined in the following manner:
利用者がこの種の質問に回答したときに何が起こるかを記述するために、boolean_question_test_action を次のように定義できます。
<boolean_question_test_action id="ocil:org.mitre:testaction:1"
question_ref="ocil:org.mitre:question:1">
<when_true>
<result>PASS</result>
</when_true>
<when_false>
<test_action_ref>ocil:org.mitre:testaction:2</test_action_ref>
</when_false>
<when_not_applicable>
<test_action_ref>ocil:org.mitre:testaction:3</test_action_ref>
</when_not_applicable>
</boolean_question_test_action>
An OCIL implementation SHALL present the referenced question. Based on the response to the question, the test action would perform different actions. Specifically, if the response is:
OCIL 実装は、参照された質問を提示しなければなりません(SHALL)。質問への回答に基づいて、test action はさまざまなアクションを実行します。具体的には、回答が次の場合です。
| YES | The when_true handler is invoked, which sets the result of this test action to PASS. |
|---|---|
| NO | The when_false handler is invoked. This causes the implementation to evaluate the test action with id ocil:org |
| N/A | The when_not_applicable handler is invoked. This causes the implementation to evaluate the test action with id ocil:org |
| Anything else | There is no handler for any other responses, so other responses set the result of this test action to ERROR. |
| YES | when_true ハンドラーが呼び出され、この test action の結果が PASS に設定されます。 |
|---|---|
| NO | when_false ハンドラーが呼び出されます。これにより、実装は id が ocil:org |
| N/A | when_not_applicable ハンドラーが呼び出されます。これにより、実装は id が ocil:org |
| それ以外 | その他の回答に対するハンドラーはないため、その他の回答では、この test action の結果は ERROR に設定されます。 |
Note that for simplicity purposes, ‘yes’ and ‘true’ responses are mapped to a when_true element. Similarly, ‘no’ and ‘false’ responses are mapped to a when_false element.
なお、簡略化のため、「yes」と「true」の回答は when_true 要素に対応付けられます。同様に、「no」と「false」の回答は when_false 要素に対応付けられます。
A choice_question_test_action contains a set of when_choice elements. A when_choice element defines what action to take when the response matches one of a list of choices. The schema prevents multiple when_choice elements from containing references to the same choice within a single choice_test_action.
choice_question_test_action には、when_choice 要素の集合が含まれます。when_choice 要素は、回答が選択肢の一覧のいずれかに一致する場合に、どのアクションを取るかを定義します。スキーマにより、単一の choice_test_action 内で、複数の when_choice 要素が同じ選択肢への参照を含むことはできません。
A numeric_question_test_action contains a set of when_equals and/or when_range elements. A when_equals element defines what action to take when a particular value matches the response. Similarly, a when_range element defines what action to take when the response is within a specified range of values, for example [29,100], [101,132), or (131, 249]. If the response matches multiple conditions, then the first matching handler SHALL be applied based on the order the handlers appear within the document. Since when_equals handlers always come before when_range handlers, preference is given to exact matches.
numeric_question_test_action には、when_equals 要素または when_range 要素(あるいはその両方)の集合が含まれます。when_equals 要素は、特定の値が回答に一致する場合に、どのアクションを取るかを定義します。同様に、when_range 要素は、回答が指定された値の範囲内にある場合に、どのアクションを取るかを定義します。範囲の例は [29,100]、[101,132)、(131, 249] などです。回答が複数の条件に一致する場合は、文書内でのハンドラーの出現順に基づいて、最初に一致したハンドラーを適用しなければなりません(SHALL)。when_equals ハンドラーは常に when_range ハンドラーの前に来るため、完全一致が優先されます。
A string_question_test_action contains a set of when_pattern elements. A when_pattern element defines what action to taken when the response matches a particular regular expression. Similar to numeric_test_action, if the response matches multiple conditions, then the first when_pattern matched SHALL be applied based on their order within the document.
string_question_test_action には、when_pattern 要素の集合が含まれます。when_pattern 要素は、回答が特定の正規表現に一致する場合に、どのアクションを取るかを定義します。numeric_test_action と同様に、回答が複数の条件に一致する場合は、文書内での順序に基づいて、最初に一致した when_pattern を適用しなければなりません(SHALL)。
7.5 Questions with Multiple References
7.5 複数の参照を持つ質問
A single question MAY be referenced by multiple test_actions within an OCIL document. If a question has already been answered during an evaluation, the same question SHOULD NOT be answered again in the same evaluation. Instead, the implementation SHOULD cache the answer to the first instance of the question and reuse that answer when evaluating any other test actions that use the same question.
1 つの question は、OCIL 文書内の複数の test_action から参照されてもよいです(MAY)。評価中に質問にすでに回答済みである場合、同じ評価の中で同じ質問に再度回答させるべきではありません(SHOULD NOT)。代わりに、実装は、質問の最初のインスタンスへの回答をキャッシュし、同じ質問を使用する他の test action を評価する際に、その回答を再利用すべきです(SHOULD)。
7.6 Artifact Submission
7.6 アーティファクトの提出
A user or system MAY be asked to submit an artifact to support a response to one or more questions within a questionnaire.
利用者またはシステムは、questionnaire 内の 1 つ以上の質問への回答を裏付けるために、アーティファクトの提出を求められてもよいです(MAY)。
If an artifact element’s persistent attribute is set to TRUE and/or an artifact_ref element’s required attribute is set to TRUE, then
artifact 要素の persistent 属性が TRUE に設定されている場合、または artifact_ref 要素の required 属性が TRUE に設定されている場合(あるいはその両方の場合)は、次のとおりです。
1.The user or system SHALL be informed that the artifact is required.
1.アーティファクトが必須であることを、利用者またはシステムに通知しなければなりません(SHALL)。
2.The artifact SHALL be collected; otherwise, an ERROR result SHALL be generated.
2.アーティファクトを収集しなければなりません(SHALL)。収集しない場合は、ERROR の結果を生成しなければなりません(SHALL)。
If an artifact element’s persistent attribute is set to FALSE and an artifact_ref element’s required attribute is set to FALSE, then
artifact 要素の persistent 属性が FALSE に設定され、かつ artifact_ref 要素の required 属性が FALSE に設定されている場合は、次のとおりです。
1.The user or system SHALL be informed that the artifact is optional.
1.アーティファクトが任意であることを、利用者またはシステムに通知しなければなりません(SHALL)。
2.The artifact SHALL be collected if the user or system supplies it; otherwise, evaluation of the OCIL document SHALL continue without the artifact collection.
2.利用者またはシステムがアーティファクトを提供した場合は、それを収集しなければなりません(SHALL)。提供しなかった場合は、アーティファクトの収集なしで OCIL 文書の評価を続行しなければなりません(SHALL)。
7.7 Variable Processing
7.7 変数の処理
The value of any variable SHALL be computed before it is used.
あらゆる変数の値は、使用する前に計算しなければなりません(SHALL)。
For each local_variable, the question it references SHALL be posed before the variable’s use.
各 local_variable については、その変数を使用する前に、それが参照する質問を提示しなければなりません(SHALL)。
The value of a local_variable is determined based on the answer to the question that it links to. The local_variable MAY have one or more set elements defined. If so, the variable’s value SHALL be computed based on those set elements; the value stored in the first set element that produces a matched pattern SHALL be used. If none of the set elements have a pattern that matches the answer, then an ERROR result SHALL be generated by all referencing test_actions.
local_variable の値は、リンク先の質問への回答に基づいて決まります。local_variable には、1 つ以上の set 要素が定義されていてもよいです(MAY)。その場合、変数の値はそれらの set 要素に基づいて計算しなければならず(SHALL)、一致するパターンを生成した最初の set 要素に格納された値を使用しなければなりません(SHALL)。回答に一致するパターンを持つ set 要素が 1 つもない場合は、参照するすべての test_action が ERROR の結果を生成しなければなりません(SHALL)。
If no set element is present, the value used SHALL be the same as the answer, with a few exceptions. The value mappings are as follows:
set 要素がない場合、使用する値は、いくつかの例外を除き、回答と同じでなければなりません(SHALL)。値の対応関係は次のとおりです。
1.If the question is a boolean question and the variable data type is NUMERIC, then the value based on the answer SHALL be 1 for true and 0 for false.
1.質問が boolean 型の質問で、変数のデータ型が NUMERIC の場合、回答に基づく値は、true なら 1、false なら 0 でなければなりません(SHALL)。
2.If the question is a boolean question and the variable data type is TEXT, then the value SHALL be determined by the question's model as follows:
2.質問が boolean 型の質問で、変数のデータ型が TEXT の場合、値は次のとおり、質問のモデルによって決定しなければなりません(SHALL)。
a.MODEL_YES_NO: the value is yes if true or no if false.
a.MODEL_YES_NO: 値は、true なら yes、false なら no です。
b.MODEL_TRUE_FALSE: the value is true if true or false if false.
b.MODEL_TRUE_FALSE: 値は、true なら true、false なら false です。
3.If the question is a choice question, the variable data type SHALL be TEXT and the value SHALL be set to the text value of the choice.
3.質問が choice 型の質問の場合、変数のデータ型は TEXT でなければならず(SHALL)、値は選択肢のテキスト値に設定しなければなりません(SHALL)。
4.If the question is a numeric question, the variable data type SHALL be NUMERIC and the value SHALL be set to the value of the answer.
4.質問が numeric 型の質問の場合、変数のデータ型は NUMERIC でなければならず(SHALL)、値は回答の値に設定しなければなりません(SHALL)。
5.If the question is a string question, the variable data type SHALL be TEXT and the value SHALL be set to the value of the answer.
5.質問が string 型の質問の場合、変数のデータ型は TEXT でなければならず(SHALL)、値は回答の値に設定しなければなりません(SHALL)。
If a local variable is referenced and the value cannot be determined, then the referencing question or test action SHALL cause an ERROR result to be generated by all referencing test actions.
ローカル変数が参照され、その値を決定できない場合、参照する質問または test action は、参照するすべての test action に ERROR の結果を生成させなければなりません(SHALL)。
If the value for an external_variable cannot be retrieved from an external source, then the referencing question or test_action SHALL cause an ERROR result to be generated whenever a test_action attempts to use the variable during evaluation. If the variable is not referenced during an evaluation—for example, the variable is used by a test_action that is not called during a particular evaluation—then an ERROR result SHOULD NOT be generated.
external_variable の値を外部ソースから取得できない場合、参照する質問または test_action は、評価中に test_action がその変数を使用しようとするたびに、ERROR の結果を生成させなければなりません(SHALL)。評価中に変数が参照されない場合(たとえば、特定の評価の間に呼び出されない test_action がその変数を使用している場合)は、ERROR の結果を生成すべきではありません(SHOULD NOT)。
7.8 Graceful Error Handling
7.8 適切なエラー処理
When initially processing an OCIL document, an OCIL implementation SHOULD check for all forms of circular references, such as a questionnaire or test action that calls itself, and a question that has a variable that gets its value from the same question. The implementation SHOULD handle these circular references gracefully, such as producing an informative error message detailing the circular references instead of displaying questionnaires containing circular references.
OCIL 文書を最初に処理する際、OCIL 実装は、questionnaire や test action が自分自身を呼び出す場合や、質問が同じ質問から値を取得する変数を持つ場合など、あらゆる形の循環参照を確認すべきです(SHOULD)。実装は、これらの循環参照を適切に処理すべきです(SHOULD)。たとえば、循環参照を含む questionnaire を表示する代わりに、循環参照の詳細を示す、有益なエラーメッセージを生成します。
An OCIL implementation SHOULD NOT suddenly terminate its execution due to an error condition. OCIL implementations SHOULD handle all exceptional conditions gracefully by performing proper error and exception handling. For all such conditions that do not have handling requirements defined elsewhere in this specification, the implementation SHOULD produce an informative error message. For exceptional conditions involving questionnaire evaluation, implementations MAY set results appropriately, based on the nature of the exceptional condition, and skip a section of a questionnaire or an entire questionnaire to allow evaluation of other questionnaires or questionnaire sections to proceed.
OCIL 実装は、エラー状態によって実行を突然終了すべきではありません(SHOULD NOT)。OCIL 実装は、適切なエラー処理と例外処理を行うことで、すべての例外的な状況を適切に処理すべきです(SHOULD)。この仕様の他の箇所で処理要件が定義されていないそのようなすべての状況について、実装は有益なエラーメッセージを生成すべきです(SHOULD)。questionnaire の評価に関わる例外的な状況では、実装は、例外的な状況の性質に基づいて結果を適切に設定し、questionnaire の一部または questionnaire 全体をスキップして、他の questionnaire や questionnaire の部分の評価を続行できるようにしてもよいです(MAY)。
7.9 The generator Element
7.9 generator 要素
Additional information not covered by the standard properties of the generator element may be supplied after those properties. However, OCIL implementations MAY choose to ignore this information.
generator 要素の標準のプロパティで扱われていない追加情報は、それらのプロパティの後に提供してもよいです。ただし、OCIL 実装は、この情報を無視することを選んでもよいです(MAY)。
Appendix A—Use Cases
付録 A—ユースケース
As discussed in Section 1, OCIL can be used in many ways to gather information from previous data collection efforts and from people. This appendix describes several common use cases for OCIL. Other use cases are possible, and the authors encourage people with additional use cases to submit them for inclusion in the final version of this specification.
第 1 節で論じたように、OCIL は、過去のデータ収集と人から情報を収集するために、さまざまな方法で使用できます。この付録では、OCIL の一般的なユースケースをいくつか説明します。ほかのユースケースも考えられ、著者は、追加のユースケースを持つ方々が、この仕様の最終版に含めるためにそれらを提出することを推奨します。
Aggregating Results
結果の集約
OCIL can be used to aggregate results from multiple data sources.
OCIL は、複数のデータソースからの結果を集約するために使用できます。
An example is using OCIL to convert disparate information into a single standardized format. If an organization has several existing sources of system configuration management information, each of which has information on the status of configurations for various systems, applications, and other IT components, OCIL could be used to harvest information from these sources and store it in a standardized format. This aggregated information could then be combined with other sources, such as the results of OVAL evaluations, and fed into a single entity, such as a dashboard. This would allow many sources of information to be viewed and analyzed from a single interface.
一例は、OCIL を使用して、バラバラの情報を単一の標準化された形式に変換することです。組織に、システム構成管理情報の既存のソースがいくつかあり、それぞれが、さまざまなシステム、アプリケーション、その他の IT コンポーネントの構成状況に関する情報を持っている場合、OCIL を使用して、これらのソースから情報を取り込み、標準化された形式で保存できます。この集約された情報は、OVAL の評価結果などの他のソースと組み合わせて、ダッシュボードなどの単一のエンティティに取り込むことができます。これにより、多くの情報源を単一のインターフェースから閲覧し、分析できるようになります。
Supplementing Automated System Checks
自動化されたシステムチェックの補完
When evaluating a system, OCIL can be used to perform manual checks that cannot be performed in a fully automated manner.
システムを評価する際、OCIL を使用して、完全に自動化された方法では実施できない手動チェックを実施できます。
An example of this is using OCIL with XCCDF. Suppose that someone writes an XCCDF document containing system security checks to collect evidence to demonstrate PCI-DSS compliance. One of the checks requires a complex evaluation that currently cannot be automated using operating system or application supported application programming interfaces (APIs). Within the document, the author includes a reference to an OCIL document containing a manual check. A security professional assigned to the task of checking the system for compliance loads the XCCDF document into an XCCDF interpreter. Upon reaching a manual check, the XCCDF interpreter loads the OCIL document into the OCIL interpreter (either through a built-in functionality within the XCCDF interpreter or an external OCIL implementation), which asks the security officer a series of questions. The security officer's responses are collected and interpreted. The OCIL results are returned to the XCCDF interpreter, which then continues with the remaining checks and generates OVAL results. The OCIL and OVAL results are aggregated into a single report by the XCCDF interpreter, which can then be used to demonstrate PCI-DSS compliance.
一例は、OCIL を XCCDF とともに使用することです。PCI-DSS への準拠を実証する証拠を収集するため、システムセキュリティチェックを含む XCCDF 文書を誰かが作成したとします。チェックの 1 つは複雑な評価を必要とし、現時点では、オペレーティングシステムまたはアプリケーションがサポートするアプリケーションプログラミングインターフェース(API)を使用して自動化できません。作成者は、文書内に、手動チェックを含む OCIL 文書への参照を記載します。システムの準拠をチェックする任務を割り当てられたセキュリティ専門家が、XCCDF 文書を XCCDF インタープリターに読み込みます。手動チェックに到達すると、XCCDF インタープリターは、OCIL 文書を OCIL インタープリターに読み込みます(XCCDF インタープリターに組み込まれた機能、または外部の OCIL 実装を通じて)。OCIL インタープリターはセキュリティ担当者に一連の質問をします。セキュリティ担当者の回答が収集され、解釈されます。OCIL の結果は XCCDF インタープリターに返され、XCCDF インタープリターは残りのチェックを続行して OVAL の結果を生成します。OCIL と OVAL の結果は、XCCDF インタープリターによって 1 つの報告書に集約され、PCI-DSS への準拠を実証するために使用できます。
Collecting Information from People
人からの情報収集
OCIL can be used to collect information from people, such as their knowledge, responsibilities, interests, and opinions.
OCIL は、人から、その知識、責任、関心、意見などの情報を収集するために使用できます。
An example of this is collecting information from building evacuation coordinators, who are responsible for ensuring that employees and visitors are safely evacuated from the building during emergencies or drills. After each evacuation, all of the coordinators are emailed a request to submit an evacuation report. The email contains a link to a form on the organization’s internal web site; this form is the front-end to an OCIL document. The user answers the questions in the form, such as how long it took to evacuate everyone. In some cases, the answer to a question causes different questions to be asked; for example, responding “yes” to “Were there problems during the evacuation?” would cause additional questions regarding the nature of the problems to be displayed. When the user finishes the form, the results are submitted to a repository, so that the organization’s safety officials can analyze and review all the results.
一例は、建物の避難調整担当者から情報を収集することです。避難調整担当者は、緊急時や訓練時に、従業員と来訪者が建物から安全に避難することを確実にする責任を負っています。各避難の後、すべての調整担当者に、避難報告書の提出を依頼するメールが送られます。このメールには、組織の社内 Web サイトにあるフォームへのリンクが含まれています。このフォームは、OCIL 文書のフロントエンドです。利用者は、全員が避難するのにかかった時間など、フォームの質問に回答します。場合によっては、質問への回答によって、異なる質問が尋ねられます。たとえば、「避難中に問題がありましたか?」に「はい」と回答すると、問題の性質に関する追加の質問が表示されます。利用者がフォームへの入力を終えると、結果がリポジトリーに提出され、組織の安全担当者がすべての結果を分析し、レビューできるようになります。
Another example of this use case is collecting information during the initial planning of a system audit. Planning may involve identifying systems, networks, applications, and other IT components to be included in the audit. OCIL can be used by auditors to collect information from key personnel about these components. Since this information is collected and stored using standardized, automated means, it can be quickly evaluated by auditors, who select the components to be audited and feed the pertinent information into tools such as vulnerability assessment scanners, thus helping to automate and expedite the assessment process.
このユースケースの別の例は、システム監査の最初の計画中に情報を収集することです。計画には、監査に含めるシステム、ネットワーク、アプリケーション、その他の IT コンポーネントの特定が含まれる場合があります。監査人は、OCIL を使用して、これらのコンポーネントに関する情報を主要な担当者から収集できます。この情報は、標準化された自動化された手段で収集・保存されるため、監査人が迅速に評価でき、監査人は、監査対象のコンポーネントを選択し、関連する情報を脆弱性評価スキャナーなどのツールに取り込めます。これにより、評価プロセスの自動化と迅速化に役立ちます。
Walking Users through Instructions
利用者への手順の案内
OCIL can present users with instructions, as a series of steps, and ask questions along with these instructions.
OCIL は、一連の手順として利用者に指示を提示し、それらの指示とともに質問をすることができます。
An example is collecting information as part of a property inventory audit. Through an OCIL document, users are presented with instructions to guide them in determining how to identify individual pieces of property and where to find the property label. Identifying the property number may be difficult for users, so instructions may help them—for example, guiding them to the location of the label and helping them to distinguish the property number from other pieces of information on the label. Finally, the OCIL document reports the property information to a centralized repository of property asset data.
一例は、資産棚卸監査の一環として情報を収集することです。OCIL 文書を通じて、利用者には、個々の資産をどのように特定するか、資産ラベルがどこにあるかを判断するための指示が提示されます。資産番号の特定は利用者にとって難しい場合があるため、指示が役立つことがあります。たとえば、ラベルの場所へ案内したり、ラベル上の他の情報と資産番号を区別する助けとなったりします。最後に、OCIL 文書は、資産情報を、資産データの一元的なリポジトリーに報告します。
Collecting Text, Files, and Resource References
テキスト、ファイル、リソース参照の収集
OCIL can collect blocks of text, copies of files, and references to resources (including URLs) from systems.
OCIL は、システムから、テキストのブロック、ファイルのコピー、(URL を含む)リソースへの参照を収集できます。
An example is collecting copies of a configuration file from systems. The exact file that needs to be collected from each system depends on certain characteristics of each system’s configuration. This system configuration information was recently collected for a different purpose and is stored in a database. The pertinent information in this database could be harvested through automated techniques and used by an OCIL document to determine which configuration file needs to be collected from each system. The OCIL document would then transfer a copy of the appropriate file to a central server for subsequent review, along with a copy of the pertinent system configuration characteristics.
一例は、システムから構成ファイルのコピーを収集することです。各システムから収集する必要があるファイルは、各システムの構成の特定の特性によって決まります。このシステム構成情報は、最近、別の目的で収集され、データベースに保存されています。このデータベース内の関連情報は、自動化された手法で取り込まれ、各システムからどの構成ファイルを収集する必要があるかを判断するために、OCIL 文書によって使用できます。その後、OCIL 文書は、適切なファイルのコピーを、関連するシステム構成の特性のコピーとともに、後のレビューのために中央サーバーへ転送します。
Appendix B—Use of OCIL as an XCCDF Check System
付録 B—XCCDF のチェックシステムとしての OCIL の使用
This appendix defines requirements for using OCIL as a check system for XCCDF. These requirements supplement the other OCIL requirements in this publication, as well as XCCDF requirements as documented in NIST IR 7275 Revision 3, Specification for the Extensible Configuration Checklist Description Format (XCCDF),4 and any subsequent releases of the XCCDF version 1.x specification.
この付録では、OCIL を XCCDF のチェックシステムとして使用するための要件を定義します。これらの要件は、この刊行物のその他の OCIL の要件を補完するものであり、NIST IR 7275 Revision 3, Specification for the Extensible Configuration Checklist Description Format (XCCDF)4 および XCCDF バージョン 1.x 仕様のその後のリリースに記載された XCCDF の要件も補完します。
B.1 OCIL <xccdf:check> Usage
B.1 OCIL <xccdf:check> の使用
References from XCCDF to OCIL questionnaires SHALL use the form:
XCCDF から OCIL の questionnaire への参照は、次の形式を使用しなければなりません(SHALL)。
<check-content-ref href="OCIL_Source_URI" name="OCIL_Questionnaire_Id"/>
The @href attribute SHALL identify the location of the OCIL questionnaire. The @name attribute SHALL refer to a specific questionnaire identifier within the @href source. When an XCCDF rule references a specific OCIL questionnaire, an OCIL questionnaire source SHALL be available to resolve the reference.
@href 属性は、OCIL の questionnaire の場所を特定しなければなりません(SHALL)。@name 属性は、@href のソース内の特定の questionnaire の識別子を参照しなければなりません(SHALL)。XCCDF の規則が特定の OCIL の questionnaire を参照する場合、その参照を解決するために、OCIL の questionnaire のソースが利用可能でなければなりません(SHALL)。
In the syntax shown above, the <xccdf:check-content-ref> element’s @href attribute refers to an OCIL questionnaire containing one or more test actions. This @check-content-ref is equivalent to referencing an OCIL questionnaire of the form:
上に示した構文では、<xccdf:check-content-ref> 要素の @href 属性は、1 つ以上の test action を含む OCIL の questionnaire を参照します。この @check-content-ref は、次の形式の OCIL の questionnaire を参照することと同等です。
<questionnaire id="identifier of questionnaire" child_only="false">
<title>…</title>
<description>…</description>
<references>…</references>
<actions>
<test_action_ref>identifier of test action</test_action_ref>
</actions>
</questionnaire>
B.2 <xccdf:Value> and OCIL Variable Dependencies
B.2 <xccdf:Value> と OCIL 変数の依存関係
OCIL provides support for defining values that can be reused in stating questions and evaluating questionnaires. These values MAY be passed from XCCDF as value parameters and into OCIL as external variables.
OCIL は、質問の記述や質問票の評価で再利用できる値を定義するための支援を提供します。これらの値は、XCCDF から値パラメーターとして渡され、OCIL に外部変数として入力されてもよいです(MAY)。
When an XCCDF rule refers to an OCIL questionnaire requiring one or more external variables, the XCCDF rule SHALL include <xccdf:check-export> elements that define the mapping from an XCCDF value to an OCIL external variable. The format of these elements is:
XCCDF の規則が、1 つ以上の外部変数を必要とする OCIL の質問票を参照する場合、その XCCDF の規則は、XCCDF の値から OCIL の外部変数へのマッピングを定義する <xccdf:check-export> 要素を含めなければなりません(SHALL)。これらの要素の形式は次のとおりです。
<check-export xmlns="http://checklists.nist.gov/xccdf/1.1"
value-id="XCCDF_Value_id" export-name="OCIL_External_Variable_id"/>
The following example demonstrates the use of this convention:
次の例は、この規約の使用方法を示しています。
<check system="http://www.mitre.org/ocil/2">
<check-export value-id="OnlyLaptops_var"
export-name="ocil:gov.nist.abc.xp:var:11000"/>
<check-export value-id="HighAlertPolicy_var"
export-name="ocil:gov.nist.abc.xp:var:11001"/>
<check-content-ref href="abc-all-ocil.xml"
name="ocil:gov.nist.abc.xp:def:11001"/>
</check>
The type and value binding of the specified XCCDF value SHALL be constrained to match the indicated OCIL variable data type. Table 2 summarizes the constraints regarding data type usage.
指定された XCCDF の値の型と値のバインディングは、示された OCIL の変数のデータ型に一致するように制約しなければなりません(SHALL)。表 2 に、データ型の使用に関する制約をまとめます。
Table 2. XCCDF-OCIL Data Export Matching Constraints
表 2. XCCDF と OCIL のデータエクスポートの照合制約
| OCIL Variable Data Type | Matching XCCDF Data Type |
|---|---|
| TEXT | string; boolean |
| NUMERIC | number |
| OCIL の変数のデータ型 | 対応する XCCDF のデータ型 |
|---|---|
| TEXT | string、boolean |
| NUMERIC | number |
B.3 Mapping OCIL Results to XCCDF Results
B.3 OCIL の結果から XCCDF の結果へのマッピング
OCIL supports full status reporting. See Table 3 for mapping from OCIL questionnaire results to XCCDF results. When evaluated, an OCIL document MAY contain an <ocil:results> element that contains all the questionnaire results, including user responses and artifacts.
OCIL は、完全なステータス報告をサポートします。OCIL 質問票の結果から XCCDF の結果へのマッピングは、表 3 を参照してください。評価された OCIL 文書には、利用者の回答とアーティファクトを含む、すべての質問票の結果を含む <ocil:results> 要素が含まれてもよいです(MAY)。
Table 3. Deriving XCCDF Rule Results from OCIL Questionnaire Results
表 3. OCIL の質問票の結果からの XCCDF ルール結果の導出
| OCIL Questionnaire Result | XCCDF Rule Result |
|---|---|
| ERROR | error |
| UNKNOWN | unknown |
| NOT_APPLICABLE | notapplicable |
| NOT_TESTED | notchecked |
| PASS | pass |
| FAIL | fail |
| OCIL の質問票の結果 | XCCDF のルール結果 |
|---|---|
| ERROR | error |
| UNKNOWN | unknown |
| NOT_APPLICABLE | notapplicable |
| NOT_TESTED | notchecked |
| PASS | pass |
| FAIL | fail |
Appendix C—Change Log
付録 C—変更履歴
2.0 DRAFT 1 – 24 August 2009
2.0 ドラフト 1 – 2009 年 8 月 24 日
•Initial draft specification released to the OCIL community for comment.
•コメントを求めて、最初のドラフト仕様を OCIL コミュニティに公開しました。
2.0 DRAFT 2 – 22 October 2010 (first CSRC Draft)
2.0 ドラフト 2 – 2010 年 10 月 22 日(最初の CSRC ドラフト)
•Editorial changes throughout the document. Condensed or removed most background information.
•文書全体の編集上の変更。背景情報の大半を要約または削除しました。
•Removed the OCIL schema appendix (Appendix A) and the OCIL content example appendix (Appendix B) from the document, and posted them online.
•OCIL スキーマの付録(付録 A)と OCIL コンテンツ例の付録(付録 B)を文書から削除し、オンラインで公開しました。
•Created new sections on conformance (Section 3) and OCIL’s relationships to existing specifications and standards (Section 4). Created new appendix on requirements for using OCIL as an XCCDF check system (Appendix B).
•適合性に関する新しい節(第 3 節)と、OCIL と既存の仕様・標準との関係に関する新しい節(第 4 節)を作成しました。OCIL を XCCDF のチェックシステムとして使用するための要件に関する新しい付録(付録 B)を作成しました。
•Moved the Vision for Use (Section 1.2) material into a new appendix (Appendix A), converted it into use cases, and expanded it.
•Vision for Use(第 1.2 節)の内容を新しい付録(付録 A)に移し、ユースケースに変換して拡張しました。
•Expanded the Data Model section to include additional elements and attributes.
•追加の要素と属性を含めるように、データモデルの節を拡張しました。
•Separated requirements into two sections, one on OCIL content (Section 6) and one on OCIL processing (Section 7). Moved requirements from the data model section to these sections.
•要件を、OCIL コンテンツに関する節(第 6 節)と OCIL の処理に関する節(第 7 節)の 2 つに分けました。要件をデータモデルの節からこれらの節に移しました。
•Removed the priority and scope attributes, and the PriorityType and ScopeType types.
•priority 属性と scope 属性、および PriorityType 型と ScopeType 型を削除しました。
•Made several changes to how artifact-related information is structured.
•アーティファクト関連情報の構造化の方法を、いくつか変更しました。
•Added the QuestionTextType type to allow substitution of local variables into question text.
•ローカル変数を質問テキストに代入できるように、QuestionTextType 型を追加しました。
•Altered how set elements are used for local variables.
•ローカル変数に対する set 要素の使用方法を変更しました。
•Deleted the default_value element for external variables.
•外部変数の default_value 要素を削除しました。
2.0 FINAL – 7 April 2011
2.0 最終版 – 2011 年 4 月 7 日
•Minor editorial changes throughout the document.
•文書全体の軽微な編集上の変更。
•Added discussion of applying digital signatures to OCIL results.
•OCIL の結果へのデジタル署名の適用に関する議論を追加しました。
•Added the additional_data element to the generator element.
•generator 要素に additional_data 要素を追加しました。
•Expanded the binary_artifact_value and text_artifact_value child elements to include the MIME type for the data they hold.
•binary_artifact_value と text_artifact_value の子要素を、保持するデータの MIME タイプを含むように拡張しました。
•Clarified the composition of the unique identifiers for questionnaire, test_action, question, artifact, and variable elements.
•questionnaire、test_action、question、artifact、variable の各要素の一意の識別子の構成を明確にしました。
