Skip to content

[IDEA] Add OWASP Threat Model Library parity - #1034

Draft
P3tra-WP wants to merge 3 commits into
CycloneDX:2.0-devfrom
P3tra-WP:2.0-dev-threatmodeling-library-parity
Draft

[IDEA] Add OWASP Threat Model Library parity#1034
P3tra-WP wants to merge 3 commits into
CycloneDX:2.0-devfrom
P3tra-WP:2.0-dev-threatmodeling-library-parity

Conversation

@P3tra-WP

Copy link
Copy Markdown

Summary

  • add document scope and threat-model lifecycle metadata
  • add threat events, persona context, and reusable qualitative risk matrices
  • document OWASP Threat Model Library control-status conversion and add fixtures
  • leave generated bundled schemas unchanged

Validation

  • direct Ajv validation of the updated 2.0 fixtures
  • git diff --check
  • schema-v2 2.0 validation suite is currently blocked by an upstream strict-mode error in cyclonedx-common-2.0.schema.json preDefinedLifecyclePhase

@P3tra-WP
P3tra-WP requested a review from a team as a code owner August 21, 2026 10:34
"description": "Descriptor for an element identified by the attribute 'bom-ref' in the same BOM document.\nIn contrast to `bomLinkElementType`.",
"$ref": "#/$defs/refType"
},
"modelScope": {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why would the model scope live here, and not in cyclonedx-ai-modelcard-2.0.schema.json ?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

modelScope is intentionally a common definition because it is reused by metadata.scope and blueprint.scope. It describes analysis/model boundaries generally, not AI-model-card-specific scope. Keeping it in the common schema avoids duplicating the same structure and allows threat models beyond AI systems to use it.

This comes from the need of having a threat modelling scope very well defined - i.e. if you are threat modelling a feature - but have a full system diagram it is important to define the scope boundaries of the threat model, especially if something is out of scope but for completeness still mentioned in the dataflows etc (i.e. if modelling a new feature, perhaps authentication is out of scope, but for completeness of the diagram it is still mentioned)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see. so this "model" is actually some threat model?
or behavior?
For me this all looks unintuitive, anyway. see #1034 (comment)

@jkowalleck jkowalleck added this to the 2.0 milestone Aug 21, 2026
@jkowalleck jkowalleck added the CDX 2.0 related to release v2.0 label Aug 21, 2026
"$ref": "cyclonedx-component-2.0.schema.json#/$defs/component"
},
"scope": {
"description": "The scope of the analysis represented by this BOM, including what is in and out of scope.",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CycloneDX is about system transparency, not BOM.
therefore, i would not put this here.

"description": "The scope of the analysis represented by this BOM, including what is in and out of scope.",
"$ref": "cyclonedx-common-2.0.schema.json#/$defs/modelScope"
},
"modelLifecycle": {

@jkowalleck jkowalleck Aug 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

too specific for a metadata. shall go somewhere else

}
}
},
"modelLifecycle": {

@jkowalleck jkowalleck Aug 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why put this here, and not in the existing threat or blueprint or behaviour space?

@jkowalleck

jkowalleck commented Aug 24, 2026

Copy link
Copy Markdown
Member

re: #1034 (comment)

the scope of this PR seams off - at least to me.

this adds features all over the place, without considering the CycloneDX 2.0 philosophy or architecture.

Lets take this PR as a basis for further discussions.
Marking as "draft" for this reason.

@jkowalleck
jkowalleck marked this pull request as draft August 24, 2026 12:57
@jkowalleck

Copy link
Copy Markdown
Member

I'd recommend opening a new discussion, if you want to get community feedback on your general ideas.

discussing the exact proposed implementation may happen in this PR< still.

@jkowalleck jkowalleck changed the title Add OWASP Threat Model Library parity [IDEA] Add OWASP Threat Model Library parity Aug 24, 2026
Comment thread schema/2.0/THREAT-MODEL-MAPPING.md Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure if this file shall stay here.
it might belong to some docs space (that we don't have yet) or to some taxonomy living in the OWASP Threat Model Library space.

@P3tra-WP

Copy link
Copy Markdown
Author

I opened a Discussion to gather architectural feedback before continuing implementation: #1039

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CDX 2.0 related to release v2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants