Zum Hauptinhalt springen

Gepatchte Upstream-Images

Diese Funktion ist verfügbar, sobald sie veröffentlicht ist. Das Changelog hält das Datum fest.

Manche Upstream-Images haben bekannte Schwachstellen und noch kein Release mit Fix. Wenn du von einer solchen Basis baust und die verwundbaren Pakete in deinen eigenen Layern patchst, weist das Image-Pull-Gate deiner Organisation die ungepatchte Basis trotzdem ab, wenn dein Build sie über den Abhängigkeits-Proxy pullt, denn diese Basis hat für sich genommen die Befunde.

Eine Liste gepatchter Basis-Images in deinem Repository erlaubt genau diesem Build, genau diese Basis zu pullen. Zurückgestellt wird nur das Urteil über bekannte Schwachstellen (CVE) der Basis; bewertet wird stattdessen das Image, das dein Build daraus erzeugt, vom selben Gate und anhand seiner eigenen Befunde. Was du auslieferst, muss weiterhin sauber sein.

Wann du es verwendest

Verwende eine Liste gepatchter Basis-Images, wenn all das zutrifft:

  • die Sperraktion für Images deiner Organisation ist block_pull, sodass ein Pull eines Images mit Befunden ab deiner Sperrschwelle abgewiesen wird;
  • ein Build von dir pullt ein Upstream-Basis-Image über den Abhängigkeits-Proxy, und diese Basis hat solche Befunde;
  • es gibt keinen neueren Upstream-Tag und keinen Rebuild, der sie behebt (der Befund zeigt Upstream-Image, kein neueres korrigiertes Tag; siehe Neuere Tags für Upstream-Images);
  • dein Build behebt die Befunde in seinen eigenen Layern, und derselbe Lauf pusht das Ergebnis in die Container-Registry deiner Organisation auf frem.sh.

Wenn ein neuerer Upstream-Tag die Befunde behebt, wechsle stattdessen zu ihm. Wenn du ein Risiko akzeptierst, ohne es zu patchen, ist das eine Ausnahme, keine gepatchte Basis.

Unter warn oder none wird nichts abgewiesen, also gibt es nichts zurückzustellen, und die Liste hat keine Wirkung.

Das Bedrohungsmodell

