Skip to content

Add practical guidance for integrating security tools into CI workflows #1267

Description

@BhagyaC

The current page lists free application security tools for open source projects, including SAST, DAST, IAST, dependency analysis, code quality tools, secrets detection, and CI/CD security tools. It also lists GitHub code scanning as a free SAST option for open source projects that can use GitHub Actions and CodeQL.

The page would benefit from a short vendor-neutral section that explains how maintainers can introduce these tools into CI workflows and how they can move from default rules to project-specific checks.

Proposed addition

Add a section titled:

Integrating security tools into CI workflows

The section should explain:

  1. Security checks can run on pull requests and pushes.
  2. Maintainers can start with a small set of high-confidence checks.
  3. Projects can combine multiple tool categories over time:
    • SAST for source-code patterns.
    • SCA/dependency checks for vulnerable components.
    • Secrets detection for exposed credentials.
    • DAST for running web applications.
    • IaC and CI/CD checks for infrastructure and workflow configuration.
  4. Maintainers can later add custom rules or queries for project-specific risks.
  5. Custom checks should include documentation, tests, and clear rationale so future maintainers can review them.

Suggested minimal example

Add one short GitHub Actions example, such as a CodeQL code scanning workflow, and link to the official GitHub documentation for more detailed configuration.

The page should not duplicate full CodeQL, Semgrep, ZAP, or dependency scanning documentation. It should provide a short starting point and link to the relevant tool documentation.

Acceptance criteria

  • The new section stays vendor-neutral.
  • The new section explains how CI can run security checks on pull requests and pushes.
  • The new section maps existing OWASP tool categories to CI use cases.
  • The new section includes one minimal workflow example.
  • The new section links to official documentation for CodeQL custom queries, CodeQL query packs, Semgrep custom rules, and GitHub code scanning.
  • The section explains that custom rules and queries should be documented and tested.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions