目次

NIST IR 7696 日本語訳

英語タイトル : Common Platform Enumeration: Name Matching Specification Version 2.3
日本語タイトル : 共通プラットフォーム列挙:名前照合仕様 バージョン 2.3
公開日 : 2011-08-19
原文URL : https://csrc.nist.gov/pubs/ir/7696/final
翻訳編集 : 自動生成(有志による非公式の日本語訳), 原文取得日 : 2026-10-31, 訳文 : 260 / 272 ブロック

[要約] NIST IR 7696 は、Common Platform Enumeration(CPE)Name Matching バージョン 2.3 仕様を定義する報告書です。CPE Name Matching 仕様は、IT 製品の記述と命名に関するさまざまなユースケースを支援する CPE 仕様群の一部であり、元の CPE 名と対象の CPE 名の 1 対 1 の比較を行う方法を提供します。名前照合の概要として CPE 名の構成要素と技術的制約を説明し、属性比較と名前比較の集合関係、ワイルドカード属性の比較を扱ったうえで、名前照合の擬似コード(コア関数とサポート関数)を示します。仕様の定義に加えて、IT 製品が仕様に適合するために満たさなければならない要件も定義し、説明しています。

図表
[NIST logo — not reproduced on this unofficial site]

[NIST のロゴ。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]

NIST Interagency Report 7696

NIST Interagency Report 7696

Common Platform Enumeration: Name Matching Specification Version 2.3

Common Platform Enumeration: Name Matching Specification バージョン 2.3

Mary C. Parmelee
Harold Booth
David Waltermire
Karen Scarfone

Mary C. Parmelee
Harold Booth
David Waltermire
Karen Scarfone

NIST Interagency Report 7696

NIST Interagency Report 7696

Common Platform Enumeration: Name Matching Specification Version 2.3

Common Platform Enumeration: Name Matching Specification バージョン 2.3

Mary C. Parmelee
Harold Booth
David Waltermire
Karen Scarfone

Mary C. Parmelee
Harold Booth
David Waltermire
Karen Scarfone

COMPUTER SECURITY

コンピュータセキュリティ

図表
[U.S. Department of Commerce seal — not reproduced on this unofficial site]

[米国商務省の紋章。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]

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

August 2011

2011 年 8 月

U.S. Department of Commerce

米国商務省

Rebecca M. Blank, Acting Secretary

Rebecca M. Blank 長官代理

National Institute of Standards and Technology

National Institute of Standards and Technology

Patrick D. Gallagher, Under Secretary for Standards and Technology and Director

Patrick D. Gallagher、NIST 所長兼商務次官(標準・技術担当)

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 の責務には、連邦のコンピュータシステムにおける機微だが非機密の情報を費用対効果に優れた形で保護するための、技術的、物理的、管理的および運営上の標準とガイドラインの策定が含まれます。この省庁間報告書は、コンピュータセキュリティにおける ITL の研究、ガイダンス、アウトリーチの取り組みと、産業界、政府、学術機関との共同活動について論じています。

National Institute of Standards and Technology Interagency Report 7696
28 pages (Aug. 2011)

National Institute of Standards and Technology Interagency Report 7696
28 ページ(2011 年 8 月)

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, Mary C. Parmelee of The MITRE Corporation, Harold Booth and David Waltermire of the National Institute of Standards and Technology (NIST), and Karen Scarfone of Scarfone Cybersecurity wish to thank their colleagues who reviewed drafts of this document and contributed to its technical content. The authors would like to acknowledge Brant A. Cheikes of The MITRE Corporation, Paul Cichonski of NIST, Adam Halbardier of Booz Allen Hamilton, Seth Hanford of Cisco Systems, Inc., Tim Keanini of nCircle, Kent Landfield of McAfee, Inc., Jim Ronayne of Varen Technologies, Shane Shaffer of G2, Inc., and Joseph L. Wolfkiel of the US Department of Defense for their insights and support throughout the development of the document.

著者である The MITRE Corporation の Mary C. Parmelee、National Institute of Standards and Technology(NIST)の Harold Booth と David Waltermire、Scarfone Cybersecurity の Karen Scarfone は、この文書のドラフトをレビューし、その技術的内容に貢献してくださった同僚の皆様に感謝します。文書の作成全体を通じて洞察と支援をいただいた、The MITRE Corporation の Brant A. Cheikes、NIST の Paul Cichonski、Booz Allen Hamilton の Adam Halbardier、Cisco Systems, Inc. の Seth Hanford、nCircle の Tim Keanini、McAfee, Inc. の Kent Landfield、Varen Technologies の Jim Ronayne、G2, Inc. の Shane Shaffer、米国国防総省の Joseph L. Wolfkiel に謝意を表します。

Abstract

概要

This report defines the Common Platform Enumeration (CPE) Name Matching version 2.3 specification. The CPE Name Matching specification is part of a stack of CPE specifications that support a variety of use cases relating to IT product description and naming. The CPE Name Matching specification provides a method for conducting a one-to-one comparison of a source CPE name to a target CPE name. In addition to defining the specification, this report also defines and explains the requirements that IT products must meet for conformance with the CPE Name Matching version 2.3 specification.

この報告書は、Common Platform Enumeration(CPE)Name Matching バージョン 2.3 仕様を定義します。CPE Name Matching 仕様は、IT 製品の記述と命名に関するさまざまなユースケースを支援する、CPE 仕様群の一部です。CPE Name Matching 仕様は、元の CPE 名と対象の CPE 名の 1 対 1 の比較を行う方法を提供します。この報告書は、仕様の定義に加えて、IT 製品が CPE Name Matching バージョン 2.3 仕様に適合するために満たさなければならない要件も定義し、説明します。

Trademark Information

商標情報

CPE is a trademark of The MITRE Corporation.

CPE は The MITRE Corporation の商標です。

All other registered trademarks or trademarks belong to their respective organizations.

その他すべての登録商標または商標は、それぞれの組織に帰属します。

Table of Contents

目次

List of Figures and Tables

図表一覧

1. Introduction

1. はじめに

Common Platform Enumeration (CPE) is a standardized method of describing and identifying classes of applications, operating systems, and hardware devices present in an enterprise’s computing assets. CPE can be used as a source of information for enforcing and verifying IT management policies relating to these assets, such as vulnerability, configuration, and remediation policies. IT management tools can collect information about installed products, identify products using their CPE names, and use this standardized information to help make fully or partially automated decisions regarding the assets.

Common Platform Enumeration(CPE)は、企業のコンピューティング資産に存在するアプリケーション、オペレーティングシステム、ハードウェアデバイスの種類を記述し識別するための、標準化された方法です。CPE は、脆弱性、構成、修復に関する方針など、これらの資産に関する IT 管理方針を実施し検証するための情報源として使用できます。IT 管理ツールは、インストールされている製品に関する情報を収集し、CPE 名を使って製品を識別し、この標準化された情報を使って、資産に関する完全または部分的に自動化された判断を行うのに役立てることができます。

CPE Name Matching is one of several modular CPE specifications that work together in layers to perform various functions. CPE Name Matching defines a method for conducting a one-to-one comparison of a source CPE name to a target CPE name. By logically comparing CPE names as sets of values, CPE Name Matching methods can determine if common set relations hold. For example, CPE Name Matching can determine if the source and target names are equal, if one of the names is a subset of the other, or if the names are disjoint.

CPE Name Matching は、層をなして連携し、さまざまな機能を実行する、モジュール型の CPE 仕様の一つです。CPE Name Matching は、元の CPE 名と対象の CPE 名の 1 対 1 の比較を行う方法を定義します。CPE 名を値の集合として論理的に比較することで、CPE Name Matching の方法は、一般的な集合関係が成り立つかどうかを判断できます。たとえば、CPE Name Matching は、元の名前と対象の名前が等しいか、一方の名前が他方の部分集合か、または名前同士が互いに素であるかを判断できます。

One example of the value of CPE Name Matching is in determining if a particular product is installed on a system. Suppose that an organization is identifying which of its systems have any variation of Microsoft Internet Explorer 8 installed. This could be represented with the following well-formed CPE name (WFN) [CPE23-N:5.1]:

CPE Name Matching の価値を示す一例は、特定の製品がシステムにインストールされているかどうかの判断です。ある組織が、自らのシステムのうち、Microsoft Internet Explorer 8 の何らかの変種がインストールされているものを特定しようとしているとします。これは、次の整形式 CPE 名(WFN)[CPE23-N:5.1] で表すことができます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.*",update=ANY,edition=ANY,language=ANY]
原文のみ

An asset management tool could collect information on the software installed on a system and compare its Internet Explorer installation characteristics to the WFN above. Suppose that the WFN for a particular installed instance of Internet Explorer was reported as:

資産管理ツールは、システムにインストールされているソフトウェアの情報を収集し、その Internet Explorer のインストール状況の特性を、上記の WFN と比較できます。特定のインストール済みの Internet Explorer のインスタンスの WFN が、次のように報告されたとします。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update=NA,edition=NA,language="en\-us"]
原文のみ

Using these two example WFNs, CPE Name Matching methods perform a pairwise comparison of attribute values in the first (source) WFN to those in the second (target) WFN, yielding a list of the set relations between each pair of attributes (e.g., equal, superset). This list of comparison results is then assessed, leading to a determination that the first WFN represents a superset of the second WFN. This can be interpreted to mean that the system being examined does indeed have a variation of Microsoft Internet Explorer 8 installed.

これら 2 つの例の WFN を使って、CPE Name Matching の方法は、1 つ目(元)の WFN の属性値を 2 つ目(対象)の WFN の属性値と対にして比較し、各属性の対の間の集合関係(たとえば、等しい、上位集合)の一覧を導き出します。次に、この比較結果の一覧が評価され、1 つ目の WFN が 2 つ目の WFN の上位集合を表しているという判断に至ります。これは、調査対象のシステムに、Microsoft Internet Explorer 8 の変種が実際にインストールされていることを意味すると解釈できます。

Although this may seem like a trivial example, CPE Name Matching is a powerful and flexible way of performing product comparisons in a standardized, automated manner. CPE Name Matching is also used by other CPE specifications to conduct more complex tasks, such as searching for product names in CPE dictionaries and performing complex comparisons of sets of product versions—for example, determining if a system is running a particular operating system version, running two particular applications, and not running a third particular application.

これは些細な例に見えるかもしれませんが、CPE Name Matching は、標準化された自動化された方法で製品の比較を行う、強力で柔軟な方法です。CPE Name Matching は、CPE ディクショナリで製品名を検索したり、製品バージョンの集合の複雑な比較(たとえば、システムが特定のオペレーティングシステムのバージョンを実行し、特定の 2 つのアプリケーションを実行し、特定の 3 つ目のアプリケーションを実行していないかどうかの判断)を行ったりするなど、より複雑なタスクを実行するために、他の CPE 仕様でも使用されます。

