Join our Newsletter — 33% off our NHI Course
Home› Glossary› Cyber Security› Image Layers
Cyber Security

Image Layers

← Back to Glossary
By NHI Mgmt Group Updated November 1, 2026 Domain: Cyber Security

Image layers are the stacked filesystem and metadata changes that form a container image during build. Anything written into a layer can persist even if later deleted in the Dockerfile. That makes layers a common place where secrets survive, especially when build steps expose credentials before final packaging.

What image layers are and why they matter

Container image layers are not just a build convenience, they are the record of how an image was assembled. Each layer can preserve filesystem state and metadata from an earlier step, so the final image may still contain material that a later instruction appears to remove.

That persistence is why layers matter for security. If a build step writes a credential, private key, token, or other secret into the filesystem, the value can remain recoverable in the layer history even after the Dockerfile deletes the file in a later step.

How layer persistence creates secret exposure

The core problem is that deletion in a later layer does not rewrite the earlier one. Whiteout markers and filesystem overlay behaviour hide content from the running container, but they do not erase the underlying bytes from the image itself. As a result, anyone who can inspect, pull, or unpack the image may recover sensitive material that should never have been baked in.

This is especially dangerous when builds use arguments, environment variables, shell expansions, copied config files, or temporary credential files. Even if the final runtime container looks clean, the intermediate layers may still expose secrets through the image tarball, registry artifact, or local cache.

Common ways image layers retain sensitive material

Secrets typically survive when build steps place them into files, logs, package caches, or generated artefacts that become part of a layer. Examples include copying a private key during build, using a secret in a command that writes output to disk, or leaving dependency managers with cached auth material inside the image context.

Multi-stage builds reduce this risk when they keep secret-bearing steps out of the final stage, but they are not a guarantee by themselves. If a secret appears in any stage that is published, cached, or retained in a registry, it may still be exposed later. The security question is therefore not only what the running image contains, but what every build layer contains.

Why image-layer hygiene is part of container security

Image-layer hygiene sits at the intersection of build security, registry security, and release hygiene. A secure image is not only minimal and signed, it is also free of unintended secret history and unnecessary build residue. That is why container guidance treats layers, registries, and build artefacts as a single risk surface, not as separate problems.

For broader container hardening and registry controls, Container Image Security Guide covers the adjacent controls that help keep image content trustworthy, while Secrets in Container Images and Build Artefacts Guide focuses on how secrets persist in layers and how to prevent them from surviving the build. For a concrete breach pattern, Secrets in Docker Hub images (RWTH Aachen study) illustrates why leaked keys in images remain a real exposure class.

Risk and Threat Considerations

Image layers create a durable exposure path because they preserve earlier filesystem state even when the final image appears clean. That means a single build mistake can leave long-lived secrets in a registry, a cache, or a deployed image, where they may be recovered by internal users, external attackers, or anyone with artifact access.

Failure mechanism: A secret is written into a build layer, later deleted or overwritten in a subsequent step, and remains recoverable from the earlier layer, cache, or exported image history.

Impact: The exposed material can enable account compromise, API abuse, registry access, infrastructure access, or lateral movement, and it may require rotation of the affected credentials, tokens, keys, or certificates.

Standards & Framework Alignment

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

NIST SP 800-53 Rev 5, CIS Controls v8, OWASP ASVS and SLSA set the governance and control requirements practitioners need to meet.

FrameworkControl / ReferenceRelevance
NIST SP 800-53 Rev 5IA-5 — Authenticator ManagementImage layers can retain credentials and keys that require lifecycle control.
SC-28 — Protection of Information at RestPersisted layer data is stored artefact content that may expose sensitive material.
Recommendation — Rotate and revoke any secret that may have been written into a layer. Protect stored image artefacts and caches so secret material is not recoverable.
CIS Controls v8CIS-3 — Data ProtectionLayer residue can preserve sensitive data inside build artefacts and images.
Recommendation — Minimize sensitive data in images and remove exposed artefacts from the pipeline.
OWASP ASVSV14 — Data ProtectionBuild artefacts and images can retain sensitive data that should not persist.
Recommendation — Prevent secrets from being written into build outputs and retained image layers.
SLSASupply-chain Levels for Software ArtifactsImage layers are part of artifact provenance and build integrity concerns.
Recommendation — Record and verify build provenance so secret-bearing layers are not published.

Practitioner Guidance

Why practitioners should care: Treat layer content as part of the security boundary, not just the final container filesystem. If a secret ever enters the build context, a layer, or a cached artefact, assume it may need to be replaced even if the image now runs correctly.

Practitioner takeaway: Build processes should be designed so secrets are injected only for the minimum necessary step and never become part of a persisted layer history.

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.

NHIMG Editorial Note
Reviewed and updated by the NHIMG editorial team on November 1, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org