{ "$schema": "http://json-schema.org/draft-04/schema#", "title": "PolicyExplainTrace", "type": "object", "additionalProperties": false, "properties": { "SchemaVersion": { "type": "string" }, "FindingId": { "type": "string" }, "PolicyId": { "type": "string" }, "PolicyVersion": { "type": "integer", "format": "int32" }, "TenantId": { "type": "string" }, "RunId": { "type": "string" }, "EvaluatedAt": { "type": "string", "format": "date-time" }, "Verdict": { "$ref": "#/definitions/PolicyExplainVerdict" }, "RuleChain": { "type": "array", "items": { "$ref": "#/definitions/PolicyExplainRule" } }, "Evidence": { "type": "array", "items": { "$ref": "#/definitions/PolicyExplainEvidence" } }, "VexImpacts": { "type": "array", "items": { "$ref": "#/definitions/PolicyExplainVexImpact" } }, "History": { "type": "array", "items": { "$ref": "#/definitions/PolicyExplainHistoryEvent" } }, "Metadata": { "type": "object", "additionalProperties": { "type": "string" } } }, "definitions": { "PolicyExplainVerdict": { "type": "object", "additionalProperties": false, "properties": { "Status": { "$ref": "#/definitions/PolicyVerdictStatus" }, "Severity": { "oneOf": [ { "type": "null" }, { "$ref": "#/definitions/SeverityRank" } ] }, "Quiet": { "type": "boolean" }, "Score": { "type": [ "null", "number" ], "format": "double" }, "Rationale": { "type": [ "null", "string" ] } } }, "PolicyVerdictStatus": { "type": "integer", "description": "", "x-enumNames": [ "Passed", "Warned", "Blocked", "Quieted", "Ignored" ], "enum": [ 0, 1, 2, 3, 4 ] }, "SeverityRank": { "type": "integer", "description": "", "x-enumNames": [ "None", "Info", "Low", "Medium", "High", "Critical", "Unknown" ], "enum": [ 0, 1, 2, 3, 4, 5, 6 ] }, "PolicyExplainRule": { "type": "object", "additionalProperties": false, "properties": { "RuleId": { "type": "string" }, "RuleName": { "type": "string" }, "Action": { "type": "string" }, "Decision": { "type": "string" }, "Score": { "type": "number", "format": "double" }, "Condition": { "type": [ "null", "string" ] } } }, "PolicyExplainEvidence": { "type": "object", "additionalProperties": false, "properties": { "Type": { "type": "string" }, "Reference": { "type": "string" }, "Source": { "type": "string" }, "Status": { "type": "string" }, "Weight": { "type": "number", "format": "double" }, "Justification": { "type": [ "null", "string" ] }, "Metadata": { "type": "object", "additionalProperties": { "type": "string" } } } }, "PolicyExplainVexImpact": { "type": "object", "additionalProperties": false, "properties": { "StatementId": { "type": "string" }, "Provider": { "type": "string" }, "Status": { "type": "string" }, "Accepted": { "type": "boolean" }, "Justification": { "type": [ "null", "string" ] }, "Confidence": { "type": [ "null", "string" ] } } }, "PolicyExplainHistoryEvent": { "type": "object", "additionalProperties": false, "properties": { "Status": { "type": "string" }, "OccurredAt": { "type": "string", "format": "date-time" }, "Actor": { "type": [ "null", "string" ] }, "Note": { "type": [ "null", "string" ] } } } } }