Security levels

SLSA is organized into a series of levels that provide increasing supply chain security guarantees. This gives you confidence that software hasn’t been tampered with and can be securely traced back to its source.

This page is a descriptive overview of the SLSA levels and tracks, describing their intent. For the prescriptive requirements for each level, see Requirements. For a general overview of SLSA, see About SLSA.

Levels and tracks

SLSA levels are split into tracks. Each track has its own set of levels that measure a particular aspect of supply chain security. The purpose of tracks is to recognize progress made in one aspect of security without blocking on an unrelated aspect. Tracks also allow the SLSA spec to evolve: we can add more tracks without invalidating previous levels.

Track/Level	Requirements	Benefits
Build L0	(none)	(n/a)
Build L1	Attestation showing that the package was built as expected	Documentation, mistake prevention, inventorying
Build L2	Signed attestation, generated by a hosted build service	Reduced attack surface, weak tamper protection
Build L3	Hardened build service	Strong tamper protection

Note: The previous version of the specification used a single unnamed track, SLSA 1–4. For version 1.0 the Source aspects were removed to focus on the Build track. A Source track may be added in future versions.

Build track

The SLSA build track describes the level of protection against tampering during or after the build, and the trustworthiness of provenance metadata. Higher SLSA build levels provide increased confidence that a package truly came from the correct sources, without unauthorized modification or influence.

TODO: Add a diagram visualizing the following.

Summary of the build track:

Set project-specific expectations for how the package should be built.
Generate a provenance attestation automatically during each build.
Automatically verify that each package’s provenance meets expectations before allowing its publication and/or consumption.

What sets the levels apart is how much trust there is in the accuracy of the provenance and the degree to which adversaries are detected or prevented from tampering with the package. Higher levels require hardened builds and protection against more sophisticated adversaries.

Each ecosystem (for open source) or organization (for closed source) defines exactly how this is implemented, including: means of defining expectations, what provenance format is accepted, whether reproducible builds are used, how provenance is distributed, when verification happens, and what happens on failure. Guidelines for implementers can be found in the requirements.

Build L0: No guarantees

Summary: No requirements—L0 represents the lack of SLSA.
Intended for: Development or test builds of software that are built and run on the same machine, such as unit tests.
Requirements: n/a
Benefits: n/a

Build L1: Provenance exists

Summary

Package has a provenance attestation showing how it was built, and a downstream system automatically verifies that packages were built as expected. Prevents mistakes but is trivial to bypass or forge.

Intended for

Projects and organizations wanting to easily and quickly gain some benefits of SLSA—other than tamper protection—without changing their build workflows.

Requirements

Up front, the package producer defines how the package is expected to be built, including the canonical source repository and build command.
On each build, the release process automatically generates and distributes a provenance attestation describing how the artifact was actually built, including: who built the package (person or system), what process/command was used, and what the input artifacts were.
Downstream tooling automatically verifies that the artifact’s provenance exists and matches the expectation.

Benefits

Makes it easier for both producers and consumers to debug, patch, rebuild, and/or analyze the software by knowing its precise source version and build process.
Prevents mistakes during the release process, such as building from a commit that is not present in the upstream repo.
Aids organizations in creating an inventory of software and build systems used across a variety of teams.

Notes

Provenance may be incomplete and/or unsigned at L1. Higher levels require more complete and trustworthy provenance.

Build L2: Build service

Summary

Forging the provenance or evading verification requires an explicit “attack”, though this may be easy to perform. Deters unsophisticated adversaries or those who face legal or financial risk.

In practice, this means that builds run on a hosted service that generates and signs¹ the provenance.

Intended for

Projects and organizations wanting to gain moderate security benefits of SLSA by switching to a hosted build service, while waiting for changes to the build service itself required by Build L3.

Requirements

All of Build L1, plus:

The build runs on a hosted build service that generates and signs¹ the provenance itself. This may be the original build, an after-the-fact reproducible build, or some equivalent system that ensures the trustworthiness of the provenance.
Downstream verification of provenance includes validating the authenticity of the provenance attestation.

Benefits

All of Build L1, plus:

Prevents tampering after the build through digital signatures¹.
Deters adversaries who face legal or financial risk by evading security controls, such as employees who face risk of getting fired.
Reduces attack surface by limiting builds to specific build services that can be audited and hardened.
Allows large-scale migration of teams to supported build services early while further hardening work (Build L3) is done in parallel.

Build L3: Hardened builds

Summary

Forging the provenance or evading verification requires exploiting a vulnerability that is beyond the capabilities of most adversaries.

In practice, this means that builds run on a hardened build service that offers strong tamper protection.

Intended for

Most software releases. Build L3 usually requires significant changes to existing build services.

Requirements

All of Build L2, plus:

Build service implements strong controls to:
- prevent runs from influencing one another, even within the same project.
- prevent secret material used to sign the provenance from being accessible to the user-defined build steps.

Benefits

All of Build L2, plus:

Prevents tampering during the build—by insider threats, compromised credentials, or other tenants.
Greatly reduces the impact of compromised package upload credentials by requiring attacker to perform a difficult exploit of the build process.
Provides strong confidence that the package was built from the official source and build process.

Alternate means of verifying the authenticity of the provenance are also acceptable. ↩

‹ Terminology Producing artifacts ›