Skip to content

docs: rewrite code validation around GitHub security features, OSV-Scanner and OpenSSF - #479

Merged
TheJuanAndOnly99 merged 8 commits into
finos:mainfrom
TheJuanAndOnly99:cursor/replace-archived-code-scanning-refs-afa7
Nov 19, 2026
Merged

TheJuanAndOnly99 merged 8 commits into
finos:mainfrom
TheJuanAndOnly99:cursor/replace-archived-code-scanning-refs-afa7

Conversation

@TheJuanAndOnly99

Copy link
Copy Markdown
Member

The code validation docs still pointed projects at the archived finos/code-scanning repository, the retired metadata-tool scan, and vendor tools FINOS no longer uses (WhiteSource/Mend, Coverity Scan, SonarCloud, CodeClimate and Sonatype Lifecycle). This PR rewrites the page around GitHub's built-in security features, OSV-Scanner, and OpenSSF recommendations. These tools are free for public repositories, and maintainers can turn them on without asking FINOS for a third-party account.

Code validation page

docs/development-infrastructure/code-validation/intro.md

  • Security baseline: a table of the OSPS Baseline maturity level required at each lifecycle stage (Labs 1, Incubating 2, Graduated 3), matching the lifecycle pages. It names the Baseline controls these tools help meet: MFA and branch protection (OSPS-AC), keeping secrets out of version control (OSPS-BR-07), private vulnerability reporting (OSPS-VM-03), and automated SCA/SAST checks on changes (OSPS-VM-05, OSPS-VM-06).
  • Recommended tools, replacing the old per-language vendor matrix:
    • GitHub: dependency graph; Dependabot alerts, security updates and version updates; CodeQL code scanning (default setup); secret scanning with push protection; the dependency review action, which blocks PRs that add vulnerable dependencies or licenses outside an allow-list; private vulnerability reporting and repository security advisories.
    • OSV-Scanner: the PR and scheduled reusable workflows.
    • OpenSSF: Scorecard and the Best Practices Badge.
  • Removed the "Project compliance scan" section, which documented the archived metadata-tool (has-admin, no-whitesource, …).
  • Contributor sign-off now points to DCO (the default, enforced by DCO2) and to EasyCLA for projects that use a CLA.

Removed tool pages

  • Deleted the WhiteSource, Coverity Scan, SonarCloud, CodeClimate and Sonatype Lifecycle pages, their images and their sidebar entries.
  • Added client redirects from the old URLs to the code validation page, so existing links keep working.
  • Removed the whitesourcesoftware.com entry from .lycheeignore.

Other references updated

  • docs/collaboration-infrastructure.mdx: the "Security Scanning" and "Automated and continuous quality scanning" sections now point to the GitHub, OSV-Scanner and OpenSSF tools instead of finos/code-scanning.
  • docs/finos-maintainer-cheatsheet.mdx: the Security row linked the WhiteSource page ("Use the FINOS Open Developer Platform for Project Security Vulnerability Scanning"). It now links the code validation page.
  • docs/journey/Consume.md: the "security scanning" link pointed at the WhiteSource page.
  • docs/development-infrastructure/continuous-integration/intro.mdx: removed WhiteSource from the vendor list.
  • docs/development-infrastructure/project-documentation.mdx: the relative-link example no longer uses (whitesource).

Not changed

  • The Maven Central and issues.sonatype.org references are about publishing Java artifacts, not Sonatype Lifecycle.
  • The wider Open Developer Platform wording in the CI docs is left for a separate PR.

Testing

  • docusaurus build passes. The only broken-anchor warnings were there before this PR (two in cve-responsible-disclosure, one in Lead.md).

Sources

cursoragent and others added 7 commits November 17, 2026 22:09
Replace references to the archived FINOS Code Scanning repository
(https://github.com/finos/code-scanning) with GitHub's native security
tools and OSV-Scanner:

- GitHub CodeQL for code vulnerability scanning
- Dependabot for dependency vulnerability alerts and updates
- GitHub dependency graph for supply chain visibility
- OSV-Scanner for open source vulnerability detection

Files changed:
- docs/collaboration-infrastructure.mdx (lines 291, 351)
- docs/development-infrastructure/code-validation/intro.md (lines 22-23)

Note: docs/project-support-guidelines.md also contains references but is
being deleted in a separate PR.

Co-authored-by: Juan Estrella <TheJuanAndOnly99@users.noreply.github.com>
Per maintainer feedback, FINOS does not use WhiteSource (Mend) or
Coverity Scan. Remove these from the Security rows (lines 22-23)
that were updated in this PR.

The Security section now lists only:
- GitHub CodeQL, SonarCloud, CodeClimate for code scanning
- Dependabot and OSV-Scanner for library vulnerability scanning

Co-authored-by: Juan Estrella <TheJuanAndOnly99@users.noreply.github.com>
Per maintainer feedback, FINOS does not use SonarCloud or CodeClimate.
Remove these from line 22 (Scans code for security vulnerabilities).

The Security section now lists only GitHub's native tools:
- GitHub CodeQL for code scanning
- Dependabot and OSV-Scanner for library vulnerability scanning

Co-authored-by: Juan Estrella <TheJuanAndOnly99@users.noreply.github.com>
- Rewrite the code validation page: recommend GitHub dependency graph,
  Dependabot, CodeQL, secret scanning and the dependency review action,
  plus OSV-Scanner, OpenSSF Scorecard and the Best Practices badge.
  Map them to the OSPS Baseline levels required per lifecycle stage.
- Remove the retired metadata-tool compliance scan section and point
  contributor sign-off at DCO (default) and EasyCLA.
- Delete the WhiteSource (now Mend), Coverity Scan, SonarCloud,
  CodeClimate and Sonatype Lifecycle pages and images, which FINOS no
  longer uses, and redirect their URLs to the code validation page.
- Update the maintainer cheatsheet security link and the collaboration
  infrastructure scanning sections.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Removed redundant information about requesting third-party accounts for code validation tools.
Updated the link for FINOS approved licenses in the dependency review action section.
@netlify

netlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for eager-borg-83c1a5 ready!

Name Link
🔨 Latest commit 844b1f6
🔍 Latest deploy log https://app.netlify.com/projects/eager-borg-83c1a5/deploys/6afdb9eda9b7d4850f80ae72
😎 Deploy Preview https://deploy-preview-479--eager-borg-83c1a5.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

The link was relative and lowercased, so Docusaurus resolved it under
the code validation page and failed the build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Juan Estrella <juan.estrella@finos.org>
@TheJuanAndOnly99
TheJuanAndOnly99 merged commit 04550dc into finos:main Nov 19, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants