1.9 KiB
1.9 KiB
Einrichtung in Gitea
- Repository
VULN/statusmit Branchmainerstellen und alle Dateien dieses Pakets (einschließlich.gitea/workflows/) hochladen. sources.jsonbearbeiten: Repository-Namen und Workflow-Dateinamen (z. B.sync.yml) müssen wirklich existieren. Nicht vorhandene Quellen löschen.max_age_hourspro Quelle anpassbar.- Einen Gitea Personal Access Token mit Lesezugriff auf Actions aller überwachten Repositories sowie Schreibzugriff auf Code im Repository
VULN/statuserstellen. Bei privaten Repositories müssen passende Zugriffsrechte bestehen. InVULN/statusunter Settings → Actions → Secrets alsSTATUS_API_TOKENspeichern. - Dem gewünschten Docker-Runner Label
status:docker://python:3.12-bookwormzuweisen (z. B.GITEA_RUNNER_LABELSum,status:docker://python:3.12-bookwormerweitern) und Runner neu starten. Damit laufen die Status-Jobs im Python-Container. - Actions für
VULN/statusaktivieren, WorkflowVulnerability Status Dashboardmanuell starten. Danach alle 15 Minuten automatischer Lauf. - README unter
VULN/statusanschauen.
Wichtige Hinweise
- Der API-Endpunkt ist
/api/v1/repos/{owner}/{repo}/actions/workflows/{workflow}/runs. - Der Job lädt das Skript über die Gitea-Contents-API;
actions/checkoutist nicht nötig. - Der Token ist ein Secret, niemals in die Repository-Dateien schreiben.
- Lege
STATUS_API_TOKENmit minimal nötigen Rechten an. Die Schreibrechte aufVULN/statussind für den README-Commit nötig. - Der Workflow verwendet
gitea.server_urlals Gitea-Basis-URL. Bei Reverse-Proxy-Installationen auf korrekteROOT_URLachten. - Der Status prüft den letzten Workflow pro Quelle und den letzten erfolgreichen Lauf. Ein alter Erfolg gilt als überfällig.
- Bei API-Fehlern wird eine Fehlermeldung im Dashboard angezeigt und der Aktualisierungsjob schlägt fehl.
- Die Ausführung muss Zugang zur Gitea-API haben und DNS/TLS korrekt auflösen.