Skip to content

Commit 2fa0a09

Browse files
authored
[K9CODESEC-1666] Document lockfile-less SCA scanning (#37555)
* Document lockfile-less SCA scanning for package.json and pyproject.toml * Clarify lockfile precedence and version selection * Manifests can declare ranges, not always
1 parent a4eaf3e commit 2fa0a09

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

  • content/en/security/code_security/software_composition_analysis/setup_static

content/en/security/code_security/software_composition_analysis/setup_static/_index.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,23 @@ Datadog SCA scans libraries in the following languages using dependency manifest
4343

4444
**Note:** If both a `packages.lock.json` and a `.csproj` file are present, the `packages.lock.json` takes precedence and provides more precise version resolution.
4545

46+
## Lockfile-less scanning
47+
48+
Datadog SCA scans manifest files **only when no supported lockfile is detected**. When a lockfile is present, it takes precedence and the manifest is not scanned.
49+
50+
| Language | Package Manager | File |
51+
|----------|------------------------|------------------|
52+
| Node.js | npm, yarn, pnpm, Bun | `package.json` |
53+
| Python | Poetry, PDM, UV, pip | `pyproject.toml` |
54+
55+
**Supported sections:**
56+
- `package.json`: `dependencies`, `devDependencies`, and `optionalDependencies`
57+
- `pyproject.toml`: PEP 621 `dependencies` and `optional-dependencies`, PEP 735 `dependency-groups`, and Poetry dependency sections
58+
59+
<div class="alert alert-info">
60+
Because manifests can declare version ranges (such as <code>^2.3.4</code> or <code>&gt;=1.0,&lt;2</code>) rather than pinned versions, Datadog resolves each range by selecting the newest published version that satisfies the range. Pre-release versions are excluded.
61+
</div>
62+
4663
## Select where to run static SCA scans
4764
By default, scans run when you commit changes that update supported dependency manifests or lockfiles in an enabled repository. You can also run SCA in your CI pipelines; CI jobs are supported for `push` events.
4865

0 commit comments

Comments
 (0)