@mitre/hdf-schema 3.6.0 → 3.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -2
- package/dist/go/hdf.go +20 -12
- package/dist/index.js +28 -28
- package/dist/schemas/hdf-amendments.schema.json +95 -48
- package/dist/schemas/hdf-baseline.schema.json +100 -53
- package/dist/schemas/hdf-comparison.schema.json +177 -130
- package/dist/schemas/hdf-evidence-package.schema.json +96 -49
- package/dist/schemas/hdf-plan.schema.json +101 -54
- package/dist/schemas/hdf-requirement-change-event.schema.json +167 -120
- package/dist/schemas/hdf-results.schema.json +153 -106
- package/dist/schemas/hdf-system.schema.json +116 -69
- package/dist/ts/hdf.d.ts +12 -2
- package/dist/ts/hdf.ts +12 -2
- package/package.json +2 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/hdf-comparison/v3.
|
|
3
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/hdf-comparison/v3.7.0",
|
|
4
4
|
"type": "object",
|
|
5
5
|
"unevaluatedProperties": false,
|
|
6
6
|
"required": [
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"externalReferences": {
|
|
15
15
|
"type": "array",
|
|
16
16
|
"items": {
|
|
17
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
17
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/External_Reference"
|
|
18
18
|
},
|
|
19
19
|
"description": "Optional references to external artifacts relevant to this comparison (CTI/STIX, advisories, or any URI-addressable artifact). Inert context; see External_Reference."
|
|
20
20
|
},
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"description": "Schema version for this comparison format."
|
|
25
25
|
},
|
|
26
26
|
"comparisonMode": {
|
|
27
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
27
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Comparison_Mode",
|
|
28
28
|
"description": "The mode of comparison being performed."
|
|
29
29
|
},
|
|
30
30
|
"timestamp": {
|
|
@@ -33,50 +33,50 @@
|
|
|
33
33
|
"description": "When this comparison was performed."
|
|
34
34
|
},
|
|
35
35
|
"generator": {
|
|
36
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
36
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Generator",
|
|
37
37
|
"description": "Information about the tool that generated this comparison."
|
|
38
38
|
},
|
|
39
39
|
"sources": {
|
|
40
40
|
"type": "array",
|
|
41
41
|
"minItems": 2,
|
|
42
42
|
"items": {
|
|
43
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
43
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Source"
|
|
44
44
|
},
|
|
45
45
|
"description": "The source documents being compared. At least two sources are required."
|
|
46
46
|
},
|
|
47
47
|
"matching": {
|
|
48
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
48
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Matching_Config",
|
|
49
49
|
"description": "Configuration for how requirements were matched across sources."
|
|
50
50
|
},
|
|
51
51
|
"summary": {
|
|
52
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
52
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Comparison_Summary",
|
|
53
53
|
"description": "Summary statistics for the overall comparison."
|
|
54
54
|
},
|
|
55
55
|
"baselineDiffs": {
|
|
56
56
|
"type": "array",
|
|
57
57
|
"items": {
|
|
58
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
58
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Baseline_Diff"
|
|
59
59
|
},
|
|
60
60
|
"description": "Comparison of baselines between sources."
|
|
61
61
|
},
|
|
62
62
|
"requirementDiffs": {
|
|
63
63
|
"type": "array",
|
|
64
64
|
"items": {
|
|
65
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
65
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Requirement_Diff"
|
|
66
66
|
},
|
|
67
67
|
"description": "Detailed comparison of individual requirements between sources."
|
|
68
68
|
},
|
|
69
69
|
"componentDiffs": {
|
|
70
70
|
"type": "array",
|
|
71
71
|
"items": {
|
|
72
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
72
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Component_Diff"
|
|
73
73
|
},
|
|
74
74
|
"description": "Comparison of components between two system documents. Used in systemDrift mode. A component's BOM changes surface as a field change on its boms[] here."
|
|
75
75
|
},
|
|
76
76
|
"packageDiffs": {
|
|
77
77
|
"type": "array",
|
|
78
78
|
"items": {
|
|
79
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
79
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Package_Diff"
|
|
80
80
|
},
|
|
81
81
|
"description": "RESERVED — not emitted by the current systemDrift comparison. systemDrift now reports a component's BOM changes as a field change on its boms[] (see componentDiffs), and standalone SBOM package diffing is a separate `hdf diff <sbom> <sbom>` output shape. This field is retained for a future normalized package-level diff; consumers must not expect it from today's systemDrift output."
|
|
82
82
|
},
|
|
@@ -88,19 +88,19 @@
|
|
|
88
88
|
"drift": {
|
|
89
89
|
"type": "array",
|
|
90
90
|
"items": {
|
|
91
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
91
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Requirement_Diff"
|
|
92
92
|
},
|
|
93
93
|
"description": "External/metadata changes separate from status changes (Terraform pattern)."
|
|
94
94
|
},
|
|
95
95
|
"annotations": {
|
|
96
96
|
"type": "object",
|
|
97
97
|
"additionalProperties": {
|
|
98
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
98
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0#/$defs/Annotation"
|
|
99
99
|
},
|
|
100
100
|
"description": "Map of annotation IDs to annotation objects, providing context or action items for requirement diffs."
|
|
101
101
|
},
|
|
102
102
|
"integrity": {
|
|
103
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
103
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Integrity",
|
|
104
104
|
"description": "Cryptographic integrity information for verifying this comparison document."
|
|
105
105
|
},
|
|
106
106
|
"extensions": {
|
|
@@ -112,9 +112,9 @@
|
|
|
112
112
|
"description": "Structured comparison between two or more HDF security assessment documents. Supports temporal, baseline, fleet, and multi-source comparison modes.",
|
|
113
113
|
"title": "HDF Comparison",
|
|
114
114
|
"$defs": {
|
|
115
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
115
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0": {
|
|
116
116
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
117
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
117
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0",
|
|
118
118
|
"title": "HDF Common Primitives",
|
|
119
119
|
"description": "Shared building blocks used by hdf-results and hdf-baseline schemas.",
|
|
120
120
|
"$defs": {
|
|
@@ -554,6 +554,24 @@
|
|
|
554
554
|
"type",
|
|
555
555
|
"data"
|
|
556
556
|
],
|
|
557
|
+
"if": {
|
|
558
|
+
"properties": {
|
|
559
|
+
"encoding": {
|
|
560
|
+
"const": "base64"
|
|
561
|
+
}
|
|
562
|
+
},
|
|
563
|
+
"required": [
|
|
564
|
+
"encoding"
|
|
565
|
+
]
|
|
566
|
+
},
|
|
567
|
+
"then": {
|
|
568
|
+
"properties": {
|
|
569
|
+
"data": {
|
|
570
|
+
"pattern": "^[0-9A-Za-z+/]+={0,2}$",
|
|
571
|
+
"contentEncoding": "base64"
|
|
572
|
+
}
|
|
573
|
+
}
|
|
574
|
+
},
|
|
557
575
|
"properties": {
|
|
558
576
|
"type": {
|
|
559
577
|
"type": "string",
|
|
@@ -570,7 +588,8 @@
|
|
|
570
588
|
},
|
|
571
589
|
"data": {
|
|
572
590
|
"type": "string",
|
|
573
|
-
"
|
|
591
|
+
"minLength": 1,
|
|
592
|
+
"description": "The evidence content. For screenshots/files: base64-encoded data or URL. For code/logs: the raw text. For URLs: the URL string. Must not be empty. When encoding is 'base64', data must be bare base64 matching ^[0-9A-Za-z+/]+={0,2}$ (OSCAL's Base64Datatype): no data: URI prefix, URL, or line breaks."
|
|
574
593
|
},
|
|
575
594
|
"description": {
|
|
576
595
|
"type": "string",
|
|
@@ -582,7 +601,7 @@
|
|
|
582
601
|
},
|
|
583
602
|
"encoding": {
|
|
584
603
|
"type": "string",
|
|
585
|
-
"description": "Encoding used for the data. Example: 'base64', 'utf-8'."
|
|
604
|
+
"description": "Encoding used for the data. Example: 'base64', 'utf-8'. The value 'base64' (exactly, lowercase) requires data to be bare base64."
|
|
586
605
|
},
|
|
587
606
|
"size": {
|
|
588
607
|
"type": "number",
|
|
@@ -646,6 +665,7 @@
|
|
|
646
665
|
}
|
|
647
666
|
}
|
|
648
667
|
],
|
|
668
|
+
"$comment": "Examples, in order: 1) base64-encoded PNG screenshot with full capture provenance; 2) raw configuration text; 3) log excerpt; 4) URL to an external ticket; 5) base64-encoded file captured by an automated system.",
|
|
649
669
|
"description": "Supporting evidence for a finding or override, such as screenshots, code samples, log excerpts, or URLs.",
|
|
650
670
|
"title": "Evidence"
|
|
651
671
|
},
|
|
@@ -723,6 +743,13 @@
|
|
|
723
743
|
"status"
|
|
724
744
|
],
|
|
725
745
|
"properties": {
|
|
746
|
+
"title": {
|
|
747
|
+
"type": "string",
|
|
748
|
+
"minLength": 1,
|
|
749
|
+
"pattern": "^[^ \\t\\n\\r]([^\\n\\r]*[^ \\t\\n\\r])?$",
|
|
750
|
+
"$comment": "The pattern is OSCAL's StringDatatype (\\S(.*\\S)?) as its XSD defines \\S and '.', spelled with explicit classes so ECMA-262 and Go regexp engines agree: \\S and '.' differ between them on CR and non-ASCII whitespace.",
|
|
751
|
+
"description": "Short single-line label for this milestone, suitable where a consumer needs a title (for example an OSCAL POA&M remediation or task). No line breaks, and no leading or trailing whitespace. The description remains the full text of the milestone; the title does not replace it."
|
|
752
|
+
},
|
|
726
753
|
"description": {
|
|
727
754
|
"type": "string",
|
|
728
755
|
"description": "Description of this milestone or task."
|
|
@@ -752,6 +779,25 @@
|
|
|
752
779
|
"description": "Identity of who completed this milestone."
|
|
753
780
|
}
|
|
754
781
|
},
|
|
782
|
+
"examples": [
|
|
783
|
+
{
|
|
784
|
+
"title": "Deploy OpenSSH 9.8p1",
|
|
785
|
+
"description": "Upgrade OpenSSH to 9.8p1 on every RHEL 9 host in the web tier to remediate CVE-2024-6387, then restart sshd during the Saturday maintenance window.",
|
|
786
|
+
"estimatedCompletion": "2026-10-31T00:00:00Z",
|
|
787
|
+
"status": "inProgress"
|
|
788
|
+
},
|
|
789
|
+
{
|
|
790
|
+
"description": "Isolate the affected host on a restricted VLAN until the vendor patch is available.",
|
|
791
|
+
"estimatedCompletion": "2026-09-05T00:00:00Z",
|
|
792
|
+
"status": "completed",
|
|
793
|
+
"completedAt": "2026-09-04T14:30:00Z",
|
|
794
|
+
"completedBy": {
|
|
795
|
+
"identifier": "network-admin@example.com",
|
|
796
|
+
"type": "email"
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
],
|
|
800
|
+
"$comment": "Examples, in order: 1) titled milestone in progress — the title is the short label, the description the full remediation text; 2) untitled completed milestone with completion provenance — title is optional, and a consumer needing one derives it.",
|
|
755
801
|
"description": "A milestone or task within a POA&M remediation plan.",
|
|
756
802
|
"title": "Milestone"
|
|
757
803
|
},
|
|
@@ -1041,7 +1087,7 @@
|
|
|
1041
1087
|
"description": "Whether the requirement is mandatory within its baseline.\n\nDistinct from severity (risk weight) and status (lifecycle state).\n\nMaps cleanly onto: FedRAMP rev5 OSCAL 'CORE' prop, FedRAMP 20x inline 'Optional:' markers, CMMC sublevel rows, and CIS Implementation Group memberships (IG1/IG2/IG3 may carry richer semantics; layer those onto props[]/tags{}).\n\nOptional: when omitted, consumers should treat the requirement as 'required' by convention."
|
|
1042
1088
|
}
|
|
1043
1089
|
},
|
|
1044
|
-
"$comment": "Examples, in order: 1) v3.1.x-style requirement: classification fields omitted. Consumers must continue to handle this shape
|
|
1090
|
+
"$comment": "Examples, in order: 1) v3.1.x-style requirement: classification fields omitted. Consumers must continue to handle this shape for backward compatibility; 2) v3.2 example populating all three classification fields. controlType=technical because AC-3 is enforced via configuration, not policy text. verificationMethod=automated because a check exists. applicability=required because this is a CORE control in the source baseline; 3) v3.2 example for a manual-by-design requirement. FedRAMP 20x KSIs are statement-form: code is omitted (not null) and verificationMethod=manual-by-design distinguishes this from 'automation could exist but doesn't yet'. controlType=policy because this is an authored governance statement; 4) v3.2 example for a STIG rule lacking a <fix>. Differs from manual-by-design: automation should exist, just not yet. applicability=advisory used here because the source format flagged it as recommended-but-not-mandatory; CIS-style IG memberships and FedRAMP 'Optional:' markers map onto applicability=optional or advisory similarly.",
|
|
1045
1091
|
"examples": [
|
|
1046
1092
|
{
|
|
1047
1093
|
"id": "SV-238196",
|
|
@@ -1177,9 +1223,9 @@
|
|
|
1177
1223
|
}
|
|
1178
1224
|
}
|
|
1179
1225
|
},
|
|
1180
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
1226
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0": {
|
|
1181
1227
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
1182
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.
|
|
1228
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/comparison/v3.7.0",
|
|
1183
1229
|
"title": "HDF Comparison Primitives",
|
|
1184
1230
|
"description": "Types for representing structured comparisons between HDF security assessment documents.",
|
|
1185
1231
|
"$defs": {
|
|
@@ -1351,7 +1397,7 @@
|
|
|
1351
1397
|
"description": "The original format of the source document before conversion to HDF."
|
|
1352
1398
|
},
|
|
1353
1399
|
"checksum": {
|
|
1354
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
1400
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
1355
1401
|
"description": "Cryptographic checksum of the source document for integrity verification."
|
|
1356
1402
|
},
|
|
1357
1403
|
"assessmentTimestamp": {
|
|
@@ -1360,13 +1406,13 @@
|
|
|
1360
1406
|
"description": "When the source assessment was performed. ISO 8601 format."
|
|
1361
1407
|
},
|
|
1362
1408
|
"tool": {
|
|
1363
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
1409
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Tool",
|
|
1364
1410
|
"description": "The security tool that produced the assessment data in this source."
|
|
1365
1411
|
},
|
|
1366
1412
|
"components": {
|
|
1367
1413
|
"type": "array",
|
|
1368
1414
|
"items": {
|
|
1369
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
1415
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0#/$defs/Component"
|
|
1370
1416
|
},
|
|
1371
1417
|
"description": "The components assessed in this source."
|
|
1372
1418
|
},
|
|
@@ -1718,7 +1764,7 @@
|
|
|
1718
1764
|
"before": {
|
|
1719
1765
|
"oneOf": [
|
|
1720
1766
|
{
|
|
1721
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
1767
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0#/$defs/Component"
|
|
1722
1768
|
},
|
|
1723
1769
|
{
|
|
1724
1770
|
"type": "null"
|
|
@@ -1729,7 +1775,7 @@
|
|
|
1729
1775
|
"after": {
|
|
1730
1776
|
"oneOf": [
|
|
1731
1777
|
{
|
|
1732
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
1778
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0#/$defs/Component"
|
|
1733
1779
|
},
|
|
1734
1780
|
{
|
|
1735
1781
|
"type": "null"
|
|
@@ -1934,7 +1980,7 @@
|
|
|
1934
1980
|
"before": {
|
|
1935
1981
|
"oneOf": [
|
|
1936
1982
|
{
|
|
1937
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.
|
|
1983
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.7.0#/$defs/Evaluated_Requirement"
|
|
1938
1984
|
},
|
|
1939
1985
|
{
|
|
1940
1986
|
"type": "null"
|
|
@@ -1945,7 +1991,7 @@
|
|
|
1945
1991
|
"after": {
|
|
1946
1992
|
"oneOf": [
|
|
1947
1993
|
{
|
|
1948
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.
|
|
1994
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.7.0#/$defs/Evaluated_Requirement"
|
|
1949
1995
|
},
|
|
1950
1996
|
{
|
|
1951
1997
|
"type": "null"
|
|
@@ -2041,9 +2087,9 @@
|
|
|
2041
2087
|
}
|
|
2042
2088
|
}
|
|
2043
2089
|
},
|
|
2044
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
2090
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0": {
|
|
2045
2091
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
2046
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
2092
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0",
|
|
2047
2093
|
"title": "HDF Extension Primitives",
|
|
2048
2094
|
"description": "Extension types for waivers, attestations, generators, and integrity.",
|
|
2049
2095
|
"$defs": {
|
|
@@ -2073,20 +2119,20 @@
|
|
|
2073
2119
|
"externalReferences": {
|
|
2074
2120
|
"type": "array",
|
|
2075
2121
|
"items": {
|
|
2076
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2122
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/External_Reference"
|
|
2077
2123
|
},
|
|
2078
2124
|
"description": "Optional references to the external artifacts behind this override (e.g. the STIX bundle/object or CTI feed motivating an E:A riskAdjustment). Inert context distinct from `evidence`; see External_Reference. Symmetric with Standalone_Override.externalReferences for the inline (results-embedded) override carrier."
|
|
2079
2125
|
},
|
|
2080
2126
|
"type": {
|
|
2081
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
2127
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0#/$defs/Override_Type",
|
|
2082
2128
|
"description": "The type of override applied to this requirement."
|
|
2083
2129
|
},
|
|
2084
2130
|
"status": {
|
|
2085
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
2131
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Result_Status",
|
|
2086
2132
|
"description": "The new status this override sets for the requirement. Optional when only impact is being overridden."
|
|
2087
2133
|
},
|
|
2088
2134
|
"impact": {
|
|
2089
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
2135
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0#/$defs/Impact_Override",
|
|
2090
2136
|
"description": "Override to the requirement's impact score. At least one of status or impact must be set."
|
|
2091
2137
|
},
|
|
2092
2138
|
"reason": {
|
|
@@ -2094,7 +2140,7 @@
|
|
|
2094
2140
|
"description": "Explanation for why this override was applied."
|
|
2095
2141
|
},
|
|
2096
2142
|
"appliedBy": {
|
|
2097
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2143
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
2098
2144
|
"description": "Identity of who applied this override. For simple cases, use type 'simple' with just an identifier."
|
|
2099
2145
|
},
|
|
2100
2146
|
"appliedAt": {
|
|
@@ -2108,27 +2154,27 @@
|
|
|
2108
2154
|
"description": "Timestamp when this override expires and must be reviewed/renewed. REQUIRED - no permanent overrides allowed. ISO 8601 format."
|
|
2109
2155
|
},
|
|
2110
2156
|
"signature": {
|
|
2111
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2157
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Signature",
|
|
2112
2158
|
"description": "Optional digital signature for enhanced trust and non-repudiation. Supports hardware security tokens (PKCS#11/PKCS#12), Yubikeys, GPG keys, passkeys, and other signing methods."
|
|
2113
2159
|
},
|
|
2114
2160
|
"evidence": {
|
|
2115
2161
|
"type": "array",
|
|
2116
2162
|
"items": {
|
|
2117
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2163
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Evidence"
|
|
2118
2164
|
},
|
|
2119
2165
|
"description": "Supporting evidence for this override, such as screenshots demonstrating manual verification for attestations."
|
|
2120
2166
|
},
|
|
2121
2167
|
"previousChecksum": {
|
|
2122
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2168
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
2123
2169
|
"description": "SHA-256 checksum of the previous amendment in chronological order. Each amendment's checksum is recorded by the NEXT one, so editing an amendment in place is detectable — provided a later amendment is chained to it. It is NOT tamper-proof: the final amendment, the document envelope, deleted trailing amendments, and a chain that has been stripped or recomputed wholesale are all outside what it can detect. Use signature for non-repudiation. Omitted on the first amendment on a requirement."
|
|
2124
2170
|
},
|
|
2125
2171
|
"cvss": {
|
|
2126
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.
|
|
2172
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.7.0#/$defs/Cvss",
|
|
2127
2173
|
"$comment": "When present alongside impact.value on a riskAdjustment override, impact.value should be approximately cvss.computedScore / 10.0. Soft consistency rule — validators may warn but should not error. The cvss block makes Environmental/Threat enrichment auditable.",
|
|
2128
2174
|
"description": "Structured CVSS scoring data backing this override. Captures the rubric (which Environmental/Threat metrics the consumer modified, the recomputed score) used to justify a riskAdjustment. For other override types this is optional context."
|
|
2129
2175
|
},
|
|
2130
2176
|
"justification": {
|
|
2131
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
2177
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0#/$defs/Justification",
|
|
2132
2178
|
"description": "Structured controlled-vocabulary classification for why this override applies. Complements (does not replace) the free-text 'reason' field. Most useful on falsePositive and attestation overrides where the structured category enables filtering and lossless round-trip with VEX / OSCAL / FedRAMP DR. See the Justification primitive for the precedent vocabulary and rationale."
|
|
2133
2179
|
}
|
|
2134
2180
|
},
|
|
@@ -2221,7 +2267,7 @@
|
|
|
2221
2267
|
"evidence": [
|
|
2222
2268
|
{
|
|
2223
2269
|
"type": "screenshot",
|
|
2224
|
-
"data": "
|
|
2270
|
+
"data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
|
|
2225
2271
|
"description": "Screenshot showing firewall configuration",
|
|
2226
2272
|
"mimeType": "image/png",
|
|
2227
2273
|
"encoding": "base64",
|
|
@@ -2264,7 +2310,7 @@
|
|
|
2264
2310
|
"description": "Detailed explanation of the plan, including what actions will be taken."
|
|
2265
2311
|
},
|
|
2266
2312
|
"appliedBy": {
|
|
2267
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2313
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
2268
2314
|
"description": "Identity of who created this POA&M. For simple cases, use type 'simple' with just an identifier."
|
|
2269
2315
|
},
|
|
2270
2316
|
"appliedAt": {
|
|
@@ -2280,23 +2326,23 @@
|
|
|
2280
2326
|
"milestones": {
|
|
2281
2327
|
"type": "array",
|
|
2282
2328
|
"items": {
|
|
2283
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2329
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Milestone"
|
|
2284
2330
|
},
|
|
2285
2331
|
"description": "Optional array of milestones tracking progress toward completion."
|
|
2286
2332
|
},
|
|
2287
2333
|
"signature": {
|
|
2288
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2334
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Signature",
|
|
2289
2335
|
"description": "Optional digital signature for enhanced trust and non-repudiation."
|
|
2290
2336
|
},
|
|
2291
2337
|
"evidence": {
|
|
2292
2338
|
"type": "array",
|
|
2293
2339
|
"items": {
|
|
2294
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2340
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Evidence"
|
|
2295
2341
|
},
|
|
2296
2342
|
"description": "Supporting evidence for this POA&M, such as documentation of compensating controls or mitigation implementation."
|
|
2297
2343
|
},
|
|
2298
2344
|
"previousChecksum": {
|
|
2299
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2345
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
2300
2346
|
"description": "SHA-256 checksum of the previous amendment in chronological order. Each amendment's checksum is recorded by the NEXT one, so editing an amendment in place is detectable — provided a later amendment is chained to it. It is NOT tamper-proof: the final amendment, the document envelope, deleted trailing amendments, and a chain that has been stripped or recomputed wholesale are all outside what it can detect. Use signature for non-repudiation. Omitted on the first amendment on a requirement."
|
|
2301
2347
|
}
|
|
2302
2348
|
},
|
|
@@ -2449,7 +2495,7 @@
|
|
|
2449
2495
|
},
|
|
2450
2496
|
"properties": {
|
|
2451
2497
|
"algorithm": {
|
|
2452
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2498
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Hash_Algorithm",
|
|
2453
2499
|
"description": "The hash algorithm used for the checksum."
|
|
2454
2500
|
},
|
|
2455
2501
|
"checksum": {
|
|
@@ -2482,9 +2528,9 @@
|
|
|
2482
2528
|
}
|
|
2483
2529
|
}
|
|
2484
2530
|
},
|
|
2485
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
2531
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0": {
|
|
2486
2532
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
2487
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
2533
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0",
|
|
2488
2534
|
"title": "HDF Amendment Primitives",
|
|
2489
2535
|
"description": "Types for waivers, attestations, and POA&Ms that modify requirement compliance status.",
|
|
2490
2536
|
"$defs": {
|
|
@@ -2595,7 +2641,7 @@
|
|
|
2595
2641
|
"externalReferences": {
|
|
2596
2642
|
"type": "array",
|
|
2597
2643
|
"items": {
|
|
2598
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2644
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/External_Reference"
|
|
2599
2645
|
},
|
|
2600
2646
|
"description": "Optional references to the external artifacts behind this override (e.g. the STIX bundle/object, advisory, or CTI feed that motivated it). Inert context distinct from `evidence`; see External_Reference."
|
|
2601
2647
|
},
|
|
@@ -2605,6 +2651,7 @@
|
|
|
2605
2651
|
},
|
|
2606
2652
|
"requirementId": {
|
|
2607
2653
|
"type": "string",
|
|
2654
|
+
"minLength": 1,
|
|
2608
2655
|
"description": "The ID of the requirement being amended. Must match a requirement ID in the referenced baseline."
|
|
2609
2656
|
},
|
|
2610
2657
|
"baselineRef": {
|
|
@@ -2612,7 +2659,7 @@
|
|
|
2612
2659
|
"description": "Name of the baseline containing the requirement. Required when the system has multiple baselines with potentially overlapping requirement IDs."
|
|
2613
2660
|
},
|
|
2614
2661
|
"status": {
|
|
2615
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
2662
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Result_Status",
|
|
2616
2663
|
"description": "The new status this amendment sets. Optional when only impact is being overridden."
|
|
2617
2664
|
},
|
|
2618
2665
|
"impact": {
|
|
@@ -2624,7 +2671,7 @@
|
|
|
2624
2671
|
"description": "Justification for this amendment."
|
|
2625
2672
|
},
|
|
2626
2673
|
"appliedBy": {
|
|
2627
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2674
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
2628
2675
|
"description": "Identity of who applied this amendment."
|
|
2629
2676
|
},
|
|
2630
2677
|
"appliedAt": {
|
|
@@ -2640,20 +2687,20 @@
|
|
|
2640
2687
|
"evidence": {
|
|
2641
2688
|
"type": "array",
|
|
2642
2689
|
"items": {
|
|
2643
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2690
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Evidence"
|
|
2644
2691
|
},
|
|
2645
2692
|
"description": "Supporting evidence (screenshots, logs, URLs, documents)."
|
|
2646
2693
|
},
|
|
2647
2694
|
"signature": {
|
|
2648
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2695
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Signature",
|
|
2649
2696
|
"description": "Digital signature for non-repudiation."
|
|
2650
2697
|
},
|
|
2651
2698
|
"previousChecksum": {
|
|
2652
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2699
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
2653
2700
|
"description": "SHA-256 checksum of the prior amendment in chronological order. Each amendment's checksum is recorded by the NEXT one, so editing an amendment in place is detectable — provided a later amendment is chained to it. It is NOT tamper-proof: the final amendment, the document envelope, deleted trailing amendments, and a chain that has been stripped or recomputed wholesale are all outside what it can detect. Use signature for non-repudiation. Omitted on the first amendment."
|
|
2654
2701
|
},
|
|
2655
2702
|
"cvss": {
|
|
2656
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.
|
|
2703
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.7.0#/$defs/Cvss",
|
|
2657
2704
|
"$comment": "When present alongside impact.value on a riskAdjustment override, impact.value should be approximately cvss.computedScore / 10.0. Soft consistency rule — validators may warn but should not error. The cvss block makes Environmental/Threat enrichment auditable.",
|
|
2658
2705
|
"description": "Structured CVSS scoring data backing this override. Captures the rubric (which Environmental/Threat metrics the consumer modified, the recomputed score) used to justify a riskAdjustment. For other override types this is optional context."
|
|
2659
2706
|
},
|
|
@@ -2664,7 +2711,7 @@
|
|
|
2664
2711
|
"milestones": {
|
|
2665
2712
|
"type": "array",
|
|
2666
2713
|
"items": {
|
|
2667
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
2714
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Milestone"
|
|
2668
2715
|
},
|
|
2669
2716
|
"description": "Remediation milestones (primarily for POA&M type amendments)."
|
|
2670
2717
|
},
|
|
@@ -2681,7 +2728,7 @@
|
|
|
2681
2728
|
"affectedPackages": {
|
|
2682
2729
|
"type": "array",
|
|
2683
2730
|
"items": {
|
|
2684
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.
|
|
2731
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.7.0#/$defs/Affected_Package"
|
|
2685
2732
|
},
|
|
2686
2733
|
"description": "Software packages this amendment is scoped to, distinct from componentRef (which scopes to an HDF-internal Component by UUID).\n\nUse when the source amendment format references packages by purl/cpe/name+version — e.g., VEX `affects[]` / `products[]`, OSCAL POA&M `subjects[]`, FedRAMP component-aware amendments.\n\nSymmetric with Evaluated_Requirement.affectedPackages, which scopes findings to the same package vocabulary.\n\nWhen omitted, the amendment applies system-wide (or only to componentRef when that is set)."
|
|
2687
2734
|
}
|
|
@@ -2814,9 +2861,9 @@
|
|
|
2814
2861
|
}
|
|
2815
2862
|
}
|
|
2816
2863
|
},
|
|
2817
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
2864
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0": {
|
|
2818
2865
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
2819
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
2866
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0",
|
|
2820
2867
|
"title": "HDF Result Primitives",
|
|
2821
2868
|
"description": "Types for representing assessment results and statuses.",
|
|
2822
2869
|
"$defs": {
|
|
@@ -2947,9 +2994,9 @@
|
|
|
2947
2994
|
}
|
|
2948
2995
|
}
|
|
2949
2996
|
},
|
|
2950
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.
|
|
2997
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.7.0": {
|
|
2951
2998
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
2952
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.
|
|
2999
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.7.0",
|
|
2953
3000
|
"title": "HDF CVSS Primitives",
|
|
2954
3001
|
"description": "Types for representing CVSS (Common Vulnerability Scoring System) data attached to assessment findings. Supports CVSS v2.0, v3.0, v3.1, and v4.0 metric groups (Base, Threat, Environmental, Supplemental).",
|
|
2955
3002
|
"$defs": {
|
|
@@ -3146,9 +3193,9 @@
|
|
|
3146
3193
|
}
|
|
3147
3194
|
}
|
|
3148
3195
|
},
|
|
3149
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.
|
|
3196
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.7.0": {
|
|
3150
3197
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3151
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.
|
|
3198
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.7.0",
|
|
3152
3199
|
"title": "HDF Affected Package Primitives",
|
|
3153
3200
|
"description": "Types for representing the software package(s) affected by a vulnerability finding.",
|
|
3154
3201
|
"$defs": {
|
|
@@ -3256,9 +3303,9 @@
|
|
|
3256
3303
|
}
|
|
3257
3304
|
}
|
|
3258
3305
|
},
|
|
3259
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
3306
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0": {
|
|
3260
3307
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3261
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
3308
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0",
|
|
3262
3309
|
"title": "HDF Component Primitives",
|
|
3263
3310
|
"description": "First-class system component with identity, polymorphic type, generalized BOM attachment (boms[]), and system-binding properties. Components are the successor to Targets, adding stable identity (componentId), external system cross-references, and manifest inventory (SBOM, AI model/dataset, and reserved future BOM kinds).",
|
|
3264
3311
|
"$defs": {
|
|
@@ -3304,7 +3351,7 @@
|
|
|
3304
3351
|
"description": "Description of this component's role or purpose."
|
|
3305
3352
|
},
|
|
3306
3353
|
"owner": {
|
|
3307
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
3354
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
3308
3355
|
"description": "Team or individual responsible for this component. Enables per-component ownership when different teams manage different parts of a system."
|
|
3309
3356
|
},
|
|
3310
3357
|
"externalIds": {
|
|
@@ -3324,14 +3371,14 @@
|
|
|
3324
3371
|
"boms": {
|
|
3325
3372
|
"type": "array",
|
|
3326
3373
|
"items": {
|
|
3327
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.
|
|
3374
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.7.0#/$defs/Bom"
|
|
3328
3375
|
},
|
|
3329
3376
|
"description": "Component-scoped Bills of Materials (SBOM, ai-model, dataset, or any reserved bomType), each carried by passthrough (ref/document) or normalized. Replaces the former sbom/sbomRef/sbomFormat trio; a component may carry several BOMs (e.g. an SBOM plus an ai-model BOM). See primitives/bom.schema.json."
|
|
3330
3377
|
},
|
|
3331
3378
|
"integrity": {
|
|
3332
3379
|
"type": "array",
|
|
3333
3380
|
"items": {
|
|
3334
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
3381
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum"
|
|
3335
3382
|
},
|
|
3336
3383
|
"description": "Cryptographic integrity of this component's underlying artifact — model weights or shards, dataset archive, container image, or package bytes.\n\nAn array supports multi-file/sharded artifacts.\n\nThis is the single, generic home for artifact/subject integrity across all component types (it replaced the former per-type Container_Image digest and Artifact checksum fields).\n\nDistinct from BOM-document integrity (Bom.hashes[]) and from the document tamper-evidence Integrity type."
|
|
3337
3384
|
},
|
|
@@ -3345,12 +3392,12 @@
|
|
|
3345
3392
|
"inputOverrides": {
|
|
3346
3393
|
"type": "array",
|
|
3347
3394
|
"items": {
|
|
3348
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.
|
|
3395
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.7.0#/$defs/Input_Override"
|
|
3349
3396
|
},
|
|
3350
3397
|
"description": "System-specific overrides for baseline input values."
|
|
3351
3398
|
},
|
|
3352
3399
|
"targetSelector": {
|
|
3353
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.
|
|
3400
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.7.0#/$defs/Target_Selector",
|
|
3354
3401
|
"description": "Label selector to match targets belonging to this component during migration. Targets with matching labels are automatically included."
|
|
3355
3402
|
}
|
|
3356
3403
|
},
|
|
@@ -3633,7 +3680,7 @@
|
|
|
3633
3680
|
"const": "cloudAccount"
|
|
3634
3681
|
},
|
|
3635
3682
|
"provider": {
|
|
3636
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
3683
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Cloud_Provider",
|
|
3637
3684
|
"description": "Cloud provider."
|
|
3638
3685
|
},
|
|
3639
3686
|
"accountId": {
|
|
@@ -3672,7 +3719,7 @@
|
|
|
3672
3719
|
"const": "cloudResource"
|
|
3673
3720
|
},
|
|
3674
3721
|
"provider": {
|
|
3675
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
3722
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Cloud_Provider",
|
|
3676
3723
|
"description": "Cloud provider."
|
|
3677
3724
|
},
|
|
3678
3725
|
"resourceType": {
|
|
@@ -3971,9 +4018,9 @@
|
|
|
3971
4018
|
}
|
|
3972
4019
|
}
|
|
3973
4020
|
},
|
|
3974
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.
|
|
4021
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.7.0": {
|
|
3975
4022
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3976
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.
|
|
4023
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/bom/v3.7.0",
|
|
3977
4024
|
"title": "HDF BOM Primitives",
|
|
3978
4025
|
"description": "Generalized Bill-of-Materials / manifest representation.\n\nOne extensible Bom shape, discriminated by bomType, carries any manifest kind (SBOM, AI model/dataset, and reserved future kinds) either by passthrough (opaque ref/embed of the native document) or normalized (converted into HDF's queryable shape).\n\nSubject identity (name, version, componentId) is inherited from the host component or system — the BOM never re-owns it.\n\nSee ADR-0001.",
|
|
3979
4026
|
"$defs": {
|
|
@@ -4029,7 +4076,7 @@
|
|
|
4029
4076
|
"hashes": {
|
|
4030
4077
|
"type": "array",
|
|
4031
4078
|
"items": {
|
|
4032
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4079
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum"
|
|
4033
4080
|
},
|
|
4034
4081
|
"description": "Integrity of the carried BOM *document* itself (the referenced/embedded manifest file), NOT the integrity of the BOM's subject artifact. Subject/artifact integrity (model weights, dataset archive) is a component-level concern, not carried here. Subject identity is inherited from the host component/system; per-node identity lives in the type-extension."
|
|
4035
4082
|
},
|
|
@@ -4441,9 +4488,9 @@
|
|
|
4441
4488
|
}
|
|
4442
4489
|
}
|
|
4443
4490
|
},
|
|
4444
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.
|
|
4491
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.7.0": {
|
|
4445
4492
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
4446
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.
|
|
4493
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/system/v3.7.0",
|
|
4447
4494
|
"title": "HDF System Primitives",
|
|
4448
4495
|
"description": "Types for describing system architecture, authorization boundaries, and components.",
|
|
4449
4496
|
"$defs": {
|
|
@@ -4494,7 +4541,7 @@
|
|
|
4494
4541
|
"description": "Rationale for why this override is needed."
|
|
4495
4542
|
},
|
|
4496
4543
|
"approvedBy": {
|
|
4497
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4544
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
4498
4545
|
"description": "Identity of the person or system that approved this override."
|
|
4499
4546
|
}
|
|
4500
4547
|
},
|
|
@@ -4576,9 +4623,9 @@
|
|
|
4576
4623
|
}
|
|
4577
4624
|
}
|
|
4578
4625
|
},
|
|
4579
|
-
"https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.
|
|
4626
|
+
"https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.7.0": {
|
|
4580
4627
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
4581
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.
|
|
4628
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/hdf-results/v3.7.0",
|
|
4582
4629
|
"type": "object",
|
|
4583
4630
|
"unevaluatedProperties": false,
|
|
4584
4631
|
"required": [
|
|
@@ -4588,7 +4635,7 @@
|
|
|
4588
4635
|
"externalReferences": {
|
|
4589
4636
|
"type": "array",
|
|
4590
4637
|
"items": {
|
|
4591
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4638
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/External_Reference"
|
|
4592
4639
|
},
|
|
4593
4640
|
"description": "Optional references to external artifacts (CTI/STIX, BOMs, advisories, runbooks, or any URI-addressable artifact) relevant to this assessment as a whole. Inert context; see External_Reference."
|
|
4594
4641
|
},
|
|
@@ -4605,7 +4652,7 @@
|
|
|
4605
4652
|
"components": {
|
|
4606
4653
|
"type": "array",
|
|
4607
4654
|
"items": {
|
|
4608
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.
|
|
4655
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/component/v3.7.0#/$defs/Component"
|
|
4609
4656
|
},
|
|
4610
4657
|
"description": "The components that were assessed. Each component describes a system element (host, container, cloud resource, application, etc.) with optional identity, SBOM, and external references."
|
|
4611
4658
|
},
|
|
@@ -4617,23 +4664,23 @@
|
|
|
4617
4664
|
"description": "Information on the baselines that were evaluated, including findings."
|
|
4618
4665
|
},
|
|
4619
4666
|
"statistics": {
|
|
4620
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.
|
|
4667
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.7.0#/$defs/Statistics",
|
|
4621
4668
|
"description": "Statistics for the assessment run, including duration and result counts."
|
|
4622
4669
|
},
|
|
4623
4670
|
"generator": {
|
|
4624
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4671
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Generator",
|
|
4625
4672
|
"description": "Information about the tool that generated this file."
|
|
4626
4673
|
},
|
|
4627
4674
|
"tool": {
|
|
4628
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4675
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Tool",
|
|
4629
4676
|
"description": "The security tool that produced the assessment data in this file."
|
|
4630
4677
|
},
|
|
4631
4678
|
"integrity": {
|
|
4632
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4679
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Integrity",
|
|
4633
4680
|
"description": "Cryptographic integrity information for verifying this file."
|
|
4634
4681
|
},
|
|
4635
4682
|
"preAmendmentChecksum": {
|
|
4636
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4683
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
4637
4684
|
"description": "Hash of this results document as it stood immediately before the most recent amendment application. Written by `hdf amend apply` when it applies at least one override; an apply that matches nothing leaves the document untouched. The hash covers the results file's RAW BYTES as read, not a canonical form, so reproducing it requires the byte-identical original — reformatting or re-serializing the source changes the value. Only the most recent pre-application state is recorded: applying amendments to an already-amended document REPLACES this value, so it is a single link back one step, not a growing chain. Distinct from the `previousChecksum` inside an override, which chains amendments to each other and is computed over a canonical JSON form.",
|
|
4638
4685
|
"$comment": "Example 1: the real SHA-256 of hdf-converters/converters/nessus-to-hdf/fixtures/expected/sample.nessus.hdf.json, reproducible with `shasum -a 256` on that file — chosen over a synthetic digest so a reader can verify the hash basis is the raw file bytes.",
|
|
4639
4686
|
"examples": [
|
|
@@ -4644,11 +4691,11 @@
|
|
|
4644
4691
|
]
|
|
4645
4692
|
},
|
|
4646
4693
|
"runner": {
|
|
4647
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.
|
|
4694
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.7.0#/$defs/Runner",
|
|
4648
4695
|
"description": "Information about the test execution environment where the security tool was run. Distinct from targets (what is being tested)."
|
|
4649
4696
|
},
|
|
4650
4697
|
"remediation": {
|
|
4651
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4698
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Remediation",
|
|
4652
4699
|
"description": "Optional reference to automated remediation resources (Ansible playbooks, Terraform scripts, etc.) for fixing failing requirements found in this assessment."
|
|
4653
4700
|
},
|
|
4654
4701
|
"systemRef": {
|
|
@@ -4662,7 +4709,7 @@
|
|
|
4662
4709
|
"description": "Reference to an hdf-plan document describing the assessment plan that produced these results. May be a relative path, absolute URI, or fragment identifier."
|
|
4663
4710
|
},
|
|
4664
4711
|
"derivation": {
|
|
4665
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.
|
|
4712
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.7.0#/$defs/Derivation",
|
|
4666
4713
|
"description": "Present ONLY on reconciled result sets: lineage recording the seed snapshot and event watermark this document was reassembled from (ADR-0005). Documents produced directly by a scan omit this field. When present, generator names the reconciling tool."
|
|
4667
4714
|
},
|
|
4668
4715
|
"extensions": {
|
|
@@ -4760,14 +4807,14 @@
|
|
|
4760
4807
|
],
|
|
4761
4808
|
"allOf": [
|
|
4762
4809
|
{
|
|
4763
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4810
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Baseline_Metadata"
|
|
4764
4811
|
}
|
|
4765
4812
|
],
|
|
4766
4813
|
"properties": {
|
|
4767
4814
|
"depends": {
|
|
4768
4815
|
"type": "array",
|
|
4769
4816
|
"items": {
|
|
4770
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4817
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Dependency"
|
|
4771
4818
|
},
|
|
4772
4819
|
"description": "The set of dependencies this baseline depends on."
|
|
4773
4820
|
},
|
|
@@ -4780,15 +4827,15 @@
|
|
|
4780
4827
|
"description": "The description - should be more detailed than the summary."
|
|
4781
4828
|
},
|
|
4782
4829
|
"integrity": {
|
|
4783
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4830
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Integrity",
|
|
4784
4831
|
"description": "Cryptographic integrity information for verifying this baseline has not been tampered with."
|
|
4785
4832
|
},
|
|
4786
4833
|
"originalChecksum": {
|
|
4787
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4834
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
4788
4835
|
"description": "SHA-256 checksum of the original baseline definition file (before execution). This is an immutable reference to the baseline as defined, used to detect tampering with baseline requirements or metadata."
|
|
4789
4836
|
},
|
|
4790
4837
|
"resultsChecksum": {
|
|
4791
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4838
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
4792
4839
|
"description": "SHA-256 checksum of the raw results before any amendments (statusOverrides or POAMs). Used to detect tampering with test results. Compare with currentChecksum to verify amendment integrity."
|
|
4793
4840
|
},
|
|
4794
4841
|
"statusMessage": {
|
|
@@ -4806,14 +4853,14 @@
|
|
|
4806
4853
|
"groups": {
|
|
4807
4854
|
"type": "array",
|
|
4808
4855
|
"items": {
|
|
4809
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4856
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Requirement_Group"
|
|
4810
4857
|
},
|
|
4811
4858
|
"description": "A set of descriptions for the requirement groups."
|
|
4812
4859
|
},
|
|
4813
4860
|
"inputs": {
|
|
4814
4861
|
"type": "array",
|
|
4815
4862
|
"items": {
|
|
4816
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.
|
|
4863
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.7.0#/$defs/Input"
|
|
4817
4864
|
},
|
|
4818
4865
|
"description": "Typed inputs used to parameterize this baseline at execution time. See the Input primitive for the full schema."
|
|
4819
4866
|
},
|
|
@@ -4838,7 +4885,7 @@
|
|
|
4838
4885
|
],
|
|
4839
4886
|
"allOf": [
|
|
4840
4887
|
{
|
|
4841
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4888
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Requirement_Core"
|
|
4842
4889
|
}
|
|
4843
4890
|
],
|
|
4844
4891
|
"properties": {
|
|
@@ -4846,7 +4893,7 @@
|
|
|
4846
4893
|
"type": "array",
|
|
4847
4894
|
"minItems": 1,
|
|
4848
4895
|
"items": {
|
|
4849
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
4896
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Requirement_Description"
|
|
4850
4897
|
},
|
|
4851
4898
|
"contains": {
|
|
4852
4899
|
"type": "object",
|
|
@@ -4862,37 +4909,37 @@
|
|
|
4862
4909
|
"description": "Array of labeled descriptions. At least one description with label 'default' must be present. Convention: place default description first. Common labels: 'default', 'check', 'fix', 'rationale'."
|
|
4863
4910
|
},
|
|
4864
4911
|
"severity": {
|
|
4865
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4912
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Severity",
|
|
4866
4913
|
"description": "Explicit severity rating. Typically derived from impact score but provided explicitly for clarity."
|
|
4867
4914
|
},
|
|
4868
4915
|
"sourceLocation": {
|
|
4869
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4916
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Source_Location",
|
|
4870
4917
|
"description": "The explicit location of the requirement within the source code."
|
|
4871
4918
|
},
|
|
4872
4919
|
"results": {
|
|
4873
4920
|
"type": "array",
|
|
4874
4921
|
"minItems": 1,
|
|
4875
4922
|
"items": {
|
|
4876
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
4923
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Requirement_Result"
|
|
4877
4924
|
},
|
|
4878
4925
|
"description": "The set of all tests within the requirement and their results."
|
|
4879
4926
|
},
|
|
4880
4927
|
"statusOverrides": {
|
|
4881
4928
|
"type": "array",
|
|
4882
4929
|
"items": {
|
|
4883
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4930
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/Status_Override"
|
|
4884
4931
|
},
|
|
4885
4932
|
"description": "Chronological history of all overrides applied to this requirement. Overrides are intentional changes to the compliance status and/or impact score (waivers, attestations, false positives, risk adjustments). Most recent override should be first in array. Preserves full audit trail."
|
|
4886
4933
|
},
|
|
4887
4934
|
"poams": {
|
|
4888
4935
|
"type": "array",
|
|
4889
4936
|
"items": {
|
|
4890
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.
|
|
4937
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/extensions/v3.7.0#/$defs/POAM"
|
|
4891
4938
|
},
|
|
4892
4939
|
"description": "Plan of Action and Milestones for tracking remediation, mitigation, or risk acceptance. POAMs do NOT change effectiveStatus - they track the work being done to address a failure. Separate from statusOverrides which DO change status."
|
|
4893
4940
|
},
|
|
4894
4941
|
"effectiveStatus": {
|
|
4895
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
4942
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Result_Status",
|
|
4896
4943
|
"description": "The current effective compliance status of this requirement after applying the most recent non-expired override with a status field, or computed from results (worst-wins) if no status-bearing overrides exist."
|
|
4897
4944
|
},
|
|
4898
4945
|
"effectiveImpact": {
|
|
@@ -4902,33 +4949,33 @@
|
|
|
4902
4949
|
"description": "The current effective impact score (0.0–1.0) after applying the most recent non-expired override with an impact field. Absent when no impact overrides apply; consumers should use the requirement's impact field in that case."
|
|
4903
4950
|
},
|
|
4904
4951
|
"disposition": {
|
|
4905
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.
|
|
4952
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/amendments/v3.7.0#/$defs/Override_Type",
|
|
4906
4953
|
"description": "The type of the most recent non-expired override or POAM governing this requirement. Indicates why the requirement is in its current state (e.g., waiver, falsePositive, riskAdjustment) or what remediation is being tracked (poam). Absent when no overrides or POAMs apply."
|
|
4907
4954
|
},
|
|
4908
4955
|
"effectiveChecksum": {
|
|
4909
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4956
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
4910
4957
|
"description": "Checksum of this requirement's resolved effective posture, for per-control change detection in continuous monitoring.\n\nsha256 over the canonical JSON object with keys status, impact, disposition (in that order), holding the resolved effective status, resolved effective impact, and governing override type (null when nothing governs), with override expiry anchored to the document timestamp.\n\nFlips exactly when the operative status, impact, or disposition changes; stable under all other churn (result details, timestamps, tags).\n\nOptional; stamped by tooling (hdf convert, hdf amend apply)."
|
|
4911
4958
|
},
|
|
4912
4959
|
"evidence": {
|
|
4913
4960
|
"type": "array",
|
|
4914
4961
|
"items": {
|
|
4915
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
4962
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Evidence"
|
|
4916
4963
|
},
|
|
4917
4964
|
"description": "Supporting evidence for this requirement's findings, such as screenshots, code samples, or log excerpts."
|
|
4918
4965
|
},
|
|
4919
4966
|
"cvss": {
|
|
4920
4967
|
"type": "array",
|
|
4921
4968
|
"items": {
|
|
4922
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.
|
|
4969
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/cvss/v3.7.0#/$defs/Cvss"
|
|
4923
4970
|
},
|
|
4924
4971
|
"description": "Structured CVSS scoring data for vulnerability findings. One entry per CVE — a finding may match multiple CVEs (common in vulnerability scanners). Captures vendor-supplied Base metrics plus optional consumer-owned Threat / Environmental / Supplemental groups for risk adjustment. See cvss.schema.json."
|
|
4925
4972
|
},
|
|
4926
4973
|
"epss": {
|
|
4927
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.
|
|
4974
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.7.0#/$defs/Epss",
|
|
4928
4975
|
"description": "FIRST.org EPSS (Exploit Prediction Scoring System) score for this CVE finding. Used alongside CVSS for prioritization — captures the probability the vulnerability will be exploited."
|
|
4929
4976
|
},
|
|
4930
4977
|
"kev": {
|
|
4931
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.
|
|
4978
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.7.0#/$defs/Kev",
|
|
4932
4979
|
"description": "CISA Known Exploited Vulnerabilities (KEV) catalog status. When inKev=true, dateAdded and dueDate carry the federal patching deadline."
|
|
4933
4980
|
},
|
|
4934
4981
|
"cwe": {
|
|
@@ -4942,7 +4989,7 @@
|
|
|
4942
4989
|
"affectedPackages": {
|
|
4943
4990
|
"type": "array",
|
|
4944
4991
|
"items": {
|
|
4945
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.
|
|
4992
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/affected-package/v3.7.0#/$defs/Affected_Package"
|
|
4946
4993
|
},
|
|
4947
4994
|
"description": "Packages affected by this vulnerability finding. Vulnerability-finding-scoped — see components[] on hdf-system for component-level package inventories. One entry per matched package signature (scanners often report multiple CPE variations per CVE)."
|
|
4948
4995
|
}
|
|
@@ -5231,9 +5278,9 @@
|
|
|
5231
5278
|
}
|
|
5232
5279
|
}
|
|
5233
5280
|
},
|
|
5234
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.
|
|
5281
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.7.0": {
|
|
5235
5282
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5236
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.
|
|
5283
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/statistics/v3.7.0",
|
|
5237
5284
|
"title": "HDF Statistics Primitives",
|
|
5238
5285
|
"description": "Statistics types for tracking assessment run metrics.",
|
|
5239
5286
|
"$defs": {
|
|
@@ -5302,9 +5349,9 @@
|
|
|
5302
5349
|
}
|
|
5303
5350
|
}
|
|
5304
5351
|
},
|
|
5305
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.
|
|
5352
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.7.0": {
|
|
5306
5353
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5307
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.
|
|
5354
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/runner/v3.7.0",
|
|
5308
5355
|
"title": "HDF Runner Primitive",
|
|
5309
5356
|
"description": "Information about the test execution environment where the security tool/scanner was executed.",
|
|
5310
5357
|
"$defs": {
|
|
@@ -5348,7 +5395,7 @@
|
|
|
5348
5395
|
"description": "The container instance identifier. Example: 'a1b2c3d4e5f6', 'security-scan-job-xyz123'. Can be a Docker container ID, Kubernetes pod name, or other container runtime identifier."
|
|
5349
5396
|
},
|
|
5350
5397
|
"operator": {
|
|
5351
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
5398
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Identity",
|
|
5352
5399
|
"description": "The identity of the person or system responsible for executing the test. This could be a human auditor manually completing a checklist, an automated CI/CD system, or a security tool. Optional field to support both automated and manual HDF generation."
|
|
5353
5400
|
}
|
|
5354
5401
|
},
|
|
@@ -5397,9 +5444,9 @@
|
|
|
5397
5444
|
}
|
|
5398
5445
|
}
|
|
5399
5446
|
},
|
|
5400
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.
|
|
5447
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.7.0": {
|
|
5401
5448
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5402
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.
|
|
5449
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/events/v3.7.0",
|
|
5403
5450
|
"title": "HDF Change Event Primitives",
|
|
5404
5451
|
"description": "Shared building blocks for HDF change-event wire documents. The envelope is entity-agnostic: hdf-requirement-change-event composes it today, and any future sibling event type (e.g. component change events — hdf-comparison already models componentDiffs alongside requirementDiffs) reuses it verbatim.",
|
|
5405
5452
|
"$defs": {
|
|
@@ -5453,7 +5500,7 @@
|
|
|
5453
5500
|
"priorChecksum": {
|
|
5454
5501
|
"oneOf": [
|
|
5455
5502
|
{
|
|
5456
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
5503
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum"
|
|
5457
5504
|
},
|
|
5458
5505
|
{
|
|
5459
5506
|
"type": "null"
|
|
@@ -5471,7 +5518,7 @@
|
|
|
5471
5518
|
"systemRef": "apptier.hdf-system.json",
|
|
5472
5519
|
"componentId": "6e0f2a3b-9c01-4d5e-8f7a-1b2c3d4e5f60",
|
|
5473
5520
|
"timestamp": "2026-07-22T14:03:11Z",
|
|
5474
|
-
"schemaRef": "https://mitre.github.io/hdf-libs/schemas/hdf-requirement-change-event/v3.
|
|
5521
|
+
"schemaRef": "https://mitre.github.io/hdf-libs/schemas/hdf-requirement-change-event/v3.7.0",
|
|
5475
5522
|
"priorChecksum": {
|
|
5476
5523
|
"algorithm": "sha256",
|
|
5477
5524
|
"value": "704f62b2d0803438ad6b7b9bab45e2c4f350b7344135a2a7f8ef986d98669021"
|
|
@@ -5525,7 +5572,7 @@
|
|
|
5525
5572
|
],
|
|
5526
5573
|
"properties": {
|
|
5527
5574
|
"effectiveStatus": {
|
|
5528
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.
|
|
5575
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/result/v3.7.0#/$defs/Result_Status",
|
|
5529
5576
|
"description": "The resolved effective compliance status at this point in the chain."
|
|
5530
5577
|
},
|
|
5531
5578
|
"effectiveImpact": {
|
|
@@ -5574,7 +5621,7 @@
|
|
|
5574
5621
|
"description": "URI to the seed snapshot document (relative path or absolute URL)."
|
|
5575
5622
|
},
|
|
5576
5623
|
"checksum": {
|
|
5577
|
-
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.
|
|
5624
|
+
"$ref": "https://mitre.github.io/hdf-libs/schemas/primitives/common/v3.7.0#/$defs/Checksum",
|
|
5578
5625
|
"description": "Checksum of the seed snapshot, REQUIRED: the derivation pins an immutable snapshot by content, not just location."
|
|
5579
5626
|
}
|
|
5580
5627
|
},
|
|
@@ -5623,9 +5670,9 @@
|
|
|
5623
5670
|
}
|
|
5624
5671
|
}
|
|
5625
5672
|
},
|
|
5626
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.
|
|
5673
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.7.0": {
|
|
5627
5674
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5628
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.
|
|
5675
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/parameter/v3.7.0",
|
|
5629
5676
|
"title": "HDF Parameter Primitives",
|
|
5630
5677
|
"description": "Input/parameter type definitions for typed, traceable configuration values that bridge governance prose and scanner automation.",
|
|
5631
5678
|
"$defs": {
|
|
@@ -5756,9 +5803,9 @@
|
|
|
5756
5803
|
}
|
|
5757
5804
|
}
|
|
5758
5805
|
},
|
|
5759
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.
|
|
5806
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.7.0": {
|
|
5760
5807
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5761
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.
|
|
5808
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/epss/v3.7.0",
|
|
5762
5809
|
"title": "HDF EPSS Primitive",
|
|
5763
5810
|
"description": "Type for representing FIRST.org's Exploit Prediction Scoring System (EPSS) data for a vulnerability. EPSS estimates the probability that a CVE will be exploited in the wild in the next 30 days. See https://www.first.org/epss/ for the underlying model and methodology.",
|
|
5764
5811
|
"$defs": {
|
|
@@ -5813,9 +5860,9 @@
|
|
|
5813
5860
|
}
|
|
5814
5861
|
}
|
|
5815
5862
|
},
|
|
5816
|
-
"https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.
|
|
5863
|
+
"https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.7.0": {
|
|
5817
5864
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
5818
|
-
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.
|
|
5865
|
+
"$id": "https://mitre.github.io/hdf-libs/schemas/primitives/kev/v3.7.0",
|
|
5819
5866
|
"title": "HDF Kev Primitives",
|
|
5820
5867
|
"description": "Types for representing CISA Known Exploited Vulnerabilities (KEV) catalog membership. The KEV catalog (https://www.cisa.gov/known-exploited-vulnerabilities-catalog) flags CVEs that are confirmed actively exploited in the wild and drives federal patching urgency under CISA Binding Operational Directive 22-01.",
|
|
5821
5868
|
"$defs": {
|