1.1 Purpose and Scope

1.1 目的と適用範囲

This report defines the specification for CPE Name Matching version 2.3. The report also defines and explains the requirements that producers of CPE Name Matching implementations, such as software and services, must meet to claim conformance with version 2.3 of the CPE Name Matching specification.

この報告書は、CPE Name Matching バージョン 2.3 の仕様を定義します。また、この報告書は、ソフトウェアやサービスなど、CPE Name Matching の実装の提供者が、CPE Name Matching 仕様のバージョン 2.3 への適合を主張するために満たさなければならない要件も定義し、説明します。

This report only applies to version 2.3 of CPE Name Matching. All other versions are out of the scope of this report, as are all CPE specifications other than CPE Name Matching.

この報告書は、CPE Name Matching のバージョン 2.3 にのみ適用されます。その他のすべてのバージョンは、CPE Name Matching 以外のすべての CPE 仕様と同様に、この報告書の適用範囲外です。

1.2 Audience

1.2 想定読者

This report is intended for two main audiences: IT management tool developers and the authors and editors of CPE content. Readers of this report should already be familiar with CPE naming concepts and conventions as defined in [CPE23-N].

この報告書は、IT 管理ツールの開発者と CPE コンテンツの作成者および編集者という、2 つの主な読者を想定しています。この報告書の読者は、[CPE23-N] で定義されている CPE の命名の概念と規則にすでに精通しているべきです。

1.3 Document Structure

1.3 文書の構成

The remainder of this report is organized into the following major sections:

この報告書の残りの部分は、次の主要な節で構成されています。

•Section 2 defines the key terms and abbreviations used in this specification.

•第 2 節では、この仕様で使用する主要な用語と略語を定義します。

•Section 3 provides an overview of related specifications and standards.

•第 3 節では、関連する仕様と標準の概要を示します。

•Section 4 defines the high-level conformance rules for this specification.

•第 4 節では、この仕様の上位レベルの適合性ルールを定義します。

•Section 5 describes the foundational concepts, name constructs, and technical constraints associated with CPE name matching.

•第 5 節では、CPE の名前照合に関連する基礎的な概念、名前の構成要素、技術的制約を説明します。

•Section 6 defines CPE set relations.

•第 6 節では、CPE の集合関係を定義します。

•Section 7 describes expected name matching behavior in pseudocode.

•第 7 節では、期待される名前照合の動作を擬似コードで説明します。

•Appendix A lists normative and informative references.

•付録 A は、規範的参考文献と参考情報を一覧にします。

•Appendix B describes how to implement CPE 2.2 equivalent matching capabilities using CPE 2.3 matching functions.

•付録 B は、CPE 2.3 の照合関数を使って、CPE 2.2 と同等の照合機能を実装する方法を説明します。

•Appendix C provides a change log that documents significant changes to major drafts of the specification.

•付録 C は、仕様の主要なドラフトにおける重要な変更を記録した変更履歴を提供します。

1.4 Document Conventions

1.4 文書の表記規則

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 [RFC 2119].

この文書のキーワード "MUST"、"MUST NOT"、"REQUIRED"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、"RECOMMENDED"、"MAY"、"OPTIONAL" は、[RFC 2119] に記述されているとおりに解釈されるものとします。

Text intended to represent computing system input, output, or algorithmic processing is presented in fixed-width Courier font.

コンピューティングシステムの入力、出力、またはアルゴリズム処理を表すことを意図したテキストは、fixed-width Courier fontで表示します。

Normative references are listed in Appendix A of this document. The following reference citation conventions are used in the text of this document:

規範的参考文献は、この文書の付録 A に列挙しています。この文書の本文では、次の参照の引用規則を用います。

•For normative references, a square bracket notation containing an abbreviation of the overall reference citation, followed by a colon and subsection citation where applicable (e.g., [CPE23- N:7.2] is a citation for the CPE 2.3 Naming specification, Section 7.2)

•規範的参考文献については、参考文献全体の引用の略称を含む角括弧の表記に続けて、コロンと、該当する場合は小節の引用を付けたものを用います(たとえば、[CPE23- N:7.2] は、CPE 2.3 Naming 仕様の第 7.2 節の引用である)。

•For references within this document (internal references) and non-normative references, a parenthetical notation containing the “cf.” (compare) abbreviation followed by a section number for internal references or an external reference (e.g., (cf. 3.1) is a citation for Section 3.1 of this document).

•この文書内の参照(内部参照)と非規範的参考文献については、「cf.」(比較せよ)の略語を含む丸括弧の表記に続けて、内部参照については節番号、外部参照については外部の参考文献を付けたものを用います(たとえば、(cf. 3.1) は、この文書の第 3.1 節の引用である)。

The phrase “CPE Name Matching” is capitalized only when referring to the proper name of this specification. When “CPE name matching” is otherwise used, such as a verb phrase, only the CPE acronym is capitalized.

「CPE Name Matching」という語句は、この仕様の固有の名称を指す場合にのみ大文字で表記します。「CPE name matching」が動詞句などの形でそれ以外の意味で使われる場合は、CPE という略語のみを大文字で表記します。

This document uses an abstract pseudocode programming language to specify expected computational behavior. Pseudocode is intended to be straightforwardly readable and translatable into actual programming language statements. Note, however, that pseudocode specifications are not necessarily intended to illustrate efficient or optimized programming code; rather, their purpose is to clearly define the desired behavior, leaving it to implementers to choose the best language-specific design which respects that behavior. In some cases, particularly where standardized implementations exist for a given pseudocode function, we describe the function's behavior in prose.

この文書では、期待される計算上の動作を規定するために、抽象的な擬似コードのプログラミング言語を使用します。擬似コードは、容易に読み取ることができ、実際のプログラミング言語の文に容易に変換できることを意図しています。ただし、擬似コードの仕様は、必ずしも効率的または最適化されたプログラムコードを示すことを意図したものではないことに注意してください。その目的は、望ましい動作を明確に定義し、その動作を満たす最適な言語固有の設計の選択を実装者に委ねることです。場合によっては、特に特定の擬似コード関数に標準化された実装が存在する場合には、関数の動作を文章で記述します。

When reading pseudocode the following should be kept in mind:

擬似コードを読む際は、次の点に留意すべきです。

•All pseudocode functions are pass by value, meaning that any changes applied to the supplied arguments within the scope of the function do not affect the values of the variables in the caller’s scope.

•すべての擬似コード関数は値渡しであり、関数のスコープ内で、与えられた引数に適用された変更は、呼び出し元のスコープにある変数の値に影響しません。

•In a few cases, the pseudocode functions reference (more or less) standard library functions, particularly to support string handling. Whenever possible, we reference semantically equivalent functions from the GNU C library, cf. http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities.

•一部の場合には、擬似コード関数が、特に文字列処理を支援するために、(おおむね)標準的なライブラリ関数を参照します。可能な限り、意味的に等価な GNU C library の関数を参照します。cf. http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities.

2. Definitions and Abbreviations

2. 定義と略語

This section defines selected terms and acronyms used within the document.

この節では、文書内で使用されている一部の用語と頭字語を定義します。

2.1 Definitions

2.1 定義

The following definitions apply to the CPE Name Matching specification. These definitions build on the definitions from the CPE Naming specification [CPE23-N]. They have been adapted where practical from authoritative sources, such as industry, national, and international standard specifications.

次の定義は、CPE Name Matching 仕様に適用されます。これらの定義は、CPE Naming 仕様 [CPE23-N] の定義を基礎としています。実用上可能な場合には、産業界、国内および国際的な標準仕様などの権威ある情報源の定義を採用しています。

Attribute: A property or characteristic of a computing product. CPE 2.2 commonly used the term “component” instead of “attribute”. CPE 2.3 uses the term “attribute” to clarify the distinction between CPE 2.2 name “components” and computing components, such as software modules. Examples of CPE 2.3 attributes are part, vendor, product, and version. CPE attributes and their value constraints are defined in the CPE Naming specification [CPE23-N:5.2, 5.3].

Attribute: コンピューティング製品の性質または特性。CPE 2.2 では、「attribute」ではなく「component」という用語が一般的に使われていました。CPE 2.3 では、CPE 2.2 の名前の「コンポーネント」と、ソフトウェアモジュールなどのコンピューティングコンポーネントとの区別を明確にするため、「attribute」という用語を使用します。CPE 2.3 の属性の例は、part、vendor、product、version です。CPE の属性とその値の制約は、CPE Naming 仕様 [CPE23-N:5.2, 5.3] で定義されています。

Attribute-Value (A-V) Pair: A tuple a=v in which a (the attribute) is an alphanumeric label representing a property or state, and v (the value) is the value assigned to the attribute.

Attribute-Value (A-V) Pair: a=v という組で、a(属性)は性質または状態を表す英数字のラベル、v(値)はその属性に割り当てられた値です。

CPE Attribute Comparison: The first phase of CPE name matching, where a matching engine compares each of the A-V pairs of a source CPE name to the corresponding A-V pair of a target name in order to specify one of four possible logical attribute comparison relations for each attribute in a CPE name.

CPE Attribute Comparison: CPE の名前照合の第 1 段階。照合エンジンが、元の CPE 名の各 A-V ペアを、対象の名前の対応する A-V ペアと比較し、CPE 名の各属性について、4 つの可能な論理的な属性比較関係のいずれかを特定します。

CPE Name Comparison: The second phase of CPE name matching, where the individual attribute comparison results from the first phase are analyzed as a collection to determine an overall comparison result for the two names. The result of a name comparison is the identification of the relationship between a source CPE name and target CPE name.

CPE Name Comparison: CPE の名前照合の第 2 段階。第 1 段階の個々の属性比較結果を集合として分析し、2 つの名前の全体的な比較結果を判断します。名前比較の結果は、元の CPE 名と対象の CPE 名の間の関係の特定です。

CPE Name Matching: A one-to-one source-to-target comparison of CPE names. CPE name matching has two phases: attribute comparison and name comparison. CPE name matching compares source-to- target attribute values at the attribute comparison level, and then applies rules to the set of attribute relations to determine a name match, such as the names being equal or the source name being a superset of the target name.

CPE Name Matching: CPE 名の、元から対象への 1 対 1 の比較。CPE の名前照合には、属性比較と名前比較の 2 つの段階があります。CPE の名前照合は、属性比較のレベルで元から対象への属性値を比較し、次に、属性関係の集合に規則を適用して、名前が等しい、または元の名前が対象の名前の上位集合であるなどの、名前の一致を判断します。

