PKR-Lab

d0080 - Code-Scanning und Abhängigkeits-Alerts — CodeQL, Dependabot, Security-Issues

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/d-sicherheit/d0080-codeql-dependabot.md

Code-Scanning und Abhängigkeits-Alerts — CodeQL, Dependabot, Security-Issues

Drei Bausteine prüfen das Repo laufend auf Sicherheitslücken und melden sich von selbst:
CodeQL sucht Schwachstellen im eigenen Code, Dependabot erkennt verwundbare Abhängigkeiten und
öffnet dafür Fix-PRs, und ein täglicher Workflow macht aus den offenen Funden Issues, die sich
wieder schließen, sobald der Fund behoben ist. Vorher gab es mit gitleaks
nur eine Secret-Prüfung und mit Renovate Versions-Updates im
Wochenrhythmus, aber keine Prüfung des Codes selbst und keinen Hinweis, wenn eine eingesetzte Version eine
bekannte Lücke hat.

Gilt für: das GitHub-Repo pkr-lab/capulus-core (kein Cluster). Ergebnisse unter
Security → Code scanning / Dependabot, Issues mit dem Label security.
Begründungen zu einzelnen Entscheidungen: 600a0.


Architektur

 PR / Push auf main / Wochenlauf
        │
        ▼
 codeql.yml ──► Code-Scanning-Alerts (main) ──┐      im PR: Check "CodeQL", Annotationen,
                                              │      Fix-Vorschläge (Copilot Autofix)
 Dependency Graph ──► Dependabot-Alerts ──────┤
                         │                    │
                         ▼                    ▼
              Dependabot-Fix-PR      security-issues.yml (täglich 06:35 UTC)
              (fix(deps): …)                  │
                                              ▼
                                   Issues mit Label `security`
                                   (anlegen, ergänzen, schließen, wieder öffnen)
Baustein Findet Ergebnis Dateien
CodeQL Schwachstellen im eigenen Code: Go, JavaScript, Python, Swift, GitHub-Actions-Workflows Alerts im Security-Tab, Check und Annotationen im PR .github/workflows/codeql.yml
Dependabot alerts + security updates bekannte Lücken in Go-Modulen und GitHub Actions (GitHub Advisory Database) Alerts im Security-Tab und automatischer Fix-PR .github/dependabot.yml + Repo-Einstellungen
Security-Issues spiegelt beide Quellen ein Issue je Regel bzw. je Manifest, schließt sich selbst .github/workflows/security-issues.yml, scripts/security-issues.py
Renovate (bestehend) neue Versionen Versions-PRs, unverändert renovate.json, f0020

Bewertung: CodeQL und Dependabot gegen freie Alternativen

Geprüft im Oktober 2026 nach vier Kriterien: kostenlos, Open Source, deckt die Sprachen des Repos ab,
öffnet PRs/Issues ohne zusätzliche Infrastruktur. Das Repo ist öffentlich, das entscheidet die
Kostenfrage: CodeQL, Dependabot, Copilot Autofix und Secret Scanning kosten hier nichts. Für ein
privates Repo wäre CodeQL kostenpflichtig (GitHub Code Security), dann wäre Opengrep die erste Wahl.

Code-Scanning (SAST)

Werkzeug Lizenz und Kosten Stärken Schwächen für dieses Repo Entscheidung
CodeQL Abfragen MIT, Engine proprietär, für öffentliche Repos kostenlos Datenfluss-Analyse über Funktions- und Dateigrenzen, alle fünf Sprachen des Repos inkl. Workflows, native PR-Annotationen, Copilot Autofix Engine nicht Open Source eingesetzt
Opengrep LGPL-2.1, Community-Fork von Semgrep CE (Januar 2025) vollständig Open Source, schnelle Musterregeln, eigene Regeln leicht flachere Analyse, Regelsatz muss selbst gepflegt werden Alternative, falls das Repo privat wird
Semgrep CE Engine LGPL-2.1, offizielle Regeln seit Dezember 2024 unter der eigenen „Semgrep Rules License“ wie Opengrep Analyse über Dateigrenzen nur in der kommerziellen Version, Regel-Lizenz nicht Open Source nicht eingesetzt
gosec, Bandit Apache-2.0 spezialisiert auf Go bzw. Python je eine Sprache, kein Swift/JS/Workflows neben CodeQL überflüssig
zizmor MIT sehr gründlich für GitHub-Actions-Workflows nur Workflows, meldet für die bestehenden Workflows 107 Funde (vor allem nicht per SHA gepinnte Actions) Empfehlung für später, siehe Lücken