Eine Liste, die ein Image an einem Sicherheits-Gate vorbeilässt, ist selbst ein Angriffsziel. Jede der folgenden Regeln schließt einen Weg, sie zu missbrauchen.

  • Nur vom Default-Branch gelesen. fremforge liest .fremforge/patched-bases.json am Kopf des Default-Branches des Repositorys, nie von dem Branch oder Commit, auf dem der Job läuft. Ein Pull Request, der einen Eintrag hinzufügt oder erweitert, ändert nichts, bis er deinen eigenen Branch-Schutz und dein Review durchlaufen hat und gemergt ist. Schütze den Default-Branch und verlange ein Review für .fremforge/, wie für Workflow-Dateien.
  • Exakte Digests, nie Tags. Ein Eintrag nennt Manifest-Digests, keinen Tag. Ein Tag kann upstream auf anderen Inhalt verschoben werden; ein Digest ist der Inhalt. Nur ein Pull, dessen ausgeliefertes Manifest den Hash eines gelisteten Digests hat, passt.
  • Benannte Jobs dieses Repositorys. Ein Eintrag nennt die Workflow-Datei und den Job, die die Basis pullen dürfen, und nur Jobs des Repositorys, in dem die Liste liegt. fremforge erkennt den Job an seinen eigenen Aufzeichnungen über den laufenden Job, nicht an dem, was der Workflow oder der Client sagt. Ein Pull durch eine Person, einen Registry-Robot, ein persönliches Zugriffstoken oder den Job eines anderen Repositorys wird wie bisher bewertet.
  • Keine Pull Requests, keine Forks. Nur Läufe mit push, schedule und workflow_dispatch auf einem erlaubten Branch können zurückstellen. Ein Pull-Request-Lauf, ein Merge-Group-Lauf oder ein Lauf aus einem Fork tut das nie, sodass nicht reviewter Code die ungepatchte Basis nicht pullen kann.
  • Nur deine Organisation. Die Liste stellt Pulls im Abhängigkeits-Proxy ihrer eigenen Organisation zurück, durch deren eigene Jobs. Sie kann für eine andere Organisation nichts zurückstellen, egal welchen Digest oder Namen diese verwendet.
  • Das Ergebnis wird bewertet. Der Eintrag nennt das Image, das dein Build erzeugt. Dieses Image liegt in deiner eigenen Registry, wo dieselben Image-Gates es bei jedem Pull bewerten: Mit block_pull wird ein Ergebnis, das noch Befunde ab deiner Schwelle hat, wie jedes andere Image abgewiesen.
  • Das Ergebnis muss ankommen. Auf jeden zurückgestellten Pull muss innerhalb von 6 Stunden ein Push des Ausgabe-Images des Eintrags folgen, aus demselben Lauf, in die Registry deiner Organisation auf frem.sh. Ein Job, der ohne diesen Push erfolgreich endet, setzt den Eintrag für das Repository sofort aus, und drei fehlgeschlagene oder unfertige Jobs in Folge tun das auch: siehe Der Push des Ergebnisses wird geprüft.
  • Schlägt geschlossen fehl. Ein unbekannter Schlüssel oder ein einziger ungültiger Eintrag macht die ganze Liste ungültig. Eine Liste, die nicht validiert, stellt nichts zurück; sie wird nie zur Hälfte angewendet.
  • Kein Ablaufdatum. Ein Eintrag hat kein Ablaufdatum, denn er ist keine Ausnahme: Er verschiebt das Urteil von der Eingabe auf das Ergebnis. Wenn upstream eine Basis mit Fix veröffentlicht, pinne den neuen Digest. Der alte Eintrag passt dann auf nichts mehr, was du pullst, und du kannst ihn entfernen.

Beispiel

.fremforge/patched-bases.json im Repository acme/base-images:

{
  "version": 1,
  "bases": [
    {
      "id": "nginx-1-27-patched",
      "image": "docker.io/library/nginx",
      "digests": [
        "sha256:847ed4ff646e27c4141ccda2134c861d71c53d97c8e17c4717aeb0a97371eba6",
        "sha256:416c19e2f2f06ad4ea5fac5768a4ef9ecef4a56f1457a6cd0cb4e4ce1e03f32f"
      ],
      "pullers": [
        { "repo": "acme/base-images", "workflow": "build.yaml", "job": "build" },
        { "repo": "acme/base-images", "workflow": "nightly.yaml", "job": "rebuild (amd64)" }
      ],
      "refs": ["refs/heads/main"],
      "events": ["push", "schedule", "workflow_dispatch"],
      "output": { "image": "nginx-patched" },
      "reason": "Upstream has no release with the fixed OpenSSL yet; our Dockerfile upgrades the affected packages in its own layer.",
      "approved_by": "Platform security team, change review",
      "confirmed": "2026-11-12, platform security team"
    }
  ]
}

Der Build pinnt die Basis per Digest, über den Abhängigkeits-Proxy, und meldet sich mit dem eigenen Token des Jobs an:

