Skip to content

Commit 3a0e934

Browse files
docs: expand proactive SCA section — Trivy prerequisite and setup paths (#2690)
* docs: expand proactive SCA section — Trivy prerequisite, setup paths, and deep-link anchor Replaces the single-line Trivy note with a full explanation of how proactive SCA nightly scans work, what's required (Trivy tool + vulnerability patterns), both setup paths (coding standard / per-repo), and the silent failure case when only the tool is enabled. Adds a new H4 subsection with anchor #proactive-sca-requirements so Phase 2 CTAs (Dependency Explorer empty state OD-143, partial coverage banner OD-144) can deep-link directly to the prerequisite content. Closes OD-139 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: remove redundant admonition — requirements list is self-evident Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: rework SCA intro, remove inaccurate last sentence, add Dependencies cross-link - Lead with what SCA findings are (dependency vulnerabilities) before explaining the daily re-scan feature - Use "daily re-scans" (matches pricing page "Daily SCA and Malicious Package re-scans") and drop "nightly" / "every evening" inconsistency - Remove inaccurate closing sentence — nightly scans always run for SCA-enabled orgs; enabling Trivy makes them produce results, not start - Add cross-reference in the Dependencies section pointing to #proactive-sca-requirements so there's a path in both directions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: fix Business tier → business-tier (hyphen, consistent with rest of file) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: fold upgrade CTA inline, expand pattern list to sub-bullets Removes the orange Important admonition that was breaking the reading flow. The business-tier note is now a single inline sentence at the end of the daily re-scans paragraph. Pattern IDs moved to sub-bullets for readability. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: move Trivy requirements to Dependencies section, collapse SCA findings subsection SCA findings behave identically to other git findings — no separate lifecycle documentation needed. The unique part (daily re-scans + Trivy requirements) belongs with Dependencies, where an admin with an empty tab will look for help. - SCA findings subsection: collapsed to 2 sentences + link to #proactive-sca-requirements - Trivy requirements block: moved from H4 under Findings to H3 under Dependencies, anchor preserved for Phase 2 CTA deep-links (OD-143, OD-144) - Dependencies upgrade CTA: updated to use Knock link for consistency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: move page access instruction before requirements subsection Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Revert "docs: move page access instruction before requirements subsection" This reverts commit d5d6ad1. * docs: add 'Viewing your dependencies' heading before access sentence --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent e197922 commit 3a0e934

1 file changed

Lines changed: 22 additions & 10 deletions

File tree

docs/organizations/managing-security-and-risk.md

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -189,15 +189,9 @@ Codacy closes a finding in either of the following cases:
189189

190190
### How Codacy manages findings detected during software composition analysis (SCA) {: id="opening-and-closing-sca-items"}
191191

192-
!!! note
193-
To make sure that Codacy detects dependency issues correctly, [enable code patterns](../repositories-configure/configuring-code-patterns.md) belonging to the Trivy tool.
194-
195-
Vulnerable dependencies are a specific GIT repository finding. Similarly to other repository findings, Codacy opens an issue whenever a commit is analyzed.
192+
SCA findings behave like other Git repository findings. Codacy opens a finding whenever a commit to the default branch is analyzed and a vulnerable dependency is detected, and closes it when the dependency is no longer detected.
196193

197-
Additionally, Codacy scans your codebase every evening to see if it's affected by any newly discovered vulnerabilities.
198-
199-
!!! important
200-
The proactive SCA scanning is a business tier feature. If you are a Codacy Pro customer interested in upgrading to gain access to this feature, reach out to our customer success team.
194+
On the Business plan, Codacy also runs [daily re-scans](#proactive-sca-requirements) across all repositories — so newly discovered vulnerabilities are surfaced even without a new commit. [Talk to us](https://start-chat.com/slack/codacy/rmbTzb) if you're interested in upgrading.
201195

202196

203197
### How Codacy manages findings detected on Jira {: id="opening-and-closing-jira-items"}
@@ -569,10 +563,28 @@ Security and risk management supports checking the languages and infrastructure-
569563
## Dependencies {: id="dependencies-list"}
570564

571565
!!! important
572-
The dependency tab is a business-tier feature. If you are a Codacy Pro customer interested in upgrading to gain access to this feature, contact our customer success team.
566+
The dependency tab is a business-tier feature. If you are a Codacy Pro customer interested in upgrading to gain access to this feature, [talk to us](https://start-chat.com/slack/codacy/rmbTzb).
567+
568+
The **Security and risk management Dependencies** page displays a unified view of all dependencies used by your repositories, populated by Codacy's daily SCA re-scans.
569+
570+
### Daily re-scan requirements {: id="proactive-sca-requirements"}
571+
572+
Proactive SCA uses **Trivy** as its scanning tool. For daily re-scans to produce results on a repository, **both** conditions must be met:
573+
574+
1. The **Trivy tool** is enabled — either through a [coding standard](using-coding-standards.md) applied to the repository, or directly via the repository's [Code patterns settings](../repositories-configure/configuring-code-patterns.md).
575+
2. At least one **Trivy vulnerability pattern** is enabled:
576+
- `Trivy_vulnerability_critical`
577+
- `Trivy_vulnerability_high`
578+
- `Trivy_vulnerability_medium`
579+
- `Trivy_vulnerability_minor`
580+
- `Trivy_malicious_packages`
581+
582+
To enable Trivy across your organization, you can:
573583

584+
- **Recommended — via coding standard:** [Add Trivy to a coding standard](using-coding-standards.md), enable its vulnerability patterns in the standard configuration, and apply the standard to your repositories. This covers all linked repositories in one step.
585+
- **Per repository:** Open each repository's [Code patterns page](../repositories-configure/configuring-code-patterns.md), enable the Trivy tool, and enable the relevant vulnerability patterns.
574586

575-
The **Security and risk management Dependencies** page displays a unified view of all dependencies used by your repositories.
587+
### Viewing your dependencies
576588

577589
To access the dependencies page, access the [overview page](#dashboard) and click the **Dependencies** tab.
578590

0 commit comments

Comments
 (0)