Abhängigkeiten (SCA) und Fix-PRs

Werkzeug Lizenz und Kosten Stärken Schwächen für dieses Repo Entscheidung
Dependabot alerts + security updates kostenlos für alle Repos, Kern (dependabot-core) seit Mai 2024 MIT GitHub Advisory Database, Fix-PR meist innerhalb von Stunden, kein Token nötig kennt keine Container-Images und Helm-Charts, keine Erreichbarkeitsanalyse eingesetzt, nur für Sicherheits-PRs
Renovate AGPL-3.0, schon im Repo beste Versions-Updates (Helm-Values, Charts, Dockerfiles), Gruppierung, Dashboard läuft hier nur montags (PAT-Fallback, f0020); seine Sicherheits-PRs (vulnerabilityAlerts) lesen ohnehin die Dependabot-Alerts bleibt für Versions-Updates zuständig, Sicherheits-PRs abgeschaltet
OSV-Scanner Apache-2.0 offene OSV-Datenbank, auch Container-Images keine Fix-PRs für Go Option
govulncheck BSD-3 (Go-Team) Erreichbarkeitsanalyse, prüft auch die Standardbibliothek nur Go, keine PRs Option, für die Abschätzung unten genutzt
Trivy Apache-2.0 Images, IaC, Secrets am 2026-03-19 kompromittiert (TeamPCP: trivy-action, setup-trivy, Release v0.69.4 mit Credential-Stealer) Option für Image-Scans, dann nur mit per SHA gepinnter Action

Ergebnis


1. CodeQL

.github/workflows/codeql.yml, erweiterte Einrichtung („advanced
setup“): Konfiguration und Sprachen sind im Repo versioniert statt in den Repo-Einstellungen.