FROM frem.sh/acme/dependency-proxy/docker.io/library/nginx@sha256:847ed4ff646e27c4141ccda2134c861d71c53d97c8e17c4717aeb0a97371eba6
RUN apt-get update && apt-get install -y --only-upgrade openssl libssl3 && rm -rf /var/lib/apt/lists/*
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "$GITHUB_TOKEN" | docker login frem.sh -u x --password-stdin
      - run: docker build -t frem.sh/acme/nginx-patched:1.27 . && docker push frem.sh/acme/nginx-patched:1.27

Feldreferenz

Die oberste Ebene enthält version (muss 1 sein) und bases und darf $schema enthalten. Jeder andere Schlüssel macht die Datei ungültig.

FeldPflichtBedeutung
idjaEin kurzer Name des Eintrags in Kleinbuchstaben, eindeutig in der Datei: Buchstaben, Ziffern, ., _ und -, 2 bis 64 Zeichen, beginnend mit einem Buchstaben oder einer Ziffer. Er wird im Audit-Ereignis festgehalten.
imagejaDas Upstream-Image, wie der Abhängigkeits-Proxy es nennt: Registry-Host und Pfad, etwa docker.io/library/nginx oder ghcr.io/example/server. Kein Tag, kein Digest und nicht der Pfad frem.sh/<org>/dependency-proxy/.... Ein Docker-Hub-Image braucht seinen vollen Namen (docker.io/library/nginx, nicht nginx).
digestsja1 bis 32 Manifest-Digests, sha256: gefolgt von 64 hexadezimalen Zeichen in Kleinbuchstaben. Liste den Multi-Architektur-Index und die Plattform-Manifeste auf, die dein Build pullt.
pullersja1 bis 20 Jobs, die die Basis pullen dürfen, jeweils { "repo", "workflow", "job" }. repo muss dieses Repository sein, <owner>/<repo>. workflow ist der Dateiname des Workflows unter .forgejo/workflows/, etwa build.yaml, ohne das Verzeichnis. job ist der Name des Jobs, wie Forgejo ihn im Lauf zeigt: sein name:, wenn er einen setzt, sonst sein Schlüssel; ein Matrix-Job mit seinem Suffix, etwa rebuild (amd64). Wird exakt verglichen.
refsnein1 bis 10 Branches, auf denen der Job laufen darf, als volle Refs: refs/heads/main. Keine Tags und keine Platzhalter. Standard: der Default-Branch des Repositorys.
eventsneinDie Ereignisse, die der Lauf haben darf: beliebige aus push, schedule und workflow_dispatch. Standard: alle drei.
output.imagejaDas Image, das dein Build erzeugt, in der eigenen Registry deiner Organisation, als Name unter deiner Organisation: nginx-patched für frem.sh/acme/nginx-patched. Kein Host, kein Tag, kein Digest und kein Image des Abhängigkeits-Proxys.
reasonjaWarum die Basis gepatcht statt ersetzt wird, 20 bis 2.000 Zeichen.
approved_byjaWer den Eintrag reviewt hat, bis zu 200 Zeichen.
confirmedneinEine Notiz, die den Eintrag erneut bestätigt, 1 bis 200 Zeichen, etwa ein Datum und wer ihn geprüft hat. Sie ändert nichts daran, worauf der Eintrag passt. Mit dem Setzen oder Ändern dieser Notiz hebst du eine Aussetzung auf.

Grenzen: Die Datei ist höchstens 64 KiB groß und enthält höchstens 50 Einträge.

Was zurückgestellt wird und was nicht

Zurückgestellt: nur das Urteil über bekannte Schwachstellen (CVE) des Image-Pull-Gates, und nur für einen Pull, auf den all das zutrifft:

  • ein gelisteter Digest des gelisteten image;
  • über den Abhängigkeits-Proxy deiner Organisation gepullt;
  • von einem gelisteten Job desselben Repositorys, in derselben Organisation, angemeldet mit dem eigenen Token dieses Jobs;
  • in einem Lauf auf einem erlaubten Branch, für ein erlaubtes Ereignis.

Ein solcher Pull wird ausgeliefert. Das im Eintrag genannte Ausgabe-Image wird stattdessen vom normalen CVE-Gate der Registry bewertet.

Nicht zurückgestellt:

  • die Malware-Prüfungen: infizierte Layer, bösartige Pakete im Image und Layer, die nicht gescannt werden konnten, werden wie bisher abgewiesen;
  • die Prüfung der Image-Signatur und deine Paketrichtlinie;
  • Pull-Request-Läufe, Merge-Group-Läufe und Läufe aus Forks;
  • andere Repositorys, andere Jobs und andere Organisationen sowie Pulls, die nicht von einem Job stammen;
  • ein nicht gelisteter Digest, auch derselbe Tag, nachdem er upstream verschoben wurde.

Deine bestehenden CVE-Ausnahmen, deine Sperrschwelle und deine Sperraktion (block_pull, warn oder none) bleiben unverändert.

Der Push des Ergebnisses wird geprüft

Eine Zurückstellung ist ein Versprechen: Der Lauf, der die ungepatchte Basis gepullt hat, baut das gepatchte Image und pusht es. fremforge prüft dieses Versprechen für jeden zurückgestellten Pull.

  • Die Uhr startet beim Pull. Der erste zurückgestellte Pull eines Eintrags in einem Lauf startet ein Fenster von 6 Stunden. Spätere Pulls desselben Eintrags im selben Lauf starten es nicht neu.
  • Derselbe Lauf. Ein Job des Laufs, der die Basis gepullt hat, muss das Ergebnis pushen, angemeldet mit seinem eigenen Token. Jeder Job dieses Laufs zählt. Ein Push aus einem anderen Lauf, auch aus einem späteren Lauf desselben Workflows, oder durch eine Person, ein persönliches Zugriffstoken oder einen Registry-Robot zählt nicht.
  • Das Ausgabe-Image des Eintrags, in deiner Registry. Der Push muss ein angenommener Push von frem.sh/<org>/<output.image> in die eigene Registry deiner Organisation sein, mit beliebigem Tag. Ein Push in eine andere Registry, in eine andere Organisation oder unter einem anderen Image-Namen zählt nicht.
  • Innerhalb von 6 Stunden. fremforge prüft alle paar Minuten, sodass ein fehlender Push kurz nach Ablauf der 6 Stunden auffällt.

Ist der Push nicht angekommen, entscheidet das Ergebnis des Jobs, der die Basis gepullt hat, so wie Forgejo es zur 6-Stunden-Marke festhält. Es zählt das Ergebnis des Jobs, nicht des Laufs; haben mehrere Jobs des Laufs die Basis für den Eintrag gepullt, gilt es als Erfolg, wenn einer von ihnen erfolgreich war.

  • Der Job war erfolgreich. Der Eintrag wird für das Repository sofort ausgesetzt. Ein Job, der gut endet, ohne sein Ergebnis zu liefern, ist genau das, was diese Prüfung abfangen soll.
  • Der Job ist fehlgeschlagen, wurde abgebrochen oder übersprungen oder war nicht fertig. Der Eintrag wird nicht ausgesetzt. Der fehlende Push wird als Audit-Ereignis image_cve.patched_base_output_skipped festgehalten und gezählt. Ein Job, der zur 6-Stunden-Marke noch läuft oder den Forgejo nicht mehr kennt, gilt als nicht fertig.
  • Drei in Folge. Der dritte solche Fall für denselben Eintrag im selben Repository, ohne bestätigten Push dazwischen, setzt den Eintrag aus.
  • Ein bestätigter Push setzt die Zählung zurück, ebenso das Aufheben einer Aussetzung.

Wenn ein Eintrag ausgesetzt ist

Was passiert. Der Eintrag stellt für dieses Repository nichts mehr zurück. Ein Pull, den der Eintrag sonst zurückgestellt hätte, wird mit 403 DENIED und einem eigenen Grund abgewiesen, patched_base_suspended, sodass du ihn von einer gewöhnlichen CVE-Abweisung unterscheiden kannst:

  • die Antwort trägt den Header X-Fremforge-Refusal-Reason: patched_base_suspended;
  • der Body nennt den Eintrag, wann er ausgesetzt wurde und wie du ihn erneut bestätigst (unten);
  • das Zugriffsprotokoll der Registry hält den Pull als blocked mit dem decision_reason image_cve:patched_base_suspended fest, den die Konsole als Blockiert: deklarierte gepatchte Basis ausgesetzt (ihr Ausgabe-Image wurde nicht gepusht) anzeigt.
HTTP/1.1 403 Forbidden
Content-Type: application/json
X-Fremforge-Refusal-Reason: patched_base_suspended
{
  "errors": [
    {
      "code": "DENIED",
      "message": "Pull blocked: patched base \"nginx-1-27-patched\" in .fremforge/patched-bases.json is suspended for this repository (an earlier run that pulled it did not push its output image), so its 3 high/critical finding(s) are judged as usual. To re-confirm it, change the entry on the default branch, e.g. its `confirmed` note.",
      "detail": {
        "reason": "patched_base_suspended",
        "entry": "nginx-1-27-patched",
        "suspended_at": "2026-11-12T16:05:12.000Z",
        "reconfirm": "change the entry on the default branch, e.g. its `confirmed` note",
        "finding_count": 3,
        "block_severity": "high",
        "admin_url": "https://frem.sh/acme/_admin/code-security/images"
      }
    }
  ]
}

detail.finding_count und detail.block_severity sind die Befunde der Basis und deine Schwelle; admin_url ist die Seite mit den Image-Befunden deiner Organisation. Die anderen Einträge der Liste wirken weiter. Eine Aussetzung läuft nicht ab, und ein späterer Push hebt sie nicht auf.

Wie du davon erfährst. fremforge schreibt das Audit-Ereignis image_cve.patched_base_suspended, das auch deinen SIEM-Stream erreicht, und sendet das Sicherheitsereignis security.policy.violation, mit "policy": "patched_base" in details, an jedes Webhook-Ziel, das es abonniert hat. Es gibt keine E-Mail. Um von einer Aussetzung zu erfahren, abonniere mit einem Ziel der Webhooks für Sicherheitsalarme security.policy.violation, oder beobachte das Audit-Log.

{
  "event": "security.policy.violation",
  "event_id": "9a1e5c7b3d2f4a6c8e0b1d3f5a7c9e2b",
  "occurred_at": "2026-11-12T16:05:12.000Z",
  "org": "acme",
  "severity": "high",
  "title": "Patched base nginx-1-27-patched suspended: run 48213 did not push acme/nginx-patched within 6 h",
  "repository": "acme/base-images",
  "source": "registry",
  "correlation_key": "patched-base:acme/base-images:nginx-1-27-patched",
  "console_url": "https://frem.sh/acme/_admin/code-security/images",
  "details": {
    "policy": "patched_base",
    "audit_event_id": "1f3b5d7f-2a4c-4e6a-8c0e-2b4d6f8a0c1e",
    "org": "acme",
    "repo": "acme/base-images",
    "run_id": 48213,
    "run_number": 112,
    "entry": "nginx-1-27-patched",
    "output_image": "acme/nginx-patched",
    "deferred_at": "2026-11-12T10:01:37.000Z",
    "deferral_event_id": "7c9e1a3b-5d7f-4b2d-9f1a-3c5e7a9b1d3f",
    "window_hours": 6,
    "cause": "success_without_push",
    "outcome": "success"
  }
}

title nennt den Lauf mit seiner run_id; details.run_number ergibt seine Seite, /<owner>/<repo>/actions/runs/<run_number>. correlation_key ist für jede Aussetzung desselben Eintrags im selben Repository gleich.

So hebst du sie auf.

  1. Finde heraus, warum der Push nicht angekommen ist (siehe Fehler, die einen Eintrag aussetzen), und korrigiere den Workflow.
  2. Ändere den Eintrag auf dem Default-Branch, über dein normales Review. Um ihn zu ändern, ohne zu ändern, worauf er passt, setze oder ändere seine Notiz confirmed, etwa "confirmed": "2026-11-12, push fixed in build.yaml".
  3. Starte den Build erneut. Bei seinem ersten Pull der Basis liest fremforge den Eintrag am Kopf des Default-Branches, erkennt, dass er sich vom ausgesetzten Eintrag unterscheidet, hebt die Aussetzung auf und schreibt das Audit-Ereignis image_cve.patched_base_reconfirmed. Dieser Pull wird wieder zurückgestellt, und der Push seines Ergebnisses wird wie jeder andere geprüft.

Nur eine Änderung dessen, was der Eintrag sagt, zählt: jedes seiner Felder, confirmed eingeschlossen. Die Datei neu zu formatieren, Schlüssel, Einträge, Digests oder Pullers umzusortieren und Commits an anderen Einträgen oder anderen Dateien lassen den Eintrag, wie er war, sodass er ausgesetzt bleibt. Eine Änderung auf einem anderen Branch oder in einem offenen Pull Request zählt erst, wenn sie gemergt ist.

Prüfen, ob es gewirkt hat

Jeder zurückgestellte Pull hinterlässt zwei Einträge.

Im Zugriffsprotokoll der Registry ist der Pull allowed, und sein decision_reason enthält image_cve:deferred_patch_input:

curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/access-log?decision=allowed&since=2026-11-01" \
  | jq '.. | objects | select((.decision_reason? // "") | test("image_cve:deferred_patch_input"))'

Im Audit-Log, und von dort in deinem SIEM-Stream, ist jeder zurückgestellte Pull das Ereignis image_cve.deferred_patch_input. Seine Felder:

FeldBedeutung
org, repoDeine Organisation und das Repository, dessen Job die Basis gepullt hat
run_id, run_number, job_idDer Lauf und der Job; run_number ist die Seite des Laufs, /<owner>/<repo>/actions/runs/<run_number>
workflow, jobDie Workflow-Datei und der Job-Name, die auf den Eintrag gepasst haben
image, digestDas über den Proxy bezogene Image und der ausgelieferte Digest
output_imageDas Ausgabe-Image, auf das das Urteil verschoben wurde, <org>/<name>
entryDie id des passenden Eintrags
list_path, list_commit.fremforge/patched-bases.json und der Commit des Default-Branches, an dem sie gelesen wurde
entry_hashEin Hash des Eintrags, wie er gelesen wurde. Eine Aussetzung wird nur aufgehoben, wenn er sich ändert
curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/audit?since=2026-11-01T00:00:00Z" \
  | jq '.. | objects | select(.action? == "image_cve.deferred_patch_input")'

Beide brauchen ein Token mit audit:read. Wenn der Pull mit 403 DENIED abgewiesen wurde und keiner der beiden Einträge existiert, wurde der Pull nicht zurückgestellt: siehe die Fehler unten.

Wenn die Prüfung des Ergebnisses fehlschlägt

Ein fehlender Push, der den Eintrag nicht aussetzt, eine Aussetzung und die Änderung, die sie aufhebt, hinterlassen je ein Audit-Ereignis. Der fehlende Push, der einen Eintrag nach zwei früheren aussetzt, hinterlässt sowohl sein Ereignis image_cve.patched_base_output_skipped als auch die Aussetzung.

image_cve.patched_base_output_skipped, geschrieben, wenn ein Job, der nicht erfolgreich war, auch nicht gepusht hat:

FeldBedeutung
org, repoDeine Organisation und das Repository, dessen Job die Basis gepullt hat
entryDie id des Eintrags
run_id, run_numberDer Lauf, der die Basis gepullt und das Ergebnis nicht gepusht hat
output_imageDas Ausgabe-Image, das nicht gepusht wurde, <org>/<name>
outcomeDas Ergebnis des Jobs: failure, cancelled, skipped, unfinished oder unknown
consecutive_non_success, suspends_atDer wievielte solche Fall in Folge das für den Eintrag ist, und die Zahl, die ihn aussetzt, 3
deferral_event_idDie id des Ereignisses image_cve.deferred_patch_input, das die Uhr gestartet hat

image_cve.patched_base_suspended, geschrieben, wenn der Eintrag ausgesetzt wird:

FeldBedeutung
org, repoDeine Organisation und das Repository, für das der Eintrag ausgesetzt ist
entryDie id des ausgesetzten Eintrags
run_id, run_numberDer Lauf, der die Basis gepullt und das Ergebnis nicht gepusht hat
output_imageDas Ausgabe-Image, das nicht gepusht wurde, <org>/<name>
deferred_at, deferral_event_idWann der zurückgestellte Pull stattfand, der die Uhr gestartet hat, und die id seines Ereignisses image_cve.deferred_patch_input
window_hoursDas Fenster, 6
causesuccess_without_push (der Job war erfolgreich, ohne zu pushen) oder non_success_x3 (der dritte fehlende Push in Folge)
outcomeDas Ergebnis des Jobs wie oben, oder success
consecutive_non_successNur bei non_success_x3: die Zahl, 3

image_cve.patched_base_reconfirmed, geschrieben beim ersten Pull, nachdem sich der Eintrag geändert hat:

FeldBedeutung
org, repoDeine Organisation und das Repository, für das die Aussetzung aufgehoben ist
entryDie id des Eintrags
list_commitDer Commit des Default-Branches, an dem der geänderte Eintrag gelesen wurde
suspended_at, suspended_run_idWann der Eintrag ausgesetzt wurde, und die run_id des Laufs, der das verursacht hat
entry_hashDer Hash des Eintrags, wie er jetzt lautet
curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/audit?since=2026-11-01T00:00:00Z" \
  | jq '.. | objects | select(.action? | IN("image_cve.patched_base_output_skipped", "image_cve.patched_base_suspended", "image_cve.patched_base_reconfirmed"))'

Die Zustellungen von security.policy.violation stehen im Zustellprotokoll jedes Ziels, GET /orgs/{org}/webhooks/deliveries?destination_id={id}.

Häufige Fehler

Ein Pull, der nicht zurückgestellt wird, wird genau wie bisher abgewiesen; es gibt dafür keinen eigenen Fehler. Die Ausnahme ist ein Pull eines ausgesetzten Eintrags, der den Grund patched_base_suspended trägt. Prüfe zuerst das:

  • Die Liste ist noch nicht auf dem Default-Branch. Der Pull-Request-Lauf, der sie hinzufügt, kann sie nicht nutzen, und auch kein anderer Lauf, bis die Änderung gemergt ist.
  • Der Lauf ist ein Pull Request. Ein Pull-Request-Lauf oder ein Merge-Group-Lauf stellt nie zurück, auch nicht, nachdem die Liste gemergt ist. Baue das Image bei push, schedule oder workflow_dispatch.
  • Ein Tag statt eines Digests. "image": "docker.io/library/nginx:1.27" oder ein Tag in digests macht die ganze Liste ungültig. Trage die Digests in digests ein und pinne die Basis in deinem Dockerfile per Digest, damit ein erneuter Push des Tags upstream nicht ändern kann, was du pullst.
  • Ein Digest, der nicht der ausgelieferte ist. Ein Multi-Architektur-Tag wird zuerst als Index ausgeliefert, dann als Plattform-Manifest. Liste beide Digests auf, sonst wird der Pull des fehlenden abgewiesen.
  • Ein unbekannter Schlüssel oder ein fehlerhafter Eintrag. Ein falsch geschriebenes Feld ("digest" statt "digests"), ein zusätzliches Feld wie "expires" oder ein einziger Eintrag, der nicht validiert, macht die ganze Liste ungültig, und für keinen Eintrag wird etwas zurückgestellt.
  • Der falsche Job-Name. job ist der Name, den Forgejo für den Job im Lauf zeigt: sein name:, wenn er einen hat, nicht sein Schlüssel; ein Matrix-Job enthält sein Suffix.
  • Ein Pfad in workflow. Schreibe build.yaml, nicht .forgejo/workflows/build.yaml.
  • Ein kurzer Branch-Name in refs. Schreibe refs/heads/main, nicht main.
  • Ein anderes Repository in pullers. Eine Liste deckt nur die Jobs ihres eigenen Repositorys ab. Damit ein anderes Repository dieselbe Basis pullen darf, lege dort eine Liste an.
  • Die falschen Zugangsdaten. Der Job muss sich bei frem.sh mit seinem eigenen Token (GITHUB_TOKEN) anmelden. Ein persönliches Zugriffstoken oder ein Registry-Robot ist kein Job, deshalb werden seine Pulls nicht zurückgestellt.
  • Die Basis direkt von upstream gepullt. Nur Pulls über frem.sh/<org>/dependency-proxy/... werden zurückgestellt.

Fehler, die einen Eintrag aussetzen

Wird ein Pull mit patched_base_suspended abgewiesen, suche das Ereignis image_cve.patched_base_suspended im Audit-Log: Sein cause und seine run_number sagen, welche Regel gegriffen hat und welcher Lauf sie ausgelöst hat. Diese Fehler lassen die Prüfung des Ergebnisses fehlschlagen:

  • Das Ergebnis aus einem anderen Lauf gepusht. In einem Workflow zu bauen und aus einem anderen zu pushen, oder das Image danach von Hand zu pushen, zählt nicht. Pushe aus dem Lauf, der die Basis gepullt hat.
  • Das Ergebnis in eine andere Registry gepusht. Ein Push zu Docker Hub, in eine andere Registry oder in eine andere Organisation auf frem.sh zählt nicht. Pushe nach frem.sh/<org>/<output.image>.
  • Ein anderer Image-Name. Für "output": { "image": "nginx-patched" } zählt ein Push von nginx-patched-amd64 nicht. Der Tag spielt keine Rolle, der Name schon.
  • Der Push mit anderen Zugangsdaten. Ein persönliches Zugriffstoken oder ein Registry-Robot im Push-Schritt trägt den Lauf nicht mit. Melde dich auch für den Push mit dem eigenen Token des Jobs (GITHUB_TOKEN) an.
  • Ein Job, der ohne Push erfolgreich endet. Ein Push-Schritt, der durch eine if:-Bedingung übersprungen wird oder unter continue-on-error fehlschlägt, lässt den Job erfolgreich und das Ergebnis ungepusht. Das setzt den Eintrag sofort aus.
  • Ein gelisteter Workflow, der nie pusht. Ein geplanter Scan- oder Test-Workflow in pullers, dessen Job die Basis pullt, erfolgreich endet und das Ergebnis nicht pusht, setzt den Eintrag bei seinem ersten Lauf aus. Liste nur Workflows, deren Läufe das Ergebnis pushen.
  • Ein Build, der nach dem Pull immer wieder fehlschlägt. Ein fehlgeschlagener, abgebrochener oder unfertiger Job wird festgehalten, setzt aber nicht aus; der dritte in Folge für denselben Eintrag, ohne bestätigten Push dazwischen, setzt ihn aus. Korrigiere den Build, bevor er ein drittes Mal fehlschlägt.
  • Ein Push nach mehr als 6 Stunden. Ein langer Build, der mehr als 6 Stunden nach seinem ersten Pull der Basis pusht, ist zu spät; ein Job, der dann noch läuft, gilt als nicht fertig. Pulle die Basis kurz vor dem Push.
  • Nur confirmed geändert. Den Eintrag erneut zu bestätigen, ohne die Ursache zu beheben, hebt die Aussetzung auf, aber derselbe Fehler setzt den Eintrag wieder aus.

Siehe auch

  • Image-Scanning: die Befunde, die Sperrschwelle und das Image-Pull-Gate.
  • Abhängigkeits-Proxy: Upstream-Images über deine Organisation pullen.
  • Ausnahmen: ein Risiko akzeptieren, das du nicht patchst, mit Ablaufdatum und einer zweiten Freigabe.
  • Branch-Schutz: das Review, das eine Änderung an der Liste durchläuft.