NIST IR 7697 日本語訳
英語タイトル : Common Platform Enumeration: Dictionary Specification Version 2.3日本語タイトル : 共通プラットフォーム列挙:辞書仕様 バージョン 2.3
公開日 : 2011-08-19
原文URL : https://csrc.nist.gov/pubs/ir/7697/final
翻訳編集 : 自動生成(有志による非公式の日本語訳), 原文取得日 : 2026-10-31, 訳文 : 396 / 412 ブロック
[要約] NIST IR 7697 は、共通プラットフォーム列挙(CPE)辞書バージョン 2.3 の仕様を定義する報告書です。CPE 辞書仕様は、情報技術(IT)製品の記述と命名に関するさまざまなユースケースを支える CPE 仕様群の一部であり、個々の CPE 辞書は IT 製品名のリポジトリで、リポジトリ内の各名前は世界中の IT 製品の一意のクラスを識別します。本仕様は、CPE 辞書データモデルの意味と、CPE 辞書の作成および管理に関連する規則を定義します。CPE 辞書を含む IT 製品およびサービスが仕様に適合するために満たさなければならない要件も、定義し説明しています。
[NIST のロゴ。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]
NIST Interagency Report 7697
NIST省庁間報告書 7697
Common Platform Enumeration: Dictionary Specification Version 2.3
共通プラットフォーム列挙: 辞書仕様 バージョン 2.3
Paul Cichonski
David Waltermire
Karen Scarfone
Paul Cichonski
David Waltermire
Karen Scarfone
NIST Interagency Report 7697
NIST省庁間報告書 7697
Common Platform Enumeration: Dictionary Specification Version 2.3
共通プラットフォーム列挙: 辞書仕様 バージョン 2.3
Paul Cichonski
David Waltermire
Karen Scarfone
Paul Cichonski
David Waltermire
Karen Scarfone
COMPUTER SECURITY
コンピュータセキュリティ
[米国商務省の紋章。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]
Computer Security Division
Information Technology Laboratory
National Institute of Standards and Technology
Gaithersburg, MD 20899-8930
情報セキュリティ部門
情報技術研究所
米国国立標準技術研究所
メリーランド州ゲイサーズバーグ 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
Patrick D. Gallagher, Under Secretary for Standards and Technology and Director
米国国立標準技術研究所
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.
国立標準技術研究所(NIST)の情報技術研究所(ITL)は、国の計測・標準インフラに対する技術的なリーダーシップを提供することで、米国経済と公共の福祉を促進しています。ITL は、情報技術の開発と生産的な利用を進めるために、試験、試験方法、参照データ、概念実証の実装、技術分析を開発しています。ITL の責務には、連邦コンピュータシステムにおける機微だが機密扱いでない情報について、そのセキュリティとプライバシーを費用対効果よく確保するための、技術上、物理的、運用上および管理上の標準とガイドラインの開発が含まれます。この Interagency Report は、ITL のコンピュータセキュリティに関する研究、ガイダンス、アウトリーチの取り組みと、産業界、政府、学術機関との共同活動について論じています。
National Institute of Standards and Technology Interagency Report 7697
38 pages (Aug. 2011)
米国国立標準技術研究所 省庁間報告書 7697
38 ページ(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, Paul Cichonski 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 Harold Booth of NIST, Brant A. Cheikes and Mary Parmelee of the MITRE Corporation, Adam Halbardier and Christopher McCormick 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.
著者である国立標準技術研究所(NIST)の Paul Cichonski と David Waltermire、および Scarfone Cybersecurity の Karen Scarfone は、本文書のドラフトを査読し、技術的内容に貢献してくれた同僚に感謝します。著者は、文書の策定を通じて洞察と支援を寄せてくれた、NIST の Harold Booth、MITRE Corporation の Brant A. Cheikes と Mary Parmelee、Booz Allen Hamilton の Adam Halbardier と Christopher McCormick、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) Dictionary version 2.3 specification. The CPE Dictionary Specification is a part of a stack of CPE specifications that support a variety of use cases relating to information technology (IT) product description and naming. An individual CPE dictionary is a repository of IT product names, with each name in the repository identifying a unique class of IT product in the world. This specification defines the semantics of the CPE Dictionary data model and the rules associated with CPE dictionary creation and management. This report also defines and explains the requirements that IT products and services, including CPE dictionaries, must meet for conformance with the CPE Dictionary version 2.3 specification.
本報告書は、共通プラットフォーム列挙(CPE)辞書バージョン 2.3 の仕様を定義します。CPE 辞書仕様は、情報技術(IT)製品の記述と命名に関するさまざまなユースケースを支える、CPE 仕様群の一部です。個々の CPE 辞書は IT 製品名のリポジトリであり、リポジトリ内の各名前は、世界中の IT 製品の一意のクラスを識別します。本仕様は、CPE 辞書データモデルの意味と、CPE 辞書の作成および管理に関連する規則を定義します。本報告書は、CPE 辞書を含む IT 製品およびサービスが、CPE 辞書バージョン 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
図の一覧
List of 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 information technology (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.
共通プラットフォーム列挙(CPE)は、エンタープライズのコンピューティング資産に存在するアプリケーション、オペレーティングシステム、ハードウェア機器のクラスを記述し、識別するための標準化された方法です。CPE は、これらの資産に関する脆弱性、構成、是正のポリシーなど、情報技術(IT)管理ポリシーを実施し、検証するための情報源として使用できます。IT 管理ツールは、インストールされている製品に関する情報を収集し、CPE 名を使って製品を識別し、この標準化された情報を使って、資産に関する完全または部分的に自動化された判断を支援できます。
CPE consists of several modular specifications. Combinations of the specifications work together in layers to perform various functions. This specification, CPE Dictionary, defines a standardized method for creating and managing CPE dictionaries. A dictionary is a repository of CPE names and metadata associated with the names. Each CPE name in the dictionary identifies a single class of IT product in the world. The word “class” here signifies that the object identified is not a physical instantiation of a product on a system, but rather the abstract model of that product. Although organizations may use a CPE name to represent either a single product class or a set of multiple product classes, a CPE dictionary stores only bound forms of well-formed CPE names (WFNs) that identify a single product class, not a set of product classes. These single product-class WFNs in bound form are referred to as identifier names. An example of a WFN and its bound forms is shown below.
CPE は、複数のモジュール式の仕様で構成されています。仕様の組み合わせが層をなして連携し、さまざまな機能を実行します。本仕様である CPE 辞書は、CPE 辞書を作成し管理するための標準化された方法を定義します。辞書とは、CPE 名と、その名前に関連付けられたメタデータのリポジトリです。辞書内の各 CPE 名は、世界中の IT 製品の単一のクラスを識別します。ここでの「クラス」という語は、識別される対象が、システム上にある製品の物理的なインスタンスではなく、その製品の抽象的なモデルであることを意味します。組織は CPE 名を、単一の製品クラスと、複数の製品クラスの集合のどちらを表すためにも使用できますが、CPE 辞書は、製品クラスの集合ではなく単一の製品クラスを識別する、整形式 CPE 名(WFN)の束縛形式だけを格納します。束縛形式の、これらの単一の製品クラスの WFN は、識別子名と呼ばれます。WFN とその束縛形式の例を以下に示します。
WFN:
WFN:
wfn:[part="o",vendor="microsoft",product="windows_vista",version="6\.0",
update="sp1",edition=NA,language=NA,sw_edition="home_premium",
target_sw=NA,target_hw="x64",other=NA]
WFN bound to a URI:
URI に束縛した WFN:
cpe:/o:microsoft:windows_vista:6.0:sp1:~-~home_premium~-~x64~-
WFN bound to a formatted string:
書式付き文字列に束縛した WFN:
cpe:2.3:o:microsoft:windows_vista:6.0:sp1:-:-:home_premium:-:x64:-
NIST hosts the Official CPE Dictionary1, which is the authoritative repository of identifier names. The goal of the CPE stack of specifications is to provide entities within the IT industry a standardized way to describe and identify IT products, and the Official CPE Dictionary provides the mechanism to support this interoperability for product identifiers. The authoritative nature of the Official CPE Dictionary allows organizations to search for and find identifier names in one centralized place without worrying about dealing with conflicts between federated dictionaries.
NIST は、識別子名の権威あるリポジトリである公式 CPE 辞書1をホストしています。CPE 仕様群の目標は、IT 業界内の主体に、IT 製品を記述し識別する標準化された方法を提供することであり、公式 CPE 辞書は、製品識別子についてのこの相互運用性を支える仕組みを提供します。公式 CPE 辞書が権威あるものであることにより、組織は、連携する辞書同士の競合への対処を気にすることなく、1 つの中央の場所で識別子名を検索して見つけることができます。
Organizations may create their own extended CPE dictionaries, which are used to store identifier names not present in the Official CPE Dictionary. There are several reasons why extended dictionaries are needed. For example, an organization may have to create identifier names for proprietary products that are only useful within that organization, such as internally developed software not found outside the organization. Another possible reason is that an IT company may want to use identifiers for their unreleased products that do not yet have official identifier names; once the identifier names have stabilized, the company would submit them to the Official CPE Dictionary. Finally, an organization may discover new products in use that do not yet have official identifiers; the organization could create identifiers, add them to its own extended dictionary, submit them for inclusion in the Official CPE Dictionary, and use them internally while waiting for their addition to the Official CPE Dictionary.
組織は、公式 CPE 辞書に存在しない識別子名を格納するために使用する、独自の拡張 CPE 辞書を作成してもよいです。拡張辞書が必要になる理由はいくつかあります。たとえば、組織は、その組織内でのみ有用な独自の製品(組織外には存在しない、社内で開発されたソフトウェアなど)の識別子名を作成しなければならない場合があります。別の理由として考えられるのは、IT 企業が、まだ公式の識別子名を持たない未発表の製品に識別子を使いたい場合です。識別子名が安定したら、その企業はそれらを公式 CPE 辞書に提出します。最後に、組織は、使用中の新しい製品で、まだ公式の識別子がないものを発見する場合があります。その組織は、識別子を作成して自らの拡張辞書に追加し、公式 CPE 辞書への収録のために提出し、公式 CPE 辞書への追加を待つあいだ、組織内でそれらを使用できます。
1.1 Purpose and Scope
1.1 目的と範囲
This document defines the specification for CPE Dictionary version 2.3. This includes formally defining the concept of a CPE dictionary, the rules and policies relating to dictionary instantiation and management, and the data model that represents all dictionary concepts and relationships. This document also establishes the concept of an Official CPE Dictionary, as well as the process for how organizations can extend the Official CPE Dictionary using extended CPE dictionaries.
この文書は、CPE 辞書バージョン 2.3 の仕様を定義します。これには、CPE 辞書の概念、辞書のインスタンス化と管理に関する規則とポリシー、およびすべての辞書の概念と関係を表すデータモデルの正式な定義が含まれます。この文書は、公式 CPE 辞書の概念と、組織が拡張 CPE 辞書を使って公式 CPE 辞書を拡張する方法のプロセスも定めます。
This report only applies to version 2.3 of CPE Dictionary. All other versions are out of the scope of this report, as are all CPE specifications other than CPE Dictionary. Operational guidelines, such as suggested processes for submitting new entries to a dictionary, are also out of the scope of this report.
本報告書は、CPE 辞書のバージョン 2.3 にのみ適用されます。CPE 辞書以外のすべての CPE 仕様と同様に、その他のバージョンは本報告書の範囲外です。辞書に新しいエントリを提出するための推奨プロセスなどの運用上のガイドラインも、本報告書の範囲外です。
1.2 Audience
1.2 対象読者
This report is intended for two main audiences: the creators and maintainers of CPE dictionaries, and IT management tool developers. Readers of this report should already be familiar with CPE naming and name matching concepts and conventions, as specified in [CPE23-N] and [CPE23-M].
本報告書は、2 つの主な読者、すなわち CPE 辞書の作成者と保守者、および IT 管理ツールの開発者を対象としています。本報告書の読者は、[CPE23-N] と [CPE23-M] で規定されている CPE の命名と名前照合の概念および規約に、すでに精通しているべきです。
1.3 Document Structure
1.3 文書の構成
The remainder of this report is organized into the following major sections and appendices:
本報告書の残りの部分は、以下の主な節と付録で構成されています。
•Section 2 defines selected terms and abbreviations used within this specification.
•2 節では、本仕様で使用される主な用語と略語を定義します。
•Section 3 provides an overview of related specifications or standards.
•3 節では、関連する仕様または標準の概要を示します。
•Section 4 defines the conformance rules for this specification.
•4 節では、本仕様の適合規則を定義します。
•Section 5 defines the CPE dictionary data model.
•5 節では、CPE 辞書データモデルを定義します。
•Section 6 provides information and requirements related to CPE dictionary creation and maintenance.
•6 節では、CPE 辞書の作成と保守に関する情報と要件を示します。
•Section 7 defines operations for using a CPE dictionary, such as looking up a particular identifier name or searching for dictionary entries that belong to a particular set of products.
•7 節では、特定の識別子名を検索する、特定の製品の集合に属する辞書エントリを検索するなど、CPE 辞書を使用するための操作を定義します。
•Section 8 provides pseudocode that implements concepts defined in other sections of the specification.
•8 節では、仕様の他の節で定義された概念を実装する擬似コードを示します。
•Appendix A lists normative and informative references.
•付録 A では、規範的な参考文献と参考情報の文献を挙げます。
•Appendix B provides a change log that documents significant changes to major drafts of the specification.
•付録 B では、仕様の主要なドラフトにおける重要な変更を記録する変更履歴を示します。
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 Request for Comment (RFC) 2119.2
本文書におけるキーワード “MUST”、“MUST NOT”、“REQUIRED”、“SHALL”、“SHALL NOT”、“SHOULD”、“SHOULD NOT”、“RECOMMENDED”、“MAY”、“OPTIONAL” は、Request for Comment(RFC)2119 に記載されているとおりに解釈されます。2
Text intended to represent computing system input, output, or algorithmic processing is presented in fixed-width Courier font.
コンピューティングシステムの入力、出力、またはアルゴリズム処理を表すことを意図したテキストは、等幅の Courier フォントで示します。
Normative references are listed in Appendix A. These references use the citation convention of 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).
規範的な参考文献は付録 A に挙げています。これらの参考文献は、参考文献全体の引用の略称を含む角括弧表記の後に、コロンと、該当する場合は小節の引用が続く引用規約を用います(例: [CPE23-N:7.2] は、CPE 2.3 Naming 仕様の 7.2 節の引用です)。
This specification adheres to all rules and conventions defined lower in the CPE stack of specifications. The CPE Naming Specification defines the concept of a Well-Formed CPE Name (WFN) that is a logical representation of a CPE name [CPE23-N:5.1]. Wherever possible, this specification uses WFN representation of CPE names to limit the dependency on any particular CPE name binding. However, readers should keep in mind that CPE dictionaries store bound CPE names, not WFNs.
本仕様は、CPE 仕様群の下位で定義されたすべての規則と規約に従います。CPE Naming 仕様は、CPE 名の論理的な表現である整形式 CPE 名(WFN)の概念を定義しています [CPE23-N:5.1]。本仕様は、特定の CPE 名の束縛への依存を抑えるため、可能な限り CPE 名の WFN 表現を使用します。ただし、読者は、CPE 辞書が格納するのは WFN ではなく束縛された 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. In most cases semantically equivalent functions can be found in the GNU C library, cf. http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities.
•一部の場合には、擬似コードの関数が、特に文字列処理を支援するために、(ほぼ)標準のライブラリ関数を参照します。ほとんどの場合、意味的に等価な関数を GNU C library に見つけることができます。http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities を参照してください。
This document uses qualified names to refer to specific XML elements. A qualified name associates a named element with a namespace. The namespace identifies the XML model, and the XML schema is a definition and implementation of that model. A qualified name declares this schema to element association using the format ‘prefix:element-name’. The association of prefix to namespace is defined in the metadata of an XML document and varies from document to document. This document uses the conventional mappings listed below.
本文書は、特定の XML 要素を参照するために、修飾名を使用します。修飾名は、名前付きの要素を名前空間に関連付けます。名前空間は XML モデルを識別し、XML スキーマはそのモデルの定義と実装です。修飾名は、‘prefix:element-name’ という書式を使って、このスキーマと要素の関連付けを宣言します。接頭辞と名前空間の関連付けは、XML 文書のメタデータで定義され、文書ごとに異なります。本文書は、以下に挙げる慣例的な対応付けを使用します。
| Prefix | Namespace | Schema |
|---|---|---|
| cpe_dict | http:/ | CPE Dictionary 2.3 schema |
| cpe_dict_ext | http:/ | CPE Dictionary 2.3 schema extension |
| cpe-name | http:/ | CPE Naming 2.3 schema |
| xml | http:/ | Common XML attributes |
| xsd | http:/ | XML Schema |
| 接頭辞 | 名前空間 | スキーマ |
|---|---|---|
| cpe_dict | http:/ | CPE 辞書 2.3 スキーマ |
| cpe_dict_ext | http:/ | CPE 辞書 2.3 スキーマ拡張 |
| cpe-name | http:/ | CPE 命名 2.3 スキーマ |
| xml | http:/ | 共通 XML 属性 |
| xsd | http:/ | XML スキーマ |
2. Definitions and Abbreviations
2. 定義と略語
This section defines selected terms and abbreviations used within the document. This section builds on the terms defined in the CPE Naming specification [CPE23-N] and the CPE Name Matching specification [CPE23-M], and does not repeat them here.
この節では、本文書内で使用される選択した用語と略語を定義します。この節は、CPE Naming 仕様 [CPE23-N] と CPE Name Matching 仕様 [CPE23-M] で定義された用語を土台としており、それらをここでは繰り返しません。
2.1 Definitions
2.1 定義
CPE Dictionary: A repository of identifier CPE names (WFNs in bound form) and associated metadata.
CPE 辞書(CPE Dictionary): 識別子 CPE 名(束縛形式の WFN)と、関連するメタデータのリポジトリです。
Deprecated Identifier Name: An identifier name that is no longer valid because it has either been replaced by a new identifier name or set of identifier names or was created erroneously.
非推奨の識別子名(Deprecated Identifier Name): 新しい識別子名または識別子名の集合に置き換えられたか、誤って作成されたかのいずれかの理由で、もはや有効でない識別子名です。
Dictionary Contributor: An organization or person that submits new identifier CPE names to a dictionary for inclusion.
辞書の貢献者(Dictionary Contributor): 新しい識別子 CPE 名を、収録のために辞書へ提出する組織または個人です。
Dictionary Creator: An organization that instantiates a CPE dictionary that conforms to the guidance within this specification. A dictionary creator is the organization that is ultimately responsible for the dictionary.
辞書の作成者(Dictionary Creator): 本仕様のガイダンスに適合する CPE 辞書をインスタンス化する組織です。辞書の作成者は、その辞書に最終的な責任を負う組織です。
Dictionary Maintainer: An organization that manages a CPE dictionary and all processes relating to that CPE dictionary. In the majority of cases, the organization that serves as the dictionary creator for a specific CPE dictionary will also serve as the dictionary maintainer. Otherwise, generally the dictionary maintainer is supporting the dictionary on behalf of the dictionary creator.
辞書の保守者(Dictionary Maintainer): CPE 辞書と、その CPE 辞書に関するすべてのプロセスを管理する組織です。大多数の場合、特定の CPE 辞書の辞書の作成者を務める組織が、辞書の保守者も務めます。そうでない場合、一般に、辞書の保守者は辞書の作成者に代わって辞書を支援します。
Dictionary Management Documents: A set of documentation that captures the rules and processes specific to a CPE dictionary.
辞書の管理文書(Dictionary Management Documents): CPE 辞書に固有の規則とプロセスを記録した文書一式です。
Dictionary Search: The process of determining which identifier names within a CPE dictionary are members of a source name that represents a set of products.
辞書の検索(Dictionary Search): CPE 辞書内のどの識別子名が、製品の集合を表すソース名の構成要素であるかを判定するプロセスです。
Dictionary User: An organization, individual, product, or service that consumes a CPE dictionary for any purpose.
辞書の利用者(Dictionary User): 何らかの目的で CPE 辞書を利用する組織、個人、製品、またはサービスです。
Extended CPE Dictionary: A dictionary that an organization may create to house identifier names not found in the Official CPE Dictionary.
拡張 CPE 辞書(Extended CPE Dictionary): 公式 CPE 辞書にない識別子名を収めるために、組織が作成してもよい辞書です。
Identifier Lookup: The process of determining if a single identifier name exists in a CPE dictionary.
識別子の検索(Identifier Lookup): 単一の識別子名が CPE 辞書に存在するかどうかを判定するプロセスです。
Identifier CPE Name: A bound representation of a CPE WFN that uniquely identifies a single product class. Also referred to as an “identifier name”.
識別子 CPE 名(Identifier CPE Name): 単一の製品クラスを一意に識別する、CPE WFN の束縛された表現です。「識別子名」とも呼ばれます。
Known Data: A category of information that may be present within an attribute of a CPE name. Known data represents any meaningful value about a product (e.g., “sp1”, “2.3.4”, “pro”, NA), but does not include the logical value ANY.
既知のデータ(Known Data): CPE 名の属性内に存在し得る情報の分類です。既知のデータは、製品に関する意味のある任意の値(例: “sp1”、“2.3.4”、“pro”、NA)を表しますが、論理値 ANY は含みません。
Official CPE Dictionary: The authoritative repository of identifier names, which is hosted by NIST.
公式 CPE 辞書(Official CPE Dictionary): NIST がホストする、識別子名の権威あるリポジトリです。
Official Identifier CPE Name: Any bound representation of a CPE WFN that uniquely identifies a single product class and is contained within the Official CPE Dictionary.
公式識別子 CPE 名(Official Identifier CPE Name): 単一の製品クラスを一意に識別し、公式 CPE 辞書に含まれる、CPE WFN の束縛された表現です。
2.2 Abbreviations
2.2 略語
| CPE | Common Platform Enumeration |
| IR | Interagency Report |
| IT | Information Technology |
| ITL | Information Technology Laboratory |
| NIST | National Institute of Standards and Technology |
| RFC | Request for Comment |
| URI | Uniform Resource Identifier |
| WFN | Well-Formed CPE Name |
| XML | Extensible Markup Language |
| CPE | 共通プラットフォーム列挙 |
| IR | 省庁間報告書 |
| IT | 情報技術 |
| ITL | 情報技術研究所 |
| NIST | 米国国立標準技術研究所 |
| RFC | コメント要求 |
| URI | 統一資源識別子 |
| WFN | 整形式 CPE 名 |
| XML | 拡張可能マークアップ言語 |
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 was constructed using 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 Dictionary version 2.3 specification builds upon the CPE Naming version 2.3 [CPE23-N] and CPE Name Matching version 2.3 [CPE23-M] specifications to define the concept of a CPE dictionary.
CPE Dictionary バージョン 2.3 仕様は、CPE Naming バージョン 2.3 [CPE23-N] 仕様と CPE Name Matching バージョン 2.3 [CPE23-M] 仕様を土台として、CPE 辞書の概念を定義します。
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 differences between CPE Dictionary versions 2.2 and 2.3 include:
CPE Dictionary のバージョン 2.2 と 2.3 の主な相違点は次のとおりです。
•Updated deprecation logic that includes one-to-many CPE deprecation
•1 対多の CPE 非推奨化を含む、更新された非推奨化のロジック
•Updated change history and provenance data requirements
•更新された変更履歴と来歴データの要件
•Built-in one-to-one mapping between CPE version 2.2 and version 2.3 names; the version 2.3 name is embedded in the version 2.2 name so that the instance document will validate against the version 2.2 schema.
•CPE バージョン 2.2 と 2.3 の名前の間の組み込みの 1 対 1 の対応付け。バージョン 2.3 の名前はバージョン 2.2 の名前に埋め込まれているため、インスタンス文書はバージョン 2.2 スキーマに対して検証されます。
4. Conformance
4. 適合性
Products and organizations may want to claim conformance with this specification for a variety of reasons. For example, a product may want to assert that it uses official identifier names properly. Organizations may want to claim conformance if they are creating and/or maintaining CPE dictionaries.
製品や組織は、さまざまな理由で、本仕様への適合を主張したい場合があります。たとえば、製品が、公式の識別子名を適切に使用していると主張したい場合があります。組織は、CPE 辞書を作成または保守している場合に、適合を主張したい場合があります。
This section provides the high-level requirements that a product or organization must meet if they are seeking conformance with this specification. The majority of the requirements listed in this section reference other sections in this document that fully define the high-level requirement.
この節では、製品または組織が本仕様への適合を求める場合に満たさなければならない、高水準の要件を示します。この節に挙げる要件の大半は、その高水準の要件を完全に定義している本文書内の他の節を参照しています。
4.1 Dictionary Use Conformance
4.1 辞書の使用に関する適合性
This section contains the set of requirements for IT products asserting conformance with this specification for dictionary use. Products may claim conformance with this specification to show that the product uses identifier names properly. All products claiming conformance with this specification MUST adhere to the following requirements:
この節には、辞書の使用に関して本仕様への適合を主張する IT 製品の要件の集合が含まれます。製品は、識別子名を適切に使用していることを示すために、本仕様への適合を主張してもよいです。本仕様への適合を主張するすべての製品は、次の要件に従わなければなりません(MUST)。
1.Products using CPE names as identifiers MUST only use identifier names that meet the criteria defined in Section 6.1. Products using identifier names SHOULD only use official identifier names, which are located in the Official CPE Dictionary. If an official identifier name is not available, the product MUST use an identifier name contained within an extended CPE dictionary to which it has access.
1.CPE 名を識別子として使用する製品は、6.1 節で定義された基準を満たす識別子名のみを使用しなければなりません(MUST)。識別子名を使用する製品は、公式 CPE 辞書にある公式の識別子名を使用すべきです(SHOULD)。公式の識別子名が利用できない場合、製品は、アクセスできる拡張 CPE 辞書に含まれる識別子名を使用しなければなりません(MUST)。
2.Products using a CPE dictionary MUST adhere to the requirements in Section 7.1 and 7.2 for identifier lookups and dictionary searches.
2.CPE 辞書を使用する製品は、識別子の検索と辞書の検索について、7.1 節と 7.2 節の要件に従わなければなりません(MUST)。
3.When a product consumes or outputs an identifier name, that product MUST first determine if the identifier name is deprecated and act appropriately if it is, in compliance with the process defined in Section 7.3. This requirement MAY be ignored if the product is intending to communicate information about deprecated identifier names.
3.製品が識別子名を取り込む、または出力する際、その製品は、まずその識別子名が非推奨かどうかを判定し、非推奨である場合は、7.3 節で定義されたプロセスに従って適切に対処しなければなりません(MUST)。製品が非推奨の識別子名に関する情報を伝達しようとしている場合、この要件は無視してもよいです(MAY)。
4.2 Dictionary Creation and Maintenance Conformance
4.2 辞書の作成と保守に関する適合性
Organizations creating or maintaining CPE dictionaries may claim conformance with this specification if the dictionary meets the requirements in this section. This section first provides the generic requirements for all dictionaries, then provides requirements specific to the dictionary type (i.e. Official CPE Dictionary or extended CPE dictionary).
CPE 辞書を作成または保守する組織は、辞書がこの節の要件を満たす場合、本仕様への適合を主張してもよいです。この節ではまず、すべての辞書に共通の要件を示し、次に、辞書の種類(すなわち公式 CPE 辞書か拡張 CPE 辞書か)に固有の要件を示します。
1.The data within a CPE dictionary MUST adhere to the data model defined in Section 5; this includes all entries in the dictionary containing the mandatory elements defined in Section 5.
1.CPE 辞書内のデータは、5 節で定義されたデータモデルに従わなければなりません(MUST)。これには、辞書内のすべてのエントリが、5 節で定義された必須要素を含むことが含まれます。
2.Organizations creating/maintaining a CPE dictionary MAY extend the CPE dictionary data model defined in Section 5. These organizations MUST use only the extension points defined in Section 5.7 when extending the CPE dictionary data model.
2.CPE 辞書を作成・保守する組織は、5 節で定義された CPE 辞書データモデルを拡張してもよいです(MAY)。これらの組織は、CPE 辞書データモデルを拡張する際、5.7 節で定義された拡張ポイントのみを使用しなければなりません(MUST)。
3.All entries in a CPE dictionary MUST adhere to the minimum set of identifier name acceptance criteria defined in Section 6.1.
3.CPE 辞書内のすべてのエントリは、6.1 節で定義された、識別子名の受け入れ基準の最小の集合に従わなければなりません(MUST)。
4.A CPE dictionary MUST adhere to the identifier name deprecation process defined in Section 6.2.
4.CPE 辞書は、6.2 節で定義された識別子名の非推奨化プロセスに従わなければなりません(MUST)。
5.A CPE dictionary MUST capture the identifier name provenance data defined in Section 6.3.
5.CPE 辞書は、6.3 節で定義された識別子名の来歴データを記録しなければなりません(MUST)。
The following subsections provide additional requirements specific to each dictionary type.
以下の小節では、各辞書の種類に固有の追加要件を示します。
4.2.1 Official CPE Dictionary
4.2.1 公式 CPE 辞書
Additional requirements for the Official CPE Dictionary are:
公式 CPE 辞書の追加要件は次のとおりです。
1.The Official CPE Dictionary SHOULD NOT further restrict the acceptance criteria defined in Section 6.1 because doing so would require all extended CPE dictionaries to implement the same restrictions.
1.公式 CPE 辞書は、6.1 節で定義された受け入れ基準をさらに制限すべきではありません(SHOULD NOT)。そうすると、すべての拡張 CPE 辞書が同じ制限を実装しなければならなくなるためです。
2.The Official CPE Dictionary MUST house its own set of management documents as specified in Section 6.4.
2.公式 CPE 辞書は、6.4 節で規定された独自の管理文書一式を保持しなければなりません(MUST)。
4.2.2 Extended CPE Dictionaries
4.2.2 拡張 CPE 辞書
Additional requirements for extended CPE dictionaries are:
拡張 CPE 辞書の追加要件は次のとおりです。
1.Organizations MAY use extended CPE dictionaries to store identifier names for proprietary products.
1.組織は、独自の製品の識別子名を格納するために、拡張 CPE 辞書を使用してもよいです(MAY)。
2.Organizations MAY use extended CPE dictionaries to store identifier names not yet found in the Official CPE Dictionary, but these organizations SHOULD submit these new identifier names to the Official CPE Dictionary as official identifier names.
2.組織は、公式 CPE 辞書にまだない識別子名を格納するために、拡張 CPE 辞書を使用してもよいです(MAY)。ただし、これらの組織は、これらの新しい識別子名を、公式の識別子名として公式 CPE 辞書に提出すべきです(SHOULD)。
3.An extended CPE dictionary SHOULD house its own set of management documents as specified in Section 6.4. If a dictionary does not have its own documents, the dictionary creator or maintainer SHOULD reference the Official CPE Dictionary Management Documents as applicable to the extended dictionary.
3.拡張 CPE 辞書は、6.4 節で規定された独自の管理文書一式を保持すべきです(SHOULD)。辞書が独自の文書を持たない場合、辞書の作成者または保守者は、拡張辞書に該当する範囲で、公式 CPE 辞書の管理文書を参照すべきです(SHOULD)。
4.An extended CPE dictionary MUST adhere to all acceptance criteria restrictions implemented in the Official CPE Dictionary. An extended CPE dictionary MAY further restrict the Official CPE Dictionary acceptance criteria, but MUST not conflict with them.
4.拡張 CPE 辞書は、公式 CPE 辞書に実装されたすべての受け入れ基準の制限に従わなければなりません(MUST)。拡張 CPE 辞書は、公式 CPE 辞書の受け入れ基準をさらに制限してもよいです(MAY)が、それらと矛盾してはなりません(MUST not)。
5.An extended CPE dictionary SHOULD NOT contain identifier names that conflict with the Official CPE Dictionary. If an extended dictionary does contain conflicting names, the extended dictionary’s maintainers SHOULD try to resolve the conflict with the Official Dictionary.
5.拡張 CPE 辞書は、公式 CPE 辞書と矛盾する識別子名を含むべきではありません(SHOULD NOT)。拡張辞書が矛盾する名前を実際に含む場合、拡張辞書の保守者は、公式辞書との矛盾の解消を試みるべきです(SHOULD)。
6.An extended CPE dictionary MUST NOT include any names that are not unique with respect to itself or to the Official CPE Dictionary. Section 6.1.3 defines CPE name uniqueness.
6.拡張 CPE 辞書は、それ自身や公式 CPE 辞書に対して一意でない名前を含めてはなりません(MUST NOT)。CPE 名の一意性は 6.1.3 節で定義されています。
5. CPE Dictionary Data Model
5. CPE 辞書データモデル
This section defines the data model that all CPE dictionaries MUST implement. The data model does not prescribe a specific binding or implementation; it merely describes the data that is required to support the technical use cases. Any CPE dictionary binding MUST implement all data model elements and properties defined in this section. Additionally, any CPE dictionary binding MAY extend this data model, but extensions MUST only occur at the valid extension points defined in Section 5.7.
この節では、すべての CPE 辞書が実装しなければならない(MUST)データモデルを定義します。このデータモデルは、特定の束縛や実装を規定するものではなく、技術的なユースケースを支えるために必要なデータを記述するだけです。CPE 辞書の束縛は、この節で定義されたすべてのデータモデルの要素とプロパティを実装しなければなりません(MUST)。さらに、CPE 辞書の束縛は、このデータモデルを拡張してもよいです(MAY)が、拡張は、5.7 節で定義された有効な拡張ポイントでのみ行わなければなりません(MUST)。
A CPE dictionary is a collection of identifier names and metadata associated with these identifiers. To support this, the CPE Dictionary data model revolves around one core element called cpe-item that holds all the information relating to a single identifier name. The cpe-item element has evolved out of the CPE Dictionary 2.2 XML Schema to support backwards compatibility. The cpe-item element contains a cpe23-item element that captures all CPE 2.3 specific data, including provenance data and an upgraded deprecation system.
CPE 辞書は、識別子名と、それらの識別子に関連付けられたメタデータの集合です。これを支えるために、CPE Dictionary データモデルは、単一の識別子名に関するすべての情報を保持する、cpe-item と呼ばれる 1 つの中核要素を中心に構成されています。cpe-item 要素は、後方互換性を支えるために、CPE Dictionary 2.2 XML スキーマから発展したものです。cpe-item 要素は、来歴データやアップグレードされた非推奨化の仕組みを含む、CPE 2.3 固有のすべてのデータを記録する cpe23-item 要素を含みます。
This data model makes special accommodations to ensure that existing version 2.2 CPE dictionaries are forward compatible with the CPE Dictionary 2.3 XML schemas. Also, any XML schema based bindings generated from this data model can produce instance data that validates against the CPE Dictionary 2.2 XML schema, if the cpe23-item element is used as the “any” element in the CPE Dictionary 2.2 XML schema and the title element is always specified for each cpe-item element. To support this, the CPE dictionary’s XML specification is split into two schemas: the main schema corresponds to the CPE Dictionary 2.2 XML schema (with the exception of making the title element optional instead of mandatory), and the schema extension contains the CPE Dictionary 2.3 specific elements and attributes.
このデータモデルは、既存のバージョン 2.2 の CPE 辞書が、CPE Dictionary 2.3 XML スキーマと将来互換になるように、特別な配慮をしています。また、このデータモデルから生成される XML スキーマベースの束縛は、cpe23-item 要素を CPE Dictionary 2.2 XML スキーマの “any” 要素として使い、各 cpe-item 要素に title 要素を常に指定すれば、CPE Dictionary 2.2 XML スキーマに対して検証されるインスタンスデータを生成できます。これを支えるため、CPE 辞書の XML 仕様は 2 つのスキーマに分割されています。メインスキーマは CPE Dictionary 2.2 XML スキーマに対応し(ただし、title 要素を必須ではなく任意にしている点を除く)、スキーマ拡張は CPE Dictionary 2.3 固有の要素と属性を含みます。
The tables below define the elements of the data model and their properties. Several of the elements allow organizations to supply additional information that is not covered by these properties. However, such information is not part of the official CPE Dictionary data model, and there are no requirements for dictionary users to access or process this information.
以下の表は、データモデルの要素とそのプロパティを定義します。いくつかの要素では、組織が、これらのプロパティではカバーされていない追加情報を提供できます。ただし、そのような情報は公式の CPE Dictionary データモデルの一部ではなく、辞書の利用者がこの情報にアクセスしたり処理したりする要件はありません。
In the tables below, types prefixed with “cpe_dict:” are from the CPE Dictionary 2.3 XML schema, “cpe_dict_ext:” prefixes indicate types from the CPE Dictionary 2.3 XML schema extension, and “cpe-name” prefixes indicate types from the CPE Naming 2.3 XML schema. These schemas, which are the authoritative XML binding definitions, can be found at http://scap.nist.gov/schema/cpe/2.3/cpe-dictionary_2.3.xsd, http://scap.nist.gov/schema/cpe/2.3/cpe-dictionary-extension_2.3.xsd, and http://scap.nist.gov/schema/cpe/2.3/cpe-naming_2.3.xsd, respectively.
以下の表では、“cpe_dict:” が付いた型は CPE Dictionary 2.3 XML スキーマのもの、“cpe_dict_ext:” の接頭辞は CPE Dictionary 2.3 XML スキーマ拡張の型、“cpe-name” の接頭辞は CPE Naming 2.3 XML スキーマの型を示します。権威ある XML 束縛の定義であるこれらのスキーマは、それぞれ http://scap.nist.gov/schema/cpe/2.3/cpe-dictionary_2.3.xsd、http://scap.nist.gov/schema/cpe/2.3/cpe-dictionary-extension_2.3.xsd、http://scap.nist.gov/schema/cpe/2.3/cpe-naming_2.3.xsd にあります。
5.1 The <cpe_dict:cpe-list> Element
5.1 <cpe_dict:cpe-list> 要素
The <cpe_dict:cpe-list> element contains all of the dictionary entries and dictionary metadata. The table below describes the <cpe_dict:cpe-list> element’s properties.
<cpe_dict:cpe-list> 要素は、辞書のすべてのエントリと辞書のメタデータを含みます。以下の表は、<cpe_dict:cpe-list> 要素のプロパティを説明します。
| Property | Type | Count | Description |
|---|---|---|---|
| generator (element) | cpe_dict:GeneratorType | 0-1 | Information related to the generation of the document, including the dictionary schema version, the time of the dictionary’s generation, and the name and version of the application used to generate it. |
| cpe-item (element) | cpe_dict:ItemType | 1-n | A container for a single dictionary entry (identifier name) and its metadata. |
| xsd:any | 0-n | Additional elements that are not part of the CPE namespace. These MAY contain additional information that a user MAY choose to use or not, but this information is not required to be used or understood. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| generator(要素) | cpe_dict:GeneratorType | 0-1 | 辞書のスキーマバージョン、辞書の生成時刻、生成に使用したアプリケーションの名前とバージョンなど、文書の生成に関する情報です。 |
| cpe-item(要素) | cpe_dict:ItemType | 1-n | 単一の辞書エントリ(識別子名)とそのメタデータのコンテナーです。 |
| xsd:any | 0-n | CPE 名前空間に含まれない追加の要素です。これらには、利用者が使用するかどうかを選択してもよい(MAY)追加情報が含まれてもよいです(MAY)が、この情報は、使用または理解することが求められません。 |
The rest of Section 5 provides additional information on the <cpe_dict:generator> and <cpe_dict:cpe-item> elements.
5 節の残りでは、<cpe_dict:generator> 要素と <cpe_dict:cpe-item> 要素についての追加情報を示します。
5.2 The <cpe_dict:generator> Element
5.2 <cpe_dict:generator> 要素
The <cpe_dict:generator> element contains information about the generation of the dictionary file. The properties of the <cpe_dict:generator> element are listed below.
<cpe_dict:generator> 要素は、辞書ファイルの生成に関する情報を含みます。<cpe_dict:generator> 要素のプロパティを以下に挙げます。
| Property | Type | Count | Description |
|---|---|---|---|
| product_name (element) | xsd:string | 0-1 | The name of the application used to generate the file. |
| product_version (element) | xsd:string | 0-1 | The version of the application used to generate the file. |
| schema_version (element) | xsd:decimal | 1 | The version of the schema that the document was written in and that should be used for validation. |
| timestamp (element) | xsd:dateTime | 1 | When the file was generated. |
| xsd:any | 0-n | Additional elements that are not part of the CPE namespace. These MAY contain additional information that a user MAY choose to use or not, but this information is not required to be used or understood. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| product_name(要素) | xsd:string | 0-1 | ファイルの生成に使用したアプリケーションの名前です。 |
| product_version(要素) | xsd:string | 0-1 | ファイルの生成に使用したアプリケーションのバージョンです。 |
| schema_version(要素) | xsd:decimal | 1 | 文書が書かれたスキーマのバージョンで、検証に使用すべきものです。 |
| timestamp(要素) | xsd:dateTime | 1 | ファイルが生成された日時です。 |
| xsd:any | 0-n | CPE 名前空間に含まれない追加の要素です。これらには、利用者が使用するかどうかを選択してもよい(MAY)追加情報が含まれてもよいです(MAY)が、この情報は、使用または理解することが求められません。 |
5.3 The <cpe_dict:cpe-item> Element
5.3 <cpe_dict:cpe-item> 要素
The <cpe_dict:cpe-item> element contains all of the information for a single dictionary entry (identifier name), including metadata. The properties of the <cpe_dict:cpe-item> element are defined below.
<cpe_dict:cpe-item> 要素は、メタデータを含む、単一の辞書エントリ(識別子名)のすべての情報を含みます。<cpe_dict:cpe-item> 要素のプロパティを以下に定義します。
| Property | Type | Count | Description |
|---|---|---|---|
| name (attribute) | cpe-name:cpe22Type | 1 | The identifier name bound in CPE 2.2 format. |
| deprecated (attribute) | xsd:boolean | 0-1 | Whether or not the name has been deprecated. Default value is false. |
| deprecated_by (attribute) | cpe-name:cpe22Type | 0-1 | The name that deprecated this name, bound in CPE 2.2 format. |
| deprecation_date (attribute) | xsd:dateTime | 0-1 | When the name was deprecated. |
| title (element) | cpe_dict:TextType | 0-n | Human-readable title of the name. To support uses intended for multiple languages, the <cpe_dict:title> element supports the @xml:lang attribute. At most one <cpe_dict:title> element MAY appear for each language. |
| notes (element) | cpe_dict:NotesType | 0-n | Optional descriptive material. To support uses intended for multiple languages, the <cpe_dict:notes> element supports the @xml:lang attribute. At most one <cpe_dict:notes> element MAY appear for each language. |
| references (element) | cpe_dict:ReferencesType | 0-1 | External references to additional descriptive material. Each reference consists of a piece of text (intended to be human-readable) and a URI (intended to be a URL pointing to a real resource). |
| check (element) | cpe_dict:CheckType | 0-n | Calls out a check, such as an OVAL definition, that can confirm or reject an IT system as an instance of the named platform. Includes a REQUIRED check system specification URI (e.g., the URI for a particular version of OVAL), a REQUIRED check identifier, and an OPTIONAL external file reference (for example, a pointer to the file where the check is defined). |
| cpe23-item (element) | cpe_dict_ext:itemType | 1 | Element that captures all CPE 2.3 specific data including the CPE 2.3 formatted string binding of the name, provenance data, and deprecation data. |
| xsd:any | 0-n | Additional elements that are not part of the CPE namespace. These MAY contain additional information that a user MAY choose to use or not, but this information is not required to be used or understood. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| name(属性) | cpe-name:cpe22Type | 1 | CPE 2.2 形式に束縛された識別子名です。 |
| deprecated(属性) | xsd:boolean | 0-1 | 名前が非推奨になっているかどうかです。既定値は false です。 |
| deprecated_by(属性) | cpe-name:cpe22Type | 0-1 | この名前を非推奨にした名前で、CPE 2.2 形式に束縛されています。 |
| deprecation_date(属性) | xsd:dateTime | 0-1 | 名前が非推奨になった日時です。 |
| title(要素) | cpe_dict:TextType | 0-n | 名前の人間が読めるタイトルです。複数言語を対象とする用途を支えるため、<cpe_dict:title> 要素は @xml:lang 属性をサポートします。<cpe_dict:title> 要素は、言語ごとに最大 1 つまで現れてもよいです(MAY)。 |
| notes(要素) | cpe_dict:NotesType | 0-n | 任意の説明資料です。複数言語を対象とする用途を支えるため、<cpe_dict:notes> 要素は @xml:lang 属性をサポートします。<cpe_dict:notes> 要素は、言語ごとに最大 1 つまで現れてもよいです(MAY)。 |
| references(要素) | cpe_dict:ReferencesType | 0-1 | 追加の説明資料への外部参照です。各参照は、(人間が読めることを意図した)テキストと、(実在する資源を指す URL であることを意図した)URI で構成されます。 |
| check(要素) | cpe_dict:CheckType | 0-n | IT システムが、名前付きのプラットフォームのインスタンスであることを確認または否定できる、OVAL 定義などのチェックを指定します。必須(REQUIRED)のチェックシステム仕様 URI(例: 特定のバージョンの OVAL の URI)、必須(REQUIRED)のチェック識別子、および任意(OPTIONAL)の外部ファイル参照(例: チェックが定義されているファイルへのポインター)を含みます。 |
| cpe23-item(要素) | cpe_dict_ext:itemType | 1 | 名前の CPE 2.3 の書式付き文字列の束縛、来歴データ、非推奨化のデータなど、CPE 2.3 固有のすべてのデータを記録する要素です。 |
| xsd:any | 0-n | CPE 名前空間に含まれない追加の要素です。これらには、利用者が使用するかどうかを選択してもよい(MAY)追加情報が含まれてもよいです(MAY)が、この情報は、使用または理解することが求められません。 |
5.4 The <cpe_dict_ext:cpe23-item> Element
5.4 <cpe_dict_ext:cpe23-item> 要素
The <cpe_dict_ext:cpe23-item> element contains all CPE 2.3 specific data related to a given identifier name.
<cpe_dict_ext:cpe23-item> 要素は、特定の識別子名に関連する CPE 2.3 固有のすべてのデータを含みます。
| Property | Type | Count | Description |
|---|---|---|---|
| name (attribute) | cpe_dict_ext:namePattern | 1 | The identifier name bound to a formatted string [CPE23-N:6.2]. |
| provenance-record (element) | cpe | 0-1 | Container for all provenance information for the given identifier name. |
| deprecation (element) | cpe | 0-n | Element holding one or more deprecation entries for the given identifier name. It is possible for a single identifier name to have multiple deprecations that occur at different time periods. |
| xsd:any | 0-n | Additional elements that are not part of the CPE namespace. These MAY contain additional information that a user MAY choose to use or not, but this information is not required to be used or understood. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| name(属性) | cpe_dict_ext:namePattern | 1 | 書式付き文字列に束縛された識別子名です [CPE23-N:6.2]。 |
| provenance-record(要素) | cpe | 0-1 | 特定の識別子名のすべての来歴情報のコンテナーです。 |
| deprecation(要素) | cpe | 0-n | 特定の識別子名の 1 つ以上の非推奨化エントリを保持する要素です。1 つの識別子名が、異なる時期に起こる複数の非推奨化を持つ場合があります。 |
| xsd:any | 0-n | CPE 名前空間に含まれない追加の要素です。これらには、利用者が使用するかどうかを選択してもよい(MAY)追加情報が含まれてもよいです(MAY)が、この情報は、使用または理解することが求められません。 |
5.5 The <cpe_dict_ext:provenance-record> Element
5.5 <cpe_dict_ext:provenance-record> 要素
The <cpe_dict_ext:provenance-record> element contains the provenance information for the given identifier name.
<cpe_dict_ext:provenance-record> 要素は、特定の識別子名の来歴情報を含みます。
| Property | Type | Count | Description |
|---|---|---|---|
| submitter (element) | cpe | 1 | The organization responsible for submitting the identifier name. |
| authority (element) | cpe | 1-n | The authority or authorities responsible for endorsing the identifier name. Multiple authorities may endorse the same identifier name. |
| change-description (element) | cpe | 1-n | A description of any changes made to the identifier name or associated metadata. |
| xsd:any | 0-n | Additional elements that are not part of the CPE namespace. These MAY contain additional information that a user MAY choose to use or not, but this information is not required to be used or understood. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| submitter(要素) | cpe | 1 | 識別子名の提出に責任を持つ組織です。 |
| authority(要素) | cpe | 1-n | 識別子名の承認に責任を持つ機関です。複数の機関が同じ識別子名を承認する場合があります。 |
| change-description(要素) | cpe | 1-n | 識別子名または関連するメタデータに加えられた変更の説明です。 |
| xsd:any | 0-n | CPE 名前空間に含まれない追加の要素です。これらには、利用者が使用するかどうかを選択してもよい(MAY)追加情報が含まれてもよいです(MAY)が、この情報は、使用または理解することが求められません。 |
The <cpe_dict_ext:submitter> and <cpe_dict_ext:authority> elements have the same structure:
<cpe_dict_ext:submitter> 要素と <cpe_dict_ext:authority> 要素は、同じ構造を持ちます。
| Property | Type | Count | Description |
|---|---|---|---|
| system-id (attribute) | xsd:anyURI | 1 | Unique URI representing the organization. |
| name (attribute) | xsd:token | 1 | Human readable name of the organization. |
| date (attribute) | xsd:dateTime | 1 | The date the organization performed an action relative to an identifier name. For example, the date the organization submitted or endorsed a particular identifier name. |
| description (element) | xsd:token | 0-1 | A high-level description of the organization acting as the submitter or authority. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| system-id(属性) | xsd:anyURI | 1 | 組織を表す一意の URI です。 |
| name(属性) | xsd:token | 1 | 組織の人間が読める名前です。 |
| date(属性) | xsd:dateTime | 1 | 組織が識別子名に関して行動を行った日付です。たとえば、組織が特定の識別子名を提出した、または承認した日付です。 |
| description(要素) | xsd:token | 0-1 | 提出者または機関として行動する組織の高水準の説明です。 |
The <cpe_dict_ext:change-description> element has the following structure:
<cpe_dict_ext:change-description> 要素は、次の構造を持ちます:
| Property | Type | Count | Description |
|---|---|---|---|
| change-type (attribute) | cpe | 1 | The type of change that occurred. The possible values are listed below the table. |
| date (attribute) | xsd:dateTime | 0-1 | When the change occurred. |
| evidence-reference (element) | cpe | 0-1 | Supporting evidence for any change to a name or associated metadata, including a link to external information relating to the change. |
| comments (element) | xsd:token | 0-1 | Comments explaining the rationale for the change. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| change-type(属性) | cpe | 1 | 発生した変更の種類です。取り得る値は、表の下に挙げます。 |
| date(属性) | xsd:dateTime | 0-1 | 変更が発生した日時です。 |
| evidence-reference(要素) | cpe | 0-1 | 名前または関連するメタデータへの変更を裏付ける証拠で、変更に関する外部情報へのリンクを含みます。 |
| comments(要素) | xsd:token | 0-1 | 変更の根拠を説明するコメントです。 |
The possible values for the @change-type attribute are:
@change-type 属性の取り得る値は次のとおりです。
•ORIGINAL_RECORD: Used when the name is first added to the dictionary.
•ORIGINAL_RECORD: 名前が最初に辞書へ追加されたときに使用されます。
•AUTHORITY_CHANGE: Used when the authority behind the name is modified.
•AUTHORITY_CHANGE: 名前の背後にある機関が変更されたときに使用されます。
•DEPRECATION: Used when the name is first deprecated.
•DEPRECATION: 名前が最初に非推奨になったときに使用されます。
•DEPRECATION_MODIFICATION: Used when additional deprecation entries are recorded for a deprecated name.
•DEPRECATION_MODIFICATION: 非推奨になった名前に、追加の非推奨化エントリが記録されたときに使用されます。
The <cpe_dict_ext:evidence-reference> element contains a URI, which references a specific piece of evidence, and an @evidence attribute, which has one of the following possible values:
<cpe_dict_ext:evidence-reference> 要素は、特定の証拠を参照する URI と、次の取り得る値のいずれかを持つ @evidence 属性を含みます:
•CURATOR_UPDATE: The curator of the dictionary discovered information that led to a change.
•CURATOR_UPDATE: 辞書のキュレーターが、変更につながる情報を発見した場合です。
•VENDOR_FIX: The vendor of the product identified in the name released or submitted information that led to a change.
•VENDOR_FIX: 名前で識別される製品のベンダーが、変更につながる情報を公開または提出した場合です。
•THIRD_PARTY_FIX: A third party released or submitted information that led to a change.
•THIRD_PARTY_FIX: 第三者が、変更につながる情報を公開または提出した場合です。
5.6 The <cpe_dict_ext:deprecation> Element
5.6 <cpe_dict_ext:deprecation> 要素
A <cpe_dict_ext:deprecation> element (from the <cpe_dict_ext:cpe23-item> element) contains the deprecation information for a specific deprecation of a given identifier name. If a name is deprecated multiple times, there would be a separate instance of the deprecation element for each deprecation.
<cpe_dict_ext:deprecation> 要素(<cpe_dict_ext:cpe23-item> 要素内のもの)は、特定の識別子名の特定の非推奨化に関する非推奨化情報を含みます。名前が複数回非推奨になる場合は、非推奨化ごとに、deprecation 要素の別々のインスタンスが存在することになります。
| Property | Type | Count | Description |
|---|---|---|---|
| date (attribute) | xsd:dateTime | 0-1 | When the deprecation occurred. |
| deprecated-by (element) | cpe | 1-n | The list of names that deprecated the identifier name. The names in the list do not have to be identifier names; they MAY contain wildcards and represent sets of products. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| date(属性) | xsd:dateTime | 0-1 | 非推奨化が行われた日時です。 |
| deprecated-by(要素) | cpe | 1-n | 識別子名を非推奨にした名前の一覧です。一覧の名前は識別子名である必要はなく、ワイルドカードを含み、製品の集合を表してもよいです(MAY)。 |
The deprecated-by element has the following structure:
deprecated-by 要素は、次の構造を持ちます:
| Property | Type | Count | Description |
|---|---|---|---|
| name (attribute) | cpe-name:cpe23Type | 0-1 | The name that is deprecating the identifier name. |
| type (attribute) | cpe | 1 | The type of deprecation. |
| プロパティ | 型 | 個数 | 説明 |
|---|---|---|---|
| name(属性) | cpe-name:cpe23Type | 0-1 | 識別子名を非推奨にしている名前です。 |
| type(属性) | cpe | 1 | 非推奨化の種類です。 |
The possible values for the type attribute are:
type 属性の取り得る値は次のとおりです。
•NAME_CORRECTION: Deprecation is of type Identifier Name Correction
•NAME_CORRECTION: 非推奨化の種類が、識別子名の訂正です
•NAME_REMOVAL: Deprecation is of type Identifier Name Removal
•NAME_REMOVAL: 非推奨化の種類が、識別子名の削除です
•ADDITIONAL_INFORMATION: Deprecation is of type Additional Information Discovery
•ADDITIONAL_INFORMATION: 非推奨化の種類が、追加情報の発見です
5.7 Extension Points
5.7 拡張ポイント
Organizations may need to capture data not defined in the CPE Dictionary data model. Any organization serving as a CPE dictionary creator or maintainer MAY extend the <cpe_dict_ext:cpe23-item>, <cpe_dict_ext:cpe-list>, and <cpe_dict_ext:provenance-record> elements to capture additional, organization specific data. If organizations extend these elements, this extension MUST only occur by adding additional properties to these elements to capture different types of data, or by restricting the values for specific properties. Organizations MUST NOT define rules conflicting with the properties already defined for these elements.
組織は、CPE Dictionary データモデルで定義されていないデータを記録する必要がある場合があります。CPE 辞書の作成者または保守者を務める組織は、追加の組織固有のデータを記録するために、<cpe_dict_ext:cpe23-item>、<cpe_dict_ext:cpe-list>、<cpe_dict_ext:provenance-record> の各要素を拡張してもよいです(MAY)。組織がこれらの要素を拡張する場合、この拡張は、異なる種類のデータを記録するためにこれらの要素に追加のプロパティを加えるか、特定のプロパティの値を制限することによってのみ行わなければなりません(MUST)。組織は、これらの要素についてすでに定義されているプロパティと矛盾する規則を定義してはなりません(MUST NOT)。
6. Dictionary Creation and Maintenance
6. 辞書の作成と保守
This section provides information and requirements related to creating and maintaining CPE dictionaries. It defines requirements for valid identifier names within dictionaries and explains the process to be followed when an identifier name needs to be replaced or removed from a dictionary. This section also briefly discusses requirements for capturing identifier name provenance data. Finally, this section explains CPE dictionary management documents and provides related requirements.
この節では、CPE 辞書の作成と保守に関する情報と要件を示します。辞書内で有効な識別子名の要件を定義し、識別子名を辞書から置き換えたり削除したりする必要が生じたときに従うべきプロセスを説明します。この節では、識別子名の来歴データを記録するための要件についても簡単に論じます。最後に、この節は、CPE 辞書の管理文書を説明し、関連する要件を示します。
6.1 Acceptance Criteria
6.1 受け入れ基準
A CPE dictionary holds a collection of identifier names that serve to identify classes of products. A dictionary maintainer MUST only permit valid identifier names in the dictionary.3 An identifier name is valid if it meets the acceptance criteria defined in the following sub-sections, which ensure a certain degree of interoperability across all CPE dictionaries. The criteria focus on ensuring that each identifier name within a CPE dictionary identifies a single product class. Dictionary maintainers MAY further restrict the acceptance criteria defined in this section, but MUST NOT relax the criteria. The maintainers of the Official CPE Dictionary SHOULD NOT further restrict the criteria since that would require all extended dictionaries to implement the same restrictions.
CPE 辞書は、製品クラスを識別するのに役立つ識別子名の集合を保持します。辞書の保守者は、辞書内に有効な識別子名のみを許可しなければなりません(MUST)。3識別子名は、以下の小節で定義される受け入れ基準を満たす場合に有効であり、この基準は、すべての CPE 辞書にわたる一定の相互運用性を確保します。この基準は、CPE 辞書内の各識別子名が単一の製品クラスを識別することを確保することに重点を置いています。辞書の保守者は、この節で定義された受け入れ基準をさらに制限してもよいです(MAY)が、基準を緩和してはなりません(MUST NOT)。公式 CPE 辞書の保守者は、基準をさらに制限すべきではありません(SHOULD NOT)。そうすると、すべての拡張辞書が同じ制限を実装しなければならなくなるためです。
6.1.1 Logical Values and Special Characters
6.1.1 論理値と特殊文字
The CPE Naming specification reserves a set of logical values and special characters for use within a CPE attribute value [CPE23-N:5.3]. The CPE Dictionary specification permits a subset of these to be contained within identifier names.
CPE Naming 仕様は、CPE 属性値内で使用するために、一連の論理値と特殊文字を予約しています [CPE23-N:5.3]。CPE Dictionary 仕様では、それらの一部を識別子名に含めることが許可されています。
6.1.1.1 NA Logical Value
6.1.1.1 論理値 NA
The NA value within a CPE attribute signifies that the attribute is Not Applicable. For example, a vendor may distribute the first release of a product that contains no update, but later releases an update to this first release in the form of a service pack. This example contains two distinct products, the first product that contains no update, and the second product that does contain an update. The identifier name created to represent the first release of the product should contain an update attribute with a value of NA (i.e., update=NA) since the update attribute is known to be not applicable to the product. The identifier name created to represent the second release of the product should contain an update attribute with a value of sp1 (i.e., update=“sp1”).
CPE 属性内の NA の値は、その属性が適用不可(Not Applicable)であることを示します。たとえば、ベンダーが、アップデートを含まない製品の最初のリリースを配布し、その後、この最初のリリースに対するアップデートをサービスパックの形でリリースする場合があります。この例には、アップデートを含まない最初の製品と、アップデートを含む 2 番目の製品という、2 つの別個の製品が含まれます。製品の最初のリリースを表すために作成される識別子名には、update 属性が製品に適用されないことがわかっているため、値 NA の update 属性(すなわち update=NA)を含めるべきです。製品の 2 番目のリリースを表すために作成される識別子名には、値 sp1 の update 属性(すなわち update=“sp1”)を含めるべきです。
Identifier names MUST NOT use the NA logical value as the part, vendor, or product attribute value, but MAY use the NA logical value for any other CPE attributes’ values to indicate that the attributes are not applicable.
識別子名は、part、vendor、product の属性値として論理値 NA を使用してはなりません(MUST NOT)が、ほかの CPE 属性の値には、その属性が適用不可であることを示すために論理値 NA を使用してもよいです(MAY)。
6.1.1.2 ANY Logical Value
6.1.1.2 論理値 ANY
The use of the ANY logical value for a CPE attribute value signifies that there was not enough information to populate the specific CPE attribute at the time of name creation. Identifier names MUST NOT use the ANY logical value as the part, vendor, product, or version attribute value, but MAY use the ANY logical value for any other CPE attributes’ values to indicate a lack of information.
CPE 属性値に論理値 ANY を使用することは、名前の作成時に、特定の CPE 属性を埋めるのに十分な情報がなかったことを示します。識別子名は、part、vendor、product、version の属性値として論理値 ANY を使用してはなりません(MUST NOT)が、ほかの CPE 属性の値には、情報の欠如を示すために論理値 ANY を使用してもよいです(MAY)。
accept-name.accept-name にあります。 It is common for the amount of information known about a product to grow over time. To support this, it is necessary to evolve the identifier name itself by creating a new, more specific identifier name and deprecating the old identifier name. Section 6.2 defines the formal deprecation process for tracking changes to identifier names within a dictionary.
製品について知られている情報の量が、時間とともに増えることはよくあります。これを支えるためには、より具体的な新しい識別子名を作成し、古い識別子名を非推奨にすることで、識別子名自体を進化させる必要があります。6.2 節では、辞書内の識別子名の変更を追跡するための正式な非推奨化プロセスを定義します。
6.1.1.3 Special Characters
6.1.1.3 特殊文字
The CPE Naming specification reserves a set of special characters for use within a CPE attribute value [CPE23-N:5.3.2]. The CPE Name Matching specification assigns specific meaning to a subset of these special characters: the asterisk, which is a multi-character wildcard, and the question mark, which is a single-character wildcard [CPE23-M:5]. This wildcard concept works well when creating expressions to represent sets of product classes, but not for attempting to identify a single product class. Therefore, identifier names MUST NOT contain any asterisk or question mark characters within attribute values unless those characters are quoted. However, CPE dictionaries MAY contain these values within names not serving as identifiers (e.g., within deprecation logic). CPE names containing these values are not valid identifier names.4
CPE Naming 仕様は、CPE 属性値内で使用するために、一連の特殊文字を予約しています [CPE23-N:5.3.2]。CPE Name Matching 仕様は、これらの特殊文字の部分集合に特定の意味を割り当てています。すなわち、アスタリスクは複数文字のワイルドカード、疑問符は 1 文字のワイルドカードです [CPE23-M:5]。このワイルドカードの概念は、製品クラスの集合を表す式を作成する際には有効ですが、単一の製品クラスを識別しようとする場合には有効ではありません。したがって、識別子名は、属性値内にアスタリスクや疑問符の文字を、それらがクォートされていない限り含んではなりません(MUST NOT)。ただし、CPE 辞書は、識別子として機能しない名前(たとえば非推奨化のロジック内)には、これらの値を含めてもよいです(MAY)。これらの値を含む CPE 名は、有効な識別子名ではありません。4
6.1.2 CPE Name Completeness
6.1.2 CPE 名の完全性
Each identifier name MUST contain known data (e.g., not the ANY logical value) for the part, vendor, product, and version attributes’ values. This ensures that each identifier name contains the minimum amount of data required to identify a unique product class. The ANY logical value does not increase the completeness of an identifier name; only known data can increase the identifier name completeness. Known data refers to any value that represents a distinct aspect of a product (e.g. “sp1”, “2.0”, “Microsoft”, “ios”). For attributes other than the part, vendor, and product attributes, known data includes the NA logical value since it represents the known fact that no data exists for a specific CPE attribute.
各識別子名は、part、vendor、product、version の属性値について、既知のデータ(たとえば論理値 ANY ではないもの)を含まなければなりません(MUST)。これにより、各識別子名が、一意の製品クラスを識別するのに必要な最小限のデータを含むことが確保されます。論理値 ANY は識別子名の完全性を高めません。識別子名の完全性を高められるのは、既知のデータだけです。既知のデータとは、製品の別個の側面を表す任意の値(例: “sp1”、“2.0”、“Microsoft”、“ios”)をいいます。part、vendor、product 以外の属性については、既知のデータには、特定の CPE 属性についてデータが存在しないという既知の事実を表すため、論理値 NA が含まれます。
6.1.3 CPE Name Uniqueness
6.1.3 CPE 名の一意性
Every identifier name MUST be unique in the sense that it MUST NOT encompass a more complete identifier name within the dictionary. In terms of the set relations and algorithms in the CPE Name Matching specification [CPE23-M:6], this means that the identifier name SHALL NOT be a SUPERSET of any identifier name within the dictionary unless the two names are the same (EQUAL).5 Before adding a new identifier name to a dictionary, the dictionary maintainer MUST use CPE name matching to determine CPE uniqueness. If the dictionary is an extended dictionary, both the extended dictionary and the Official CPE Dictionary MUST be checked.
すべての識別子名は、辞書内のより完全な識別子名を包含してはならない(MUST NOT)という意味で、一意でなければなりません(MUST)。CPE Name Matching 仕様 [CPE23-M:6] の集合関係とアルゴリズムの観点では、これは、識別子名が、辞書内のいかなる識別子名の SUPERSET にもなってはならない(SHALL NOT)ことを意味します。ただし、2 つの名前が同じ(EQUAL)である場合は除きます。5辞書の保守者は、辞書に新しい識別子名を追加する前に、CPE 名の照合を使って CPE の一意性を判定しなければなりません(MUST)。辞書が拡張辞書である場合は、拡張辞書と公式 CPE 辞書の両方を確認しなければなりません(MUST)。
The two scenarios that MUST be checked for are:
確認しなければならない(MUST)2 つのシナリオは次のとおりです。
1.New name too general (the new name is a SUPERSET of the old name, but the new name is not EQUAL to the old name). The creator of a new name may not have had the full set of information required to populate all of its attributes with known data. CPE dictionaries support this situation, but they MUST NOT include such a name if a more complete version of that name exists in the dictionary.
1.新しい名前が一般的すぎる場合(新しい名前が古い名前の SUPERSET ですが、新しい名前が古い名前と EQUAL ではない)。新しい名前の作成者は、すべての属性を既知のデータで埋めるのに必要な完全な情報を持っていなかった可能性があります。CPE 辞書はこの状況に対応していますが、辞書内により完全な版の名前が存在する場合、そのような名前を含めてはなりません(MUST NOT)。
2.Existing name too general (the new name is a SUBSET of the old name, but the new name is not EQUAL to the old name). The new name may include information that was not available when previous, more general names were created. For example, there may already be a similar identifier name in the dictionary that contains the ANY logical value for fields that have known data in the new name.6 In such a case the pre-existing name(s) SHALL be deprecated to the new, more specific name; the deprecation process defined in Section 6.2 SHALL be followed for performing this deprecation.
2.既存の名前が一般的すぎる場合(新しい名前が古い名前の SUBSET ですが、新しい名前が古い名前と EQUAL ではない)。新しい名前には、以前のより一般的な名前が作成された時点では利用できなかった情報が含まれている可能性があります。たとえば、新しい名前では既知のデータがあるフィールドについて、論理値 ANY を含む類似の識別子名が、辞書にすでに存在する場合があります。6そのような場合、既存の名前は、新しい、より具体的な名前を置き換え先として非推奨にされなければなりません(SHALL)。この非推奨化を行うには、6.2 節で定義された非推奨化プロセスに従わなければなりません(SHALL)。
contains-restricted-characters.contains-restricted-characters にあります。 To provide an example (focusing on the CPE update attribute), suppose that a CPE dictionary contains the following identifier name version of a CPE:
(CPE の update 属性に着目した)例を示すために、CPE 辞書に、CPE の次の識別子名のバージョンが含まれているとします。
wfn:[part="a",vendor="foo_company",product="bar",version="2\.3",
update="sp1",edition=ANY,language=ANY,sw_edition=ANY,target_sw=ANY,
target_hw=ANY,other=ANY]
The above CPE represents the hypothetical product Foo Company Bar 2.3 sp1. At some later point in time, a dictionary contributor submits the following identifier name version of a CPE for potential inclusion within the same dictionary:
上記の CPE は、架空の製品 Foo Company Bar 2.3 sp1 を表します。その後のある時点で、辞書の貢献者が、同じ辞書への収録候補として、CPE の次の識別子名のバージョンを提出します。
wfn:[part="a",vendor="foo_company",product="bar",version="2\.3",
update=ANY,edition=ANY,language=ANY,sw_edition=ANY,target_sw=ANY,
target_hw=ANY,other=ANY]
This new name represents the hypothetical product: Foo Company Bar 2.3. The difference with this new name is that “ANY” is the value for the update attribute. This means that the contributor of this name does not know the correct value of the update field at the time of submission. The acceptance criteria defined in this document does not permit this submission because an identifier name already exists that contains a known value for the update field of the product. The reason for this restriction is that the less-complete name does not represent any real-world product, but instead represents a set of existing identifier name within the dictionary. If the dictionary contributor discovers a new update of the product, then the contributor should submit an identifier name containing the new update value.
この新しい名前は、架空の製品 Foo Company Bar 2.3 を表します。この新しい名前の違いは、update 属性の値が “ANY” である点です。これは、この名前の貢献者が、提出時に update フィールドの正しい値を知らないことを意味します。本文書で定義された受け入れ基準は、この提出を許可しません。製品の update フィールドに既知の値を含む識別子名がすでに存在するためです。この制限の理由は、完全性の低い名前が実世界のどの製品も表さず、代わりに辞書内の既存の識別子名の集合を表すためです。辞書の貢献者が製品の新しいアップデートを発見した場合、貢献者は、新しい update の値を含む識別子名を提出すべきです。
This does not mean that an identifier name representing the product Foo Company Bar 2.3 with no update is not permitted (e.g., the first release of the product contained no update). The identifier name representing the product with no update would contain the NA logical value in the update attribute. The following CPE does meet the acceptance criteria since it represents a real-world product that is known to have no update (i.e., the initial release of Bar 2.3):
これは、アップデートのない製品 Foo Company Bar 2.3 を表す識別子名が許可されないという意味ではありません(例: 製品の最初のリリースにはアップデートが含まれていなかった場合)。アップデートのない製品を表す識別子名は、update 属性に論理値 NA を含みます。次の CPE は、アップデートがないことがわかっている実世界の製品(すなわち Bar 2.3 の最初のリリース)を表すため、受け入れ基準を満たします。
wfn:[part="a",vendor="foo_company",product="bar",version="2\.3",
update=NA,edition=ANY,language=ANY,sw_edition=ANY,target_sw=ANY,
target_hw=ANY,other=ANY]
6.2 CPE Dictionary Deprecation Process
6.2 CPE 辞書の非推奨化プロセス
All identifier names stored within a dictionary MUST be immutable because data relating to a product is captured in the identifier itself. An identifier name MUST NOT be modified because the loss of historical information will cause problems for anyone already using that identifier name. Any updates to the product data captured in the identifier name MUST occur through deprecation. For example, when a dictionary maintainer discovers more information about a product represented by an existing identifier in the dictionary, they MUST deprecate the legacy identifier name in favor of a new identifier name or new set of identifier names. A deprecated identifier name is no longer considered valid.
辞書に格納されたすべての識別子名は、製品に関するデータが識別子自体に記録されるため、不変でなければなりません(MUST)。識別子名を変更すると、すでにその識別子名を使っている人々にとって、過去の情報が失われることによる問題が生じるため、識別子名を変更してはなりません(MUST NOT)。識別子名に記録された製品データの更新は、非推奨化を通じて行わなければなりません(MUST)。たとえば、辞書の保守者は、辞書内の既存の識別子で表される製品についてより多くの情報を発見した場合、旧来の識別子名を、新しい識別子名または新しい識別子名の集合に置き換える形で非推奨にしなければなりません(MUST)。非推奨の識別子名は、もはや有効とはみなされません。
matches-more-complete-in-dictionary.matches-more-complete-in-dictionary にあります。 An important distinction exists between the set of names that deprecate an identifier name and the identifier name that a CPE dictionary user selects as a replacement of the deprecated name. The CPE dictionary may link a deprecated identifier name to a set of identifier names replacing it, but this is asserting that any identifier name within the set of new identifier names is a valid replacement for the deprecated identifier name. Using this information a CPE dictionary user may, depending on the use case, decide on the appropriate name to use as a replacement, or decide to use the entire set. For example, when resolving the deprecating entries for a deprecated name found within an applicability statement, an organization may find it useful to use the entire set to avoid false negatives.
識別子名を非推奨にする名前の集合と、CPE 辞書の利用者が非推奨の名前の置き換えとして選択する識別子名とのあいだには、重要な違いがあります。CPE 辞書は、非推奨の識別子名を、それを置き換える識別子名の集合にリンクする場合がありますが、これは、新しい識別子名の集合内のどの識別子名も、非推奨の識別子名の有効な置き換えであると主張するものです。この情報を使って、CPE 辞書の利用者は、ユースケースに応じて、置き換えとして使用する適切な名前を決めるか、集合全体を使用することを決めてもよいです。たとえば、適用可能性の記述の中に見つかった非推奨の名前について、非推奨化のエントリを解決するとき、組織は、偽陰性を避けるために集合全体を使用することが有用だと考える場合があります。
There are three types of identifier name deprecation:
識別子名の非推奨化には 3 つの種類があります。
•Identifier Name Correction – An error occurred during name creation. The error could range from a simple syntax error (e.g., typo, misspelling) to an incorrect product listing. For example, a dictionary maintainer may add a product to the dictionary, only to later discover that the product is only a component library of a larger product. In this case, the dictionary maintainer would deprecate the identifier name representing the component library to the identifier name representing the actual product containing the component. This type of deprecation is one-to-one, with the deprecated name pointing to the single identifier name that represents the correct product.
•識別子名の訂正(Identifier Name Correction) – 名前の作成中に誤りが発生した場合です。誤りは、単純な構文の誤り(例: 誤植、スペルミス)から、不正確な製品の掲載までさまざまです。たとえば、辞書の保守者が製品を辞書に追加したところ、後になって、その製品がより大きな製品の構成要素のライブラリにすぎないと発見する場合があります。この場合、辞書の保守者は、構成要素のライブラリを表す識別子名を、その構成要素を含む実際の製品を表す識別子名に非推奨化します。この種類の非推奨化は 1 対 1 であり、非推奨の名前は、正しい製品を表す単一の識別子名を指します。
•Identifier Name Removal – An identifier name exists in the dictionary that does not belong and has no replacement. This condition normally results from a case where the dictionary maintainer has added a name to the dictionary that should never have been included in the dictionary. In this case, the dictionary maintainer will deprecate the legacy name without pointing to a new name.
•識別子名の削除(Identifier Name Removal) – 辞書に、属すべきでなく、置き換えもない識別子名が存在する場合です。この状況は通常、辞書の保守者が、辞書に決して含まれるべきでなかった名前を辞書に追加した場合に生じます。この場合、辞書の保守者は、新しい名前を指すことなく、旧来の名前を非推奨にします。
•Additional Information Discovery – The dictionary maintainer adds one or more identifier names to the dictionary that are more complete than an existing identifier name. In this case, the pre-existing name really represents a set of possible products that the maintainer did not know about when originally adding the name to the dictionary. This type of deprecation may be one-to-many since the dictionary maintainer will deprecate the pre-existing name to all of the names that are more complete. This deprecation relationship is largely informational; when making this deprecation, the dictionary maintainer is asserting that any identifier name within the set of new identifier names is a valid replacement for the deprecated name. It is up to the user to decide on which individual name to use, or to use the entire set.
•追加情報の発見(Additional Information Discovery) – 辞書の保守者が、既存の識別子名よりも完全な識別子名を、辞書に 1 つ以上追加する場合です。この場合、既存の名前は、実際には、保守者が辞書に最初にその名前を追加したときには知らなかった、考えられる製品の集合を表しています。この種類の非推奨化は、保守者が既存の名前を、より完全なすべての名前に非推奨化するため、1 対多になる場合があります。この非推奨化の関係は、主に情報提供的なものであり、この非推奨化を行う際、辞書の保守者は、新しい識別子名の集合内のどの識別子名も、非推奨の名前の有効な置き換えであると主張しています。どの個別の名前を使用するか、または集合全体を使用するかは、利用者が決めます。
When deprecating an identifier name, the dictionary maintainer MUST link the deprecated identifier name to all identifier names that are replacing it through the deprecated-by relationship as defined in Section 5.6. For example, if x is a single identifier name that is being deprecated and y is a set of identifier names that is deprecating x, then "x deprecated-by y" defines a deprecation relationship between x and y.
識別子名を非推奨にする際、辞書の保守者は、5.6 節で定義された deprecated-by の関係を通じて、非推奨の識別子名を、それを置き換えるすべての識別子名にリンクしなければなりません(MUST)。たとえば、x が非推奨になる単一の識別子名で、y が x を非推奨にする識別子名の集合である場合、"x deprecated-by y" は x と y の間の非推奨化の関係を定義します。
When a dictionary maintainer decides to deprecate an identifier name, the dictionary maintainer MUST follow the deprecation process below. This process refers to the identifier name being deprecated as the legacy name.
辞書の保守者が識別子名を非推奨にすると決めた場合、辞書の保守者は、以下の非推奨化プロセスに従わなければなりません(MUST)。このプロセスでは、非推奨になる識別子名を旧来の名前と呼びます。
1.If the dictionary maintainer is replacing the legacy name with one or more new identifier names, then the dictionary maintainer MUST add the new identifier names to the dictionary.
1.辞書の保守者が、旧来の名前を 1 つ以上の新しい識別子名に置き換える場合、辞書の保守者は、新しい識別子名を辞書に追加しなければなりません(MUST)。
2.The dictionary maintainer MUST add a deprecation element to the legacy name dictionary entry to signify that it is deprecated. If the legacy name was previously deprecated, then the dictionary maintainer MUST add a new deprecation element to record the new deprecation.7
2.辞書の保守者は、旧来の名前の辞書エントリに deprecation 要素を追加して、それが非推奨であることを示さなければなりません(MUST)。旧来の名前が以前に非推奨になっていた場合、辞書の保守者は、新しい非推奨化を記録するために、新しい deprecation 要素を追加しなければなりません(MUST)。7
3.The dictionary maintainer MUST expand the new deprecation element to include one or more deprecated-by elements to record the identifier name(s) replacing the legacy name. The dictionary maintainer MUST specify the type of deprecation within the type attribute of each deprecated-by element. Additionally:
3.辞書の保守者は、旧来の名前を置き換える識別子名を記録するために、新しい deprecation 要素を拡張して、1 つ以上の deprecated-by 要素を含めなければなりません(MUST)。辞書の保守者は、各 deprecated-by 要素の type 属性に、非推奨化の種類を指定しなければなりません(MUST)。加えて、次のとおりです。
a.If the dictionary maintainer is performing an Identifier Name Correction deprecation, then the dictionary maintainer MUST populate the name attribute of the deprecated-by element with the identifier name replacing the legacy name.
a.辞書の保守者が、識別子名の訂正による非推奨化を行う場合、辞書の保守者は、deprecated-by 要素の name 属性に、旧来の名前を置き換える識別子名を設定しなければなりません(MUST)。
b.If the dictionary maintainer is performing an Additional Information Discovery deprecation, then the dictionary maintainer MUST populate the name attribute of the deprecated-by element with a name representing the set of new identifier names that are replacing the legacy name. This name may contain wildcards (e.g., *, ?) to represent a set of identifier names.
b.辞書の保守者が、追加情報の発見による非推奨化を行う場合、辞書の保守者は、deprecated-by 要素の name 属性に、旧来の名前を置き換える新しい識別子名の集合を表す名前を設定しなければなりません(MUST)。この名前は、識別子名の集合を表すために、ワイルドカード(例: *、?)を含んでもよいです。
4.The dictionary maintainer MUST record the change in the legacy name’s provenance information.
4.辞書の保守者は、この変更を旧来の名前の来歴情報に記録しなければなりません(MUST)。
6.3 CPE Dictionary Provenance Data
6.3 CPE 辞書の来歴データ
CPE dictionary maintainers MUST capture the required provenance data specified in Section 5.5. The provenance data required includes data useful in understanding the reasoning behind changes made to identifier names stored within a CPE Dictionary. This provenance data also captures the organization responsible for identifier name submissions, as well as the authority behind the submissions.
CPE 辞書の保守者は、5.5 節で規定された必須の来歴データを記録しなければなりません(MUST)。必須の来歴データには、CPE 辞書に格納された識別子名に加えられた変更の理由を理解するのに役立つデータが含まれます。この来歴データは、識別子名の提出に責任を持つ組織と、その提出の背後にある機関も記録します。
6.4 CPE Dictionary Management Documents
6.4 CPE 辞書の管理文書
Every CPE dictionary has a set of supporting management documentation associated with it. This documentation improves the transparency relating to dictionary acceptance criteria, dictionary content creation decisions and processes associated with the dictionary. Each CPE dictionary creator or maintainer MUST create or reference a series of accompanying management documents capturing rules and processes specific to its dictionary. A single dictionary creator or maintainer MAY establish multiple extended CPE dictionaries. In these situations a single set of external CPE dictionary management documents MAY be referenced as the authoritative documents for each extended dictionary.
すべての CPE 辞書には、それに関連付けられた一連の支援的な管理文書があります。この文書は、辞書の受け入れ基準、辞書の内容の作成に関する決定、辞書に関連するプロセスについての透明性を高めます。各 CPE 辞書の作成者または保守者は、その辞書に固有の規則とプロセスを記録した、付随する一連の管理文書を作成または参照しなければなりません(MUST)。1 人の辞書の作成者または保守者が、複数の拡張 CPE 辞書を設けてもよいです(MAY)。このような場合、外部の CPE 辞書管理文書の 1 つの集合を、各拡張辞書の権威ある文書として参照してもよいです(MAY)。
This section defines each required CPE dictionary management document.
この節では、必須の各 CPE 辞書管理文書を定義します。
6.4.1 Dictionary Content Management and Decisions Document
6.4.1 辞書の内容管理と決定の文書
Dictionary maintainers MUST either create or reference a Dictionary Content Management and Decisions Document for each dictionary that they maintain. The document defines the procedures for identifier name creation within a particular dictionary or set of dictionaries. All procedures defined in the decisions document MUST NOT override or conflict with the requirements defined in this specification. The decisions document MUST capture the following information:
辞書の保守者は、保守する各辞書について、辞書の内容管理と決定の文書(Dictionary Content Management and Decisions Document)を作成または参照しなければなりません(MUST)。この文書は、特定の辞書または辞書の集合内での識別子名の作成の手順を定義します。決定の文書で定義されたすべての手順は、本仕様で定義された要件を上書きしたり、それと矛盾したりしてはなりません(MUST NOT)。決定の文書は、次の情報を記録しなければなりません(MUST)。
1.Rules relating to dictionary-specific acceptance criteria for identifier names.
1.識別子名についての、辞書固有の受け入れ基準に関する規則。
2.Identification strategies relating to different product types. Due to the heterogeneous nature of product versioning in the IT industry, multiple disparate strategies for versioning products exist. Where possible, the document should record the different identification strategies captured within the dictionary. For example, if a specific product line uses seven digits within its version syntax, then the document should record the semantics of each digit within this syntax.
2.製品の種類ごとの識別戦略。IT 業界における製品のバージョン付けは多様であるため、製品のバージョン付けには複数の異なる戦略が存在します。可能な場合、文書は、辞書に記録されたさまざまな識別戦略を記録すべきです。たとえば、特定の製品ラインがバージョン構文に 7 桁を使用する場合、文書は、この構文における各桁の意味を記録すべきです。
3.Automated identifier name creation strategies for specific products. These strategies may include the API calls or functions to call on certain products to populate specific attributes of an identifier name.
3.特定の製品に対する識別子名の自動作成の戦略。これらの戦略には、識別子名の特定の属性を埋めるために、特定の製品に対して呼び出す API 呼び出しや関数が含まれる場合があります。
4.Lists of valid values for specific CPE attributes where appropriate. Valid value lists either may be global or pertain to specific CPEs. For example, it is possible to have a granular valid value list for the version attribute of a specific vendor and product, without extending the scope of this valid values list to every CPE version attribute within the dictionary.
4.該当する場合、特定の CPE 属性に対する有効な値の一覧。有効な値の一覧は、全体に適用されるものでも、特定の CPE に関するものでもかまいません。たとえば、この有効な値の一覧の範囲を辞書内のすべての CPE の version 属性に広げることなく、特定のベンダーと製品の version 属性について、粒度の細かい有効な値の一覧を持つことが可能です。
5.Abbreviation rules for data within specific CPE attributes where appropriate. Abbreviation rules may either be global or pertain to specific CPEs.
5.該当する場合、特定の CPE 属性内のデータに対する略記規則。略記規則は、全体に適用されるものでも、特定の CPE に関するものでもかまいません。
6.Rules relating to any dictionary-specific provenance data that the dictionary records.
6.辞書が記録する、辞書固有の来歴データに関する規則。
6.4.2 Dictionary Process Management Document
6.4.2 辞書のプロセス管理の文書
Dictionary maintainers MUST either create or reference a Dictionary Process Management Document for each dictionary that they maintain. The document defines all processes associated with a particular dictionary or set of dictionaries. All processes defined in the document MUST NOT override or conflict with the requirements defined in this specification. The process management document MUST capture the following information:
辞書の保守者は、保守する各辞書について、辞書のプロセス管理の文書(Dictionary Process Management Document)を作成または参照しなければなりません(MUST)。この文書は、特定の辞書または辞書の集合に関連するすべてのプロセスを定義します。文書で定義されたすべてのプロセスは、本仕様で定義された要件を上書きしたり、それと矛盾したりしてはなりません(MUST NOT)。プロセス管理の文書は、次の情報を記録しなければなりません(MUST)。
1.The scope of the dictionary.
1.辞書の範囲。
2.The target audience of the dictionary.
2.辞書の対象読者。
3.The submission process that users must follow to submit new CPE identifiers for inclusion within the dictionary. At a minimum, this overview SHOULD include the submission format, the process for starting the submission process, and the workflow surrounding the submission process.
3.利用者が、辞書への収録のために新しい CPE 識別子を提出する際に従わなければならない提出プロセス。この概要には、少なくとも、提出の形式、提出プロセスを開始するためのプロセス、提出プロセスをめぐるワークフローを含めるべきです(SHOULD)。
4.The content decisions process that the community follows to create the content decision rules that are captured in the Dictionary Content Management and Decisions Document.
4.コミュニティが、辞書の内容管理と決定の文書に記録される内容決定の規則を作成するために従う、内容決定のプロセス。
5.The CPE Identifier modification process followed by dictionary maintainers.
5.辞書の保守者が従う、CPE 識別子の変更プロセス。
6.The dictionary distribution process and methodology. At a minimum, this SHOULD define the binding in which the dictionary is distributed.
6.辞書の配布プロセスと方法論。少なくとも、辞書の配布形式を定義すべきです(SHOULD)。
7. Dictionary Use
7. 辞書の使用
This section defines two common ways of using a CPE Dictionary. The first involves looking up a single identifier name within a dictionary. The second involves using a name representing a set of products to search against the dictionary to determine which identifier names within the dictionary are members of that set. The two methods of searching are necessary to support the type of information a user is retrieving from a dictionary. In some cases, it is necessary to retrieve an exact match from the dictionary; for example, when resolving a deprecation chain based on “Identifier Name Correction” deprecation, it is necessary to resolve only the exact identifier name listed in the deprecation metadata. In other cases, it is necessary to search for an entire set of CPE names; for example, when resolving a deprecation chain based on “Additional Information Discovery” deprecation, it is necessary to resolve all identifier names captured in the deprecation metadata.
この節では、CPE 辞書を使用する 2 つの一般的な方法を定義します。1 つ目は、辞書内の単一の識別子名を検索(ルックアップ)する方法です。2 つ目は、製品の集合を表す名前を使って辞書を検索し、辞書内のどの識別子名がその集合に属するかを判定する方法です。この 2 つの検索方法は、利用者が辞書から取得する情報の種類を支えるために必要です。辞書から完全一致を取得する必要がある場合があります。たとえば、「識別子名の訂正」による非推奨化に基づく非推奨化の連鎖を解決する場合は、非推奨化メタデータに挙げられた識別子名だけを正確に解決する必要があります。それ以外の場合には、CPE 名の集合全体を検索する必要があります。たとえば、「追加情報の発見」による非推奨化に基づく非推奨化の連鎖を解決する場合は、非推奨化メタデータに記録されたすべての識別子名を解決する必要があります。
The section also explains how identifier names should be resolved from a deprecated name. All of these operations leverage the CPE name matching algorithms8 when performing the search operations.
この節では、非推奨の名前から識別子名をどのように解決すべきかも説明します。これらの操作はすべて、検索操作を実行する際に、CPE 名の照合アルゴリズム8を活用します。
7.1 Identifier Lookup
7.1 識別子の検索(ルックアップ)
Identifier lookup involves using the WFN corresponding to a single identifier name (i.e., the source identifier name) to iterate through each entry in a dictionary to see if that source identifier exists within the dictionary—if any identifier name in the dictionary is equal to the source identifier name. Equality means that the corresponding attribute values in the two identifier names are all equal. The CPE_EQUAL function defined in the CPE Name Matching specification [CPE23-M:7.2] presents a formal implementation of this equality test. The two possible outcomes of an identifier lookup are:
識別子の検索(ルックアップ)では、単一の識別子名(すなわちソース識別子名)に対応する WFN を使って、辞書内の各エントリを順に調べ、そのソース識別子が辞書内に存在するか、つまり辞書内のいずれかの識別子名がソース識別子名と等しいかを確認します。等しいとは、2 つの識別子名の対応する属性値がすべて等しいことを意味します。CPE Name Matching 仕様 [CPE23-M:7.2] で定義された CPE_EQUAL 関数は、この等価性の検査の正式な実装を示しています。識別子の検索で取り得る結果は 2 つあります。
•Match – The source identifier name matches an identifier name within the dictionary. The operation returns the status “EXACT-MATCH” and the WFN of the dictionary identifier name that matched. Note that since each name within the dictionary MUST be unique, at most only one identifier name could match the source identifier name.
•一致(Match) – ソース識別子名が、辞書内の識別子名と一致します。この操作は、ステータス “EXACT-MATCH” と、一致した辞書の識別子名の WFN を返します。辞書内の各名前は一意でなければならない(MUST)ため、ソース識別子名と一致し得る識別子名は、多くても 1 つだけです。
•No Match – The source identifier name does not match any identifier name within the dictionary. The operation returns a null value.
•不一致(No Match) – ソース識別子名が、辞書内のどの識別子名とも一致しません。この操作は、null 値を返します。
Section 8.3 defines the formal implementation of this identifier lookup operation in pseudocode.
8.3 節では、この識別子の検索操作の正式な実装を擬似コードで定義します。
7.2 Dictionary Searching
7.2 辞書の検索
Dictionary searching involves using a source name representing a set of products to search against a dictionary to determine which identifier names within the dictionary are members of that set. A dictionary searching routine would iterate through each entry in the dictionary to identify all that are a member of the set represented by the source name. Possible outcomes of this searching operation are:
辞書の検索では、製品の集合を表すソース名を使って辞書を検索し、辞書内のどの識別子名がその集合に属するかを判定します。辞書の検索ルーチンは、辞書内の各エントリを順に調べ、ソース名が表す集合に属するものをすべて特定します。この検索操作で取り得る結果は次のとおりです。
•Superset Match – One or more identifier names from the dictionary belong to the set represented by the source name. In set theory language, the set represented by the source name is a superset of the matched identifier names from the dictionary. The operation returns “SUPERSET-MATCH” and the set of matching dictionary identifier names expressed as WFNs.
•上位集合の一致(Superset Match) – 辞書の 1 つ以上の識別子名が、ソース名が表す集合に属します。集合論の言葉でいえば、ソース名が表す集合は、辞書内の一致した識別子名の上位集合です。この操作は、“SUPERSET-MATCH” と、WFN として表現された、一致した辞書の識別子名の集合を返します。
•Subset Match – The set represented by the source name is a possible subset of one or more identifier names within the dictionary. This will only occur if the source name is more specific than one or more names within the dictionary. Generally this result should be treated as an error; the searcher may want to notify the dictionary maintainer that a name in the wild is more specific than one or more identifier names within the dictionary. The operation returns “SUBSET-MATCH” and the set of matching dictionary identifier names expressed as WFNs.
•部分集合の一致(Subset Match) – ソース名が表す集合が、辞書内の 1 つ以上の識別子名の部分集合である可能性があります。これは、ソース名が、辞書内の 1 つ以上の名前よりも具体的である場合にのみ起こります。一般に、この結果は誤りとして扱うべきです。検索者は、実環境の名前が、辞書内の 1 つ以上の識別子名よりも具体的であることを、辞書の保守者に通知したいと考えるかもしれません。この操作は、“SUBSET-MATCH” と、WFN として表現された、一致した辞書の識別子名の集合を返します。
•No Match – There is no relationship between the set represented by the source name and the identifier names within the dictionary. The source name is disjoint with the dictionary. When no match is found, the operation returns a null value.
•不一致(No Match) – ソース名が表す集合と、辞書内の識別子名とのあいだに関係はありません。ソース名は辞書と互いに素です。一致するものが見つからない場合、この操作は null 値を返します。
Section 8.3 defines the formal implementation of this dictionary search operation in pseudocode. This pseudocode leverages the CPE_SUPERSET and CPE_SUBSET functions defined in the CPE Name Matching specification [CPE23-M:7.2] to implement the search operation.
8.3 節では、この辞書の検索操作の正式な実装を擬似コードで定義します。この擬似コードは、検索操作を実装するために、CPE Name Matching 仕様 [CPE23-M:7.2] で定義された CPE_SUPERSET 関数と CPE_SUBSET 関数を活用します。
7.3 Use of Deprecated Identifier Names
7.3 非推奨の識別子名の使用
The concept of deprecated identifier names is explained in Section 6.2. CPE dictionary users MUST NOT use a deprecated identifier name, but MUST instead use an identifier name that is linked to the deprecated identifier name through the deprecated-by relationship.9 It is important to understand that even though a set of names may deprecate one identifier name, an organization does not have to use all of these new names. The organization MAY simply pick a non-deprecated name out of the set, or the organization MAY choose to use the entire set.
非推奨の識別子名の概念は、6.2 節で説明しています。CPE 辞書の利用者は、非推奨の識別子名を使用してはならず(MUST NOT)、代わりに、deprecated-by の関係を通じて非推奨の識別子名にリンクされた識別子名を使用しなければなりません(MUST)。9名前の集合が 1 つの識別子名を非推奨にする場合でも、組織は、これらの新しい名前をすべて使用する必要はありません。組織は、その集合から非推奨でない名前を 1 つ選んでもよいです(MAY)し、集合全体を使用してもよいです(MAY)。
When a product consumes or outputs an identifier name, that product MUST first determine if the identifier name is deprecated in the Official CPE Dictionary. If the identifier name is not present in the Official CPE Dictionary, then the product MUST determine if the identifier name is deprecated in an extended CPE dictionary to which it has access. If the identifier name is deprecated, the product MUST resolve the correct non-deprecated identifier names for use in place of the deprecated identifier name. The product MUST use the following process, which references the dictionary-search function defined in Section 8.3, to perform this resolution.
製品が識別子名を取り込む、または出力する際、その製品は、まず、その識別子名が公式 CPE 辞書で非推奨かどうかを判定しなければなりません(MUST)。識別子名が公式 CPE 辞書に存在しない場合、製品は、アクセスできる拡張 CPE 辞書でその識別子名が非推奨かどうかを判定しなければなりません(MUST)。識別子名が非推奨の場合、製品は、非推奨の識別子名の代わりに使用する、非推奨でない正しい識別子名を解決しなければなりません(MUST)。製品は、この解決を行うために、8.3 節で定義された dictionary-search 関数を参照する次のプロセスを使用しなければなりません(MUST)。
1.If the deprecated identifier name does not reference any identifier names within the deprecated-by element, then the organization MUST choose a new non-deprecated identifier name from the dictionary. This situation will occur if the deprecation is of type “Identifier Name Removal”.
1.非推奨の識別子名が deprecated-by 要素内でどの識別子名も参照していない場合、組織は、辞書から非推奨でない新しい識別子名を選ばなければなりません(MUST)。この状況は、非推奨化の種類が「識別子名の削除」である場合に生じます。
2.If the deprecated identifier name provides an identifier name within the deprecated-by element, and:
2.非推奨の識別子名が deprecated-by 要素内に識別子名を示しており、かつ、次の条件に該当する場合:
a.If the deprecation type is “Identifier Name Correction”, then the organization MUST resolve the dictionary entry containing the identifier name listed. The organization MUST resolve this identifier name using the dictionary-search function, passing the identifier name, the dictionary, and a value of true as the parameters to the function; these arguments will result in an identifier lookup operation.
a.非推奨化の種類が「識別子名の訂正」の場合、組織は、挙げられた識別子名を含む辞書エントリを解決しなければなりません(MUST)。組織は、dictionary-search 関数を使ってこの識別子名を解決しなければならず(MUST)、その際、識別子名、辞書、値 true を関数のパラメーターとして渡します。これらの引数により、識別子の検索操作が行われます。
b.If the deprecation type is “Additional Information Discovery” then the organization MUST resolve the set of dictionary entries containing the identifier names. The organization MUST resolve this set of identifier names using the dictionary-search function, passing the set of identifier names, the dictionary, and a value of false as the parameters to the function; these arguments will result in a dictionary search operation.
b.非推奨化の種類が「追加情報の発見」の場合、組織は、識別子名を含む辞書エントリの集合を解決しなければなりません(MUST)。組織は、dictionary-search 関数を使ってこの識別子名の集合を解決しなければならず(MUST)、その際、識別子名の集合、辞書、値 false を関数のパラメーターとして渡します。これらの引数により、辞書の検索操作が行われます。
3.If there are multiple deprecation elements or a single deprecation element with multiple deprecated-by elements, then the organization MUST iterate through step 2 for all deprecated-by elements provided. The organization MUST take the union of all resolved sets of identifier names; this union is the correct set of identifier names that have replaced the legacy name.
3.複数の deprecation 要素がある場合、または 1 つの deprecation 要素に複数の deprecated-by 要素がある場合、組織は、提供されたすべての deprecated-by 要素について、手順 2 を繰り返さなければなりません(MUST)。組織は、解決されたすべての識別子名の集合の和集合をとらなければなりません(MUST)。この和集合が、旧来の名前に置き換わった識別子名の正しい集合です。
4.The organization MAY encounter deprecated identifier names in the set of identifier names resolved in Step 2. In this case, the organization MUST follow the above process to replace these deprecated names with the set of names that deprecated it; this process may be recursive.
4.組織は、手順 2 で解決された識別子名の集合の中に非推奨の識別子名を見つける場合があります(MAY)。この場合、組織は、上記のプロセスに従って、これらの非推奨の名前を、それらを非推奨にした名前の集合に置き換えなければなりません(MUST)。このプロセスは再帰的になる場合があります。
5.The final set of resolved names represents all names that replace the legacy name. Organizations MAY either use all of these names, or pick one name out of the set to use in place of the legacy name.
5.解決された名前の最終的な集合は、旧来の名前に置き換わるすべての名前を表します。組織は、これらの名前をすべて使用することも、旧来の名前の代わりに使用する名前を集合から 1 つ選ぶこともできます(MAY)。
8. CPE Dictionary Operations and Pseudocode
8. CPE 辞書の操作と擬似コード
This section specifies functions for basic CPE dictionary operations and provides pseudocode for the identifier name acceptance criteria and the dictionary searching operations.
この節では、CPE 辞書の基本的な操作のための関数を規定し、識別子名の受け入れ基準と辞書の検索操作の擬似コードを示します。
8.1 Operations on a CPE Dictionary
8.1 CPE 辞書に対する操作
This section defines a set of functions for performing common activities against a CPE Dictionary. These functions are relatively simple and do not require a pseudocode implementation, but the remaining sub-sections present pseudocode that may utilize these common functions.
この節では、CPE 辞書に対して一般的な作業を行うための一連の関数を定義します。これらの関数は比較的単純で、擬似コードによる実装を必要としませんが、残りの小節では、これらの共通の関数を利用する場合がある擬似コードを示します。
8.1.1 Function get_cpe_items(d)
8.1.1 関数 get_cpe_items(d)
The get_cpe_items(d) function takes a single CPE Dictionary, d, and returns all cpe-items associated with it. A single cpe-item within the dictionary represents the identifier name and all associated metadata.
get_cpe_items(d) 関数は、単一の CPE 辞書 d を受け取り、それに関連付けられたすべての cpe-items を返します。辞書内の単一の cpe-item は、識別子名と、関連するすべてのメタデータを表します。
8.1.2 Function get_cpe_item_WFN(item)
8.1.2 関数 get_cpe_item_WFN(item)
The get_cpe_item_WFN(item)function takes a single cpe-item element and returns the identifier WFN that it represents. Because the dictionary holds bound representations of names, it is necessary to unbind one of those to obtain a WFN. The formatted string binding should be used if available, and it can be unbound using the unbind_fs(fs) function defined in the CPE Naming Specification [CPE23-N:6.2.3].
get_cpe_item_WFN(item) 関数は、単一の cpe-item 要素を受け取り、それが表す識別子 WFN を返します。辞書は名前の束縛された表現を保持しているため、WFN を得るには、そのうちの 1 つの束縛を解除する必要があります。利用可能であれば、書式付き文字列の束縛を使用すべきで、これは CPE Naming 仕様 [CPE23-N:6.2.3] で定義された unbind_fs(fs) 関数を使って束縛を解除できます。
8.1.3 Function get(w,a)
8.1.3 関数 get(w,a)
The get(w,a) function takes two arguments, a WFN w and an attribute a, and returns the value of a. If the attribute a is unspecified in w, the function returns the default value ANY. This function is defined in the CPE Naming Specification [CPE23-N:5.4.2].
get(w,a) 関数は、WFN w と属性 a の 2 つの引数を受け取り、a の値を返します。属性 a が w で指定されていない場合、関数は既定値 ANY を返します。この関数は、CPE Naming 仕様 [CPE23-N:5.4.2] で定義されています。
8.1.4 Function is_deprecated(item)
8.1.4 関数 is_deprecated(item)
The is_deprecated(item) function takes a single cpe-item and returns true if the cpe-item is deprecated, false if the cpe-item is not deprecated.
is_deprecated(item) 関数は、単一の cpe-item を受け取り、cpe-item が非推奨の場合は true、cpe-item が非推奨でない場合は false を返します。
8.1.5 Function getItem(list, index)
8.1.5 関数 getItem(list, index)
The getItem(list, index)function is a helper function for retrieving an item in a list. The function will return the list item at the position specified by index. This function assumes a 0-based index and will return null if no items exist at the provided index.
getItem(list, index) 関数は、リスト内の項目を取得するための補助関数です。この関数は、index で指定された位置にあるリストの項目を返します。この関数は 0 始まりのインデックスを仮定し、指定されたインデックスに項目が存在しない場合は null を返します。
8.1.6 Function strlen(s)
8.1.6 関数 strlen(s)
The strlen(s)function returns the length of string s. If the string is empty, it returns zero. It is defined as in GNU C.
strlen(s) 関数は、文字列 s の長さを返します。文字列が空の場合は、0 を返します。これは GNU C と同様に定義されています。
8.1.7 Function substr(s,b,e)
8.1.7 関数 substr(s,b,e)
The substr(s,b,e)function returns a substring of string s, beginning with the character at location b (with zero being the first character) and ending with the character at location e. If b equals e, it returns the character at location b. b must be less than or equal to e. If b is equal to or greater than strlen(s), it returns nil.
substr(s,b,e) 関数は、位置 b の文字(0 が最初の文字)から始まり、位置 e の文字で終わる、文字列 s の部分文字列を返します。b が e と等しい場合は、位置 b の文字を返します。b は e 以下でなければなりません。b が strlen(s) 以上の場合は、nil を返します。
8.2 Acceptance Criteria Pseudocode
8.2 受け入れ基準の擬似コード
This section defines the algorithm required to implement the acceptance criteria defined in Section 6.1. The core algorithm is implemented in the below pseudocode function named accept-name, which processes a given formatted string binding, fs, converts it to its WFN representation, w, and compares the WFN against a specific dictionary to determine if the dictionary should accept the new name. The following list provides a brief summary of the algorithm implemented in the accept-name function:
この節では、6.1 節で定義された受け入れ基準を実装するために必要なアルゴリズムを定義します。中核となるアルゴリズムは、以下の accept-name という名前の擬似コードの関数で実装されます。この関数は、指定された書式付き文字列の束縛 fs を処理して WFN 表現 w に変換し、その WFN を特定の辞書と比較して、辞書がその新しい名前を受け入れるべきかどうかを判定します。次の一覧は、accept-name 関数で実装されるアルゴリズムの簡単な要約です。
1.Unbind the formatted string fs to its WFN representation w because all the other functions within accept-name require a WFN as input. See the unbind_fs function in the CPE Naming Specification [CPE23-N:6.2.3].
1.書式付き文字列 fs の束縛を解除して WFN 表現 w にします。accept-name 内のほかのすべての関数は入力として WFN を必要とするためです。CPE Naming 仕様 [CPE23-N:6.2.3] の unbind_fs 関数を参照してください。
2.Use the helper function contains-restricted-characters to determine if the WFN w contains any of the restricted characters defined in Section 6.1.1.3. If w contains any of the restricted characters, accept-name will return false.
2.補助関数 contains-restricted-characters を使って、WFN w が、6.1.1.3 節で定義された制限文字のいずれかを含むかどうかを判定します。w が制限文字のいずれかを含む場合、accept-name は false を返します。
3.Use the helper function contains-required-attributes to determine if the WFN w contains known data for all of the required attributes specified in Section 6.1.2. If w does not contain all of the required attributes, accept-name will return false.
3.補助関数 contains-required-attributes を使って、WFN w が、6.1.2 節で規定された必須属性のすべてについて既知のデータを含むかどうかを判定します。w が必須属性のすべてを含まない場合、accept-name は false を返します。
4.Use the helper function matches-more-complete-in-dictionary to determine if the WFN w is unique within the dictionary d, as specified in Section 6.1.3. If w does not adhere to this rule, or in other words if w matches against a more complete name in the given dictionary d, then accept-name will return false. This function uses the dictionary-search function defined in Section 8.3 for matching against the dictionary.
4.補助関数 matches-more-complete-in-dictionary を使って、WFN w が、6.1.3 節で規定されたとおり、辞書 d 内で一意かどうかを判定します。w がこの規則に従わない場合、言い換えると、w が指定された辞書 d 内のより完全な名前と一致する場合、accept-name は false を返します。この関数は、辞書との照合に、8.3 節で定義された dictionary-search 関数を使用します。
1 function accept-name(fs, d)
2 ;; Top-level function to determine if the formatted string fs
3 ;; should be accepted into dictionary d based on high-level
4 ;; acceptance criteria. Assumes that the fs and its WFN
5 ;; representation meet acceptance criteria defined in the
6 ;; CPE Naming Spec.
7 w := unbind_fs(fs).
8 if contains-restricted-characters(w)
9 then return false.
10 endif.
11 if !contains-required-attributes(w)
12 then return false.
13 endif.
14 if matches-more-complete-in-dictionary(w, d)
15 then return false.
16 endif.
17 return true.
18 end.
Figure 8-1: accept-name function
図 8-1: accept-name 関数
1 function contains-restricted-characters(w)
2 ;; Helper-function to determine if WFN w contains characters
3 ;; not permitted in dictionary.
4 ;; loop through every attribute in WFN
5 foreach a in {part,vendor,product,version,update,edition,language,
6 sw_edition,target_sw,target_hw,other} do
7 s := get(w,a). ;; get value of attribute
8 if (s = ANY or s = NA)
9 ;; the attribute value is a logical
10 then continue. ; to next attribute
11 endif.
12 ;; If we get here, s is a string value.
13 n := 0.
14 loop
15 if n >= strlen(s)
16 then break. ;; break to outer loop
17 endif.
18 c := substr(s,n,n). ;; get the n’th character of s.
19 if (c = "*" or c = "?")
20 then
21 if ((n = 0) or (substr(s,n-1,n-1) != "\"))
22 then return true. ;; unquoted '*' or '?' not permitted
23 endif.
24 else
25 ;; character is legal, move on
26 n := n + 1.
27 continue.
28 endif.
29 endloop.
30 endfor.
31 return false.
32 end.
Figure 8-2: contains-restricted-characters function
図 8-2: contains-restricted-characters 関数
1 function contains-required-attributes(w)
2 ;; Helper-function to determine if required attributes contain
3 ;; known data. WFN syntax defined in CPE Naming Spec ensures all
4 ;; attributes contain at least some data.
5 foreach a in {part, vendor, product, version} do
6 s := get(w,a). ;; get string value of attribute
7 ;; only loop through required attributes of w
8 if s = ANY
9 then return false.
10 endif.
11 if (a != version and s = NA)
12 then return false. ;; NA only permitted in version
13 endif.
14 endfor.
15 return true.
16 end.
Figure 8-3: contains-required-attributes function
図 8-3: contains-required-attributes 関数
1 function matches-more-complete-in-dictionary(w, d)
2 ;; Helper-function to determine if identifier WFN w matches a
3 ;; more complete name in the dictionary d (i.e. a superset match).
4 matches := dictionary-search(w, d, false).
5 if (size(matches) > 0)
6 then
7 if (getItem(matches, 0) = "SUPERSET-MATCH")
8 then return false. ;; at least one superset match was found
9 endif.
10 endif.
11 return true. ;; no match, or subset match are both okay.
12 end.
Figure 8-4: matches-more-complete-in-dictionary function
図 8-4: matches-more-complete-in-dictionary 関数
8.3 Dictionary Use Pseudocode
8.3 辞書の使用の擬似コード
This section contains pseudocode that implements the identifier lookup and dictionary search operations defined in Section 7 with the dictionary-search function.10 This function is focused on returning all non-deprecated names within a dictionary, but will not filter out deprecated names from the result set, allowing the caller to filter the names based on use case. While this function will not filter out deprecated names, it does not guarantee that it will return all matching deprecated names in the result set; it only guarantees the return of all matching non-deprecated names. When not looking for exact matches, the function will look for all superset matches within the given dictionary. The function will only look for subset matches if the given dictionary contains no superset matches. This ordering derives from the CPE Dictionary acceptance criteria that will not allow a dictionary to contain non-deprecated subset matches if a superset match is present.11
この節には、7 節で定義された識別子の検索操作と辞書の検索操作を、dictionary-search 関数で実装する擬似コードが含まれています。10この関数は、辞書内の非推奨でない名前をすべて返すことに重点を置いていますが、結果の集合から非推奨の名前を除外しないため、呼び出し元はユースケースに基づいて名前を絞り込めます。この関数は非推奨の名前を除外しませんが、一致する非推奨の名前をすべて結果の集合に含めて返すことは保証せず、一致する非推奨でない名前をすべて返すことだけを保証します。完全一致を探していない場合、関数は指定された辞書内で、与えられた名前の上位集合に当たる一致をすべて探します。関数は、指定された辞書に上位集合に当たる一致がない場合にのみ、部分集合に当たる一致を探します。この順序はCPE Dictionaryの受け入れ基準に由来しており、上位集合に当たる一致が存在する場合、辞書に非推奨でない部分集合の一致が含まれることは認められません。11
Table 8-1 provides a detailed overview of the dictionary-search function. This pseudocode leverages the accessor functions defined in Section 8.1. The code also leverages the CPE_EQUAL, CPE_SUBSET, and CPE_SUPERSET functions defined in the CPE Name Matching specification [CPE23-M:7.2].
表 8-1 は、dictionary-search 関数の詳細な概要を示します。この擬似コードは、8.1 節で定義されたアクセサー関数を活用します。コードは、CPE Name Matching 仕様 [CPE23-M:7.2] で定義された CPE_EQUAL、CPE_SUBSET、CPE_SUPERSET の各関数も活用します。
dictionary-search function was designed for readability; more efficient methods for implementing this logic exist.dictionary-search 関数は、読みやすさを重視して設計されています。このロジックを実装するより効率的な方法が存在します。 Table 8-1: Description of dictionary-search function
表 8-1: dictionary-search 関数の説明
| Line Numbers | Description |
|---|---|
| 1 | The function accepts three arguments, the source WFN, the dictionary to search against, and a boolean flag 'exact'. When 'exact' is true the function will perform an identifier lookup based on the source WFN. When 'exact' is false the function will perform dictionary searching for all names contained the source WFN set. |
| 11 | Creates a list to store all discovered matches as well as the match type; if a match is found, then the first position of this list will contain the match type and the second position will contain the matches (either single match, or set of matches). |
| 12 -13 | If 'exact' is true, the function will enter into logic to determine if an exact match is present within d. The function will then call the findExactMatch function (defined in Figure 8-8) to determine if an exact match exists in the dictionary. |
| 14-20 | If an exact match is found, the function will populate the 'response' list with the response type of 'EXACT-MATCH' and then append the exact match to the next position in the list. The function will then return the response list, or null if no match was found. |
| 22 | The function will call the findSupersetMatches function (defined in Figure 8-6) to build the set of all superset matches found in d. |
| 23-28 | If any superset matches are found, the function will populate the 'response' list with the response type of 'SUPERSET-MATCH' and then append the set of matches to the next position in the list. The function will then return the response list. |
| 29 | The function will call the findSubsetMatches function (defined in Figure 8-7) to build the set of all subset matches found in d. NOTE: No non-deprecated subset matches should be present if a superset match was found. |
| 30-35 | If any subset matches are found, the function will populate the 'response' list with the response type of 'SUBSET-MATCH' and then append the set of matches to the next position in the list. The function will then return the response list. |
| 36 | If no matches were found the function will return null. |
| 行番号 | 説明 |
|---|---|
| 1 | 関数は、ソース WFN、検索対象の辞書、ブール値フラグ 'exact' の3つの引数を受け取ります。'exact' が true の場合、関数はソース WFN に基づいて識別子を検索します。'exact' が false の場合、関数はソース WFN が表す集合に含まれるすべての名前を辞書内で検索します。 |
| 11 | 見つかったすべての一致と一致の種類を格納するリストを作成します。一致が見つかった場合、このリストの1番目の位置に一致の種類が、2番目の位置に一致(単一の一致または一致の集合のいずれか)が格納されます。 |
| 12 -13 | 'exact' が true の場合、関数はd内に完全一致が存在するかどうかを判定するロジックに入ります。続いて関数は、辞書に完全一致が存在するかどうかを判定するため、findExactMatch関数(図8-8で定義)を呼び出します。 |
| 14-20 | 完全一致が見つかった場合、関数は'response'リストに応答の種類'EXACT-MATCH'を設定し、リストの次の位置に完全一致を追加します。その後、関数は応答リストを返します。一致が見つからなかった場合はnullを返します。 |
| 22 | 関数は、d内で見つかった上位集合の一致をすべて構築するため、findSupersetMatches関数(図8-6で定義)を呼び出します。 |
| 23-28 | 上位集合の一致が見つかった場合、関数は'response'リストに応答の種類'SUPERSET-MATCH'を設定し、リストの次の位置に一致の集合を追加します。その後、関数は応答リストを返します。 |
| 29 | 関数は、d内で見つかった部分集合の一致をすべて構築するため、findSubsetMatches関数(図8-7で定義)を呼び出します。注: 上位集合の一致が見つかった場合、非推奨でない部分集合の一致は存在しないはずです。 |
| 30-35 | 部分集合の一致が見つかった場合、関数は'response'リストに応答の種類'SUBSET-MATCH'を設定し、リストの次の位置に一致の集合を追加します。その後、関数は応答リストを返します。 |
| 36 | 一致が見つからなかった場合、関数はnullを返します。 |
1 function dictionary-search(source, d, exact)
2 ;; For a given source WFN, source, the function will determine
3 ;; how it relates to the given dictionary, d. If the source WFN
4 ;; is a superset match to one or more identifier WFNs in d, then
5 ;; the function will return that set of names. If the source name
6 ;; is not a superset of any dictionary names, but is a subset of a
7 ;; dictionary name(s), then the function will return the set of
8 ;; dictionary names of which it is a subset. If an exact match is
9 ;; found and exact is true, the function will return the exact
10 ;; match. If no match exists the function will return null.
11 response := new List().
12 if (exact = true)
13 match := findExactMatch(source, d).
14 if (match != null)
15 then
16 response := append(response, "EXACT-MATCH").
17 response := append(response, match).
18 return response.
19 else return null.
20 endif.
21 endif.
22 supersetMatches := findSupersetMatches(source, d).
23 if (size(supersetMatches) > 0)
24 then ;;superset matches found
25 response := append(response, "SUPERSET-MATCH").
26 response := append(response, supersetMatches).
27 return response.
28 endif.
29 subsetMatches := findSubsetMatches(source, d).
30 if (size(subsetMatches) > 0)
31 then ;; subset matches found
32 response := append(response, "SUBSET-MATCH").
33 response := append(response, subsetMatches).
34 return response.
35 endif.
36 return null.
37 end
Figure 8-5: dictionary-search function
図 8-5: dictionary-search 関数
Table 8-2: Description of findSupersetMatches function
表 8-2: findSupersetMatches 関数の説明
| Line Numbers | Description |
|---|---|
| 4 | Creates a set to store all discovered superset matches. |
| 5 | Starts looping over every cpe-item in given dictionary, d. |
| 7 | Retrieves the WFN represented by the current item from the dictionary. |
| 8-12 | Passes the source and dictionary WFN to the CPE_SUPERSET and CPE_EQUAL functions (defined in the CPE Name Matching specification [CPE23-M:7.2] to determine how the two names relate. If the source is a 'superset' of the dictionary name, but not equal to the dictionary name, then the function will append the item to the set of matches. |
| 14 | The function will return the set of matches. |
| 行番号 | 説明 |
|---|---|
| 4 | 見つかったすべての上位集合の一致を格納する集合を作成します。 |
| 5 | 指定された辞書 d 内のすべての cpe-item についてのループを開始します。 |
| 7 | 辞書から、現在の項目が表す WFN を取得します。 |
| 8-12 | ソースと辞書の WFN を CPE_SUPERSET 関数と CPE_EQUAL 関数(CPE Name Matching 仕様 [CPE23-M:7.2] で定義)に渡して、2 つの名前がどう関係するかを判定します。ソースが辞書の名前の '上位集合' ですが、辞書の名前と等しくない場合、関数はその項目を一致の集合に追加します。 |
| 14 | 関数は一致の集合を返します。 |
1 function findSupersetMatches(source, d)
2 ;; For a given source WFN, source, the function will find all
3 ;; superset matches contained within the given CPE dictionary, d.
4 matches := new Set().
5 foreach item in get_cpe_items(d)
6 do
7 dictionaryName := get_cpe_item_WFN(item). ;;WFN from cpe-item
8 if ((CPE_SUPERSET(source, dictionaryName) = true) and
9 (CPE_EQUAL(source, dictionaryName) = false))
10 then
11 matches := append(matches, item).
12 endif.
13 endfor.
14 return matches.
15 end
Figure 8-6: findSupersetMatches function
図 8-6: findSupersetMatches 関数
Table 8-3: Description of findSubsetMatches function
表 8-3: findSubsetMatches 関数の説明
| Line Numbers | Description |
|---|---|
| 4 | Creates a set to store all discovered subset matches. |
| 5 | Starts looping over every cpe-item in given dictionary, d. |
| 7 | Retrieves the WFN represented by the current item from the dictionary. |
| 8-12 | Passes the source and dictionary WFN to the CPE_SUBSET and CPE_EQUAL functions (defined in the CPE Name Matching specification [CPE23-M:7.2] to determine how the two names relate. If the source is a 'subset' of the dictionary name, but not equal to the dictionary name, then the function will append the item to the set of matches. |
| 14 | The function will return the set of matches |
| 行番号 | 説明 |
|---|---|
| 4 | 見つかったすべての部分集合の一致を格納する集合を作成します。 |
| 5 | 指定された辞書 d 内のすべての cpe-item についてのループを開始します。 |
| 7 | 辞書から、現在の項目が表す WFN を取得します。 |
| 8-12 | ソースと辞書の WFN を CPE_SUBSET 関数と CPE_EQUAL 関数(CPE Name Matching 仕様 [CPE23-M:7.2] で定義)に渡して、2 つの名前がどう関係するかを判定します。ソースが辞書の名前の '部分集合' ですが、辞書の名前と等しくない場合、関数はその項目を一致の集合に追加します。 |
| 14 | 関数は一致の集合を返します |
1 function findSubsetMatches(source, d)
2 ;; For a given source WFN, source, the function will find all
3 ;; subset matches contained within the given CPE dictionary, d.
4 matches := new Set().
5 foreach item in get_cpe_items(d)
6 do
7 dictionaryName := get_cpe_item_WFN(item). ;;WFN from cpe-item
8 if ((CPE_SUBSET(source, dictionaryName) = true) and
9 (CPE_EQUAL(source, dictionaryName) = false))
10 then
11 matches := append(matches, item).
12 endif.
13 endfor.
14 return matches.
15 end
Figure 8-7: findSubsetMatches function
図 8-7: findSubsetMatches 関数
Table 8-4: Description of findExactMatch function
表 8-4: findExactMatch 関数の説明
| Line Numbers | Description |
|---|---|
| 4 | Starts looping over every cpe-item in given dictionary, d. |
| 6 | Retrieves the WFN represented by the current item from the dictionary. |
| 7-10 | Passes the source and dictionary WFN to the CPE_EQUAL function (defined in the CPE Name Matching specification [CPE23-M:7.2] to determine how the two names relate. If the two names are equal then the function will return the item as the exact match. |
| 12 | If not exact matches were found the function will return null. |
| 行番号 | 説明 |
|---|---|
| 4 | 指定された辞書 d 内のすべての cpe-item についてのループを開始します。 |
| 6 | 辞書から、現在の項目が表す WFN を取得します。 |
| 7-10 | ソースと辞書の WFN を CPE_EQUAL 関数(CPE Name Matching 仕様 [CPE23-M:7.2] で定義)に渡して、2 つの名前がどう関係するかを判定します。2 つの名前が等しい場合、関数はその項目を完全一致として返します。 |
| 12 | 完全一致が見つからなかった場合、関数は null を返します。 |
1 function findExactMatch(source, d)
2 ;; For a given source WFN, source, the function will find the
3 ;; exact match contained within the given CPE dictionary, d.
4 foreach item in get_cpe_items(d)
5 do
6 dictionaryName := get_cpe_item_WFN(item). ;;WFN from cpe-item
7 if (CPE_EQUAL(source, dictionaryName) = true)
8 then
9 return item.
10 endif.
11 endfor.
12 return null.
13 end
Figure 8-8: findExactMatch function
図 8-8: findExactMatch 関数
Appendix A—References
付録 A—参考文献
The following documents are indispensable references for understanding the application of this specification.
以下の文書は、本仕様の適用を理解するために不可欠な参考文献です。
Normative References
規範的な参考文献
[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. および 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-M] Parmelee, M., Booth, H., Waltermire, D., and Scarfone, K., NIST Interagency Report 7696, Common Platform Enumeration: Name Matching Specification Version 2.3, August 2011. See http://csrc.nist.gov/publications/PubsNISTIRs.html.
[CPE23-M] Parmelee, M., Booth, H., Waltermire, D., および Scarfone, K., NIST Interagency Report 7696, Common Platform Enumeration: Name Matching Specification Version 2.3, August 2011. 参照: 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. See http://csrc.nist.gov/publications/PubsNISTIRs.html.
[CPE23-N] Cheikes, B., Waltermire, D., および Scarfone, K., NIST Interagency Report 7695, Common Platform Enumeration: Naming Specification Version 2.3, August 2011. 参照: http://csrc.nist.gov/publications/PubsNISTIRs.html.
Informative References
参考情報の文献
[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., および 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, July 2011. See http://csrc.nist.gov/publications/PubsSPs.html#800-126.
[SP800-126] Waltermire, D., Quinn, S., Scarfone, K., および Halbardier, A., NIST Special Publication 800-126 Revision 2, The Technical Specification for the Security Content Automation Protocol (SCAP): SCAP Version 1.2, July 2011. 参照: http://csrc.nist.gov/publications/PubsSPs.html#800-126.
Appendix B—Change Log
付録 B—変更履歴
Release 0 – 9 June 2010
リリース 0 – 2010年6月9日
•Complete draft specification released to the CPE community for comment.
•CPE コミュニティにコメントを求めて公開された、完全なドラフト仕様。
Release 1 – 30 June 2010
リリース 1 – 2010年6月30日
•Minor edits to audience description.
•対象読者の記述の軽微な編集。
•Minor editorial changes throughout the document.
•文書全体の軽微な編集上の変更。
•Removed all mention of and support for the logical value UNKNOWN.
•論理値 UNKNOWN に関するすべての言及とサポートを削除。
•Updated Dictionary Searching section to remove the notion of an Error result, and clarify on superset versus subset matches.
•辞書の検索の節を更新し、エラー結果という考え方を削除して、上位集合の一致と部分集合の一致について明確化。
•Updated deprecation logic, and data model to include three distinct types of deprecation.
•非推奨化のロジックとデータモデルを更新し、データモデルに3つの異なる種類の非推奨化を含めました。
Release 2 – 2 June 2011
リリース 2 – 2011年6月2日
•Reorganized the sequence of several sections and sub-sections.
•いくつかの節と小節の順序を再編成。
•Minor editorial changes throughout the document.
•文書全体の軽微な編集上の変更。
•Reorganized the data model discuss to include all elements and attributes available in version 2.3.
•バージョン 2.3 で利用可能なすべての要素と属性を含めるように、データモデルの説明を再編成。
•Changed the overarching term “Dictionary Searching” to “Dictionary Use” to distinguish it from the lower-level term “dictionary searching”.
•包括的な用語「Dictionary Searching」を「Dictionary Use」に変更し、より低水準の用語「dictionary searching」と区別しました。
•Clarified what results are returned by identifier lookups and dictionary searching.
•識別子の検索と辞書の検索によって返される結果を明確化。
•Made several minor changes to the version 2.3 schema/data model, including making several elements and attributes optional and changing a few types.
•バージョン 2.3 のスキーマとデータモデルに、いくつかの軽微な変更を加えました。これには、いくつかの要素と属性を任意にすることと、いくつかの型を変更することが含まれます。
Release 3 – 30 August 2011
リリース 3 – 2011年8月30日
•Final release of CPE Dictionary 2.3 specification.
•CPE Dictionary 2.3 仕様の最終リリース。
•Made minor editorial changes.
•軽微な編集上の変更を加えました。
•Added prefix/namespace/schema mapping table to Section 1; updated prefixes for consistency with corresponding XML schemas.
•1 節に、接頭辞・名前空間・スキーマの対応表を追加。対応する XML スキーマと整合するように接頭辞を更新。
•Adjusted some Section 5 requirements to be normative instead of informative.
•5 節の一部の要件を、参考情報ではなく規範的なものに調整。