Join our Newsletter — 33% off our NHI Course

GUAC (Graph for Understanding Artifact Composition)

GUAC is a way to map how software artifacts are built from other components, so teams can see what is inside a system and where risk may enter. Technically, it models dependencies as a graph across packages, images, artifacts, and related metadata, supporting vulnerability analysis and supply chain review.

What GUAC Measures in Software Supply Chains

GUAC is a graph model for understanding how software artifacts are composed, linked, and reused across a system. Its value is visibility: teams can trace where components came from, how they relate, and where risk may enter through dependency chains or inherited metadata.

That makes GUAC less about a single tool output and more about a data model for software composition intelligence. It helps answer questions such as which image contains which packages, which artifact depends on another, and whether a risk in one component may propagate into others.

Why Composition Graphs Matter for Security Review

Software supply chains are hard to assess with flat inventories because the interesting risk often sits in the relationships, not just the assets themselves. A composition graph helps security teams reason about transitive dependencies, repeated components, and the blast radius of vulnerable or untrusted inputs.

GUAC is especially useful when organisations need to connect build outputs, container images, package metadata, and provenance-like records into one view. That kind of linkage supports faster review of what is actually inside a deliverable, rather than what a manifest or ticket claims is inside it.

For readers who want the broader supply-chain integrity context, SLSA defines the provenance and integrity expectations that GUAC-style composition analysis helps observe and verify.

How GUAC Supports Vulnerability Analysis

GUAC does not eliminate vulnerabilities, but it improves the ability to find and reason about them in context. When an issue lands in one package or artifact, the graph can show which higher-level systems inherit that exposure and which downstream components may need attention.

This is important because modern software often reuses the same libraries, base images, and build materials across many products. A composition graph can reveal that one disclosure or vulnerable dependency is not an isolated issue, but part of a much larger security pattern.

It also supports review of artifact metadata that can affect trust, such as build provenance, component origin, and dependency relationships. That is where GUAC becomes useful for both vulnerability management and supply chain assurance.

Where GUAC Fits in Supply Chain Operations

In practice, GUAC sits between raw artifact data and decision-making. It helps security, platform, and development teams ask better questions about exposure, ownership, and remediation priority, especially when many components are changing at once.

Used well, it supports inventory accuracy, dependency tracing, and governance over what gets promoted, deployed, or accepted into a release. That makes it valuable for organisations that need repeatable answers to “what is this made of?” and “what else is affected if this changes?”

It is most effective when paired with reliable upstream metadata and consistent artifact collection. A graph can only illuminate composition if the underlying data sources are complete enough to describe the system accurately.

Risk and Threat Considerations

Composition graphs expose how much an organisation depends on shared software parts, which means they also expose where compromise or vulnerable reuse can spread. If the graph is incomplete or stale, teams may miss a critical transitive dependency, underestimate blast radius, or trust an artifact whose origin is weaker than it appears.

Failure mechanism: Attackers or defective build inputs exploit hidden dependency chains, reused components, or weak provenance to slip risk into multiple downstream artifacts at once.

Impact: Exposure can scale quickly across products, images, and services, making triage slower and remediation broader than expected.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

SLSA, NIST CSF 2.0 and NIST SP 800-53 Rev 5 set the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
SLSA Supply-chain Levels for Software Artifacts GUAC maps artifact composition and provenance used in software supply-chain integrity.
Recommendation — Use SLSA to verify provenance and integrity for artifacts represented in the graph.
NIST CSF 2.0 ID.AM-01 — Physical devices and systems within the organization are inventoried GUAC improves inventory and dependency visibility across software artifacts and components.
PR.DS-08 — Integrity of software, firmware, and information is verified GUAC supports integrity review by exposing how artifacts are assembled and related.
Recommendation — Inventory artifact dependencies so composition data stays complete and current. Verify artifact integrity using composition evidence before release.
NIST SP 800-53 Rev 5 CM-8 — System Component Inventory GUAC supports a component inventory across packages, images, artifacts, and metadata.
SA-10 — Developer Configuration Management GUAC aids supply-chain review of software components and build inputs.
Recommendation — Maintain a component inventory that includes artifact relationships and dependencies. Track software composition and build inputs under configuration management.