Extension: The set of individual products to which a WFN refers.

Extension: WFN が指す個々の製品の集合。

Quote: To precede printable non-alphanumeric characters (e.g., *, $, ?) with the backslash ( \) escape character in a value string. When a non-alphanumeric character is quoted in a WFN, it SHALL be processed as string data. When a non-alphanumeric character is unquoted in a WFN, it may be interpreted as a special character by CPE 2.3 specifications, including this one.

Quote: 値の文字列内で、印字可能な英数字以外の文字(たとえば *、$、?)の前に、バックスラッシュ(\)のエスケープ文字を付けること。WFN 内で英数字以外の文字がクォートされている場合、その文字は文字列データとして処理されなければなりません(SHALL)。WFN 内で英数字以外の文字がクォートされていない場合、その文字は、この仕様を含む CPE 2.3 の仕様によって特殊文字として解釈される場合があります。

Source Name: A single WFN that a matching engine compares to a target WFN to determine whether or not there is a source-to-target match. (This is the X value in the CPE 2.2 matching algorithm.)

Source Name: 元から対象への一致があるかどうかを判断するために、照合エンジンが対象の WFN と比較する、単一の WFN。(これは CPE 2.2 の照合アルゴリズムにおける X の値です。)

Source Value: A single value that a matching engine compares to a corresponding target value to determine whether or not there is a source-to-target match. Source values include A-V pairs or set relation values (e.g., superset or subset).

Source Value: 元から対象への一致があるかどうかを判断するために、照合エンジンが対応する対象の値と比較する、単一の値。元の値には、A-V ペアや集合関係の値(たとえば、上位集合や部分集合)が含まれます。

Special Character: A non-alphanumeric character that may be defined by one or more CPE specifications to have a special meaning when it appears unquoted in a WFN. Special characters typically trigger a processor to perform a given function. The rules for escaping CPE special characters are defined in the CPE Naming specification [CPE23-N:5.3.2].

Special Character: WFN 内でクォートされずに現れたとき、1 つ以上の CPE 仕様によって特別な意味を持つと定義される場合がある、英数字以外の文字。特殊文字は、通常、処理系に所定の機能を実行させる。CPE の特殊文字をエスケープするための規則は、CPE Naming 仕様 [CPE23-N:5.3.2] で定義されています。

Target Name: A single WFN that is the target of a matching process. A matching engine compares a source WFN to a target WFN to determine whether or not there is a source-to-target match. In CPE 2.2 terms a target name is a single item in the list of known values (each N of K) and is equivalent to the N value in the CPE 2.2 Matching algorithm.

Target Name: 照合プロセスの対象となる、単一の WFN。照合エンジンは、元から対象への一致があるかどうかを判断するために、元の WFN を対象の WFN と比較します。CPE 2.2 の用語では、対象の名前は既知の値のリスト(各 N of K)内の単一の項目であり、CPE 2.2 の照合アルゴリズムにおける N の値に相当します。

Target Value: A single value that is the target of a matching process. A matching engine compares a source value to a target value to determine whether or not there is a source-to-target match. Source values include AV pairs or set relation values (e.g., superset or subset).

Target Value: 照合プロセスの対象となる単一の値。照合エンジンは、元の値を対象の値と比較し、元の値と対象の値が一致するかどうかを判断します。元の値には、AV ペアや集合関係の値(たとえば、上位集合や部分集合)が含まれます。

Value String: A value assigned to an attribute of a WFN. It must be a non-empty contiguous string of bytes encoded using printable Unicode Transformation Format-8 (UTF-8) characters with hexadecimal values between x00 and x7F.

Value String: WFN の属性に割り当てられた値。印字可能な Unicode Transformation Format-8(UTF-8)の文字(16 進数の値が x00 から x7F の間)を用いてエンコードされた、空でない連続したバイト列でなければなりません。

Well-Formed CPE Name (WFN): A logical construct that constitutes an unordered list of A-V pairs that collectively describe or identify one or more operating systems, software applications, or hardware devices. Unordered means that there is no prescribed order in which A-V pairs should be listed, and there is no specified relationship (hierarchical, set-theoretic, or otherwise) among attributes. WFNs must satisfy the criteria specified in the CPE Naming specification [CPE23-N:5.2]. For a full description and usage constraints on WFN logical attribute values, see Section 5 of the CPE Naming specification [CPE23-N:5].

Well-Formed CPE Name (WFN): 1 つ以上のオペレーティングシステム、ソフトウェアアプリケーション、ハードウェアデバイスを、全体として記述または識別する、順序のない A-V ペアのリストを構成する論理的な構造。順序がないとは、A-V ペアを並べるべき規定の順序がなく、属性間に指定された関係(階層的、集合論的、その他)がないことを意味します。WFN は、CPE Naming 仕様 [CPE23-N:5.2] で指定された基準を満たさなければなりません。WFN の論理属性値の完全な説明と使用上の制約については、CPE Naming 仕様の第 5 節 [CPE23-N:5] を参照してください。

2.2 Abbreviations

2.2 略語

A-VAttribute-Value Pair
CPECommon Platform Enumeration
GNUGNU's Not Unix (recursive acronym)
IRInteragency Report
ITInformation Technology
ITLInformation Technology Laboratory
NISTNational Institute of Standards and Technology
RFCRequest for Comment
SCAPSecurity Content Automation Protocol
URIUniform Resource Identifier
UTF-8Unicode Transformation Format-8
WFNWell-Formed CPE Name
XMLExtensible Markup Language
A-V属性値ペア
CPECommon Platform Enumeration
GNUGNU's Not Unix(再帰的頭字語)
IR省庁間報告書
IT情報技術
ITLInformation Technology Laboratory
NISTNational Institute of Standards and Technology
RFCRequest for Comment
SCAPSecurity Content Automation Protocol
URIUniform Resource Identifier
UTF-8Unicode Transformation Format-8
WFN整形式 CPE 名
XMLExtensible Markup Language

3. Relationship to Existing Specifications and Standards

3. 既存の仕様および標準との関係

This section explains the relationships between this specification and related specifications or standards.

この節では、この仕様と関連する仕様または標準との関係を説明します。

3.1 Other CPE Version 2.3 Specifications

3.1 その他の CPE バージョン 2.3 仕様

CPE version 2.3 has a modular, stack-based approach, with each major component defined in a separate specification. Functional capabilities are built by layering these modular specifications. This architecture opens opportunities for innovation, as novel capabilities can be defined by combining only the needed specifications, and the impacts of change can be better compartmentalized and managed.

CPE バージョン 2.3 は、モジュール型でスタックに基づくアプローチを採用しており、各主要コンポーネントが個別の仕様で定義されています。機能的な能力は、これらのモジュール型の仕様を階層化することで構築されます。このアーキテクチャは、必要な仕様のみを組み合わせることで新しい能力を定義でき、変更の影響をより適切に区分して管理できるため、イノベーションの機会を広げます。

The CPE Name Matching specification builds on the foundation of the CPE Naming specification [CPE23-N]. Many of the concepts and methods that are applied in this specification are defined in the CPE Naming specification. Specifications layered above the CPE Name Matching specification in the CPE stack build on the matching criteria and logic defined in this document.

CPE Name Matching 仕様は、CPE Naming 仕様 [CPE23-N] を基礎として構築されています。この仕様で適用される概念と方法の多くは、CPE Naming 仕様で定義されています。CPE スタックで CPE Name Matching 仕様の上位に階層化される仕様は、この文書で定義された照合の基準とロジックを土台としています。

3.2 CPE Version 2.2

3.2 CPE バージョン 2.2

The CPE version 2.3 specifications, including this specification, collectively replace [CPE22]. CPE version 2.3 is intended to provide all the capabilities made available by [CPE22] while adding new features suggested by the CPE user community.

この仕様を含む CPE バージョン 2.3 の仕様は、全体として [CPE22] を置き換えます。CPE バージョン 2.3 は、[CPE22] が提供するすべての能力を提供するとともに、CPE ユーザーコミュニティから提案された新機能を追加することを意図しています。

The primary changes in CPE Name Matching since CPE 2.2 are:

CPE 2.2 以降の CPE Name Matching における主な変更点は次のとおりです。

1.The “prefix property” [CPE22:4] was eliminated from CPE 2.3.

1.「プレフィックスプロパティ」[CPE22:4] が CPE 2.3 から削除されました。

2.New matching criteria and logic support a broad range of use cases.

2.新しい照合基準とロジックが、幅広いユースケースを支援します。

3.CPE name matching is defined in terms of a WFN so that it can be implemented in a common way regardless of how names are bound for machine processing and interchange.

3.CPE の名前照合が WFN に基づいて定義されているため、機械処理や交換のために名前がどのようにバインドされるかにかかわらず、共通の方法で実装できます。

4.Attribute matching supports single-character and multi-character wild card values.

4.属性の照合が、1 文字および複数文字のワイルドカード値をサポートします。

4. Conformance

4. 適合性

Product manufacturers may want to claim conformance with this specification for a variety of reasons. This section provides the high-level requirements that must be met by any implementation seeking to claim conformance with this specification. These requirements ensure the interoperability of conformant implementations through common CPE name matching functionality.

製品の製造者は、さまざまな理由から、この仕様への適合を主張したい場合があります。この節では、この仕様への適合を主張しようとするあらゆる実装が満たさなければならない、上位レベルの要件を示します。これらの要件により、CPE の名前照合の共通の機能を通じて、適合する実装の相互運用性が確保されます。

The following apply to all implementations claiming conformance with this specification:

この仕様への適合を主張するすべての実装には、次が適用されます。

1.An implementation MUST make an explicit claim of conformance to this specification in any documentation provided to end users.

1.実装は、エンドユーザーに提供するあらゆる文書で、この仕様への適合を明示的に主張しなければなりません(MUST)。

2.An implementation MUST implement the behavior that is specified in the pseudocode of this document (cf. 7).

2.実装は、この文書の擬似コードで規定された動作を実装しなければなりません(MUST)(cf. 7)。

3.An implementation MUST produce the identical results for CPE attribute and name comparison relations that are specified in this document (cf. 5, 6).

3.実装は、CPE の属性比較関係と名前比較関係について、この文書で規定された結果と同一の結果を生成しなければなりません(MUST)(cf. 5, 6)。

4.An implementation MUST satisfy the technical constraints as defined in this document (cf. 5.2)

4.実装は、この文書で定義された技術的制約を満たさなければなりません(MUST)(cf. 5.2)

5. Name Matching Overview

5. 名前照合の概要

