Find and address exposure
- Open Exposure and look for the version you need to investigate. The main list groups versions flagged for malware or a security-related registry withdrawal. Choose the repositories you need to review.
- Use Impact to see where a matching version appears in indexed scans or open pull requests. Check the version, branch or PR, and evidence link. Select What to do on the exposure to open the package page for that version.
- Replace or remove the affected version, regenerate and commit the lockfile, and run a new dependency scan on the affected branch. Recheck the inventory and the exposure after the new scan is indexed.
SUPPLY_CHAIN_MALWARE_DETECTED
to receive malware exposure events in your own tooling.
Investigate a malware campaign
Open Campaigns to see related packages and versions grouped into known malware campaigns. The list shows whether affected versions appear in repositories you can view or triggered a failed Supply Chain Intel check on a pull request.- Open a campaign and review Your exposure, when shown, for affected repositories and links to PR check evidence.
- Review the campaign’s packages or versions. Open a package and select the affected version to see the evidence and remediation guidance.
- Prioritize versions on active branches and review flagged PRs before merging.
SUPPLY_CHAIN_CAMPAIGN_VALIDATED for newly validated ZeroPath campaigns
and SUPPLY_CHAIN_CAMPAIGN_IMPACT for campaign versions found in default-branch
scans. See webhook setup.
Look up a package version
In Intel, enter a package and version in Package or advisory ID and press Enter. For example, search fornpm:lodash@4.17.21 or
pypi:requests@2.32.3. Confirm the version in the package header before
reading the verdict. Open Analysis or Advisories to review the evidence
and check Way out on the Overview when it’s available. Open Your usage
to see the versions of the package found in your repositories and pull requests.
Search for a malware advisory ID to open Impact. Review Where it is
for repository and version matches, and use Export CSV to share those
rows when there are matches.
Check dependency changes on GitHub
The ZeroPath Supply Chain Intel check evaluates newly introduced versions in supported npm and PyPI dependency files. It runs alongside your regular PR scan, so reviewers can see which package version matched a policy rule before merging.- In the repository’s pull request settings, enable Pull Request Scanning and Post Check Status. VCS checks must also be enabled for the repository.
- In Supply chain → Policy → Pull request check, turn on Check pull requests. Turn on Bot pull requests to cover dependency updates from services such as Dependabot and Renovate.
- Open or update a GitHub PR. Find the result in GitHub or under Intel → Pull requests. Open the check details to see the rule match and any dependency files the check could not resolve.
- To enforce the result before merge, make the posted check name required in your GitHub ruleset or branch protection settings.
package-lock.json, npm-shrinkwrap.json,
pnpm-lock.yaml, yarn.lock, Pipfile.lock, poetry.lock, and uv.lock.
When a supported manifest has no lockfile, the check can read versions
pinned in the manifest. Commit lockfiles to give the check the resolved
direct and transitive versions.
Set a policy and review exceptions
Open Supply chain → Policy → Rules to choose an organization preset (Low noise, Default, or Strict) and configure rules. Use Tag overrides or Repository overrides to scope rules to a subset of repositories. To change the policy, you need permission to edit the organization’s scanner settings.
If multiple rules match a version, the strongest action among hits without
an applicable exception determines that version’s result. Use
Pull request check to set how the check handles old intel and warnings.
Use Internal sources to identify your private package names or registries.
If you need to use a version the check flagged, follow the
GitHub exception instructions.
The matching rules determine whether exceptions are allowed and whether they
require approval. Review requests, active exceptions, and expiry dates in
Intel → Exceptions.