{
  "specFormat": "CycloneDX",
  "specVersion": "2.0",
  "$comment": "Generated by tools/build_perspectives.py from profile-deployment-disclosure.rules.json v0.2. Informative companion: the rules file is normative.",
  "metadata": {
    "timestamp": "2026-10-25T00:00:00Z"
  },
  "perspectives": [
    {
      "bom-ref": "perspective:deployment-disclosure",
      "name": "PKIC CBOM profile: Deployment Disclosure (Example) v0.2",
      "description": "For each interface of this deployment: which published weakness affects it, whether what the deployment permits and what it was seen to do match, and where the deployment falls short of what its products are capable of.",
      "domains": [
        "cryptographic-security"
      ],
      "mappings": [
        {
          "expression": "$.inventories[*].components[*]",
          "nativeName": "interface-disclosure#P1",
          "relevance": "required",
          "rationale": "Product declares at least one cryptographic interface"
        },
        {
          "expression": "$.inventories[*].components[*]",
          "nativeName": "interface-disclosure#P2",
          "relevance": "required",
          "rationale": "Product declares at least one management (configuration) interface, or states why it has none"
        },
        {
          "expression": "$.inventories[0].subject.identifiers",
          "nativeName": "interface-disclosure#P3",
          "relevance": "required",
          "rationale": "Document identifies the subject it describes"
        },
        {
          "expression": "$.compositions",
          "nativeName": "interface-disclosure#P4",
          "relevance": "required",
          "rationale": "Product states how complete its declared interface set is"
        },
        {
          "expression": "$.inventories[0].subject.properties[?(@.name=='pkic:profile:subjectType')]",
          "nativeName": "interface-disclosure#P5",
          "relevance": "required",
          "rationale": "Document declares which type of subject it describes, from the types the profile accepts"
        },
        {
          "expression": "$.metadata.lifecycles",
          "nativeName": "interface-disclosure#P6",
          "relevance": "required",
          "rationale": "Document declares one lifecycle stage, and every interface reports that stage"
        },
        {
          "expression": "$.externalReferences[?(@.type=='bom')]",
          "nativeName": "deployment-disclosure#P1",
          "relevance": "required",
          "rationale": "Document cites the documents it builds on, each by BOM-Link and hash"
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.type",
          "nativeName": "interface-disclosure#I1 protocol",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.version",
          "nativeName": "interface-disclosure#I2 protocolVersion",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I3 keyExchange",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I4 encryption",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I5 authentication",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:endpointRoles')]",
          "nativeName": "interface-disclosure#I6 endpointRoles",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:interfaceType')]",
          "nativeName": "interface-disclosure#I7 interfaceType",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.metadata.lifecycles",
          "nativeName": "interface-disclosure#I8 lifecycleStage",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.dependencies[*].provides",
          "nativeName": "interface-disclosure#I9 implementationPurl",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='related-crypto-material')].cryptoProperties.relatedCryptoMaterialProperties.securedBy",
          "nativeName": "interface-disclosure#I10 keyWrapping",
          "relevance": "required",
          "rationale": "Required when interfaceType is storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:defaultState')]",
          "nativeName": "interface-disclosure#I11 defaultState",
          "relevance": "recommended",
          "rationale": "Required when lifecycleStage is implemented."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:correspondsTo')]",
          "nativeName": "deployment-disclosure#I1 correspondsTo",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:observationMethod')]",
          "nativeName": "deployment-disclosure#I2 observationMethod",
          "relevance": "required",
          "rationale": "Required when lifecycleStage is observed."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:observedAt')]",
          "nativeName": "deployment-disclosure#I3 observedAt",
          "relevance": "required",
          "rationale": "Required when lifecycleStage is observed."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:peerInterface')]",
          "nativeName": "deployment-disclosure#I4 peerInterface",
          "relevance": "optional",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='sbom')])]",
          "nativeName": "interface-disclosure#R1 sbom",
          "relevance": "required",
          "rationale": "The SBOM of the same subject, as a BOM-Link with a hash. It is how a consumer reaches components the CBOM does not describe, and how a library named under I9 is placed in the dependency tree."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='vulnerability-statements')])]",
          "nativeName": "interface-disclosure#R2 vulnerability-statements",
          "relevance": "required",
          "rationale": "Where the producer publishes statements about whether this subject is affected by a vulnerability (VEX, CSAF VEX, or an exploitability statement). Either a fixed document, with a hash, or a feed or API, with its access protocol named. A producer that publishes none says so ('not-published'). Silence"
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='advisories')])]",
          "nativeName": "interface-disclosure#R3 advisories",
          "relevance": "recommended",
          "rationale": "Where third-party or vendor advisories about the subject and its libraries are published, with the access protocol named: a web page, a CSAF provider, the OSV API or the GitHub advisory API. A machine-readable endpoint lets a consumer query by the package URLs the CBOM already carries."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='security-contact')])]",
          "nativeName": "interface-disclosure#R4 security-contact",
          "relevance": "recommended",
          "rationale": "Where to report a weakness or request a fuller disclosure. The objective lists 'request a fuller disclosure from the producer' as a decision option; without a contact, that option has no address."
        },
        {
          "expression": "$.inventories[*].components[*].externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='configuration-guidance')])]",
          "nativeName": "interface-disclosure#R5 configuration-guidance",
          "relevance": "required",
          "rationale": "If a product states that the operator decides an algorithm, the interface points to where the operator decides it. 'deployment-defined' without this pointer tells the operator that the decision is theirs and not how to make it."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='design-intent')])]",
          "nativeName": "interface-disclosure#R6 design-intent",
          "relevance": "optional",
          "rationale": "A threat model or design document. This is where design intention is recorded now that 'intended' is not an accepted stage: as context the record points to, not as a stage it reports."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='configuration-source')])]",
          "nativeName": "deployment-disclosure#R1 configuration-source",
          "relevance": "required",
          "rationale": "The revision of the configuration the record was read from: a commit in the configuration repository, or the infrastructure code. Without it, drift between the configured and the observed record cannot be traced to a change. The URL should name an immutable revision."
        },
        {
          "expression": "$.inventories[*].components[*].externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='observation-evidence')])]",
          "nativeName": "deployment-disclosure#R2 observation-evidence",
          "relevance": "recommended",
          "rationale": "The evidence an observed value was taken from: a scan report, a sensor log extract, a query result. Withholdable, because evidence often carries internal addresses and is shared on request rather than published."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='data-register')])]",
          "nativeName": "deployment-disclosure#R3 data-register",
          "relevance": "recommended",
          "rationale": "Where the operator records what data each interface carries and how long it must stay confidential. These facts decide harvest-now-decrypt-later exposure and are excluded from the CBOM (base exclusions; Q36, Q37, Q45). The record points to the register; it does not carry it."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='issuer-policy')])]",
          "nativeName": "deployment-disclosure#R4 issuer-policy",
          "relevance": "optional",
          "rationale": "The certificate policy or practice statement of the CA that issues the deployment's certificates. The CA is an external dependency (pqc-migration-extended I9): an interface cannot present an ML-DSA chain before its CA issues one."
        }
      ],
      "externalReferences": [
        {
          "type": "documentation",
          "url": "https://pkic.github.io/cbom/methodology/profile.html"
        }
      ]
    }
  ]
}