The CPE Name Matching specification interprets the Well-Formed CPE Name (WFN) as a set-theoretic construct. That is, a WFN is treated as an expression that refers to a set of individual products having certain attribute values. The set of individual products to which a WFN refers is called the extension of the WFN. For example, the extension of the WFN

CPE Name Matching 仕様は、整形式 CPE 名(WFN)を集合論的な構造として解釈します。すなわち、WFN は、特定の属性値を持つ個々の製品の集合を指す式として扱われます。WFN が指す個々の製品の集合を、その WFN の外延と呼びます。たとえば、次の WFN の外延は

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0"]
原文のみ

is the set of individual products with the part attribute equal to "a" (i.e., applications), the vendor attribute equal to "microsoft", the product attribute equal to "internet_explorer", the version attribute equal to "8\.0", and all the other (unspecified) attribute values with any value. It is important to keep in mind that the attribute values serve as constraints on membership in the WFN's extension; they are ANDed together because, to be a member of a WFN's extension, an individual product must satisfy all the attribute values.

part 属性が "a"(すなわちアプリケーション)、vendor 属性が "microsoft"、product 属性が "internet_explorer"、version 属性が "8\.0" に等しく、その他の(指定されていない)属性値がすべて任意の値である、個々の製品の集合です。属性値は、WFN の外延に属するための制約として機能し、それらは AND で結合されることに留意することが重要です。WFN の外延に属するには、個々の製品がすべての属性値を満たさなければならないからです。

This conception of WFNs permits an intuitive formulation of WFN matching as the assessment of the set relationship (e.g., subset, superset) between the two extensions of the WFNs being compared. This specification builds on the set-theoretic conception of WFNs to define common matching functionality for the assessment of the set relation between a source WFN and a target WFN. The functionality described in this specification encompasses two main parts: a method for comparing attribute values within the source and target WFNs to identify their set relations, and a method for comparing source and target WFNs as sets of attribute relations. Taken together, these two parts provide for basic tool interoperability, while remaining flexible and extensible enough to apply to a broad range of use cases.

この WFN の捉え方により、WFN の照合を、比較される 2 つの WFN の外延の間の集合関係(たとえば、部分集合、上位集合)の評価として、直感的に定式化できます。この仕様は、WFN の集合論的な捉え方を土台として、元の WFN と対象の WFN の間の集合関係を評価するための共通の照合機能を定義します。この仕様で記述する機能は、2 つの主要な部分を含みます。元の WFN と対象の WFN の中の属性値を比較してそれらの集合関係を特定する方法と、元の WFN と対象の WFN を属性関係の集合として比較する方法です。これら 2 つの部分を合わせることで、基本的なツールの相互運用性が実現され、かつ、幅広いユースケースに適用できるだけの柔軟性と拡張性が保たれます。

The CPE v2.2 specification [CPE22] provided a single definition of what it means for a source CPE name to “match” a target name. In contrast, this specification takes a more open and flexible approach. Here, CPE name matching is defined to return individual results for each pairwise attribute comparison, along with a single overall set-theoretic result for a name comparison. CPE’s developers have chosen not to define a single notion of “name match” because experience has shown that name matching distinctions are often use-case dependent. For example, when a source WFN is generated from the sparse results of a non-authenticated asset inventory tool, matching of only one or two CPE attribute values may constitute a meaningful “name match” for some applications. In contrast, when both the source and target WFNs are fully specified, common names in an authoritative CPE dictionary, it may be reasonable to decide that a “name match” requires an exact match of all CPE attribute values in both names. In order to remain flexible enough to support these and other use cases, the CPE Name Matching specification leaves the majority of decisions about what constitutes a “name match” to CPE implementers at design time. This flexibility is expected to free the CPE community to develop new and innovative ways to define CPE name matches as required to satisfy various application needs.

CPE v2.2 仕様 [CPE22] は、元の CPE 名が対象の名前に「一致する」とはどういうことかについて、単一の定義を提供していました。これに対し、この仕様は、より開かれた柔軟なアプローチを採っています。ここでは、CPE の名前照合は、属性の対ごとの比較について個別の結果を返し、名前比較について単一の全体的な集合論的な結果を返すように定義されています。CPE の開発者は、名前照合の区別が多くの場合ユースケースに依存することが経験から分かっているため、単一の「名前の一致」という概念を定義しないことを選びました。たとえば、元の WFN が、認証を行わない資産目録ツールの疎な結果から生成される場合、CPE の属性値のうち 1 つまたは 2 つだけが一致することが、一部のアプリケーションにとって意味のある「名前の一致」となる場合があります。これに対し、元の WFN と対象の WFN の両方が、権威ある CPE ディクショナリにある完全に指定された一般的な名前である場合は、「名前の一致」には両方の名前のすべての CPE 属性値の完全一致が必要であると判断するのが妥当な場合があります。これらやその他のユースケースを支援できるだけの柔軟性を保つため、CPE Name Matching 仕様は、何が「名前の一致」を構成するかについての判断の大部分を、設計時に CPE の実装者に委ねています。この柔軟性により、CPE コミュニティが、さまざまなアプリケーションのニーズを満たすために必要に応じて、CPE の名前の一致を定義する新しく革新的な方法を自由に開発できるようになると期待されます。

Although the following matching capabilities may build on the foundation of the CPE Name Matching specification, they are outside of its scope:

次の照合機能は、CPE Name Matching 仕様を基礎として構築される場合がありますが、その適用範囲外です。

1.Multiple name results. Although CPE Name Matching methods can be sequentially applied to a list of target names, they return only the first match found in the list. CPE Name Matching methods do not return lists of results.

1.複数の名前の結果。CPE Name Matching の方法は、対象の名前のリストに順次適用できますが、リスト内で最初に見つかった一致のみを返します。CPE Name Matching の方法は、結果のリストを返しません。

2.Many-to-many comparisons. When comparing a list of source names to a list of target names, the CPE Name Matching specification provides a foundation from which to build list-to-list comparisons, but it does not define many-to-many comparisons.

2.多対多の比較。元の名前のリストを対象の名前のリストと比較する場合、CPE Name Matching 仕様は、リスト対リストの比較を構築するための基礎を提供しますが、多対多の比較は定義しません。

3.Weighting of matching results. CPE Name Matching does not specify how to determine whether or not one match is more relevant than another. For example, the algorithm does not distinguish whether a match of a version attribute value is more or less relevant than a match of a language attribute value.

3.照合結果の重み付け。CPE Name Matching は、ある一致が別の一致より関連性が高いかどうかを判断する方法を規定しません。たとえば、アルゴリズムは、version 属性値の一致が language 属性値の一致よりも関連性が高いか低いかを区別しません。

The remainder of this section defines the foundational CPE name constructs and technical constraints associated with CPE name matching.

この節の残りでは、CPE の名前照合に関連する基礎的な CPE 名の構成要素と技術的制約を定義します。

5.1 CPE Name Constructs

5.1 CPE 名の構成要素

CPE name matching is defined to be independent of any bound form of a CPE name. Rather, it is defined only in terms of the logical constructs of a WFN. The possible attribute values of a WFN include the logical values ANY and NA, value strings, and special characters. For a full description and basic usage constraints on WFN attribute values, see the CPE Naming specification [CPE23-N:5].

CPE の名前照合は、CPE 名のどのバインド形式にも依存しないように定義されています。むしろ、WFN の論理的な構造のみに基づいて定義されています。WFN の属性値として取り得るものには、論理値の ANY と NA、値の文字列、特殊文字が含まれます。WFN の属性値の完全な説明と基本的な使用上の制約については、CPE Naming 仕様 [CPE23-N:5] を参照してください。

The CPE Naming specification designates the asterisk (*) and the question mark (?) as special characters for use in the CPE attribute-value strings of a WFN. When these characters appear unquoted within a CPE attribute-value string, they may be interpreted as having a special meaning by CPE specifications [CPE23-N:5.3.2]. The CPE Name Matching specification assigns special interpretations to these unquoted characters. For matching purposes, an unquoted asterisk in an attribute-value string SHALL be interpreted as a multi-character wild card, and an unquoted question mark SHALL be interpreted as a single-character wild card. Logically, these wild cards translate to multi-character ANY and single- character ANY, respectively.

CPE Naming 仕様は、アスタリスク(*)と疑問符(?)を、WFN の CPE 属性値文字列で使用する特殊文字として指定しています。これらの文字が CPE の属性値文字列内で引用符で囲まれずに現れる場合、CPE 仕様によって特別な意味を持つと解釈される場合があります [CPE23-N:5.3.2]。CPE Name Matching 仕様は、これらの引用符で囲まれていない文字に特別な解釈を割り当てています。照合の目的では、属性値文字列内の引用符で囲まれていないアスタリスクは複数文字のワイルドカードとして解釈しなければなりません(SHALL)。引用符で囲まれていない疑問符は1文字のワイルドカードとして解釈しなければなりません(SHALL)。論理的には、これらのワイルドカードは、それぞれ複数文字の ANY と1文字の ANY に変換されます。

Although the CPE Name Matching specification is defined in terms of WFNs, CPE Name Matching implementations are NOT REQUIRED to transform CPE names into WFNs prior to matching. In practice, implementers MAY choose to unbind CPE names to WFNs prior to matching, or they MAY apply matching to the bound form of their choice.

CPE Name Matching 仕様は WFN に基づいて定義されていますが、CPE Name Matching の実装は、照合の前に CPE 名を WFN に変換することを要求されません(NOT REQUIRED)。実際には、実装者は、照合の前に CPE 名を WFN にアンバインドすることを選んでもよく(MAY)、選択したバインド形式に直接照合を適用してもよいです(MAY)。

When applying matching directly to bound forms (e.g., URIs or formatted strings), implementers should be aware of the ways in which unquoted special characters are encoded [CPE23-N:6.1.2.1.2]. In URI bindings, the unquoted question mark is encoded as the character sequence %01, and the unquoted asterisk is encoded as the character sequence %02. In formatted string bindings, the unquoted question mark is encoded as a question mark without a preceding escape (backslash) character, and the unquoted asterisk is encoded as an asterisk without a preceding escape character.

バインド形式(たとえば、URI や書式化文字列)に直接照合を適用する場合、実装者は、引用符で囲まれていない特殊文字がどのようにエンコードされるかに注意すべきです [CPE23-N:6.1.2.1.2]。URI バインディングでは、引用符で囲まれていない疑問符は文字列 %01 としてエンコードされ、引用符で囲まれていないアスタリスクは文字列 %02 としてエンコードされます。書式化文字列バインディングでは、引用符で囲まれていない疑問符は、前にエスケープ(バックスラッシュ)文字を付けない疑問符としてエンコードされ、引用符で囲まれていないアスタリスクは、前にエスケープ文字を付けないアスタリスクとしてエンコードされます。

