TL;DR: Knowledge base lookups are fast but can miss embedded copyleft obligations, while source code analysis is slower but produces audit-grade license evidence, according to FOSSA. For teams distributing software, the trade-off is not convenience versus perfection but whether compliance controls reflect the full reality of the codebase.
Editorial analysis by NHI Mgmt Group, based on content published by FOSSA: “How Open Source License Scanners Work”.
Key questions
Q: How should teams choose between metadata-only and source-level license scanning?
A: Choose based on distribution risk.
Q: Why can license scanners miss copyleft obligations in open source dependencies?
A: They miss them when the scanner trusts package registries or manifests more than the actual artifact.
Q: What are the signs that a license compliance program is too shallow?
A: Common signs include frequent surprises during release review, unexplained NOTICE file changes, repeated manual corrections, and license findings that appear only after source inspection.
Practitioner guidance
- Prefer source-level license detection for distributed products Use direct code analysis as the default for software that leaves the organisation, so hidden license text and vendored code are discovered before release.
- Treat metadata-only scans as incomplete evidence Reserve knowledge base lookup for low-risk internal projects or as a fallback when source is unavailable, and document the limitation in compliance records.
- Build triage workflows for multi-license findings Require legal or compliance review for components that surface more than one applicable license, and keep the decision trail with the build record.
Bottom line: Open source license compliance fails when teams rely on declared package metadata instead of the actual shipped code.
Explore further
View Full Forum → | NHI Foundation Course → | Our Services → | Read the full analysis →
Metadata-only license detection creates a compliance blind spot when the obligation lives in the code, not the registry. License governance fails when organisations equate declared package metadata with the full legal state of the dependency. That assumption is attractive because it is fast and scalable, but it is wrong whenever vendored code, embedded text, or copied source changes the obligation set. The practitioner conclusion is simple: speed is useful, but it cannot be the only control where software is distributed.
A few things that frame the scale:
- Software supply chain attacks were projected to cost organisations $60 billion in 2025.
A question worth separating out:
Q: How can organisations keep license scanning defensible without drowning in false positives?
A: Use a review workflow that records why a finding was accepted, dismissed, or escalated. The goal is not to eliminate every extra match, but to preserve traceability so a later audit can explain how each material license decision was made and by whom.
👉 Read our full editorial: License detection methods shape open source compliance risk