A pre-installation check is a control that evaluates a package before it is added to a project or build pipeline. It helps prevent malware, known vulnerabilities, typosquats, and abandoned dependencies from entering software systems. For agentic workflows, it is a critical boundary because it stops bad choices early.
Expanded Definition
A pre-installation check is a policy and inspection step that evaluates a package before it is admitted into a build, deployment, or agent workflow. In NHI security, the term matters because packages often carry scripts, hooks, dependencies, and transitive components that can inherit execution paths or access to secrets.
Definitions vary across vendors, because some tools use the phrase to describe malware scanning only, while others include signature verification, provenance checks, license policy, and dependency health. In practice, a rigorous pre-installation check sits closer to supply chain admission control than to simple antivirus, and it is often implemented alongside the NIST Cybersecurity Framework 2.0 principles for protecting software supply chains.
For agentic systems, the boundary is especially important because an AI agent can install, update, or invoke tools quickly enough to turn one bad package into broad execution risk. The most common misapplication is treating the check as a one-time scanning event, which occurs when teams inspect artifacts after download instead of enforcing admission before install.
Examples and Use Cases
Implementing pre-installation checks rigorously often introduces latency and false positives, requiring organisations to weigh pipeline speed against stronger supply chain assurance.
- Blocking a package that matches a known malicious hash before it is allowed into a CI pipeline, preventing downstream build compromise.
- Rejecting a typosquatted dependency that mimics a trusted library name, a risk pattern that pairs naturally with the controls described in Ultimate Guide to NHIs.
- Requiring provenance or signature verification before an agent installs a tool, aligning package admission with NIST Cybersecurity Framework 2.0 supply chain expectations.
- Checking for abandoned dependencies with no maintainer activity, especially when those dependencies may be used by service accounts or build bots that hold secrets.
- Stopping a package whose post-install scripts would request broad filesystem or network access that the agent does not need for its task.
Why It Matters in NHI Security
Pre-installation checks reduce the chance that a non-human identity, build runner, or agent inherits malicious code before it ever executes. That matters because NHI environments already face severe exposure: NHI Mgmt Group reports that 79% of organisations have experienced secrets leaks, and 77% of those incidents caused tangible damage, according to the Ultimate Guide to NHIs.
The control also supports governance by shrinking the number of packages that can introduce hidden credential theft, dependency confusion, or automated lateral movement. In NHI operations, even one compromised package can become an entry point for API keys, service tokens, or agent tool access. That is why pre-installation checks should be treated as an enforcement point, not a documentation step, and why they should be paired with inventory and review processes consistent with the broader guidance in Ultimate Guide to NHIs.
Organisations typically encounter the full impact only after a build system has already pulled a hostile dependency or an agent has installed an untrusted tool, at which point pre-installation checks become operationally unavoidable to address.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Non-Human Identity Top 10 and OWASP Agentic AI Top 10 address the attack and risk surface, while NIST CSF 2.0, NIST Zero Trust (SP 800-207) and NIST AI RMF set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| OWASP Non-Human Identity Top 10 | NHI-01 | Package admission controls reduce supply chain risk for NHI-driven automation. |
| OWASP Agentic AI Top 10 | A-03 | Agent tool and package trust decisions are part of secure agent execution boundaries. |
| NIST CSF 2.0 | PR.DS-6 | Software supply chain protections align with secure acquisition and integrity safeguards. |
| NIST Zero Trust (SP 800-207) | SI | Zero trust demands explicit verification before software is trusted or executed. |
| NIST AI RMF | AI risk management includes controlling inputs and tools that can affect agent behavior. |
Add admission checks to pipeline controls so untrusted packages never reach production systems.
Related resources from NHI Mgmt Group
- Why do attackers often check model availability before trying to generate content?
- What is the difference between pre-deployment scanning and runtime protection?
- When does pre-commit scanning add the most value for NHI governance?
- When does pre-commit scanning make more sense than pre-push scanning?
Deepen Your Knowledge
Reviewed and updated by the NHIMG editorial team on August 28, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org