5.2 Technical Constraints

5.2 技術的制約

This specification places the following constraints on usage of the unquoted question mark in attribute- value strings:

この仕様は、属性値文字列におけるクォートされていないクエスチョンマークの使用に、次の制約を課します。

1.An unquoted question mark MAY be used at the beginning and/or the end of an attribute-value string. Examples: "?foo", "bar?", "?baz?"

1.クォートされていないクエスチョンマークは、属性値文字列の先頭および/または末尾で使用してもよいです(MAY)。例: "?foo", "bar?", "?baz?"

2.A contiguous sequence of unquoted question marks MAY appear at the beginning and/or the end of an attribute-value string. Examples: "??foo", "bar???", "??baz???"

2.クォートされていないクエスチョンマークの連続した並びは、属性値文字列の先頭および/または末尾に現れてもよいです(MAY)。例: "??foo", "bar???", "??baz???"

3.An unquoted question mark SHALL NOT be used in any other place in an attribute-value string. Examples of illegal usage: "foo?bar", "bar??baz", "q??x"

3.クォートされていないクエスチョンマークは、属性値文字列のその他の場所で使用してはなりません(SHALL NOT)。不正な使用の例: "foo?bar", "bar??baz", "q??x"

This specification places the following constraints on usage of the unquoted asterisk in attribute-value strings:

この仕様は、属性値文字列におけるクォートされていないアスタリスクの使用に、次の制約を課します。

1.A single unquoted asterisk MAY be used as the entire attribute-value string. Example: "*"

1.単一のクォートされていないアスタリスクは、属性値文字列全体として使用してもよいです(MAY)。例: "*"

2.A single unquoted asterisk MAY be used at the beginning and/or end of an attribute-value string. Examples: "*foo", "bar*", "*baz*"

2.単一のクォートされていないアスタリスクは、属性値文字列の先頭および/または末尾で使用してもよいです(MAY)。例: "*foo", "bar*", "*baz*"

3.An unquoted asterisk SHALL NOT be used in any other place in an attribute-value string. Example of illegal usage: "foo*bar", "**foo", "bar***"

3.クォートされていないアスタリスクは、属性値文字列のその他の場所で使用してはなりません(SHALL NOT)。不正な使用の例: "foo*bar", "**foo", "bar***"

Unquoted question marks and asterisks MAY appear in the same attribute-value string as long as they meet the constraints above. Examples of legal usage: "?foo*", "*bar??". Examples of illegal usage: "*?foobar", "foobar*?".

クォートされていないクエスチョンマークとアスタリスクは、上記の制約を満たす限り、同じ属性値文字列に現れてもよいです(MAY)。正当な使用の例: "?foo*", "*bar??"。不正な使用の例: "*?foobar", "foobar*?"。

CPE Name Matching implementations MUST satisfy the following technical constraints:

CPE Name Matching の実装は、次の技術的制約を満たさなければなりません(MUST)。

1.The logical meaning that is applied to the unquoted characters asterisk (*) and question mark (?) MUST be applied as defined in this specification.

1.クォートされていない文字であるアスタリスク(*)とクエスチョンマーク(?)に適用される論理的な意味は、この仕様で定義されたとおりに適用しなければなりません(MUST)。

2.Attribute comparison MUST be performed prior to name comparison.

2.属性比較は、名前比較より前に実行しなければなりません(MUST)。

3.The collective relations of the attribute comparison of a source CPE name to a target CPE name SHALL be used as input to name comparison.

3.元の CPE 名と対象の CPE 名の属性比較の関係の集合は、名前比較の入力として使用しなければなりません(SHALL)。

4.Final CPE name matching results SHALL provide matching results for each attribute comparison in a CPE name as well as an overall name comparison result.

4.最終的な CPE の名前照合の結果は、CPE 名の各属性比較の照合結果と、全体的な名前比較の結果を提供しなければなりません(SHALL)。

6. Set Relations

6. 集合関係

This section defines CPE Name Matching set relations and describes how they are applied to compare CPE attributes and names.

この節では、CPE Name Matching の集合関係を定義し、それらが CPE の属性と名前の比較にどのように適用されるかを説明します。

There are four possible set relations between a source WFN and a target WFN. Although the contents of source and target and the applied logic vary among name matching processes, the meaning of the relation itself remains consistent throughout this specification. Table 6-1 defines the notation and meaning of each set relation.

元の WFN と対象の WFN の間には、4 つの集合関係があり得ます。元と対象の内容、および適用されるロジックは名前照合のプロセスごとに異なりますが、関係そのものの意味は、この仕様全体を通じて一貫しています。表 6-1 は、各集合関係の表記と意味を定義します。

Table 6-1: CPE Name Matching Set Relations

表 6-1: CPE 名の照合における集合関係

No.NotationDefinition
1⊃The source is a SUPERSET of the target
2⊂The source is a SUBSET of the target
3=The source and target are EQUAL
4≠The source and target are mutually exclusive or DISJOINT
番号表記定義
1⊃元が対象の上位集合(SUPERSET)である
2⊂元が対象の部分集合(SUBSET)である
3=元と対象が等しい(EQUAL)
4≠元と対象が互いに排他的、すなわち互いに素(DISJOINT)である

The SUPERSET and SUBSET relations defined in this specification are the conventional, “non-proper” set relations: that is, a set is not only EQUAL to itself, but it is also a SUPERSET and a SUBSET of itself.

この仕様で定義する SUPERSET と SUBSET の関係は、従来の「非真」の集合関係です。すなわち、集合は自分自身と EQUAL であるだけでなく、自分自身の SUPERSET であり SUBSET でもあります。

Given the set-theoretic conception of WFNs, WFN extensions are sets containing zero or more individuals. Each A-V pair of a WFN can thus be thought of as a subset of the WFN's full extension, namely, the subset of individuals from the full extension having the particular attribute value. This idea allows us to design source-to-target WFN comparison as a two-stage process: a sequence of pairwise A-V comparisons, yielding a list of results, followed by a holistic evaluation of the results list to arrive at an overall determination of the set-theoretic relationship between source and target. The next section describes the attribute comparison relations.

WFN の集合論的な捉え方を前提とすると、WFN の外延は、0 個以上の個体を含む集合です。したがって、WFN の各 A-V ペアは、その WFN の全体の外延の部分集合、すなわち、全体の外延のうち特定の属性値を持つ個体の部分集合と考えることができます。この考え方により、元から対象への WFN の比較を、2 段階のプロセスとして設計できます。すなわち、対ごとの A-V 比較の並びによって結果のリストを導き、続いて、その結果のリストを総合的に評価して、元と対象の間の集合論的な関係の全体的な判断に至る、というものです。次の節では、属性比較の関係を説明します。

6.1 Attribute Comparison Relations

6.1 属性比較の関係

The first of two CPE name matching phases, the attribute comparison process compares each A-V pair in a source name to its corresponding A-V pair in a target name, matching it to one of the four possible set relations. For example, comparing the source A-V vendor=ANY to the target A-V vendor="microsoft" matches to set relation number 1 in Table 6-1 ( ⊃ ), where the source A-V represents a superset of the target A-V.

CPE の名前照合の 2 つの段階の第 1 段階である属性比較プロセスは、元の名前の各 A-V ペアを、対象の名前の対応する A-V ペアと比較し、4 つの可能な集合関係のいずれかに対応づけます。たとえば、元の A-V vendor=ANY を対象の A-V vendor="microsoft" と比較すると、表 6-1 の集合関係の番号 1(⊃)に対応します。これは、元の A-V が対象の A-V の上位集合を表すことを意味します。

Table 6-2 enumerates all combinations of CPE WFN A-Vs and defines the set relation for each comparison. The following key describes the attribute value notation for Table 6-2.

表 6-2 は、CPE WFN の A-V のすべての組み合わせを列挙し、各比較の集合関係を定義します。次の凡例は、表 6-2 の属性値の表記を説明します。

1.ANY and NA are logical values as defined in [CPE23-N:5.3.1]

1.ANY と NA は、[CPE23-N:5.3.1] で定義された論理値である

2.i is a wildcard-free attribute-value string, e.g., "foo"

2.i は、ワイルドカードを含まない属性値文字列です。例: "foo"

3.k is a wildcard-free attribute-value string that is not identical to i, e.g., "bar"

3.k は、i と同一ではない、ワイルドカードを含まない属性値文字列です。例: "bar"

4.m + wild cards is an attribute-value string containing a legal combination of unquoted question mark or asterisk wild cards at the beginning and/or the end of the string, e.g., "*b??"

4.m + wild cards は、文字列の先頭および/または末尾に、クォートされていないクエスチョンマークまたはアスタリスクのワイルドカードの正当な組み合わせを含む、属性値文字列です。例: "*b??"

Table 6-2: Enumeration of Attribute Comparison Set Relations

表 6-2: 属性比較の集合関係の列挙

No.Source A-VTarget A-VRelation
1ANYANY=
2ANYNA⊃
3ANYi⊃
4ANYm + wild cardsundefined
5NAANY⊂
6NANA=
7NAi≠
8NAm + wild cardsundefined
9ii=
10ik≠
11im + wild cardsundefined
12iNA≠
13iANY⊂
14m1 + wild cardsm2⊃ or ≠
15m + wild cardsANY⊂
16m + wild cardsNA≠
17m1 + wild cardsm2 + wild cardsundefined
番号元の A-V対象の A-V関係
1ANYANY=
2ANYNA⊃
3ANYi⊃
4ANYm + ワイルドカード未定義
5NAANY⊂
6NANA=
7NAi≠
8NAm + ワイルドカード未定義
9ii=
10ik≠
11im + ワイルドカード未定義
12iNA≠
13iANY⊂
14m1 + ワイルドカードm2⊃ または ≠
15m + ワイルドカードANY⊂
16m + ワイルドカードNA≠
17m1 + ワイルドカードm2 + ワイルドカード未定義

When comparing string literals, matching results MUST be insensitive to lexical case.

文字列リテラルを比較する際、照合結果は、字句上の大文字小文字を区別してはなりません(MUST)。

Wild card usage is a new OPTIONAL feature in CPE 2.3. Wild cards MAY be included as part of the source value (lines 14-17 of Table 6-2). Wild cards SHOULD NOT be included in the target value—in this specification the inclusion of wild card characters in a target value yields an undefined result. See Section 6.3 of this document for a description of wild card matching criteria and relations.