Trigger Wirkung
Push auf main Alerts für main, daraus entstehen die Issues
PR gegen main (nicht bei reinen Doku-Änderungen: docs/**, *.md) Check „Code scanning results / CodeQL“, Annotationen nur für neu eingeführte Funde, Fix-Vorschläge per Copilot Autofix
montags 03:41 UTC neue Abfragen neuerer CodeQL-Versionen greifen auch ohne Code-Änderung
manuell (workflow_dispatch) —
Sprache Build-Modus Runner Analysiert
--- --- --- ---
actions none ubuntu alle Workflows unter .github/workflows/
go autobuild ubuntu beide Go-Module (argocd/apps/tech/pacman/server, argocd/apps/tech/carplay-api/src), der Autobuilder findet beide go.mod selbst
javascript-typescript none ubuntu pacman-Frontend, Xibo-Slideshow, n8n/scripts/whatsapp-pair.js; minifizierte Dateien (*.min.js) überspringt CodeQL von sich aus
python none ubuntu scripts/*.py und die Python-Dateien der Ansible-Rollen
swift autobuild macos iOS-App unter ios/; vorher erzeugt XcodeGen das (nicht eingecheckte) Xcode-Projekt

Abfragesatz: der Standardsatz („default“, hohe Treffsicherheit). Lokal mit CodeQL 2.26.2 gemessen
(Oktober 2026, ohne Swift): der Standardsatz meldet 2 Funde, security-extended 46. Die 44 zusätzlichen
sind überwiegend Fehlalarme: 30× go/log-injection auf strukturierte slog-Ausgaben, 6× actions/untrusted-checkout/medium
auf ci.yml (Workflow ohne Rechte und Secrets) und 8× actions/unpinned-tag (berechtigt, aber ein Repo-weites Thema, siehe
Lücken). Umschalten: im Schritt Initialize CodeQL queries: security-extended ergänzen.

Kein Pflicht-Check: CodeQL steht nicht im Ruleset „main: PR + CI“ (f0090).
Der Check „Code scanning results“ wird bei neuen Funden ab high trotzdem rot und ist im PR sichtbar.

Erwartete Erstbefüllung

Quelle Erwartung Hinweis
CodeQL py/path-injection 2 Alerts in power-agent.py (Zeilen 67 und 92), 1 Issue name kommt aus der HTTP-Anfrage, TARGETS[name] wirkt davor als Allowlist. Vermutlich Fehlalarm: im Alert mit Begründung verwerfen oder den Namen ausdrücklich prüfen, dann verschwindet der Fund.
Dependabot carplay-api/src/go.mod rund 28 Advisories in indirekten Abhängigkeiten von gin: golang.org/x/crypto (17), x/net (8), x/text, x/sys, quic-go (je 1), 1 Issue und 1 gruppierter Fix-PR Abschätzung mit govulncheck gegen vuln.go.dev (Stand 2026-10-01). Erledigt am 2026-10-17 (Incident 016): govulncheck meldet „No vulnerabilities found“, siehe 60080.
Dependabot pacman/server/go.mod keine —
Swift unbekannt lokal nicht prüfbar (braucht macOS)

2. Dependabot

.github/dependabot.yml plus zwei Schalter in den Repo-Einstellungen
(siehe Einrichtung).


3. Security-Issues

.github/workflows/security-issues.yml läuft täglich um
06:35 UTC (und manuell) und gleicht mit scripts/security-issues.py die
offenen Alerts auf main mit den Issues ab. Ein Issue fasst zusammen, was gemeinsam behoben wird:

Situation Aktion
Gruppe mit Alerts ab MIN_SEVERITY, noch kein Issue Issue anlegen (Label security, wird bei Bedarf angelegt)
neue Alerts in einer Gruppe mit offenem Issue Tabelle aktualisieren und Kommentar „Neue Alerts: …“ (löst eine Benachrichtigung aus)
Alerts behoben, andere noch offen Tabelle still aktualisieren
keine Alerts ab MIN_SEVERITY mehr Issue mit Kommentar schließen (Grund completed)
Issue geschlossen, Alerts aber noch offen Issue mit Kommentar wieder öffnen
eine Quelle nicht abrufbar deren Issues bleiben unverändert, der Lauf wird rot

Schwelle: MIN_SEVERITY: medium in der Workflow-Datei. Kleinere Funde bleiben im Security-Tab sichtbar, bekommen
aber kein Issue. Bei Code-Scanning-Regeln ohne Sicherheits-Schweregrad gilt error als high, warning als
medium, note als low.

Bedienung:

Rechte: nur der Standard-GITHUB_TOKEN (issues: write, pull-requests: read, security-events: read für
Code-Scanning, vulnerability-alerts: read für Dependabot-Alerts). Die letzte Berechtigung gibt es seit dem
2026-09-03; vorher brauchte das Lesen von Dependabot-Alerts im Workflow ein PAT.

Lokal testen (braucht ein gh-Login mit Lesezugriff auf die Alerts, also als Repo-Admin):

DRY_RUN=1 GH_REPO=pkr-lab/capulus-core GITHUB_REPOSITORY=pkr-lab/capulus-core python3 scripts/security-issues.py

DRY_RUN=1 liest alles, gibt die geplanten Issue-Änderungen samt Text aus und schreibt nichts.


Einmalige Einrichtung (GitHub-Einstellungen)

Die Workflows wirken mit dem Merge. Zusätzlich unter Settings → Advanced Security (Bereich „Security“ der
Seitenleiste, früher „Code security“):

Einstellung Wert Warum
Dependency graph an (für öffentliche Repos Standard) Grundlage für Dependabot
Dependabot alerts Enable ohne sie wird security-issues.yml rot („Dependabot alerts are disabled“)
Dependabot security updates Enable erst damit öffnet Dependabot Fix-PRs
Grouped security updates egal die Gruppen stehen bereits in dependabot.yml
Code scanning → CodeQL analysis nicht auf „Default setup“ stellen die erweiterte Einrichtung per Workflow ist aktiv; mit „Default setup“ weist GitHub die Uploads des Workflows ab
Copilot Autofix an Fix-Vorschläge im PR, kostenlos für öffentliche Repos
Secret Protection: Secret Scanning und Push Protection an kostenlos für öffentliche Repos, ergänzt gitleaks. Push Protection lehnt einen Push ab, der ein erkanntes Token enthält (auch über die API); umgehen geht nur mit Begründung im Dialog.
Secret Scanning: Non-Provider-Patterns, Validity Checks aus Non-Provider-Patterns lassen sich für dieses Repo nicht einschalten (die API setzt den Wert nach enabled auf disabled zurück), Validity Checks sind bewusst aus, weil sie gefundene Schlüssel bei den Anbietern auf Gültigkeit prüfen

Danach einmal Actions → CodeQL → Run workflow (füllt die Alerts für main) und anschließend
Actions → Security issues → Run workflow starten, statt auf den nächsten Zeitplan zu warten.

Stand seit 2026-10-17 (Incident 014): Secret Scanning, Push Protection, Dependabot alerts und Dependabot security updates sind aktiv
(gh api repos/pkr-lab/capulus-core --jq '.security_and_analysis', vulnerability-alerts liefert 204, automated-security-fixes enabled: true).
Vorher standen alle Funktionen auf disabled, obwohl dieses Dokument sie als aktiv beschrieb; security-issues.yml lief deshalb seit Tagen rot.
Der Workflow security-issues.yml ist bewusst manuell deaktiviert (gh workflow disable security-issues.yml), damit keine öffentlichen Issues zu
Abhängigkeitslücken entstehen, bevor die Fix-PRs eingespielt sind. Wieder einschalten: gh workflow enable security-issues.yml.


Was das Setup nicht abdeckt

Lücke Hinweis
Container-Images (Drittanbieter-Images aus den values.yaml, eigene Images pacman, carplay-api, n8n-custom samt der im Dockerfile installierten npm-Pakete wie whatsapp-web.js) Dependabot und CodeQL sehen keine Images. Option: Image-Scan mit Grype oder (per SHA gepinntem) Trivy nach dem Build in build-images.yml.
Fehlkonfigurationen in Helm-Charts, Manifesten, Ansible kubeconform prüft nur das Schema (f0070). Option: Checkov, KICS oder kube-linter.
Vendorte Bibliotheken: jquery-1.10.2.min.js im pacman-Frontend jQuery 1.10.2 hat bekannte XSS-Lücken (CVE-2015-9251, CVE-2019-11358, CVE-2020-11022, CVE-2020-11023). Kein Scanner sieht vendorte Dateien, CodeQL überspringt *.min.js. Von Hand aktualisieren oder ersetzen.
Gepinnte Actions (Incident 015) Seit 2026-10-17 zeigen alle uses: auf Commit-SHAs, Renovate hält sie mit helpers:pinGitHubActionDigests aktuell (600a0). Nicht gepinnt bleiben npx- und pip install-Aufrufe in den Workflows (Incident 031).
n8n-Workflows (JavaScript in JSON-Dateien) werden nicht analysiert
Secret-Scanning-Alerts landen nicht als Issue (der GITHUB_TOKEN darf sie nicht lesen); GitHub benachrichtigt selbst, gitleaks prüft jeden PR. Abfrage: gh api 'repos/pkr-lab/capulus-core/secret-scanning/alerts?state=open' (enthält die Klartextwerte, nicht in Logs oder Chats ausgeben)
Go-Standardbibliothek Dependabot meldet keine Lücken der Go-Version. Die Images bauen mit golang:1.27-alpine, Renovate hält das Basis-Image aktuell.

Troubleshooting

Symptom Hinweis
CodeQL-Lauf rot: „CodeQL analyses from advanced configurations cannot be processed when the default setup is enabled“ Settings → Advanced Security → CodeQL analysis: „Default setup“ abschalten
Swift-Job rot: „We were unable to automatically build your code“ oder xcodebuild-Fehler Auf einem Mac nachstellen: cd ios && xcodegen generate && xcodebuild build -project HomeserverDashboard.xcodeproj -target HomeserverDashboard CODE_SIGNING_ALLOWED=NO. Baut die App dort, im Workflow auf build-mode: manual mit genau diesem Befehl umstellen.
security-issues.yml rot: „Dependabot alerts are disabled for this repository“ Settings → Advanced Security → Dependabot alerts aktivieren
security-issues.yml rot: „Resource not accessible by integration“ bei dependabot/alerts Berechtigung vulnerability-alerts: read fehlt im Job. Notlösung: fine-grained PAT mit „Dependabot alerts: Read-only“ als GH_TOKEN
Kein Dependabot-PR trotz Alert Dependabot security updates aktiv? Gibt es eine gepatchte Version (Spalte „behoben in“)? Scheitert das Update, zeigt der Alert selbst den Grund („Dependabot cannot update …“).
Renovate- und Dependabot-PR für dasselbe Paket Kann vorkommen, wenn das Sicherheits-Update zugleich ein normales Versions-Update ist. Einen mergen, der andere schließt sich selbst.
Ein Issue öffnet sich immer wieder Der Alert ist noch offen: beheben oder im Security-Tab verwerfen
actionlint meldet unknown permission scope "vulnerability-alerts" actionlint 1.7.12 kennt die Berechtigung noch nicht. GitHub akzeptiert sie (dokumentiert seit 2026-09-03).