litellm/.github/workflows/codeql.yml

name: "CodeQL"

on:
  pull_request:
    branches: [main]
  schedule:
    # Run daily at 04:00 UTC
    - cron: "0 4 * * *"

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

jobs:
  analyze:
    if: github.event_name != 'schedule' || github.repository == 'BerriAI/litellm'
    name: Analyze (${{ matrix.language }})
    runs-on: ubuntu-latest
    timeout-minutes: 30
    permissions:
      security-events: write
      packages: read
      actions: read
      contents: read

    strategy:
      fail-fast: false
      matrix:
        include:
          - language: actions
            build-mode: none
          - language: javascript-typescript
            build-mode: none
          - language: python
            build-mode: none

    steps:
      - name: Checkout repository
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

      - name: Initialize CodeQL
        uses: github/codeql-action/init@6f2ac81f5cd81fe351a197ba0b00d91d03cd2aee # v4.39.0
        with:
          languages: ${{ matrix.language }}
          build-mode: ${{ matrix.build-mode }}
          config-file: ./.github/codeql/codeql-config.yml
          queries: ${{ github.event_name == 'pull_request' && '+security-extended' || '' }}

      - name: Perform CodeQL Analysis
        uses: github/codeql-action/analyze@6f2ac81f5cd81fe351a197ba0b00d91d03cd2aee # v4.39.0
        with:
          category: "/language:${{ matrix.language }}"
          output: sarif-results
          upload: failure-only

      # py/weak-sensitive-data-hashing (CWE-328) fires on the OCI signing call at
      # litellm/llms/oci/common_utils.py, which hashes the HTTP request body to
      # produce the x-content-sha256 header required by the OCI HTTP signing spec —
      # a content-integrity hash, not a password or secret hash. SHA-256 is mandated
      # by Oracle for this header; see
      # https://docs.oracle.com/en-us/iaas/Content/API/Concepts/signingrequests.htm
      # The `usedforsecurity=False` flag on the hashlib.sha256 call already declares
      # non-security intent, but CodeQL's taint flow still re-fires when callers
      # further up the stack are modified. The suppression is scoped to this one
      # file/rule pair via SARIF post-filtering so every other callsite of
      # py/weak-sensitive-data-hashing in the repository continues to be analyzed.
      # The same query fires on the HIBP k-anonymity lookup in
      # litellm/proxy/auth/password_policy.py, where the password's SHA-1 is only
      # a lookup key into the haveibeenpwned range API (the protocol mandates
      # SHA-1) and the digest itself never leaves the proxy beyond its first 5
      # characters.
      - name: Filter SARIF (OCI sha256, HIBP sha1)
        if: matrix.language == 'python'
        uses: advanced-security/filter-sarif@2da736ff05ef065cb2894ac6892e47b5eac2c3c0 # v1.1
        with:
          patterns: |
            -litellm/llms/oci/common_utils.py:py/weak-sensitive-data-hashing
            -litellm/proxy/auth/password_policy.py:py/weak-sensitive-data-hashing
          input: sarif-results/python.sarif
          output: sarif-results/python.sarif

      - name: Upload SARIF
        uses: github/codeql-action/upload-sarif@6f2ac81f5cd81fe351a197ba0b00d91d03cd2aee # v4.39.0
        with:
          sarif_file: sarif-results
          category: "/language:${{ matrix.language }}"