ワイルドカードの使用は、CPE 2.3 の新しい任意(OPTIONAL)の機能です。ワイルドカードは、元の値の一部として含めてもよいです(MAY)(表 6-2 の 14〜17 行目)。ワイルドカードは、対象の値に含めるべきではありません(SHOULD NOT)。この仕様では、対象の値にワイルドカード文字を含めると、未定義の結果になります。ワイルドカードの照合基準と関係の説明については、この文書の第 6.3 節を参照してください。

In line 14 of Table 6-2, the result of the comparison depends on whether the wildcard comparison returns a positive string match. For example, if the source value is "9\.*" and the target value is "9\.3", then the result of the comparison is ⊃ (SUPERSET). If, however, the source value is "9\.*" and the target value is "8\.3", then the string match fails and the result of the comparison is ≠ (DISJOINT).

表 6-2 の 14 行目では、比較の結果は、ワイルドカードの比較が文字列の一致を肯定的に返すかどうかに依存します。たとえば、元の値が "9\.*" で対象の値が "9\.3" の場合、比較の結果は ⊃(SUPERSET)です。ただし、元の値が "9\.*" で対象の値が "8\.3" の場合、文字列の一致は失敗し、比較の結果は ≠(DISJOINT)です。

The attribute comparison phase results in a list of relations, one for each pairwise comparison of WFN attributes. Table 6-3 illustrates a set of source and target A-Vs and the resulting set of attribute comparison relations.

属性比較の段階により、WFN の属性の対ごとの比較それぞれに 1 つずつ、関係のリストが得られます。表 6-3 は、元と対象の A-V の集合と、その結果として得られる属性比較の関係の集合の例を示します。

Table 6-3: Attribute Comparison Example

表 6-3: 属性比較の例

AttributePartVendorProductVersionUpdateEdition
Source ValueaAdobeANY9.*ANYPalmOS
Target ValueaANYReader9.3.2NANA
Relation Set=⊂⊃⊃⊃≠
属性PartVendorProductVersionUpdateEdition
元の値aAdobeANY9.*ANYPalmOS
対象の値aANYReader9.3.2NANA
関係の集合=⊂⊃⊃⊃≠

6.2 Name Comparison Relations

6.2 名前比較の関係

The second of two CPE name matching phases, the name comparison process evaluates the attribute relations in the relation set resulting from the attribute comparison phase of the matching process. The results of a CPE name comparison is a single set relation between the source and target WFNs. In keeping with the goal to remain flexible enough to support a broad range of use cases, while specifying enough commonality to ensure basic interoperability between CPE Name Matching conformant tools, CPE 2.3 provides four basic name comparison relations. These relations were chosen for two reasons: they are the least likely to be use-case dependent, and they provide functional backward compatibility with the CPE 2.2 name matching process.

CPE の名前照合の 2 つの段階の第 2 段階である名前比較プロセスは、照合プロセスの属性比較の段階で得られた関係の集合の中の属性関係を評価します。CPE の名前比較の結果は、元の WFN と対象の WFN の間の単一の集合関係です。幅広いユースケースを支援できるだけの柔軟性を保ちつつ、CPE Name Matching に適合するツール間の基本的な相互運用性を確保するのに十分な共通性を規定するという目標に沿って、CPE 2.3 は 4 つの基本的な名前比較の関係を提供します。これらの関係は、ユースケースに依存する可能性が最も低いことと、CPE 2.2 の名前照合プロセスとの機能的な後方互換性を提供することの 2 つの理由から選ばれました。

The four name comparison relations are described in Table 6-4.

4 つの名前比較の関係は、表 6-4 に記述されています。

Table 6-4: Required CPE Name Comparison Relations

表 6-4: 必須の CPE 名比較関係

No.If Attribute Relation Set =Then Name Comparison Relation
1If any attribute relation is DISJOINT (≠)Then CPE name relation is DISJOINT (≠)
2If all attribute relations are EQUAL (=)Then CPE name relation is EQUAL (=)
3If all attribute relations are SUBSET (⊂) or EQUAL (=)Then CPE name relation is SUBSET(⊂)
4If all attribute relations are SUPERSET (⊃) or EQUAL (=)Then CPE name relation is SUPERSET (⊃)
番号属性関係の集合が次のとおりである場合CPE の名前比較の関係は次のとおり
1いずれかの属性関係が DISJOINT(≠)である場合CPE 名の関係は DISJOINT(≠)
2すべての属性関係が EQUAL(=)である場合CPE 名の関係は EQUAL(=)
3すべての属性関係が SUBSET(⊂)または EQUAL(=)である場合CPE 名の関係は SUBSET(⊂)
4すべての属性関係が SUPERSET(⊃)または EQUAL(=)である場合CPE 名の関係は SUPERSET(⊃)

Although additional name matching relations MAY be defined by other CPE specifications or by the CPE community to meet their operational needs, these four name comparison relations are the minimal REQUIRED set for baseline interoperability of CPE Name Matching implementations. Four corresponding name comparison functions define the expected behavior for CPE name comparison in the pseudocode specification in Section 7.2. CPE implementers who wish to emulate the functionality of the CPE 2.2 Matching algorithm should note that name comparison numbers 1 and 3 in Table 6-4 are equivalent to a final result of FALSE in CPE 2.2, while name comparison numbers 2 and 4 are equivalent to a CPE 2.2 result of TRUE. See Appendix B for a discussion of how to implement CPE 2.2 equivalent matching capabilities using CPE 2.3 name matching procedures.

運用上のニーズを満たすために、他の CPE 仕様や CPE コミュニティによって、追加の名前照合の関係が定義される場合があります(MAY)が、これら 4 つの名前比較の関係は、CPE Name Matching の実装の基本的な相互運用性のために必要な(REQUIRED)最小限の集合です。対応する 4 つの名前比較関数が、第 7.2 節の擬似コード仕様における CPE の名前比較の期待される動作を定義します。CPE 2.2 の Matching アルゴリズムの機能を再現したい CPE の実装者は、表 6-4 の名前比較の番号 1 と 3 が CPE 2.2 の最終結果 FALSE に相当し、名前比較の番号 2 と 4 が CPE 2.2 の結果 TRUE に相当することに留意すべきです。CPE 2.3 の名前照合の手順を使って、CPE 2.2 と同等の照合機能を実装する方法の説明については、付録 B を参照してください。

6.3 Wild Card Attribute Comparison

6.3 ワイルドカード属性の比較

A wild card (i.e., an unquoted special character) MAY be included as part of the source value when performing attribute value comparisons. The unquoted asterisk (*) character is a wild card for zero or more characters in the target value, and the unquoted question mark (?) character is a wild card for zero or one characters in the target value. Following [CPE23-N], wild card characters SHALL BE restricted to appearing at the beginning and/or the end of strings. Use of wild cards embedded within a string is not supported.

属性値の比較を行う際は、元の値の一部としてワイルドカード(すなわち、クォートされていない特殊文字)を含めてもよいです(MAY)。クォートされていないアスタリスク(*)文字は、対象の値の 0 文字以上に対するワイルドカードであり、クォートされていないクエスチョンマーク(?)文字は、対象の値の 0 文字または 1 文字に対するワイルドカードです。[CPE23-N] に従い、ワイルドカード文字は、文字列の先頭および/または末尾にのみ現れるものに限定されなければなりません(SHALL BE)。文字列の途中に埋め込まれたワイルドカードの使用はサポートされません。

When comparing a source string containing wild cards to a target string (cf. line 14 in Table 6-2), one of two set relation results are possible: SUPERSET ( ⊃ ) or DISJOINT (≠). If the source string (treated as a simple regular expression) matches the target string, the set-theoretic relation is SUPERSET ( ⊃ ), because the set denoted by the target string includes or is equal to the set denoted by the target. If the source string (treated as a simple regular expression) fails to match the target, the set-theoretic relation is DISJOINT (≠), because the set denoted by the source does not overlap the set denoted by the target.

ワイルドカードを含む元の文字列を対象の文字列と比較する場合(cf. 表 6-2 の 14 行目)、2 つの集合関係の結果のいずれかになり得ます。SUPERSET(⊃)または DISJOINT(≠)です。元の文字列(単純な正規表現として扱う)が対象の文字列に一致する場合、集合論的な関係は SUPERSET(⊃)です。これは、元の文字列が表す集合が、対象の文字列が表す集合を含むか、またはそれに等しいためです。元の文字列(単純な正規表現として扱う)が対象の文字列に一致しない場合、集合論的な関係は DISJOINT(≠)です。これは、元の文字列が表す集合が、対象の文字列が表す集合と重ならないためです。

7. CPE Name Matching Pseudocode

7. CPE 名前照合の擬似コード

This section specifies the required common matching capabilities in terms of an abstract pseudocode programming language. The input/output behavior of all functions defined in pseudocode should be considered normative. The pseudocode implementations themselves should be considered informative, as the algorithms are written for clarity and simplicity rather than for efficiency.

この節では、必要な共通の照合機能を、抽象的な擬似コードのプログラミング言語で規定します。擬似コードで定義されたすべての関数の入出力の動作は、規範的なものとみなすべきです。擬似コードの実装そのものは、アルゴリズムが効率ではなく明確さと単純さのために書かれているため、参考情報とみなすべきです。

7.1 Overview of CPE Name Matching Pseudocode

7.1 CPE 名前照合の擬似コードの概要

The following core functions comprise the required common matching capabilities:

次のコア関数が、必要な共通の照合機能を構成します。

•CPE_DISJOINT: This function compares two WFNs and returns TRUE if the set-theoretic relation between the names is DISJOINT.

•CPE_DISJOINT: この関数は 2 つの WFN を比較し、名前間の集合論的な関係が DISJOINT である場合に TRUE を返します。

•CPE_EQUAL: This function compares two WFNs and returns TRUE if the set-theoretic relation between the names is EQUAL.

•CPE_EQUAL: この関数は 2 つの WFN を比較し、名前間の集合論的な関係が EQUAL である場合に TRUE を返します。

•CPE_SUBSET: This function compares two WFNs and returns TRUE if the set-theoretic relation between the names is (non-proper) SUBSET.

•CPE_SUBSET: この関数は 2 つの WFN を比較し、名前間の集合論的な関係が(非真の)SUBSET である場合に TRUE を返します。

•CPE_SUPERSET: This function compares two WFNs and returns TRUE if the set-theoretic relation between the names is (non-proper) SUPERSET.

•CPE_SUPERSET: この関数は 2 つの WFN を比較し、名前間の集合論的な関係が(非真の)SUPERSET である場合に TRUE を返します。

•Compare_WFNs: This function compares two WFNs and returns a list of pairwise attribute- value comparison results. This function is required by the functions listed above. It provides full access to the individual comparison results to enable use-case specific implementations of novel name-comparison algorithms.

