製品に十分な
製品に十分な技術文書またはエンジニアリング文書が含まれていない。
電子形式であるかを問わない。
製品の関連するソフトウェア/ハードウェア要素、たとえば次のようなものが含まれます。
使用方法、構造、アーキテクチャ・コンポーネント、インターフェイス、設計、実装、
構成、操作など。
技術文書が限られていたり不足していたりすると、製品の保守はより困難になる。 これは、脆弱性の発見や修正が難しくなったり、時間がかかったりすることで、間接的にセキュリティに影響する。
時間や労力に制限のある第三者/自社によるセキュリティコンサルティングサービス(脅威モデリング、脆弱性発見、ペンテストなど)を利用する場合、文書が不十分だと、コンサルタントは、その専門知識を欠陥の発見や効果的な緩和策の提案に集中させるのではなく、製品がどのように構成されているかを学ぶことに不必要な時間を投資せざるを得なくなる。
ハードウェア設計に関しては、正式な最終製造者リファレンスがないため、製造後の検証を含め、最終製品の評価が困難または不可能になる可能性があります。設計の機能や動作が許容範囲内にあり、仕様に適合し、予期せぬ動作がないことを保証することができない。ハードウェア関連文書には、ハードウェア記述言語(HDL)、ネットリスト、ガーバーファイル、部品表、EDA(Electronic Design Automation)ツールファイルなどのエンジニアリング成果物が含まれます。
The product does not contain sufficient
technical or engineering documentation (whether on paper or
in electronic form) that contains descriptions of all the
relevant software/hardware elements of the product, such as
its usage, structure, architectural components, interfaces, design, implementation,
configuration, operation, etc.
When technical documentation is limited or lacking, products are more difficult to maintain. This indirectly affects security by making it more difficult or time-consuming to find and/or fix vulnerabilities.
When using time-limited or labor-limited third-party/in-house security consulting services (such as threat modeling, vulnerability discovery, or pentesting), insufficient documentation can force those consultants to invest unnecessary time in learning how the product is organized, instead of focusing their expertise on finding the flaws or suggesting effective mitigations.
With respect to hardware design, the lack of a formal, final manufacturer reference can make it difficult or impossible to evaluate the final product, including post-manufacture verification. One cannot ensure that design functionality or operation is within acceptable tolerances, conforms to specifications, and is free from unexpected behavior. Hardware-related documentation may include engineering artifacts such as hardware description language (HDLs), netlists, Gerber files, Bills of Materials, EDA (Electronic Design Automation) tool files, etc.