Pin Semgrep CI image by digest and scope security-events to the upload job (CWE-829) #164
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # Name of this GitHub Actions workflow. | |
| name: Semgrep | |
| on: | |
| # Scan changed files in PRs (diff-aware scanning): | |
| # The branches below must be a subset of the branches above | |
| pull_request: | |
| branches: ["master", "main"] | |
| push: | |
| branches: ["master", "main"] | |
| schedule: | |
| - cron: '0 6 * * *' | |
| permissions: | |
| contents: read | |
| jobs: | |
| semgrep: | |
| # User definable name of this GitHub Actions job. | |
| # This job runs third-party code (the Semgrep container), so it is granted | |
| # `contents: read` only. SARIF upload — which needs `security-events: write` — is | |
| # deliberately isolated in the `upload-sarif` job below, so a compromised image | |
| # cannot write to the repository's code-scanning dashboard. | |
| permissions: | |
| contents: read # for actions/checkout to fetch code | |
| name: semgrep/ci | |
| # If you are self-hosting, change the following `runs-on` value: | |
| runs-on: ubuntu-latest | |
| container: | |
| # A Docker image with Semgrep installed. Do not change this. | |
| # Pinned by immutable digest, not by tag: a tag (even a version tag) can be | |
| # re-pointed at new content upstream, which would silently execute unreviewed | |
| # third-party code in this runner on the next scheduled run. | |
| # Digest below == returntocorp/semgrep:1.166.0 (multi-arch index, pushed 2026-06-11). | |
| # To refresh the pin (and update this comment): | |
| # docker manifest inspect returntocorp/semgrep:<version> -v | grep -m1 Digest | |
| image: returntocorp/semgrep@sha256:c180f0c93a17b420c0af5006214a29d3c747c5459c732b740191adf657dd0068 | |
| # Skip any PR created by dependabot to avoid permission issues: | |
| if: (github.actor != 'dependabot[bot]') | |
| steps: | |
| # Fetch project source with GitHub Actions Checkout. | |
| - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9 # v3.5.3 | |
| # Run the "semgrep ci" command on the command line of the docker image. | |
| - run: semgrep ci --sarif --output=semgrep.sarif | |
| env: | |
| # Add the rules that Semgrep uses by setting the SEMGREP_RULES environment variable. | |
| SEMGREP_RULES: p/default # more at semgrep.dev/explore | |
| # Hand the SARIF to the upload job as an artifact. `semgrep ci` exits non-zero when | |
| # it has blocking findings, so this must run even on failure. | |
| - name: Upload SARIF as a workflow artifact | |
| uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2 | |
| with: | |
| name: semgrep-sarif | |
| path: semgrep.sarif | |
| if-no-files-found: error | |
| if: always() | |
| # Separate job so that `security-events: write` is never held by the job running the | |
| # third-party Semgrep image. This job runs no third-party code beyond first-party | |
| # GitHub actions, all digest-pinned. | |
| upload-sarif: | |
| name: Upload SARIF to GitHub Advanced Security Dashboard | |
| needs: semgrep | |
| if: always() && (github.actor != 'dependabot[bot]') | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: read | |
| security-events: write # for github/codeql-action/upload-sarif to upload SARIF results | |
| steps: | |
| - name: Download SARIF artifact | |
| uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0 | |
| with: | |
| name: semgrep-sarif | |
| - name: Upload SARIF file for GitHub Advanced Security Dashboard | |
| uses: github/codeql-action/upload-sarif@6c089f53dd51dc3fc7e599c3cb5356453a52ca9e # v2.20.0 | |
| with: | |
| sarif_file: semgrep.sarif |