•Compare_WFNs: この関数は 2 つの WFN を比較し、属性値ごとの対の比較結果のリストを返します。この関数は、上に挙げた関数に必要とされます。ユースケース固有の、新しい名前比較アルゴリズムの実装を可能にするため、個々の比較結果への完全なアクセスを提供します。

These core functions depend on a number of support functions, including compare(), compareStrings(), and several string-processing functions. Section 7.2 defines the core functions, and Section 7.3 defines the support functions.

これらのコア関数は、compare()、compareStrings()、およびいくつかの文字列処理関数を含む、多数のサポート関数に依存します。第 7.2 節ではコア関数を定義し、第 7.3 節ではサポート関数を定義します。

7.2 CPE Name Matching Pseudocode: Core Functions

7.2 CPE 名前照合の擬似コード: コア関数

The following CPE Name Matching pseudocode defines the required core matching functions.

次の CPE 名前照合の擬似コードは、必要なコアの照合関数を定義します。

;; Begin CPE DISJOINT function. Input arguments are WFNs.
;; Returns TRUE if the set relation between source and target is DISJOINT,
;; otherwise FALSE.
function CPE_DISJOINT(source, target)
  result_list := Compare_WFNs(source, target).
  ;; If any pairwise comparison returned DISJOINT (≠) then the overall
  ;; name relationship is DISJOINT (≠).
  foreach result in result_list do
    if (result = DISJOINT (≠)) then return TRUE.
  end.
  return FALSE.
end.

;; Begin CPE EQUAL function. Input arguments are WFNs.
;; Returns TRUE if the set relation between source and target is EQUAL,
;; otherwise FALSE.
function CPE_EQUAL(source, target)
  result_list := Compare_WFNs(source, target).
  ;; If every pairwise comparison returned EQUAL (=) then the overall
  ;; name relationship is EQUAL (=).
  foreach result in result_list do
    if (result != EQUAL (=)) then return FALSE.
  end.
  return TRUE.
end.

;; Begin CPE SUBSET function. Input arguments are WFNs.
;; Returns TRUE if the set relation between source and target is SUBSET,
;; otherwise FALSE.
function CPE_SUBSET(source, target)
  result_list := Compare_WFNs(source, target).
  ;; If any pairwise comparison returned something other than SUBSET or
  ;; EQUAL, then SUBSET is false.
  foreach result in result_list do
    if ((result != SUBSET (⊂)) and (result != EQUAL (=))) then
      return FALSE.
  end.
  return TRUE.
end.

;; Begin CPE SUPERSET function. Input arguments are WFNs.
;; Returns TRUE if the set relation between source and target is
;; SUPERSET, otherwise FALSE.
function CPE_SUPERSET(source, target)
  result_list := Compare_WFNs(source, target).
  ;; If any pairwise comparison returned something other than SUPERSET
  ;; or EQUAL, then SUPERSET is false.
  foreach result in result_list do
    if ((result != SUPERSET (⊃)) and (result != EQUAL (=))) then
      return FALSE.
  end.
  return TRUE.
end.

;; Compare each attribute of the Source WFN to the Target WFN.
;; Inputs to the function are WFNs.
;; Output is a list of pairwise attribute comparison results.
function Compare_WFNs(source, target)
  ;; Create a new associative array table.
  result := new table.
  ;; Compare results using the get() function defined in Section 5.4.2
  ;; of the CPE Naming specification.
  put(result, part, compare(get(source, part), get(target, part))).
  put(result, vendor, compare(get(source, vendor), get(target, vendor))).
  put(result, product, compare(get(source, product), get(target, product))).
  put(result, version, compare(get(source, version), get(target, version))).
  put(result, update, compare(get(source, update), get(target, update))).
  put(result, edition, compare(get(source, edition), get(target, edition))).
  put(result, language, compare(get(source, language), get(target,
    language))).
  put(result, sw_edition, compare(get(source, sw_edition), get(target,
    sw_edition))).
  put(result, target_sw, compare(get(source, target_sw), get(target,
    target_sw))).
  put(result, target_hw, compare(get(source, target_hw), get(target,
    target_hw))).
  put(result, other, compare(get(source, other), get(target, other))).
  return result.
end.
原文のみ

7.3 CPE Name Matching Pseudocode: Support Functions

7.3 CPE 名前照合の擬似コード: サポート関数

The following CPE Name Matching pseudocode defines the required matching support functions.

次の CPE 名前照合の擬似コードは、必要な照合のサポート関数を定義します。

;; The compare() function is a support function for Compare_WFNs.
;; Input to the function is a pair of attribute values, which may
;; be logical values (ANY or NA) or string values.
;; Output is the attribute comparison relation as defined in Section 6.1
;; of this document.
function compare(source, target)
  if (is_string(source)) then source := to_lowercase(source).
  if (is_string(target)) then target := to_lowercase(target).
  ;; In this specification, unquoted wildcard characters in the target
  ;; yield an undefined result. Table 6-2, lines 4, 8, 11 and 17.
  if (is_string(target) and contains_wildcards(target)) then
    return UNDEFINED.
  ;; If source and target attribute values are equal, then the
  ;; result is EQUAL (=). Table 6-2, lines 1, 6, 9.
  if (source = target) then return EQUAL (=).
  ;; If source attribute value is ANY, then the result is SUPERSET.
  ;; Table 6-2, lines 2, 3.
  if (source = ANY) then return SUPERSET (⊃).
  ;; If target attribute value is ANY, then the result is SUBSET.
  ;; Table 6-2, lines 5, 13, 15.
  if (target = ANY) then return SUBSET (⊂).
  ;; If either source or target attribute value is NA then the
  ;; result is DISJOINT (≠). Table 6-2, lines 7, 12, 16.
  if (source = NA or target = NA) then return DISJOINT (≠).
  ;; If we get to this point, we are comparing two strings, so call
  ;; compareStrings(). Table 6-2, lines 10, 14.
  return compareStrings(source, target).
end.

;; The compareStrings() function compares a source string to a target
;; string, and addresses the condition in which the source string includes
;; unquoted special characters. It performs a simple regular expression
;; match, with the assumption that (as required) unquoted special characters
;; appear only at the beginning and/or the end of the source string. It
;; also properly differentiates between unquoted and quoted special
;; characters.
function compareStrings(source, target)
  start := 0.
  end := strlen(source).
  begins := 0.
  ends := 0.
  if (substr(source,0,0) = "*") then
    start := 1.
    begins := -1.
  else
    while ((start < strlen(source)) and
           (substr(source,start,start) = "?")) do
      start := start + 1.
      begins := begins + 1.
    end.
  endif.
  if ((substr(source,end-1,end-1) = "*") and
      (isEvenWildcards(source,end-1))) then
    end := end – 1.
    ends := -1.
  else
    while ((end > 0) and
           (substr(source,end-1,end-1) = "?") and
           (isEvenWildcards(source,end-1))) do
      end := end – 1.
      ends := ends + 1.
    end.
  endif.
  source := substr(source,start,end).
  index := -1.
  leftover := strlen(target).
  while (leftover > 0) do
    index := indexOf(target,source,index+1).
    if (index = -1) then break.
    escapes := countEscapeCharacters(target, 0, index).
    if ((index > 0) and
        (begins != -1) and
        (begins < (index – escapes))) then break.
    escapes := countEscapeCharacters(target, index+1, strlen(target)).
    leftover := strlen(target) – index – escapes – strlen(source).
    if ((leftover > 0) and ((ends != -1) and (leftover > ends)))
      then continue.
    return SUPERSET (⊃).
  end.
  return DISJOINT (≠).
end.

;; Function countEscapeCharacters takes a string str, a start index start,
;; and an end index end. Starting at the start offset into str, it counts
;; and returns the number of distinct escape (backslash) characters found,
;; up to and including the end index.
function countEscapeCharacters(str, start, end)
  result := 0.
  active := FALSE.
  i := 0.
  while (i < end) do
    active := (!active and (substr(str,i,i) = "\")).
    if (active and (i >= start)) then result := result + 1.
    i := i + 1.
  end.
  return result.
end.

;; Function isEvenWildcards returns true if an even number of
;; escape (backslash) characters precede the character at index
;; idx in string str.
function isEvenWildcards(str,idx)
  result := 0.
  while ((idx > 0) and (substr(str,idx-1,idx-1) = "\")) do
    idx := idx – 1.
    result := result + 1.
  end.
  return isEvenNumber(result).
end.

;; The is_string() function is a support function for compare().
function is_string(arg)
  ;; This function should return TRUE if arg is a string value,
  ;; and FALSE if arg is a logical value (ANY or NA).
end.

;; The contains_wildcards() function is a support function for compare().
function contains_wildcards(string)
  ;; Input to this function is a string value.
  ;; This function should return TRUE if the string contains any unquoted
  ;; special characters (question-mark or asterisk), otherwise FALSE.
  ;; Ex: contains_wildcards("foo") => FALSE
  ;; Ex: contains_wildcards("foo\?") => FALSE
  ;; Ex: contains_wildcards("foo?") => TRUE
  ;; Ex: contains_wildcards("\*bar") => FALSE
  ;; Ex: contains_wildcards("*bar") => TRUE
end.

function strlen(s)
  ;; Defined as in GNU C, returns the length of string s.
  ;; Returns zero if the string is empty.
end.

function substr(s,b,e)
  ;; Returns a substring of s, beginning at the b'th character,
  ;; with zero being the first character, and ending at the e'th
  ;; character. If b = e, returns the b'th character. b must be <= e.
  ;; Returns nil if b >= strlen(s).
end.

function indexOf(str1,str2,off)
  ;; Searches str1 for the first occurrence of the string str2, starting
  ;; at the offset off into str1. Semantics equivalent to the Java
  ;; string indexOf method. Returns -1 if str2 is not found.
end.

function to_lowercase(s)
  ;; convert all alphabetic characters to lowercase.
end.
原文のみ

Appendix A—References

付録 A—参考文献

The following documents are indispensable references for understanding the application of this specification.

次の文書は、この仕様の適用を理解するために欠かせない参考文献です。

A.1 Normative References

A.1 規範的参考文献

[CPE22] Buttner, A. and N. Ziring, Common Platform Enumeration (CPE)—Specification, Version 2.2, March 11, 2009. See http://cpe.mitre.org/specification/archive/version2.2/cpe-specification_2.2.pdf.

[CPE22] Buttner, A. and N. Ziring, Common Platform Enumeration (CPE)—Specification, Version 2.2, March 11, 2009. 参照: http://cpe.mitre.org/specification/archive/version2.2/cpe-specification_2.2.pdf.

[CPE23-N] Cheikes, B., Waltermire, D., and Scarfone, K., NIST Interagency Report 7695, Common Platform Enumeration: Naming Specification Version 2.3, August 2011. See http://csrc.nist.gov/publications/PubsNISTIRs.html.

[CPE23-N] Cheikes, B., Waltermire, D., and Scarfone, K., NIST Interagency Report 7695, Common Platform Enumeration: Naming Specification Version 2.3, August 2011. 参照: http://csrc.nist.gov/publications/PubsNISTIRs.html.

[RFC2119] Bradner, S. Key words for use in RFCs to Indicate Requirement Levels. March 1997. See http://www.ietf.org/rfc/rfc2119.txt.

[RFC2119] Bradner, S. Key words for use in RFCs to Indicate Requirement Levels. March 1997. 参照: http://www.ietf.org/rfc/rfc2119.txt.

A.2 Informative References

A.2 参考情報

[SP800-117] Quinn, S., Scarfone, K., Barrett, M., and Johnson, C., NIST Special Publication 800-117, Guide to Adopting and Using the Security Content Automation Protocol, July 2010. See http://csrc.nist.gov/publications/PubsSPs.html#800-117.

[SP800-117] Quinn, S., Scarfone, K., Barrett, M., and Johnson, C., NIST Special Publication 800-117, Guide to Adopting and Using the Security Content Automation Protocol, July 2010. 参照: http://csrc.nist.gov/publications/PubsSPs.html#800-117.

[SP800-126] Waltermire, D., Quinn, S., Scarfone, K., and Halbardier, A., NIST Special Publication 800- 126 Revision 2, The Technical Specification for the Security Content Automation Protocol (SCAP): SCAP Version 1.2, August 2011. See http://csrc.nist.gov/publications/PubsSPs.html#800-126.

[SP800-126] Waltermire, D., Quinn, S., Scarfone, K., and Halbardier, A., NIST Special Publication 800- 126 Revision 2, The Technical Specification for the Security Content Automation Protocol (SCAP): SCAP Version 1.2, August 2011. 参照: http://csrc.nist.gov/publications/PubsSPs.html#800-126.

Appendix B—Implementing CPE 2.2 Matching Functionality

付録 B—CPE 2.2 の照合機能の実装

This appendix explains how to implement CPE 2.2 equivalent matching capabilities using CPE 2.3 matching functions.

この付録では、CPE 2.3 の照合関数を使って、CPE 2.2 と同等の照合機能を実装する方法を説明します。

In [CPE22: 7.2] (“Matching Algorithm: Known Instance Based Matching”) a name-comparison function CPE_Name_Match is defined, with the following inputs and outputs:

[CPE22: 7.2](「Matching Algorithm: Known Instance Based Matching」)では、名前比較関数 CPE_Name_Match が、次の入力と出力で定義されています。

入力:

•K - A list of m CPE Names, K = {K1, K2, …, Km} .

•K - m 個の CPE 名のリスト。K = {K1, K2, …, Km}。

•X - A candidate CPE Name

•X - 候補となる CPE 名

出力:

•True if X matches K, false otherwise.

•X が K に一致する場合は true、そうでなければ false。

The accompanying pseudocode is reproduced below for ease of reference:

参照しやすいように、付随する擬似コードを以下に再掲します。

function CPE_Name_Match(K, X)
  for each N in K do
    if length(N)>= length(X) then r := false.
    for i := 1 to length(X) do
      if comp(X,i) = comp(N,i) or comp(X,i) = ""
        then
          r := true.
        else
          r := false.
          break.
      end if.
    end for.
    if r = true then return true.
  end for.
  return false.
end.
原文のみ

The above function methodically compares X to each CPE name N in K, and returns TRUE when the first match is found between the source X and the target N. If no such match is found, the function returns FALSE.

上記の関数は、X を K の各 CPE 名 N と体系的に比較し、元の X と対象の N の間で最初の一致が見つかった時点で TRUE を返します。そのような一致が見つからない場合、関数は FALSE を返します。

The core source-to-target comparison implemented above in CPE_Name_Match is functionally equivalent to the CPE_SUPERSET function specified in Section 7.2 of this document. Using the new capabilities introduced in the current specification, one could implement CPE_Name_Match as follows:

上記の CPE_Name_Match に実装された、元から対象への中核となる比較は、この文書の第 7.2 節で規定する CPE_SUPERSET 関数と機能的に等価です。現在の仕様で導入された新しい機能を使って、CPE_Name_Match を次のように実装できます。

入力:

•K - A list of m target WFNs, K = {K1, K2, …, Km} .

•K - m 個の対象 WFN のリスト。K = {K1, K2, …, Km}。

•X - A source WFN

•X - 元の WFN

出力:

•True if X matches K, false otherwise.

•X が K に一致する場合は true、そうでなければ false。

function CPE_Name_Match(K, X)
  for each N in K do
    if CPE_SUPERSET(X, N) then return true.
  end for.
  return false.
end.
原文のみ

The above pseudocode differs from the CPE 2.2 implementation in that the argument X is expected to be a WFN (rather than a CPE name encoded as a character string), and the argument K is expected to be a list of WFNs. To see that this is true, consider the following matching example, based on the example presented in [CPE2.2: 7.3]:

上記の擬似コードは、引数 X が(文字列としてエンコードされた CPE 名ではなく)WFN であり、引数 K が WFN のリストであることが想定されている点で、CPE 2.2 の実装と異なります。これが正しいことを確認するため、[CPE2.2: 7.3] に示された例に基づく、次の照合の例を考えます。

K = {wfn:[part="o",vendor="microsoft",product="windows_2000",
          update="sp3",edition="pro"],
     wfn:[part="a",vendor="microsoft",product="ie",version="5.5"]}
原文のみ
X = wfn:[part="o",vendor="microsoft",product="windows_2000"]
原文のみ

In this example, the result of the comparison is true because

この例では、比較の結果は true です。なぜなら、

CPE_SUPERSET(wfn:[part="o",vendor="microsoft",product="windows_2000"],
             wfn:[part="o",vendor="microsoft",product="windows_2000",
                  update="sp3",edition="pro"])
原文のみ

returns true. Recall that unspecified attributes in a WFN default to the logical value ANY, thus the value of the update and edition attributes in X are ANY. The result of comparing an ANY value in the source to a specific value (e.g., "sp3") in the target is SUPERSET (cf. line 3 in Table 6-2), and the result of comparing an ANY value in the source to an ANY value in the target is EQUAL (cf. line 1 in Table 6-2). CPE_SUPERSET is true when all pairwise attribute comparisons yield EQUAL or SUPERSET.

が true を返すからです。WFN で指定されていない属性は、既定で論理値 ANY になることを思い出してください。したがって、X の update 属性と edition 属性の値は ANY です。元の ANY の値を対象の特定の値(たとえば "sp3")と比較した結果は SUPERSET であり(cf. 表 6-2 の 3 行目)、元の ANY の値を対象の ANY の値と比較した結果は EQUAL です(cf. 表 6-2 の 1 行目)。CPE_SUPERSET は、属性の対ごとの比較がすべて EQUAL または SUPERSET となるとき、true になります。

Appendix C—Change Log

付録 C—変更履歴

Release 0 – 9 June 2010

リリース 0 – 2010 年 6 月 9 日

•Initial draft specification released to the CPE community as a read ahead for the CPE Developer Days Workshop.

•CPE Developer Days Workshop の事前資料として、最初のドラフト仕様を CPE コミュニティに公開しました。

Release 1 – 30 June 2010

リリース 1 – 2010 年 6 月 30 日

•Near final draft released to NIST for submission to review process.

•レビュー手続きに提出するため、最終稿に近いドラフトを NIST に引き渡しました。

•Minor editorial changes throughout the document.

•文書全体で軽微な編集上の変更を行いました。

•Added abstract and change log sections.

•概要と変更履歴の節を追加しました。

•Removed all mention of and support for the logical value UNKNOWN.

•論理値 UNKNOWN への言及とサポートをすべて削除しました。

•Updated audience sections to align with the CPE Naming specification.

•CPE Naming 仕様に合わせて、想定読者の節を更新しました。

•Updated the name matching sections to reflect the new set relation matching results and the minimal required name matching criteria.

•新しい集合関係の照合結果と、必要最小限の名前照合基準を反映するよう、名前照合の節を更新しました。

•Added restrictions to the wild card verbiage to allow only start and end wild card usage within a value string.

•値の文字列内では、先頭と末尾でのワイルドカードの使用のみを許可するよう、ワイルドカードの文言に制限を追加しました。

•Added source wild card to target wild card matching pseudocode.

•元のワイルドカードから対象のワイルドカードへの照合の擬似コードを追加しました。

•Broke out the name matching function to four separate functions in the pseudocode.

•擬似コードで、名前照合関数を 4 つの別々の関数に分割しました。

•Added a new section to define wild card matching criteria and methods.

•ワイルドカードの照合基準と方法を定義する新しい節を追加しました。

Release 2 – 22 April 2011

リリース 2 – 2011 年 4 月 22 日

•Reorganized the sequence of several sections and sub-sections.

•いくつかの節と小節の順序を並べ替えました。

•Added discussion of the set-theoretic view of WFNs that underlies the name matching model.

•名前照合モデルの根底にある、WFN の集合論的な見方についての議論を追加しました。

•Removed the INTERSECT function, and clarified the definitions of SUBSET and SUPERSET.

•INTERSECT 関数を削除し、SUBSET と SUPERSET の定義を明確にしました。

•Extensively revised the informative pseudocode for clarity and organization.

•明確さと構成のため、参考情報の擬似コードを大幅に改訂しました。

•Added explicit support for wild cards in the source attribute values, including informative pseudocode for the string comparison functions.

•元の属性値でのワイルドカードの明示的なサポートを、文字列比較関数の参考情報の擬似コードを含めて追加しました。

•Added Appendix B, which describes how to implement CPE 2.2-equivalent matching capabilities using CPE 2.3 functions.

•CPE 2.3 の関数を使って CPE 2.2 と同等の照合機能を実装する方法を説明する付録 B を追加しました。

•Minor editorial changes throughout the document.

•文書全体で軽微な編集上の変更を行いました。

Release 3 – 30 August 2011

リリース 3 – 2011 年 8 月 30 日

•Final release of CPE Name Matching 2.3 specification.

•CPE Name Matching 2.3 仕様の最終リリース。

•Made minor editorial changes.

•軽微な編集上の変更を行いました。

•Corrected minor errors in pseudocode.

•擬似コードの軽微な誤りを訂正しました。